@entelligentsia/forgecli 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,141 @@ All notable changes to `@entelligentsia/forgecli` are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+---
+
+## [0.3.0] — 2026-05-09
+
+Headline: Pi-runtime parity adapters — interactive UX + hook safety net.
+`forge:ask_user` delivers real TUI prompts for all `/forge:init` gate sites;
+the hook safety net enforces store-cli write validity and legal status
+transitions at runtime. Fixes BUG-026 (non-blocking Y/N prompts) and BUG-027
+(unguarded store-cli writes under pi runtime).
+
+### Added
+
+- **`forge:ask_user` custom tool** (FORGE-S18-T04).
+  Registers `forge_ask_user` via `pi.registerTool`. Accepts `{question, type, options?, default?}`
+  where `type` is `confirm` (Y/N), `choice` (select from list), or `text` (free-form input).
+  Uses `ctx.ui.confirm / select / input` from the pi `ExtensionContext` — no raw pi-tui
+  component wiring needed. Blocks the model loop until the user responds. Non-interactive
+  bypass: `FORGE_YES=1`, `--non-interactive`, or headless mode returns the default
+  immediately. Cancellation surfaces as `isError: true`. 14 Vitest tests.
+
+- **`registerHookDispatcher` wired to `tool_call` / `tool_result`** (FORGE-S18-T02).
+  Replaces the 7-line empty shim with a real implementation. Subscribes both pi events
+  (wired to tool_call/tool_result; enforcement layer added by T03).
+  Exports `parseStoreCLIInvocation()` + `StoreCLICall` interface for T03 to layer
+  validation on top. Hook inventory document produced at
+  `engineering/sprints/FORGE-S18/FORGE-S18-T02/HOOK_INVENTORY.md`.
+
+- **Store-cli pushback correction loop + audit-log mode** (FORGE-S18-T03).
+  Extends the T02 hook-dispatcher scaffold from audit-only to enforcement.
+  `store-validator.ts` spawns `store-cli validate` synchronously on every write call;
+  `transition-guard.ts` enforces the legal status-transition table for task/sprint/bug
+  records. Returns `{ block: true, reason }` on violation. `FORGE_HOOK_AUDIT=1` logs
+  every decision (would-block/would-allow) with timestamp, entity, reason — returns
+  `undefined` (allow-through) regardless, enabling observation without disruption.
+  Closes FORGE-BUG-027.
+
+### Changed
+
+- **Gate sites in `/forge:init` now use `forge:ask_user`** (FORGE-S18-T05). G2
+  (pre-flight phase selector) and G3 (KB folder prompt) replaced from
+  `sendToAgent+waitForIdle` to `ctx.ui.confirm / ctx.ui.input`. Operator receives a
+  real TUI prompt instead of model-generated text. Gate audit captured in
+  `GATE_AUDIT.md`.
+
+### Fixed
+
+- **BUG-026** — Pi runtime: TUI Y/N prompts in command bodies don't wait for user
+  input. Fixed by `forge:ask_user` tool (T04) + gate-site retrofit (T05). `/forge:init`
+  gate sites G2 and G3 now use `ctx.ui.confirm/input` and block until the operator
+  responds.
+- **BUG-027** — Pi runtime: validation hooks not wired — store-cli writes unguarded,
+  no pushback correction loop. Fixed by hook adapter (T02) + enforcement layer (T03).
+  `registerHookDispatcher` intercepts `store-cli write` and `store-cli update-status`
+  calls, validates against schema and transition table, returns `{ block: true, reason }`
+  on violation.
+
+---
+
+## [0.2.1] — 2026-05-09
+
+Headline: Non-interactive mode for CI and scripted use. `FORGE_YES=1` and
+`forge --non-interactive` both bypass every Y/N gate in `/forge:init`, resolving
+each to its documented default. Unblocks scripted adoption immediately (BUG-026
+short-circuit; T04/T05 deliver the real interactive TUI path).
+
+### Added
+
+- **`--non-interactive` CLI flag** (FORGE-S18-T01). Parsed by `argv.ts`,
+  sets `FORGE_NON_INTERACTIVE=1`. Documented in `--help` output.
+- **`FORGE_YES=1` environment variable** (FORGE-S18-T01). Ergonomic shorthand
+  for scripts (`FORGE_YES=1 forge`). Checked alongside `FORGE_NON_INTERACTIVE`.
+- **`isNonInteractive()` helper** in `forge-init.ts`. Bypasses G1 (resume
+  confirm), G2 (pre-flight phase selector), G3 (KB folder name), G4 (CLAUDE.md
+  create confirm) when active.
+- **README non-interactive mode section** — flag, env var, and default-resolution
+  table for all four gate sites.
+- **Vitest gate coverage** — 12 new test cases covering each gate under
+  interactive, `FORGE_NON_INTERACTIVE=1`, and `FORGE_YES=1` arms.
+- **E2E smoke gates E2E-04/05/06** — auth-free checks that flag and env vars
+  are accepted without errors.
+
+## [0.2.0] — 2026-05-09
+
+Headline: `/forge:init` is now a real implementation. The 0.1.0 stub at
+`src/extensions/forgecli/index.ts:77-82` is replaced with a full-parity port of
+the Claude-Code plugin's `/forge:init` flow. Default payload trimmed by 35.8%
+unpacked. Tarball size-budget gate enforced in smoke + CI.
+
+### Added
+
+- **`/forge:init` real implementation** (FORGE-S17-T02). Full parity to the
+  plugin: 4-phase flow, `--fast` / `--full` flags, resume detection via
+  `.forge/init-progress.json`, hero banner with project-name discovery, idempotent
+  re-run. Consumes `dist/forge-payload/`, substitutes placeholders against user
+  project context, writes `.forge/{personas,skills,workflows,templates,config.json,project-context.json}`.
+- **Tarball size-budget gate** (FORGE-S17-T05) at
+  `test/e2e/lib/tarball-size-gate.sh` (sourceable) plus
+  `test/e2e/size-budget.test.sh` (18 boundary assertions). Smoke gate runs after
+  `npm pack` with PASS / WARN (>35 MB) / FAIL (>50 MB) status. Thresholds
+  env-overridable via `FORGE_TARBALL_SIZE_*`.
+- **`scripts/build-payload.cjs --include-full`** flag and `--help`
+  (FORGE-S17-T04). Opt-in to the legacy un-trimmed payload for forensic /
+  round-trip verification — round-trip verified byte-exact.
+- **Mid-sprint runtime fixes** (FORGE-BUG-017..025) — `/forge:init` runtime
+  defects discovered during init-port adaptation review; pi-aware
+  `paths.forgeRoot`; skip Claude-Code-only command output during init.
+
+### Changed
+
+- **Default payload trimmed by 35.8% unpacked** (FORGE-S17-T03 audit applied
+  by FORGE-S17-T04). Files 175 → 105, unpacked 704,388 → 452,445 bytes,
+  forge-payload tar.gz 194,067 → 123,505 bytes (−36.4%). Trim sites:
+  - top-level `personas/skills/workflows/templates/` removed (Pass 1 vestige,
+    never read at runtime),
+  - `.tools/lib/` allowlisted to runtime-loaded subset
+    (`forge-root, paths, pricing, project-root, result.js, validate.js`),
+  - `.init/generation/` reduced to `generate-kb-doc.md`,
+  - `.schemas/` reduced to `*.schema.json`.
+- **Full `npm pack` output** (the published artifact, with bundled pi runtime
+  as bulk): 30.42 MB compressed, 19.58 MB headroom under the 50 MB hard gate.
+
+### Documentation
+
+- README updated with size-budget tuning surface and trimmed-payload note.
+
+### 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`.
+- `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
@@ -57,4 +192,7 @@ 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.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
 [0.1.0]: https://github.com/Entelligentsia/forge-cli/releases/tag/v0.1.0

package/README.md

@@ -1,52 +1,191 @@
-# forgecli
+## @entelligentsia/forgecli
 
-**Status:** Stage 1 scaffold (FORGE-S15-T01). No runtime logic yet.
+Forge SDLC on the [pi-coding-agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) runtime. Three bin aliases: `forge`, `forgecli`, `4ge`.
 
-`forgecli` is the TypeScript port of the Forge SDLC plugin, packaged as a `pi-coding-agent` extension. It will eventually expose the same workflows, personas, and tools that live in the Claude Code Forge plugin (`forge/`), but on the pi runtime.
+Bundled Forge plugin: **v0.40.3**.
+Bundled pi runtime: pinned in `package.json`.
 
-## Layout
+## Install
 
+```sh
+npm install -g @entelligentsia/forgecli
 ```
-forge-cli/
-├── package.json              ← name "forgecli", ESM, peer dep on @earendil-works/pi-coding-agent ^0.73.0
-├── tsconfig.json             ← strict, NodeNext, ES2022, outDir dist/
-├── biome.json                ← mirrors pi-mono conventions
-├── src/
-│   ├── extensions/forgecli/
-│   │   ├── index.ts          ← extension entrypoint (no-op stub)
-│   │   ├── forge-tools.ts    ← tool registration shim
-│   │   ├── forge-commands.ts ← command registration shim
-│   │   ├── hook-dispatcher.ts← hook routing shim
-│   │   ├── forge-root.ts     ← .forge/config.json resolver stub
-│   │   └── subagent/         ← T02 vendors pi-mono subagent module here
-│   └── bin/forgecli.ts       ← CLI entry stub (real impl in T03)
-├── agents/                   ← reserved for generated agents
-├── prompts/                  ← reserved for generated prompts
-├── skills/                   ← reserved for skill defs
-└── test/poc/                 ← spike tests for T04–T09
+
+Requires Node 20+.
+
+## Quick start
+
+```sh
+cd your-project
+forge                # launch interactive session (forge | forgecli | 4ge)
+> /forge:init        # bootstrap Forge SDLC — 4 phases, ~45s
+```
+
+`/forge:init` is idempotent and resumable via `.forge/init-progress.json`. Re-running picks up where the previous run stopped.
+
+## What `/forge:init` does
+
+1. **Collect** — 5 parallel discovery scans → `.forge/config.json`
+2. **Discover** — KB doc generation + `.forge/project-context.json`
+3. **Materialize** — substitute placeholders → fully functional workflows
+4. **Register** — versioning, manifest, cache, store entries
+
+Outputs land in `.forge/{personas,skills,workflows,templates,config.json,project-context.json}` and the configured KB folder (default `engineering/`).
+
+## CLI flags
+
+```
+forge --version              Print version triplet (forgecli, forge, pi)
+forge --help                 Show forge + pi help
+forge --no-update-check      Skip update check
+forge --non-interactive      Bypass all Y/N gates with defaults (CI/scripted use)
+forge --registry <path>      Override model registry
+```
+
+Pi flags (`-p`, `--cwd`, `--session`, `--model`, `--tools`, `--thinking`, …) are forwarded verbatim. Run `forge --help` for the full list.
+
+## Non-interactive mode
+
+For CI, scripts, or any context where the model cannot answer Y/N prompts:
+
+```sh
+# Using the flag
+forge --non-interactive
+
+# Using the environment variable
+FORGE_YES=1 forge
+```
+
+Both activate the same bypass. When active, every Y/N gate in `/forge:init` resolves to its documented default:
+
+| Gate | Default resolution |
+|------|--------------------|
+| Resume previous init? | No — delete checkpoint, start fresh |
+| Pre-flight phase selector (Phase 1–4 prompt) | Skip prompt — proceed from Phase 1 |
+| Knowledge base folder name | Use default `engineering/` |
+| Create CLAUDE.md? | Yes — create with KB links |
+
+## Hook safety net
+
+forge-cli intercepts `store-cli write` and `store-cli update-status` bash calls and validates them before they reach the store. This prevents malformed payloads and illegal status transitions from corrupting the project's engineering knowledge base.
+
+### Default-on enforcement
+
+When enforcement is active (default), the hook dispatcher:
+
+1. **Schema validation** — every `store-cli write <entity> '<json>'` invocation is validated against the entity schema. If the payload is invalid, the model receives a structured error via `{ block: true, reason: <error> }` and is expected to self-correct on the next attempt.
+
+2. **Transition guard** — every `store-cli update-status <entity> <id> status <value>` invocation is checked against the legal transition table for the entity. Illegal transitions (e.g. `draft → committed`, skipping required intermediate states) are blocked with an explanatory message naming both `from` and `to` states and the legal next states.
+
+Both checks are enforced by default. The hooks fire synchronously before the tool executes, so the model sees the error as the tool result and retries with a corrected payload.
+
+### `--force` scope
+
+When `--force` is present in the `store-cli` argv:
+
+- **Transition guard** is bypassed — `--force` is an explicit operator override for status transitions.
+- **Schema validation still runs** — a malformed payload is always invalid regardless of intent.
+
+### `FORGE_HOOK_AUDIT=1` — audit-only mode
+
+Set `FORGE_HOOK_AUDIT=1` to observe hook decisions without taking action. In audit mode:
+
+- Every decision (would-block, would-allow, lookup-failed) is logged to `.forge/logs/hooks.log`.
+- Nothing is blocked — all calls proceed regardless of validation outcome.
+- Useful for calibrating the false-positive rate before enabling enforcement in a new project.
+
+Log format (one entry per line):
+
 ```
