@entelligentsia/forgecli 1.0.21 → 1.0.25

package/dist/extensions/forgecli/lib/halt-advisor.js

@@ -1,113 +0,0 @@
-// halt-advisor.ts — Halt-recovery advisor helper (FORGE-S26-T18).
-//
-// When preflight-gate.cjs exits 1 and emits a structured failure JSON,
-// the CLI route (run-task / fix-bug) calls runHaltAdvisor to spawn a
-// read-only one-shot subagent that explains the failure and guides recovery.
-//
-// Design constraints:
-//   - Advisor is READ-ONLY: no store writes, no artifact mutations.
-//   - Model: the HEAVY model the runtime resolves point-in-time — the
-//     approve/architect slot through the existing routing cascade
-//     (project > user > pi default). NO dedicated advisorModel config entry.
-//     If nothing is routed and no current model exists, the advisor is
-//     skipped silently (non-fatal).
-//   - runHaltAdvisor is best-effort: failures must not mask the primary halt.
-import { runForgeSubagent, loadForgePersona } from "../forge-subagent.js";
-import { resolveModelForPhase } from "../model-resolver.js";
-/**
- * Resolve the advisor model for halt-recovery.
- *
- * Priority:
- *   1. Explicit `advisorModel` config slot from forge-cli layered config.
- * Contract (rev. 2026-06-04): the advisor model is the HEAVY model the runtime
- * resolves point-in-time. There is NO dedicated advisorModel config entry —
- * "heavy" is the approve/architect slot resolved through the existing routing
- * cascade (L4 phase override → L3/L2 project → L1 user/global → default),
- * exactly as the approve phase itself would resolve. When the cascade bottoms
- * out at inherit, the session's current model (pi default) is used. In the
- * Claude Code plugin route the equivalent is the opus-class session model.
- *
- * Returns undefined (advisor skipped, non-fatal) only when nothing is routed
- * AND no current model is available.
- *
- * (History: the original FORGE-S26-T18 implementation used a dedicated
- * advisorModel config slot with a blind registry fallback that produced
- * "anthropic/undefined" on the CART-S03-T01 halt — both retired.)
- */
-export function resolveAdvisorModel(merged, currentModel, pipelineName = "default") {
-    // Heavy slot: the approve phase / architect persona routing resolution.
-    try {
-        const heavy = resolveModelForPhase(pipelineName, "approve", "architect", merged ?? {});
-        if (heavy.model)
-            return heavy.model;
-    }
-    catch {
-        // resolution errors are non-fatal — fall through to the current model
-    }
-    // Inherit → pi's current model (provider-neutral, known-good).
-    if (currentModel?.provider) {
-        const model = currentModel.model ?? currentModel.id;
-        if (model)
-            return { provider: currentModel.provider, model };
-    }
-    return undefined;
-}
-/**
- * Spawn a read-only advisor subagent to explain the gate failure and guide recovery.
- *
- * Best-effort: errors are notified via ctx.ui but do NOT propagate. The
- * primary halt status is the caller's responsibility to surface separately.
- */
-export async function runHaltAdvisor(opts) {
-    const { gateFailure, advisorModel, taskId, cwd, ctx, forgeRoot } = opts;
-    if (!advisorModel) {
-        // No model available — skip advisor silently.
-        return;
-    }
-    ctx.ui.notify(`ℹ forge: halt advisor running on ${advisorModel.provider}/${advisorModel.model} for ${taskId}`, "info");
-    const advisoryPrompt = [
-        `# Halt-Recovery Advisory for ${taskId}`,
-        ``,
-        `A preflight gate halted the pipeline for phase **${gateFailure.phase}**.`,
-        ``,
-        `## Failure Details`,
-        `- **Reason code:** \`${gateFailure.reasonCode}\``,
-        `- **Detail:** ${gateFailure.detail}`,
-        ``,
-        `## Recommended Remediation`,
-        gateFailure.remediation,
-        ``,
-        `## Your Role`,
-        `You are a read-only advisor. Explain the failure in plain language, confirm the`,
-        `remediation step, and provide any additional context the user needs to unblock.`,
-        `Do NOT modify any files, run any commands, or write to the store.`,
-        `Output your advisory as a brief structured summary (2–4 sentences).`,
-    ].join("\n");
-    try {
-        let persona;
-        try {
-            persona = loadForgePersona("engineer", cwd);
-        }
-        catch {
-            // Persona unavailable — use a minimal fallback rather than crashing.
-            persona = {
-                name: "advisor",
-                description: "Halt-recovery advisor",
-                systemPrompt: "You are a Forge engineering advisor. Be concise and helpful.",
-                filePath: "",
-            };
-        }
-        await runForgeSubagent({
-            persona,
-            task: advisoryPrompt,
-            cwd,
-            forgeRoot,
-            requestedModel: advisorModel,
-        });
-    }
-    catch (err) {
-        const e = err;
-        ctx.ui.notify(`⚠ forge: halt advisor failed (non-fatal): ${e.message ?? "unknown"}`, "warning");
-    }
-}
-//# sourceMappingURL=halt-advisor.js.map

