@entelligentsia/forgecli 1.0.25 → 1.0.36

package/CHANGELOG.md

@@ -7,6 +7,264 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **`4ge uninstall claude [dir] [--purge] [--yes]`** — the counterpart to
+  `4ge init claude`. Deterministically reverses the bootstrap: removes the
+  vendored Forge scaffold (`.forge/{tools,schemas,init,.base-pack,meta,
+  .claude-plugin,cache}`, `.bootstrap-manifest.json`, `.claude/commands/forge`,
+  `.claude/workflows`, and the payload's agents/skills), un-merges the Forge
+  hooks from `.claude/settings.json`, and un-appends the Forge block from
+  `.gitignore`. Safety: **preserves user data by default** (`.forge/config.json`,
+  `.forge/store/**`, the KB folder); `--purge` also removes config + store (KB
+  is never auto-removed). Refuses to act without a `.bootstrap-manifest.json`
+  (proof the project was forge-bootstrapped), edits `settings.json`/`.gitignore`
+  rather than deleting them, preserves user-authored agents/skills not in the
+  payload, and is idempotent. A `[y/N]` confirm guards it unless `--yes`/`-y` or
+  `FORGE_NON_INTERACTIVE=1`.
+
+## [1.0.36] — 2026-06-09
+
+Orchestrator dashboard logs + autonomous run-sprint + KB-refresh, re-landed onto
+the modular-orchestrator decomposition.
+
+### Added
+
+- **Orchestrator decision logs on the dashboard.** The shared
+  `withOrchestratorTranscript` notify-interception now mirrors every
+  orchestrator notify onto its root node (`tree.appendTail(entityId, …)`), and
+  the dashboard renders the Activity log for ALL node kinds (not just leaf). The
+  task/sprint/bug root node now carries the orchestrator's own narrative — gate
+  results, review verdicts, escalations, halts — alongside the per-phase leaf
+  nodes' subagent tool-call activity. New granular per-phase lines: `〇 preflight
+  ok`, `dispatch persona/model`, resolved `verdict`, `〇 postflight ok`.
+- **KB-link refresh is orchestrator-owned in run-task.** After the writeback
+  phase, the pipeline calls `runRefreshKbLinks(cwd)` directly (forge-cli
+  subagents run via the Pi runtime and have no Skill tool, so the prior
+  `forge:refresh-kb-links` Skill-tool instruction caused a multi-call probe
+  loop).
+
+### Changed
+
+- **`/forge:run-sprint` runs to completion.** Removed the per-task "Continue to
+  next task?" confirm and the partial-ceremony-on-decline branch. A sprint
+  command now runs all of its tasks, then the single clean-complete ceremony.
+  The mid-sprint modal previously turned any UI hiccup into a premature partial
+  ceremony (ceremony firing after task 1 with later tasks still draft).
+  Deliberate cancellation (abort signal / task halt) still stops the sprint.
+
+### Fixed
+
+- Dispatch line printed `model=[object Object]` — `modelResolution.model` is a
+  `{provider, model}` object; now formatted as `provider:model`.
+
+## [1.0.35] — 2026-06-07
+
+Re-bundle forge-plugin 1.4.4 — CLI-first field-test gap fixes: paths.commands
+no longer prefix-derived (always `.claude/commands/forge`), explicit
+`paths.forgeRoot=".forge"` write, dev-only tools excluded from the
+structure manifest (instance expectation 49/49, no false /forge:health gaps).
+
+## [1.0.34] — 2026-06-07
+
+No-dead-vendored-references gate (closes the forge#112 failure class).
+
+### Added
+
+- **`tools/check-vendored-refs.cjs`** — scans every vendored text file
+  (commands, drivers, rulebooks, settings, agents, skills) for
+  `.forge/…` / `$FORGE_ROOT/…` path references and fails on any whose
+  target doesn't exist post-bootstrap. Wired in twice: vitest
+  (`vendored-refs.test.ts`, against the real payload) and `tmp-smoke.sh`
+  BOOTSTRAP-9.
+
+### Fixed
+
+- Two dead references the new gate caught immediately:
+  **`forge-preflight.cjs`** (referenced by the run-task driver +
+  meta-fix-bug/meta-orchestrate — /forge:run-task would have hit a dead tool
+  on first use) added to `TOOLS_TO_COPY`, and
+  **`init/workflow-gen-plan.json`** (referenced by rebuild.md) bundled.
+
+## [1.0.33] — 2026-06-07
+
+Re-bundle forge-plugin 1.4.3 — wfl-init.js Phase 2 verify invocations carry
+the required `--kb-path` ([forge#112](https://github.com/Entelligentsia/forge/issues/112) follow-up).
+
+## [1.0.32] — 2026-06-07
+
+Re-bundle forge-plugin 1.4.2 — wfl-init.js Workflow-API rewrite
+([forge#112](https://github.com/Entelligentsia/forge/issues/112): phase
+callbacks silently discarded → init ran 0 agents but reported success;
+parallel() thunks; agent(prompt, opts) arg order; missing schema opts).
+
+### Fixed
+
+- **`build-payload` bundles the full `init/` rulebook tree** — `discovery/`
+  (5 prompts) and `generation/` (11 rulebooks) join `phases/`. Bundling only
+  `phases/` left wfl-init.js discovery/KB-doc subagents with dead rulebook
+  references in vendored projects.
+
+## [1.0.31] — 2026-06-07
+
+Re-bundle forge-plugin 1.4.1 — wfl-init.js Workflow-harness parse fix
+(`export default` wrapper stripped; every `/forge:init` dispatch previously
+failed at launch with "SyntaxError: Unexpected keyword 'export'").
+Projects bootstrapped with the broken driver: re-run `4ge init claude .`
+(idempotent repair overwrites `.claude/workflows/wfl-init.js`).
+
+## [1.0.30] — 2026-06-07
+
+Fixed `/forge:*` command namespace — full project vendoring (bundles forge-plugin 1.4.0).
+
+### Changed
+
+- **Bootstrap Step 4 — full `/forge:*` command surface vendored.** Replaces the
+  init.md-only install: the union of `.base-pack/commands/` (17 sprint-workflow
+  shims, now static `/forge:*` files) and `commands/` (utility commands) vendors
+  into `.claude/commands/forge/`. On name collision (`init.md`, `check-agent.md`,
+  `enhance.md`) the `.base-pack` version wins. Project-prefix namespaces
+  (`/acme:*`, `/hello:*`) are retired — wfl:init no longer generates them
+  (plugin 1.4.0 `getCommandsSubdir()` is fixed to `forge`).
+
+- **Bootstrap Step 4c — Forge-root content vendored into `.forge/`.** `init/`
+  (wfl:init phase rulebooks), `.base-pack/` (Phase 3 materialization source —
+  substitute-placeholders probes it first), `meta/` (rebuild/migrate sources +
+  skill-recommendations), and `.claude-plugin/plugin.json` (version source).
+  The vendored `.forge/` now serves as a complete Forge root for the
+  `${CLAUDE_PLUGIN_ROOT:-$(pwd)/.forge}` fallback every command carries.
+
+- **Bootstrap Step 4d — Claude Code assets vendored into `.claude/`.**
+  `agents/` (store-query-validator, tomoshibi) and `skills/` (4 skill dirs).
+
+- **`forge.bundledVersion`** corrected to track the actually-bundled plugin
+  (1.4.0; had drifted at 1.2.21).
+
+### Fixed
+
+- **`composeUpdateKickoff` directive patch** handles both the plugin ≥ 1.4.0
+  `${CLAUDE_PLUGIN_ROOT:-$(pwd)/.forge}` form and the legacy
+  `${CLAUDE_PLUGIN_ROOT}` form when retargeting `update.md`.
+
+## [1.0.29] — 2026-06-07
+
+`4ge init claude` bootstrap repair, round 2 — hook runtime deps (PostToolUse MODULE_NOT_FOUND in 1.0.28).
+
+### Fixed
+
+- **`hooks/lib/` vendored (bootstrap Step 3b + build-payload 2e4).** Hook scripts
+  require `./lib/common.cjs` / `./lib/write-registry.js` at runtime; neither the
+  payload nor the bootstrap shipped `hooks/lib/`, so `validate-write`, `post-init`,
+  and `post-sprint` failed with MODULE_NOT_FOUND on every matching tool call
+  (fail-open, but noisy in the Claude Code UI).
+
+- **`query-logger.cjs` added to `TOOLS_TO_COPY`.** The settings.json PostToolUse:Bash
+  hook points at `.forge/tools/query-logger.cjs`, but the tool was never bundled into
+  the payload — a hard exit-1 hook error on every Bash call in a bootstrapped project.
+
+- **`tools/package.json` CJS scope marker vendored (FORGE-BUG-030 parity).** The
+  bootstrap copy filter (`*.cjs`/`*.js` only) dropped the `{"type":"commonjs"}`
+  marker build-payload writes into `tools/` — vendored `lib/*.js` would resolve as
+  ESM and crash in `"type":"module"` host projects.
+
+## [1.0.28] — 2026-06-07
+
+`4ge init claude` bootstrap repair — vendor hook scripts + schemas (first-field-test regressions in 1.0.27).
+
+### Fixed
+
+- **Bootstrap Step 3b — hook scripts vendored.** `bootstrapClaudeProject()` now copies
+  `payload/hooks/*.cjs` into `.forge/tools/hooks/` — the exact paths the Step 7 settings
+  wiring points at. In 1.0.27 the copy step was missing entirely, so every wired hook
+  (SessionStart, PreToolUse, PostToolUse, PermissionRequest) fired `node` against a
+  nonexistent file and failed with MODULE_NOT_FOUND on session start.
+
+- **Bootstrap Step 3c — schemas vendored.** `payload/schemas/*.json` + `schemas/_defs/`
+  are now copied into `.forge/schemas/` (previously scaffolded empty), per the
+  cli-first-bootstrap ADR ("vendor tools → `.forge/tools/` + schemas").
+
+- **`settings-merge.ts` — query-logger retarget.** `query-logger.cjs` is a tool, not a
+  hook script (plugin `hooks.json` points it at `tools/query-logger.cjs`); the settings
+  block now targets `$CLAUDE_PROJECT_DIR/.forge/tools/query-logger.cjs` instead of the
+  nonexistent `tools/hooks/query-logger.cjs`.
+
+- Bootstrap manifest `steps` now records `vendor-hooks` and `vendor-schemas`.
+
+## [1.0.27] — 2026-06-07
+
+`4ge init claude` — settings hooks wiring, gitignore, preflight, hand-off UX (FORGE-S31-T03).
+
+### Added
+
+- **`settings-merge.ts`** — new `mergeForgeHooks()` + `buildForgeHooksBlock()` module with
+  merge-not-clobber semantics for wiring Forge hooks into project `.claude/settings.json`.
+  Handles 6 branches: absent file (create), empty object (add hooks key), existing without hooks
+  (merge in), unrelated hooks (merge Forge entries without overwriting), already-present (no-op),
+  malformed JSON (error, never overwrites). Fully idempotent: second run returns `"already-present"`.
+
+- **Bootstrap Step 7** — `bootstrapClaudeProject()` now wires Forge hooks into project
+  `.claude/settings.json` via `mergeForgeHooks()`. All 8 hook entries (7 task-workflow hooks +
+  `forge-permissions`) are written with commands pointing at
+  `$CLAUDE_PROJECT_DIR/.forge/tools/hooks/<name>.cjs`. Outcome (`created`/`skipped`/`warnings`)
+  reported in `BootstrapResult` per existing conventions.
+
+- **Bootstrap Step 8** — idempotent `.gitignore` append. Ported `updateGitignore()` from
+  `phase4-register.ts` as a pure standalone function (no `ctx.ui`). If `.gitignore` is present
+  and does not already contain a `.forge/store/events/` parent pattern, appends the standard
+  Forge gitignore block. Skips silently when absent or already covered.
+
+- **Bootstrap Step 9** — preflight check for Claude Code availability (`runPreflight()`). Detects
+  `claude` binary reachability via `execFileSync("claude", ["--version"])`. Non-fatal: adds an
+  actionable warning to `result.warnings` if unavailable, but does not flip `result.ok`. Returns
+  `BootstrapPreflight { claudeAvailable, workflowToolChecked, warnings }` attached to `BootstrapResult`.
+
+- **`BootstrapPreflight` type** — new sub-object on `BootstrapResult` with `claudeAvailable: boolean`,
+  `workflowToolChecked: boolean` (always `false` in T03 — no reliable offline check), and `warnings: string[]`.
+  Additive change — T02 tests remain green.
+
+- **Hand-off UX** — `init.ts` now prints a structured multi-line message naming `/forge:init`,
+  explaining the one-time hooks-approval prompt, and listing all 7 task-workflow hooks by name
+  and event type. Prepends a warning line if Claude Code was not found on PATH.
+
+- **Test suite** — 9-fixture `settings-merge.test.ts` covering all merge branches; 11 new assertions
+  in `bootstrap.test.ts` for Steps 7–9 and idempotency.
+
+## [1.0.26] — 2026-06-07
+
+CLI-first bootstrap: new `4ge init claude [dir]` bin subcommand (FORGE-S31-T02).
+
+### Added
+
+- **`forge init claude [dir]` subcommand** — new bin route that deterministically
+  bootstraps a Claude Code project from the bundled forge-payload in seconds.
+  Zero LLM tokens, zero network access, pure fs. Scaffolds `.forge/` skeleton
+  + store dirs, vendors tools+lib into `.forge/tools/`, installs
+  `.claude/commands/forge/init.md` from payload, and installs all four
+  `.claude/workflows/wfl-*.js` drivers. Writes `.forge/.bootstrap-manifest.json`
+  with payload version and integrity hash. Idempotent repair: a second consecutive
+  run is a byte-identical no-op; partial bootstraps are repaired file-by-file.
+  `.forge/config.json` and `.forge/store/**` are never touched.
+
+- **`src/extensions/forgecli/claude-bootstrap/bootstrap.ts`** — the pure-fs
+  bootstrap module (`bootstrapClaudeProject(opts)`) with clean/partial/complete
+  idempotency, fast-fail payload validation, and structured `BootstrapResult`
+  (created/skipped/warnings). Grep-negative: no fetch/network, no store writes,
+  no sendUserMessage, no ctx.ui.
+
+- **Vitest tests** in
+  `test/extensions/forgecli/claude-bootstrap/bootstrap.test.ts` — 17 tests
+  covering clean / partial / complete (no-op) / non-writable / payload-validation
+  / init.md install / wfl-drivers / grep-negative ACs branches. All integration-
+  style against the real function (no fs mocking).
+
+- **argv.ts**: extended `ForgeAction` union with `"init"`; added `init claude [dir]`
+  parse branch before the fast-path subcommand block.
+
+- **`src/bin/init.ts`** — `parseInitArgs()` + `runInit()` handler following the
+  `runDoctor` / `runUpdate` / `runConfig` structural convention.
+
+- **forge.ts**: wired `forgeAction === "init"` dispatch branch; updated help text.
+
 ## [1.0.25] — 2026-06-06
 
 Coordinated release matching forge plugin **v1.2.21**. Both changes come from

package/README.md

@@ -18,6 +18,8 @@
 
 forge-cli generates a project-specific engineering knowledge base, sprint workflows, agent personas, and an SDLC pipeline — then drives them from your terminal on the [pi-coding-agent] runtime. Model-agnostic. No editor lock-in.
 
+> **Two ways to run Forge.** Drive it headless in your terminal on the pi runtime (this README), **or** scaffold Forge into a Claude Code project with `4ge init claude .` and run the `/forge:*` slash commands inside Claude Code — remove it with `4ge uninstall claude`. The `4ge init` path is the supported way to add Forge to Claude Code and **replaces the deprecated marketplace plugin install** ([why](https://github.com/Entelligentsia/forge#distribution)).
+
 ## Why
 
 - **Structured SDLC, in any terminal.** Plan → implement → review → validate → commit chains, gated by your own personas and audience rules.

package/dist/CHANGELOG-forge-plugin.md

@@ -5,6 +5,169 @@ Format: newest first. Breaking changes are marked **△ Breaking**.
 
 ---
 
+## [1.4.5] — 2026-06-09
+
+Collate-workflow KB-link refresh is orchestrator-owned under forge-cli. The
+generated collate workflow no longer instructs the collator subagent to invoke
+the `forge:refresh-kb-links` Skill tool — forge-cli subagents run via the Pi
+runtime, which has no Skill tool, so the instruction triggered a multi-call
+bash-probe loop before falling back. The Claude Code TUI standalone path still
+uses the Skill tool; under forge-cli the run-task orchestrator owns the KB
+refresh after the writeback phase. Prose-only change to `collator_agent.md`
+(base-pack) and `meta-collate.md`.
+
+**Regenerate:** workflows:collator_agent
+
+> Manual: run `/forge:update` (or `/forge:rebuild`) to regenerate the collate workflow.
+
+---
+
+## [1.4.4] — 2026-06-07
+
+First full CLI-first field test (git.git, ~500 source files) — `/forge:init`
+passed all phases; gap analysis surfaced three config/manifest defects.
+
+### Fixed
+
+- **`paths.commands` config drift** — `phase-1-collect.md` still carried a
+  prefix-derived instruction ("if prefix is `HELLO`, write
+  `.claude/commands/hello`") that survived the 1.4.0 namespace redesign; the
+  config-writer followed it and check-structure reported commands 0/14. The
+  path is ALWAYS `.claude/commands/forge`.
+- **`paths.forgeRoot` written as an absolute npm-global payload path** — no
+  rulebook said what to write, so the register agent improvised. New explicit
+  `generate-tools.md` step: `paths.forgeRoot = ".forge"` (the vendored
+  `.forge/` IS the Forge root; absolute paths break on upgrades/nvm switches).
+- **False "missing tools" gaps (49/59)** — `build-manifest.cjs` now excludes
+  the 10 plugin-development tools (`build-manifest`, `gen-integrity`,
+  `token-forensics`, …) from the `tools` namespace: the structure manifest
+  describes project instances, and dev tools are never vendored.
+  `structure-manifest.json` regenerated; instance expectation is now 49/49.
+
+## [1.4.3] — 2026-06-07
+
+### Fixed
+
+- **`wfl-init.js` Phase 2 verify invocations matched the tool's real CLI**
+  ([forge#112](https://github.com/Entelligentsia/forge/issues/112) follow-up).
+  Prompts said `verify-phase.cjs --phase 2` bare; the tool requires
+  `--phase 2 --kb-path <path>` and exits 2 without it. Both invocations now
+  pass `--kb-path "${kbFolder}"`. Contract gates added: every driver
+  verify-phase invocation must use a supported phase (1–3) and `--phase 2`
+  must carry `--kb-path`.
+
+## [1.4.2] — 2026-06-07
+
+### Fixed
+
+- **`wfl-init.js` ran zero agents but reported fabricated success
+  ([forge#112](https://github.com/Entelligentsia/forge/issues/112)).** Four
+  Workflow-API misuses: `phase(title, callback)` callbacks (containing every
+  phase body) were silently discarded by the harness; `parallel()` received
+  in-flight promises instead of thunks; `agent()` got the model tier as first
+  arg instead of `opts.model`; structured results lacked `opts.schema` so
+  `.ok` reads were undefined. `/forge:init` "completed" in ~3 ms with 0 agents
+  and hardcoded `ok: true`. Phase bodies now run inline, fan-outs use thunks,
+  every agent call is `agent(prompt, { model, label, phase, schema })`, and
+  the final report reflects real phase results (halts return `ok: false` with
+  the failure reason). Rulebook reads use vendored `.forge/init/...` paths
+  with a direct-analysis fallback for absent prompt files. Fix ported from
+  the field-validated patch authored against the live testbench run.
+
+### Added
+
+- **`wfl-drivers-parse.test.cjs` API-contract gates** — all drivers checked
+  for phase-callback misuse, promise-instead-of-thunk `parallel()` calls,
+  reversed `agent()` args, and dead `init/**.md` rulebook references.
+
+## [1.4.1] — 2026-06-07
+
+### Fixed
+
+- **`wfl-init.js` failed to launch — "SyntaxError: Unexpected keyword 'export'".**
+  The driver shipped wrapped in `export default async function wflInit(args)`,
+  but the Workflow harness permits exactly one export (the leading `meta`
+  literal) and evaluates the remainder as an async function body. The body now
+  runs at top level reading the `args` global, matching the other three
+  drivers. Every `/forge:init` → `workflow('wfl:init')` dispatch was dead on
+  arrival before this fix.
+
+### Added
+
+- **`wfl-drivers-parse.test.cjs`** — regression gate that parses all base-pack
+  `wfl-*.js` drivers exactly the way the Workflow harness does (single meta
+  export, body as async function body with workflow globals in scope).
+
+## [1.4.0] — 2026-06-07
+
+### Changed — △ Breaking
+
+- **Fixed `/forge:*` command namespace (CLI-first redesign).** Project-prefix
+  command namespaces (`/acme:*`, `/hello:*`) are retired — every project gets
+  the same `/forge:*` surface, with full parity between Claude Code and the
+  pure CLI (`4ge`):
+  - `tools/lib/paths.cjs` — `getCommandsSubdir()` returns `'forge'`
+    unconditionally (prefix arg is vestigial, kept for caller compat).
+  - `init/base-pack/commands/*.md` — `/{{PREFIX}}:` → literal `/forge:`
+    (26 occurrences, 17 files). Command templates are now fully static.
+  - `tools/substitute-placeholders.cjs` — materializes commands to
+    `.claude/commands/forge/` regardless of project prefix.
+  - Rulebooks updated: `generate-commands.md`, `phase-3-materialize.md`,
+    `phase-1-collect.md` (config `paths.commands` example), `meta-migrate.md`,
+    `migrate_structural.md`, `commands/add-task.md` next-steps text.
+  - The prefix-derived namespace existed to avoid collisions with the Forge
+    *plugin's* own `/forge:*` commands — moot now that the plugin mechanism
+    is retired in favour of project-vendored commands.
+  - **Migration:** existing projects keep working with their old
+    `.claude/commands/<prefix>/` files; re-materialize to get
+    `.claude/commands/forge/`, then delete the prefix directory.
+
+- **`FORGE_ROOT` vendored fallback in every command.** All 33 resolution
+  lines across `commands/*.md` and `init/base-pack/commands/*.md` change from
+  `${CLAUDE_PLUGIN_ROOT}` to `${CLAUDE_PLUGIN_ROOT:-$(pwd)/.forge}` — in a
+  plugin-installed session the plugin root still wins; in a plugin-less
+  project bootstrapped by `4ge init claude` the vendored `.forge/` (tools,
+  schemas, hooks, init, meta) serves as the Forge root.
+
+## [1.3.0] — 2026-06-07
+
+### Added
+
+- **`init/base-pack/commands/init.md`** — new project-local command wrapper
+  installed by `4ge init claude .` into `.claude/commands/forge/`. Contains
+  the full hoisted-prompt flow (KB folder prompt, CLAUDE.md offer, timestamp
+  minting), dispatches `workflow('wfl:init', args)`, handles the
+  Workflow-tool-missing error explicitly, presents the marketplace-skills offer
+  from `result.skillMatches` post-workflow, invokes `forge:refresh-kb-links`
+  via the Skill tool, and emits the final report (KB doc count, workflow count,
+  command count, accepted/skipped skills). Uses vendored `.forge/tools/` paths
+  only — no `$FORGE_ROOT` / `${CLAUDE_PLUGIN_ROOT}` references.
+
+### Changed
+
+- **`commands/init.md` (plugin-side)** — Execute section rewritten to dispatch
+  `workflow('wfl:init', args)` with hoisted interactive prompts (KB folder
+  prompt, CLAUDE.md offer, timestamp minting). Replaces the previous
+  `Read $FORGE_ROOT/init/sdlc-init.md` instruction. Includes the explicit
+  Workflow-tool-missing error halt (Iron Law 5 — no silent degradation or
+  fallback to `sdlc-init.md`).
+
+- **`init/phases/phase-1-collect.md`** — Pre-flight Knowledge Base Folder block
+  and Step 5 (Marketplace Skills) annotated as orchestrator-owned when the
+  orchestrator pre-supplies the values. Annotations are informational — no step
+  renames or renumbers (forge-cli `run-phases.ts` glob freeze maintained).
+
+- **`init/phases/phase-4-register.md`** — Step 11 (Tomoshibi/refresh-kb-links)
+  and Step 13 (CLAUDE.md prompt) annotated as orchestrator-owned. Same
+  semantics-preserving annotation policy.
+
+- **`init/sdlc-init.md`** — Body reduced to a spec-pointer paragraph: points
+  to `wfl-init.js` (orchestration), `commands/init.md` (dispatch surface), and
+  `init/phases/` (canonical per-phase contracts). Phase/verify table preserved
+  for human readers. File not deleted.
+
+---
+
 ## [1.2.21] — 2026-06-06
 
 ### Fixed

package/dist/bin/argv.d.ts

@@ -1,5 +1,5 @@
-/** Parsed result when `--version`, `--help`, `doctor`, `update`, `config`, or a fast-path subcommand is requested. */
-export type ForgeAction = "version" | "help" | "doctor" | "update" | "config" | "subcommand" | null;
+/** Parsed result when `--version`, `--help`, `doctor`, `update`, `config`, `init`, or a fast-path subcommand is requested. */
+export type ForgeAction = "version" | "help" | "doctor" | "update" | "config" | "init" | "uninstall" | "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

package/dist/bin/argv.js

@@ -155,6 +155,31 @@ export function parseForgeArgv(argv) {
                 subcommandArgs: argv.slice(i + 1),
             };
         }