+[store-cli-intercept] subcmd=write entity=task payload={"taskId":"..."}
+[store-cli-intercept] decision=would-block reason=missing required field: taskId
+[store-cli-intercept] decision=would-allow
+[store-cli-intercept] decision=lookup-failed entity=task entityId=FORGE-S18-T03
+```
+
+### Interpreting block messages
+
+When the model emits a malformed `store-cli` call and the hook blocks it, the tool result will contain:
+
+```
+block: true
+reason: <error text>
+```
+
+The model should read the `reason` field and self-correct the payload or transition before retrying. Common block reasons:
 
-## Reference
+| Reason pattern | Cause | Fix |
+|---|---|---|
+| `missing required field: <field>` | Schema validation — required field absent | Add the missing field to the payload |
+| `<from> → <to> is not a legal transition...` | Transition guard — illegal status jump | Use the listed legal next states |
+| `store-cli validate exited with code 1` | Schema validation — malformed JSON or unknown entity | Fix the JSON payload |
 
-- `architectural-review.md` (sibling of this README) — design decisions and constraints.
-- `forge-cli-feasibility.txt` — feasibility study and PoC notes.
-- `.claude/skills/forge-cli-engineer/SKILL.md` — implementer skill (boundary rules, git protocol).
+## Custom tools
 
-## Next steps
+### `forge:ask_user` — interactive prompt
 
-| Task | What lands |
-|---|---|
-| FORGE-S15-T02 | Vendor subagent module from pi-mono |
-| FORGE-S15-T03 | No-op extension entrypoint + `pi -e` smoke load |
-| FORGE-S15-T04–T09 | Spike R1–R6 PoCs |
-| FORGE-S15-T10 | Stage 2 gate |
+The `forge_ask_user` custom tool allows Forge workflows to request user input
+during model execution. It presents the appropriate TUI prompt and blocks the
+model loop until the user responds.
 
-## Build / verify (Stage 1)
+**Schema:**
 
-```bash
-cd forge-cli
-npm install
-npx tsc --noEmit
+```typescript
+{
+  question: string;         // The prompt shown to the user
+  type: "confirm"           // Y/N boolean confirmation
+       | "choice"           // Select from a list
+       | "text";            // Free-form single-line input
+  options?: string[];       // Required when type === "choice"
+  default?: string;         // Returned in non-interactive mode
+}
 ```
 
