agentplane 0.3.6 → 0.3.8

package/dist/cli/group-command.js

@@ -0,0 +1,45 @@
+import { usageError } from "./spec/errors.js";
+import { suggestOne } from "./spec/suggest.js";
+export function parseGroupCommand(raw, argName = "cmd") {
+    const value = raw.args[argName];
+    if (Array.isArray(value))
+        return { cmd: value.map(String) };
+    if (typeof value === "string" && value.length > 0)
+        return { cmd: [value] };
+    return { cmd: [] };
+}
+export function directSubcommandNames(prefix, specs) {
+    return directSubcommandNamesFromIds(prefix, specs.map((spec) => spec.id));
+}
+export function directSubcommandNamesFromIds(prefix, ids) {
+    const names = new Set();
+    for (const id of ids) {
+        if (id.length <= prefix.length)
+            continue;
+        if (!prefix.every((segment, index) => id[index] === segment))
+            continue;
+        const next = id[prefix.length];
+        if (typeof next === "string" && next.length > 0)
+            names.add(next);
+    }
+    return [...names].toSorted((left, right) => left.localeCompare(right));
+}
+export async function loadDirectSubcommandNames(prefix) {
+    // Lazy-load the catalog to avoid a static cycle between group roots and catalog bootstrap.
+    const { getDirectChildCommandNames } = await import("./run-cli/command-catalog.js");
+    return getDirectChildCommandNames(prefix);
+}
+export function throwGroupCommandUsage(opts) {
+    const input = opts.cmd.join(" ");
+    const suggestion = suggestOne(input, [...opts.subcommands]);
+    const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
+    const message = opts.cmd.length === 0
+        ? (opts.missingMessage ?? "Missing subcommand.")
+        : `${opts.unknownMessage?.(opts.cmd[0] ?? "") ?? `Unknown subcommand: ${opts.cmd[0]}.`}${suffix}`;
+    throw usageError({
+        spec: opts.spec,
+        command: opts.command,
+        message,
+        context: opts.contextCommand ? { command: opts.contextCommand } : undefined,
+    });
+}

package/dist/cli/output.d.ts

@@ -1,3 +1,28 @@
+export type CliOutputWriter = {
+    write: (chunk: string) => unknown;
+};
+export type CliEmitterStream = "stdout" | "stderr";
+export type CliReportEntry = string | {
+    label: string;
+    value?: string | number | boolean | null;
+};
+export type CliReportOptions = {
+    header?: string;
+    stream?: CliEmitterStream;
+};
+export type CliEmitter = {
+    line: (text: string, stream?: CliEmitterStream) => void;
+    lines: (lines: Iterable<string>, stream?: CliEmitterStream) => void;
+    json: (value: unknown, stream?: CliEmitterStream) => void;
+    jsonSection: (label: string, value: unknown, options?: {
+        indent?: string;
+        stream?: CliEmitterStream;
+    }) => void;
+    report: (entries: Iterable<CliReportEntry>, options?: CliReportOptions) => void;
+    info: (message: string, stream?: CliEmitterStream) => void;
+    warn: (message: string, stream?: CliEmitterStream) => void;
+    success: (action: string, target?: string, details?: string, stream?: CliEmitterStream) => void;
+};
 export declare function successMessage(action: string, target?: string, details?: string): string;
 export declare function infoMessage(message: string): string;
 export declare function warnMessage(message: string): string;
