@bhargavvc/sdd-cc 1.30.1 → 1.42.3

package/scripts/rebrand-gsd-to-sdd.sh

@@ -1,220 +1,222 @@
-#!/usr/bin/env bash
-##############################################################################
-# rebrand-gsd-to-sdd.sh (for sdd-cc repo)
-#
-# Converts all G.S.D references to S.D.D in the IDE installer package.
-# IDEMPOTENT — safe to re-run. Excludes itself from modification.
-#
-# USAGE:  bash scripts/rebrand-gsd-to-sdd.sh
-# RUN AFTER:  git merge upstream-sync  (into main)
-##############################################################################
-
-set -euo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-cd "$REPO_ROOT"
-
-# Build literal strings via hex to avoid self-modification by sed
-OLD_LC=$(printf '\x67\x73\x64')       # g-s-d
-OLD_UC=$(printf '\x47\x53\x44')       # G-S-D
-NEW_LC="sdd"
-NEW_UC="SDD"
-
-# The old framework directory name (hex-encoded to avoid self-match)
-OLD_DIR=$(printf '\x67\x65\x74\x2d\x73\x68\x69\x74\x2d\x64\x6f\x6e\x65')  # get-shit-done
-NEW_DIR="sdd"
-
-# Old branding phrases (hex-encoded)
-OLD_BRAND1=$(printf '\x47\x65\x74\x20\x53\x68\x69\x74\x20\x44\x6f\x6e\x65')  # Get Shit Done
-OLD_BRAND2=$(printf '\x47\x65\x74\x20\x53\x74\x75\x66\x66\x20\x44\x6f\x6e\x65') # Get Stuff Done
-NEW_BRAND="Spec-Driven Development"
-
-SELF_NAME="rebrand-$(echo "${OLD_LC}")-to-${NEW_LC}.sh"
-
-echo "=== ${NEW_UC}-CC Rebrand Script ==="
-echo "Working in: $REPO_ROOT"
-
-# ─── STEP 1: Rename directories ─────────────────────────────────────────────
-echo ""
-echo "[1/5] Renaming directories..."
-
-# Rename get-shit-done/ → sdd/
-if [ -d "${OLD_DIR}" ] && [ ! -d "${NEW_DIR}" ]; then
-  echo "  ${OLD_DIR}/ -> ${NEW_DIR}/"
-  mv "${OLD_DIR}" "${NEW_DIR}"
-fi
-
-# Rename commands/gsd/ → commands/sdd/
-if [ -d "commands/${OLD_LC}" ] && [ ! -d "commands/${NEW_LC}" ]; then
-  echo "  commands/${OLD_LC}/ -> commands/${NEW_LC}/"
-  mv "commands/${OLD_LC}" "commands/${NEW_LC}"
-fi
-
-# Rename internal get-shit-done/commands/gsd/ if it exists
-if [ -d "${NEW_DIR}/commands/${OLD_LC}" ] && [ ! -d "${NEW_DIR}/commands/${NEW_LC}" ]; then
-  echo "  ${NEW_DIR}/commands/${OLD_LC}/ -> ${NEW_DIR}/commands/${NEW_LC}/"
-  mv "${NEW_DIR}/commands/${OLD_LC}" "${NEW_DIR}/commands/${NEW_LC}"
-fi
-
-echo "  Done."
-
-# ─── STEP 2: Rename files ───────────────────────────────────────────────────
-echo ""
-echo "[2/5] Renaming files..."
-
-find . -not -path './.git/*' -not -path './node_modules/*' \
-  -not -name "$SELF_NAME" \
-  \( -name "*${OLD_LC}*" -o -name "*${OLD_UC}*" -o -name "*${OLD_DIR}*" \) \
-  -type f 2>/dev/null | sort -r | while read -r path; do
-  dir=$(dirname "$path")
-  base=$(basename "$path")
-  newbase=$(echo "$base" | sed "s/${OLD_DIR}/${NEW_DIR}/g; s/${OLD_LC}/${NEW_LC}/g; s/${OLD_UC}/${NEW_UC}/g")
-  [ "$base" = "$newbase" ] && continue
-  echo "  $path -> $dir/$newbase"
-  mv "$path" "$dir/$newbase"
-done
-
-echo "  Done."
-
-# ─── STEP 3: Replace content in all files ───────────────────────────────────
-echo ""
-echo "[3/5] Finding files with content to replace..."
-
-grep -rl --include="*.md" --include="*.js" --include="*.cjs" \
-  --include="*.json" --include="*.sh" --include="*.yml" --include="*.yaml" \
-  -E "${OLD_LC}|${OLD_UC}|${OLD_DIR}" . 2>/dev/null \
-  | grep -v '\.git/' | grep -v 'node_modules/' \
-  | grep -v "$SELF_NAME" \
-  | grep -v 'package-lock.json' \
-  > /tmp/${NEW_LC}-cc-rebrand-files.txt || true
-
-FCOUNT=$(wc -l < /tmp/${NEW_LC}-cc-rebrand-files.txt)
-echo "  Found $FCOUNT files."
-
-echo "  Replacing..."
-while IFS= read -r file; do
-  [ -z "$file" ] && continue
-
-  # Branding phrases first (longest match first)
-  sed -i \
-    -e "s/${OLD_BRAND1}/${NEW_BRAND}/g" \
-    -e "s/${OLD_BRAND2}/${NEW_BRAND}/g" \
-    "$file"
-
-  # Directory name: get-shit-done → sdd
-  sed -i \
-    -e "s/${OLD_DIR}-cc/@bhargavvc\/${NEW_LC}-cc/g" \
-    -e "s/${OLD_DIR}/${NEW_DIR}/g" \
-    "$file"
-
-  # Targeted patterns
-  sed -i \
-    -e "s/${OLD_LC}:/${NEW_LC}:/g" \
-    -e "s/${OLD_LC}-/${NEW_LC}-/g" \
-    -e "s/_${OLD_LC}/_${NEW_LC}/g" \
-    -e "s/${OLD_LC}_/${NEW_LC}_/g" \
-    -e "s/\/${OLD_LC}\//\/${NEW_LC}\//g" \
-    -e "s/\.${OLD_LC}\//\.${NEW_LC}\//g" \
-    -e "s/\.${OLD_LC}\"/.${NEW_LC}\"/g" \
-    -e "s/\.${OLD_LC}'/.${NEW_LC}'/g" \
-    -e "s/\"${OLD_LC}\"/\"${NEW_LC}\"/g" \
-    -e "s/'${OLD_LC}'/'${NEW_LC}'/g" \
-    -e "s/@${OLD_LC}\//@${NEW_LC}\//g" \
-    -e "s/${OLD_UC}_/${NEW_UC}_/g" \
-    -e "s/\"${OLD_UC}\"/\"${NEW_UC}\"/g" \
-    -e "s/'${OLD_UC}'/'${NEW_UC}'/g" \
-    "$file"
-
-  # Variable syntax: {{GSD_ARGS}} → {{SDD_ARGS}}
-  sed -i \
-    -e "s/{{${OLD_UC}_ARGS}}/{{${NEW_UC}_ARGS}}/g" \
-    -e "s/{{${OLD_UC}_/{{${NEW_UC}_/g" \
-    "$file"
-
-  # Catch-all: remaining standalone instances
-  sed -i \
-    -e "s/\b${OLD_LC}\b/${NEW_LC}/g" \
-    -e "s/\b${OLD_UC}\b/${NEW_UC}/g" \
-    "$file"
-
-  # Restore @gsd-build (upstream npm scope — must stay)
-  if grep -q "${NEW_LC}-build" "$file" 2>/dev/null; then
-    sed -i \
-      -e "s/@${NEW_LC}-build/@${OLD_LC}-build/g" \
-      -e "s/${NEW_LC}-build\//${OLD_LC}-build\//g" \
-      "$file"
-  fi
-
-done < /tmp/${NEW_LC}-cc-rebrand-files.txt
-
-rm -f /tmp/${NEW_LC}-cc-rebrand-files.txt
-echo "  Done."
-
-# ─── STEP 4: Fix package.json ───────────────────────────────────────────────
-echo ""
-echo "[4/5] Updating package.json..."
-
-if [ -f "package.json" ]; then
-  # Fix package name and bin
-  sed -i \
-    -e 's/"name": *"[^"]*"/"name": "@bhargavvc\/sdd-cc"/' \
-    -e 's/"sdd-cc-cc"/"sdd-cc"/' \
-    -e "s/\"${OLD_DIR}-cc\"/\"${NEW_LC}-cc\"/g" \
-    package.json
-
-  # Fix bin entry: the key might already be partially renamed
-  # Ensure bin is exactly: "sdd-cc": "bin/install.js"
-  node -e "
-    const pkg = require('./package.json');
-    const fs = require('fs');
-    pkg.name = '@bhargavvc/sdd-cc';
-    pkg.bin = { 'sdd-cc': 'bin/install.js' };
-    pkg.description = pkg.description
-      .replace(/Get Shit Done/gi, 'Spec-Driven Development')
-      .replace(/GSD/g, 'SDD')
-      .replace(/gsd/g, 'sdd');
-    pkg.repository = { type: 'git', url: 'git+https://github.com/bhargavvc/sdd-cc.git' };
-    pkg.homepage = 'https://github.com/bhargavvc/sdd-cc';
-    pkg.bugs = { url: 'https://github.com/bhargavvc/sdd-cc/issues' };
-    pkg.publishConfig = { access: 'public' };
-    fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
-  "
-  echo "  package.json updated."
-fi
-
-echo "  Done."
-
-# ─── STEP 5: Verify ─────────────────────────────────────────────────────────
-echo ""
-echo "[5/5] Verifying..."
-
-STALE_COUNT=0
-
-echo "  Checking for stale references..."
-# Check markdown and source files for remaining gsd (excluding @gsd-build and this script)
-STALE=$(grep -rn "${OLD_LC}\|${OLD_DIR}" \
-  --include="*.md" --include="*.js" --include="*.cjs" \
-  . 2>/dev/null \
-  | grep -v '\.git/' | grep -v 'node_modules/' \
-  | grep -v "$SELF_NAME" \
-  | grep -v "@${OLD_LC}-build" \
-  | grep -v "REBRAND" \
-  | head -20 || true)
-
-if [ -n "$STALE" ]; then
-  echo "  WARNING: Stale references found:"
-  echo "$STALE"
-  STALE_COUNT=$(echo "$STALE" | wc -l)
-else
-  echo "  No stale references found."
-fi
-
-echo ""
-echo "=== Rebrand complete ==="
-echo "  Stale references: $STALE_COUNT"
-echo ""
-echo "  Next steps:"
-echo "  1. Review changes: git diff --stat"
-echo "  2. Test installer:  node bin/install.js --cursor --local"
-echo "  3. Commit:          git add -A && git commit -m 'rebrand: GSD → SDD'"
-echo "  4. Publish:         npm publish --access public"
+#!/usr/bin/env bash
+##############################################################################
+# rebrand-gsd-to-sdd.sh (for sdd-cc repo)
+#
+# Converts all G.S.D references to S.D.D in the IDE installer package.
+# IDEMPOTENT — safe to re-run. Excludes itself from modification.
+#
+# USAGE:  bash scripts/rebrand-gsd-to-sdd.sh
+# RUN AFTER:  git merge upstream-sync  (into main)
+##############################################################################
+
+set -eu
+# Note: pipefail removed — grep returns 1 for "no matches" which is normal
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO_ROOT"
+
+# Build literal strings via hex to avoid self-modification by sed
+OLD_LC=$(printf '\x67\x73\x64')       # g-s-d
+OLD_UC=$(printf '\x47\x53\x44')       # G-S-D
+NEW_LC="sdd"
+NEW_UC="SDD"
+
+# The old framework directory name (hex-encoded to avoid self-match)
+OLD_DIR=$(printf '\x67\x65\x74\x2d\x73\x68\x69\x74\x2d\x64\x6f\x6e\x65')  # get-shit-done
+NEW_DIR="sdd"
+
+# Old branding phrases (hex-encoded)
+OLD_BRAND1=$(printf '\x47\x65\x74\x20\x53\x68\x69\x74\x20\x44\x6f\x6e\x65')  # Get Shit Done
+OLD_BRAND2=$(printf '\x47\x65\x74\x20\x53\x74\x75\x66\x66\x20\x44\x6f\x6e\x65') # Get Stuff Done
+NEW_BRAND="Spec-Driven Development"
+
+SELF_NAME="rebrand-$(echo "${OLD_LC}")-to-${NEW_LC}.sh"
+
+echo "=== ${NEW_UC}-CC Rebrand Script ==="
+echo "Working in: $REPO_ROOT"
+
+# ─── STEP 1: Rename directories ─────────────────────────────────────────────
+echo ""
+echo "[1/5] Renaming directories..."
+
+# Rename get-shit-done/ → sdd/
+if [ -d "${OLD_DIR}" ] && [ ! -d "${NEW_DIR}" ]; then
+  echo "  ${OLD_DIR}/ -> ${NEW_DIR}/"
+  mv "${OLD_DIR}" "${NEW_DIR}"
+fi
+
+# Rename commands/gsd/ → commands/sdd/
+if [ -d "commands/${OLD_LC}" ] && [ ! -d "commands/${NEW_LC}" ]; then
+  echo "  commands/${OLD_LC}/ -> commands/${NEW_LC}/"
+  mv "commands/${OLD_LC}" "commands/${NEW_LC}"
+fi
+
+# Rename internal get-shit-done/commands/gsd/ if it exists
+if [ -d "${NEW_DIR}/commands/${OLD_LC}" ] && [ ! -d "${NEW_DIR}/commands/${NEW_LC}" ]; then
+  echo "  ${NEW_DIR}/commands/${OLD_LC}/ -> ${NEW_DIR}/commands/${NEW_LC}/"
+  mv "${NEW_DIR}/commands/${OLD_LC}" "${NEW_DIR}/commands/${NEW_LC}"
+fi
+
+echo "  Done."
+
+# ─── STEP 2: Rename files ───────────────────────────────────────────────────
+echo ""
+echo "[2/5] Renaming files..."
+
+find . -not -path './.git/*' -not -path './node_modules/*' \
+  -not -name "$SELF_NAME" \
+  \( -name "*${OLD_LC}*" -o -name "*${OLD_UC}*" -o -name "*${OLD_DIR}*" \) \
+  -type f 2>/dev/null | sort -r | while read -r path; do
+  dir=$(dirname "$path")
+  base=$(basename "$path")
+  newbase=$(echo "$base" | sed "s/${OLD_DIR}/${NEW_DIR}/g; s/${OLD_LC}/${NEW_LC}/g; s/${OLD_UC}/${NEW_UC}/g")
+  [ "$base" = "$newbase" ] && continue
+  echo "  $path -> $dir/$newbase"
+  mv "$path" "$dir/$newbase"
+done
+
+echo "  Done."
+
+# ─── STEP 3: Replace content in all files ───────────────────────────────────
+echo ""
+echo "[3/5] Finding files with content to replace..."
+
+grep -rl --include="*.md" --include="*.js" --include="*.cjs" --include="*.mjs" \
+  --include="*.ts" --include="*.tsx" \
+  --include="*.json" --include="*.sh" --include="*.yml" --include="*.yaml" \
+  -E "${OLD_LC}|${OLD_UC}|${OLD_DIR}" . 2>/dev/null \
+  | grep -v '\.git/' | grep -v 'node_modules/' \
+  | grep -v "$SELF_NAME" \
+  | grep -v 'package-lock.json' \
+  > /tmp/${NEW_LC}-cc-rebrand-files.txt || true
+
+FCOUNT=$(wc -l < /tmp/${NEW_LC}-cc-rebrand-files.txt)
+echo "  Found $FCOUNT files."
+
+echo "  Replacing..."
+while IFS= read -r file; do
+  [ -z "$file" ] && continue
+
+  # Branding phrases first (longest match first)
+  sed -i \
+    -e "s/${OLD_BRAND1}/${NEW_BRAND}/g" \
+    -e "s/${OLD_BRAND2}/${NEW_BRAND}/g" \
+    "$file"
+
+  # Directory name: get-shit-done → sdd
+  sed -i \
+    -e "s/${OLD_DIR}-cc/@bhargavvc\/${NEW_LC}-cc/g" \
+    -e "s/${OLD_DIR}/${NEW_DIR}/g" \
+    "$file"
+
+  # Targeted patterns
+  sed -i \
+    -e "s/${OLD_LC}:/${NEW_LC}:/g" \
+    -e "s/${OLD_LC}-/${NEW_LC}-/g" \
+    -e "s/_${OLD_LC}/_${NEW_LC}/g" \
+    -e "s/${OLD_LC}_/${NEW_LC}_/g" \
+    -e "s/\/${OLD_LC}\//\/${NEW_LC}\//g" \
+    -e "s/\.${OLD_LC}\//\.${NEW_LC}\//g" \
+    -e "s/\.${OLD_LC}\"/.${NEW_LC}\"/g" \
+    -e "s/\.${OLD_LC}'/.${NEW_LC}'/g" \
+    -e "s/\"${OLD_LC}\"/\"${NEW_LC}\"/g" \
+    -e "s/'${OLD_LC}'/'${NEW_LC}'/g" \
+    -e "s/@${OLD_LC}\//@${NEW_LC}\//g" \
+    -e "s/${OLD_UC}_/${NEW_UC}_/g" \
+    -e "s/\"${OLD_UC}\"/\"${NEW_UC}\"/g" \
+    -e "s/'${OLD_UC}'/'${NEW_UC}'/g" \
+    "$file"
+
+  # Variable syntax: {{GSD_ARGS}} → {{SDD_ARGS}}
+  sed -i \
+    -e "s/{{${OLD_UC}_ARGS}}/{{${NEW_UC}_ARGS}}/g" \
+    -e "s/{{${OLD_UC}_/{{${NEW_UC}_/g" \
+    "$file"
+
+  # Catch-all: remaining standalone instances
+  sed -i \
+    -e "s/\b${OLD_LC}\b/${NEW_LC}/g" \
+    -e "s/\b${OLD_UC}\b/${NEW_UC}/g" \
+    "$file"
+
+  # Restore @gsd-build (upstream npm scope — must stay)
+  if grep -q "${NEW_LC}-build" "$file" 2>/dev/null; then
+    sed -i \
+      -e "s/@${NEW_LC}-build/@${OLD_LC}-build/g" \
+      -e "s/${NEW_LC}-build\//${OLD_LC}-build\//g" \
+      "$file"
+  fi
+
+done < /tmp/${NEW_LC}-cc-rebrand-files.txt
+
+rm -f /tmp/${NEW_LC}-cc-rebrand-files.txt
+echo "  Done."
+
+# ─── STEP 4: Fix package.json ───────────────────────────────────────────────
+echo ""
+echo "[4/5] Updating package.json..."
+
+if [ -f "package.json" ]; then
+  # Fix package name and bin
+  sed -i \
+    -e 's/"name": *"[^"]*"/"name": "@bhargavvc\/sdd-cc"/' \
+    -e 's/"sdd-cc-cc"/"sdd-cc"/' \
+    -e "s/\"${OLD_DIR}-cc\"/\"${NEW_LC}-cc\"/g" \
+    package.json
+
+  # Fix bin entry: the key might already be partially renamed
+  # Ensure bin includes sdd-cc (installer) + sdd-sdk (back-compat shim, fix #2441)
+  node -e "
+    const pkg = require('./package.json');
+    const fs = require('fs');
+    pkg.name = '@bhargavvc/sdd-cc';
+    pkg.bin = { 'sdd-cc': 'bin/install.js', 'sdd-sdk': 'bin/sdd-sdk.js', 'sdd-tools': 'bin/sdd-sdk.js' };
+    pkg.description = pkg.description
+      .replace(/Get Shit Done/gi, 'Spec-Driven Development')
+      .replace(/GSD/g, 'SDD')
+      .replace(/gsd/g, 'sdd');
+    pkg.repository = { type: 'git', url: 'git+https://github.com/bhargavvc/sdd-cc.git' };
+    pkg.homepage = 'https://github.com/bhargavvc/sdd-cc';
+    pkg.bugs = { url: 'https://github.com/bhargavvc/sdd-cc/issues' };
+    pkg.publishConfig = { access: 'public' };
+    fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
+  "
+  echo "  package.json updated."
+fi
+
+echo "  Done."
+
+# ─── STEP 5: Verify ─────────────────────────────────────────────────────────
+echo ""
+echo "[5/5] Verifying..."
+
+STALE_COUNT=0
+
+echo "  Checking for stale references..."
+# Check markdown and source files for remaining gsd (excluding @gsd-build and this script)
+STALE=$(grep -rn "${OLD_LC}\|${OLD_DIR}" \
+  --include="*.md" --include="*.js" --include="*.cjs" \
+  . 2>/dev/null \
+  | grep -v '\.git/' | grep -v 'node_modules/' \
+  | grep -v "$SELF_NAME" \
+  | grep -v "@${OLD_LC}-build" \
+  | grep -v "REBRAND" \
+  | head -20 || true)
+
+if [ -n "$STALE" ]; then
+  echo "  WARNING: Stale references found:"
+  echo "$STALE"
+  STALE_COUNT=$(echo "$STALE" | wc -l)
+else
+  echo "  No stale references found."
+fi
+
+echo ""
+echo "=== Rebrand complete ==="
+echo "  Stale references: $STALE_COUNT"
+echo ""
+echo "  Next steps:"
+echo "  1. Review changes: git diff --stat"
+echo "  2. Test installer:  node bin/install.js --cursor --local"
+echo "  3. Commit:          git add -A && git commit -m 'rebrand: GSD → SDD'"
+echo "  4. Publish:         npm publish --access public"