package/dist/extensions/forgecli/lib/halt-advisor.js.map

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

package/dist/extensions/forgecli/lib/orchestrator-preflight.d.ts

@@ -1,46 +0,0 @@
-import type { MergedConfig } from "../config-layer.js";
-import type { OrchestratorResult } from "./orchestrator-types.js";
-/** Minimal context interface — only the bits preflight needs. */
-export interface PreflightContext {
-    ui: {
-        notify(message: string, type?: "error" | "info" | "warning"): void;
-    };
-}
-export interface RunOrchestratorPreflightOptions {
-    /** "task" runs validateModelConfig; "ceremony" skips it. */
-    mode: "task" | "ceremony";
-    /** Minimal context for notifications. */
-    ctx: PreflightContext;
-    /** Prefix for notify messages, e.g. "forge:run-task" or "forge:fix-bug". */
-    notifyPrefix: string;
-    /** Persona name catalogue from readPersonaDir. */
-    personaCatalogue: string[];
-    /** Pipeline name catalogue from readPipelineNames; null if no config found. */
-    pipelineCatalogue: string[] | null;
-    /** Merged model-routing config from loadLayeredConfig. */
-    modelRoutingConfig: MergedConfig;
-    /** Available models from ctx.modelRegistry.getAvailable(). */
-    availableModels: Array<{
-        provider: string;
-        id: string;
-    }>;
-}
-/** Discriminated union: proceed=true → continue; proceed=false → return result early. */
-export type OrchestratorPreflightResult = {
-    proceed: true;
-} | {
-    proceed: false;
-    result: OrchestratorResult;
-};
-/**
- * Run the orchestrator pre-flight check.
- *
- * In mode="task": calls validateModelConfig and surfaces warnings/errors via
- * ctx.ui.notify. Returns `{ proceed: false, result }` with status="failed" if
- * there are errors; returns `{ proceed: true }` otherwise.
- *
- * In mode="ceremony": returns `{ proceed: true }` immediately without calling
- * validateModelConfig. This matches the existing behaviour of ceremony dispatch
- * which uses lookupPersonaModel rather than the full validator.
- */
-export declare function runOrchestratorPreflight(opts: RunOrchestratorPreflightOptions): OrchestratorPreflightResult;

package/dist/extensions/forgecli/lib/orchestrator-preflight.js

@@ -1,64 +0,0 @@
-// lib/orchestrator-preflight.ts — FORGE-S25-T17 (H-13, N-H-D)
-//
-// Single shared preflight helper for orchestrator pipelines. Replaces the
-// duplicate pre-flight validation blocks in run-task.ts and fix-bug.ts.
-//
-// Design: a `mode` parameter selects behaviour:
-//
-//   mode="task"     — full model-config validation via validateModelConfig.
-//                     Used by runTaskPipeline and runBugPipeline.
-//   mode="ceremony" — skips validateModelConfig entirely.
-//                     Aligns with dispatchSprintCeremony which uses
-//                     lookupPersonaModel (not the full validator). The
-//                     run-sprint.ts ceremony call does NOT use this helper
-//                     directly; it was already skip-validation by design
-//                     (N-H-D). This mode is available for future callers
-//                     that need a ceremony-style preflight.
-//
-// Why run-sprint.ts is NOT migrated to this helper:
-//   run-sprint.ts contains a separate sprint-entry validation block
-//   (lines 470–498) that validates sprint-level config, not task/phase-level.
-//   That block is architecturally distinct and is explicitly out of scope
-//   per the plan-review finding (N-H-D resolved, reviewer-approved).
-import { validateModelConfig } from "../model-validator.js";
-// ---------------------------------------------------------------------------
-// runOrchestratorPreflight
-// ---------------------------------------------------------------------------
-/**
- * Run the orchestrator pre-flight check.
- *
- * In mode="task": calls validateModelConfig and surfaces warnings/errors via
- * ctx.ui.notify. Returns `{ proceed: false, result }` with status="failed" if
- * there are errors; returns `{ proceed: true }` otherwise.
- *
- * In mode="ceremony": returns `{ proceed: true }` immediately without calling
- * validateModelConfig. This matches the existing behaviour of ceremony dispatch
- * which uses lookupPersonaModel rather than the full validator.
- */
-export function runOrchestratorPreflight(opts) {
-    if (opts.mode === "ceremony") {
-        return { proceed: true };
-    }
-    // mode="task" — full validation
-    const strict = process.env.FORGE_STRICT_MODELS === "1";
-    const { errors, warnings } = validateModelConfig(opts.personaCatalogue, opts.pipelineCatalogue, opts.modelRoutingConfig, opts.availableModels, strict);
-    for (const w of warnings) {
-        opts.ctx.ui.notify(`⚠ ${opts.notifyPrefix} — model routing: ${w.message}`, "warning");
-    }
-    if (errors.length > 0) {
-        for (const e of errors) {
-            opts.ctx.ui.notify(`× ${opts.notifyPrefix} — model routing: ${e.message}`, "error");
-        }
-        return {
-            proceed: false,
-            result: {
-                status: "failed",
-                lastPhaseIndex: 0,
-                iterationCounts: {},
-                lastError: `model config validation failed: ${errors.map((e) => e.code).join(", ")}`,
-            },
-        };
-    }
-    return { proceed: true };
-}
-//# sourceMappingURL=orchestrator-preflight.js.map

