thachvd-kit 1.0.38 → 1.0.39

package/skills/subagent-driven-development/scripts/review-package.js

@@ -1,52 +1,52 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const { runGit, workspaceForPlan } = require('./sdd-workspace-lib');
-
-function gitStatus(args) {
-    const { spawnSync } = require('child_process');
-    return spawnSync('git', args, { encoding: 'utf8' });
-}
-
-function main() {
-    if (process.argv.length < 5 || process.argv.length > 6) {
-        throw new Error('usage: review-package PLAN_FILE BASE HEAD [OUTFILE]');
-    }
-    const [, , planFile, base, head, explicitOutput] = process.argv;
-    if (!fs.existsSync(path.resolve(planFile))) throw new Error(`no such plan file: ${planFile}`);
-    for (const ref of [base, head]) {
-        const result = gitStatus(['rev-parse', '--verify', '--quiet', ref]);
-        if (result.status !== 0) throw new Error(`bad ${ref === base ? 'BASE' : 'HEAD'}: ${ref}`);
-    }
-    const ancestor = gitStatus(['merge-base', '--is-ancestor', base, head]);
-    if (ancestor.status !== 0) throw new Error(`HEAD is not a descendant of BASE: ${base}..${head}`);
-    const commits = Number(runGit(['rev-list', '--count', `${base}..${head}`]));
-    if (commits <= 0) throw new Error(`empty commit range: ${base}..${head}`);
-
-    const outputPath = explicitOutput || path.join(
-        workspaceForPlan(planFile),
-        `review-${runGit(['rev-parse', '--short', base])}..${runGit(['rev-parse', '--short', head])}.diff`
-    );
-    const content = [
-        `# Review package: ${base}..${head}`,
-        '',
-        '## Commits',
-        runGit(['log', '--oneline', `${base}..${head}`]),
-        '',
-        '## Files changed',
-        runGit(['diff', '--stat', `${base}..${head}`]),
-        '',
-        '## Diff',
-        runGit(['diff', '-U10', `${base}..${head}`])
-    ].join('\n') + '\n';
-    fs.writeFileSync(outputPath, content);
-    console.log(`wrote ${outputPath}: ${commits} commit(s), ${Buffer.byteLength(content)} bytes`);
-}
-
-try {
-    main();
-} catch (error) {
-    console.error(error.message);
-    process.exitCode = 2;
-}
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { runGit, workspaceForPlan } = require('./sdd-workspace-lib');
+
+function gitStatus(args) {
+    const { spawnSync } = require('child_process');
+    return spawnSync('git', args, { encoding: 'utf8' });
+}
+
+function main() {
+    if (process.argv.length < 5 || process.argv.length > 6) {
+        throw new Error('usage: review-package PLAN_FILE BASE HEAD [OUTFILE]');
+    }
+    const [, , planFile, base, head, explicitOutput] = process.argv;
+    if (!fs.existsSync(path.resolve(planFile))) throw new Error(`no such plan file: ${planFile}`);
+    for (const ref of [base, head]) {
+        const result = gitStatus(['rev-parse', '--verify', '--quiet', ref]);
+        if (result.status !== 0) throw new Error(`bad ${ref === base ? 'BASE' : 'HEAD'}: ${ref}`);
+    }
+    const ancestor = gitStatus(['merge-base', '--is-ancestor', base, head]);
+    if (ancestor.status !== 0) throw new Error(`HEAD is not a descendant of BASE: ${base}..${head}`);
+    const commits = Number(runGit(['rev-list', '--count', `${base}..${head}`]));
+    if (commits <= 0) throw new Error(`empty commit range: ${base}..${head}`);
+
+    const outputPath = explicitOutput || path.join(
+        workspaceForPlan(planFile),
+        `review-${runGit(['rev-parse', '--short', base])}..${runGit(['rev-parse', '--short', head])}.diff`
+    );
+    const content = [
+        `# Review package: ${base}..${head}`,
+        '',
+        '## Commits',
+        runGit(['log', '--oneline', `${base}..${head}`]),
+        '',
+        '## Files changed',
+        runGit(['diff', '--stat', `${base}..${head}`]),
+        '',
+        '## Diff',
+        runGit(['diff', '-U10', `${base}..${head}`])
+    ].join('\n') + '\n';
+    fs.writeFileSync(outputPath, content);
+    console.log(`wrote ${outputPath}: ${commits} commit(s), ${Buffer.byteLength(content)} bytes`);
+}
+
+try {
+    main();
+} catch (error) {
+    console.error(error.message);
+    process.exitCode = 2;
+}