@@ -13,4 +38,8 @@ export declare function invalidFieldMessage(field: string, expected: string, sou
 export declare function invalidPathMessage(field: string, reason: string, source?: string): string;
 export declare function missingFileMessage(filename: string, rootHint?: string): string;
 export declare function workflowModeMessage(actual: string | undefined, expected: string): string;
+export declare function createCliEmitter(streams?: {
+    stdout?: CliOutputWriter;
+    stderr?: CliOutputWriter;
+}): CliEmitter;
 //# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5F;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExF"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"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"}

package/dist/cli/output.js

@@ -1,3 +1,19 @@
+function ensureTrailingNewline(text) {
+    return text.endsWith("\n") ? text : `${text}\n`;
+}
+function renderReportLine(entry) {
+    if (typeof entry === "string")
+        return entry;
+    if (entry.value === undefined || entry.value === null)
+        return `${entry.label}:`;
+    return `${entry.label}: ${String(entry.value)}`;
+}
+function resolveWriter(stdout, stderr, stream) {
+    return stream === "stderr" ? stderr : stdout;
+}
+function writeChunk(writer, text) {
+    writer.write(text);
+}
 export function successMessage(action, target, details) {
     const base = target ? `${action} ${target}` : action;
     const suffix = details ? ` (${details})` : "";
@@ -45,3 +61,63 @@ export function missingFileMessage(filename, rootHint) {
 export function workflowModeMessage(actual, expected) {
     return `Invalid workflow_mode: ${actual ?? "unknown"} (expected ${expected})`;
 }
+function renderPrettyJson(value) {
+    return JSON.stringify(value, null, 2);
+}
+function renderTextLine(text) {
+    return ensureTrailingNewline(text);
+}
+function renderTextLines(lines) {
+    return Array.from(lines, renderTextLine).join("");
+}
+function renderReportBlock(entries, options) {
+    const lines = options?.header ? [options.header] : [];
+    for (const entry of entries) {
+        lines.push(renderReportLine(entry));
+    }
+    return renderTextLines(lines);
+}
+function renderJsonSectionBlock(label, value, indent) {
+    const payload = renderPrettyJson(value);
+    if (!payload)
+        return null;
+    return renderTextLines([`${label}:`, ...payload.split("\n").map((line) => `${indent}${line}`)]);
+}
+export function createCliEmitter(streams) {
+    const stdout = streams?.stdout ?? process.stdout;
+    const stderr = streams?.stderr ?? process.stderr;
+    const line = (text, stream = "stdout") => {
+        writeChunk(resolveWriter(stdout, stderr, stream), renderTextLine(text));
+    };
+    const lines = (values, stream = "stdout") => {
+        writeChunk(resolveWriter(stdout, stderr, stream), renderTextLines(values));
+    };
+    const json = (value, stream = "stdout") => {
+        line(renderPrettyJson(value), stream);
+    };
+    const jsonSection = (label, value, options) => {
+        const block = renderJsonSectionBlock(label, value, options?.indent ?? "  ");
+        if (!block)
+            return;
+        writeChunk(resolveWriter(stdout, stderr, options?.stream ?? "stdout"), block);
+    };
+    const report = (entries, options) => {
+        writeChunk(resolveWriter(stdout, stderr, options?.stream ?? "stdout"), renderReportBlock(entries, options));
+    };
+    return {
+        line,
+        lines,
+        json,
+        jsonSection,
+        report,
+        info: (message, stream = "stdout") => {
+            line(infoMessage(message), stream);
+        },
+        warn: (message, stream = "stderr") => {
+            line(warnMessage(message), stream);
+        },
+        success: (action, target, details, stream = "stdout") => {
+            line(successMessage(action, target, details), stream);
+        },
+    };
+}

package/dist/cli/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzF;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjE"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAEA,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUzF;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKjE"}

package/dist/cli/prompts.js

@@ -21,7 +21,11 @@ export async function promptYesNo(prompt, defaultValue) {
     const trimmed = answer.trim().toLowerCase();
     if (!trimmed)
         return defaultValue;
-    return ["y", "yes", "true", "1", "on"].includes(trimmed);
+    if (["y", "yes", "true", "1", "on"].includes(trimmed))
+        return true;
+    if (["n", "no", "false", "0", "off"].includes(trimmed))
+        return false;
+    return defaultValue;
 }
 export async function promptInput(prompt) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });

package/dist/cli/run-cli/command-catalog/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/core.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,2VAqMkB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/core.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,2VA8MkB,CAAC"}

package/dist/cli/run-cli/command-catalog/core.js

@@ -9,129 +9,138 @@ import { releaseApplySpec } from "../../../commands/release/apply.command.js";
 import { releasePlanSpec } from "../../../commands/release/plan.command.js";
 import { releaseSpec } from "../../../commands/release/release.command.js";
 import { configSetSpec, configShowSpec, modeGetSpec, modeSetSpec, profileSetSpec, } from "../commands/config.js";
