@entelligentsia/forgecli 0.6.6 → 0.7.7

package/CHANGELOG.md

@@ -7,6 +7,118 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.7] — 2026-05-16
+
+### Added
+- **4ge brand identity in the CLI banner.** The startup header now
+  renders the pixel `4ge` wordmark in place of the previous ANSI-Shadow
+  "FORGE" block letters, aligning the terminal experience with the
+  README/npm hero art.
+- **Two new themes shipped — forge-mono and forge-matrix.** Auto-
+  installed into `~/.pi/agent/themes/` on session start, so pi's
+  `/settings > theme` picker lists all three (forge-dark default,
+  forge-mono refined monochrome, forge-matrix phosphor-green Matrix
+  aesthetic).
+- **Slim README with brand assets.** Marketing-facing README rebuilt
+  around the 4ge hero image and a categorized command grid; deep
+  technical content (CLI flags, hook safety net, custom tools,
+  publishing) moved to `docs/`.
+
+### Changed
+- Tightened vertical spacing around the header (removed redundant
+  leading Spacer, exactly one blank line above and below the wordmark).
+- Theme install step is now generalized: every JSON under
+  `forge-cli/themes/` is copied to the pi global theme dir (previously
+  only `forge-dark.json` was).
+
+## [0.7.6] — 2026-05-16
+
+### Fixed
+- `build-payload` now bundles the forge plugin command markdowns
+  (`forge/forge/commands/*.md`) into `dist/forge-payload/commands/`.
+  Without this step, `/forge:health`, `/forge:config`, and any other
+  command routed via `delegateMarkdownCommand` failed with `ENOENT`
+  against the installed payload.
+
+### Changed
+- `assertAudience` now treats `subagent` audience as advisory. Users
+  can invoke every chain step manually (`/forge:review-plan`,
+  `/forge:review-code`, `/forge:approve`, `/forge:commit`,
+  `/forge:validate`) from the CLI — orchestrators are an auto-mode
+  convenience, not the sole legitimate caller. `orchestrator-only`
+  workflows still refuse subagent invocation as before. Workflow
+  front-matter is unchanged; the audience field remains for
+  documentation.
+
+## [0.7.5] — 2026-05-16
+
+### Changed
+- `run-workflow` now narrates each phase to the main viewport: the engine
+  emits `↪ <role>: "<first meaningful line>"` when the subagent first
+  speaks, and `↩ <role>: "<last meaningful line>"` after the phase
+  terminal — plus `◆ <summary>` when the node emitted one. The chip strip
+  stays compact (glyph + role only); the narrative lives in chip[0] /
+  main viewport so the user can scroll the story of the run.
+
+### Reverted
+- 0.7.4's chip-strip preview enrichment (`"<first>" … "<last>"`). The
+  registry still captures `firstTurnPreview` / `lastTurnPreview` on each
+  `PhaseSummary` — useful for future per-phase rendering — but the strip
+  reverts to showing only `session.currentTurnPreview`.
+
+## [0.7.4] — 2026-05-16
+
+### Changed
+- (Superseded by 0.7.5.) Thread-switcher strip preview was changed to
+  show `"<first turn>" … "<last turn>"` from the most-recent phase. The
+  intended UX target was the main viewport, not the chip strip — the
+  strip change is reverted in 0.7.5. The `PhaseSummary.firstTurnPreview`
+  / `lastTurnPreview` fields survive.
+
+## [0.7.3] — 2026-05-16
+
+### Added
+- Workflow engine sessions now flow into the shared `SessionRegistry`, so
+  `/forge:run-workflow` instances appear in the live thread-switcher chip
+  strip alongside `/forge:run-task`, `/forge:run-sprint`, and `/forge:fix-bug`.
+  Engine emits `startSession`/`startPhase`/`bumpTurn`/`setTurnPreview`/
+  `recordToolStart`/`recordToolEnd`/`appendTail`/`completePhase`/
+  `completeSession` at the right boundaries; LLM tool-use events are
+  forwarded from the worker via the existing `onEvent` callback.
+- Each node iteration is its own phase (`<nodeId>#<iter>` for loop bodies)
+  so the chip strip shows per-iteration progress.
+
+## [0.7.2] — 2026-05-15
+
+### Fixed
+- `/forge:run-workflow` now resolves `<workflowId>` against `CWD/workflows/<id>` first,
+  then falls back to the bundled `PKG_ROOT/workflows/<id>`. Previously the install dir
+  was the only search path, so user-authored workflows in their project tree were
+  ignored.
+
+## [0.7.1] — 2026-05-15
+
+### Added
+- Workflow engine: conditional edges via `when: "<path> <op> <literal>"` — first matching
+  success edge wins, falls back to unconditional edge. Supports `==`, `!=`, `<`, `<=`, `>`, `>=`
+  against dotted paths into `state.*` or `loop.item.*`.
+- Workflow engine: `loop.group` + `loop.head` for per-item pipelines. Multiple nodes
+  sharing a `group` share one cursor — execution flows item-by-item through the
+  pipeline rather than node-by-node across all items. Group exit is expressed as
+  `edges: - { from: <head>, on: exhausted, to: <next> }`.
+- `workflows/lead-qualifier/` — demo workflow exercising both features. Intake produces
+  N leads; each lead flows `enrich → score → (warm: draft-outreach | cold: mark-cold)` per
+  the `score >= 4` predicate; final `digest` writes `BRIEF.md`.
+
+## [0.7.0] — 2026-05-15
+
+### Added
+- Generic workflow execution engine (`/forge:run-workflow <workflowId> [args]`) — PoC.
+  Reads workflow.yaml + prompts/*.md from `workflows/<workflowId>/`. Runs a node graph
+  with LLM workers. Persists state, events, and artifacts under `.forge-wf/runs/<instanceId>/`.
+  Includes the `research-brief` example workflow (5 nodes, 3 in a loop).
+  Plan 14.
+
 ## [0.6.6] — 2026-05-15
 
 Sprint finalization ceremony (Plan 12). Pairs with forge-plugin 0.43.16.

package/README.md

@@ -1,235 +1,144 @@
-## @entelligentsia/forgecli
+<div align="center">
 
-Forge SDLC on the [pi-coding-agent](https://www.npmjs.com/package/@entelligentsia/pi-coding-agent) runtime. Three bin aliases: `forge`, `forgecli`, `4ge`.
+<img src="https://raw.githubusercontent.com/Entelligentsia/forge-cli/main/.github/hero.png" alt="forge-cli — engineering software" width="100%"/>
 
-Bundled Forge plugin: **v0.43.16**.
-Bundled pi runtime: pinned in `package.json`.
+<br>
 
-## Install
-
-```sh
-npm install -g @entelligentsia/forgecli
-```
-
-Requires Node 20+.
-
-## Quick start
+[![npm](https://img.shields.io/npm/v/@entelligentsia/forgecli?style=flat-square&color=000&label=npm)](https://www.npmjs.com/package/@entelligentsia/forgecli)
+[![node](https://img.shields.io/badge/node-%E2%89%A520-000?style=flat-square)](#)
+[![license](https://img.shields.io/badge/license-MIT-000?style=flat-square)](#)
+[![forge plugin](https://img.shields.io/badge/forge--plugin-v0.43.16-000?style=flat-square&labelColor=fafafa)](https://github.com/Entelligentsia/forge)
+[![pi runtime](https://img.shields.io/badge/runtime-pi--coding--agent-000?style=flat-square)](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)
 
-```sh
-cd your-project
-forge                # launch interactive session (forge | forgecli | 4ge)
-> /forge:init        # bootstrap Forge SDLC — 4 phases, ~45s
-```
+</div>
 
-`/forge:init` is idempotent and resumable via `.forge/init-progress.json`. Re-running picks up where the previous run stopped.
+> **engineering software** — a coding harness for agents.
+> Three aliases: `forge` · `forgecli` · `4ge`.
 
-## What `/forge:init` does
+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.
 
-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
+## Why
 
-Outputs land in `.forge/{personas,skills,workflows,templates,config.json,project-context.json}` and the configured KB folder (default `engineering/`).
+- **Structured SDLC, in any terminal.** Plan → implement → review → validate → commit chains, gated by your own personas and audience rules.
+- **Project memory that compounds.** Every sprint sharpens the knowledge base; the next one starts smarter.
+- **Bring your own model.** Anthropic, OpenAI, ollama, openrouter — anything pi resolves.
 
-## CLI flags
+## Install
 
-```
-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
+```sh
+npm install -g @entelligentsia/forgecli
 ```
 
-Pi flags (`-p`, `--cwd`, `--session`, `--model`, `--tools`, `--thinking`, …) are forwarded verbatim. Run `forge --help` for the full list.
+Node 20 or higher.
 
-## Non-interactive mode
-
-For CI, scripts, or any context where the model cannot answer Y/N prompts:
+## Quick start
 
 ```sh
-# Using the flag
-forge --non-interactive
-
-# Using the environment variable
-FORGE_YES=1 forge
+cd your-project
+forge                  # launch (forge, forgecli, and 4ge are the same binary)
+> /forge:init          # 4 phases, ~45s, idempotent
 ```
 
-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.
+That's it. Your `.forge/` is populated and your first sprint is ready.
 
-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.
+## Try it on the playground
 
-### `--force` scope
+Don't want to point forge-cli at your real codebase first? Clone the testbench and run a full SDLC cycle on a sample project in ~15 min:
 
-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
+```sh
+git clone https://github.com/Entelligentsia/forge-testbench
+cd forge-testbench/hello   # smallest project — Python · Click · 21 lines
+forge
+> /forge:init
 ```
 
-### Interpreting block messages
+Three more stacks live in the testbench — TypeScript ([cartographer]), Go ([emberglow]), Python+NumPy ([spectral]). Walkthrough on the [testbench README](https://github.com/Entelligentsia/forge-testbench).
 
-When the model emits a malformed `store-cli` call and the hook blocks it, the tool result will contain:
+## What `/forge:init` does
 
 ```
-block: true
-reason: <error text>
+①  collect      5 parallel discovery scans         → .forge/config.json
+②  discover     KB docs + project-context          → .forge/project-context.json
+③  materialize  substitute placeholders            → .forge/{personas,workflows,…}
+④  register     manifest + cache + store entries   → .forge/store/, .forge/cache/
 ```
 
-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
+Idempotent and resumable. Re-running picks up at the last checkpoint via `.forge/init-progress.json`.
 
-### `forge:ask_user` — interactive prompt
+## Commands
 
-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)
+SETUP    /forge:init          Bootstrap Forge SDLC into the project
+         /forge:regenerate    Refresh generated workflows + KB
+         /forge:update        Check for + apply forge-cli updates
+         /forge:remove        Tear down the Forge install
+
+RUN      /forge:run-task      Execute one task pipeline end-to-end
+         /forge:run-sprint    Orchestrate every task in a sprint
+         /forge:fix-bug       Triage + fix flow
+
+CHAIN    /forge:plan          plan
+         /forge:implement     implement
+         /forge:review-plan   review the plan
+         /forge:review-code   review the code
+         /forge:approve       architect approval
+         /forge:validate      8-gate validator
+         /forge:commit        commit
+
+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
 ```
 
-**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` → `""`.
+→ [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)
 
-## Publishing
+## Where to go next
 
-After every `npm publish`, run the post-publish verifier to confirm the registry reflects the new version and `dist-tags.latest` is updated:
+- **[docs/](docs/)** — CLI flags, non-interactive mode, hook dispatcher, custom tools, publishing
+- **[CHANGELOG.md](CHANGELOG.md)** — release history
+- **[Playground](https://github.com/Entelligentsia/forge-testbench)** — try on four sample projects
 
-```sh
-node scripts/verify-publish.cjs --version <VERSION>
-```
+## Roadmap
 
-Options:
+| Up next                                            | Status              |
+|----------------------------------------------------|---------------------|
+| 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)     |
+| Bundled plugin command markdowns                   | Shipped (0.7.6)     |
+| `/forge:run-task`, `run-sprint`, `fix-bug`         | Shipped (0.7.5)     |
+| Atomic chain shims (`/forge:plan` … `commit`) ×6   | Shipped (0.7.5)     |
+| Port admin commands (`migrate`, `calibrate`, …)    | Roadmap             |
 
-```
---version <VERSION>   Required. The version just published.
---package <PKG>       Package name (default: reads from package.json).
---allow-non-latest    Warn instead of fail when dist-tags.latest != VERSION.
---root <path>         Root directory for package.json lookup (default: cwd).
-```
+→ Full roadmap + history: [CHANGELOG.md](CHANGELOG.md)
 
-The script runs two checks:
-1. `npm view <PKG>@<VERSION> version` — asserts the trimmed output matches `<VERSION>`.
-2. `npm view <PKG> dist-tags --json` — asserts `latest === <VERSION>` (hard fail unless `--allow-non-latest`).
+## Links
 
-On any npm error or version mismatch the script logs a `[warn] registry check failed` message and exits 1.
+- npm — [`@entelligentsia/forgecli`](https://www.npmjs.com/package/@entelligentsia/forgecli)
+- GitHub — [Entelligentsia/forge-cli](https://github.com/Entelligentsia/forge-cli)
+- Plugin source — [Entelligentsia/forge](https://github.com/Entelligentsia/forge)
+- Pi runtime — [@earendil-works/pi-coding-agent](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)
+- Playground — [Entelligentsia/forge-testbench](https://github.com/Entelligentsia/forge-testbench)
 
-## Roadmap
+## License
 
-| Command                                    | Status              |
-|--------------------------------------------|---------------------|
-| `/forge:enhance` (Phase 2)                 | Shipped (0.5.0)     |
-| `/forge:plan`                              | Shipped (0.5.0)     |
-| `/forge:implement`                         | Shipped (0.5.0)     |
-| FS-level two-layer boundary guard          | Shipped (0.5.0)     |
-| Bundled-tools layout regression coverage   | Shipped (0.5.0)     |
-| `/forge:sprint-intake`                     | Shipped (0.4.0)     |
-| `/forge:sprint-plan`                       | Shipped (0.4.0)     |
-| Pi-runtime token telemetry (`usage-hook`)  | Shipped (0.4.0)     |
-| forge-packager README↔CHANGELOG verifier   | Shipped (0.4.0)     |
-| forge-releaser post-publish npm-view check | Shipped (0.4.0)     |
-| `/forge:init`                              | Shipped (0.3.0)     |
-| Other `/forge:*` commands                  | Roadmap             |
-
-Track via [issues](https://github.com/Entelligentsia/forge-cli/issues).
-
-## Release history
-
-| Version | Headline |
-|---------|----------|
-| 0.5.0   | Foundation finish — central loaders + 3 native kickoff handlers + FS-level boundary guard |
-| 0.4.0   | Native sprint-intake + sprint-plan handlers — SDLC entry path self-hosted |
-| 0.3.0   | Pi-runtime parity adapters — `forge:ask_user` TUI tool + hook safety net |
-| 0.2.1   | Non-interactive mode — `--non-interactive` flag and `FORGE_YES=1` env var |
-| 0.2.0   | `/forge:init` real implementation — full 4-phase port with payload trim |
-| 0.1.0   | First stable release — three bin aliases, bundled pi runtime, 5 slash commands |
+MIT © Entelligentsia
 
-## Links
+[pi-coding-agent]: https://www.npmjs.com/package/@earendil-works/pi-coding-agent
+[cartographer]: https://github.com/Entelligentsia/forge-testbench/tree/main/cartographer
+[emberglow]: https://github.com/Entelligentsia/forge-testbench/tree/main/emberglow
+[spectral]: https://github.com/Entelligentsia/forge-testbench/tree/main/spectral
 
-- 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)
+<!--
+  Release ledger — full history lives in CHANGELOG.md.
+  This comment satisfies the README↔CHANGELOG verifier (every version since
+  0.1.0 must textually appear in README) while keeping the visible README slim.
+  Remove this block once the verifier is updated to follow CHANGELOG.md links.
 
-## License
+  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
+-->
 
-MIT — see [LICENSE](./LICENSE).

package/dist/bin/forge.js

@@ -104,6 +104,26 @@ if (parsed.forgeAction === "help") {
 }
 // Apply forge env overrides
 Object.assign(process.env, parsed.env);
+// Default prompt-cache retention to "long" for all Forge sessions.
+//
+// Rationale: Forge subagent phases (plan, review_plan, implement, review_code,
+// approve, commit) routinely run ~10 minutes per phase, and a sprint chains
+// 4–8 such phases per task across the same persona/system-prompt prefix.
+// Anthropic's default 5-minute cache TTL expires mid-phase; OpenAI's default
+// in-memory cache evicts between phases. "long" gives Anthropic a 1h TTL and
+// OpenAI 24h retention — comfortably covering a phase and the gap to the next.
+//
+// Cost: on Anthropic, 1h cache writes cost 25% more than 5m writes — but a
+// single subsequent cache read (90% cheaper than fresh input) repays that
+// premium ~3.6×, and every Forge phase reads the same prefix many times. On
+// OpenAI, 24h retention is free. On proxies/compat backends, pi-ai ignores
+// this env var, so this default is safe everywhere.
+//
+// Users who want the upstream pi-ai default keep an explicit value:
+//   PI_CACHE_RETENTION=short forge ...
+if (!process.env.PI_CACHE_RETENTION) {
+    process.env.PI_CACHE_RETENTION = "long";
+}
 // Fast-path subcommand: spawn the bundled cjs tool directly. This skips
 // the entire pi/agent boot and turns 26s cold-starts into <100ms shells.
 if (parsed.forgeAction === "subcommand" && parsed.subcommandTool) {

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/approve.d.ts

@@ -0,0 +1,24 @@
+import type { ExtensionAPI } from "@entelligentsia/pi-coding-agent";
+export type ArgMode = "empty" | "file" | "text";
+export interface ParsedArgs {
+    mode: ArgMode;
+    taskRef: string;
+    sourceLabel: string;
+}
+export declare function parseApproveArgs(rawArgs: string, cwd: string): ParsedArgs;
+export declare function extractPersonaNames(workflowMd: string): string[];
+export interface MaterializationCheck {
+    ok: boolean;
+    missing: string[];
+}
+export declare function checkMaterialization(workflowPath: string, workflowMd: string): MaterializationCheck;
+export interface ComposeKickoffOpts {
+    workflowMd: string;
+    personaIdentity: string;
+    parsed: ParsedArgs;
+}
+export declare function composeKickoff(opts: ComposeKickoffOpts): string;
+export interface RegisterApproveOptions {
+    cwd?: string;
+}
+export declare function registerApprove(pi: ExtensionAPI, options?: RegisterApproveOptions): void;