-No runtime entrypoint is wired up yet — `npm run lint` and `npx tsc --noEmit` are the only meaningful verifications at this stage.
+**Returns:** A string — `"Y"` or `"N"` for `confirm`, the selected option for
+`choice`, or the entered text for `text`. On cancellation (user dismisses the
+dialog), the tool returns `isError: true` with a structured message.
+
+**Examples:**
+
+```
+// Confirm
+forge_ask_user({ question: "Overwrite existing files?", type: "confirm" })
+// → "Y" or "N"
+
+// Choice
+forge_ask_user({
+  question: "Select environment:",
+  type: "choice",
+  options: ["development", "staging", "production"]
+})
+// → "development" | "staging" | "production"
+
+// Text
+forge_ask_user({ question: "Enter project name:", type: "text", default: "myproject" })
+// → user-entered string (or "myproject" in non-interactive mode)
+```
+
+**Non-interactive behaviour:** When `FORGE_YES=1`, `--non-interactive` is set,
+or pi is running in headless/RPC mode, the tool returns the `default` immediately
+without rendering any TUI. Fallback defaults when no explicit `default` is
+provided: `confirm` → `"Y"`, `choice` → `options[0]`, `text` → `""`.
+
+## Roadmap
+
+| Command                   | Status              |
+|---------------------------|---------------------|
+| `/forge:init`             | Shipped (0.3.0)     |
+| Other `/forge:*` commands | Roadmap             |
+
+Track via [issues](https://github.com/Entelligentsia/forge-cli/issues).
+
+## Links
+
+- Source: <https://github.com/Entelligentsia/forge-cli>
+- Issues: <https://github.com/Entelligentsia/forge-cli/issues>
+- Forge plugin (Claude Code): <https://github.com/Entelligentsia/forge>
+- Changelog: [CHANGELOG.md](./CHANGELOG.md)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/bin/argv.js

@@ -71,6 +71,11 @@ export function parseForgeArgv(argv) {
             i++;
             continue;
         }
+        if (token === "--non-interactive") {
+            env.FORGE_NON_INTERACTIVE = "1";
+            i++;
+            continue;
+        }
         if (token === "--registry") {
             if (i + 1 >= argv.length) {
                 return { error: "forge: --registry requires a path argument. Run `forge --help` for usage." };

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":"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;AAoBhD,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;;;;;GAKG;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,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,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,uBAAuB,KAAK,mCAAmC;SACtE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACrC,CAAC"}

package/dist/bin/forge.js

@@ -56,6 +56,7 @@ Forge-owned options:
   --version                Print version triplet and exit
   --help, -h               Print this help message
   --no-update-check        Skip forge update check (sets FORGE_NO_UPDATE_CHECK=1)
+  --non-interactive        Bypass all Y/N gates with defaults, e.g. for CI (sets FORGE_NON_INTERACTIVE=1)
   --registry <path>        Override model registry path (sets FORGE_MODEL_REGISTRY=path)
 
 Pi options (forwarded verbatim):

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/extensions/forgecli/ask-user-tool.d.ts

@@ -0,0 +1,17 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+export declare const AskUserParams: Type.TObject<{
+    question: Type.TString;
+    type: Type.TUnion<[Type.TLiteral<"confirm">, Type.TLiteral<"choice">, Type.TLiteral<"text">]>;
+    options: Type.TOptional<Type.TArray<Type.TString>>;
+    default: Type.TOptional<Type.TString>;
+}>;
+/**
+ * Register the forge_ask_user tool with the pi ExtensionAPI.
+ *
+ * The tool is named `forge_ask_user` (snake_case per pi convention); the
+ * human/LLM-facing name `forge:ask_user` appears in description and promptSnippet.
+ *
+ * @param pi  The pi ExtensionAPI instance.
+ */
+export declare function registerAskUserTool(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/ask-user-tool.js

@@ -0,0 +1,139 @@
+// forge:ask_user custom tool — FORGE-S18-T04
+//
+// Registers forge_ask_user via pi.registerTool. The tool accepts a question and
+// an input type (confirm | choice | text), presents the appropriate TUI prompt
+// via ctx.ui.confirm / ctx.ui.select / ctx.ui.input, and returns the user's
+// answer as a string.
+//
+// Non-interactive bypass:
+//   When FORGE_YES=1 or FORGE_NON_INTERACTIVE=1 (set by `forge --non-interactive`),
+//   or when ctx.hasUI is false (headless / RPC mode), the tool returns the supplied
+//   default without rendering any TUI. Fallback defaults when no explicit default:
+//     confirm  → "Y"
+//     choice   → options[0] (or "" if empty)
+//     text     → ""
+//
+// Cancellation:
+//   ctx.ui.* returns undefined when the user cancels. The tool surfaces this as
+//   isError: true with a structured message — never silently defaults.
+//
+// Iron Law 6 compliance: no shell-string interpolation. No subprocess spawning.
+import { Type } from "typebox";
+// ── Schema ────────────────────────────────────────────────────────────────────
+export const AskUserParams = Type.Object({
+    question: Type.String({
+        description: "The question or prompt to display to the user.",
+    }),
+    type: Type.Union([Type.Literal("confirm"), Type.Literal("choice"), Type.Literal("text")], {
+        description: "Input modality: confirm (Y/N boolean), choice (select from list), or text (free-form single-line input).",
+    }),
+    options: Type.Optional(Type.Array(Type.String(), {
+        description: "Required when type === 'choice'. The list of options to present to the user.",
+    })),
+    default: Type.Optional(Type.String({
+        description: "Default value returned in non-interactive mode or when no default is needed. " +
+            "If absent, the fallback is: confirm → 'Y', choice → options[0], text → ''.",
+    })),
+});
+// ── Non-interactive helper ────────────────────────────────────────────────────
+/**
+ * Returns true when running in non-interactive / CI mode.
+ *
+ * Inlined here (not imported from forge-init.ts) to keep the module boundary
+ * clean and avoid any risk of circular imports.
+ *
+ * Activated by:
+ *   - `FORGE_YES=1`             — ergonomic shell shorthand (FORGE-S18-T01)
+ *   - `FORGE_NON_INTERACTIVE=1` — set by `forge --non-interactive` flag
+ */
+function isNonInteractive() {
+    return process.env.FORGE_YES === "1" || process.env.FORGE_NON_INTERACTIVE === "1";
+}
+// ── Result helpers ────────────────────────────────────────────────────────────
+function okResult(text) {
+    return {
+        content: [{ type: "text", text: text || "" }],
+        details: {},
+    };
+}
+function errResult(text) {
+    return {
+        content: [{ type: "text", text }],
+        details: {},
+        isError: true,
+    };
+}
+// ── Fallback computation ──────────────────────────────────────────────────────
+/**
+ * Compute the non-interactive fallback value.
+ *
+ * Priority: explicit `default` field → type-specific hardcoded fallback.
+ */
+function computeFallback(params) {
+    if (params.default !== undefined)
+        return params.default;
+    if (params.type === "confirm")
+        return "Y";
+    if (params.type === "choice")
+        return params.options?.[0] ?? "";
+    return ""; // text
+}
+// ── Public registration ───────────────────────────────────────────────────────
+/**
+ * Register the forge_ask_user tool with the pi ExtensionAPI.
+ *
+ * The tool is named `forge_ask_user` (snake_case per pi convention); the
+ * human/LLM-facing name `forge:ask_user` appears in description and promptSnippet.
+ *
+ * @param pi  The pi ExtensionAPI instance.
+ */
+export function registerAskUserTool(pi) {
+    pi.registerTool({
+        name: "forge_ask_user",
+        label: "Forge Ask User",
+        description: "forge:ask_user — Present an interactive prompt to the user and return their answer. " +
+            "Accepts three input types: 'confirm' (Y/N), 'choice' (select from a list), or 'text' " +
+            "(free-form single-line input). Blocks the model loop until the user responds. " +
+            "In non-interactive mode (FORGE_YES=1 or --non-interactive), returns the default immediately.",
+        promptSnippet: "Use forge_ask_user when a Forge workflow needs synchronous user input — confirm (Y/N), choice from a list, or free-form text.",
+        parameters: AskUserParams,
+        async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+            // Non-interactive bypass: applies when env flag is set OR when running
+            // headless (ctx.hasUI=false, e.g. RPC mode / print mode).
+            if (isNonInteractive() || !ctx.hasUI) {
+                const fallback = computeFallback(params);
+                // Emit a one-line audit entry to stderr (not a file) so CI logs capture it.
+                process.stderr.write(`[forge:ask_user] non-interactive fallback — type=${params.type} question="${params.question}" default="${fallback}"\n`);
+                return okResult(fallback);
+            }
+            const opts = signal !== undefined ? { signal } : {};
+            if (params.type === "confirm") {
+                // ctx.ui.confirm returns true/false or undefined (cancel).
+                const answer = await ctx.ui.confirm("forge:ask_user", params.question, opts);
+                if (answer === undefined) {
+                    return errResult(`forge:ask_user cancelled — user dismissed the prompt. question: "${params.question}"`);
+                }
+                return okResult(answer ? "Y" : "N");
+            }
+            if (params.type === "choice") {
+                if (!params.options || params.options.length === 0) {
+                    return errResult("forge:ask_user error — type 'choice' requires a non-empty 'options' array.");
+                }
+                // ctx.ui.select returns the selected string or undefined (cancel).
+                const answer = await ctx.ui.select("forge:ask_user", params.options, opts);
+                if (answer === undefined) {
+                    return errResult(`forge:ask_user cancelled — user dismissed the prompt. question: "${params.question}"`);
+                }
+                return okResult(answer);
+            }
+            // type === "text"
+            // ctx.ui.input returns the entered string or undefined (cancel/ESC).
+            const answer = await ctx.ui.input("forge:ask_user", params.question, opts);
+            if (answer === undefined) {
+                return errResult(`forge:ask_user cancelled — user dismissed the prompt. question: "${params.question}"`);
+            }
+            return okResult(answer);
+        },
+    });
+}
+//# sourceMappingURL=ask-user-tool.js.map

package/dist/extensions/forgecli/ask-user-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-tool.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/ask-user-tool.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,sBAAsB;AACtB,EAAE;AACF,0BAA0B;AAC1B,oFAAoF;AACpF,oFAAoF;AACpF,mFAAmF;AACnF,qBAAqB;AACrB,6CAA6C;AAC7C,oBAAoB;AACpB,EAAE;AACF,gBAAgB;AAChB,gFAAgF;AAChF,uEAAuE;AACvE,EAAE;AACF,gFAAgF;AAGhF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,iFAAiF;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;QACrB,WAAW,EAAE,gDAAgD;KAC7D,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE;QACzF,WAAW,EACV,0GAA0G;KAC3G,CAAC;IACF,OAAO,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE;QACzB,WAAW,EAAE,8EAA8E;KAC3F,CAAC,CACF;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,CAAC;QACX,WAAW,EACV,+EAA+E;YAC/E,4EAA4E;KAC7E,CAAC,CACF;CACD,CAAC,CAAC;AAEH,iFAAiF;AAEjF;;;;;;;;;GASG;AACH,SAAS,gBAAgB;IACxB,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC;AACnF,CAAC;AAED,iFAAiF;AAEjF,SAAS,QAAQ,CAAC,IAAY;IAC7B,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;QACtD,OAAO,EAAE,EAAa;KACtB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC9B,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAa;QACtB,OAAO,EAAE,IAAa;KACtB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAIxB;IACA,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACxD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAC1C,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,OAAO;AACnB,CAAC;AAED,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAgB;IACnD,EAAE,CAAC,YAAY,CAAC;QACf,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACV,sFAAsF;YACtF,uFAAuF;YACvF,gFAAgF;YAChF,8FAA8F;QAC/F,aAAa,EACZ,+HAA+H;QAChI,UAAU,EAAE,aAAa;QACzB,KAAK,CAAC,OAAO,CACZ,WAAmB,EACnB,MAAuG,EACvG,MAA+B,EAC/B,SAAkB,EAClB,GAAqB;YAErB,uEAAuE;YACvE,0DAA0D;YAC1D,IAAI,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;gBACzC,4EAA4E;gBAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,oDAAoD,MAAM,CAAC,IAAI,cAAc,MAAM,CAAC,QAAQ,cAAc,QAAQ,KAAK,CACvH,CAAC;gBACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAEpD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/B,2DAA2D;gBAC3D,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC7E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,SAAS,CAAC,oEAAoE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAC1G,CAAC;gBACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpD,OAAO,SAAS,CAAC,4EAA4E,CAAC,CAAC;gBAChG,CAAC;gBACD,mEAAmE;gBACnE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC3E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,SAAS,CAAC,oEAAoE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;gBAC1G,CAAC;gBACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;YAED,kBAAkB;YAClB,qEAAqE;YACrE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAC,oEAAoE,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC1G,CAAC;YACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/extensions/forgecli/forge-commands.d.ts

@@ -7,8 +7,29 @@ interface RegisterOptions {
 }
 declare function resetTomoshibiState(): void;
 export declare function registerForgeCommands(pi: ExtensionAPI, options: RegisterOptions): void;
+/** Parse YAML frontmatter from a markdown file. Returns name and description or null. */
+declare function parseFrontmatter(content: string): {
+    name: string;
+    description: string;
+} | null;
+export interface RegisterAllOptions {
+    /** Absolute path to dist/forge-payload/ (containing .base-pack/commands/). */
+    bundlePayloadRoot: string;
+    /** Current working directory (for health check). */
+    cwd?: string;
+    /** Absolute path to dist/forge-payload/ for health check bundle root. */
+    bundleRoot?: string;
+}
+/**
+ * Register all forge commands from the bundled .base-pack/commands/ directory.
+ * Commands already registered (real handlers) are skipped.
+ * Returns the number of commands registered.
+ */
+export declare function registerAllForgeCommands(pi: ExtensionAPI, options: RegisterAllOptions): number;
 export declare const __test__: {
     resetTomoshibiState: typeof resetTomoshibiState;
     getTomoshibiPending: () => boolean;
+    parseFrontmatter: typeof parseFrontmatter;
+    REAL_HANDLERS: Set<string>;
 };
 export {};