agentplane 0.3.7 → 0.3.9

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

@@ -0,0 +1,117 @@
+import { usageError } from "../../cli/spec/errors.js";
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { mapBackendError } from "../../cli/error-map.js";
+import { createCliEmitter } from "../../cli/output.js";
+import { loadCommandContext } from "../shared/task-backend.js";
+import { executeTaskRunnerExecution } from "../../runner/usecases/task-run.js";
+import { materializeRecipeScenarioTask } from "../../runner/usecases/scenario-materialize-task.js";
+import { cmdTaskPlanApprove } from "../task/plan.js";
+import { cmdTaskStartReady } from "../task/start-ready.js";
+import { CliError } from "../../shared/errors.js";
+const output = createCliEmitter();
+export const scenarioExecuteSpec = {
+    id: ["scenario", "execute"],
+    group: "Scenario",
+    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",
+            why: "Create a task from the scenario template and execute it through the configured runner.",
+        },
+    ],
+    parse: (raw) => {
+        const id = String(raw.args.id ?? "");
+        const [recipeId, scenarioId] = id.split(":", 2);
+        if (!recipeId || !scenarioId) {
+            throw usageError({
+                spec: scenarioExecuteSpec,
+                command: "scenario execute",
+                message: `Invalid scenario id: ${id} (expected: <recipe:scenario>)`,
+            });
+        }
+        return { recipeId, scenarioId };
+    },
+};
+function renderScenarioExecuteStartBody(parsed, taskId) {
+    return (`Start: execute recipe scenario ${parsed.recipeId}:${parsed.scenarioId} through the shared runner ` +
+        `using materialized task ${taskId} and its explicit task_template.`);
+}
+function renderScenarioExecutePlanApprovalNote(parsed) {
+    return (`Materialized from recipe scenario ${parsed.recipeId}:${parsed.scenarioId} ` +
+        "for immediate shared-runner execution.");
+}
+export const runScenarioExecute = async (ctx, parsed) => {
+    try {
+        const commandCtx = await loadCommandContext({
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+        });
+        const materialized = await materializeRecipeScenarioTask({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            recipe_id: parsed.recipeId,
+            scenario_id: parsed.scenarioId,
+        });
+        await cmdTaskPlanApprove({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? undefined,
+            taskId: materialized.task_id,
+            by: "ORCHESTRATOR",
+            note: renderScenarioExecutePlanApprovalNote(parsed),
+        });
+        await cmdTaskStartReady({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? undefined,
+            taskId: materialized.task_id,
+            author: materialized.task.owner,
+            body: renderScenarioExecuteStartBody(parsed, materialized.task_id),
+            force: false,
+            yes: false,
+            quiet: true,
+        });
+        const executed = await executeTaskRunnerExecution({
+            ctx: commandCtx,
+            cwd: ctx.cwd,
+            rootOverride: ctx.rootOverride ?? null,
+            task_id: materialized.task_id,
+            run_id: materialized.run_id,
+            recipe: materialized.recipe_context,
+            target: {
+                kind: "recipe_scenario",
+                recipe_id: parsed.recipeId,
+                scenario_id: parsed.scenarioId,
+                task_id: materialized.task_id,
+            },
+        });
+        output.info(`scenario executed: ${parsed.recipeId}:${parsed.scenarioId}`);
+        output.line(`task_id: ${materialized.task_id}`);
+        output.line(`run_id: ${executed.invocation.run_id}`);
+        output.line(`state: ${executed.bundle.execution.artifact_paths.state_path}`);
+        output.line(`events: ${executed.bundle.execution.artifact_paths.events_path}`);
+        output.line(`status: ${executed.result.status}`);
+        output.line(`runner_exit_code: ${executed.result.exit_code ?? "null"}`);
+        if (executed.result.stdout_summary) {
+            output.line(`stdout: ${executed.result.stdout_summary}`);
+        }
+        if (executed.result.stderr_summary) {
+            output.line(`stderr: ${executed.result.stderr_summary}`, "stderr");
+        }
+        return executed.result.status === "success"
+            ? 0
+            : (executed.result.exit_code ?? exitCodeForError("E_RUNTIME"));
+    }
+    catch (err) {
+        if (err instanceof CliError)
+            throw err;
+        throw mapBackendError(err, {
+            command: scenarioExecuteSpec.id.join(" "),
+            recipe_id: parsed.recipeId,
+            scenario_id: parsed.scenarioId,
+        });
+    }
+};

