@entelligentsia/forgecli 1.0.25 → 1.0.36

package/dist/bin/init.js

@@ -0,0 +1,123 @@
+// forge init — deterministic Claude Code project bootstrap (FORGE-S31-T02).
+//
+// `4ge init claude [dir]` scaffolds a Claude Code project from the bundled
+// forge-payload in seconds: zero LLM tokens, zero network, pure fs.
+//
+// Structural convention: follows runDoctor / runUpdate / runConfig.
+//   - parseInitArgs(args): pure arg parser
+//   - runInit(args): async entry point, returns exit code
+//
+// Iron-Law boundary (IL6): no shell-string interpolation. If shell-outs are
+// ever added they MUST use argv-array spawn, not execSync with a string.
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { bootstrapClaudeProject } from "../extensions/forgecli/claude-bootstrap/bootstrap.js";
+// ── Payload root resolution (same logic as forge-init.ts) ─────────────────────
+const _BIN_DIR = path.dirname(fileURLToPath(import.meta.url));
+// dist/bin/init.js → dist/ → <pkg-root>/
+const _DIST_DIR = path.resolve(_BIN_DIR, "..");
+const _PKG_ROOT = path.resolve(_DIST_DIR, "..");
+function getBundledPayloadRoot() {
+    return path.join(_PKG_ROOT, "dist", "forge-payload");
+}
+/**
+ * Parse subcommand args for `forge init`.
+ *
+ * Expected forms:
+ *   forge init claude           → dir = process.cwd()
+ *   forge init claude <dir>     → dir = <dir>
+ *   forge init                  → error: platform required
+ *   forge init <other>          → error: unknown platform
+ */
+export function parseInitArgs(args) {
+    if (args.length === 0) {
+        return {
+            error: "forge init: platform argument required.\n" +
+                "Usage: forge init claude [dir]\n" +
+                "  claude    Bootstrap a Claude Code (.claude/) project",
+        };
+    }
+    const platform = args[0];
+    if (platform !== "claude") {
+        return {
+            error: `forge init: unknown platform '${platform}'.\n` +
+                "Supported platforms: claude\n" +
+                "Usage: forge init claude [dir]",
+        };
+    }
+    // Optional dir arg — defaults to cwd
+    const dir = args[1] ? path.resolve(args[1]) : process.cwd();
+    return { platform: "claude", dir };
+}
+/**
+ * Entry point invoked from bin/forge.ts.
+ *
+ * Returns exit code: 0 on success, 1 on bootstrap error.
+ */
+export async function runInit(args) {
+    const parsed = parseInitArgs(args);
+    if ("error" in parsed) {
+        process.stderr.write(`${parsed.error}\n`);
+        return 1;
+    }
+    const { dir } = parsed;
+    const payloadRoot = getBundledPayloadRoot();
+    process.stdout.write(`forge init claude — bootstrapping ${dir}\n`);
+    let result;
+    try {
+        result = bootstrapClaudeProject({ dir, payloadRoot });
+    }
+    catch (err) {
+        const e = err;
+        process.stderr.write(`forge init: bootstrap failed: ${e.message ?? String(err)}\n`);
+        return 1;
+    }
+    if (!result.ok) {
+        for (const w of result.warnings) {
+            process.stderr.write(`  ✗ ${w}\n`);
+        }
+        process.stderr.write("forge init: bootstrap failed — see warnings above.\n");
+        return 1;
+    }
+    // Print success summary
+    if (result.created.length > 0) {
+        process.stdout.write(`\nCreated (${result.created.length}):\n`);
+        for (const p of result.created) {
+            process.stdout.write(`  + ${p}\n`);
+        }
+    }
+    if (result.skipped.length > 0) {
+        process.stdout.write(`\nAlready present (${result.skipped.length}):\n`);
+        process.stdout.write(`  ○ ${result.skipped.length} paths verified unchanged\n`);
+    }
+    if (result.warnings.length > 0) {
+        process.stdout.write(`\nWarnings:\n`);
+        for (const w of result.warnings) {
+            process.stdout.write(`  △ ${w}\n`);
+        }
+    }
+    // Hand-off message (FORGE-S31-T03): names /forge:init, lists 7 hooks, mentions one-time approval prompt.
+    // Prepend preflight warning if Claude Code was not found.
+    const claudeUnavailableWarning = result.preflight.claudeAvailable
+        ? ""
+        : "  Warning: Claude Code not found on PATH — install before opening this project.\n\n";
+    process.stdout.write(`\n✓ forge init complete — project bootstrapped in ${dir}\n` +
+        `\nNext step:\n` +
+        `${claudeUnavailableWarning}` +
+        `  Open Claude Code in ${dir} and run: /forge:init\n` +
+        `\nWhat to expect:\n` +
+        `  Claude Code will ask you to approve 7 project hooks (one-time prompt).\n` +
+        `  Approve them — they are scoped to this project only.\n` +
+        `\n  Hooks registered:\n` +
+        `    • check-update       (SessionStart)\n` +
+        `    • preflight-session  (SessionStart)\n` +
+        `    • validate-write     (PreToolUse — Write/Edit/MultiEdit)\n` +
+        `    • triage-error       (PostToolUse — Bash)\n` +
+        `    • query-logger       (PostToolUse — Bash)\n` +
+        `    • post-init          (PostToolUse — Bash)\n` +
+        `    • post-sprint        (PostToolUse — Bash)\n` +
+        `\n  After approval, /forge:init runs discovery, KB generation,\n` +
+        `  and project configuration. Zero tokens until you open Claude Code.\n`);
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/bin/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":"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"}

package/dist/bin/uninstall.d.ts

@@ -0,0 +1,20 @@
+export interface UninstallArgs {
+    platform: "claude";
+    dir: string;
+    purge: boolean;
+    yes: boolean;
+}
+export interface UninstallArgsError {
+    error: string;
+}
+/**
+ * Parse subcommand args for `forge uninstall`.
+ *
+ * Expected forms:
+ *   forge uninstall claude                 → dir = cwd
+ *   forge uninstall claude <dir>           → dir = <dir>
+ *   forge uninstall claude [dir] --purge   → also remove config + store
+ *   forge uninstall claude [dir] --yes|-y  → skip the [y/N] confirm
+ */
+export declare function parseUninstallArgs(args: readonly string[]): UninstallArgs | UninstallArgsError;
+export declare function runUninstall(args: readonly string[]): Promise<number>;

package/dist/bin/uninstall.js

@@ -0,0 +1,141 @@
+// forge uninstall — deterministic reverse of `4ge init claude` (counterpart to init.ts).
+//
+// `4ge uninstall claude [dir] [--purge] [--yes]` removes the Forge scaffold a
+// prior `4ge init claude` placed in a project. By default it preserves user
+// data (.forge/config.json, .forge/store/**, the KB folder); --purge also
+// removes the config + store. A [y/N] confirmation guards the destructive op
+// unless --yes / -y or FORGE_NON_INTERACTIVE=1.
+//
+// Structural convention mirrors init.ts / update-cli.ts:
+//   - parseUninstallArgs(args): pure arg parser
+//   - runUninstall(args): async entry point, returns exit code
+//
+// Iron-Law boundary (IL6): no shell-string interpolation; pure fs in the core.
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { fileURLToPath } from "node:url";
+import { uninstallClaudeProject } from "../extensions/forgecli/claude-bootstrap/uninstall.js";
+// ── Payload root resolution (same logic as init.ts) ───────────────────────────
+const _BIN_DIR = path.dirname(fileURLToPath(import.meta.url));
+const _DIST_DIR = path.resolve(_BIN_DIR, "..");
+const _PKG_ROOT = path.resolve(_DIST_DIR, "..");
+function getBundledPayloadRoot() {
+    return path.join(_PKG_ROOT, "dist", "forge-payload");
+}
+/**
+ * Parse subcommand args for `forge uninstall`.
+ *
+ * Expected forms:
+ *   forge uninstall claude                 → dir = cwd
+ *   forge uninstall claude <dir>           → dir = <dir>
+ *   forge uninstall claude [dir] --purge   → also remove config + store
+ *   forge uninstall claude [dir] --yes|-y  → skip the [y/N] confirm
+ */
+export function parseUninstallArgs(args) {
+    if (args.length === 0) {
+        return {
+            error: "forge uninstall: platform argument required.\n" +
+                "Usage: forge uninstall claude [dir] [--purge] [--yes]\n" +
+                "  claude    Remove the Forge scaffold from a Claude Code (.claude/) project",
+        };
+    }
+    const platform = args[0];
+    if (platform !== "claude") {
+        return {
+            error: `forge uninstall: unknown platform '${platform}'.\n` +
+                "Supported platforms: claude\n" +
+                "Usage: forge uninstall claude [dir] [--purge] [--yes]",
+        };
+    }
+    let dir;
+    let purge = false;
+    let yes = false;
+    for (const t of args.slice(1)) {
+        if (t === "--purge") {
+            purge = true;
+        }
+        else if (t === "--yes" || t === "-y") {
+            yes = true;
+        }
+        else if (t.startsWith("-")) {
+            return {
+                error: `forge uninstall: unknown option ${t}. Valid options: --purge, --yes`,
+            };
+        }
+        else if (dir === undefined) {
+            dir = path.resolve(t);
+        }
+        else {
+            return { error: `forge uninstall: unexpected extra argument '${t}'.` };
+        }
+    }
+    return { platform: "claude", dir: dir ?? process.cwd(), purge, yes };
+}
+// ── Confirmation prompt (mirrors update-cli.ts) ───────────────────────────────
+async function askConfirm(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(`${question} [y/N] `, (answer) => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+    });
+}
+// ── Entry point ───────────────────────────────────────────────────────────────
+export async function runUninstall(args) {
+    const parsed = parseUninstallArgs(args);
+    if ("error" in parsed) {
+        process.stderr.write(`${parsed.error}\n`);
+        return 1;
+    }
+    const { dir, purge, yes } = parsed;
+    const payloadRoot = getBundledPayloadRoot();
+    // Confirmation gate (skipped by --yes / -y / FORGE_NON_INTERACTIVE=1).
+    const autoYes = yes || process.env.FORGE_NON_INTERACTIVE === "1";
+    if (!autoYes) {
+        const scope = purge
+            ? "the Forge scaffold AND your .forge/config.json + .forge/store/** (sprints, tasks, bugs, events)"
+            : "the Forge scaffold (config.json, store, and the KB folder are preserved)";
+        process.stdout.write(`forge uninstall claude — this will remove ${scope} from:\n  ${dir}\n`);
+        const proceed = await askConfirm("Proceed?");
+        if (!proceed) {
+            process.stdout.write("forge uninstall: aborted — nothing was removed.\n");
+            return 0;
+        }
+    }
+    let result;
+    try {
+        result = uninstallClaudeProject({ dir, payloadRoot, purge });
+    }
+    catch (err) {
+        const e = err;
+        process.stderr.write(`forge uninstall: failed: ${e.message ?? String(err)}\n`);
+        return 1;
+    }
+    if (!result.bootstrapped) {
+        for (const w of result.warnings)
+            process.stderr.write(`  ✗ ${w}\n`);
+        return 1;
+    }
+    if (result.removed.length > 0) {
+        process.stdout.write(`\nRemoved (${result.removed.length}):\n`);
+        for (const p of result.removed)
+            process.stdout.write(`  - ${p}\n`);
+    }
+    else {
+        process.stdout.write("\nNothing to remove — project already clean of the Forge scaffold.\n");
+    }
+    if (result.kept.length > 0) {
+        process.stdout.write(`\nPreserved (user data — use --purge to remove):\n`);
+        for (const p of result.kept)
+            process.stdout.write(`  ○ ${p}\n`);
+    }
+    if (result.warnings.length > 0) {
+        process.stdout.write(`\nWarnings:\n`);
+        for (const w of result.warnings)
+            process.stdout.write(`  △ ${w}\n`);
+    }
+    process.stdout.write(`\n✓ forge uninstall complete — ${dir}\n`);
+    return result.ok ? 0 : 1;
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/bin/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../src/bin/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/add-pipeline.d.ts

@@ -0,0 +1,19 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export type AddPipelineMode = "add" | "edit" | "view" | "remove";
+export interface ParsedAddPipelineArgs {
+    mode: AddPipelineMode;
+    pipelineName: string | null;
+    seed: string;
+    sourceLabel: string;
+}
+export declare function parseAddPipelineArgs(rawArgs: string, cwd: string): ParsedAddPipelineArgs;
+export interface ComposeAddPipelineKickoffOpts {
+    commandMd: string;
+    parsed: ParsedAddPipelineArgs;
+}
+export declare function composeAddPipelineKickoff(opts: ComposeAddPipelineKickoffOpts): string;
+export interface RegisterAddPipelineOptions {
+    forgeRoot: string | null;
+    cwd?: string;
+}
+export declare function registerAddPipeline(pi: ExtensionAPI, options: RegisterAddPipelineOptions): void;

package/dist/extensions/forgecli/add-pipeline.js

@@ -0,0 +1,143 @@
+// forge:add-pipeline — native kickoff handler (FORGE-S23-T11).
+//
+// Replaces the auto-generated stub previously installed by
+// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
+// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
+//
+// Parses --add/--edit/--view/--remove/--list/--name flags and a plain
+// pipeline name before dispatching. Resolved mode is prepended to the
+// kickoff so the LLM starts in the correct mode without prompting.
+//
+// Workflow source: <forgeRoot>/commands/add-pipeline.md (command file).
+// File-existence check only — command files lack Pack-06 workflow markers.
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL4 — no JSON.stringify-into-subagent dispatch.
+//   IL6 — no shell-string interpolation; no spawn calls here.
+//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
+//         continuation.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { sendKickoff } from "./kickoff.js";
+export function parseAddPipelineArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    const result = {
+        mode: "add",
+        pipelineName: null,
+        seed: "",
+        sourceLabel: "",
+    };
+    if (!trimmed) {
+        result.sourceLabel = "(no args — LLM will ask intent)";
+        return result;
+    }
+    const tokens = trimmed.split(/\s+/);
+    const remaining = [];
+    for (let i = 0; i < tokens.length; i++) {
+        const tok = tokens[i];
+        if (tok === "--add") {
+            result.mode = "add";
+        }
+        else if (tok === "--edit") {
+            result.mode = "edit";
+        }
+        else if (tok === "--view" || tok === "--list") {
+            result.mode = "view";
+        }
+        else if (tok === "--remove") {
+            result.mode = "remove";
+        }
+        else if (tok === "--name" && i + 1 < tokens.length) {
+            result.pipelineName = tokens[++i];
+        }
+        else {
+            remaining.push(tok);
+        }
+    }
+    const tail = remaining.join(" ").trim();
+    if (tail.startsWith("@")) {
+        const ref = tail.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        result.seed = fs.readFileSync(filePath, "utf8");
+        result.sourceLabel = `(seed from file: ${ref})`;
+    }
+    else if (tail) {
+        // A bare word with no mode flag = pipeline name, default mode "add"
+        if (!result.pipelineName && !/^--/.test(tail)) {
+            result.pipelineName = tail;
+        }
+        else {
+            result.seed = tail;
+        }
+        result.sourceLabel = "(from inline text)";
+    }
+    return result;
+}
+// ── Kickoff composition ───────────────────────────────────────────────────
+const MODE_LABELS = {
+    add: "Add a new pipeline",
+    edit: "Customize an existing pipeline",
+    view: "View configured pipelines",
+    remove: "Remove a pipeline",
+};
+export function composeAddPipelineKickoff(opts) {
+    const { commandMd, parsed } = opts;
+    const sections = ["# /forge:add-pipeline", ""];
+    sections.push("## Dispatch", "");
+    sections.push(`Start in **Mode: ${MODE_LABELS[parsed.mode]}**.`);
+    if (parsed.pipelineName) {
+        sections.push(`Pipeline name: \`${parsed.pipelineName}\``);
+    }
+    sections.push("");
+    sections.push("Run the pipeline manager command below. Use `forge_store` for all config reads and writes. " +
+        "Read `.forge/config.json` directly when you need the pipelines section.");
+    sections.push("", "---", "", "## Command", "", commandMd.trim(), "", "---");
+    if (parsed.seed) {
+        sections.push("", `## Additional Input — ${parsed.sourceLabel}`, "", parsed.seed.trim());
+    }
+    return sections.join("\n");
+}
+// ── Registration ──────────────────────────────────────────────────────────
+const COMMAND_NAME = "add-pipeline";
+export function registerAddPipeline(pi, options) {
+    pi.registerCommand("forge:add-pipeline", {
+        description: "Conversational pipeline manager — add, customize, view, or remove Forge pipelines. " +
+            "Usage: /forge:add-pipeline [--add|--edit|--view|--remove] [--name <name>] [<pipeline-name>]",
+        async handler(args, ctx) {
+            const { forgeRoot } = options;
+            const cwd = options.cwd ?? process.cwd();
+            if (!forgeRoot) {
+                ctx.ui.notify("× forge:add-pipeline — no Forge project at cwd; run /forge:init to bootstrap", "warning");
+                return;
+            }
+            const commandPath = path.join(forgeRoot, "commands", `${COMMAND_NAME}.md`);
+            let commandMd;
+            try {
+                commandMd = fs.readFileSync(commandPath, "utf8");
+            }
+            catch (err) {
+                const e = err;
+                if (e.code === "ENOENT") {
+                    ctx.ui.notify(`× forge:add-pipeline — command file not found at commands/${COMMAND_NAME}.md; run /forge:init or /forge:rebuild first.`, "error");
+                }
+                else {
+                    ctx.ui.notify(`× forge:add-pipeline — failed to read command file: ${e.message ?? "unknown error"}`, "error");
+                }
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseAddPipelineArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:add-pipeline — failed to parse args: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            const kickoff = composeAddPipelineKickoff({ commandMd, parsed });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=add-pipeline.js.map

package/dist/extensions/forgecli/add-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-pipeline.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/add-pipeline.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/add-task.d.ts

@@ -0,0 +1,20 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface ParsedAddTaskArgs {
+    sprintId: string | null;
+    title: string | null;
+    estimate: string | null;
+    pipeline: string | null;
+    seed: string;
+    sourceLabel: string;
+}
+export declare function parseAddTaskArgs(rawArgs: string, cwd: string): ParsedAddTaskArgs;
+export interface ComposeAddTaskKickoffOpts {
+    commandMd: string;
+    parsed: ParsedAddTaskArgs;
+}
+export declare function composeAddTaskKickoff(opts: ComposeAddTaskKickoffOpts): string;
+export interface RegisterAddTaskOptions {
+    forgeRoot: string | null;
+    cwd?: string;
+}
+export declare function registerAddTask(pi: ExtensionAPI, options: RegisterAddTaskOptions): void;

package/dist/extensions/forgecli/add-task.js

@@ -0,0 +1,154 @@
+// forge:add-task — native kickoff handler (FORGE-S23-T11).
+//
+// Replaces the auto-generated stub previously installed by
+// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
+// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
+//
+// This handler reads commands/add-task.md from the bundled forge payload,
+// forwards any provided argv shortcuts (--sprint, --title, --estimate,
+// --pipeline) in the kickoff body so the LLM skips those interview steps,
+// and dispatches via pi.sendUserMessage with { deliverAs: "steer" }.
+//
+// Note: The task prompt mentions "store-cli --next-id pre-flight", but
+// store-cli has no next-id subcommand. The ID is computed by the LLM
+// from the sprint record (per Step 3 in the command file). The handler
+// only forwards shortcuts to reduce LLM round-trips.
+//
+// Workflow source: <forgeRoot>/commands/add-task.md (command file).
+// File-existence check only (not Pack-06 4-marker check) — command files
+// are simpler than full workflow files and lack the required markers.
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL4 — no JSON.stringify-into-subagent dispatch.
+//   IL6 — no shell-string interpolation; no spawn calls here.
+//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
+//         continuation.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { sendKickoff } from "./kickoff.js";
+export function parseAddTaskArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    const result = {
+        sprintId: null,
+        title: null,
+        estimate: null,
+        pipeline: null,
+        seed: "",
+        sourceLabel: "",
+    };
+    if (!trimmed) {
+        result.sourceLabel = "(no args — LLM will conduct full interview)";
+        return result;
+    }
+    // Parse known flags
+    const tokens = trimmed.split(/\s+/);
+    const remaining = [];
+    for (let i = 0; i < tokens.length; i++) {
+        const tok = tokens[i];
+        if (tok === "--sprint" && i + 1 < tokens.length) {
+            result.sprintId = tokens[++i];
+        }
+        else if (tok === "--title" && i + 1 < tokens.length) {
+            result.title = tokens[++i];
+        }
+        else if (tok === "--estimate" && i + 1 < tokens.length) {
+            result.estimate = tokens[++i];
+        }
+        else if (tok === "--pipeline" && i + 1 < tokens.length) {
+            result.pipeline = tokens[++i];
+        }
+        else {
+            remaining.push(tok);
+        }
+    }
+    // Remaining tokens: @<file> or free-form text
+    const tail = remaining.join(" ").trim();
+    if (tail.startsWith("@")) {
+        const ref = tail.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        result.seed = fs.readFileSync(filePath, "utf8");
+        result.sourceLabel = `(seed from file: ${ref})`;
+    }
+    else if (tail) {
+        result.seed = tail;
+        result.sourceLabel = "(seed from inline text)";
+    }
+    else {
+        result.sourceLabel = "(shortcuts provided)";
+    }
+    return result;
+}
+export function composeAddTaskKickoff(opts) {
+    const { commandMd, parsed } = opts;
+    const shortcuts = [];
+    if (parsed.sprintId)
+        shortcuts.push(`--sprint ${parsed.sprintId}`);
+    if (parsed.title)
+        shortcuts.push(`--title "${parsed.title}"`);
+    if (parsed.estimate)
+        shortcuts.push(`--estimate ${parsed.estimate}`);
+    if (parsed.pipeline)
+        shortcuts.push(`--pipeline ${parsed.pipeline}`);
+    const sections = ["# /forge:add-task", ""];
+    sections.push("## Dispatch", "");
+    sections.push("Run the add-task command below to add a new task to an existing sprint. Specifically:");
+    sections.push("");
+    sections.push("1. Follow the command file steps in order.");
+    if (shortcuts.length > 0) {
+        sections.push(`2. The following shortcuts were provided — skip the corresponding interview steps: \`${shortcuts.join(" ")}\``);
+    }
+    sections.push(`${shortcuts.length > 0 ? "3" : "2"}. Use \`forge_store\` for all store reads and writes (never raw bash \`forge store\`).`);
+    sections.push(`${shortcuts.length > 0 ? "4" : "3"}. Compute the next task ID from the sprint record's \`taskIds\` array per Step 3 in the command file.`);
+    sections.push("", "---", "", "## Command", "", commandMd.trim(), "", "---");
+    if (parsed.seed) {
+        sections.push("", `## Additional Input — ${parsed.sourceLabel}`, "", parsed.seed.trim());
+    }
+    else if (shortcuts.length === 0) {
+        sections.push("", "## Input", "", "(no args — begin mini-intake interview)");
+    }
+    return sections.join("\n");
+}
+// ── Registration ──────────────────────────────────────────────────────────
+const COMMAND_NAME = "add-task";
+export function registerAddTask(pi, options) {
+    pi.registerCommand("forge:add-task", {
+        description: "Add a new task to an existing sprint mid-flight — mini intake, sequential ID assignment, store write. " +
+            "Usage: /forge:add-task [--sprint <ID>] [--title <text>] [--estimate <S|M|L|XL>] [--pipeline <name>] [@<file> | <text>]",
+        async handler(args, ctx) {
+            const { forgeRoot } = options;
+            const cwd = options.cwd ?? process.cwd();
+            if (!forgeRoot) {
+                ctx.ui.notify("× forge:add-task — no Forge project at cwd; run /forge:init to bootstrap", "warning");
+                return;
+            }
+            const commandPath = path.join(forgeRoot, "commands", `${COMMAND_NAME}.md`);
+            let commandMd;
+            try {
+                commandMd = fs.readFileSync(commandPath, "utf8");
+            }
+            catch (err) {
+                const e = err;
+                if (e.code === "ENOENT") {
+                    ctx.ui.notify(`× forge:add-task — command file not found at commands/${COMMAND_NAME}.md; run /forge:init or /forge:rebuild first.`, "error");
+                }
+                else {
+                    ctx.ui.notify(`× forge:add-task — failed to read command file: ${e.message ?? "unknown error"}`, "error");
+                }
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseAddTaskArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:add-task — failed to parse args: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            const kickoff = composeAddTaskKickoff({ commandMd, parsed });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=add-task.js.map