Skip to content

💫 Toolkit to help you get started with SDD or any other process!

Fix package logic

Den Delimarsky 🌺0a5b1ac5385d
diff --git a/.github/workflows/scripts/create-release-packages.sh b/.github/workflows/scripts/create-release-packages.sh
index 1a60b8c5b..0e408d2f2 100644
--- a/.github/workflows/scripts/create-release-packages.sh
+++ b/.github/workflows/scripts/create-release-packages.sh
@@ -4,7 +4,14 @@ set -euo pipefail
# create-release-packages.sh (workflow-local)
# Build Spec Kit template release archives for each supported AI assistant and script type.
# Usage: .github/workflows/scripts/create-release-packages.sh <version>
-# Version argument should include leading 'v'.
+# Version argument should include leading 'v'.
+# Optionally set AGENTS and/or SCRIPTS env vars to limit what gets built.
+# AGENTS : space or comma separated subset of: claude gemini copilot (default: all)
+# SCRIPTS : space or comma separated subset of: sh ps (default: both)
+# Examples:
+# AGENTS=claude SCRIPTS=sh $0 v0.2.0
+# AGENTS="copilot,gemini" $0 v0.2.0
+# SCRIPTS=ps $0 v0.2.0
if [[ $# -ne 1 ]]; then
echo "Usage: $0 <version-with-v-prefix>" >&2
@@ -40,10 +47,26 @@ generate_commands() {
mkdir -p "$output_dir"
for template in templates/commands/*.md; do
[[ -f "$template" ]] || continue
- local name description raw_body variant_line injected body
+ local name description raw_body variant_line injected body file_norm delim_count
name=$(basename "$template" .md)
- description=$(awk '/^description:/ {gsub(/^description: *"?/, ""); gsub(/"$/, ""); print; exit}' "$template" | tr -d '\r')
- raw_body=$(awk '/^---$/{if(++count==2) start=1; next} start' "$template")
+ # Normalize line endings first (remove CR) for consistent regex matching
+ file_norm=$(tr -d '\r' < "$template")
+ # Extract description from frontmatter
+ description=$(printf '%s\n' "$file_norm" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')
+ # Count YAML frontmatter delimiter lines
+ delim_count=$(printf '%s\n' "$file_norm" | grep -c '^---$' || true)
+ if [[ $delim_count -ge 2 ]]; then
+ # Grab everything after the second --- line
+ raw_body=$(printf '%s\n' "$file_norm" | awk '/^---$/ {if(++c==2){next}; if(c>=2){print}}')
+ else
+ # Fallback: no proper frontmatter detected; use entire file content (still allowing variant parsing)
+ raw_body=$file_norm
+ fi
+ # If somehow still empty, fallback once more to whole normalized file
+ if [[ -z ${raw_body// /} ]]; then
+ echo "Warning: body extraction empty for $template; using full file" >&2
+ raw_body=$file_norm
+ fi
# Find single-line variant comment matching the variant: <!-- VARIANT:sh ... --> or <!-- VARIANT:ps ... -->
variant_line=$(printf '%s\n' "$raw_body" | awk -v sv="$script_variant" '/<!--[[:space:]]+VARIANT:'sv'/ {match($0, /VARIANT:'"sv"'[[:space:]]+(.*)-->/, m); if (m[1]!="") {print m[1]; exit}}')
if [[ -z $variant_line ]]; then
@@ -54,6 +77,11 @@ generate_commands() {
injected=$(printf '%s\n' "$raw_body" | sed "s/VARIANT-INJECT/${variant_line//\//\/}/")
# Remove all single-line variant comments
injected=$(printf '%s\n' "$injected" | sed '/<!--[[:space:]]*VARIANT:sh/d' | sed '/<!--[[:space:]]*VARIANT:ps/d')
+ # Guard: if after stripping variant lines and injection the body became empty, restore original (minus variant comments) to avoid empty prompt files
+ if [[ -z ${injected// /} ]]; then
+ echo "Warning: resulting injected body empty for $template; writing unmodified body" >&2
+ injected=$raw_body
+ fi
# Apply arg substitution and path rewrite
body=$(printf '%s\n' "$injected" | sed "s/{ARGS}/$arg_format/g" | sed "s/__AGENT__/$agent/g" | rewrite_paths)
case $ext in
@@ -100,9 +128,48 @@ build_variant() {
echo "Created spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip"
}
-# Build for each agent+script variant
-for agent in claude gemini copilot; do
- for script in sh ps; do
+# Determine agent list
+ALL_AGENTS=(claude gemini copilot)
+ALL_SCRIPTS=(sh ps)
+
+norm_list() {
+ # convert comma+space separated -> space separated unique while preserving order of first occurrence
+ tr ',\n' ' ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?" ":"") $i)}}}END{printf("\n")}'
+}
+
+validate_subset() {
+ local type=$1; shift; local -n allowed=$1; shift; local items=($@)
+ local ok=1
+ for it in "${items[@]}"; do
+ local found=0
+ for a in "${allowed[@]}"; do [[ $it == $a ]] && { found=1; break; }; done
+ if [[ $found -eq 0 ]]; then
+ echo "Error: unknown $type '$it' (allowed: ${allowed[*]})" >&2
+ ok=0
+ fi
+ done
+ return $ok
+}
+
+if [[ -n ${AGENTS:-} ]]; then
+ AGENT_LIST=($(printf '%s' "$AGENTS" | norm_list))
+ validate_subset agent ALL_AGENTS "${AGENT_LIST[@]}" || exit 1
+else
+ AGENT_LIST=(${ALL_AGENTS[@]})
+fi
+
+if [[ -n ${SCRIPTS:-} ]]; then
+ SCRIPT_LIST=($(printf '%s' "$SCRIPTS" | norm_list))
+ validate_subset script ALL_SCRIPTS "${SCRIPT_LIST[@]}" || exit 1
+else
+ SCRIPT_LIST=(${ALL_SCRIPTS[@]})
+fi
+
+echo "Agents: ${AGENT_LIST[*]}"
+echo "Scripts: ${SCRIPT_LIST[*]}"
+
+for agent in "${AGENT_LIST[@]}"; do
+ for script in "${SCRIPT_LIST[@]}"; do
build_variant "$agent" "$script"
done
done
diff --git a/templates/commands/plan.md b/templates/commands/plan.md
index 14604f02b..9df5d308d 100644
--- a/templates/commands/plan.md
+++ b/templates/commands/plan.md
@@ -1,3 +1,6 @@
+---
+description: Execute the implementation planning workflow using the plan template to generate design artifacts.
+---
<!-- VARIANT:sh 1. Run `scripts/bash/setup-plan.sh --json` from the repo root and parse JSON for FEATURE_SPEC, IMPL_PLAN, SPECS_DIR, BRANCH. All future file paths must be absolute. -->
<!-- VARIANT:ps 1. Run `scripts/powershell/setup-plan.ps1 -Json` from the repo root and parse JSON for FEATURE_SPEC, IMPL_PLAN, SPECS_DIR, BRANCH. All future file paths must be absolute. -->
diff --git a/templates/commands/specify.md b/templates/commands/specify.md
index dbd86d559..111e27855 100644
--- a/templates/commands/specify.md
+++ b/templates/commands/specify.md
@@ -1,3 +1,6 @@
+---
+description: Create or update the feature specification from a natural language feature description.
+---
<!-- VARIANT:sh 1. Run the script `scripts/bash/create-new-feature.sh --json "{ARGS}"` from repo root and parse its JSON output for BRANCH_NAME and SPEC_FILE. All file paths must be absolute. -->
<!-- VARIANT:ps 1. Run the script `scripts/powershell/create-new-feature.ps1 -Json "{ARGS}"` from repo root and parse its JSON output for BRANCH_NAME and SPEC_FILE. All file paths must be absolute. -->
diff --git a/templates/commands/tasks.md b/templates/commands/tasks.md
index 4677f25cf..3a5848908 100644
--- a/templates/commands/tasks.md
+++ b/templates/commands/tasks.md
@@ -1,3 +1,6 @@
+---
+description: Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
+---
<!-- VARIANT:sh 1. Run `scripts/bash/check-task-prerequisites.sh --json` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. -->
<!-- VARIANT:ps 1. Run `scripts/powershell/check-task-prerequisites.ps1 -Json` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. -->