package/dist/commands/scenario/impl/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAkB3E,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAmKF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,oBAAoB,CAQtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA2ChE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/commands/scenario/impl/commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAkB3E,KAAK,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,KAAK,oBAAoB,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AA2KF,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,GACb,oBAAoB,CAQtB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA2ChE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC;CACvD,GAAG,OAAO,CAAC,MAAM,CAAC,CAuClB"}

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

@@ -5,17 +5,11 @@ import { resolveProject } from "@agentplaneorg/core";
 import { mapCoreError } from "../../../cli/error-map.js";
 import { exitCodeForError } from "../../../cli/exit-codes.js";
 import { fileExists } from "../../../cli/fs-utils.js";
-import { emptyStateMessage } from "../../../cli/output.js";
+import { createCliEmitter, emptyStateMessage } from "../../../cli/output.js";
 import { CliError } from "../../../shared/errors.js";
-import { formatJsonBlock } from "../../recipes/impl/format.js";
 import { listResolvedRecipeScenarios, readProjectInstalledRecipes, readScenarioDefinition, resolveRecipeScenarioSelection, } from "../../recipes.js";
 const execFileAsync = promisify(execFile);
-function printJsonSection(label, value) {
-    const payload = formatJsonBlock(value, "  ");
-    if (!payload)
-        return;
-    process.stdout.write(`${label}:\n${payload}\n`);
-}
+const output = createCliEmitter();
 function buildScenarioNotFoundError(recipeId, scenarioId) {
     return new CliError({
         exitCode: exitCodeForError("E_IO"),
@@ -49,6 +43,13 @@ async function resolveScenarioForCli(opts) {
         if (message.startsWith("No recipe scenario matches")) {
             throw buildScenarioNotFoundError(opts.recipeId, opts.scenarioId);
         }
+        if (message.startsWith("Scenario definition not found")) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_IO"),
+                code: "E_IO",
+                message,
+            });
+        }
         if (message.startsWith("Scenario selection is ambiguous")) {
             throw new CliError({
                 exitCode: exitCodeForError("E_VALIDATION"),
@@ -56,6 +57,15 @@ async function resolveScenarioForCli(opts) {
                 message,
             });
         }
+        if (message.startsWith("Missing required field: scenario.") ||
+            message.startsWith("Invalid field scenario.") ||
+            message.startsWith("Scenario definition id mismatch:")) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_VALIDATION"),
+                code: "E_VALIDATION",
+                message,
+            });
+        }
         throw error;
     }
 }
@@ -94,9 +104,9 @@ async function validateScenarioRecipeFiles(opts) {
     const agents = opts.entry.manifest.agents ?? [];
     const skills = opts.entry.manifest.skills ?? [];
     const tools = opts.entry.manifest.tools ?? [];
-    const selectedAgents = agents.filter((agent) => opts.selection.run_profile.agents_involved.includes(agent.id));
-    const selectedSkills = skills.filter((skill) => opts.selection.run_profile.skills_used.includes(skill.id));
-    const selectedTools = tools.filter((tool) => opts.selection.run_profile.tools_used.includes(tool.id));
+    const selectedAgents = agents.filter((agent) => opts.selection.agents_involved.includes(agent.id));
+    const selectedSkills = skills.filter((skill) => opts.selection.skills_used.includes(skill.id));
+    const selectedTools = tools.filter((tool) => opts.selection.tools_used.includes(tool.id));
     for (const agent of selectedAgents) {
         const agentFile = path.join(opts.selection.recipe_dir, agent.file);
         if (!(await fileExists(agentFile))) {
@@ -164,13 +174,13 @@ export async function cmdScenarioListParsed(opts) {
             includeIncompatible: true,
         });
         if (entries.length === 0) {
-            process.stdout.write(`${emptyStateMessage("scenarios", "Install a recipe to add scenarios.")}\n`);
+            output.line(emptyStateMessage("scenarios", "Install a recipe to add scenarios."));
             return 0;
         }
         for (const entry of entries) {
             const compatibilityLabel = entry.compatibility.ok ? "compatible" : "incompatible";
-            process.stdout.write(`${entry.recipe_id}:${entry.scenario_id} - ${entry.scenario_summary} ` +
-                `[mode=${entry.run_profile.mode}] [${compatibilityLabel}]\n`);
+            output.line(`${entry.recipe_id}:${entry.scenario_id} - ${entry.scenario_summary} ` +
+                `[mode=${entry.run_profile.mode}] [${compatibilityLabel}]`);
         }
         return 0;
     }
@@ -191,23 +201,24 @@ export async function cmdScenarioInfoParsed(opts) {
             recipeId: opts.recipeId,
             scenarioId: opts.scenarioId,
         });