package/scripts/run-tests.cjs

@@ -19,8 +19,12 @@ if (files.length === 0) {
   process.exit(1);
 }
 
+const concurrency = process.env.TEST_CONCURRENCY
+  ? `--test-concurrency=${process.env.TEST_CONCURRENCY}`
+  : '--test-concurrency=4';
+
 try {
-  execFileSync(process.execPath, ['--test', ...files], {
+  execFileSync(process.execPath, ['--test', concurrency, ...files], {
     stdio: 'inherit',
     env: { ...process.env },
   });

package/scripts/strip-prose-atrefs.cjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * strip-prose-atrefs.cjs
+ *
+ * Removes redundant @~/.claude/sdd/ path tokens from prose lines
+ * in <process> and <context> blocks. The path is already declared in
+ * <execution_context> where it actually loads the file. Prose copies are
+ * inert and add ~900 tokens/invocation of dead weight.
+ *
+ * Transformation rules (applied per matching line):
+ *   - "Execute the X workflow from @PATH end-to-end." → "Execute end-to-end."
+ *   - "Execute @PATH end-to-end."                    → "Execute end-to-end."
+ *   - "Read and execute the X workflow from @PATH end-to-end." → "Execute end-to-end."
+ *   - "Follow the X workflow at @PATH."              → "Execute end-to-end."
+ *   - "Output the X reference from @PATH."           → "Execute end-to-end."
+ *   - "**Follow the X** from `@PATH`."               → "**Follow the X.**"
+ *   - "- If it is '...': ... from @PATH end-to-end." → strip path token only
+ *   - "- Otherwise: ... from @PATH end-to-end."      → strip path token only
+ *   - "- @PATH (label)"                              → "- (label)"
+ *
+ * Run with --dry-run to preview without writing.
+ */
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+const DRY_RUN      = process.argv.includes('--dry-run');
+const ROOT         = path.join(__dirname, '..');
+const COMMANDS_DIR = path.join(ROOT, 'commands', 'sdd');
+
+const AT_PATH_PATTERN = /@(?:~|\$HOME)\/.+?sdd\/[^\s`\)]+/;
+const mkAtRe = () => new RegExp(AT_PATH_PATTERN.source, 'g');
+
+function transformLine(line) {
+  if (!AT_PATH_PATTERN.test(line)) return line;
+
+  const trimmed = line.trim();
+
+  // "- @PATH (label)"  →  "- (label)"
+  if (/^- @(?:~|\$HOME)\//.test(trimmed)) {
+    return line.replace(/^(\s*- )@(?:~|\$HOME)\/[^\s(]+\s*/, '$1');
+  }
+
+  // "**Follow the X workflow** from `@PATH`."  →  "**Follow the X workflow.**"
+  // "**Follow the X workflow** from `@PATH`"   →  "**Follow the X workflow.**"
+  if (/\*\*Follow the .+ workflow\*\* from `@/.test(trimmed)) {
+    return line.replace(/\s+from `@(?:~|\$HOME)\/[^`]+`\.?/, '.');
+  }
+
+  // Routing bullet: keep everything except "from @PATH" or bare "@PATH"
+  // "- If …: … from @PATH end-to-end." → strip path, keep bullet
+  // "- Otherwise: … from @PATH end-to-end." → strip path, keep bullet
+  if (/^- (?:If |Otherwise:|pass all)/.test(trimmed)) {
+    return line
+      .replace(/\s+from\s+@(?:~|\$HOME)\/\S+/g, '')
+      .replace(/@(?:~|\$HOME)\/\S+/g, '');
+  }
+
+  // "Execute [the X workflow] [from] @PATH [end-to-end]."
+  // "Read and execute …"  /  "Follow …"  /  "Output …"
+  // → collapse to leading indent + "Execute end-to-end."
+  const indent = line.match(/^(\s*)/)[1];
+  return `${indent}Execute end-to-end.`;
+}
+
+function processFile(filePath) {
+  const original = fs.readFileSync(filePath, 'utf-8');
+  const lines    = original.split('\n');
+  const out      = [];
+  let inProse    = false; // true when inside <process> or <context> (not execution_context)
+
+  for (const line of lines) {
+    const t = line.trim();
+    if (/<(process|context)>/.test(t) && !t.includes('execution_context')) inProse = true;
+    if (/<\/(process|context)>/.test(t) && !t.includes('execution_context')) inProse = false;
+
+    if (inProse && AT_PATH_PATTERN.test(line)) {
+      const re = mkAtRe();
+      re.lastIndex = 0;
+      out.push(transformLine(line));
+    } else {
+      out.push(line);
+    }
+  }
+
+  const result = out.join('\n');
+  if (result === original) return false; // no change
+
+  if (!DRY_RUN) fs.writeFileSync(filePath, result, 'utf-8');
+  return true;
+}
+
+const files = fs.readdirSync(COMMANDS_DIR)
+  .filter(f => f.endsWith('.md'))
+  .map(f => path.join(COMMANDS_DIR, f));
+
+let changed = 0;
+for (const f of files) {
+  if (processFile(f)) {
+    console.log(`${DRY_RUN ? '[dry]' : 'fixed'}: ${path.basename(f)}`);
+    changed++;
+  }
+}
+console.log(`\n${changed} file(s) ${DRY_RUN ? 'would be' : 'were'} modified.`);

package/scripts/verify-tarball-sdk-dist.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# Verify the published @bhargavvc/sdd-cc tarball actually contains
+# sdk/dist/cli.js and that the `query` subcommand is exposed.
+#
+# Guards regression of bug #2647: v1.38.3 shipped without sdk/dist/
+# because the outer `files` whitelist and `prepublishOnly` chain
+# drifted out of alignment. Any future drift fails release CI here.
+#
+# Run AFTER `npm run build:sdk` (so sdk/dist exists on disk) and
+# before `npm publish`. Exits non-zero on any mismatch.
+
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO_ROOT"
+
+echo "==> Packing tarball (ignore-scripts: sdk/dist must already exist)"
+TARBALL=$(npm pack --ignore-scripts 2>/dev/null | tail -1)
+if [ -z "$TARBALL" ] || [ ! -f "$TARBALL" ]; then
+  echo "::error::npm pack produced no tarball"
+  exit 1
+fi
+echo "    tarball: $TARBALL"
+
+EXTRACT_DIR=$(mktemp -d)
+trap 'rm -rf "$EXTRACT_DIR" "$TARBALL"' EXIT
+
+echo "==> Extracting tarball into $EXTRACT_DIR"
+tar -xzf "$TARBALL" -C "$EXTRACT_DIR"
+
+CLI_JS="$EXTRACT_DIR/package/sdk/dist/cli.js"
+if [ ! -f "$CLI_JS" ]; then
+  echo "::error::$CLI_JS is missing from the published tarball"
+  echo "Tarball contents under sdk/:"
+  find "$EXTRACT_DIR/package/sdk" -maxdepth 2 -print | head -40
+  exit 1
+fi
+echo "    OK: sdk/dist/cli.js present ($(wc -c < "$CLI_JS") bytes)"
+
+echo "==> Installing runtime deps inside the extracted package and invoking sdd-sdk query --help"
+pushd "$EXTRACT_DIR/package" >/dev/null
+# Install only production deps so the extracted tarball resolves
+# @anthropic-ai/claude-agent-sdk / ws the same way a real user install would.
+npm install --omit=dev --no-audit --no-fund --silent
+OUTPUT=$(node sdk/dist/cli.js query --help 2>&1 || true)
+popd >/dev/null
+
+echo "$OUTPUT" | head -20
+if ! echo "$OUTPUT" | grep -qi 'query'; then
+  echo "::error::sdk/dist/cli.js did not expose a 'query' subcommand"
+  exit 1
+fi
+if echo "$OUTPUT" | grep -qiE 'unknown command|unrecognized'; then
+  echo "::error::sdk/dist/cli.js rejected 'query' as unknown"
+  exit 1
+fi
+
+echo "==> Also verifying sdd-sdk bin shim resolves ../sdk/dist/cli.js"
+SHIM="$EXTRACT_DIR/package/bin/sdd-sdk.js"
+if [ ! -f "$SHIM" ]; then
+  echo "::error::bin/sdd-sdk.js missing from tarball"
+  exit 1
+fi
+if ! grep -qE "sdk.*dist.*cli\.js" "$SHIM"; then
+  echo "::error::bin/sdd-sdk.js does not reference sdk/dist/cli.js"
+  exit 1
+fi
+
+echo "==> Tarball verification passed"