@entelligentsia/forgecli 0.8.4 → 0.9.1

package/CHANGELOG.md

@@ -7,6 +7,67 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.1] — 2026-05-18
+
+### Changed
+- **README: Model setup documentation** — new section walks users through
+  the three-knob tier setup (Heavy / Standard / Light) with screen-by-screen
+  examples, scope toggle, verification, advanced overrides, and
+  non-interactive CLI alternatives.
+
+## [0.9.0] — 2026-05-18
+
+### Added
+- **Per-persona model routing** — Forge now routes each pipeline phase
+  (plan, review-plan, implement, review-code, validate, approve, writeback,
+  commit) to a specific AI model via persona-model assignments resolved
+  through a four-level cascade: per-step override → per-persona override →
+  tier baseline → pi current. The cascade is invisible to the user;
+  plain-English labels ("Heavy tier (global)", "Step override") replace
+  internal L1/L2/L3/L4 jargon everywhere it appears.
+- **Tiered-baseline config TUI** — `/forge:config` (and `forge config`)
+  now opens a three-knob landing screen: pick **Heavy** (architect,
+  supervisor), **Standard** (engineer, bug-fixer, qa-engineer,
+  product-manager), or **Light** (collator, librarian, orchestrator) —
+  one model per tier and all nine personas are configured in under 30
+  seconds. Tier selections commit immediately (no separate save step).
+  Scope toggles between project and global per tier-pick.
+- **`forge config show --resolved`** — prints a phase-by-phase table
+  showing which model runs each step, which persona handles it, and where
+  the assignment comes from (tier baseline, persona override, step
+  override, or pi-current fallback).
+- **`forge config dispatch [--pipeline=<name>] [--json]`** — per-phase
+  dispatch trace without making an LLM call. Shows the resolved model
+  and source for every phase of the chosen pipeline.
+- **`forge config show --strict-models`** — validates that every
+  resolved model exists in the authenticated provider catalog. Exits
+  non-zero if any persona or step resolves to an unavailable model.
+- **Advanced menu** — per-persona and per-step overrides are reachable
+  from a dedicated "Advanced" screen, clearly separated from the
+  primary tier knobs. Explanation banners explain that most users
+  don't need these.
+- **Observability** — each phase now logs `requested_model` and
+  `model_observed` so users can verify that the intended model ran.
+
+### Changed
+- **Bug-fix pipeline uses same persona routing** — `runBugPipeline`
+  now dispatches via `resolveModelForPhase` for every phase, consistent
+  with the task pipeline.
+- **Config TUI theming + width safety** — all screens use the pi TUI
+  theme (accent, muted, warning, border, etc.) and truncate to
+  terminal width via `safeLines`. Adaptive-width confirm-quit dialog.
+- **Config TUI `top-menu` removed** — replaced entirely by the tier-menu
+  landing screen. The `isEmpty` state snapshot is now a selector
+  (`isConfigEmpty`) derived from the buffer.
+
+### Fixed
+- **Forge-project detection** — `forge config` detects a Forge project
+  by the presence of `.forge/config.json` (not `.pi/`).
+- **Dirty tracking + confirm-quit** — save clears dirty; quit while
+  dirty opens a themed modal instead of exiting immediately.
+- **Scroll for long pickers** — provider and model pickers window
+  around the cursor when lists exceed the viewport.
+
 ## [0.8.4] — 2026-05-18
 
 ### Changed

package/README.md

@@ -95,11 +95,172 @@ CHAIN    /forge:plan          plan
 ASK      /forge:health        KB freshness + store integrity
          /forge:status        Sprint + task status
          /forge:ask <q>       Ask the Tomoshibi concierge