-        process.stdout.write(`Scenario: ${selection.recipe_id}:${selection.scenario_id}\n`);
-        process.stdout.write(`Recipe: ${selection.recipe_name} (${selection.recipe_id}@${selection.recipe_version})\n`);
-        process.stdout.write(`Summary: ${selection.scenario_summary}\n`);
+        output.line(`Scenario: ${selection.recipe_id}:${selection.scenario_id}`);
+        output.line(`Recipe: ${selection.recipe_name} (${selection.recipe_id}@${selection.recipe_version})`);
+        output.line(`Summary: ${selection.scenario_summary}`);
         if (selection.scenario_description) {
-            process.stdout.write(`Description: ${selection.scenario_description}\n`);
+            output.line(`Description: ${selection.scenario_description}`);
         }
-        printJsonSection("Use when", selection.use_when);
+        output.jsonSection("Use when", selection.use_when);
         if (selection.avoid_when.length > 0) {
-            printJsonSection("Avoid when", selection.avoid_when);
+            output.jsonSection("Avoid when", selection.avoid_when);
         }
-        printJsonSection("Run profile", selection.run_profile);
-        process.stdout.write(`Scenario file: ${path.relative(project.gitRoot, selection.scenario_file)}\n`);
+        output.jsonSection("Run profile", selection.run_profile);
+        output.jsonSection("Task template", selection.task_template);
+        output.line(`Scenario file: ${path.relative(project.gitRoot, selection.scenario_file)}`);
         if (selection.compatibility.ok) {
-            process.stdout.write("Compatibility: satisfied\n");
+            output.line("Compatibility: satisfied");
         }
         else {
-            printJsonSection("Compatibility failures", selection.compatibility.failures);
+            output.jsonSection("Compatibility failures", selection.compatibility.failures);
         }
         return 0;
     }
