@entelligentsia/forgecli 1.0.21 → 1.0.25

package/dist/extensions/forgecli/report-bug.js

@@ -1,159 +0,0 @@
-// forge:report-bug — native kickoff handler (FORGE-S23-T11).
-//
-// Replaces the auto-generated stub previously installed by
-// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
-// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
-//
-// Pre-flights: gh auth status (spawnSync, argv-array, IL6). On failure,
-// notifies and returns — no kickoff sent.
-//
-// Bug repo is configurable (AC#5):
-//   1. FORGE_BUG_REPO env var
-//   2. config.json bugs.repo field (if present)
-//   3. default: "Entelligentsia/forge"
-//
-// Workflow source: <forgeRoot>/commands/report-bug.md (command file).
-// File-existence check only — command files lack Pack-06 workflow markers.
-//
-// Iron Laws:
-//   IL1 — code only under forge-cli/src/extensions/forgecli/.
-//   IL4 — no JSON.stringify-into-subagent dispatch.
-//   IL6 — no shell-string interpolation; spawnSync uses argv arrays.
-//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
-//         continuation.
-import { spawnSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { sendKickoff } from "./kickoff.js";
-// ── Repo resolution ───────────────────────────────────────────────────────
-const DEFAULT_BUG_REPO = "Entelligentsia/forge";
-export function resolveBugRepo(cwd) {
-    // 1. FORGE_BUG_REPO env var
-    const fromEnv = process.env["FORGE_BUG_REPO"];
-    if (fromEnv?.trim())
-        return fromEnv.trim();
-    // 2. config.json bugs.repo field
-    try {
-        const configPath = path.join(cwd, ".forge", "config.json");
-        const raw = fs.readFileSync(configPath, "utf8");
-        const config = JSON.parse(raw);
-        const bugs = config["bugs"];
-        const repo = bugs?.["repo"];
-        if (typeof repo === "string" && repo.trim())
-            return repo.trim();
-    }
-    catch {
-        // config absent or unreadable — fall through to default
-    }
-    // 3. default
-    return DEFAULT_BUG_REPO;
-}
-export function parseReportBugArgs(rawArgs, cwd) {
-    const trimmed = (rawArgs ?? "").trim();
-    if (!trimmed) {
-        return { mode: "empty", symptomText: "", sourceLabel: "(no symptom — LLM will ask)" };
-    }
-    if (trimmed.startsWith("@")) {
-        const ref = trimmed.slice(1).trim();
-        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
-        const symptomText = fs.readFileSync(filePath, "utf8");
-        return { mode: "file", symptomText, sourceLabel: `(symptom from file: ${ref})` };
-    }
-    return { mode: "text", symptomText: trimmed, sourceLabel: "(symptom from inline text)" };
-}
-export function checkGhAuth() {
-    // IL6: argv-array, no shell interpolation
-    const result = spawnSync("gh", ["auth", "status"], {
-        encoding: "utf8",
-        timeout: 10_000,
-    });
-    const ok = result.status === 0 && !result.error;
-    const output = ((result.stdout ?? "") + (result.stderr ?? "")).trim();
-    return { ok, output: output.slice(0, 300) }; // cap for kickoff body
-}
-export function composeReportBugKickoff(opts) {
-    const { commandMd, parsed, bugRepo, ghAuthOutput } = opts;
-    const sections = ["# /forge:report-bug", ""];
-    sections.push("## Dispatch", "");
-    sections.push("File a bug report against Forge (not your project). Follow the command steps below. Specifically:");
-    sections.push("");
-    sections.push(`1. File the issue to: \`${bugRepo}\` (override via \`FORGE_BUG_REPO\` env or \`config.json\` \`bugs.repo\` field).`);
-    sections.push("2. `gh` is authenticated (pre-flight passed). Use it to file the issue.");
-    if (ghAuthOutput) {
-        sections.push(`3. Auth context: \`${ghAuthOutput.replace(/\n/g, " ").slice(0, 200)}\``);
-    }
-    sections.push("4. Gather automatic context (forge version, node version, OS) per Step 2 in the command.");
-    sections.push("5. Draft the issue body, show it to the user for review, then file with `gh issue create`.");
-    sections.push("", "---", "", "## Command", "", commandMd.trim(), "", "---");
-    if (parsed.mode === "empty") {
-        sections.push("", "## Input", "", "(no symptom provided — ask the user to describe the bug)");
-    }
-    else {
-        sections.push("", `## Input — ${parsed.sourceLabel}`, "", parsed.symptomText.trim());
-    }
-    return sections.join("\n");
-}
-// ── Registration ──────────────────────────────────────────────────────────
-const COMMAND_NAME = "report-bug";
-export function registerReportBug(pi, options) {
-    pi.registerCommand("forge:report-bug", {
-        description: "File a bug against Forge itself as a GitHub issue. " +
-            "Usage: /forge:report-bug [@<file> | <symptom description>]. " +
-            "Requires `gh` to be installed and authenticated. " +
-            "Target repo: FORGE_BUG_REPO env | config.json bugs.repo | Entelligentsia/forge.",
-        async handler(args, ctx) {
-            const { forgeRoot } = options;
-            const cwd = options.cwd ?? process.cwd();
-            // gh auth pre-flight (IL6: argv-array)
-            const ghAuth = checkGhAuth();
-            if (!ghAuth.ok) {
-                ctx.ui.notify("× forge:report-bug — gh is not authenticated. Install gh (https://cli.github.com) and run `gh auth login` first.", "error");
-                return;
-            }
-            if (!forgeRoot) {
-                // report-bug works outside a Forge project (reporting bugs in Forge itself)
-                // but we still need the command file from the bundled payload
-            }
-            // Resolve command file from forgeRoot (bundled payload) or fall back to graceful error
-            let commandMd;
-            if (forgeRoot) {
-                const commandPath = path.join(forgeRoot, "commands", `${COMMAND_NAME}.md`);
-                try {
-                    commandMd = fs.readFileSync(commandPath, "utf8");
-                }
-                catch (err) {
-                    const e = err;
-                    if (e.code === "ENOENT") {
-                        ctx.ui.notify(`× forge:report-bug — command file not found at commands/${COMMAND_NAME}.md; run /forge:init or /forge:rebuild first.`, "error");
-                    }
-                    else {
-                        ctx.ui.notify(`× forge:report-bug — failed to read command file: ${e.message ?? "unknown error"}`, "error");
-                    }
-                    return;
-                }
-            }
-            else {
-                ctx.ui.notify("× forge:report-bug — no Forge project at cwd; run /forge:init to bootstrap before reporting bugs.", "warning");
-                return;
-            }
-            let parsed;
-            try {
-                parsed = parseReportBugArgs(args, cwd);
-            }
-            catch (err) {
-                const e = err;
-                ctx.ui.notify(`× forge:report-bug — failed to parse args: ${e.message ?? "unknown"}`, "error");
-                return;
-            }
-            const bugRepo = resolveBugRepo(cwd);
-            const kickoff = composeReportBugKickoff({
-                commandMd,
-                parsed,
-                bugRepo,
-                ghAuthOutput: ghAuth.output,
-            });
-            sendKickoff(pi, kickoff);
-        },
-    });
-}
-//# sourceMappingURL=report-bug.js.map

package/dist/extensions/forgecli/report-bug.js.map

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

package/dist/extensions/forgecli/retrospective.d.ts

@@ -1,20 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { extractPersonaNames } from "./lib/frontmatter-parser.js";
-export { extractPersonaNames };
-export type ArgMode = "empty" | "file" | "text";
-export interface ParsedArgs {
-    mode: ArgMode;
-    sprintRef: string;
-    sourceLabel: string;
-}
-export declare function parseRetroArgs(rawArgs: string, cwd: string): ParsedArgs;
-export interface ComposeKickoffOpts {
-    workflowMd: string;
-    personaIdentity: string;
-    parsed: ParsedArgs;
-}
-export declare function composeKickoff(opts: ComposeKickoffOpts): string;
-export interface RegisterRetrospectiveOptions {
-    cwd?: string;
-}
-export declare function registerRetrospective(pi: ExtensionAPI, options?: RegisterRetrospectiveOptions): void;

package/dist/extensions/forgecli/retrospective.js

@@ -1,126 +0,0 @@
-// forge:retrospective — native kickoff handler (FORGE-S23-T06).
-//
-// Replaces the auto-generated stub previously installed by
-// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
-// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
-//
-// The retrospective workflow (sprint_retrospective.md) is LLM-driven:
-// the handler reads the materialized workflow, composes a kickoff message
-// citing the persona path and workflow path, then dispatches via
-// pi.sendUserMessage with { deliverAs: "steer" }.
-//
-// Iron Laws:
-//   IL1 — code only under forge-cli/src/extensions/forgecli/.
-//   IL4 — no JSON.stringify-into-subagent dispatch.
-//   IL6 — no shell-string interpolation; no spawn calls here.
-//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
-//         continuation.
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { assertAudience } from "./audience-gate.js";
-import { sendKickoff } from "./kickoff.js";
-// FORGE-S25-T16: extracted to lib module (H-1). Re-exported here for
-// backward compatibility with existing test and consumer imports.
-import { extractPersonaNames } from "./lib/frontmatter-parser.js";
-import { loadPersona, PersonaSkillLoaderError } from "./parsers/persona-skill-loader.js";
-import { loadWorkflow, WorkflowLoaderError } from "./parsers/workflow-loader.js";
-export { extractPersonaNames };
-export function parseRetroArgs(rawArgs, cwd) {
-    const trimmed = (rawArgs ?? "").trim();
-    if (trimmed === "") {
-        return { mode: "empty", sprintRef: "", sourceLabel: "(no sprint specified — will prompt)" };
-    }
-    if (trimmed.startsWith("@")) {
-        const ref = trimmed.slice(1).trim();
-        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
-        const seed = fs.readFileSync(filePath, "utf8");
-        return { mode: "file", sprintRef: seed, sourceLabel: `(seed from file: ${ref})` };
-    }
-    return { mode: "text", sprintRef: trimmed, sourceLabel: "(seed from inline text)" };
-}
-export function composeKickoff(opts) {
-    const { workflowMd, personaIdentity, parsed } = opts;
-    const sections = ["# /forge:retro", ""];
-    if (personaIdentity.trim().length > 0) {
-        sections.push(personaIdentity.trim(), "");
-    }
-    sections.push("## Dispatch", "", "Run the retrospective workflow below. Specifically:", "", "1. Identify the sprint to retrospect: if a sprint ID was provided (e.g. FORGE-SNN) use it directly; otherwise ask the user which sprint to retrospect before proceeding.", "2. Load the architect persona from `.forge/personas/architect.md` for full identity context.", "3. Follow the workflow at `.forge/workflows/sprint_retrospective.md` verbatim: load all sprint task manifests, event logs, and retrospective notes; compute cost and bottlenecks; write RETROSPECTIVE.md.", "4. Use `forge_store_query` for all store reads — do NOT raw-read `.forge/store/`.", "5. Write retrospective artifacts using the `write` tool.", "6. Honour Pack-06 Read/Write/Ask/Store discipline: in-conversation clarifications use `forge_ask_user`.");
-    sections.push("", "---", "", "## Workflow", "", workflowMd.trim(), "", "---");
-    if (parsed.mode === "empty") {
-        sections.push("", "## Input", "", "(no sprint specified — ask the user which sprint to retrospect before proceeding)");
-    }
-    else {
-        sections.push("", `## Input — ${parsed.sourceLabel}`, "", parsed.sprintRef.trim());
-    }
-    return sections.join("\n");
-}
-// Registration -------------------------------------------------------------
-const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "sprint_retrospective.md");
-export function registerRetrospective(pi, options = {}) {
-    pi.registerCommand("forge:retro", {
-        description: "Run the retrospective workflow for a Forge sprint. " +
-            "Usage: /forge:retro [FORGE-SNN | @<file> | <free-form text>]. " +
-            "Empty args — the LLM will prompt you for the sprint to retrospect.",
-        async handler(args, ctx) {
-            const cwd = options.cwd ?? process.cwd();
-            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
-            let workflowMd;
-            let workflowAudience;
-            try {
-                const loaded = loadWorkflow(workflowPath);
-                workflowMd = loaded.rawMarkdown;
-                workflowAudience = loaded.audience;
-            }
-            catch (err) {
-                if (err instanceof WorkflowLoaderError) {
-                    if (err.code === "missing_file") {
-                        ctx.ui.notify(`× forge:retro — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
-                    }
-                    else {
-                        ctx.ui.notify(`× forge:retro — workflow load failed (${err.code}): ${err.message}`, "error");
-                    }
-                    return;
-                }
-                const e = err;
-                ctx.ui.notify(`× forge:retro — failed to read workflow: ${e.message ?? "unknown"}`, "error");
-                return;
-            }
-            let parsed;
-            try {
-                parsed = parseRetroArgs(args, cwd);
-            }
-            catch (err) {
-                const e = err;
-                ctx.ui.notify(`× forge:retro — failed to read seed: ${e.message ?? "unknown"}`, "error");
-                return;
-            }
-            const personas = extractPersonaNames(workflowMd);
-            let personaIdentity = "";
-            if (personas.length > 0) {
-                try {
-                    const persona = loadPersona(personas[0], { cwd });
-                    personaIdentity = persona.identity;
-                }
-                catch (err) {
-                    if (err instanceof PersonaSkillLoaderError) {
-                        ctx.ui.notify(`× forge:retro — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
-                        return;
-                    }
-                    const e = err;
-                    ctx.ui.notify(`× forge:retro — persona load error: ${e.message ?? "unknown"}`, "error");
-                    return;
-                }
-            }
-            if (!assertAudience({ workflowName: "sprint_retrospective", audience: workflowAudience }, ctx)) {
-                return;
-            }
-            const kickoff = composeKickoff({
-                workflowMd,
-                personaIdentity,
-                parsed,
-            });
-            sendKickoff(pi, kickoff);
-        },
-    });
-}
-//# sourceMappingURL=retrospective.js.map

package/dist/extensions/forgecli/retrospective.js.map

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

package/dist/extensions/forgecli/review-code.d.ts

@@ -1,35 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { extractPersonaNames } from "./lib/frontmatter-parser.js";
-export { extractPersonaNames };
-import { checkMaterialization, type MaterializationCheck } from "./lib/manifest-checker.js";
-export { checkMaterialization, type MaterializationCheck };
-export type ArgMode = "empty" | "file" | "text";
-export interface ParsedArgs {
-    mode: ArgMode;
-    taskRef: string;
-    sourceLabel: string;
-}
-export declare function parseReviewCodeArgs(rawArgs: string, cwd: string): ParsedArgs;
-export interface ComposeKickoffOpts {
-    workflowMd: string;
-    personaIdentity: string;
-    parsed: ParsedArgs;
-    /** Revision loop context block (FORGE-S26-T11). Injected before the workflow body. */
-    reviewLoopContext?: string;
-}
-export declare function composeKickoff(opts: ComposeKickoffOpts): string;
-/**
- * Build the `### Review Loop Context` block for user-invoked (non-orchestrated)
- * review-code calls. Matches the T07 graceful-fallback spec:
- * "iteration 1 of M" where M is config.maxReviewIterations (default 3).
- */
-export declare function buildReviewLoopContext(maxIterations: number): string;
-/**
- * Read maxReviewIterations from .forge/config.json. Returns default 3 on any
- * error (missing file, missing field, non-integer value).
- */
-export declare function readMaxReviewIterations(cwd: string): number;
-export interface RegisterReviewCodeOptions {
-    cwd?: string;
-}
-export declare function registerReviewCode(pi: ExtensionAPI, options?: RegisterReviewCodeOptions): void;

package/dist/extensions/forgecli/review-code.js

@@ -1,196 +0,0 @@
-// forge:review-code — native kickoff handler (FORGE-S21-T10).
-//
-// Replaces the auto-generated stub previously installed by
-// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
-// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
-//
-// Note: The materialized workflow (review_code.md) declares
-// `audience: subagent` — advisory only. Users may invoke this command
-// manually from the CLI; assertAudience never refuses subagent-audience
-// workflows. Orchestrator chains still dispatch via runForgeSubagent
-// directly and do NOT route through this handler.
-//
-// FORGE-S26-T11:
-//   - Pipeline step guard added (checks task state via store-cli; --force bypasses).
-//   - Revision loop context injected into kickoff: `### Review Loop Context` block
-//     with `Iteration: 1 of M` (user-invoked default).
-//
-// Iron Laws:
-//   IL1 — code only under forge-cli/src/extensions/forgecli/.
-//   IL4 — no JSON.stringify-into-subagent dispatch.
-//   IL6 — no shell-string interpolation; no spawn calls here.
-//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
-//         continuation.
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { assertAudience } from "./audience-gate.js";
-import { discoverForgeConfig } from "./forge-root.js";
-import { sendKickoff } from "./kickoff.js";
-// FORGE-S25-T16: extracted to lib modules (H-1, H-2). Re-exported here for
-// backward compatibility with existing test and consumer imports.
-import { extractPersonaNames } from "./lib/frontmatter-parser.js";
-import { parseGuardArgs, runPipelineGuard } from "./lib/pipeline-guard.js";
-import { loadPersona, PersonaSkillLoaderError } from "./parsers/persona-skill-loader.js";
-import { loadWorkflow, WorkflowLoaderError } from "./parsers/workflow-loader.js";
-export { extractPersonaNames };
-import { checkMaterialization } from "./lib/manifest-checker.js";
-export { checkMaterialization };
-export function parseReviewCodeArgs(rawArgs, cwd) {
-    const trimmed = (rawArgs ?? "").trim();
-    if (trimmed === "") {
-        return { mode: "empty", taskRef: "", sourceLabel: "(no input — supervisor infers task from store/context)" };
-    }
-    if (trimmed.startsWith("@")) {
-        const ref = trimmed.slice(1).trim();
-        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
-        const seed = fs.readFileSync(filePath, "utf8");
-        return { mode: "file", taskRef: seed, sourceLabel: `(seed from file: ${ref})` };
-    }
-    return { mode: "text", taskRef: trimmed, sourceLabel: "(seed from inline text)" };
-}
-export function composeKickoff(opts) {
-    const { workflowMd, personaIdentity, parsed, reviewLoopContext } = opts;
-    const sections = ["# /forge:review-code", ""];
-    if (personaIdentity.trim().length > 0) {
-        sections.push(personaIdentity.trim(), "");
-    }
-    // Inject review loop context before workflow body (FORGE-S26-T11 / T07).
-    if (reviewLoopContext) {
-        sections.push(reviewLoopContext.trim(), "");
-    }
-    sections.push("## Dispatch", "", "Run the workflow below. Specifically:", "", "1. Read the implementation diff and PROGRESS.md for `engineering/sprints/<SPRINT_ID>/<TASK_ID>/` (the source of truth).", "2. Query the store for the task and its sprint/feature context via `forge_store_query` — do NOT raw-read `.forge/store/`.", "3. Follow the workflow Algorithm verbatim: review code for correctness, test coverage, security, and architecture compliance.", "4. Write `CODE_REVIEW.md` and `CODE-REVIEW-SUMMARY.json` to the task directory using the `write` tool.", "5. Update task status by calling the `forge_store` MCP tool: `{command:'update-status', args:['task','<TASK_ID>','status','<new-status>']}`. Never raw-write `.forge/store/`. Do NOT bash-shell `forge store ...`.", "6. Honour Pack-06 Read/Write/Ask/Store discipline: writes go via the `forge_store` MCP tool; in-conversation clarifications use `forge_ask_user`.");
-    sections.push("", "---", "", "## Workflow", "", workflowMd.trim(), "", "---");
-    if (parsed.mode === "empty") {
-        sections.push("", "## Input", "", "(no seed — infer task from sprint context and store)");
-    }
-    else {
-        sections.push("", `## Input — ${parsed.sourceLabel}`, "", parsed.taskRef.trim());
-    }
-    return sections.join("\n");
-}
-// Iteration context builder (FORGE-S26-T11) ------------------------------------
-/**
- * Build the `### Review Loop Context` block for user-invoked (non-orchestrated)
- * review-code calls. Matches the T07 graceful-fallback spec:
- * "iteration 1 of M" where M is config.maxReviewIterations (default 3).
- */
-export function buildReviewLoopContext(maxIterations) {
-    return [
-        "### Review Loop Context",
-        `- Iteration: 1 of ${maxIterations}`,
-        `- Is final iteration: ${maxIterations === 1 ? "true" : "false"}`,
-    ].join("\n");
-}
-/**
- * Read maxReviewIterations from .forge/config.json. Returns default 3 on any
- * error (missing file, missing field, non-integer value).
- */
-export function readMaxReviewIterations(cwd) {
-    const configPath = path.join(cwd, ".forge", "config.json");
-    try {
-        const raw = fs.readFileSync(configPath, "utf8");
-        const cfg = JSON.parse(raw);
-        const v = cfg["maxReviewIterations"];
-        if (typeof v === "number" && Number.isInteger(v) && v >= 1)
-            return v;
-    }
-    catch {
-        // fail-open
-    }
-    return 3;
-}
-// Registration -------------------------------------------------------------
-const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "review_code.md");
-export function registerReviewCode(pi, options = {}) {
-    pi.registerCommand("forge:review-code", {
-        description: "Run the review-code workflow for a Forge task. " +
-            "Usage: /forge:review-code [@<file> | <free-form text>]. " +
-            "Note: this workflow is subagent-only; standalone invocations are refused. " +
-            "Orchestrator chains dispatch directly via runForgeSubagent.",
-        async handler(args, ctx) {
-            const cwd = options.cwd ?? process.cwd();
-            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
-            // Pipeline step guard (FORGE-S26-T11): check task state before dispatching.
-            const guardParsed = parseGuardArgs(args);
-            if (!guardParsed.force) {
-                const forgeConfig = discoverForgeConfig(cwd);
-                if (forgeConfig) {
-                    const guard = runPipelineGuard("review-code", guardParsed.taskIdHint, forgeConfig.forgeRoot, cwd);
-                    if (guard.blocked) {
-                        ctx.ui.notify(guard.message, "error");
-                        return;
-                    }
-                }
-            }
-            const effectiveArgs = guardParsed.cleanArgs;
-            let workflowMd;
-            let workflowAudience;
-            try {
-                const loaded = loadWorkflow(workflowPath);
-                workflowMd = loaded.rawMarkdown;
-                workflowAudience = loaded.audience;
-            }
-            catch (err) {
-                if (err instanceof WorkflowLoaderError) {
-                    if (err.code === "missing_file") {
-                        ctx.ui.notify(`× forge:review-code — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
-                    }
-                    else {
-                        ctx.ui.notify(`× forge:review-code — workflow load failed (${err.code}): ${err.message}`, "error");
-                    }
-                    return;
-                }
-                const e = err;
-                ctx.ui.notify(`× forge:review-code — failed to read workflow: ${e.message ?? "unknown"}`, "error");
-                return;
-            }
-            let parsed;
-            try {
-                parsed = parseReviewCodeArgs(effectiveArgs, cwd);
-            }
-            catch (err) {
-                const e = err;
-                ctx.ui.notify(`× forge:review-code — failed to read seed: ${e.message ?? "unknown"}`, "error");
-                return;
-            }
-            // Build revision loop context (FORGE-S26-T11 / T07)
-            const maxIter = readMaxReviewIterations(cwd);
-            const reviewLoopContext = buildReviewLoopContext(maxIter);
-            const check = checkMaterialization(workflowPath, workflowMd);
-            if (!check.ok) {
-                for (const marker of check.missing) {
-                    ctx.ui.notify(`× workflow regression: ${marker} not found in ${workflowPath}`, "error");
-                }
-                return;
-            }
-            const personas = extractPersonaNames(workflowMd);
-            let personaIdentity = "";
-            if (personas.length > 0) {
-                try {
-                    const persona = loadPersona(personas[0], { cwd });
-                    personaIdentity = persona.identity;
-                }
-                catch (err) {
-                    if (err instanceof PersonaSkillLoaderError) {
-                        ctx.ui.notify(`× forge:review-code — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
-                        return;
-                    }
-                    const e = err;
-                    ctx.ui.notify(`× forge:review-code — persona load error: ${e.message ?? "unknown"}`, "error");
-                    return;
-                }
-            }
-            if (!assertAudience({ workflowName: "review_code", audience: workflowAudience }, ctx)) {
-                return;
-            }
-            const kickoff = composeKickoff({
-                workflowMd,
-                personaIdentity,
-                parsed,
-                reviewLoopContext,
-            });
-            sendKickoff(pi, kickoff);
-        },
-    });
-}
-//# sourceMappingURL=review-code.js.map

package/dist/extensions/forgecli/review-code.js.map

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

package/dist/extensions/forgecli/review-plan.d.ts

@@ -1,35 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { extractPersonaNames } from "./lib/frontmatter-parser.js";
-export { extractPersonaNames };
-import { checkMaterialization, type MaterializationCheck } from "./lib/manifest-checker.js";
-export { checkMaterialization, type MaterializationCheck };
-export type ArgMode = "empty" | "file" | "text";
-export interface ParsedArgs {
-    mode: ArgMode;
-    taskRef: string;
-    sourceLabel: string;
-}
-export declare function parseReviewPlanArgs(rawArgs: string, cwd: string): ParsedArgs;
-export interface ComposeKickoffOpts {
-    workflowMd: string;
-    personaIdentity: string;
-    parsed: ParsedArgs;
-    /** Revision loop context block (FORGE-S26-T11). Injected before the workflow body. */
-    reviewLoopContext?: string;
-}
-export declare function composeKickoff(opts: ComposeKickoffOpts): string;
-/**
- * Build the `### Review Loop Context` block for user-invoked (non-orchestrated)
- * review-plan calls. Matches the T07 graceful-fallback spec:
- * "iteration 1 of M" where M is config.maxReviewIterations (default 3).
- */
-export declare function buildReviewLoopContext(maxIterations: number): string;
-/**
- * Read maxReviewIterations from .forge/config.json. Returns default 3 on any
- * error (missing file, missing field, non-integer value).
- */
-export declare function readMaxReviewIterations(cwd: string): number;
-export interface RegisterReviewPlanOptions {
-    cwd?: string;
-}
-export declare function registerReviewPlan(pi: ExtensionAPI, options?: RegisterReviewPlanOptions): void;