agentplane 0.3.11 → 0.3.13

package/dist/cli/exit-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAarD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAExD"}
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAcrD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAExD"}

package/dist/cli/exit-codes.js

@@ -6,6 +6,7 @@ const EXIT_CODE_BY_ERROR = {
     E_BACKEND: 6,
     E_NETWORK: 7,
     E_RUNTIME: 8,
+    E_HANDOFF: 9,
     E_INTERNAL: 1,
 };
 export function exitCodeForError(code) {

package/dist/cli/reason-codes.d.ts

@@ -1,4 +1,4 @@
-export type ReasonCodeCategory = "usage" | "reconcile" | "git" | "network" | "backend" | "validation";
+export type ReasonCodeCategory = "usage" | "reconcile" | "git" | "handoff" | "network" | "backend" | "validation";
 export type ReasonCodeMeta = {
     code: string;
     category: ReasonCodeCategory;

package/dist/cli/reason-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reason-codes.d.ts","sourceRoot":"","sources":["../../src/cli/reason-codes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,WAAW,GACX,KAAK,GACL,SAAS,GACT,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA2GF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAGtF"}
+{"version":3,"file":"reason-codes.d.ts","sourceRoot":"","sources":["../../src/cli/reason-codes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,WAAW,GACX,KAAK,GACL,SAAS,GACT,SAAS,GACT,SAAS,GACT,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAwHF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAGtF"}

package/dist/cli/reason-codes.js

@@ -47,6 +47,12 @@ const REASON_CODE_MAP = {
         summary: "command requires valid git repository context",
         action: "confirm repository root and tracked changes",
     },
+    integrate_base_checkout_required: {
+        code: "integrate_base_checkout_required",
+        category: "git",
+        summary: "integrate was launched from a task worktree instead of the registered base checkout",
+        action: "rerun integrate against the base checkout/worktree for the resolved base branch",
+    },
     git_task_commit_blocked: {
         code: "git_task_commit_blocked",
         category: "git",
@@ -77,6 +83,12 @@ const REASON_CODE_MAP = {
         summary: "a lint check in the pre-commit path blocked the commit",
         action: "run lint, fix the reported errors, and retry the commit",
     },
+    protected_base_integrate_handoff: {
+        code: "protected_base_integrate_handoff",
+        category: "handoff",
+        summary: "integrate intentionally stopped before mutating a protected base branch",
+        action: "inspect the persisted handoff route, merge the GitHub PR, then pull the base branch after hosted close finishes",
+    },
     network_gate: {
         code: "network_gate",
         category: "network",

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

@@ -1,3 +1,3 @@
 import { type CommandEntry } from "./shared.js";
-export declare const CORE_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];
+export declare const CORE_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];
 //# sourceMappingURL=core.d.ts.map

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":"AAgCA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,qYAiOkB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/core.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,aAAa,6bA6PkB,CAAC"}

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

@@ -8,11 +8,12 @@ import { workflowRestoreSpec } from "../../../commands/workflow-restore.command.
 import { incidentsAdviseSpec } from "../../../commands/incidents/advise.command.js";
 import { incidentsCollectSpec } from "../../../commands/incidents/collect.command.js";
 import { incidentsSpec } from "../../../commands/incidents/incidents.command.js";
-import { releaseApplySpec } from "../../../commands/release/apply.command.js";
+import { releaseApplySpec, releaseCandidateSpec } 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 } from "../commands/core/agents.js";
+import { codexPluginInstallSpec, codexPluginSpec, codexSpec } from "../commands/codex.js";
 import { preflightSpec } from "../commands/core/preflight.js";
 import { quickstartSpec } from "../commands/core/quickstart.js";
 import { roleSpec } from "../commands/core/role.js";
@@ -47,6 +48,11 @@ export const CORE_COMMANDS = [
         needsLoadedConfig: false,
         needsTaskContext: false,
     }),
+    entry(releaseCandidateSpec, () => import("../../../commands/release/apply.command.js").then((m) => m.runReleaseCandidate), {
+        needsProject: true,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
     entry(quickstartSpec, () => import("../commands/core/quickstart.js").then((m) => m.runQuickstart), {
         needsProject: false,
         needsLoadedConfig: false,
@@ -59,6 +65,21 @@ export const CORE_COMMANDS = [
         needsTaskContext: false,
         invocation: requireCanonicalCommandInvocation(["preflight"]),
     }),
+    entry(codexSpec, () => import("../commands/codex.js").then((m) => m.runCodex), {
+        needsProject: false,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(codexPluginSpec, () => import("../commands/codex.js").then((m) => m.runCodexPlugin), {
+        needsProject: false,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
+    entry(codexPluginInstallSpec, (deps) => import("../commands/codex.js").then((m) => m.makeRunCodexPluginInstallHandler(deps)), {
+        needsProject: false,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
     entry(runtimeSpec, () => import("../../../commands/runtime.command.js").then((m) => m.runRuntime), {
         needsProject: false,
         needsLoadedConfig: false,

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, 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, 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":"AA0CA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,gBAAgB,qfA8Je,CAAC"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/command-catalog/project.ts"],"names":[],"mappings":"AA6CA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvD,eAAO,MAAM,gBAAgB,+hBAyLe,CAAC"}

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

@@ -6,8 +6,10 @@ import { branchStatusSpec } from "../../../commands/branch/status.command.js";
 import { workStartSpec } from "../../../commands/branch/work-start.command.js";
 import { integrateSpec } from "../../../commands/integrate.command.js";
 import { prCheckSpec, prCloseSpec, prCloseSupersededSpec, prNoteSpec, prOpenSpec, prSpec, prUpdateSpec, } from "../../../commands/pr/pr.command.js";
+import { recipesAddSpec } from "../../../commands/recipes/add.command.js";
 import { recipesCachePruneSpec } from "../../../commands/recipes/cache-prune.command.js";
 import { recipesCacheSpec } from "../../../commands/recipes/cache.command.js";
+import { recipesDetachSpec } from "../../../commands/recipes/detach.command.js";
 import { recipesExplainSpec } from "../../../commands/recipes/explain.command.js";
 import { recipesInfoSpec } from "../../../commands/recipes/info.command.js";
 import { recipesInstallSpec } from "../../../commands/recipes/install.spec.js";
@@ -15,6 +17,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 { recipesUpdateSpec } from "../../../commands/recipes/update.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";
@@ -33,13 +36,28 @@ export const PROJECT_COMMANDS = [
         needsLoadedConfig: false,
         needsTaskContext: false,
     }),
-    entry(recipesListSpec, () => import("../../../commands/recipes/list.command.js").then((m) => m.runRecipesList)),
+    entry(recipesAddSpec, () => import("../../../commands/recipes/add.command.js").then((m) => m.runRecipesAdd)),
+    entry(recipesListSpec, () => import("../../../commands/recipes/list.command.js").then((m) => m.runRecipesList), {
+        needsProject: false,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
     entry(recipesListRemoteSpec, () => import("../../../commands/recipes/list-remote.command.js").then((m) => m.runRecipesListRemote)),
-    entry(recipesInfoSpec, () => import("../../../commands/recipes/info.command.js").then((m) => m.runRecipesInfo)),
+    entry(recipesInfoSpec, () => import("../../../commands/recipes/info.command.js").then((m) => m.runRecipesInfo), {
+        needsProject: false,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
     entry(recipesExplainSpec, () => import("../../../commands/recipes/explain.command.js").then((m) => m.runRecipesExplain)),
     entry(recipesRemoveSpec, () => import("../../../commands/recipes/remove.command.js").then((m) => m.runRecipesRemove)),
+    entry(recipesUpdateSpec, () => import("../../../commands/recipes/update.command.js").then((m) => m.runRecipesUpdate)),
+    entry(recipesDetachSpec, () => import("../../../commands/recipes/detach.command.js").then((m) => m.runRecipesDetach)),
     entry(recipesCachePruneSpec, () => import("../../../commands/recipes/cache-prune.command.js").then((m) => m.runRecipesCachePrune)),
-    entry(recipesInstallSpec, () => import("../../../commands/recipes/install.run.js").then((m) => m.runRecipesInstall)),
+    entry(recipesInstallSpec, () => import("../../../commands/recipes/install.run.js").then((m) => m.runRecipesInstall), {
+        needsProject: false,
+        needsLoadedConfig: false,
+        needsTaskContext: false,
+    }),
     entry(scenarioSpec, () => import("../../../commands/scenario/scenario.command.js").then((m) => m.runScenario), {
         needsProject: false,
         needsLoadedConfig: false,

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

@@ -1,7 +1,7 @@
 import type { CommandId } from "../spec/spec.js";
 import type { CommandEntry } from "./command-catalog/shared.js";
 export type { CommandEntry, RunDeps } from "./command-catalog/shared.js";
-export declare const 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, 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, 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];
+export declare const 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, 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, 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];
 export type CatalogMatch = {
     entry: (typeof COMMANDS)[number];
     consumed: number;

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

@@ -1 +1 @@
-{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAOhE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEzE,eAAO,MAAM,QAAQ,2wDAKuB,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAYlF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,GAAG,IAAI,CAGlF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,CAEnE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,GAAE,SAAc,GAAG,SAAS,YAAY,EAAE,CAE9F;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,SAAc,GAAG,SAAS,MAAM,EAAE,CAEtF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAM1D"}
+{"version":3,"file":"command-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/run-cli/command-catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAOhE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEzE,eAAO,MAAM,QAAQ,62DAKuB,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAYlF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,GAAG,IAAI,CAGlF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,CAEnE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,GAAE,SAAc,GAAG,SAAS,YAAY,EAAE,CAE9F;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,GAAE,SAAc,GAAG,SAAS,MAAM,EAAE,CAEtF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,CAM1D"}

package/dist/cli/run-cli/commands/codex.d.ts

@@ -0,0 +1,14 @@
+import { type GroupCommandParsed } from "../../group-command.js";
+import type { CommandHandler, CommandSpec } from "../../spec/spec.js";
+import { type CodexPluginInstallScope } from "../../../commands/codex/plugin-install.js";
+import type { RunDeps } from "../command-catalog.js";
+export type CodexPluginInstallParsed = {
+    scope: CodexPluginInstallScope;
+};
+export declare const codexSpec: CommandSpec<GroupCommandParsed>;
+export declare const codexPluginSpec: CommandSpec<GroupCommandParsed>;
+export declare const codexPluginInstallSpec: CommandSpec<CodexPluginInstallParsed>;
+export declare const runCodex: CommandHandler<GroupCommandParsed>;
+export declare const runCodexPlugin: CommandHandler<GroupCommandParsed>;
+export declare function makeRunCodexPluginInstallHandler(deps: RunDeps): CommandHandler<CodexPluginInstallParsed>;
+//# sourceMappingURL=codex.d.ts.map

package/dist/cli/run-cli/commands/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMrD,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,kBAAkB,CAOrD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,kBAAkB,CAO3D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,wBAAwB,CAgCxE,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,kBAAkB,CASvD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,kBAAkB,CAS7D,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,OAAO,GACZ,cAAc,CAAC,wBAAwB,CAAC,CAkC1C"}

package/dist/cli/run-cli/commands/codex.js

@@ -0,0 +1,100 @@
+import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../group-command.js";
+import { createCliEmitter } from "../../output.js";
+import { installBundledCodexPlugin, resolveCodexInstallRoot, } from "../../../commands/codex/plugin-install.js";
+import { wrapCommand } from "./wrap-command.js";
+const output = createCliEmitter();
+export const codexSpec = {
+    id: ["codex"],
+    group: "Codex",
+    summary: "Codex integration commands.",
+    synopsis: ["agentplane codex <subcommand> [options]"],
+    args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
+    parse: (raw) => parseGroupCommand(raw, "subcommand"),
+};
+export const codexPluginSpec = {
+    id: ["codex", "plugin"],
+    group: "Codex",
+    summary: "Install and inspect bundled Codex plugin integrations.",
+    synopsis: ["agentplane codex plugin <subcommand> [options]"],
+    args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
+    parse: (raw) => parseGroupCommand(raw, "subcommand"),
+};
+export const codexPluginInstallSpec = {
+    id: ["codex", "plugin", "install"],
+    group: "Codex",
+    summary: "Install the bundled AgentPlane plugin into a local Codex marketplace.",
+    options: [
+        {
+            kind: "string",
+            name: "scope",
+            valueHint: "<user|repo>",
+            choices: ["user", "repo"],
+            default: "user",
+            description: "Install to the user home marketplace or the current repository marketplace.",
+        },
+    ],
+    examples: [
+        {
+            cmd: "agentplane codex plugin install",
+            why: "Install AgentPlane into the user-local Codex marketplace under ~/.agents/plugins.",
+        },
+        {
+            cmd: "agentplane codex plugin install --scope repo",
+            why: "Install AgentPlane into the current repository marketplace for local testing.",
+        },
+    ],
+    notes: [
+        "User scope writes `~/plugins/agentplane` plus `~/.agents/plugins/marketplace.json` by default.",
+        "Repo scope writes `<repo>/plugins/agentplane` plus `<repo>/.agents/plugins/marketplace.json`.",
+        "OpenAI's public self-serve Plugin Directory is not available yet; local marketplaces are the supported route today.",
+    ],
+    parse: (raw) => ({
+        scope: raw.opts.scope ?? "user",
+    }),
+};
+export const runCodex = async (_ctx, p) => {
+    throwGroupCommandUsage({
+        spec: codexSpec,
+        cmd: p.cmd,
+        subcommands: await loadDirectSubcommandNames(["codex"]),
+        command: "codex",
+        missingMessage: "Missing Codex subcommand.",
+        unknownMessage: (subcommand) => `Unknown Codex subcommand: ${subcommand}.`,
+    });
+};
+export const runCodexPlugin = async (_ctx, p) => {
+    throwGroupCommandUsage({
+        spec: codexPluginSpec,
+        cmd: p.cmd,
+        subcommands: await loadDirectSubcommandNames(["codex", "plugin"]),
+        command: "codex plugin",
+        missingMessage: "Missing Codex plugin subcommand.",
+        unknownMessage: (subcommand) => `Unknown Codex plugin subcommand: ${subcommand}.`,
+    });
+};
+export function makeRunCodexPluginInstallHandler(deps) {
+    return async (ctx, p) => wrapCommand({ command: "codex plugin install", rootOverride: ctx.rootOverride }, async () => {
+        const resolvedProject = p.scope === "repo" ? await deps.getResolvedProject("codex plugin install") : null;
+        const installRoot = p.scope === "repo"
+            ? resolveCodexInstallRoot({
+                scope: "repo",
+                repoRoot: resolvedProject?.gitRoot,
+            })
+            : resolveCodexInstallRoot({ scope: "user" });
+        const result = await installBundledCodexPlugin({
+            scope: p.scope,
+            installRoot,
+        });
+        output.report([
+            { label: "Scope", value: result.scope },
+            { label: "Install root", value: result.installRoot },
+            { label: "Plugin root", value: result.pluginRoot },
+            { label: "Manifest", value: result.manifestPath },
+            { label: "Marketplace", value: result.marketplacePath },
+        ], { header: "Installed Codex plugin" });
+        output.line(p.scope === "repo"
+            ? "Next: open Codex in this repository and install AgentPlane from the repo marketplace."
+            : "Next: open Codex, open Plugins, and install AgentPlane from the local marketplace.");
+        return 0;
+    });
+}

package/dist/cli/run-cli/commands/core.d.ts

@@ -1,4 +1,5 @@
 export { agentsSpec, makeRunAgentsHandler } from "./core/agents.js";
+export { codexPluginInstallSpec, codexPluginSpec, codexSpec, makeRunCodexPluginInstallHandler, runCodex, runCodexPlugin, } from "./codex.js";
 export { preflightSpec, runPreflight } from "./core/preflight.js";
 export { quickstartSpec, runQuickstart } from "./core/quickstart.js";
 export { roleSpec, runRole } from "./core/role.js";

package/dist/cli/run-cli/commands/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,gCAAgC,EAChC,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/cli/run-cli/commands/core.js

@@ -1,4 +1,5 @@
 export { agentsSpec, makeRunAgentsHandler } from "./core/agents.js";
+export { codexPluginInstallSpec, codexPluginSpec, codexSpec, makeRunCodexPluginInstallHandler, runCodex, runCodexPlugin, } from "./codex.js";
 export { preflightSpec, runPreflight } from "./core/preflight.js";
 export { quickstartSpec, runQuickstart } from "./core/quickstart.js";
 export { roleSpec, runRole } from "./core/role.js";

package/dist/cli/run-cli/commands/init/recipes.d.ts

@@ -1,4 +1,12 @@
-export declare function maybeInstallBundledRecipes(opts: {
+export type CachedRecipeInfo = {
+    id: string;
+    summary: string;
+    version: string;
+};
+export declare function listCachedRecipes(): Promise<CachedRecipeInfo[]>;
+export declare function renderCachedRecipesHint(recipes: CachedRecipeInfo[]): string;
+export declare function validateCachedRecipesSelection(recipes: string[]): Promise<void>;
+export declare function maybeAddCachedRecipes(opts: {
     recipes: string[];
     cwd: string;
     rootOverride?: string;

package/dist/cli/run-cli/commands/init/recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/recipes.ts"],"names":[],"mappings":"AAKA,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BhB"}
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../../../../../src/cli/run-cli/commands/init/recipes.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAOrE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAK3E;AAED,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB"}

package/dist/cli/run-cli/commands/init/recipes.js

@@ -1,31 +1,41 @@
-import { cmdRecipeInstall } from "../../../../commands/recipes.js";
-import { infoMessage } from "../../../output.js";
-import { getBundledRecipeSourcePath, listBundledRecipes } from "../../../recipes-bundled.js";
+import { cmdRecipeAddParsed, readInstalledRecipesFile, resolveInstalledRecipesPath, } from "../../../../commands/recipes.js";
 import { CliError } from "../../../../shared/errors.js";
-export async function maybeInstallBundledRecipes(opts) {
-    if (opts.recipes.length === 0)
+export async function listCachedRecipes() {
+    const cached = await readInstalledRecipesFile(resolveInstalledRecipesPath());
+    return cached.recipes.map((recipe) => ({
+        id: recipe.id,
+        summary: recipe.manifest.summary,
+        version: recipe.version,
+    }));
+}
+export function renderCachedRecipesHint(recipes) {
+    if (recipes.length === 0) {
+        return "Cached recipes: none. Use `agentplane recipes install <id>` before selecting recipes during init.";
+    }
+    return `Cached recipes: ${recipes.map((entry) => entry.id).join(", ")}`;
+}
+export async function validateCachedRecipesSelection(recipes) {
+    if (recipes.length === 0)
         return;
-    if (listBundledRecipes().length === 0) {
-        process.stdout.write(`${infoMessage("bundled recipes are empty; nothing to install")}\n`);
+    const cached = await listCachedRecipes();
+    const available = new Set(cached.map((entry) => entry.id));
+    const missing = recipes.filter((recipe) => !available.has(recipe));
+    if (missing.length === 0)
+        return;
+    throw new CliError({
+        exitCode: 2,
+        code: "E_USAGE",
+        message: `Unknown cached recipe id(s): ${missing.join(", ")}. ${renderCachedRecipesHint(cached)}`,
+    });
+}
+export async function maybeAddCachedRecipes(opts) {
+    if (opts.recipes.length === 0)
         return;
-    }
     for (const recipeId of opts.recipes) {
-        const sourcePath = getBundledRecipeSourcePath(recipeId);
-        if (!sourcePath) {
-            throw new CliError({
-                exitCode: 3,
-                code: "E_VALIDATION",
-                message: `Bundled recipe ${recipeId} is missing source_path in bundled catalog`,
-            });
-        }
-        await cmdRecipeInstall({
+        await cmdRecipeAddParsed({
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,
-            source: { type: "path", value: sourcePath },
-            index: undefined,
-            refresh: false,
-            onConflict: "overwrite",
-            yes: true,
+            recipeRef: recipeId,
         });
     }
 }

package/dist/cli/run-cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAc7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,KAAK,SAAS,GAAG;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAoF9D,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAyM5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/run-cli/commands/init.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAa7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAG7E,KAAK,SAAS,GAAG;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,KAAK,kBAAkB,GAAG,OAAO,GAAG,QAAQ,GAAG,cAAc,CAAC;AAoF9D,KAAK,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,UAAU,CAyM5C,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,UAAU,CACmB,CAAC"}

package/dist/cli/run-cli/commands/init.js

@@ -2,7 +2,7 @@ import path from "node:path";
 import { mapCoreError } from "../../error-map.js";
 import { promptChoice, promptInput, promptYesNo } from "../../prompts.js";
 import { invalidValueForFlag } from "../../output.js";
-import { renderBundledRecipesHint, validateBundledRecipesSelection, } from "../../recipes-bundled.js";
+import { listCachedRecipes, maybeAddCachedRecipes, renderCachedRecipesHint, validateCachedRecipesSelection, } from "./init/recipes.js";
 import { usageError } from "../../spec/errors.js";
 import { CliError } from "../../../shared/errors.js";
 import { getVersion } from "../../../meta/version.js";
@@ -12,7 +12,6 @@ import { resolveInitBaseBranchForInit } from "./init/base-branch.js";
 import { collectInitConflicts, handleInitConflicts } from "./init/conflicts.js";
 import { ensureGitRoot } from "./init/git.js";
 import { maybeSyncIde } from "./init/ide-sync.js";
-import { maybeInstallBundledRecipes } from "./init/recipes.js";
 import { ensureInitWorkflow } from "./init/write-workflow.js";
 import { ensureAgentplaneDirs, writeBackendStubs, writeInitConfig } from "./init/write-config.js";
 import { ensureAgentsFiles } from "./init/write-agents.js";
@@ -186,7 +185,7 @@ export const initSpec = {
             kind: "string",
             name: "recipes",
             valueHint: "<none|id1,id2,...>",
-            description: "Optional bundled recipes selection (comma-separated), or 'none'.",
+            description: "Optional cached recipes to vendor during init (comma-separated), or 'none'.",
         },
         {
             kind: "boolean",
@@ -407,25 +406,31 @@ async function cmdInit(opts) {
             if (flags.requireNetworkApproval === undefined) {
                 requireNetworkApproval = await askYesNo("Require explicit approval for network actions?", requireNetworkApproval);
             }
-            process.stdout.write(renderInitSection("Recipes", "Optional: install recipe packs now (comma-separated IDs) or choose none."));
+            process.stdout.write(renderInitSection("Recipes", "Optional: materialize cached recipes now (comma-separated IDs) or choose none."));
             if (!flags.recipes) {
-                process.stdout.write(`${renderBundledRecipesHint()}\n`);
-                const defaultRecipesLabel = selectedPreset.defaultRecipes.length > 0
-                    ? selectedPreset.defaultRecipes.join(", ")
-                    : "none";
-                const answer = await askInput(`Install optional recipes (comma separated, or none) [default: ${defaultRecipesLabel}]: `);
-                const normalized = answer.trim().toLowerCase();
-                if (normalized === "") {
-                    recipes = [...selectedPreset.defaultRecipes];
-                }
-                else if (normalized === "none") {
+                const cachedRecipes = await listCachedRecipes();
+                process.stdout.write(`${renderCachedRecipesHint(cachedRecipes)}\n`);
+                if (cachedRecipes.length === 0) {
                     recipes = [];
                 }
                 else {
-                    recipes = answer
-                        .split(",")
-                        .map((item) => item.trim())
-                        .filter(Boolean);
+                    const defaultRecipesLabel = selectedPreset.defaultRecipes.length > 0
+                        ? selectedPreset.defaultRecipes.join(", ")
+                        : "none";
+                    const answer = await askInput(`Materialize cached recipes (comma separated, or none) [default: ${defaultRecipesLabel}]: `);
+                    const normalized = answer.trim().toLowerCase();
+                    if (normalized === "") {
+                        recipes = [...selectedPreset.defaultRecipes];
+                    }
+                    else if (normalized === "none") {
+                        recipes = [];
+                    }
+                    else {
+                        recipes = answer
+                            .split(",")
+                            .map((item) => item.trim())
+                            .filter(Boolean);
+                    }
                 }
             }
         }
@@ -438,7 +443,7 @@ async function cmdInit(opts) {
                 flags.requireVerifyApproval ?? selectedPreset.defaultRequireVerifyApproval;
             executionProfile = flags.executionProfile ?? selectedPreset.defaultExecutionProfile;
             strictUnsafeConfirm = flags.strictUnsafeConfirm ?? selectedPreset.defaultStrictUnsafeConfirm;
-            process.stdout.write(renderInitSection("Defaults Applied", `Using compact ${setupProfilePreset} defaults for approvals, execution profile, and recipes. Hooks: ${hooks ? "enabled" : "disabled"}.`));
+            process.stdout.write(renderInitSection("Defaults Applied", `Using compact ${setupProfilePreset} defaults for approvals, execution profile, and cached recipe selection. Hooks: ${hooks ? "enabled" : "disabled"}.`));
         }
     }
     if (flags.yes) {
@@ -456,7 +461,7 @@ async function cmdInit(opts) {
         executionProfile = flags.executionProfile ?? yesPreset.defaultExecutionProfile;
         strictUnsafeConfirm = flags.strictUnsafeConfirm ?? yesPreset.defaultStrictUnsafeConfirm;
     }
-    validateBundledRecipesSelection(recipes);
+    await validateCachedRecipesSelection(recipes);
     try {
         const initRoot = path.resolve(opts.rootOverride ?? opts.cwd);
         const baseBranchFallback = "main";
@@ -566,7 +571,7 @@ async function cmdInit(opts) {
             gitRoot: resolved.gitRoot,
         });
         installPaths.push(...ideRes.installPaths);
-        await maybeInstallBundledRecipes({
+        await maybeAddCachedRecipes({
             recipes,
             cwd: opts.cwd,
             rootOverride: opts.rootOverride,

package/dist/cli/run-cli/error-guidance.js

@@ -83,6 +83,16 @@ function resolveErrorGuidance(err) {
             });
         }
         case "E_GIT": {
+            if (reasonCode === "integrate_base_checkout_required") {
+                return withExplicit({
+                    hint: "Integrate must run from the base checkout, not from the task branch worktree.",
+                    nextAction: {
+                        command: "git worktree list",
+                        reason: "locate the registered base checkout if the rerun command is not already provided",
+                        reasonCode,
+                    },
+                });
+            }
             if (reasonCode === "reconcile_git_state_unreadable") {
                 return withExplicit({
                     hint: "Reconcile check could not read git state.",
@@ -122,6 +132,16 @@ function resolveErrorGuidance(err) {
                 },
             });
         }
+        case "E_HANDOFF": {
+            return withExplicit({
+                hint: "This is an intentional handoff route, not a local mutation failure.",
+                nextAction: {
+                    command: command === "integrate" ? "agentplane task handoff show <task-id>" : usage,
+                    reason: "inspect the persisted finalize route and continue through the external handoff path",
+                    reasonCode: "protected_base_integrate_handoff",
+                },
+            });
+        }
         case "E_NETWORK": {
             return withExplicit({
                 hint: "Check network access and credentials.",

package/dist/cli/run-cli.test-helpers.d.ts

@@ -70,5 +70,6 @@ export declare function cleanGitEnv(): NodeJS.ProcessEnv;
 export declare function pathExists(filePath: string): Promise<boolean>;
 export declare function gitBranchExists(root: string, branch: string): Promise<boolean>;
 export declare function commitAll(root: string, message: string): Promise<void>;
+export declare function commitPathsIfChanged(root: string, paths: string[], message: string): Promise<boolean>;
 export declare function stageGitignoreIfPresent(root: string): Promise<void>;
 //# sourceMappingURL=run-cli.test-helpers.d.ts.map

package/dist/cli/run-cli.test-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-cli.test-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.test-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-cli.test-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/run-cli.test-helpers.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAsD/D,wBAAgB,sBAAsB,IAAI,IAAI,CAuD7C;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAYtD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD;AAED,wBAAgB,YAAY;;;;EAgC3B;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMvD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAExE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACA,IAAI,CAYN;AAED,wBAAgB,YAAY,IAAI,MAAM,IAAI,CAkBzC;AAED,wBAAgB,eAAe,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAsBjF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAOlE;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAMrD;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAIjD;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAI7D;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBjF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBtF;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhE;AAED,wBAAsB,mBAAmB,CAAC,IAAI,CAAC,EAAE;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAsKtE;AAED,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlB;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiHlB;AA6DD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAqDD;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAgB/C;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYpF;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE"}