package/skills/subagent-driven-development/scripts/sdd-workspace

@@ -1,82 +1,82 @@
-#!/usr/bin/env bash
-# Resolve and ensure the working-tree directory SDD uses for one plan's
-# short-lived artifacts: task briefs, implementer reports, review packages,
-# and the progress ledger. Print the plan directory's absolute path.
-#
-# One directory per plan (.superpowers/sdd/<plan-basename>/) so a follow-up
-# plan in the same working tree can never read or overwrite another plan's
-# artifacts. A stale ledger misread as current progress makes controllers
-# skip whole task sequences — plan-scoping removes that failure structurally.
-#
-# Basename slugs collide when two plans share a filename (docs/alpha/plan.md
-# vs docs/beta/plan.md), so each workspace records its owning plan's path in
-# a plan-path marker (repo-relative in-repo, absolute outside). A workspace
-# owned by a different plan is skipped and the slug disambiguated with the
-# plan's parent-directory name, then a counter. A workspace with no marker
-# predates the marker scheme and is adopted for the current plan so in-flight
-# workspaces keep resolving — which means the first collision on such a
-# legacy workspace adopts instead of detecting; acceptable, marker-less
-# workspaces age out as plans finish.
-#
-# The workspace lives in the working tree (not under .git/) because Claude Code
-# treats .git/ as a protected path and denies agent writes there — which blocks
-# an implementer subagent from writing its report file. A self-ignoring
-# .gitignore at .superpowers/sdd/ keeps every plan's workspace out of
-# `git status` and out of accidental commits without modifying any tracked file.
-#
-# Single source of truth for the workspace location, so task-brief and
-# review-package cannot drift to different directories.
-#
-# Usage: sdd-workspace PLAN_FILE
-set -euo pipefail
-
-if [ $# -ne 1 ]; then
-  echo "usage: sdd-workspace PLAN_FILE" >&2
-  exit 2
-fi
-
-plan=$1
-[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
-
-slug=$(basename "$plan" .md)
-[ -n "$slug" ] && [ "$slug" != "." ] && [ "$slug" != ".." ] \
-  || { echo "cannot derive a workspace name from: $plan" >&2; exit 2; }
-
-root=$(git rev-parse --show-toplevel)
-base="$root/.superpowers/sdd"
-
-# Normalize the plan path (physical directory, so relative/absolute/../
-# spellings of one plan compare equal) and express it as the marker value:
-# repo-relative when the plan lives under the repo root, absolute otherwise.
-plan_dir=$(CDPATH= cd -- "$(dirname "$plan")" && pwd -P)
-plan_abs="$plan_dir/$(basename "$plan")"
-case "$plan_abs" in
-  "$root"/*) plan_id=${plan_abs#"$root"/} ;;
-  *)         plan_id=$plan_abs ;;
-esac
-
-# True when the workspace at $1 is (or becomes) this plan's: an existing
-# marker must name this plan; a missing marker means a new workspace or a
-# pre-marker legacy one, and either way the plan claims it by writing one.
-owns() {
-  if [ -e "$1/plan-path" ]; then
-    [ "$(cat "$1/plan-path")" = "$plan_id" ]
-  else
-    mkdir -p "$1"
-    printf '%s\n' "$plan_id" > "$1/plan-path"
-  fi
-}
-
-dir="$base/$slug"
-if ! owns "$dir"; then
-  parent=$(basename "$plan_dir")
-  dir="$base/$slug-$parent"
-  if ! owns "$dir"; then
-    n=2
-    while ! owns "$base/$slug-$parent-$n"; do n=$((n + 1)); done
-    dir="$base/$slug-$parent-$n"
-  fi
-fi
-
-printf '*\n' > "$base/.gitignore"
-CDPATH= cd -- "$dir" && pwd
+#!/usr/bin/env bash
+# Resolve and ensure the working-tree directory SDD uses for one plan's
+# short-lived artifacts: task briefs, implementer reports, review packages,
+# and the progress ledger. Print the plan directory's absolute path.
+#
+# One directory per plan (.superpowers/sdd/<plan-basename>/) so a follow-up
+# plan in the same working tree can never read or overwrite another plan's
+# artifacts. A stale ledger misread as current progress makes controllers
+# skip whole task sequences — plan-scoping removes that failure structurally.
+#
+# Basename slugs collide when two plans share a filename (docs/alpha/plan.md
+# vs docs/beta/plan.md), so each workspace records its owning plan's path in
+# a plan-path marker (repo-relative in-repo, absolute outside). A workspace
+# owned by a different plan is skipped and the slug disambiguated with the
+# plan's parent-directory name, then a counter. A workspace with no marker
+# predates the marker scheme and is adopted for the current plan so in-flight
+# workspaces keep resolving — which means the first collision on such a
+# legacy workspace adopts instead of detecting; acceptable, marker-less
+# workspaces age out as plans finish.
+#
+# The workspace lives in the working tree (not under .git/) because Claude Code
+# treats .git/ as a protected path and denies agent writes there — which blocks
+# an implementer subagent from writing its report file. A self-ignoring
+# .gitignore at .superpowers/sdd/ keeps every plan's workspace out of
+# `git status` and out of accidental commits without modifying any tracked file.
+#
+# Single source of truth for the workspace location, so task-brief and
+# review-package cannot drift to different directories.
+#
+# Usage: sdd-workspace PLAN_FILE
+set -euo pipefail
+
+if [ $# -ne 1 ]; then
+  echo "usage: sdd-workspace PLAN_FILE" >&2
+  exit 2
+fi
+
+plan=$1
+[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
+
+slug=$(basename "$plan" .md)
+[ -n "$slug" ] && [ "$slug" != "." ] && [ "$slug" != ".." ] \
+  || { echo "cannot derive a workspace name from: $plan" >&2; exit 2; }
+
+root=$(git rev-parse --show-toplevel)
+base="$root/.superpowers/sdd"
+
+# Normalize the plan path (physical directory, so relative/absolute/../
+# spellings of one plan compare equal) and express it as the marker value:
+# repo-relative when the plan lives under the repo root, absolute otherwise.
+plan_dir=$(CDPATH= cd -- "$(dirname "$plan")" && pwd -P)
+plan_abs="$plan_dir/$(basename "$plan")"
+case "$plan_abs" in
+  "$root"/*) plan_id=${plan_abs#"$root"/} ;;
+  *)         plan_id=$plan_abs ;;
+esac
+
+# True when the workspace at $1 is (or becomes) this plan's: an existing
+# marker must name this plan; a missing marker means a new workspace or a
+# pre-marker legacy one, and either way the plan claims it by writing one.
+owns() {
+  if [ -e "$1/plan-path" ]; then
+    [ "$(cat "$1/plan-path")" = "$plan_id" ]
+  else
+    mkdir -p "$1"
+    printf '%s\n' "$plan_id" > "$1/plan-path"
+  fi
+}
+
+dir="$base/$slug"
+if ! owns "$dir"; then
+  parent=$(basename "$plan_dir")
+  dir="$base/$slug-$parent"
+  if ! owns "$dir"; then
+    n=2
+    while ! owns "$base/$slug-$parent-$n"; do n=$((n + 1)); done
+    dir="$base/$slug-$parent-$n"
+  fi
+fi
+
+printf '*\n' > "$base/.gitignore"
+CDPATH= cd -- "$dir" && pwd

package/skills/subagent-driven-development/scripts/sdd-workspace-lib.js

@@ -1,62 +1,62 @@
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-function runGit(args, cwd = process.cwd()) {
-    const result = spawnSync('git', args, { cwd, encoding: 'utf8' });
-    if (result.error || result.status !== 0) {
-        const detail = (result.stderr || result.error?.message || '').trim();
-        throw new Error(detail || `git ${args.join(' ')} failed`);
-    }
-    return result.stdout.trim();
-}
-
-function assertPlan(planFile) {
-    const planPath = path.resolve(planFile);
-    if (!fs.existsSync(planPath) || !fs.statSync(planPath).isFile()) {
-        throw new Error(`no such plan file: ${planFile}`);
-    }
-    return planPath;
-}
-
-function workspaceForPlan(planFile) {
-    const planPath = assertPlan(planFile);
-    const root = runGit(['rev-parse', '--show-toplevel']);
-    const base = path.join(root, '.superpowers', 'sdd');
-    const slug = path.basename(planPath, path.extname(planPath));
-    if (!slug || slug === '.' || slug === '..') {
-        throw new Error(`cannot derive a workspace name from: ${planFile}`);
-    }
-
-    const relative = path.relative(root, planPath).replace(/\\/g, '/');
-    const planId = relative && !relative.startsWith('../') && relative !== '..' && !path.isAbsolute(relative)
-        ? relative
-        : planPath.replace(/\\/g, '/');
-
-    function owns(candidate) {
-        const marker = path.join(candidate, 'plan-path');
-        if (fs.existsSync(marker)) {
-            return fs.readFileSync(marker, 'utf8').trim() === planId;
-        }
-        fs.mkdirSync(candidate, { recursive: true });
-        fs.writeFileSync(marker, `${planId}\n`);
-        return true;
-    }
-
-    let directory = path.join(base, slug);
-    if (!owns(directory)) {
-        const parent = path.basename(path.dirname(planPath));
-        directory = path.join(base, `${slug}-${parent}`);
-        if (!owns(directory)) {
-            let n = 2;
-            while (!owns(path.join(base, `${slug}-${parent}-${n}`))) n += 1;
-            directory = path.join(base, `${slug}-${parent}-${n}`);
-        }
-    }
-
-    fs.mkdirSync(base, { recursive: true });
-    fs.writeFileSync(path.join(base, '.gitignore'), '*\n');
-    return path.resolve(directory);
-}
-
-module.exports = { assertPlan, runGit, workspaceForPlan };
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+function runGit(args, cwd = process.cwd()) {
+    const result = spawnSync('git', args, { cwd, encoding: 'utf8' });
+    if (result.error || result.status !== 0) {
+        const detail = (result.stderr || result.error?.message || '').trim();
+        throw new Error(detail || `git ${args.join(' ')} failed`);
+    }
+    return result.stdout.trim();
+}
+
+function assertPlan(planFile) {
+    const planPath = path.resolve(planFile);
+    if (!fs.existsSync(planPath) || !fs.statSync(planPath).isFile()) {
+        throw new Error(`no such plan file: ${planFile}`);
+    }
+    return planPath;
+}
+
+function workspaceForPlan(planFile) {
+    const planPath = assertPlan(planFile);
+    const root = runGit(['rev-parse', '--show-toplevel']);
+    const base = path.join(root, '.superpowers', 'sdd');
+    const slug = path.basename(planPath, path.extname(planPath));
+    if (!slug || slug === '.' || slug === '..') {
+        throw new Error(`cannot derive a workspace name from: ${planFile}`);
+    }
+
+    const relative = path.relative(root, planPath).replace(/\\/g, '/');
+    const planId = relative && !relative.startsWith('../') && relative !== '..' && !path.isAbsolute(relative)
+        ? relative
+        : planPath.replace(/\\/g, '/');
+
+    function owns(candidate) {
+        const marker = path.join(candidate, 'plan-path');
+        if (fs.existsSync(marker)) {
+            return fs.readFileSync(marker, 'utf8').trim() === planId;
+        }
+        fs.mkdirSync(candidate, { recursive: true });
+        fs.writeFileSync(marker, `${planId}\n`);
+        return true;
+    }
+
+    let directory = path.join(base, slug);
+    if (!owns(directory)) {
+        const parent = path.basename(path.dirname(planPath));
+        directory = path.join(base, `${slug}-${parent}`);
+        if (!owns(directory)) {
+            let n = 2;
+            while (!owns(path.join(base, `${slug}-${parent}-${n}`))) n += 1;
+            directory = path.join(base, `${slug}-${parent}-${n}`);
+        }
+    }
+
+    fs.mkdirSync(base, { recursive: true });
+    fs.writeFileSync(path.join(base, '.gitignore'), '*\n');
+    return path.resolve(directory);
+}
+
+module.exports = { assertPlan, runGit, workspaceForPlan };

package/skills/subagent-driven-development/scripts/sdd-workspace.js

@@ -1,15 +1,15 @@
-#!/usr/bin/env node
-
-const { workspaceForPlan } = require('./sdd-workspace-lib');
-
-function main() {
-    if (process.argv.length !== 3) throw new Error('usage: sdd-workspace PLAN_FILE');
-    console.log(workspaceForPlan(process.argv[2]));
-}
-
-try {
-    main();
-} catch (error) {
-    console.error(error.message);
-    process.exitCode = 2;
-}
+#!/usr/bin/env node
+
+const { workspaceForPlan } = require('./sdd-workspace-lib');
+
+function main() {
+    if (process.argv.length !== 3) throw new Error('usage: sdd-workspace PLAN_FILE');
+    console.log(workspaceForPlan(process.argv[2]));
+}
+
+try {
+    main();
+} catch (error) {
+    console.error(error.message);
+    process.exitCode = 2;
+}

package/skills/subagent-driven-development/scripts/task-brief

@@ -1,43 +1,43 @@
-#!/usr/bin/env bash
-# Extract one task's full text from an implementation plan into a file the
-# implementer reads in one call, so the task text never has to be pasted
-# through the controller's context.
-#
-# Usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]
-# Default OUTFILE: <repo-root>/.superpowers/sdd/<plan-basename>/task-<N>-brief.md
-# (per plan and per worktree; concurrent runs of the SAME plan in the same
-# working tree share it).
-set -euo pipefail
-
-if [ $# -lt 2 ] || [ $# -gt 3 ]; then
-  echo "usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]" >&2
-  exit 2
-fi
-
-plan=$1
-n=$2
-[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
-
-if [ $# -eq 3 ]; then
-  out=$3
-else
-  # Invoke via bash rather than direct exec: some extractors (Python zipfile)
-  # strip Unix exec bits when unpacking marketplace packages (#2040).
-  dir=$("${BASH:-bash}" "$(cd "$(dirname "$0")" && pwd)/sdd-workspace" "$plan")
-  out="$dir/task-${n}-brief.md"
-fi
-
-awk -v n="$n" '
-  /^```/ { infence = !infence }
-  !infence && /^#+[ \t]+Task[ \t]+[0-9]+/ {
-    intask = ($0 ~ ("^#+[ \t]+Task[ \t]+" n "([^0-9]|$)"))
-  }
-  intask { print }
-' "$plan" > "$out"
-
-if [ ! -s "$out" ]; then
-  echo "task ${n} not found in ${plan} (no heading matching 'Task ${n}')" >&2
-  exit 3
-fi
-
-echo "wrote ${out}: $(wc -l < "$out" | tr -d ' ') lines"
+#!/usr/bin/env bash
+# Extract one task's full text from an implementation plan into a file the
+# implementer reads in one call, so the task text never has to be pasted
+# through the controller's context.
+#
+# Usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]
+# Default OUTFILE: <repo-root>/.superpowers/sdd/<plan-basename>/task-<N>-brief.md
+# (per plan and per worktree; concurrent runs of the SAME plan in the same
+# working tree share it).
+set -euo pipefail
+
+if [ $# -lt 2 ] || [ $# -gt 3 ]; then
+  echo "usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]" >&2
+  exit 2
+fi
+
+plan=$1
+n=$2
+[ -f "$plan" ] || { echo "no such plan file: $plan" >&2; exit 2; }
+
+if [ $# -eq 3 ]; then
+  out=$3
+else
+  # Invoke via bash rather than direct exec: some extractors (Python zipfile)
+  # strip Unix exec bits when unpacking marketplace packages (#2040).
+  dir=$("${BASH:-bash}" "$(cd "$(dirname "$0")" && pwd)/sdd-workspace" "$plan")
+  out="$dir/task-${n}-brief.md"
+fi
+
+awk -v n="$n" '
+  /^```/ { infence = !infence }
+  !infence && /^#+[ \t]+Task[ \t]+[0-9]+/ {
+    intask = ($0 ~ ("^#+[ \t]+Task[ \t]+" n "([^0-9]|$)"))
+  }
+  intask { print }
+' "$plan" > "$out"
+
+if [ ! -s "$out" ]; then
+  echo "task ${n} not found in ${plan} (no heading matching 'Task ${n}')" >&2
+  exit 3
+fi
+
+echo "wrote ${out}: $(wc -l < "$out" | tr -d ' ') lines"

package/skills/subagent-driven-development/scripts/task-brief.js

@@ -1,46 +1,46 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const { workspaceForPlan } = require('./sdd-workspace-lib');
-
-function extractTask(planText, taskNumber) {
-    const lines = planText.split(/\r?\n/);
-    const selected = [];
-    let inFence = false;
-    let active = false;
-    for (const line of lines) {
-        if (line.startsWith('```')) {
-            inFence = !inFence;
-        } else if (!inFence && /^#+[ \t]+Task[ \t]+[0-9]+/.test(line)) {
-            const match = line.match(/^#+[ \t]+Task[ \t]+([0-9]+)(?:[^0-9]|$)/);
-            active = Boolean(match && Number(match[1]) === taskNumber);
-        }
-        if (active) selected.push(line);
-    }
-    return selected;
-}
-
-function main() {
-    if (process.argv.length < 4 || process.argv.length > 5) {
-        throw new Error('usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]');
-    }
-    const planFile = process.argv[2];
-    const taskNumber = Number(process.argv[3]);
-    if (!Number.isInteger(taskNumber) || taskNumber < 1) throw new Error('TASK_NUMBER must be a positive integer');
-    const planPath = path.resolve(planFile);
-    if (!fs.existsSync(planPath)) throw new Error(`no such plan file: ${planFile}`);
-    const outputPath = process.argv[4] || path.join(workspaceForPlan(planFile), `task-${taskNumber}-brief.md`);
-    const selected = extractTask(fs.readFileSync(planPath, 'utf8'), taskNumber);
-    if (selected.length === 0) throw new Error(`task ${taskNumber} not found in ${planFile} (no heading matching 'Task ${taskNumber}')`);
-    const content = `${selected.join('\n')}\n`;
-    fs.writeFileSync(outputPath, content);
-    console.log(`wrote ${outputPath}: ${content.split(/\r?\n/).length - 1} lines`);
-}
-
-try {
-    main();
-} catch (error) {
-    console.error(error.message);
-    process.exitCode = 2;
-}
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { workspaceForPlan } = require('./sdd-workspace-lib');
+
+function extractTask(planText, taskNumber) {
+    const lines = planText.split(/\r?\n/);
+    const selected = [];
+    let inFence = false;
+    let active = false;
+    for (const line of lines) {
+        if (line.startsWith('```')) {
+            inFence = !inFence;
+        } else if (!inFence && /^#+[ \t]+Task[ \t]+[0-9]+/.test(line)) {
+            const match = line.match(/^#+[ \t]+Task[ \t]+([0-9]+)(?:[^0-9]|$)/);
+            active = Boolean(match && Number(match[1]) === taskNumber);
+        }
+        if (active) selected.push(line);
+    }
+    return selected;
+}
+
+function main() {
+    if (process.argv.length < 4 || process.argv.length > 5) {
+        throw new Error('usage: task-brief PLAN_FILE TASK_NUMBER [OUTFILE]');
+    }
+    const planFile = process.argv[2];
+    const taskNumber = Number(process.argv[3]);
+    if (!Number.isInteger(taskNumber) || taskNumber < 1) throw new Error('TASK_NUMBER must be a positive integer');
+    const planPath = path.resolve(planFile);
+    if (!fs.existsSync(planPath)) throw new Error(`no such plan file: ${planFile}`);
+    const outputPath = process.argv[4] || path.join(workspaceForPlan(planFile), `task-${taskNumber}-brief.md`);
+    const selected = extractTask(fs.readFileSync(planPath, 'utf8'), taskNumber);
+    if (selected.length === 0) throw new Error(`task ${taskNumber} not found in ${planFile} (no heading matching 'Task ${taskNumber}')`);
+    const content = `${selected.join('\n')}\n`;
+    fs.writeFileSync(outputPath, content);
+    console.log(`wrote ${outputPath}: ${content.split(/\r?\n/).length - 1} lines`);
+}
+
+try {
+    main();
+} catch (error) {
+    console.error(error.message);
+    process.exitCode = 2;
+}