-         /forge:config        Inspect or change project config
+         /forge:config        Set up AI models for your workflow
 ```
 
 → [Full reference](docs/cli-reference.md) · [Non-interactive mode](docs/non-interactive.md) · [Hook safety net](docs/hook-safety-net.md) · [Custom tools](docs/custom-tools.md) · [Publishing](docs/publishing.md)
 
+## Model setup
+
+Forge routes each step of your pipeline — plan, review, implement, validate, approve, writeback, commit — to a **specific AI model** via a persona. Out of the box, every step inherits whatever model pi is currently running. The `/forge:config` screen lets you assign models in about 30 seconds.
+
+### The three-knob setup
+
+Forge groups its nine personas into three workload tiers:
+
+| Tier | Personas | What this model does |
+|------|----------|---------------------|
+| **Heavy** | 🗻 architect · 🌿 supervisor | Review, sign-off, gates |
+| **Standard** | 🌱 engineer · 🐛 bug-fixer · 🍵 qa-engineer · 📋 product-manager | Planning, implementation, validation |
+| **Light** | 🍃 collator · 📚 librarian · 🌊 orchestrator | Writeback, indexing, task flow |
+
+Pick one model per tier and you're done — all nine personas are configured.
+
+### Step by step
+
+**1. Open the config screen**
+
+```
+/forge:config
+```
+
+You'll see three tier rows — Heavy, Standard, Light — each showing "not set":
+
+```
+forge config
+────────────────────────────────────────────────────────────
+Active right now
+────────────────
+Heavy        not set — falls back to pi current (ollama:qwen2.5:0.5b)
+Standard     not set — falls back to pi current (ollama:qwen2.5:0.5b)
+Light        not set — falls back to pi current (ollama:qwen2.5:0.5b)
+Scope        ▸ project ( ~/src/hello )    global
+
+Choose models for your AI workflow
+──────────────────────────────────
+▸ Heavy      (review, sign-off)             not set
+  Standard   (planning, implementation)     not set
+  Light      (writeback, indexing)          not set
+
+  Show what runs at each step
+  Advanced — per-persona / per-step overrides
+
+  enter pick model   tab toggle scope   q quit
+```
+
+**2. Pick a model for each tier**
+
+Press `enter` on Heavy (or press `1`), pick a provider, then a model:
+
+```
+forge config › Heavy › pick provider
+────────────────────────────────────
+This will run for: 🗻 architect, 🌿 supervisor
+
+▸ anthropic   ✓ authenticated   12 models
+  ollama      ✓ authenticated   24 models
+  openai      ✓ authenticated   18 models
+
+  ↑↓ select   enter advance   esc back
+```
+
+```
+forge config › Heavy › pick model    (provider: anthropic)
+──────────────────────────────────────────────────────────
+This will run for: 🗻 architect, 🌿 supervisor
+
+▸ claude-opus-4-5-20250514
+  claude-sonnet-4-20250514
+  claude-haiku-4-20250514
+
+  ↑↓ select   enter save   esc back
+```
+
+Pressing `enter` on a model commits it immediately — both personas in that tier are now configured. Repeat for Standard and Light.
+
+**3. Done**
+
+After all three tiers are set, the landing screen shows your assignments:
+
+```
+Active right now
+────────────────
+Heavy        anthropic:claude-opus-4-5-20250514         (project)
+Standard     anthropic:claude-sonnet-4-20250514           (project)
+Light        ollama:qwen2.5:0.5b                         (project)
+Scope        project    ▸ global
+
+Choose models for your AI workflow
+──────────────────────────────────
+▸ Heavy      (review, sign-off)             anthropic:claude-opus-4-5-20250514
+  Standard   (planning, implementation)     anthropic:claude-sonnet-4-20250514
+  Light      (writeback, indexing)          ollama:qwen2.5:0.5b
+
+  Show what runs at each step
+  Advanced — per-persona / per-step overrides
+```
+
+No separate save step — each tier pick writes through instantly.
+
+### Scope: project vs global
+
+Press `tab` to toggle scope before picking a tier:
+
+- **project** — writes to `.pi/forge-cli/config.json` in the current project. Different projects can use different models.
+- **global** — writes to `~/.pi/agent/forge-cli/config.json`. Applies to every project that doesn't have a project-level override.
+
+### Verify your setup
+
+Select **"Show what runs at each step"** (or press `s`) to see which model runs each pipeline step:
+
+```
+forge config › current setup
+────────────────────────────
+Step           Persona          Model                     Source
+─────          ─────────        ──────                    ──────
+plan           🌱 engineer       anthropic:claude-sonnet…   Standard tier (project)
+review-plan    🌿 supervisor     anthropic:claude-opus-…   Heavy tier (project)
+implement      🌱 engineer       anthropic:claude-sonnet…   Standard tier (project)
+review-code    🌿 supervisor     anthropic:claude-opus-…   Heavy tier (project)
+validate       🍵 qa-engineer    anthropic:claude-sonnet…   Standard tier (project)
+approve        🗻 architect      anthropic:claude-opus-…   Heavy tier (project)
+writeback      🍃 collator       ollama:qwen2.5:0.5b       Light tier (project)
+commit         🌱 engineer       anthropic:claude-sonnet…   Standard tier (project)
+
+How models get picked
+─────────────────────
+Each step's persona looks for an override at four levels (most specific wins):
+ 1. A model set just for this step             (Step override)
+ 2. A model set just for this persona          (Per-persona override)
+ 3. The tier baseline you set above            (Heavy / Standard / Light)
+ 4. Whatever model pi is currently running on  (falls back automatically)
+```
+
+### Advanced overrides
+
+Select **"Advanced"** (or press `a`) for fine-grained control:
+
+- **Override one persona's model** — change the model for a single persona without affecting the rest of its tier.
+- **Override one step's model** — change the model for a single pipeline step (e.g. always use a specific model for the commit step).
+- **Edit raw persona-models entries** — direct editor for the full persona list.
+
+Most users never need these — the three tier knobs cover the 80% path.
+
+### Non-interactive model setup
+
+Use the CLI directly (no TUI required):
+
+```sh
+# Print the resolved routing table
+forge config show --resolved
+
+# Per-phase dispatch trace (no LLM call)
+forge config dispatch
+
+# Validate all resolved models are authenticated
+forge config show --strict-models
+```
+
 ## Where to go next
 
 - **[docs/](docs/)** — CLI flags, non-interactive mode, hook dispatcher, custom tools, publishing
@@ -110,6 +271,7 @@ ASK      /forge:health        KB freshness + store integrity
 
 | Up next                                            | Status              |
 |----------------------------------------------------|---------------------|
+| Per-persona model routing + tiered config TUI      | Shipped (0.9.0)     |
 | 4ge brand wordmark in CLI banner + 3 themes        | Shipped (0.7.7)     |
 | Slim README + docs/ split                          | Shipped (0.7.7)     |
 | Subagent audience relaxed to advisory              | Shipped (0.7.6)     |
@@ -147,6 +309,7 @@ MIT © Entelligentsia
   Shipped: 0.2.0 · 0.2.1 · 0.3.0 · 0.4.0 ·
   0.5.0 · 0.5.1 · 0.5.2 · 0.5.3 · 0.5.4 · 0.5.5 · 0.5.6 · 0.5.7 ·
   0.6.1 · 0.6.2 · 0.6.3 · 0.6.4 · 0.6.5 · 0.6.6 ·
-  0.7.0 · 0.7.1 · 0.7.2 · 0.7.3 · 0.7.4 · 0.7.5 · 0.7.6 · 0.7.7
+  0.7.0 · 0.7.1 · 0.7.2 · 0.7.3 · 0.7.4 · 0.7.5 · 0.7.6 · 0.7.7 ·
+  0.8.0 · 0.8.1 · 0.8.2 · 0.8.3 · 0.8.4 · 0.9.0
 -->
 

package/dist/bin/argv.d.ts

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

@@ -88,6 +88,11 @@ export function parseForgeArgv(argv) {
             i++;
             continue;
         }
+        if (token === "--strict-models") {
+            env.FORGE_STRICT_MODELS = "1";
+            i++;
+            continue;
+        }
         if (token === "--registry") {
             if (i + 1 >= argv.length) {
                 return { error: "forge: --registry requires a path argument. Run `forge --help` for usage." };
@@ -136,6 +141,18 @@ export function parseForgeArgv(argv) {
                 subcommandArgs: argv.slice(i + 1),
             };
         }
+        // ── `forge config` — routing config subcommand (Plan 16) ────────────
+        // Intercepts `config show [--resolved] [--json]`. Bare `config` with no
+        // args is also handled (prints usage). Anything else falls through to pi.
+        // Only matches the first bare token, no flags collected yet.
+        if (token === "config" && piArgv.length === 0) {
+            return {
+                forgeAction: "config",
+                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":"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"}
+{"version":3,"file":"argv.js","sourceRoot":"","sources":["../../src/bin/argv.ts"],"names":[],"mappings":"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"}

package/dist/bin/config.d.ts

@@ -0,0 +1,69 @@
+export interface ConfigArgs {
+    subcommand: "show" | "dispatch" | "usage";
+    resolved: boolean;
+    json: boolean;
+    /** dispatch-only: pipeline name override (defaults to "default" for task, "fix-bug" for bug). */
+    pipeline?: string;
+}
+export interface ConfigArgsError {
+    error: string;
+}
+export type ParseConfigResult = ConfigArgs | ConfigArgsError;
+export declare function parseConfigArgs(args: string[]): ParseConfigResult;
+export interface PersonaModelEntry {
+    persona: string;
+    provider: string;
+    model: string;
+    available: boolean;
+    source: string;
+}
+export interface ConfigShowOutput {
+    personaModels: Record<string, PersonaModelEntry>;
+    pipelines: Record<string, PipelineShowOutput>;
+}
+export interface PipelineShowOutput {
+    personaModels: Record<string, PersonaModelEntry>;
+    phases: Array<{
+        role: string;
+        override: string | null;
+        available: boolean;
+        source: string;
+    }>;
+}
+type WriteFn = (line: string) => void;
+export declare function runConfigShow(opts: ConfigArgs, cwd: string, write: WriteFn): Promise<number>;
+export interface DispatchPhaseRow {
+    pipeline: "default" | "fix-bug";
+    phaseRole: string;
+    persona: string;
+    requested: {
+        provider: string;
+        model: string;
+    } | null;
+    source: string;
+    /** True if pi.modelRegistry.find(provider, model) returns a Model — i.e. setModel
+     *  will actually take effect at dispatch time. False = will silently fall through
+     *  to pi's current model.
+     */
+    registered: boolean | null;
+    /** When registered === true, the exact id the registry returned. May differ from
+     *  `requested.model` if pi aliases (e.g. "claude-haiku-4-5" → "claude-haiku-4-5-20251001").
+     */
+    registryId: string | null;
+}
+export interface DispatchOutput {
+    cwd: string;
+    taskPipeline: string;
+    taskPhases: DispatchPhaseRow[];
+    bugPhases: DispatchPhaseRow[];
+}
+/**
+ * Walk run-task's PHASES and fix-bug's BUG_PHASES; for each, compute the requested
+ * model via the same resolveModelForPhase the orchestrator uses, and verify that
+ * pi's ModelRegistry can resolve the requested id. Prints a table or JSON.
+ *
+ * No LLM call. No pi session. Pure inspection.
+ */
+export declare function runConfigDispatch(args: ConfigArgs, cwd: string, write: (line: string) => void): number;
+export declare function runConfig(args: string[], cwd?: string): Promise<number>;
+export {};