agentplane 0.3.12 → 0.3.13

package/dist/commands/recipes.test-helpers.js

@@ -1,21 +1,24 @@
 import { generateKeyPairSync, sign } from "node:crypto";
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { afterEach, beforeEach, vi } from "vitest";
-import { cmdRecipeCachePruneParsed, cmdRecipeExplainParsed, cmdRecipeInfoParsed, cmdRecipeInstall, cmdRecipeListParsed, cmdRecipeListRemoteParsed, cmdRecipeRemoveParsed, } from "./recipes.js";
+import { cmdRecipeAddParsed, cmdRecipeCachePruneParsed, cmdRecipeDetachParsed, cmdRecipeExplainParsed, cmdRecipeInfoParsed, cmdRecipeInstall, cmdRecipeListParsed, cmdRecipeListRemoteParsed, cmdRecipeRemoveParsed, cmdRecipeUpdateParsed, hashRecipeTree, } from "./recipes.js";
 import { cmdScenarioInfoParsed, cmdScenarioListParsed, cmdScenarioRunParsed } from "./scenario.js";
 import { exitCodeForError } from "../cli/exit-codes.js";
 import { parseCommandArgv } from "../cli/spec/parse.js";
 import { captureStdIO, createRecipeArchive, mkGitRepoRoot, writeDefaultConfig, } from "../cli/run-cli.test-helpers.js";
 import { CliError } from "../shared/errors.js";
 import { recipesCachePruneSpec } from "./recipes/cache-prune.command.js";
+import { recipesAddSpec } from "./recipes/add.command.js";
 import { recipesExplainSpec } from "./recipes/explain.command.js";
 import { recipesInfoSpec } from "./recipes/info.command.js";
 import { recipesInstallSpec } from "./recipes/install.spec.js";
 import { recipesListRemoteSpec } from "./recipes/list-remote.command.js";
 import { recipesListSpec } from "./recipes/list.command.js";
+import { recipesDetachSpec } from "./recipes/detach.command.js";
 import { recipesRemoveSpec } from "./recipes/remove.command.js";
+import { recipesUpdateSpec } from "./recipes/update.command.js";
 import { scenarioInfoSpec } from "./scenario/info.command.js";
 import { scenarioListSpec } from "./scenario/list.command.js";
 import { scenarioRunSpec } from "./scenario/run.command.js";
