@entelligentsia/forgecli 0.3.0 → 0.6.6

package/CHANGELOG.md

@@ -7,6 +7,386 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.6] — 2026-05-15
+
+Sprint finalization ceremony (Plan 12). Pairs with forge-plugin 0.43.16.
+
+### Added
+
+- `dispatchSprintCeremony` helper in `run-sprint.ts` dispatches architect subagent
+  against the materialized `architect_review_sprint_completion` workflow for sprint
+  finalization. The orchestrator (not the subagent) owns event emission (Slice-2
+  contract). Three exit branches per the Plan 12 truth table:
+  - **Clean-complete**: architect ceremony in `mode: "complete"`, sprint transitions
+    to `completed`, emit `sprint-complete` event with `verdict: "complete"`.
+  - **User-paused** (>=1 task done): architect ceremony in `mode: "partial"`, sprint
+    transitions to `partially-completed`, emit `sprint-complete` event with
+    `verdict: "partial"` and `pausedAfterTaskIndex`.
+  - **User-paused** (0 tasks done): no ceremony, no event, state persisted.
+  - **Halted-on-failure**: no ceremony, emit `sprint-halted` event with
+    `haltedAtTaskIndex`, `haltedAtTaskId`, `lastError`; state persisted with
+    `halted: true`.
+- `sprint-halted` event emission on task failure (no ceremony dispatch, per Plan 12 section 3).
+- Schema-validated `sprint-complete` and `sprint-halted` events with forward-compat
+  `waveCount` and `maxConcurrency` fields (always 1 for sequential).
+
+### Changed
+
+- Removed broken `sprint-collate-complete` event type (was rejected by schema
+  validation). Replaced with schema-valid `sprint-complete` and `sprint-halted`
+  variants via conditional `allOf`/`if`/`then` branches in `event.schema.json`.
+- Workflow `architect_review_sprint_completion` step-4 now gates status transition
+  on verdict: `Approved` -> `completed`, `Revision Required` + `partial` ->
+  `partially-completed`, `Revision Required` + `complete` -> no transition.
+- `validate-store.cjs` allOf interpreter now supports `enum` predicates in
+  `if.properties` (not just `const`). Required for the task-scoped event type
+  branch that uses an enum list instead of a single const.
+
+### Bundled
+
+- forge-plugin: 0.43.15 -> **0.43.16** (schema variants, workflow gating, validator
+  enum support).
+
+## [0.6.5] — 2026-05-14
+
+Telemetry contract Slice 2 — the runtime emit site. Pairs with
+forge-plugin 0.43.14 (workflow + fragment + friction-emit + backfill).
+
+### Changed
+
+- `runForgeSubagent` now surfaces `provider` on its `SubagentResult` alongside `model` and `usage`. The provider is captured directly from the per-turn `AssistantMessage.provider` field on the pi event stream — no env-var dance, no global state. Composes recursively: depth N records depth N+1's runtime attribution. Auto-exported transcripts include the resolved provider in the JSON header.
+- `run-task.ts` becomes the orchestrator side of the new event-emission contract. After each `runForgeSubagent` returns successfully, the orchestrator:
+  1. Reads the task record once to resolve `sprintId`.
+  2. Composes the canonical phase event from runtime telemetry (`result.model`, `result.provider`, `result.usage`), known task context (`taskId`, `sprintId`, `phase`, `iteration`), bracketed wall times, and the judgement blob the subagent wrote to `task.summaries.{key}`.
+  3. Emits via `node $FORGE_ROOT/tools/store-cli.cjs emit {sprintId} '{...}'` with `tokenSource: "reported"` whenever usage was non-zero.
+  4. Drains `.forge/cache/FRICTION-{phase}.jsonl` (written by the new `friction-emit.cjs` tool on the subagent side), stamps each judgement-only record with the subagent's runtime attribution, emits as event type `"friction"`, and truncates the file only after all emits succeed.
+- Subagents no longer call `store-cli emit` for phase events. The workflow prompts in forge-plugin 0.43.14 enforce this; this change is the runtime that takes over the emission responsibility.
+- `scripts/build-payload.cjs` bundles the two new forge-plugin tools (`friction-emit.cjs`, `backfill-provider.cjs`) so they ship in the global install.
+
+### Bundled
+
+- forge-plugin: 0.43.13 → **0.43.14** (telemetry contract Slice 2 — workflow/fragment rewrites + `friction-emit.cjs` + `backfill-provider.cjs`).
+
+## [0.6.4] — 2026-05-14
+
+### Fixed
+
+- `/forge:regenerate` now refreshes `.forge/schemas/` from the bundled `.schemas/` payload. Previously only workflows, personas, skills, templates, and commands were re-materialized — schemas were copied only at install time by `/forge:init`. With this fix, projects pick up forge-plugin schema changes (e.g. the 0.43.13 telemetry contract: `provider` required, `estimatedCostUSD` dropped) on the same `/forge:regenerate` call that updates workflows referencing them. Without this, regenerated workflows assumed the new contract while on-disk schemas still enforced the old one, causing silent validation drift. Notification text now reports the schema-refresh count.
+
+### Bundled
+
+- forge-plugin: 0.43.12 → **0.43.13** (telemetry contract Slice 1 + bundled-`.schemas/` runtime lookup in store-cli).
+
+## [0.6.3] — 2026-05-14
+
+Thread-switcher UX — single-viewport subagent tail browsing. Activates
+pi-mono fork at @entelligentsia/pi-* @ 0.75.0.
+
+### Added
+
+- `/forge:threads` slash command + Ctrl+T shortcut. One-row chip strip
+  below the editor. While active: ←→ navigate chips, Enter focuses a
+  thread into the main chat viewport, Esc snaps back to main.
+- Per-phase tail buffer in SessionRegistry (bounded ring, 2048 lines).
+  Subagent tool events, assistant-turn previews, compaction, and retry
+  events appended as one-line formatted entries `[<phase> HH:MM:SS] …`.
+- Unread-warning counter per phase: subagent tool errors append with
+  `warning:true`, surfacing as `◆` on the chip strip. Focusing the
+  phase clears the counter.
+
+### Changed
+
+- `forge.bundledVersion`: unchanged (0.43.12).
+- Subagent tool errors no longer surface as multi-line `⚠ … failed`
+  ctx.ui.notify blocks on the main thread. They're captured in the
+  per-phase tail (readable via the switcher) plus the existing debug
+  JSONL + transcript dumps.
+- Pi runtime: forge-cli now consumes @entelligentsia/pi-coding-agent,
+  pi-ai, pi-tui (pi-mono @ 0.75.0) via local file: refs. Adds the
+  ctx.ui.setOutputSource(component | null) extension API needed to
+  swap the chat viewport's render source on user command.
+
+### Notes
+
+- Legacy `/forge:sessions` widget (two-pane session monitor) is still
+  registered. Will be removed after the new switcher proves out.
+
+## [0.6.2] — 2026-05-14
+
+Bundled forge plugin bumped to v0.43.12 — fixes silent fragment drop
+in `/forge:regenerate` output.
+
+### Changed
+
+- `forge.bundledVersion`: `0.43.11` → `0.43.12`. The plugin's
+  `build-base-pack.cjs` previously hardcoded a 4-fragment allowlist,
+  so `_fragments/store-cli-verbs.md` (forge#95) and `_fragments/friction-emit.md`
+  (FORGE-S20-T01) never reached the `.base-pack/workflows/_fragments/`
+  shipped to users. Workflow bodies referenced both fragments but the
+  fragment files were missing after `/forge:regenerate`, regressing
+  store-cli verb fumbles and event-shape iteration that #95/#87 were
+  meant to kill. Both builders now enumerate fragments dynamically.
+- No forge-cli source changes. Carrier-only bump.
+
+## [0.6.1] — 2026-05-13
+
+HLO-S01 friction-fix sweep — bundled forge plugin bumped to v0.43.11.
+
+### Changed
+
+- `forge.bundledVersion`: `0.43.10` → `0.43.11`. New bundle covers ten
+  friction fixes batched from the 2026-05-13 testbench dogfood
+  (umbrella forge#93): meta-review-plan text drift (#78/#76), event.type
+  enum widening (#80), task FSM `planned → implemented` (#79), inline
+  FSM transition tables (#96), store-cli verb cheat-sheet fragment
+  (#95), runtime-conditional `/cost` probe (#84), surfaced
+  `commands.test` in workflow bodies (#94), `--force` gated behind
+  `FORGE_ALLOW_FORCE` + canonical event-shape (#87), commit_task author
+  fix (#82), native `--task-suffix` / `--sprint-suffix` flags
+  (forge-cli#5 tools piece).
+- No forge-cli source changes in this release. Carrier-only bump.
+
+## [0.5.7] — 2026-05-10
+
+FORGE-S20-T04 sprint-completion gap fix (paired with forge plugin v0.43.3).
+
+### Headline
+
+`hello` testbench triggered `× forge:enhance — workflow not found at .forge/workflows/enhance.md; run /forge:init or /forge:regenerate first.` on every fresh init. Root cause: T04 added the native /forge:enhance kickoff shim (enhance.ts) reading `.forge/workflows/enhance.md`, but the bundled forge plugin never shipped that file. build-base-pack.cjs only handled commands/enhance.md via the ENHANCE_AGENT_SENTINEL path; the workflow side was absent. The T04 spec line — "resolves meta-enhance.md from bundled payload" — was not honoured by the implementation.
+
+### Fixed
+
+- Bumped bundled forge plugin from `0.43.2` → `0.43.3`. The new bundle ships `init/base-pack/workflows/enhance.md` (generated from `meta-enhance.md` via the standard transformWorkflow path) carrying the four Pack-06 markers required by the kickoff shim (Iron Laws, Store-Write Verification, `forge_store` token, `engineer.md` persona path). enhance.md remains `audience: orchestrator-only` and is exempt from the 4KB phase-file byte budget.
+- `/forge:enhance` now dispatches successfully on fresh init.
+
+### Added
+
+- `bundled-base-pack-markers.test.ts` — third assertion exercising `dist/forge-payload/.base-pack/workflows/enhance.md` against `enhance.checkMaterialization`. Catches future bundle bumps that drop enhance.md or its markers.
+
+### Notes
+
+- Existing projects on `0.43.2` need `/forge:regenerate` after `/forge:update` to materialize `.forge/workflows/enhance.md`.
+
+## [0.5.6] — 2026-05-10
+
+Pack-06 materialization-marker regression fix (paired with forge plugin v0.43.2).
+
+### Headline
+
+`hello` testbench observed `/forge:plan` (and `/forge:implement`) hard-failing every fresh init with `× workflow regression: Store-Write Verification not found in /home/.../.forge/workflows/plan_task.md` plus three siblings (`Iron Laws`, `forge_store`, `persona file path (architect)`). Root cause: FORGE-S20-T05/T06 added kickoff-shim materialization preconditions but the corresponding meta sources (`forge/forge/meta/workflows/meta-plan-task.md`, `meta-implement.md`) never gained those sections. The base-pack regen produced workflows that the kickoff shim refused to dispatch.
+
+### Fixed
+
+- Bumped bundled forge plugin from `0.43.1` → `0.43.2`. The new bundle ships `plan_task.md` + `implement_plan.md` with all four Pack-06 markers (Iron Laws, Store-Write Verification, `forge_store` token, `architect.md`/`engineer.md` persona path).
+- `/forge:plan` and `/forge:implement` kickoff shims now successfully validate the bundled workflows on fresh init.
+
+### Added
+
+- `test/extensions/forgecli/bundled-base-pack-markers.test.ts` — regression guard that runs `checkMaterialization` against the real bundled `dist/forge-payload/.base-pack/workflows/{plan_task,implement_plan}.md` (not a fixture). Catches future bundle bumps that drop markers.
+
+### Notes
+
+- Existing projects on `0.43.1` need to run `/forge:regenerate` after `/forge:update` to pick up the new markers in their `.forge/workflows/`.
+
+## [0.5.5] — 2026-05-10
+
+Hot-fix: 0.5.4 shipped with the source-side verify code accidentally reverted by an in-conversation `git checkout` during testing. The CHANGELOG, package.json bump, and test updates all landed but `forge-init.ts` did not. v0.5.5 lands the actual implementation.
+
+### Added
+
+- All v0.5.4 changes per CHANGELOG below — for real this time. `verifyPhase1/2/3` helpers + Phase 1+2 retry-once-then-confirm loop + Phase 3 hard-fail + final report banner gated on cross-phase verify.
+- `non-interactive mode` describe block beforeEach updated to match outer beforeEach defaults (was overriding with old null-config setup).
+
+## [0.5.4] — 2026-05-10
+
+`/forge:init` per-phase verify + retry + recover.
+
+### Headline
+
+`hello` testbench observed `/forge:init` printing "complete" while `.forge/workflows/` was empty — `forge:sprint-intake` then died with `workflow not found at .forge/workflows/architect_sprint_intake.md`. Root cause: Phase 1 fired-and-forgot. When the agent skipped the deliverable (model said "I don't have a subagent tool"), Phase 3's `substitute-placeholders.cjs` ran against a missing config and silently produced zero workflows; Phase 4 still printed "complete".
+
+### Added
+
+- **Per-phase verifiers** in `src/extensions/forgecli/forge-init.ts`:
+  - `verifyPhase1(cwd)` — `.forge/config.json` exists + parses + has `version`, `project.{name,prefix}`, `stack`, `commands`, `paths.{engineering,store,workflows}`.
+  - `verifyPhase2(cwd, kbPath)` — all 7 architecture docs present.
+  - `verifyPhase3(cwd)` — all 4 materialized dirs (`.forge/{workflows,personas,skills,templates}`) non-empty.
+- **Phase 1 + Phase 2 verify-retry-confirm loop**: on first verify fail, send a corrective steer ("write the file now using `write` tool, do NOT call subagents"), wait idle, re-verify. On second fail in interactive mode, prompt user to abort or continue with partial init. In non-interactive mode, hard-fail with explicit error.
+- **Phase 3 hard-fail**: `substitute-placeholders.cjs` is invoked via `runToolAdvisory` (no exception on failure); the post-phase `verifyPhase3` now catches the silent-zero-output case and aborts the pipeline with a recovery hint (`/forge:regenerate`).
+- **Final report banner** gated on cross-phase verify (`verifyPhase1 + verifyPhase3`). When either fails, banner reads `/forge:init incomplete — see gaps below` and lists the specific missing artifacts plus recovery commands. The "complete" banner is no longer a lie.
+
+### Changed
+
+- Test harness `beforeEach` defaults updated to keep the verify path passing for tests that don't exercise it: `mockFs.existsSync` returns true for `config.json` only; `readFileSync` returns a complete sample config; `readdirSync` returns one stub entry for each `.forge/{workflows,personas,skills,templates}` dir.
+- 4 existing tests' `forge:init complete` string-match relaxed to `Knowledge base:` (more robust to banner text changes; the `Knowledge base:` line appears in both complete and incomplete banners).
+- `bug-023-prompt-blocking` test reset to use the new flow; `G3-custom-folder` test now uses `mockImplementation(() => true)` instead of `mockReturnValue(true)` (clearer intent; avoids the impl-vs-returnValue stacking quirk).
+
+### Tests
+
+406/406 vitest pass. New verify branches covered transitively by the existing 38 forge-init tests.
+
+## [0.5.3] — 2026-05-10
+
+UX: KB-folder confirm question rephrased so default-Yes is the safe path.
+
+### Changed
+
+- `forge-init.ts:528` — KB-folder gate question changed from `Does "engineering" conflict with an existing folder in this project?` (default-Yes meant unsafe path: trigger custom-name flow) to `Use "engineering" as the folder name?` (default-Yes = use default; pick No only if a real conflict exists). Pi's `ctx.ui.confirm` exposes no `defaultValue` option, so the question text has to align with the highlighted default. Updated 2 tests in `forge-init.test.ts` G3 group.
+
+## [0.5.2] — 2026-05-10
+
+Hot-patch: `forge_ask_user` UI rendering — text/choice prompts now show the question.
+
+### Headline
+
+Cartographer testbench: `/forge:sprint-intake` interview "got stuck — no Q visible". Root cause: `ask-user-tool.ts` passed the constant tag `"forge:ask_user"` as the dialog title for every type. Pi's `ctx.ui.input(title, placeholder)` rendered the question as faded ghost-text in the placeholder slot (vanished on first keystroke); `ctx.ui.select(title, options)` has no question slot at all, so users only saw the option list. Only `confirm` worked because pi's confirm signature is `(title, message)` and the question landed in the message body.
+
+### Changed
+
+- `src/extensions/forgecli/ask-user-tool.ts` — every type now passes `params.question` as the dialog title:
+  - `confirm(question, "", opts)`
+  - `select(question, options, opts)`
+  - `input(question, default ?? "", opts)` — `default` becomes the placeholder hint.
+- Added `ctx.ui.notify("forge:ask_user — <question>", "info")` before the dialog so the source-tag provenance is visible without crowding the dialog title.
+- Updated 2 existing test assertions (test 5 select, test 8 input) to match new arg shape. 14/14 tests pass; 406/406 full suite.
+
+## [0.5.1] — 2026-05-10
+
+Hot-patch: direct-exec contract for forge tools. Pairs with forge-plugin v0.43.1.
+
+### Headline
+
+Cartographer testbench observed haiku-4-5 burning 26-220s per `bash forge store ...` shell-out — each invocation cold-started a fresh pi/agent loop because `forge` had no `store` subcommand. Native MCP `forge_store` tool also failed on 3-arg `write sprint <id> <json>` form (store-cli requires 2-arg). Net: 600x perf regression on store-write-heavy workflows.
+
+### Added
+
+- **Bin fast-path subcommands** (`src/bin/argv.ts`, `src/bin/forge.ts`) — `forge {store|collate|validate-store|store-query} <args>` now bypasses pi entirely and exec's the bundled `.tools/<name>.cjs` directly via `spawnSync`. Cold-start drops from ~26s to ~50ms. Whitelist defined in `FAST_PATH_SUBCOMMANDS`. 7 new vitest cases on the parser.
+- **System-prompt tool-discipline block** (`src/extensions/forgecli/forge-tools.ts:registerForgeToolDiscipline`) — appended to every system prompt via `pi.on("before_agent_start", ...)`. Prescribes: prefer named MCP tools over bash, canonical 2-positional `forge_store` write shape, `forge_store_template` before write, no `bash forge store ...` shell-out.
+
+### Changed
+
+- **`forge_store` MCP description + parameters** (`forge-tools.ts`) — rewritten to enumerate every store-cli subcommand with exact arg counts and worked examples. Highlights the common 3-arg-write footgun.
+- **Kickoff prompts** rewritten to instruct named MCP tool calls instead of colloquial `forge_store ...` text:
+  - `sprint-intake.ts:56` — explicit `{command:'write', args:['sprint','<json>']}` with template-first guidance.
+  - `sprint-plan.ts:76` — same for task-write loop.
+  - `plan.ts:166-167`, `implement.ts:171-172`, `enhance.ts:206` — `update-status` and Pack-06 refs rewritten to canonical MCP-call form.
+
+### Bundled
+
+- Forge plugin bumped 0.43.0 → **0.43.1** (`forge.bundledVersion`). Brings `init/base-pack/workflows/*.md` and `_fragments/*.md` rewrites: all `/forge:store ...` slash refs replaced with `node "$FORGE_ROOT/tools/store-cli.cjs" ...` direct-cjs form.
+
+## [0.5.0] — 2026-05-10
+
+Headline: Foundation finish — central loaders + 3 native kickoff handlers + FS-level boundary guard. SDLC core path self-hosted on pi.
+
+### △ Breaking
+
+- **`/forge:plan` and `/forge:implement` legacy markdown-stub fallback DELETED** (FORGE-S20-T05, T06). The pre-S20 path injected a workflow markdown body into the user's prompt when no native handler was registered. With T05 (`plan.ts`) and T06 (`implement.ts`) shipping native Kickoff Shims, the fallback is removed. Users on a custom fork that still relied on stub injection must port to the native handler API. Stock forge-cli users see no behaviour change beyond improved kickoff reliability.
+
+### Added
+
+- **Central persona/skill loader** (FORGE-S20-T02) — `loaders/persona.ts`, `loaders/skill.ts`. Single source for resolving `meta-<persona>.md` / `meta-<skill>.md` from the bundled payload. Reused by all native kickoff handlers.
+- **Shared template-render helper** (FORGE-S20-T03) — `helpers/template-render.ts`. Mustache-style placeholder substitution for kickoff message composition; centralizes formatting across enhance/plan/implement.
+- **`/forge:enhance` Phase 2 native kickoff handler** (FORGE-S20-T04) — `enhance.ts`. Replaces the prior `/forge:enhance` markdown stub with a native Kickoff Shim. Argv parses `--phase` and free-form text; composes kickoff via T02+T03; calls `pi.sendUserMessage()` with `deliverAs:"steer"`.
+- **`/forge:plan` native kickoff handler** (FORGE-S20-T05) — `plan.ts`. Native port; legacy fallback deleted (see Breaking).
+- **`/forge:implement` native kickoff handler** (FORGE-S20-T06) — `implement.ts`. Native port mirroring T05; materialization-marker check pre-dispatch; legacy fallback deleted (see Breaking).
+- **FS-level two-layer boundary guard hook** (FORGE-S20-T07) — `hooks/two-layer-guard.ts`. Blocks tool calls that would write to `forge/forge/meta/` or non-`.forge/` paths owned by the Forge plugin from inside forge-cli runtime. Issue #24 enforcement promoted from engineer-discipline to FS layer.
+- **Bundled-tools regression test** (FORGE-S20-T08) — extends BUG-029 layout-detection coverage. Smoke gate ensures all four affected MCP tools (`forge_config`, `forge_store`, `forge_validate_store`, `forge_collate`) succeed against the flat bundled layout.
+- **forge-plugin bundled bump 0.41.0 → 0.43.0** — picks up the friction-emit channel (workflows + event schema + validate-store) from FORGE-S20 T00/T01 and the v0.42.0 catch-up content (substitute-placeholders `--target pi`, store-cli `describe`/`template`, validate hint).
+- **`forge_store_describe` MCP tool** — returns the raw JSON Schema for a Forge store entity (sprint/task/bug/event/feature). Wraps `store-cli.cjs describe`. Enables LLMs to inspect schema before writing.
+- **`forge_store_template` MCP tool** — returns a canonical sample record with all required fields populated (enum first-value, ISO date-time, ID placeholders). Wraps `store-cli.cjs template`. Reduces write→reject→retry friction. See forge#3 for phase 2/3 (per-entity TypeBox tools + harness one-shot injection).
+- **`forge_store_query` MCP tool** — natural-language and structured queries over the Forge store. Wraps `store-cli.cjs` query/nlp/schema dispatch (delegates to `store-query.cjs`). Closes the tool-gap surfaced in forge-cli#2 — non-Anthropic models can now find tasks/bugs/sprints/features by intent without scanning JSON manually. Bundled deps: `store-query.cjs` + `lib/{store-facade,store-nlp,store-query-exec}.cjs`.
+
+### Fixed
+
+- **forge-tools layout detection (FORGE-BUG-029)** — `forge_config`, `forge_store`, `forge_validate_store`, and `forge_collate` MCP tools failed with "Cannot find module" when `paths.forgeRoot` pointed at the flat bundled payload (`dist/forge-payload/.tools/`). `forge-tools.ts` was unconditionally appending a `tools/` segment, valid only for the Claude-plugin nested layout. New `resolveToolDir()` probes for `<forgeRoot>/tools/` and falls back to flat layout when absent. Two regression tests (test 11/12) cover both layouts.
+- **bundle CJS scope marker (FORGE-BUG-030)** — bundled `.tools/lib/validate.js` and `lib/result.js` failed with `ReferenceError: module is not defined in ES module scope` because forge-cli's `package.json` declares `"type":"module"`, making `.js` files in the bundle resolve as ESM. `scripts/build-payload.cjs` now writes a `package.json` scope marker (`{"type":"commonjs"}`) into `dist/forge-payload/.tools/` so `.js` files in that subtree resolve as CommonJS. New smoke gates E2E-12 (scope-marker presence) and E2E-13 (`store-cli.cjs --help` runs without ESM scope error).
+
+### Changed
+
+- **sprint-intake handler — LLM-driven kickoff (FORGE-BUG-031)** — retired the deterministic TUI interview shipped in FORGE-S19-T01. `sprint-intake.ts` (768 → 106 lines) now parses argv (empty | `@<file>` | free-form text), reads `.forge/workflows/architect_sprint_intake.md`, composes a kickoff message, and calls `pi.sendUserMessage()` to hand control to the LLM. The LLM drives the conversational interview using `forge_store`, `forge_ask_user`, `read`, `write`, and `forge_collate`. Removed `sprint-intake.test.ts` (14 TUI tests), retired smoke gates E2E-08/09 (`FORGE_NON_INTERACTIVE`, `FORGE_INTAKE_ANSWERS_FILE`). Motivation: TUI captured raw input as sprint dir name producing malformed dirs (`Add/`, `S02/`, `"add/`) and lost the elicitation intelligence of the Claude-plugin flow.
+- **sprint-plan handler — LLM-driven kickoff (FORGE-BUG-032)** — retired the deterministic JSON-mode subagent call shipped in FORGE-S19-T02. `sprint-plan.ts` (606 → 138 lines) now parses argv (`<SPRINT_ID> [@<file> | <text>]`), reads `SPRINT_REQUIREMENTS.md` or `REQUIREMENTS.md` alias, composes a kickoff with `architect_sprint_plan.md`, and calls `pi.sendUserMessage()`. LLM drives task decomposition conversationally, writing tasks via `forge_store write task` one at a time — no rigid JSON-array contract, no 2-attempt retry cap. Removed `sprint-plan.test.ts` and retired E2E-10 / `FORGE_SPRINT_PLAN_FIXTURE`. Motivation: emberglow testbench hit cascading failures with glm-5.1:cloud returning non-array output, plus accepted bare/wrong-prefix sprint IDs and lacked filename alias.
+
+## [0.4.0] — 2026-05-09
+
+Headline: Native sprint-intake + sprint-plan handlers — forge-cli takes over the SDLC entry path for S20+.
+
+### Added
+
+- **`usage-hook.ts`: Pi-runtime token telemetry hook** (FORGE-S19-T03 / FORGE-BUG-028).
+  Registers `pi.on("message_end")` listener that accumulates per-turn token usage
+  from `AssistantMessage.usage` (`input`, `output`, `cacheRead`, `cacheWrite`,
+  `cost.total`). Closes the 3-sprint `source=missing` regression (S15–S18).
+  `registerUsageHook(pi, opts)` returns an accumulator `Map<phaseKey, UsageAccumulator>`.
+  `flushPhaseUsage(opts)` writes `store-cli record-usage` sidecar with `source=reported`.
+  Phase key via `FORGE_PHASE_KEY` env var. Non-blocking: subprocess failure → stderr
+  warn; non-assistant messages silently skipped. Iron Law 6: `spawnSync` argv array.
+  Wired in `index.ts` alongside `registerHookDispatcher`. 8 auth-free vitest tests.
+
+- **`/forge:sprint-plan` native TS handler** (FORGE-S19-T02).
+  Full LLM-driven sprint decomposition. Pre-flight: reads `SPRINT_REQUIREMENTS.md`
+  from `{engineeringDir}/sprints/{SPRINT_ID}/` (config-resolved); verifies sprint is
+  in `planning` status. Persona self-load from `.forge/personas/architect.md` (🗻).
+  LLM invocation via vendored subagent spawn pattern (`./subagent/index.js`) — confirmed
+  correct by SPIKE_NOTES.md after scanning `@entelligentsia/pi-coding-agent` types
+  (`pi.invokeLLM` absent on ExtensionAPI). Prompt loaded from
+  `dist/forge-payload/.tools/prompts/sprint-plan-prompt.md` (new).
+  JSON output validated against `dist/forge-payload/.tools/schemas/task-list.schema.json`
+  (new TypeBox-compatible schema). First failure retries once with error context
+  appended; second failure writes raw output to `.forge/cache/sprint-plan-failure-{ID}.json`
+  and aborts. Kahn's algorithm cycle detection after validation, before store writes.
+  Per-task records written via `store-cli write task` (argv array form, Iron Law 6).
+  `SPRINT_PLAN.md` rendered inline with mermaid dep graph (zero-dependency case
+  emits valid node-only graph). Per-task `TASK_PROMPT.md` written under
+  `engineering/sprints/{SPRINT_ID}/{TASK_ID}/`. Sprint status `planning → planned`
+  via `store-cli update-status`. `sprint-plan-complete` event emitted.
+  `forge:sprint-plan` added to `EXPLICITLY_REGISTERED_NAMES` (renamed from
+  `REAL_HANDLERS`) in `forge-commands.ts`. Registered in `index.ts` before
+  `registerAllForgeCommands`. `scripts/build-payload.cjs` updated with Pass 2g to
+  copy `src/extensions/forgecli/prompts/` and `schemas/` into
+  `dist/forge-payload/.tools/`. 14 vitest tests. E2E-10 (`FORGE_SPRINT_PLAN_FIXTURE`
+  scripted fixture run) added to `test/e2e/smoke.sh`.
+
+- **`/forge:sprint-intake` native TS handler** (FORGE-S19-T01).
+  Full multi-turn TUI interview for sprint requirements capture. Adapts
+  `meta-sprint-intake.md` 4-step algorithm to pi `ctx.ui.input/confirm/select`
+  calls. Pre-flight reads `paths.engineering` from `.forge/config.json`; aborts
+  if no `.forge/` found. Persona self-load from `.forge/personas/product-manager.md`.
+  Context load: `MASTER_INDEX.md`, `architecture/stack.md`, open bugs and features.
+  Captures: working title, theme, goals (loop with severity via `ctx.ui.select` and
+  per-goal ACs), out-of-scope items, constraints, risks (with likelihood select),
+  carry-over items (auto-detected from previous `SPRINT_RETROSPECTIVE.md`).
+  Resumable via `.forge/cache/sprint-intake-{SPRINT_ID}.json` checkpoint.
+  Non-interactive mode (`FORGE_NON_INTERACTIVE=1` / `FORGE_YES=1`) refuses with
+  actionable error. `SPRINT_REQUIREMENTS.md` rendered via template substitution
+  from `.base-pack/templates/SPRINT_REQUIREMENTS_TEMPLATE.md`. Sprint manifest
+  record written via `store-cli write sprint` (argv array, Iron Law 6 compliant).
+  `sprint-intake-complete` event emitted via `store-cli emit`. 14 vitest tests.
+  E2E-08 (non-interactive abort) and E2E-09 (`FORGE_INTAKE_ANSWERS_FILE` scripted
+  run) gates added to `test/e2e/smoke.sh`.
+
+- **`scripts/verify-readme-changelog.cjs`: README↔CHANGELOG diff verifier** (FORGE-S19-T04).
+  Hard release gate at `scripts/verify-readme-changelog.cjs` — pure CJS, zero npm
+  dependencies. Reads `package.json:version`, `README.md`, `CHANGELOG.md` from CWD
+  or `--root <path>`. Asserts every `## [X.Y.Z]` CHANGELOG heading since `[0.1.0]`
+  (baseline exempt) has at least one mention in README. Asserts README roadmap
+  `Shipped (X.Y.Z)` matches `package.json:version`; warns (not fails) if no roadmap
+  section. Hard FAIL with actionable diff output on first mismatch. `--allow-section-skip`
+  escape hatch suppresses roadmap check. Wired into `test/e2e/smoke.sh` as E2E-11.
+  5 vitest tests with synthetic fixtures.
+
+- **`scripts/verify-publish.cjs`: post-publish npm-view check** (FORGE-S19-T05).
+  Mandatory post-publish verifier at `scripts/verify-publish.cjs` — pure CJS, zero
+  npm dependencies. Accepts `--version <VERSION>` (required), `--package <PKG>`
+  (defaults to `package.json:name`), `--allow-non-latest`, `--root <path>`. Runs
+  `npm view <PKG>@<VERSION> version` and asserts trimmed output matches `<VERSION>`.
+  Runs `npm view <PKG> dist-tags --json` and asserts `latest === <VERSION>` (hard
+  fail without `--allow-non-latest`; warn-only with flag). On any npm non-zero exit
+  or network failure: logs `[warn] registry check failed — verify manually:
+  npm view <PKG>@<VERSION>` and exits 1. Iron Law 6 compliant: `spawnSync` argv
+  array, no shell interpolation. 4 vitest tests covering success, version mismatch,
+  network failure, and `--allow-non-latest` behaviour.
+
 ---
 
 ## [0.3.0] — 2026-05-09
@@ -134,24 +514,24 @@ unpacked. Tarball size-budget gate enforced in smoke + CI.
 
 ### Bundled / pinned (unchanged from 0.1.0)
 
-- `@earendil-works/pi-coding-agent@0.74.0`,
-  `@earendil-works/pi-ai@0.74.0`,
-  `@earendil-works/pi-tui@0.74.0` via `bundledDependencies`.
+- `@entelligentsia/pi-coding-agent@0.74.0`,
+  `@entelligentsia/pi-ai@0.74.0`,
+  `@entelligentsia/pi-tui@0.74.0` via `bundledDependencies`.
 - `forge.bundledVersion: 0.40.3` (`Entelligentsia/forge@v0.40.3`) — drift audit
   clean, no upstream movement during sprint.
 
 ## [0.1.0] — 2026-05-08
 
 First public stable release of `@entelligentsia/forgecli` — the Forge SDLC
-ported onto `@earendil-works/pi-coding-agent`.
+ported onto `@entelligentsia/pi-coding-agent`.
 
 ### Added
 
 - **Three bin entries** (`forge`, `forgecli`, `4ge`) all routing to the same
   launcher. `4ge` and `forgecli` exist as collision-free aliases when the
   Foundry `forge` is on `$PATH`.
-- **Bundled pi runtime.** `@earendil-works/pi-coding-agent@0.74.0`,
-  `@earendil-works/pi-ai@0.74.0`, and `@earendil-works/pi-tui@0.74.0` are
+- **Bundled pi runtime.** `@entelligentsia/pi-coding-agent@0.74.0`,
+  `@entelligentsia/pi-ai@0.74.0`, and `@entelligentsia/pi-tui@0.74.0` are
   shipped via `bundledDependencies`, insulating installs from upstream
   npm-scope churn.
 - **Bundled forge plugin payload** at `Entelligentsia/forge@v0.40.3`,
@@ -192,6 +572,8 @@ ported onto `@earendil-works/pi-coding-agent`.
 - `claude-agent-sdk` plan-limit support (deferred to S17+).
 - Cost telemetry surfacing in `/forge:*` (waived for S16).
 
+[0.5.0]: https://github.com/Entelligentsia/forge-cli/releases/tag/v0.5.0
+[0.4.0]: https://github.com/Entelligentsia/forge-cli/releases/tag/v0.4.0
 [0.3.0]: https://github.com/Entelligentsia/forge-cli/releases/tag/v0.3.0
 [0.2.1]: https://github.com/Entelligentsia/forge-cli/releases/tag/v0.2.1
 [0.2.0]: https://github.com/Entelligentsia/forge-cli/releases/tag/v0.2.0

package/README.md

@@ -1,8 +1,8 @@
 ## @entelligentsia/forgecli
 
-Forge SDLC on the [pi-coding-agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) runtime. Three bin aliases: `forge`, `forgecli`, `4ge`.
+Forge SDLC on the [pi-coding-agent](https://www.npmjs.com/package/@entelligentsia/pi-coding-agent) runtime. Three bin aliases: `forge`, `forgecli`, `4ge`.
 
-Bundled Forge plugin: **v0.40.3**.
+Bundled Forge plugin: **v0.43.16**.
 Bundled pi runtime: pinned in `package.json`.
 
 ## Install
@@ -170,15 +170,59 @@ or pi is running in headless/RPC mode, the tool returns the `default` immediatel
 without rendering any TUI. Fallback defaults when no explicit `default` is
 provided: `confirm` → `"Y"`, `choice` → `options[0]`, `text` → `""`.
 
+## Publishing
+
+After every `npm publish`, run the post-publish verifier to confirm the registry reflects the new version and `dist-tags.latest` is updated:
+
+```sh
+node scripts/verify-publish.cjs --version <VERSION>
+```
+
+Options:
+
+```
+--version <VERSION>   Required. The version just published.
+--package <PKG>       Package name (default: reads from package.json).
+--allow-non-latest    Warn instead of fail when dist-tags.latest != VERSION.
+--root <path>         Root directory for package.json lookup (default: cwd).
+```
+
+The script runs two checks:
+1. `npm view <PKG>@<VERSION> version` — asserts the trimmed output matches `<VERSION>`.
+2. `npm view <PKG> dist-tags --json` — asserts `latest === <VERSION>` (hard fail unless `--allow-non-latest`).
+
+On any npm error or version mismatch the script logs a `[warn] registry check failed` message and exits 1.
+
 ## Roadmap
 
-| Command                   | Status              |
-|---------------------------|---------------------|
-| `/forge:init`             | Shipped (0.3.0)     |
-| Other `/forge:*` commands | Roadmap             |
+| Command                                    | Status              |
+|--------------------------------------------|---------------------|
+| `/forge:enhance` (Phase 2)                 | Shipped (0.5.0)     |
+| `/forge:plan`                              | Shipped (0.5.0)     |
+| `/forge:implement`                         | Shipped (0.5.0)     |
+| FS-level two-layer boundary guard          | Shipped (0.5.0)     |
+| Bundled-tools layout regression coverage   | Shipped (0.5.0)     |
+| `/forge:sprint-intake`                     | Shipped (0.4.0)     |
+| `/forge:sprint-plan`                       | Shipped (0.4.0)     |
+| Pi-runtime token telemetry (`usage-hook`)  | Shipped (0.4.0)     |
+| forge-packager README↔CHANGELOG verifier   | Shipped (0.4.0)     |
+| forge-releaser post-publish npm-view check | Shipped (0.4.0)     |
+| `/forge:init`                              | Shipped (0.3.0)     |
+| Other `/forge:*` commands                  | Roadmap             |
 
 Track via [issues](https://github.com/Entelligentsia/forge-cli/issues).
 
+## Release history
+
+| Version | Headline |
+|---------|----------|
+| 0.5.0   | Foundation finish — central loaders + 3 native kickoff handlers + FS-level boundary guard |
+| 0.4.0   | Native sprint-intake + sprint-plan handlers — SDLC entry path self-hosted |
+| 0.3.0   | Pi-runtime parity adapters — `forge:ask_user` TUI tool + hook safety net |
+| 0.2.1   | Non-interactive mode — `--non-interactive` flag and `FORGE_YES=1` env var |
+| 0.2.0   | `/forge:init` real implementation — full 4-phase port with payload trim |
+| 0.1.0   | First stable release — three bin aliases, bundled pi runtime, 5 slash commands |
+
 ## Links
 
 - Source: <https://github.com/Entelligentsia/forge-cli>

package/dist/bin/argv.d.ts

@@ -1,5 +1,12 @@
-/** Parsed result when `--version` or `--help` is requested. */
-export type ForgeAction = "version" | "help" | null;
+/** Parsed result when `--version`, `--help`, or a fast-path subcommand is requested. */
+export type ForgeAction = "version" | "help" | "subcommand" | null;
+/**
+ * Whitelist of bare subcommands that bypass pi and exec a bundled cjs tool
+ * directly. Each entry maps the user-typed subcommand to the cjs filename
+ * under `dist/forge-payload/.tools/`. Direct exec keeps these <100ms vs the
+ * ~26s cold-start an agent loop would incur.
+ */
+export declare const FAST_PATH_SUBCOMMANDS: Readonly<Record<string, string>>;
 export interface ParseResult {
     /** Action for forge to handle before invoking pi, or null if pi should run. */
     forgeAction: ForgeAction;
@@ -7,6 +14,10 @@ export interface ParseResult {
     piArgv: string[];
     /** Env vars to set before invoking pi. */
     env: Record<string, string>;
+    /** When forgeAction === "subcommand", the cjs filename to exec. */
+    subcommandTool?: string;
+    /** When forgeAction === "subcommand", argv to pass after the cjs filename. */
+    subcommandArgs?: string[];
 }
 export interface ParseError {
     error: string;

package/dist/bin/argv.js

@@ -19,6 +19,18 @@
 //   --no-color, --cwd, --session, -p, -r, -c, --fork, --no-session,
 //   --model, --tools, --append-system-prompt, --no-tools, --thinking,
 //   --no-thinking, and bare non-flag arguments.
+/**
+ * Whitelist of bare subcommands that bypass pi and exec a bundled cjs tool
+ * directly. Each entry maps the user-typed subcommand to the cjs filename
+ * under `dist/forge-payload/.tools/`. Direct exec keeps these <100ms vs the
+ * ~26s cold-start an agent loop would incur.
+ */
+export const FAST_PATH_SUBCOMMANDS = Object.freeze({
+    store: "store-cli.cjs",
+    collate: "collate.cjs",
+    "validate-store": "validate-store.cjs",
+    "store-query": "store-query.cjs",
+});
 export function isParseError(r) {
     return "error" in r;
 }
@@ -103,6 +115,21 @@ export function parseForgeArgv(argv) {
             }
             continue;
         }
+        // ── Fast-path subcommand (forge store, forge collate, etc.) ──────────
+        // Only matches the FIRST bare token, and only when no flags have
+        // been collected yet (so `forge --cwd /tmp store ...` still treats
+        // `store` as a fast-path; forgeAction overrides piArgv in that case).
+        if (!token.startsWith("-") &&
+            Object.hasOwn(FAST_PATH_SUBCOMMANDS, token) &&
+            piArgv.length === 0) {
+            return {
+                forgeAction: "subcommand",
+                piArgv: [],
+                env,
+                subcommandTool: FAST_PATH_SUBCOMMANDS[token],
+                subcommandArgs: argv.slice(i + 1),
+            };
+        }
         // ── Bare non-flag argument (project path etc.) ───────────────────────
         if (!token.startsWith("-")) {
             piArgv.push(token);

package/dist/bin/argv.js.map

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

package/dist/bin/forge.js

@@ -3,10 +3,11 @@
 //
 // Three bin aliases: forge / forgecli / 4ge (all point here via package.json).
 // Handles --version, --help, forge-owned flags, then delegates to pi's main().
+import { spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
-import { main } from "@earendil-works/pi-coding-agent";
+import { main } from "@entelligentsia/pi-coding-agent";
 import forgecli from "../extensions/forgecli/index.js";
 import { isParseError, parseForgeArgv } from "./argv.js";
 // ---------------------------------------------------------------------------
@@ -28,7 +29,7 @@ function readForgeCliPkg() {
 async function readPiVersion() {
     try {
         // Use import.meta.resolve to find the ESM package, then navigate to package.json
-        const piEntryUrl = import.meta.resolve("@earendil-works/pi-coding-agent");
+        const piEntryUrl = import.meta.resolve("@entelligentsia/pi-coding-agent");
         const piDir = path.dirname(fileURLToPath(piEntryUrl));
         const pkgPath = path.resolve(piDir, "..", "package.json");
         const raw = fs.readFileSync(pkgPath, "utf8");
@@ -103,6 +104,19 @@ if (parsed.forgeAction === "help") {
 }
 // Apply forge env overrides
 Object.assign(process.env, parsed.env);
+// Fast-path subcommand: spawn the bundled cjs tool directly. This skips
+// the entire pi/agent boot and turns 26s cold-starts into <100ms shells.
+if (parsed.forgeAction === "subcommand" && parsed.subcommandTool) {
+    const toolPath = path.resolve(__dirname, "..", "forge-payload", "tools", parsed.subcommandTool);
+    if (!fs.existsSync(toolPath)) {
+        process.stderr.write(`forge: fast-path tool not found at ${toolPath}. Bundle may be corrupt — try \`forge --version\` and reinstall.\n`);
+        process.exit(1);
+    }
+    const result = spawnSync(process.execPath, [toolPath, ...(parsed.subcommandArgs ?? [])], {
+        stdio: "inherit",
+    });
+    process.exit(result.status ?? 1);
+}
 // Delegate to pi
 await main(parsed.piArgv, { extensionFactories: [forgecli] });
 //# sourceMappingURL=forge.js.map