+        // ── `forge init` — deterministic bootstrap (FORGE-S31-T02) ─────────
+        // Bootstraps a Claude Code project from the bundled forge-payload.
+        // Subcommand args (["claude", "[dir]", ...flags]) are forwarded to
+        // init.ts for further parsing. Only matches the first bare token,
+        // no flags collected yet.
+        if (token === "init" && piArgv.length === 0) {
+            return {
+                forgeAction: "init",
+                piArgv: [],
+                env,
+                subcommandArgs: argv.slice(i + 1),
+            };
+        }
+        // ── `forge uninstall` — deterministic reverse of `init` ─────────────
+        // Removes the Forge scaffold a prior `init claude` placed in a project.
+        // Subcommand args (["claude", "[dir]", "--purge", "--yes"]) forwarded to
+        // uninstall.ts. Only matches the first bare token, no flags collected yet.
+        if (token === "uninstall" && piArgv.length === 0) {
+            return {
+                forgeAction: "uninstall",
+                piArgv: [],
+                env,
+                subcommandArgs: argv.slice(i + 1),
+            };
+        }
         // ── 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

package/dist/bin/argv.js.map

@@ -1 +1 @@
-{"version":3,"file":"argv.js","sourceRoot":"","sources":["../../src/bin/argv.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,0EAA0E;AAC1E,sEAAsE;AACtE,EAAE;AACF,8CAA8C;AAC9C,EAAE;AACF,qBAAqB;AACrB,yDAAyD;AACzD,sDAAsD;AACtD,iEAAiE;AACjE,mEAAmE;AACnE,EAAE;AACF,wCAAwC;AACxC,mEAAmE;AACnE,mEAAmE;AACnE,EAAE;AACF,6CAA6C;AAC7C,oEAAoE;AACpE,sEAAsE;AACtE,gDAAgD;AAKhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACpF,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,aAAa;IACtB,gBAAgB,EAAE,oBAAoB;IACtC,aAAa,EAAE,iBAAiB;CAChC,CAAC,CAAC;AAqBH,MAAM,UAAU,YAAY,CAAC,CAAqB;IACjD,OAAO,OAAO,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,kFAAkF;AAClF,4DAA4D;AAC5D,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACjC,YAAY;IACZ,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,eAAe;CACf,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACnC,OAAO;IACP,WAAW;IACX,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,SAAS;IACT,SAAS;IACT,wBAAwB;CACxB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAc;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,WAAW,GAAgB,IAAI,CAAC;IAEpC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEtB,wEAAwE;QACxE,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC3B,WAAW,GAAG,SAAS,CAAC;YACxB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,WAAW,GAAG,MAAM,CAAC;YACrB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,IAAI,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACnC,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC;YAChC,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,IAAI,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACnC,GAAG,CAAC,qBAAqB,GAAG,GAAG,CAAC;YAChC,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,IAAI,KAAK,KAAK,iBAAiB,EAAE,CAAC;YACjC,GAAG,CAAC,mBAAmB,GAAG,GAAG,CAAC;YAC9B,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC1B,OAAO,EAAE,KAAK,EAAE,2EAA2E,EAAE,CAAC;YAC/F,CAAC;YACD,GAAG,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACvC,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACV,CAAC;QAED,wEAAwE;QACxE,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,wEAAwE;QACxE,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzB,CAAC,IAAI,CAAC,CAAC;YACR,CAAC;iBAAM,CAAC;gBACP,sDAAsD;gBACtD,CAAC,EAAE,CAAC;YACL,CAAC;YACD,SAAS;QACV,CAAC;QAED,uEAAuE;QACvE,qEAAqE;QACrE,4CAA4C;QAC5C,IAAI,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACN,WAAW,EAAE,QAAQ;gBACrB,MAAM,EAAE,EAAE;gBACV,GAAG;gBACH,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;aACjC,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,6DAA6D;QAC7D,IAAI,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACN,WAAW,EAAE,QAAQ;gBACrB,MAAM,EAAE,EAAE;gBACV,GAAG;gBACH,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;aACjC,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,wEAAwE;QACxE,0EAA0E;QAC1E,6DAA6D;QAC7D,IAAI,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACN,WAAW,EAAE,QAAQ;gBACrB,MAAM,EAAE,EAAE;gBACV,GAAG;gBACH,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;aACjC,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,iEAAiE;QACjE,mEAAmE;QACnE,sEAAsE;QACtE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClG,OAAO;gBACN,WAAW,EAAE,YAAY;gBACzB,MAAM,EAAE,EAAE;gBACV,GAAG;gBACH,cAAc,EAAE,qBAAqB,CAAC,KAAK,CAAC;gBAC5C,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;aACjC,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,EAAE,CAAC;YACJ,SAAS;QACV,CAAC;QAED,wEAAwE;QACxE,2BAA2B;QAC3B,OAAO;YACN,KAAK,EAAE,yBAAyB,KAAK,mCAAmC;SACxE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACrC,CAAC"}
+{"version":3,"file":"argv.js","sourceRoot":"","sources":["../../src/bin/argv.ts"],"names":[],"mappings":"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"}

package/dist/bin/forge.js

@@ -14,6 +14,8 @@ import { isParseError, parseForgeArgv } from "./argv.js";
 import { runConfig } from "./config.js";
 import { runDoctor } from "./doctor.js";
 import { applyForgeOwnedEnvDefaults } from "./env-defaults.js";
+import { runInit } from "./init.js";
+import { runUninstall } from "./uninstall.js";
 import { runUpdate } from "./update-cli.js";
 // ---------------------------------------------------------------------------
 // Version information (resolved at startup from package.json files)
@@ -64,6 +66,8 @@ Subcommands:
   doctor [--json]          Preflight check — pi auth, model availability, settings
   update [--check] [--yes] [--version <spec>]  Guided upgrade (npm i -g)
   config show [--resolved] [--json]  Model routing config inspector
+  init claude [dir]        Bootstrap a Claude Code project from the bundled forge-payload
+  uninstall claude [dir] [--purge] [--yes]  Remove the Forge scaffold (--purge also removes config + store)
 
 Slash commands (inside a Forge project):
   /forge:init              Bootstrap a new Forge SDLC project
@@ -113,6 +117,14 @@ async function run() {
         const exitCode = await runConfig(parsed.subcommandArgs ?? []);
         process.exit(exitCode);
     }
+    if (parsed.forgeAction === "init") {
+        const exitCode = await runInit(parsed.subcommandArgs ?? []);
+        process.exit(exitCode);
+    }
+    if (parsed.forgeAction === "uninstall") {
+        const exitCode = await runUninstall(parsed.subcommandArgs ?? []);
+        process.exit(exitCode);
+    }
     // Apply forge env overrides
     Object.assign(process.env, parsed.env);
     applyForgeOwnedEnvDefaults();

package/dist/bin/forge.js.map

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

package/dist/bin/init.d.ts

@@ -0,0 +1,23 @@
+export interface InitArgs {
+    platform: "claude";
+    dir: string;
+}
+export interface InitArgsError {
+    error: string;
+}
+/**
+ * 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 declare function parseInitArgs(args: readonly string[]): InitArgs | InitArgsError;
+/**
+ * Entry point invoked from bin/forge.ts.
+ *
+ * Returns exit code: 0 on success, 1 on bootstrap error.
+ */
+export declare function runInit(args: readonly string[]): Promise<number>;