@entelligentsia/forgecli 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -5,6 +5,89 @@ 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
@@ -109,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

@@ -35,19 +35,146 @@ Outputs land in `.forge/{personas,skills,workflows,templates,config.json,project
 ## CLI flags
 
 ```
-forge --version            Print version triplet (forgecli, forge, pi)
-forge --help               Show forge + pi help
-forge --no-update-check    Skip update check
-forge --registry <path>    Override model registry
+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:
+
+| 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 |
+
+## Custom tools
+
+### `forge:ask_user` — interactive prompt
+
+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.
+
+**Schema:**
+
+```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
+}
+```
+
+**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.2.0)     |
+| `/forge:init`             | Shipped (0.3.0)     |
 | Other `/forge:*` commands | Roadmap             |
 
 Track via [issues](https://github.com/Entelligentsia/forge-cli/issues).

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":"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"}

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":"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"}

package/dist/extensions/forgecli/forge-init.js

@@ -90,6 +90,20 @@ function getBundledForgeVersion() {
 // ── Session-scoped banner state ────────────────────────────────────────────
 // Prevents re-rendering the hero banner on resume within the same session.
 let heroBannerShown = false;
+// ── Non-interactive mode ───────────────────────────────────────────────────
+/**
+ * Returns true when running in non-interactive / CI mode.
+ *
+ * Activated by either:
+ *   - `FORGE_YES=1`          — ergonomic shell shorthand (FORGE-S18-T01)
+ *   - `FORGE_NON_INTERACTIVE=1` — set by `forge --non-interactive` flag
+ *
+ * When active, every Y/N gate resolves to its documented default without
+ * emitting a model-text prompt.
+ */
+function isNonInteractive() {
+    return process.env.FORGE_YES === "1" || process.env.FORGE_NON_INTERACTIVE === "1";
+}
 function parseInitFlags(args) {
     const parts = args.trim().split(/\s+/).filter(Boolean);
     const hasFast = parts.includes("--fast");
@@ -255,8 +269,10 @@ async function linkAgentInstructionFile(cwd, kbPath, projectName, ctx) {
         // Already exists — do NOT modify (per spec step 4-11: avoid KB-link bloat)
         return;
     }
-    // None exist — prompt to create minimal CLAUDE.md
-    const ok = await ctx.ui.confirm("Create CLAUDE.md?", `No agent instruction file found at project root.\nCreate a minimal CLAUDE.md with links to the Forge knowledge base? [Y/n]`);
+    // None exist — prompt to create minimal CLAUDE.md (G4: bypassed in non-interactive mode)
+    const ok = isNonInteractive()
+        ? true
+        : await ctx.ui.confirm("Create CLAUDE.md?", `No agent instruction file found at project root.\nCreate a minimal CLAUDE.md with links to the Forge knowledge base? [Y/n]`);
     if (!ok) {
         ctx.ui.notify("〇 KB not linked — run /forge:refresh-kb-links after creating CLAUDE.md.", "info");
         return;
@@ -343,7 +359,10 @@ export function registerForgeInit(pi) {
                 const nextPhase = Math.min(lastPhase + 1, 4);
                 const resumeBanner = `〇 Previous init detected — last completed phase: ${lastPhase} of 4\n` +
                     `Resume from Phase ${nextPhase}?`;
-                const shouldResume = await ctx.ui.confirm("Resume /forge:init?", resumeBanner);
+                // G1: in non-interactive mode, default to not resuming (start fresh)
+                const shouldResume = isNonInteractive()
+                    ? false
+                    : await ctx.ui.confirm("Resume /forge:init?", resumeBanner);
                 if (shouldResume) {
                     startPhase = nextPhase;
                     // Skip hero banner on resume (session-scoped gate)
@@ -386,7 +405,7 @@ export function registerForgeInit(pi) {
             // ── 5. Pre-flight plan (unless jumping to a specific phase) ───────
             const projectName = discoverProjectName(cwd);
             if (flags.startPhase === null || flags.invalidPhase) {
-                const preflightText = `## Forge Init — ${projectName}\n\n` +
+                const preflightSummary = `Forge Init — ${projectName}\n\n` +
                     `4 phases will run in this session (~45 seconds non-interactive):\n\n` +
                     `  1   Collect      — 5 parallel discovery scans → config.json\n` +
                     `                     KB folder prompt (interactive)\n` +
@@ -394,10 +413,15 @@ export function registerForgeInit(pi) {
                     `  3   Materialize  — substitute-placeholders.cjs → fully functional workflows\n` +
                     `  4   Register     — versioning, manifest, cache, store entries, Tomoshibi\n\n` +
                     `Phase 1 is interactive (KB folder name prompt). Phases 2–4 are non-interactive\n` +
-                    `and complete in under 45 seconds.\n\n` +
-                    `Start from Phase 1? [Y] or specify phase (1–4): ___`;
-                sendToAgent(preflightText);
-                await ctx.waitForIdle();
+                    `and complete in under 45 seconds.`;
+                // G2: skip pre-flight confirm in non-interactive mode (proceed directly to Phase 1)
+                if (!isNonInteractive()) {
+                    const proceed = await ctx.ui.confirm("Start /forge:init?", preflightSummary);
+                    if (!proceed) {
+                        ctx.ui.notify("〇 /forge:init cancelled.", "info");
+                        return;
+                    }
+                }
             }
             // ── Phase 1 — Collect ─────────────────────────────────────────────
             if (startPhase <= 1) {
@@ -417,14 +441,22 @@ export function registerForgeInit(pi) {
                 const phase1Prompt = buildPhase1PromptText(bundleRoot, projectName);
                 sendToAgent(phase1Prompt);
                 await ctx.waitForIdle();
-                // KB folder prompt (spec §7, F2)
-                const kbPromptText = `━━━ Knowledge Base Folder ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n` +
-                    `Forge will create a folder for architecture docs, sprints, bugs, and features.\n` +
-                    `Default name: engineering/\n\n` +
-                    `Does "engineering" conflict with an existing folder in this project? [n/Y]\n` +
-                    `If yes, enter your preferred name (e.g. ai-docs, .forge-kb, docs/ai): ___`;
-                sendToAgent(kbPromptText);
-                await ctx.waitForIdle();
+                // KB folder prompt (spec §7, F2) — G3: skipped in non-interactive mode (default: "engineering")
+                if (!isNonInteractive()) {
+                    const kbDescription = `Forge will create a folder for architecture docs, sprints, bugs, and features.\n` +
+                        `Default name: engineering/\n\n` +
+                        `Does "engineering" conflict with an existing folder in this project?`;
+                    const hasConflict = await ctx.ui.confirm("Engineering folder name?", kbDescription);
+                    if (hasConflict) {
+                        const customName = await ctx.ui.input("Engineering folder name?", "Enter preferred folder name (e.g. ai-docs, .forge-kb, docs/ai): ");
+                        if (customName && customName.trim()) {
+                            const manageConfigToolEarly = path.join(toolsRoot, "manage-config.cjs");
+                            if (fs.existsSync(manageConfigToolEarly)) {
+                                await runToolAdvisory(manageConfigToolEarly, ["set", "paths.engineering", customName.trim()], cwd, ctx, "manage-config paths.engineering");
+                            }
+                        }
+                    }
+                }
                 // Marketplace skills advisory (sub-decision #1)
                 ctx.ui.notify("〇 Marketplace skills auto-recommendation is Claude-Code-only. " +
                     "Pi users install extensions manually. Writing installedSkills: []", "info");