@@ -73,16 +76,25 @@ export async function writeSignedIndex(indexPath, payload) {
     await writeFile(`${indexPath}.sig`, JSON.stringify(signature, null, 2), "utf8");
 }
 export function resolveProjectRecipeDir(projectDir, recipeId) {
-    return path.join(projectDir, ".agentplane", "recipes", recipeId);
+    return path.join(projectDir, ".agentplane", "recipes", "packages", recipeId);
+}
+export function resolveProjectRecipesRegistryPath(projectDir) {
+    return path.join(projectDir, ".agentplane", "recipes", "registry.json");
 }
 function readStringFixtureValue(record, key, fallback) {
     const value = record[key];
     return typeof value === "string" ? value : fallback;
 }
 export async function writeInstalledRecipes(projectDir, recipes) {
-    const recipesDir = path.join(projectDir, ".agentplane", "recipes");
+    const recipesHome = requireRecipesTempHome();
+    const recipesDir = path.join(recipesHome, "recipes-store");
     await rm(recipesDir, { recursive: true, force: true });
     await mkdir(recipesDir, { recursive: true });
+    const vendoredRecipesDir = path.join(projectDir, ".agentplane", "recipes", "packages");
+    await rm(vendoredRecipesDir, { recursive: true, force: true });
+    await mkdir(vendoredRecipesDir, { recursive: true });
+    const cachedEntries = [];
+    const registryEntries = [];
     for (const entry of recipes) {
         const record = entry;
         const manifest = record.manifest;
@@ -95,18 +107,20 @@ export async function writeInstalledRecipes(projectDir, recipes) {
             : Array.isArray(manifest.tags)
                 ? manifest.tags
                 : [];
-        const recipeDir = resolveProjectRecipeDir(projectDir, recipeId);
+        const recipeDir = path.join(recipesDir, recipeId, recipeVersion);
         await mkdir(recipeDir, { recursive: true });
         await writeFile(path.join(recipeDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
-        await writeFile(path.join(recipeDir, ".install.json"), JSON.stringify({
-            schema_version: 1,
+        const vendoredRecipeDir = resolveProjectRecipeDir(projectDir, recipeId);
+        await mkdir(vendoredRecipeDir, { recursive: true });
+        await writeFile(path.join(vendoredRecipeDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
+        cachedEntries.push({
             id: recipeId,
             version: recipeVersion,
             source,
             installed_at: installedAt,
             tags,
-            install_mode: "project-local",
-        }, null, 2), "utf8");
+            manifest,
+        });
         const scenarios = Array.isArray(manifest.scenarios)
             ? manifest.scenarios.filter((scenario) => !!scenario && typeof scenario === "object")
             : [];
@@ -124,8 +138,10 @@ export async function writeInstalledRecipes(projectDir, recipes) {
                 ? scenario.required_inputs.filter((entry) => typeof entry === "string")
                 : [];
             const scenarioPath = path.join(recipeDir, scenarioFile);
+            const vendoredScenarioPath = path.join(vendoredRecipeDir, scenarioFile);
             await mkdir(path.dirname(scenarioPath), { recursive: true });
-            await writeFile(scenarioPath, JSON.stringify({
+            await mkdir(path.dirname(vendoredScenarioPath), { recursive: true });
+            const scenarioPayload = JSON.stringify({
                 schema_version: "1",
                 id: scenarioId,
                 summary: scenarioSummary,
@@ -138,9 +154,44 @@ export async function writeInstalledRecipes(projectDir, recipes) {
                 inputs: scenarioInputs.map((name) => ({ name, type: "string" })),
                 outputs: scenarioOutputs.map((name) => ({ name, type: "string" })),
                 steps: [],
-            }, null, 2), "utf8");
+            }, null, 2);
+            await writeFile(scenarioPath, scenarioPayload, "utf8");
+            await writeFile(vendoredScenarioPath, scenarioPayload, "utf8");
+        }
+        const tools = Array.isArray(manifest.tools)
+            ? manifest.tools.filter((tool) => !!tool && typeof tool === "object")
+            : [];
+        for (const tool of tools) {
+            const entrypoint = readStringFixtureValue(tool, "entrypoint", "").trim();
+            if (!entrypoint)
+                continue;
+            const toolSource = "console.log('ok');\n";
+            const toolPath = path.join(recipeDir, entrypoint);
+            const vendoredToolPath = path.join(vendoredRecipeDir, entrypoint);
+            await mkdir(path.dirname(toolPath), { recursive: true });
+            await mkdir(path.dirname(vendoredToolPath), { recursive: true });
+            await writeFile(toolPath, toolSource, "utf8");
+            await writeFile(vendoredToolPath, toolSource, "utf8");
         }
+        registryEntries.push({
+            id: recipeId,
+            version: recipeVersion,
+            path: `packages/${recipeId}`,
+            active: false,
+            materialization: "copy",
+            source_ref: source,
+            source_sha256: await hashRecipeTree(recipeDir),
+            vendored_sha256: await hashRecipeTree(vendoredRecipeDir),
+            installed_at: installedAt,
+            tags,
+        });
     }
+    await writeInstalledRecipesRegistry(cachedEntries);
+    await writeFile(resolveProjectRecipesRegistryPath(projectDir), JSON.stringify({
+        schema_version: 1,
+        updated_at: "2026-02-05T00:00:00Z",
+        recipes: registryEntries,
+    }, null, 2), "utf8");
 }
 export async function writeInstalledRecipesRegistry(recipes) {
     const recipesHome = requireRecipesTempHome();
@@ -155,8 +206,7 @@ export function skillEntry(overrides) {
     return {
         id: "RECIPE_SKILL",
         summary: "Recipe skill",
-        kind: "agent-skill",
-        file: "skills/recipe.json",
+        file: "skills/recipe.md",
         ...overrides,
     };
 }
@@ -177,7 +227,7 @@ export function agentEntry(overrides) {
         summary: "Recipe agent",
         skills: ["RECIPE_SKILL"],
         tools: ["RECIPE_TOOL"],
-        file: "agents/recipe.json",
+        file: "agents/recipe.md",
         ...overrides,
     };
 }
@@ -247,6 +297,20 @@ export async function installRecipe(opts) {
             command: "install",
             args: ["--path", archivePath],
         });
+        if (opts.vendor ?? true) {
+            const recipesHome = process.env.AGENTPLANE_HOME?.trim() ?? requireRecipesTempHome();
+            const installed = JSON.parse(await readFile(path.join(recipesHome, "recipes.json"), "utf8"));
+            const latest = installed.recipes?.at(-1);
+            if (!latest)
+                throw new Error("cached recipe registry unexpectedly empty after install");
+            await runRecipesTest({
+                cwd: opts.projectDir,
+                command: "add",
+                args: opts.mode
+                    ? [`${latest.id}@${latest.version}`, "--mode", opts.mode]
+                    : [`${latest.id}@${latest.version}`],
+            });
+        }
     }
     finally {
         io.restore();
@@ -271,7 +335,7 @@ export async function createInstalledRecipeProject(opts = {}) {
     };
 }
 export function resolveInstalledScenarioPath(projectDir, recipeId, scenarioFile = path.join("scenarios", "recipe-scenario.json")) {
-    return path.join(projectDir, ".agentplane", "recipes", recipeId, scenarioFile);
+    return path.join(projectDir, ".agentplane", "recipes", "packages", recipeId, scenarioFile);
 }
 export async function runRecipesTest(opts) {
     if (!opts.command) {
@@ -318,6 +382,15 @@ export async function runRecipesTest(opts) {
             const parsed = parseCommandArgv(recipesInstallSpec, opts.args).parsed;
             return await cmdRecipeInstall({ cwd: opts.cwd, rootOverride: opts.rootOverride, ...parsed });
         }
+        case "add": {
+            const parsed = parseCommandArgv(recipesAddSpec, opts.args).parsed;
+            return await cmdRecipeAddParsed({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                recipeRef: parsed.recipeRef,
+                mode: parsed.mode,
+            });
+        }
         case "remove": {
             const parsed = parseCommandArgv(recipesRemoveSpec, opts.args).parsed;
             return await cmdRecipeRemoveParsed({
@@ -326,6 +399,23 @@ export async function runRecipesTest(opts) {
                 id: parsed.id,
             });
         }
+        case "update": {
+            const parsed = parseCommandArgv(recipesUpdateSpec, opts.args).parsed;
+            return await cmdRecipeUpdateParsed({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                id: parsed.id,
+                force: parsed.force,
+            });
+        }
+        case "detach": {
+            const parsed = parseCommandArgv(recipesDetachSpec, opts.args).parsed;
+            return await cmdRecipeDetachParsed({
+                cwd: opts.cwd,
+                rootOverride: opts.rootOverride,
+                id: parsed.id,
+            });
+        }
         case "cache": {
             const [sub, ...tail] = opts.args;
             if (sub !== "prune") {

package/dist/commands/scenario/execute.command.js

@@ -10,14 +10,14 @@ import { cmdTaskStartReady } from "../task/start-ready.js";
 import { CliError } from "../../shared/errors.js";
 const output = createCliEmitter();
 export const scenarioExecuteSpec = {
-    id: ["scenario", "execute"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "execute"],
+    group: "Recipes",
     summary: "Materialize a recipe-backed task and execute it through the shared runner flow.",
     description: "Resolves a recipe scenario, materializes a task from its explicit task_template, and executes the shared runner with recipe context bundled alongside the created task.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario execute viewer:demo",
+            cmd: "agentplane recipes scenario execute viewer:demo",
             why: "Create a task from the scenario template and execute it through the configured runner.",
         },
     ],
@@ -27,7 +27,7 @@ export const scenarioExecuteSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioExecuteSpec,
-                command: "scenario execute",
+                command: "recipes scenario execute",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/impl/commands.js

@@ -187,7 +187,7 @@ export async function cmdScenarioListParsed(opts) {
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario list", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario list", root: opts.rootOverride ?? null });
     }
 }
 export async function cmdScenarioInfoParsed(opts) {
@@ -225,7 +225,7 @@ export async function cmdScenarioInfoParsed(opts) {
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario info", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario info", root: opts.rootOverride ?? null });
     }
 }
 export async function executeRecipeTool(opts) {
@@ -297,13 +297,13 @@ export async function cmdScenarioRunParsed(opts) {
             ...validationChecks,
         ]);
         output.line("Status: preview only; no task created and no runner executed.");
-        output.line(`Next: use \`agentplane scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
+        output.line(`Next: use \`agentplane recipes scenario execute ${selection.recipe_id}:${selection.scenario_id}\` ` +
             "to materialize and run this scenario.");
         return 0;
     }
     catch (err) {
         if (err instanceof CliError)
             throw err;
-        throw mapCoreError(err, { command: "scenario run", root: opts.rootOverride ?? null });
+        throw mapCoreError(err, { command: "recipes scenario run", root: opts.rootOverride ?? null });
     }
 }

package/dist/commands/scenario/info.command.js

@@ -1,13 +1,13 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { cmdScenarioInfoParsed } from "../scenario.js";
 export const scenarioInfoSpec = {
-    id: ["scenario", "info"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "info"],
+    group: "Recipes",
     summary: "Show manifest-backed scenario details and normalized run profile.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario info viewer:demo",
+            cmd: "agentplane recipes scenario info viewer:demo",
             why: "Inspect resolver-backed scenario metadata before execution.",
         },
     ],