package/dist/extensions/forgecli/lib/orchestrator-preflight.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"orchestrator-preflight.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/orchestrator-preflight.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,EAAE;AACF,gDAAgD;AAChD,EAAE;AACF,4EAA4E;AAC5E,kEAAkE;AAClE,0DAA0D;AAC1D,oEAAoE;AACpE,uEAAuE;AACvE,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AACzE,4DAA4D;AAC5D,EAAE;AACF,oDAAoD;AACpD,oEAAoE;AACpE,8EAA8E;AAC9E,0EAA0E;AAC1E,qEAAqE;AAGrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAkC5D,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAqC;IAC7E,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,gCAAgC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG,CAAC;IACvD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAC/C,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,eAAe,EACpB,MAAM,CACN,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,YAAY,qBAAqB,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,YAAY,qBAAqB,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrF,CAAC;QACD,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE;gBACP,MAAM,EAAE,QAAQ;gBAChB,cAAc,EAAE,CAAC;gBACjB,eAAe,EAAE,EAAE;gBACnB,SAAS,EAAE,mCAAmC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACpF;SACD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

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

@@ -1,16 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-export interface ParsedMaterializeArgs {
-    mode: "all" | "single-workflow";
-    workflowId?: string;
-}
-/**
- * Parse /forge:materialize arguments.
- *
- * Recognised forms:
- *   (empty)                  → { mode: "all" }
- *   --all                    → { mode: "all" }
- *   workflows <id>           → { mode: "single-workflow", workflowId: "<id>" }
- *   workflows:<id>           → { mode: "single-workflow", workflowId: "<id>" }
- */
-export declare function parseMaterializeArgs(args: string): ParsedMaterializeArgs;
-export declare function registerMaterialize(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/materialize.js

@@ -1,195 +0,0 @@
-// materialize.ts — native handler for /forge:materialize (FORGE-S23-T09)
-//
-// Ports the deterministic subset of the plugin's /forge:materialize:
-//   - Full warm-up (no args or --all): runs substitute-placeholders.cjs,
-//     build-persona-pack.cjs, and build-context-pack.cjs from the bundled payload.
-//   - Single-workflow mode: deferred — notify + return (follow-up task).
-//
-// Mode-neutral invariant: never writes .forge/config.json mode field.
-// Uses spawn("node", [toolPath, ...argv]) — argv-array, no shell (IL6).
-//
-// References: regenerate.ts (substitute-placeholders.cjs argv),
-//             forge-init.ts (build-persona-pack / build-context-pack argv).
-import { spawn } from "node:child_process";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { getBundledPayloadRoot, getBundledToolsRoot } from "./forge-init.js";
-// ── Argument parser ─────────────────────────────────────────────────────────
-/**
- * Parse /forge:materialize arguments.
- *
- * Recognised forms:
- *   (empty)                  → { mode: "all" }
- *   --all                    → { mode: "all" }
- *   workflows <id>           → { mode: "single-workflow", workflowId: "<id>" }
- *   workflows:<id>           → { mode: "single-workflow", workflowId: "<id>" }
- */
-export function parseMaterializeArgs(args) {
-    const trimmed = args.trim();
-    if (!trimmed || trimmed === "--all") {
-        return { mode: "all" };
-    }
-    // "workflows plan_task" or "workflows:plan_task"
-    const workflowsMatch = trimmed.match(/^workflows[: ](.+)$/);
-    if (workflowsMatch) {
-        return { mode: "single-workflow", workflowId: workflowsMatch[1].trim() };
-    }
-    // Unrecognised flags/forms: treat as full warm-up (fail-open)
-    return { mode: "all" };
-}
-// ── Tool runner ─────────────────────────────────────────────────────────────
-/**
- * Spawn `node <toolPath> [...argv]` and await completion.
- * Returns `{ ok: boolean, stderr: string }`.
- *
- * Non-zero exit is FATAL when `fatal === true` (default), ADVISORY otherwise.
- */
-async function runTool(toolPath, argv, cwd, label, timeoutMs = 60_000) {
-    return new Promise((resolve) => {
-        const child = spawn("node", [toolPath, ...argv], {
-            cwd,
-            stdio: ["ignore", "pipe", "pipe"],
-        });
-        let stderrBuf = "";
-        const timer = setTimeout(() => {
-            child.kill("SIGKILL");
-            resolve({ ok: false, stderr: `${label} timed out after ${timeoutMs}ms` });
-        }, timeoutMs);
-        child.stderr?.on("data", (d) => {
-            stderrBuf += d.toString();
-        });
-        child.on("close", (code) => {
-            clearTimeout(timer);
-            resolve({ ok: code === 0, stderr: stderrBuf });
-        });
-        child.on("error", (err) => {
-            clearTimeout(timer);
-            resolve({ ok: false, stderr: err.message });
-        });
-    });
-}
-// ── Register ────────────────────────────────────────────────────────────────
-export function registerMaterialize(pi) {
-    pi.registerCommand("forge:materialize", {
-        description: "Fill missing or stubbed Forge scaffolding without overwriting pristine files. " +
-            "Deterministic complement to /forge:init --fast. Mode-neutral: never writes config mode.",
-        async handler(args, ctx) {
-            const cwd = process.cwd();
-            const parsed = parseMaterializeArgs(args);
-            // Single-workflow mode: deferred in forge-cli — notify and return
-            if (parsed.mode === "single-workflow") {
-                ctx.ui.notify(`〇 forge:materialize — single-workflow mode ('${parsed.workflowId ?? "?"}') is not yet supported in forge-cli. ` +
-                    "Use the Forge plugin directly or run /forge:materialize --all for a full warm-up.", "info");
-                return;
-            }
-            // Config guard
-            const configPath = path.join(cwd, ".forge", "config.json");
-            if (!fs.existsSync(configPath)) {
-                ctx.ui.notify("× forge:materialize — no .forge/config.json found. Run /forge:init first.", "error");
-                return;
-            }
-            // Resolve tool paths
-            let bundleRoot;
-            let toolsRoot;
-            try {
-                bundleRoot = getBundledPayloadRoot();
-                toolsRoot = getBundledToolsRoot();
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                ctx.ui.notify(`× forge:materialize — could not resolve bundle paths: ${msg}`, "error");
-                return;
-            }
-            const substituteTool = path.join(toolsRoot, "substitute-placeholders.cjs");
-            const basePackDir = path.join(bundleRoot, ".base-pack");
-            const configJsonPath = path.join(cwd, ".forge", "config.json");
-            // Guard: tools must exist
-            if (!fs.existsSync(substituteTool)) {
-                ctx.ui.notify(`× forge:materialize — substitute-placeholders.cjs not found at ${substituteTool}`, "error");
-                return;
-            }
-            if (!fs.existsSync(basePackDir)) {
-                ctx.ui.notify(`× forge:materialize — .base-pack not found at ${basePackDir}`, "error");
-                return;
-            }
-            ctx.ui.setStatus?.("forge:materialize", "Materializing .forge/ artifacts…");
-            // Step 1: substitute-placeholders.cjs (fatal on failure)
-            // argv shape mirrors regenerate.ts usage
-            const initContextJson = path.join(cwd, ".forge", "init-context.json");
-            const subArgv = [
-                "--forge-root",
-                bundleRoot,
-                "--base-pack",
-                basePackDir,
-                "--config",
-                configJsonPath,
-                "--out",
-                cwd,
-            ];
-            if (fs.existsSync(initContextJson)) {
-                subArgv.push("--context", initContextJson);
-            }
-            const subResult = await runTool(substituteTool, subArgv, cwd, "substitute-placeholders", 60_000);
-            if (!subResult.ok) {
-                const errMsg = subResult.stderr.trim().split("\n").slice(-3).join(" | ") || "unknown error";
-                ctx.ui.notify(`× forge:materialize — substitute-placeholders.cjs failed: ${errMsg}`, "error");
-                ctx.ui.setStatus?.("forge:materialize", undefined);
-                return;
-            }
-            ctx.ui.notify("〇 forge:materialize — scaffold filled", "info");
-            // Step 2: build-persona-pack.cjs (advisory — non-fatal)
-            const buildPersonaPackTool = path.join(toolsRoot, "build-persona-pack.cjs");
-            if (fs.existsSync(buildPersonaPackTool)) {
-                fs.mkdirSync(path.join(cwd, ".forge", "cache"), { recursive: true });
-                const personaResult = await runTool(buildPersonaPackTool, ["--out", path.join(cwd, ".forge", "cache", "persona-pack.json")], cwd, "build-persona-pack", 30_000);
-                if (!personaResult.ok) {
-                    const msg = personaResult.stderr.trim().split("\n").at(-1) ?? "unknown";
-                    ctx.ui.notify(`△ forge:materialize — build-persona-pack.cjs failed (non-fatal): ${msg}`, "warning");
-                }
-            }
-            // Step 3: build-context-pack.cjs (advisory — non-fatal)
-            const buildContextPackTool = path.join(toolsRoot, "build-context-pack.cjs");
-            if (fs.existsSync(buildContextPackTool)) {
-                // Read engineering path from config
-                let kbPath = "engineering";
-                try {
-                    const raw = fs.readFileSync(configPath, "utf8");
-                    const cfg = JSON.parse(raw);
-                    const p = cfg.paths;
-                    if (p && typeof p.engineering === "string")
-                        kbPath = p.engineering;
-                }
-                catch {
-                    // use default
-                }
-                const ctxResult = await runTool(buildContextPackTool, [
-                    "--arch-dir",
-                    path.join(cwd, kbPath, "architecture"),
-                    "--out-md",
-                    path.join(cwd, ".forge", "cache", "context-pack.md"),
-                    "--out-json",
-                    path.join(cwd, ".forge", "cache", "context-pack.json"),
-                ], cwd, "build-context-pack", 30_000);
-                if (!ctxResult.ok) {
-                    const msg = ctxResult.stderr.trim().split("\n").at(-1) ?? "unknown";
-                    ctx.ui.notify(`△ forge:materialize — build-context-pack.cjs failed (non-fatal): ${msg}`, "warning");
-                }
-            }
-            // Complete
-            ctx.ui.setStatus?.("forge:materialize", undefined);
-            ctx.ui.notify("〇 forge:materialize complete — gaps filled (mode unchanged)", "info");
-            // Promotion hint (mode-neutral: only read, never write)
-            try {
-                const raw = fs.readFileSync(configPath, "utf8");
-                const cfg = JSON.parse(raw);
-                if (cfg.mode === "fast") {
-                    ctx.ui.notify("〇 To declare the project fully generated: /forge:config mode full", "info");
-                }
-            }
-            catch {
-                // non-fatal — promotion hint is cosmetic
-            }
-        },
-    });
-}
-//# sourceMappingURL=materialize.js.map

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

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

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

@@ -1,22 +0,0 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { type ForgeToolDefs } from "./forge-tools.js";
-export interface ParsedMigrateArgs {
-    /** True when --structural flag present OR .forge/structure-versions.json absent. */
-    structural: boolean;
-    /** True when --dry-run flag present (schema branch only). */
-    dryRun: boolean;
-}
-/**
- * Parse /forge:migrate arguments.
- *
- * Also checks filesystem for .forge/structure-versions.json to determine
- * structural vs schema branch (absence → structural).
- */
-export declare function parseMigrateArgs(args: string, cwd: string): ParsedMigrateArgs;
-export interface RegisterMigrateOptions {
-    /** Override bundleRoot — for testing only. Production: always undefined (resolved via getBundledPayloadRoot). */
-    _testBundleRoot?: string;
-    /** Forge tool definitions for subagent injection. */
-    forgeToolDefs?: ForgeToolDefs;
-}
-export declare function registerMigrate(pi: ExtensionAPI, opts?: RegisterMigrateOptions): void;