@entelligentsia/forgecli 0.10.1 → 0.11.2

package/CHANGELOG.md

@@ -7,6 +7,84 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.2] — 2026-05-20
+
+### Fixed
+
+- **`package.json.bundledVersion` actually advanced to `0.44.6`.** The 0.11.1 CHANGELOG entry claimed bundled 0.44.6 but the manifest still read 0.44.5; downstream `/forge:update` heuristics that key off `bundledVersion` were stale.
+- **`thread-switcher.ts` — hide viewport footer when no orchestrator session is active.** `ViewportFooterComponent.render()` previously kept the row visible across sessions; now returns `[]` unless at least one session is `running` or `cancelling`, removing a permanent blank line in the editor area between sessions.
+
+---
+
+## [0.11.1] — 2026-05-20
+
+### Fixed
+
+**P1 bug-fix batch (forge-cli#25 — defects A and B) — payload packaging gaps.**
+
+- **Defect A — meta/ directory missing from bundled payload.** `scripts/build-payload.cjs` now copies `forge/forge/meta/` (personas + skills source-of-truth) into `dist/forge-payload/meta/`. Without this directory, `build-persona-pack.cjs` hashed an empty input tree and produced SHA `e3b0c4...` for every install, causing `/forge:health` to permanently flag "persona pack stale" on fresh installs.
+
+- **Defect B — three health-check tools missing from bundled payload.** `check-structure.cjs`, `list-skills.js`, and `verify-integrity.cjs` are now included in `TOOLS_TO_COPY` in `build-payload.cjs`. Previously these tools were absent from `dist/forge-payload/tools/`, causing `/forge:health` to silently skip 3 of its 14 checks on every install (reported as "(skipped — `<tool>` not available in this Forge version)").
+
+**Bundled plugin version**: 0.44.6 (defects C, D, E fixes included).
+
+---
+
+## [0.11.0] — 2026-05-20
+
+### Added
+
+**FORGE-S23: Full /forge:\* surface port + migration runner + thread cancellation**
+
+- **Migration runner (`/forge:update`)** (FORGE-S23-T01): `runMigrations()` deterministic engine. Executes pending migrations in version order, idempotent, integrated with the `/forge:update` upgrade flow. Migrations are defined in `forge-cli/dist/forge-payload/.schemas/migrations.json` and applied automatically on `forge update`.
+
+- **Validate-write hook** (FORGE-S23-T02): Port of `forge/forge/hooks/validate-write.js` as a pi `PostToolUse` hook. Full FS-level schema guard — rejects JSON writes to forge-owned paths (`.forge/store/**`, `.forge/config.json`) that violate their schema. Schema errors are surfaced in the pi notification strip.
+
+- **Triage-error hook** (FORGE-S23-T03): Port of `forge/forge/hooks/triage-error.js`. When a Bash tool call exits non-zero and matches Forge-related patterns (11 regexes), emits a `FORGE_ERROR_TRIAGE` notify suggesting `/forge:report-bug`. Non-Forge commands and successful exits are silent.
+
+- **Forge-permissions hook** (FORGE-S23-T04): Port of `forge/forge/hooks/forge-permissions.js`. Pattern-match auto-allow for forge-owned tool invocations; surfaces a permission prompt for unknown patterns.
+
+- **Check-update hook** (FORGE-S23-T05): Port of `forge/forge/hooks/check-update.js`. Full parity (5 functions): version fetch, stale-check, banner injection, changelog delta, and auto-dismiss on upgrade.
+
+- **`/forge:retrospective`** (FORGE-S23-T06): Kickoff shim. Reads the retrospective workflow and injects into the LLM conversation with the sprint context.
+
+- **`/forge:health` programmatic checks** (FORGE-S23-T07): 3 new checks added: schema integrity scan (validates `.forge/schemas/` JSON Schemas), store referential integrity (detects orphaned task/bug references), forgeRef drift detection (compares `paths.forgeRef` vs bundled plugin version). Health output now includes structured check results with pass/fail/warning states.
+
+- **`/forge:calibrate`** (FORGE-S23-T08): Orchestrator handler. Drift detection + patch proposal: reads `.forge/config.json`, compares against expected schema, proposes a patch for stale or missing fields. Allows one-shot config repair from within pi.
+
+- **`/forge:materialize` + `/forge:migrate`** (FORGE-S23-T09): Two new atomic handlers. `materialize` regenerates `.forge/` from the bundled plugin source (calls `forge:regenerate` logic). `migrate` applies pending schema migrations to the active `.forge/store/`.
+
+- **`/forge:update-tools`, `/forge:store-query`, `/forge:status`** (FORGE-S23-T10): Three new atomic handlers. `update-tools` refreshes `.forge/schemas/` from the bundled plugin. `store-query` exposes store inspection (list sprints, tasks, bugs with filters). `status` renders a sprint-status widget in the main viewport.
+
+- **6 kickoff-shim commands** (FORGE-S23-T11): `/forge:add-task`, `/forge:add-pipeline`, `/forge:quiz-agent`, `/forge:remove`, `/forge:report-bug`, `/forge:store-repair` — all now have real handlers (previously advisory stubs that fell back to the Claude Code plugin).
+
+- **Thread cancellation** (`feat/thread-cancellation`): User can cancel an in-progress orchestrator run (`/forge:run-task`, `/forge:run-sprint`, `/forge:fix-bug`) from the session-monitor strip UI. Between-phase cancellation gate in `run-task.ts` and `fix-bug.ts`. State file preserved on cancellation so runs are resumable (ADR-S21-01). Cancellation status tracked in bug state (`status: "cancelled"` vs `"halted"`).
+
+- **Structured transcript paths**: Subagent transcripts now land in `.forge/transcripts/<entityId>/<entityId>__<phase>.json` (previously `forge-subagent-<timestamp>__<persona>__<tag>.json`). Deterministic, overwrite-on-rerun, gitignored via the existing `.forge/` entry in `.gitignore`.
+
+### Changed
+
+- **`forge.bundledVersion` updated to `0.44.5`**: New installs via `/forge:init` materialize at Forge plugin 0.44.5 (was 0.44.3 since v0.10.0).
+
+### Notes
+
+- All 36 `/forge:*` commands now have real handlers. Zero advisory stubs remain.
+- Smoke matrix gate (113/113 structural checks) passes on all T06–T12 handlers for both `openai-compatible` and `anthropic` model classes (FORGE-S23-T14).
+- Sprint parity audit (FORGE-S23-T12) documents command coverage against the plugin's workflow surface.
+- Versions 0.10.4–0.10.11 were internal pre-release version bumps during sprint development; they were never published to npm. This release (0.11.0) supersedes all of them.
+
+## [0.10.3] — 2026-05-20
+
+### Added
+- **Triage-error hook — post-Bash-failure context injection** (FORGE-S23-T03).
+  When a Bash tool call exits non-zero and the command matches Forge-related patterns
+  (`FORGE_PATTERNS` — 11 regexes ported verbatim from `triage-error.js:10-20`),
+  `hook-dispatcher.ts` now calls `ctx.ui.notify` with a `FORGE_ERROR_TRIAGE` message
+  suggesting the user run `/forge:report-bug`. Non-Forge commands and successful exits
+  are silent. Port of `forge/forge/hooks/triage-error.js` for the pi extension context.
+
+## [0.10.2] — 2026-05-20
+
 ## [0.10.1] — 2026-05-19
 
 ### Fixed

package/README.md

@@ -8,7 +8,7 @@
 [![npm](https://img.shields.io/npm/v/@entelligentsia/forgecli?style=flat-square&color=000&label=npm)](https://www.npmjs.com/package/@entelligentsia/forgecli)
 [![node](https://img.shields.io/badge/node-%E2%89%A520-000?style=flat-square)](#)
 [![license](https://img.shields.io/badge/license-MIT-000?style=flat-square)](#)
-[![forge plugin](https://img.shields.io/badge/forge--plugin-v0.43.16-000?style=flat-square&labelColor=fafafa)](https://github.com/Entelligentsia/forge)
+[![forge plugin](https://img.shields.io/badge/forge--plugin-v0.44.5-000?style=flat-square&labelColor=fafafa)](https://github.com/Entelligentsia/forge)
 [![pi runtime](https://img.shields.io/badge/runtime-pi--coding--agent-000?style=flat-square)](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)
 
 </div>
@@ -77,12 +77,20 @@ Idempotent and resumable. Re-running picks up at the last checkpoint via `.forge
 ```
 SETUP    /forge:init          Bootstrap Forge SDLC into the project
          /forge:regenerate    Refresh generated workflows + KB
+         /forge:materialize   Fill in stub artifacts after fast-mode init
+         /forge:migrate       Schema + structural migration of legacy stores
          /forge:update        Check for + apply forge-cli updates
+         /forge:update-tools  Refresh .forge/schemas/ to bundled version
+         /forge:add-pipeline  Add or customize a pipeline interactively
          /forge:remove        Tear down the Forge install
 
 RUN      /forge:run-task      Execute one task pipeline end-to-end
          /forge:run-sprint    Orchestrate every task in a sprint
          /forge:fix-bug       Triage + fix flow
+         /forge:sprint-intake Elicit sprint requirements
+         /forge:sprint-plan   Decompose a sprint into tasks
+         /forge:add-task      Add a task to an existing sprint mid-flight
+         /forge:retrospective Produce a sprint retrospective document
 
 CHAIN    /forge:plan          plan
          /forge:implement     implement
@@ -96,6 +104,11 @@ ASK      /forge:health        KB freshness + store integrity
          /forge:status        Sprint + task status
          /forge:ask <q>       Ask the Tomoshibi concierge
          /forge:config        Set up AI models for your workflow
+         /forge:store-query   Query the JSON store by NLP or flags
+         /forge:store-repair  Diagnose + repair corrupted store records
+         /forge:quiz-agent    Verify an agent has loaded the KB
+         /forge:calibrate     Detect KB↔agent drift, propose patches
+         /forge:report-bug    File a Forge bug as a GitHub issue
 ```
 
 → [Full reference](docs/cli-reference.md) · [Non-interactive mode](docs/non-interactive.md) · [Hook safety net](docs/hook-safety-net.md) · [Custom tools](docs/custom-tools.md) · [Publishing](docs/publishing.md)
@@ -309,6 +322,8 @@ before forge-cli's extension hook runs.
 
 | Up next                                            | Status              |
 |----------------------------------------------------|---------------------|
+| Full `/forge:*` surface + 4 hooks + migration runner | Shipped (0.11.0)  |
+| Pi-aligned data layout under `~/.pi/forge-cli/`    | Shipped (0.10.0)    |
 | Per-persona model routing + tiered config TUI      | Shipped (0.9.0)     |
 | 4ge brand wordmark in CLI banner + 3 themes        | Shipped (0.7.7)     |
 | Slim README + docs/ split                          | Shipped (0.7.7)     |
@@ -316,7 +331,6 @@ before forge-cli's extension hook runs.
 | Bundled plugin command markdowns                   | Shipped (0.7.6)     |
 | `/forge:run-task`, `run-sprint`, `fix-bug`         | Shipped (0.7.5)     |
 | Atomic chain shims (`/forge:plan` … `commit`) ×6   | Shipped (0.7.5)     |
-| Port admin commands (`migrate`, `calibrate`, …)    | Roadmap             |
 
 → Full roadmap + history: [CHANGELOG.md](CHANGELOG.md)
 
@@ -348,6 +362,10 @@ MIT © Entelligentsia
   0.5.0 · 0.5.1 · 0.5.2 · 0.5.3 · 0.5.4 · 0.5.5 · 0.5.6 · 0.5.7 ·
   0.6.1 · 0.6.2 · 0.6.3 · 0.6.4 · 0.6.5 · 0.6.6 ·
   0.7.0 · 0.7.1 · 0.7.2 · 0.7.3 · 0.7.4 · 0.7.5 · 0.7.6 · 0.7.7 ·
-  0.8.0 · 0.8.1 · 0.8.2 · 0.8.3 · 0.8.4 · 0.9.0
+  0.7.8 · 0.7.9 · 0.7.10 · 0.7.11 ·
+  0.8.0 · 0.8.1 · 0.8.2 · 0.8.3 · 0.8.4 ·
+  0.9.0 · 0.9.1 · 0.9.2 · 0.9.3 · 0.9.4 ·
+  0.10.0 · 0.10.1 · 0.10.2 · 0.10.3 ·
+  0.11.0
 -->
 

package/dist/CHANGELOG-forge-plugin.md

@@ -5,6 +5,28 @@ Format: newest first. Breaking changes are marked **△ Breaking**.
 
 ---
 
+## [0.44.6] — 2026-05-20
+
+**P1 bug-fix batch (forge-cli#25 — defects C, D, E).** Three tool fixes to address defects discovered in the forge-cli 0.11.0 dogfooding session.
+
+**C — substitute-placeholders.cjs base-pack path stale.** Tool now probes `.base-pack/` (bundled install layout) before `init/base-pack` (source layout) when no `--base-pack` flag is supplied. `--help`/`-h` now short-circuits before any path resolution so the usage text is always accessible.
+
+**D — store-cli list event.** The `list` subcommand previously exited 1 with "Unknown entity type: event" despite `event` being in the documented entity set. Fixed by adding an `event` case to `listEntities()` that traverses all sub-directories under `.forge/store/events/` (`bugs/`, `enhancement/`, and per-sprint `<sprintId>/` dirs) and returns the union. Sidecar files (`_`-prefixed) are skipped.
+
+**E — substitute-placeholders.cjs --category flag.** New `--category <name[,name]>` flag limits materialisation to the specified subdirectory names (e.g. `--category personas` writes only `.forge/personas/` and skips workflows, skills, templates, and commands). `commands/regenerate.md` documents the scope-enforcement rule for callers that invoke the tool directly during per-category regeneration.
+
+**Regenerate:** tools:substitute-placeholders, tools:store-cli, commands:regenerate
+
+---
+
+## [0.44.5] — 2026-05-20
+
+**Migration apply path + config schema.** Two FORGE-S23 contributions to the plugin distribution. First, `migrations.json` gains the `0.44.4→0.44.5` entry consumed by forge-cli's new `runMigrations()` deterministic engine: semver-range traversal `[from, to)` on keys, per-category resolver covering 84 unique category strings, idempotency ledger at `.forge/applied-migrations.json`, always-on schema refresh post-pass, fileOps forward-compat, and path-traversal defense. The `/forge:update` flow in forge-cli prompts to apply pending migrations after upgrade (`FORGE_NON_INTERACTIVE=1` auto-applies); the `update_plan` and `plan_task` workflows reference the new application steps. Second, `forge/schemas/config.schema.json` is added so the validate-write hook (also ported to forge-cli in this sprint) can enforce `.forge/config.json` structure at write time. No tool or persona changes — the plugin's role is to ship the migration entry and the new schema; the engine lives in forge-cli (v0.11.0).
+
+**Regenerate:** workflows:update_plan, workflows:plan_task
+
+---
+
 ## [0.44.4] — 2026-05-19
 
 **Supervisor persona forbids FSM writes from review phases.** `meta-supervisor.md` gains a top-level Iron Law: "The Supervisor NEVER writes entity status — the workflow orchestrator owns all FSM transitions. Do not call `store-cli update-status` from a review phase. The verdict signal travels through the SUMMARY's `verdict` field, not `entity.status`." The workflow-level guard at `meta-review-plan.md:76` and `meta-review-implementation.md:82` ("Bug mode — NO status write") already existed; this is the persona-level reinforcement so the model never attempts the write in the first place. Surfaced during FORGE-BUG-003 re-run testing of the forge-cli stale-ctx fix: a supervisor subagent called `update-status bug FORGE-BUG-003 status plan-approved` against a bug already in terminal `fixed` state. `store-cli` correctly rejected the illegal transition and the run completed (the rails held), but the persona now discourages the attempt.

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:regenerate 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:regenerate 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

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

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

package/dist/extensions/forgecli/calibrate.d.ts

@@ -0,0 +1,61 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { type CalibrationBaseline } from "./init-context.js";
+export interface ParsedCalibrateFlags {
+    /** Override project directory (from --path <dir>). Null = use cwd. */
+    path: string | null;
+}
+/**
+ * Parse /forge:calibrate arguments.
+ * Supports: --path <dir>
+ */
+export declare function parseCalibrateFlags(args: string): ParsedCalibrateFlags;
+export interface ForgeConfig {
+    paths?: {
+        engineering?: string;
+        forgeRoot?: string;
+        store?: string;
+    };
+    calibrationBaseline?: Partial<CalibrationBaseline> & {
+        masterIndexHash?: string | null;
+    };
+    calibrationHistory?: CalibrationHistoryEntry[];
+    [key: string]: unknown;
+}
+/** Read and parse .forge/config.json from projectRoot. Returns null on any error. */
+export declare function readForgeConfig(projectRoot: string): ForgeConfig | null;
+/**
+ * Compute SHA-256 of MASTER_INDEX.md, stripping blank lines and HTML comment lines.
+ * Returns null if the file does not exist.
+ */
+export declare function computeCurrentHash(projectRoot: string, kbPath: string): string | null;
+export interface DriftCategory {
+    category: "technical" | "business" | "retrospective" | "acceptance criteria";
+    evidence: string;
+    targets: string[];
+}
+/**
+ * Categorize drift by scanning MASTER_INDEX.md content for section keywords
+ * and identifying new sprints since last calibration.
+ */
+export declare function categorizeDrift(projectRoot: string, kbPath: string, baseline: Partial<CalibrationBaseline> & {
+    masterIndexHash?: string | null;
+}): DriftCategory[];
+export interface PatchProposal {
+    target: string;
+    type: "regenerate";
+    rationale: string;
+}
+/** Extract PatchProposal objects from the architect's free-form response text. */
+export declare function extractPatchProposals(text: string): PatchProposal[];
+export interface CalibrationHistoryPatch {
+    target: string;
+    type: "regenerate";
+    applied: boolean;
+}
+export interface CalibrationHistoryEntry {
+    date: string;
+    version: string;
+    categories: string[];
+    patches: CalibrationHistoryPatch[];
+}
+export declare function registerCalibrate(pi: ExtensionAPI): void;