@@ -17,7 +17,7 @@ export const scenarioInfoSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioInfoSpec,
-                command: "scenario info",
+                command: "recipes scenario info",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/list.command.js

@@ -1,9 +1,9 @@
 import { cmdScenarioListParsed } from "../scenario.js";
 export const scenarioListSpec = {
-    id: ["scenario", "list"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "list"],
+    group: "Recipes",
     summary: "List resolver-backed scenario descriptors from installed recipes.",
     parse: () => ({}),
-    examples: [{ cmd: "agentplane scenario list", why: "List available recipe scenarios." }],
+    examples: [{ cmd: "agentplane recipes scenario list", why: "List available recipe scenarios." }],
 };
 export const runScenarioList = (ctx) => cmdScenarioListParsed({ cwd: ctx.cwd, rootOverride: ctx.rootOverride });

package/dist/commands/scenario/run.command.js

@@ -1,14 +1,14 @@
 import { usageError } from "../../cli/spec/errors.js";
 import { cmdScenarioRunParsed } from "../scenario.js";
 export const scenarioRunSpec = {
-    id: ["scenario", "run"],
-    group: "Scenario",
+    id: ["recipes", "scenario", "run"],
+    group: "Recipes",
     summary: "Preview a validated scenario plan without creating a task or running a runner.",
     args: [{ name: "id", required: true, valueHint: "<recipe:scenario>" }],
     examples: [
         {
-            cmd: "agentplane scenario run viewer:demo",
-            why: "Validate a scenario and inspect the preview plan before `scenario execute`.",
+            cmd: "agentplane recipes scenario run viewer:demo",
+            why: "Validate a scenario and inspect the preview plan before `recipes scenario execute`.",
         },
     ],
     parse: (raw) => {
@@ -17,7 +17,7 @@ export const scenarioRunSpec = {
         if (!recipeId || !scenarioId) {
             throw usageError({
                 spec: scenarioRunSpec,
-                command: "scenario run",
+                command: "recipes scenario run",
                 message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
             });
         }

package/dist/commands/scenario/scenario.command.js

@@ -1,9 +1,9 @@
 import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
 export const scenarioSpec = {
-    id: ["scenario"],
-    group: "Scenario",
+    id: ["recipes", "scenario"],
+    group: "Recipes",
     summary: "Recipe scenario commands.",
-    synopsis: ["agentplane scenario <subcommand> [options]"],
+    synopsis: ["agentplane recipes scenario <subcommand> [options]"],
     args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
     parse: (raw) => parseGroupCommand(raw, "subcommand"),
 };
@@ -11,9 +11,9 @@ export const runScenario = async (_ctx, p) => {
     throwGroupCommandUsage({
         spec: scenarioSpec,
         cmd: p.cmd,
-        subcommands: await loadDirectSubcommandNames(["scenario"]),
-        command: "scenario",
-        missingMessage: "Missing scenario subcommand.",
-        unknownMessage: (subcommand) => `Unknown scenario subcommand: ${subcommand}.`,
+        subcommands: await loadDirectSubcommandNames(["recipes", "scenario"]),
+        command: "recipes scenario",
+        missingMessage: "Missing recipes scenario subcommand.",
+        unknownMessage: (subcommand) => `Unknown recipes scenario subcommand: ${subcommand}.`,
     });
 };

package/dist/commands/shared/task-handoff.d.ts

@@ -1,4 +1,4 @@
-import { type TaskHandoff, type TaskHandoffRunnerNextAction, type TaskHandoffRunnerState } from "@agentplaneorg/core";
+import { type TaskHandoff, type TaskHandoffRoute, type TaskHandoffRunnerNextAction, type TaskHandoffRunnerState } from "@agentplaneorg/core";
 import type { CommandContext } from "./task-backend.js";
 export type TaskHandoffArtifact = TaskHandoff;
 export type TaskHandoffRunnerHint = TaskHandoffRunnerState;
@@ -46,6 +46,7 @@ export declare function buildTaskHandoffArtifact(opts: {
     workspace_root?: string | null;
     pr_branch?: string | null;
     runner?: TaskHandoffRunnerHint | undefined;
+    route?: TaskHandoffRoute | undefined;
     next_actions?: string[] | undefined;
     risks?: string[] | undefined;
     open_questions?: string[] | undefined;

package/dist/commands/shared/task-handoff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-handoff.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-handoff.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-handoff.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-handoff.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/task-handoff.js

@@ -14,6 +14,20 @@ function normalizeStringList(values) {
     const normalized = values.map((value) => value.trim()).filter((value) => value.length > 0);
     return normalized.length > 0 ? normalized : undefined;
 }
+function normalizeRoute(route) {
+    if (!route)
+        return undefined;
+    return {
+        kind: route.kind,
+        status: route.status ?? undefined,
+        local_mutation: route.local_mutation ?? undefined,
+        finalize_via: route.finalize_via ?? undefined,
+        pr_number: typeof route.pr_number === "number" && route.pr_number > 0 ? route.pr_number : null,
+        pr_url: trimOrNull(route.pr_url) ?? undefined,
+        handoff_show_command: trimOrNull(route.handoff_show_command) ?? undefined,
+        base_pull_command: trimOrNull(route.base_pull_command) ?? undefined,
+    };
+}
 export function resolveTaskHandoffPaths(opts) {
     const handoff_dir = path.join(opts.git_root, opts.workflow_dir, opts.task_id, "handoff");
     return {
@@ -96,6 +110,7 @@ export function buildTaskHandoffArtifact(opts) {
         workspace_root: trimOrNull(opts.workspace_root),
         pr_branch: trimOrNull(opts.pr_branch),
         runner: opts.runner,
+        route: normalizeRoute(opts.route),
         next_actions: normalizeStringList(opts.next_actions),
         risks: normalizeStringList(opts.risks),
         open_questions: normalizeStringList(opts.open_questions),

package/dist/commands/task/handoff-show.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handoff-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/handoff-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAiBlE,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,KAAK,UAAU,EAAE,QAAQ,qBAAqB,oBAsDtF,CAAC"}
+{"version":3,"file":"handoff-show.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/handoff-show.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAOtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,qBAAqB,CAiBlE,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,KAAK,UAAU,EAAE,QAAQ,qBAAqB,oBA2EtF,CAAC"}

package/dist/commands/task/handoff-show.command.js

@@ -52,6 +52,30 @@ export const runTaskHandoffShow = async (ctx, parsed) => {
         entries.push({ label: "head_sha", value: handoff.head_sha });
     if (handoff.pr_branch)
         entries.push({ label: "pr_branch", value: handoff.pr_branch });
+    if (handoff.route?.kind)
+        entries.push({ label: "route_kind", value: handoff.route.kind });
+    if (handoff.route?.status)
+        entries.push({ label: "route_status", value: handoff.route.status });
+    if (handoff.route?.local_mutation) {
+        entries.push({ label: "route_local_mutation", value: handoff.route.local_mutation });
+    }
+    if (handoff.route?.finalize_via) {
+        entries.push({ label: "route_finalize_via", value: handoff.route.finalize_via });
+    }
+    if (typeof handoff.route?.pr_number === "number") {
+        entries.push({ label: "route_pr_number", value: String(handoff.route.pr_number) });
+    }
+    if (handoff.route?.pr_url)
+        entries.push({ label: "route_pr_url", value: handoff.route.pr_url });
+    if (handoff.route?.handoff_show_command) {
+        entries.push({
+            label: "route_handoff_show_command",
+            value: handoff.route.handoff_show_command,
+        });
+    }
+    if (handoff.route?.base_pull_command) {
+        entries.push({ label: "route_base_pull_command", value: handoff.route.base_pull_command });
+    }
     if (handoff.runner?.run_id) {
         entries.push({ label: "run_id", value: handoff.runner.run_id }, { label: "runner_status", value: handoff.runner.status ?? "unknown" }, { label: "runner_next_action", value: handoff.runner.next_action ?? "none" });
         if (handoff.runner.next_command) {

package/dist/runner/context/base-prompts.d.ts

@@ -2,7 +2,7 @@ import { type ResolvedBehavior } from "../../runtime/behavior/index.js";
 import { type PolicyGatewayFlavor } from "../../shared/policy-gateway.js";
 import type { ResolvedExecutionProfileRuntime } from "../../runtime/execution-profile/index.js";
 import type { ResolvedHarnessContract } from "../../runtime/harness/index.js";
-import type { RunnerPromptBlock, RunnerRecipeContext } from "../types.js";
+import type { RunnerPromptBlock, RunnerRecipeContext, RunnerTaskContext } from "../types.js";
 type PromptSourcePayload = {
     source: string;
     title: string;
@@ -27,6 +27,7 @@ export declare function collectRunnerBasePrompts(opts: {
     owner_id: string;
     agents_dir?: string;
     fallback_policy_gateway_flavor?: PolicyGatewayFlavor;
+    task?: RunnerTaskContext;
     recipe?: RunnerRecipeContext;
     harness?: ResolvedHarnessContract;
     execution_profile?: ResolvedExecutionProfileRuntime;

package/dist/runner/context/base-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-prompts.d.ts","sourceRoot":"","sources":["../../../src/runner/context/base-prompts.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAoB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA8D5F,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;AAmD7F,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2ChC;AAwCD,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,mBAAmB,CAAC;IACrC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyChC;AA8MD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B,CAAC,EAAE,mBAAmB,CAAC;IACrD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;CACrD,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgC/B"}
+{"version":3,"file":"base-prompts.d.ts","sourceRoot":"","sources":["../../../src/runner/context/base-prompts.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EACV,iBAAiB,EAEjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AA8IrB,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;AAmD7F,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2ChC;AAwCD,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,mBAAmB,CAAC;IACrC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyChC;AAgOD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B,CAAC,EAAE,mBAAmB,CAAC;IACrD,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;CACrD,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoC/B"}