@@ -275,17 +286,19 @@ export async function cmdScenarioRunParsed(opts) {
         assertScenarioCompatibility(selection);
         const scenarioDefinition = await readValidatedScenarioDefinition({ selection });
         const validationChecks = await validateScenarioRecipeFiles({ entry, selection });
-        process.stdout.write(`Prepared run plan: ${selection.recipe_id}:${selection.scenario_id}\n`);
-        process.stdout.write(`Recipe: ${selection.recipe_name} (${selection.recipe_id}@${selection.recipe_version})\n`);
-        process.stdout.write(`Goal: ${scenarioDefinition.goal}\n`);
-        process.stdout.write(`Scenario file: ${path.relative(project.gitRoot, selection.scenario_file)}\n`);
-        printJsonSection("Run profile", selection.run_profile);
-        printJsonSection("Selection reasons", selection.selection_reasons);
-        printJsonSection("Validation", [
+        output.line(`Prepared run plan: ${selection.recipe_id}:${selection.scenario_id}`);
+        output.line(`Recipe: ${selection.recipe_name} (${selection.recipe_id}@${selection.recipe_version})`);
+        output.line(`Goal: ${scenarioDefinition.goal}`);
+        output.line(`Scenario file: ${path.relative(project.gitRoot, selection.scenario_file)}`);
+        output.jsonSection("Run profile", selection.run_profile);
+        output.jsonSection("Selection reasons", selection.selection_reasons);
+        output.jsonSection("Validation", [
             `scenario definition ok: ${path.relative(project.gitRoot, selection.scenario_file)}`,
             ...validationChecks,
         ]);
-        process.stdout.write("Status: scenario orchestration runtime is not implemented yet.\n");
+        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}\` ` +
+            "to materialize and run this scenario.");
         return 0;
     }
     catch (err) {

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

@@ -3,12 +3,12 @@ import { cmdScenarioRunParsed } from "../scenario.js";
 export const scenarioRunSpec = {
     id: ["scenario", "run"],
     group: "Scenario",
-    summary: "Validate a scenario and print a prepared run plan (no execution).",
+    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 prepared run plan.",
+            why: "Validate a scenario and inspect the preview plan before `scenario execute`.",
         },
     ],
     parse: (raw) => {

package/dist/commands/scenario/scenario.command.d.ts

@@ -1,6 +1,5 @@
 import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
-type ScenarioParsed = Record<string, never>;
-export declare const scenarioSpec: CommandSpec<ScenarioParsed>;
-export declare const runScenario: CommandHandler<ScenarioParsed>;
-export {};
+import { type GroupCommandParsed } from "../../cli/group-command.js";
+export declare const scenarioSpec: CommandSpec<GroupCommandParsed>;
+export declare const runScenario: CommandHandler<GroupCommandParsed>;
 //# sourceMappingURL=scenario.command.d.ts.map

package/dist/commands/scenario/scenario.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scenario.command.d.ts","sourceRoot":"","sources":["../../../src/commands/scenario/scenario.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AAItF,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAI5C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,cAAc,CAyBpD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,cAAc,CAOtD,CAAC"}
+{"version":3,"file":"scenario.command.d.ts","sourceRoot":"","sources":["../../../src/commands/scenario/scenario.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,kBAAkB,CAOxD,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,kBAAkB,CAY1D,CAAC"}

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

@@ -1,37 +1,19 @@
-import { usageError } from "../../cli/spec/errors.js";
-import { suggestOne } from "../../cli/spec/suggest.js";
-const SCENARIO_SUBCOMMANDS = ["list", "info", "run"];
+import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
 export const scenarioSpec = {
     id: ["scenario"],
     group: "Scenario",
     summary: "Recipe scenario commands.",
     synopsis: ["agentplane scenario <subcommand> [options]"],
     args: [{ name: "subcommand", required: false, variadic: true, valueHint: "<subcommand>" }],
-    parse: () => ({}),
-    validateRaw: (raw) => {
-        const rest = Array.isArray(raw.args.subcommand) ? raw.args.subcommand : [];
-        const sub = rest[0];
-        if (!sub) {
-            throw usageError({
-                spec: scenarioSpec,
-                command: "scenario",
-                message: "Missing scenario subcommand.",
-            });
-        }
-        const suggestion = suggestOne(String(sub), [...SCENARIO_SUBCOMMANDS]);
-        const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
-        throw usageError({
-            spec: scenarioSpec,
-            command: "scenario",
-            message: `Unknown scenario subcommand: ${String(sub)}.${suffix}`,
-        });
-    },
+    parse: (raw) => parseGroupCommand(raw, "subcommand"),
 };
-export const runScenario = (_ctx) => {
-    // Should be unreachable because validateRaw always throws.
-    throw usageError({
+export const runScenario = async (_ctx, p) => {
+    throwGroupCommandUsage({
         spec: scenarioSpec,
+        cmd: p.cmd,
+        subcommands: await loadDirectSubcommandNames(["scenario"]),
         command: "scenario",
-        message: "Missing scenario subcommand.",
+        missingMessage: "Missing scenario subcommand.",
+        unknownMessage: (subcommand) => `Unknown scenario subcommand: ${subcommand}.`,
     });
 };

package/dist/commands/shared/git-context.d.ts

@@ -9,6 +9,7 @@ export declare class GitContext {
     statusStagedPaths(): Promise<string[]>;
     statusUntrackedPaths(): Promise<string[]>;
     statusUnstagedTrackedPaths(): Promise<string[]>;
+    invalidateStatus(): void;
     headCommit(): Promise<string>;
     stage(paths: string[]): Promise<void>;
     commit(opts: {

package/dist/commands/shared/git-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,gBAAgB,IAAI,IAAI;IAIxB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}

package/dist/commands/shared/git-context.js

@@ -95,6 +95,9 @@ export class GitContext {
         const status = await this.statusPorcelainZ();
         return status.unstagedTrackedPaths;
     }
+    invalidateStatus() {
+        this.memo.status = undefined;
+    }
     headCommit() {
         this.memo.headCommit ??= (async () => {
             const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
@@ -113,8 +116,7 @@ export class GitContext {
             cwd: this.gitRoot,
             env: gitEnv(),
         });
-        // Invalidate memoized status: staging changes index state.
-        this.memo.status = undefined;
+        this.invalidateStatus();
     }
     async commit(opts) {
         const args = ["commit", "-m", opts.message];

package/dist/commands/shared/git-ops.d.ts

@@ -1,6 +1,7 @@
 export declare function gitRevParse(cwd: string, args: string[]): Promise<string>;
 export declare function gitCurrentBranch(cwd: string): Promise<string>;
 export declare function gitBranchExists(cwd: string, branch: string): Promise<boolean>;
+export declare function gitBranchUpstream(cwd: string, branch: string): Promise<string | null>;
 export declare function gitListBranches(cwd: string): Promise<string[]>;
 export declare function gitStagedPaths(cwd: string): Promise<string[]>;
 export declare function gitAddPaths(cwd: string, paths: string[]): Promise<void>;

package/dist/commands/shared/git-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-ops.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBnE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYnF;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-ops.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9E;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBnE;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYnF;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe3F;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASpE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASnE;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5E;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDlB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBhB"}

package/dist/commands/shared/git-ops.js

@@ -52,6 +52,19 @@ export async function gitBranchExists(cwd, branch) {
         throw err;
     }
 }
+export async function gitBranchUpstream(cwd, branch) {
+    try {
+        const { stdout } = await execFileAsync("git", ["for-each-ref", "--format=%(upstream:short)", `refs/heads/${branch}`], {
+            cwd,
+            env: gitEnv(),
+        });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
 export async function gitListBranches(cwd) {
     const { stdout } = await execFileAsync("git", ["branch", "--format=%(refname:short)"], {
         cwd,

package/dist/commands/shared/operator-pipeline.d.ts

@@ -0,0 +1,10 @@
+export type OperatorPipelineSpec<TState, TResult, TOutput = TResult> = {
+    init: () => Promise<TState> | TState;
+    preflight?: (state: TState) => Promise<void> | void;
+    materialize?: (state: TState) => Promise<void> | void;
+    execute: (state: TState) => Promise<TResult> | TResult;
+    finalize?: (state: TState, result: TResult) => Promise<TOutput> | TOutput;
+    cleanup?: (state: TState, result: TResult | null) => Promise<void> | void;
+};
+export declare function runOperatorPipeline<TState, TResult, TOutput = TResult>(spec: OperatorPipelineSpec<TState, TResult, TOutput>): Promise<TOutput>;
+//# sourceMappingURL=operator-pipeline.d.ts.map

package/dist/commands/shared/operator-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-pipeline.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/operator-pipeline.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI;IACrE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACvD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3E,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1E,IAAI,EAAE,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GACnD,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/commands/shared/operator-pipeline.js

@@ -0,0 +1,16 @@
+export async function runOperatorPipeline(spec) {
+    const state = await spec.init();
+    let result = null;
+    try {
+        await spec.preflight?.(state);
+        await spec.materialize?.(state);
+        result = await spec.execute(state);
+        if (spec.finalize) {
+            return await spec.finalize(state, result);
+        }
+        return result;
+    }
+    finally {
+        await spec.cleanup?.(state, result);
+    }
+}

package/dist/commands/shared/pr-meta.d.ts

@@ -1,16 +1,36 @@
-export type PrMeta = {
-    schema_version: 1;
-    task_id: string;
-    branch?: string;
-    created_at: string;
-    updated_at: string;
-    last_verified_sha: string | null;
-    last_verified_at: string | null;
-    verify?: {
-        status?: "pass" | "fail" | "skipped";
-        command?: string;
-    };
+import { type TaskPrMeta } from "@agentplaneorg/core";
+export type PrMeta = TaskPrMeta;
+export type PrArtifactTextState = {
+    diffstatText: string | null;
+    verifyLogText: string | null;
+    reviewText: string | null;
 };
+export type PrArtifactState = PrArtifactTextState & {
+    meta: PrMeta;
+};
+export declare function buildOpenedPrMeta(opts: {
+    taskId: string;
+    branch: string;
+    at: string;
+    previousMeta: PrMeta | null;
+}): PrMeta;
+export declare function buildUpdatedPrMeta(opts: {
+    meta: PrMeta;
+    branch: string;
+    at: string;
+}): PrMeta;
+export declare function buildIntegratedPrMeta(opts: {
+    meta: PrMeta;
+    branch: string;
+    base: string;
+    mergeStrategy: "squash" | "merge" | "rebase";
+    mergeHash: string;
+    branchHeadSha: string;
+    at: string;
+    verifyCommands: string[];
+    shouldRunVerify: boolean;
+    alreadyVerifiedSha: string | null;
+}): PrMeta;
 export type ShellInvocation = {
     command: string;
     args: string[];

package/dist/commands/shared/pr-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr-meta.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/pr-meta.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,MAAM,GAAG;IACnB,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAQvE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAc/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAqBD"}
+{"version":3,"file":"pr-meta.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/pr-meta.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI1E,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC;AAChC,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GAAG,MAAM,CAYT;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ7F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,GAAG,MAAM,CAsBT;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAQvE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAW/D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQrE;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAqBD"}

package/dist/commands/shared/pr-meta.js

@@ -1,12 +1,54 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { validateTaskPrMeta } from "@agentplaneorg/core";
 import { execFileAsync } from "./git.js";
-function isRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
+function nowOrExisting(value, fallback) {
+    const trimmed = value?.trim() ?? "";
+    return trimmed || fallback;
 }
-function isIsoDate(value) {
-    return typeof value === "string" && !Number.isNaN(Date.parse(value));
+export function buildOpenedPrMeta(opts) {
+    return {
+        schema_version: 1,
+        task_id: opts.taskId,
+        branch: opts.branch,
+        created_at: opts.previousMeta?.created_at ?? opts.at,
+        updated_at: opts.at,
+        last_verified_sha: opts.previousMeta?.last_verified_sha ?? null,
+        last_verified_at: opts.previousMeta?.last_verified_at ?? null,
+        verify: opts.previousMeta?.verify ?? { status: "skipped" },
+        base: opts.previousMeta?.base,
+    };
+}
+export function buildUpdatedPrMeta(opts) {
+    return {
+        ...opts.meta,
+        branch: opts.branch,
+        updated_at: opts.at,
+        last_verified_sha: opts.meta.last_verified_sha ?? null,
+        last_verified_at: opts.meta.last_verified_at ?? null,
+    };
+}
+export function buildIntegratedPrMeta(opts) {
+    const nextMeta = {
+        ...opts.meta,
+        branch: opts.branch,
+        base: opts.base,
+        merge_strategy: opts.mergeStrategy,
+        status: "MERGED",
+        merged_at: nowOrExisting(opts.meta.merged_at, opts.at),
+        merge_commit: opts.mergeHash,
+        head_sha: opts.branchHeadSha,
+        updated_at: opts.at,
+    };
+    if (opts.verifyCommands.length > 0 && (opts.shouldRunVerify || opts.alreadyVerifiedSha)) {
+        nextMeta.last_verified_sha = opts.branchHeadSha;
+        nextMeta.last_verified_at = opts.at;
+        nextMeta.verify = opts.meta.verify
+            ? { ...opts.meta.verify, status: "pass" }
+            : { status: "pass", command: opts.verifyCommands.join(" && ") };
+    }
+    return nextMeta;
 }
 export function resolveShellInvocation(command) {
     if (os.platform() === "win32") {
@@ -25,17 +67,10 @@ export function parsePrMeta(raw, taskId) {
         const message = err instanceof Error ? err.message : String(err);
         throw new Error(`JSON Parse error: ${message}`);
     }
-    if (!isRecord(parsed))
-        throw new Error("pr/meta.json must be an object");
-    if (parsed.schema_version !== 1)
-        throw new Error("pr/meta.json schema_version must be 1");
-    if (parsed.task_id !== taskId)
+    const meta = validateTaskPrMeta(parsed);
+    if (meta.task_id !== taskId)
         throw new Error("pr/meta.json task_id mismatch");
-    if (!isIsoDate(parsed.created_at))
-        throw new Error("pr/meta.json created_at must be ISO");
-    if (!isIsoDate(parsed.updated_at))
-        throw new Error("pr/meta.json updated_at must be ISO");
-    return parsed;
+    return meta;
 }
 export function extractLastVerifiedSha(logText) {
     const regex = /verified_sha=([0-9a-f]{7,40})/gi;

package/dist/commands/shared/reconcile-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile-check.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/reconcile-check.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAuGvE,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CA+ChB"}
+{"version":3,"file":"reconcile-check.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/reconcile-check.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAuG3B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE;IACzD,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhB"}