-import { agentsSpec, preflightSpec, quickstartSpec, roleSpec } from "../commands/core.js";
+import { agentsSpec } from "../commands/core/agents.js";
+import { preflightSpec } from "../commands/core/preflight.js";
+import { quickstartSpec } from "../commands/core/quickstart.js";
+import { roleSpec } from "../commands/core/role.js";
 import { ideSyncSpec } from "../commands/ide.js";
 import { initSpec } from "../commands/init.js";
+import { requireCanonicalCommandInvocation } from "../../command-invocations.js";
 import { entry } from "./shared.js";
 export const CORE_COMMANDS = [
     entry(initSpec, () => import("../commands/init.js").then((m) => m.runInit), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
+        invocation: requireCanonicalCommandInvocation(["init"]),
     }),
     entry(upgradeSpec, () => import("../../../commands/upgrade.command.js").then((m) => m.runUpgrade), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(releaseSpec, () => import("../../../commands/release/release.command.js").then((m) => m.runRelease), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(releasePlanSpec, () => import("../../../commands/release/plan.command.js").then((m) => m.runReleasePlan), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(releaseApplySpec, () => import("../../../commands/release/apply.command.js").then((m) => m.runReleaseApply), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
-    entry(quickstartSpec, () => import("../commands/core.js").then((m) => m.runQuickstart), {
+    entry(quickstartSpec, () => import("../commands/core/quickstart.js").then((m) => m.runQuickstart), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
+        invocation: requireCanonicalCommandInvocation(["quickstart"]),
     }),
-    entry(preflightSpec, () => import("../commands/core.js").then((m) => m.runPreflight), {
+    entry(preflightSpec, () => import("../commands/core/preflight.js").then((m) => m.runPreflight), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
+        invocation: requireCanonicalCommandInvocation(["preflight"]),
     }),
     entry(runtimeSpec, () => import("../../../commands/runtime.command.js").then((m) => m.runRuntime), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(runtimeExplainSpec, () => import("../../../commands/runtime.command.js").then((m) => m.runRuntimeExplain), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
-    entry(roleSpec, () => import("../commands/core.js").then((m) => m.runRole), {
+    entry(roleSpec, () => import("../commands/core/role.js").then((m) => m.runRole), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
+        invocation: requireCanonicalCommandInvocation(["role"]),
     }),
-    entry(agentsSpec, (deps) => import("../commands/core.js").then((m) => m.makeRunAgentsHandler(deps)), {
+    entry(agentsSpec, (deps) => import("../commands/core/agents.js").then((m) => m.makeRunAgentsHandler(deps)), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(configShowSpec, (deps) => import("../commands/config.js").then((m) => m.makeRunConfigShowHandler(deps)), {
         needsProject: true,
-        needsConfig: true,
+        needsLoadedConfig: true,
         needsTaskContext: false,
+        invocation: requireCanonicalCommandInvocation(["config", "show"]),
     }),
     entry(configSetSpec, (deps) => import("../commands/config.js").then((m) => m.makeRunConfigSetHandler(deps)), {
         needsProject: true,
-        needsConfig: true,
+        needsLoadedConfig: true,
         needsTaskContext: false,
     }),
     entry(modeGetSpec, (deps) => import("../commands/config.js").then((m) => m.makeRunModeGetHandler(deps)), {
         needsProject: true,
-        needsConfig: true,
+        needsLoadedConfig: true,
         needsTaskContext: false,
     }),
     entry(modeSetSpec, (deps) => import("../commands/config.js").then((m) => m.makeRunModeSetHandler(deps)), {
         needsProject: true,
-        needsConfig: true,
+        needsLoadedConfig: true,
         needsTaskContext: false,
     }),
     entry(profileSetSpec, (deps) => import("../commands/config.js").then((m) => m.makeRunProfileSetHandler(deps)), {
         needsProject: true,
-        needsConfig: true,
+        needsLoadedConfig: true,
         needsTaskContext: false,
     }),
     entry(ideSyncSpec, (deps) => import("../commands/ide.js").then((m) => m.makeRunIdeSyncHandler(deps)), {
         needsProject: true,
-        needsConfig: true,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(doctorSpec, () => import("../../../commands/doctor.run.js").then((m) => m.runDoctor), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(workflowSpec, () => import("../../../commands/workflow.command.js").then((m) => m.runWorkflow), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(workflowBuildSpec, () => import("../../../commands/workflow-build.command.js").then((m) => m.runWorkflowBuild), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(workflowRestoreSpec, () => import("../../../commands/workflow-restore.command.js").then((m) => m.runWorkflowRestore), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(workflowDebugSpec, () => import("../../../commands/workflow-playbook.command.js").then((m) => m.runWorkflowDebug), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(workflowSyncSpec, () => import("../../../commands/workflow-playbook.command.js").then((m) => m.runWorkflowSync), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(workflowLandSpec, () => import("../../../commands/workflow-playbook.command.js").then((m) => m.runWorkflowLand), {
         needsProject: true,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
 ];

package/dist/cli/run-cli/command-catalog/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/lifecycle.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,kBAAkB,yPAmFa,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/lifecycle.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,kBAAkB,yPA2Fa,CAAC"}

package/dist/cli/run-cli/command-catalog/lifecycle.js

@@ -14,22 +14,25 @@ import { hooksUninstallSpec } from "../../../commands/hooks/uninstall.command.js
 import { readySpec } from "../../../commands/ready.command.js";
 import { startSpec } from "../../../commands/start.spec.js";
 import { verifySpec } from "../../../commands/verify.spec.js";
+import { requireCanonicalCommandInvocation } from "../../command-invocations.js";
 import { entry } from "./shared.js";
 export const LIFECYCLE_COMMANDS = [
     entry(commitSpec, (deps) => import("../../../commands/commit.command.js").then((m) => m.makeRunCommitHandler(deps.getCtx))),
     entry(startSpec, (deps) => import("../../../commands/start.run.js").then((m) => m.makeRunStartHandler(deps.getCtx))),
     entry(blockSpec, (deps) => import("../../../commands/block.run.js").then((m) => m.makeRunBlockHandler(deps.getCtx))),
-    entry(verifySpec, (deps) => import("../../../commands/verify.run.js").then((m) => m.makeRunVerifyHandler(deps.getCtx))),
-    entry(finishSpec, (deps) => import("../../../commands/finish.run.js").then((m) => m.makeRunFinishHandler(deps.getCtx))),
+    entry(verifySpec, (deps) => import("../../../commands/verify.run.js").then((m) => m.makeRunVerifyHandler(deps.getCtx)), { invocation: requireCanonicalCommandInvocation(["verify"]) }),
+    entry(finishSpec, (deps) => import("../../../commands/finish.run.js").then((m) => m.makeRunFinishHandler(deps.getCtx)), {
+        invocation: requireCanonicalCommandInvocation(["finish"]),
+    }),
     entry(readySpec, (deps) => import("../../../commands/ready.command.js").then((m) => m.makeRunReadyHandler(deps.getCtx))),
     entry(docsCliSpec, (deps) => import("../../../commands/docs/cli.command.js").then((m) => m.makeRunDocsCliHandler(deps.getHelpJsonForDocs)), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(hooksSpec, () => import("../../../commands/hooks/hooks.command.js").then((m) => m.runHooks), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(hooksInstallSpec, () => import("../../../commands/hooks/install.command.js").then((m) => m.runHooksInstall)),
@@ -37,13 +40,13 @@ export const LIFECYCLE_COMMANDS = [
     entry(hooksRunSpec, () => import("../../../commands/hooks/run.command.js").then((m) => m.runHooksRun)),
     entry(cleanupSpec, () => import("../../../commands/cleanup/merged.command.js").then((m) => m.runCleanup), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(cleanupMergedSpec, (deps) => import("../../../commands/cleanup/merged.command.js").then((m) => m.makeRunCleanupMergedHandler(deps.getCtx))),
     entry(guardSpec, () => import("../../../commands/guard/guard.command.js").then((m) => m.runGuard), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(guardCleanSpec, () => import("../../../commands/guard/clean.command.js").then((m) => m.runGuardClean)),

package/dist/cli/run-cli/command-catalog/project.d.ts

@@ -1,3 +1,3 @@
 import { type CommandEntry } from "./shared.js";
-export declare const PROJECT_COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
+export declare const PROJECT_COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
 //# sourceMappingURL=project.d.ts.map

package/dist/cli/run-cli/command-catalog/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/project.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,gBAAgB,+aAyIe,CAAC"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/project.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,gBAAgB,ydAsJe,CAAC"}

package/dist/cli/run-cli/command-catalog/project.js

@@ -1,5 +1,5 @@
 import { syncSpec } from "../../../commands/sync.command.js";
-import { backendSpec, backendSyncSpec } from "../../../commands/backend/sync.command.js";
+import { backendInspectSpec, backendMigrateCanonicalStateSpec, backendSpec, backendSyncSpec, } from "../../../commands/backend/sync.command.js";
 import { branchBaseClearSpec, branchBaseExplainSpec, branchBaseGetSpec, branchBaseSetSpec, branchBaseSpec, } from "../../../commands/branch/base.command.js";
 import { branchRemoveSpec } from "../../../commands/branch/remove.command.js";
 import { branchStatusSpec } from "../../../commands/branch/status.command.js";
@@ -15,6 +15,7 @@ import { recipesListRemoteSpec } from "../../../commands/recipes/list-remote.com
 import { recipesListSpec } from "../../../commands/recipes/list.command.js";
 import { recipesRemoveSpec } from "../../../commands/recipes/remove.command.js";
 import { recipesSpec } from "../../../commands/recipes/recipes.command.js";
+import { scenarioExecuteSpec } from "../../../commands/scenario/execute.command.js";
 import { scenarioInfoSpec } from "../../../commands/scenario/info.command.js";
 import { scenarioListSpec } from "../../../commands/scenario/list.command.js";
 import { scenarioRunSpec } from "../../../commands/scenario/run.command.js";
@@ -24,12 +25,12 @@ export const PROJECT_COMMANDS = [
     entry(workStartSpec, (deps) => import("../../../commands/branch/work-start.command.js").then((m) => m.makeRunWorkStartHandler(deps.getCtx))),
     entry(recipesSpec, () => import("../../../commands/recipes/recipes.command.js").then((m) => m.runRecipes), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(recipesCacheSpec, () => import("../../../commands/recipes/cache.command.js").then((m) => m.runRecipesCache), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(recipesListSpec, () => import("../../../commands/recipes/list.command.js").then((m) => m.runRecipesList)),
@@ -41,15 +42,16 @@ export const PROJECT_COMMANDS = [
     entry(recipesInstallSpec, () => import("../../../commands/recipes/install.run.js").then((m) => m.runRecipesInstall)),
     entry(scenarioSpec, () => import("../../../commands/scenario/scenario.command.js").then((m) => m.runScenario), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(scenarioListSpec, () => import("../../../commands/scenario/list.command.js").then((m) => m.runScenarioList)),
     entry(scenarioInfoSpec, () => import("../../../commands/scenario/info.command.js").then((m) => m.runScenarioInfo)),
+    entry(scenarioExecuteSpec, () => import("../../../commands/scenario/execute.command.js").then((m) => m.runScenarioExecute)),
     entry(scenarioRunSpec, () => import("../../../commands/scenario/run.command.js").then((m) => m.runScenarioRun)),
     entry(branchBaseSpec, () => import("../../../commands/branch/base.command.js").then((m) => m.runBranchBase), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(branchBaseGetSpec, () => import("../../../commands/branch/base.command.js").then((m) => m.runBranchBaseGet)),
@@ -60,14 +62,16 @@ export const PROJECT_COMMANDS = [
     entry(branchRemoveSpec, () => import("../../../commands/branch/remove.command.js").then((m) => m.runBranchRemove)),
     entry(backendSpec, (deps) => import("../../../commands/backend/sync.command.js").then((m) => m.makeRunBackendHandler(deps.getCtx)), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(backendSyncSpec, (deps) => import("../../../commands/backend/sync.command.js").then((m) => m.makeRunBackendSyncHandler(deps.getCtx))),
+    entry(backendInspectSpec, (deps) => import("../../../commands/backend/sync.command.js").then((m) => m.makeRunBackendInspectHandler(deps.getCtx))),
+    entry(backendMigrateCanonicalStateSpec, (deps) => import("../../../commands/backend/sync.command.js").then((m) => m.makeRunBackendMigrateCanonicalStateHandler(deps.getCtx))),
     entry(syncSpec, (deps) => import("../../../commands/sync.command.js").then((m) => m.makeRunSyncHandler(deps.getCtx))),
     entry(prSpec, (deps) => import("../../../commands/pr/pr.command.js").then((m) => m.makeRunPrHandler(deps.getCtx)), {
         needsProject: false,
-        needsConfig: false,
+        needsLoadedConfig: false,
         needsTaskContext: false,
     }),
     entry(prOpenSpec, (deps) => import("../../../commands/pr/pr.command.js").then((m) => m.makeRunPrOpenHandler(deps.getCtx))),

package/dist/cli/run-cli/command-catalog/shared.d.ts

@@ -8,12 +8,21 @@ export type RunDeps = {
     getLoadedConfig: (commandForErrorContext: string) => Promise<LoadedConfig>;
     getHelpJsonForDocs: () => readonly HelpJson[];
 };
+export type DispatchNeeds = {
+    project: boolean;
+    loadedConfig: boolean;
+    taskContext: boolean;
+};
 export type CommandEntry = {
     spec: CommandSpec<unknown>;
     load: (deps: RunDeps) => Promise<CommandHandler<unknown>>;
+    dispatch: DispatchNeeds;
+    invocation?: string;
+};
+export declare function entry<TParsed>(spec: CommandSpec<TParsed>, load: (deps: RunDeps) => Promise<CommandHandler<TParsed>>, meta?: Partial<{
     needsProject: boolean;
-    needsConfig: boolean;
+    needsLoadedConfig: boolean;
     needsTaskContext: boolean;
-};
-export declare function entry<TParsed>(spec: CommandSpec<TParsed>, load: (deps: RunDeps) => Promise<CommandHandler<TParsed>>, meta?: Partial<Pick<CommandEntry, "needsProject" | "needsConfig" | "needsTaskContext">>): CommandEntry;
+    invocation: string;
+}>): CommandEntry;
 //# sourceMappingURL=shared.d.ts.map

package/dist/cli/run-cli/command-catalog/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,KAAK,CAAC,OAAO,EAC3B,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EACzD,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,aAAa,GAAG,kBAAkB,CAAC,CAAC,GACtF,YAAY,CAQd"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE,kBAAkB,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACjF,eAAe,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3E,kBAAkB,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,KAAK,CAAC,OAAO,EAC3B,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,GACD,YAAY,CAWd"}

package/dist/cli/run-cli/command-catalog/shared.js

@@ -2,8 +2,11 @@ export function entry(spec, load, meta) {
     return {
         spec: spec,
         load: (deps) => load(deps),
-        needsProject: meta?.needsProject ?? true,
-        needsConfig: meta?.needsConfig ?? meta?.needsProject ?? true,
-        needsTaskContext: meta?.needsTaskContext ?? true,
+        dispatch: {
+            project: meta?.needsProject ?? true,
+            loadedConfig: meta?.needsLoadedConfig ?? meta?.needsProject ?? true,
+            taskContext: meta?.needsTaskContext ?? true,
+        },
+        invocation: meta?.invocation,
     };
 }

package/dist/cli/run-cli/command-catalog/task.d.ts

@@ -1,3 +1,3 @@
 import { type CommandEntry } from "./shared.js";
-export declare const TASK_COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
+export declare const TASK_COMMANDS: readonly [CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry, CommandEntry];
 //# sourceMappingURL=task.d.ts.map

package/dist/cli/run-cli/command-catalog/task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/task.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,ydAwKkB,CAAC"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/task.ts"],"names":[],"mappings":"AAgDA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,+oBAoPkB,CAAC"}