agentplane 0.3.6 → 0.3.8

package/dist/runner/usecases/task-run-lifecycle-shared.js

@@ -0,0 +1,172 @@
+import path from "node:path";
+import { loadCommandContext } from "../../commands/shared/task-backend.js";
+import { CliError } from "../../shared/errors.js";
+import { createRunnerAdapter } from "../adapters/index.js";
+import { runnerAdapterCancelledResult } from "../adapters/shared.js";
+import { evolveRunnerRunState } from "../artifacts.js";
+import { isProcessAlive, readObservedProcessIdentity } from "../process-supervision.js";
+import { assertRunnerBundleMatchesTask, RunnerRunRepository } from "../run-repository.js";
+import { assertRunnerTaskExecutable, } from "./task-run.js";
+function normalizeTaskStatus(task) {
+    return String(task.status || "TODO")
+        .trim()
+        .toUpperCase();
+}
+function assertCurrentTaskDoing(taskId, task) {
+    if (!task) {
+        throw new CliError({
+            exitCode: 4,
+            code: "E_IO",
+            message: `Task not found: ${taskId}`,
+        });
+    }
+    const status = normalizeTaskStatus(task);
+    if (status === "DOING")
+        return;
+    throw new CliError({
+        exitCode: 2,
+        code: "E_USAGE",
+        message: `${taskId}: runner lifecycle commands require task status DOING ` +
+            `(current=${JSON.stringify(status)}; use \`agentplane task start-ready ${taskId} --author <ROLE> --body "Start: ..."\` first).`,
+    });
+}
+export function assertExecuteMode(bundle, action) {
+    if (bundle.execution.mode === "execute")
+        return;
+    throw new CliError({
+        exitCode: 2,
+        code: "E_USAGE",
+        message: `runner ${action} requires an execute-mode run ` +
+            `(current=${JSON.stringify(bundle.execution.mode)}; dry-run artifacts cannot be ${action}d).`,
+    });
+}
+export function readRunningPid(state) {
+    return typeof state.supervision?.pid === "number" ? state.supervision.pid : null;
+}
+function normalizeCommandFingerprint(command) {
+    const firstToken = command?.trim().split(/\s+/u)[0] ?? "";
+    return firstToken ? path.basename(firstToken) : null;
+}
+function commandMatchesFingerprint(expected, observedCommand) {
+    const expectedFingerprint = normalizeCommandFingerprint(expected);
+    if (!expectedFingerprint || !observedCommand)
+        return false;
+    return observedCommand.includes(expectedFingerprint);
+}
+function startedAtMatches(expected, observed) {
+    const expectedMs = expected ? Date.parse(expected) : Number.NaN;
+    const observedMs = observed ? Date.parse(observed) : Number.NaN;
+    if (Number.isNaN(expectedMs) || Number.isNaN(observedMs))
+        return false;
+    return Math.abs(expectedMs - observedMs) <= 5000;
+}
+export async function assertMatchingProcessIdentity(opts) {
+    const observed = await readObservedProcessIdentity(opts.pid);
+    if (!observed) {
+        if (!isProcessAlive(opts.pid))
+            return;
+        throw new CliError({
+            exitCode: 8,
+            code: "E_RUNTIME",
+            message: `runner cancel refused because process identity could not be confirmed for ` +
+                `${opts.task_id}:${opts.run_id} pid=${opts.pid}.`,
+            context: {
+                task_id: opts.task_id,
+                run_id: opts.run_id,
+                pid: opts.pid,
+                expected_command: opts.state.supervision?.command ?? null,
+                expected_started_at: opts.state.supervision?.started_at ?? null,
+            },
+        });
+    }
+    const commandMatches = commandMatchesFingerprint(opts.state.supervision?.command, observed.command);
+    const startMatches = startedAtMatches(opts.state.supervision?.started_at, observed.started_at);
+    if (commandMatches && startMatches)
+        return;
+    throw new CliError({
+        exitCode: 8,
+        code: "E_RUNTIME",
+        message: `runner cancel refused because the live process no longer matches persisted supervision ` +
+            `metadata for ${opts.task_id}:${opts.run_id} pid=${opts.pid}.`,
+        context: {
+            task_id: opts.task_id,
+            run_id: opts.run_id,
+            pid: opts.pid,
+            expected_command: opts.state.supervision?.command ?? null,
+            observed_command: observed.command,
+            expected_started_at: opts.state.supervision?.started_at ?? null,
+            observed_started_at: observed.started_at,
+        },
+    });
+}
+export function signalProcess(pid, signal) {
+    try {
+        process.kill(pid, signal);
+        return true;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ESRCH")
+            return false;
+        throw err;
+    }
+}
+export function buildSyntheticCancelledState(opts) {
+    const priorSupervision = opts.state.supervision;
+    const started_at = opts.state.result?.started_at ??
+        priorSupervision?.started_at ??
+        opts.state.updated_at ??
+        opts.updated_at;
+    const result = runnerAdapterCancelledResult({
+        reason: `Runner cancellation state synthesized after requested ${opts.signal}; ` +
+            "observed process exit metadata was unavailable.",
+        started_at,
+        ended_at: opts.updated_at,
+        output_paths: [opts.state.bundle_path, opts.state.bootstrap_path].filter((value) => typeof value === "string" && value.trim().length > 0),
+    });
+    return evolveRunnerRunState({
+        state: opts.state,
+        status: "cancelled",
+        result,
+        updated_at: opts.updated_at,
+        supervision: {
+            ...priorSupervision,
+            heartbeat_at: opts.updated_at,
+            cancel_requested_at: priorSupervision?.cancel_requested_at ?? opts.updated_at,
+            cancel_signal: priorSupervision?.cancel_signal ?? opts.signal,
+            exit_signal: priorSupervision?.exit_signal ?? null,
+        },
+    });
+}
+export async function loadExistingRunnerExecution(opts) {
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    if (opts.require_task_doing !== false) {
+        assertCurrentTaskDoing(opts.task_id, await ctx.taskBackend.getTask(opts.task_id));
+    }
+    const repository = RunnerRunRepository.forTaskRun({
+        git_root: ctx.resolvedProject.gitRoot,
+        workflow_dir: ctx.config.paths.workflow_dir,
+        task_id: opts.task_id,
+        run_id: opts.run_id,
+    });
+    const record = await repository.readRecord();
+    if (!record) {
+        throw new CliError({
+            exitCode: 4,
+            code: "E_IO",
+            message: `Runner artifacts not found for ${opts.task_id}:${opts.run_id}`,
+        });
+    }
+    assertRunnerBundleMatchesTask(record.bundle, opts.task_id, opts.run_id);
+    assertRunnerTaskExecutable(record.bundle);
+    const adapter = createRunnerAdapter(ctx.config);
+    const invocation = await adapter.prepare(record.bundle);
+    return {
+        ctx,
+        bundle: record.bundle,
+        invocation,
+        state: record.state,
+        repository,
+    };
+}

package/dist/runner/usecases/task-run-lifecycle.d.ts

@@ -0,0 +1,4 @@
+export { cancelTaskRunnerExecution } from "./task-run-lifecycle-cancel.js";
+export { resumeTaskRunnerExecution, retryTaskRunnerExecution, } from "./task-run-lifecycle-replay.js";
+export type { CancelledTaskRunnerExecution, ResumedTaskRunnerExecution, RetriedTaskRunnerExecution, } from "./task-run-lifecycle-shared.js";
+//# sourceMappingURL=task-run-lifecycle.d.ts.map

package/dist/runner/usecases/task-run-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-run-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/runner/usecases/task-run-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC"}

package/dist/runner/usecases/task-run-lifecycle.js

@@ -0,0 +1,2 @@
+export { cancelTaskRunnerExecution } from "./task-run-lifecycle-cancel.js";
+export { resumeTaskRunnerExecution, retryTaskRunnerExecution, } from "./task-run-lifecycle-replay.js";

package/dist/runner/usecases/task-run.d.ts

@@ -0,0 +1,32 @@
+import { type CommandContext } from "../../commands/shared/task-backend.js";
+import { type RunnerContextBundle, type RunnerExecutionContract, type RunnerInvocation, type RunnerRecipeContext, type RunnerResult, type RunnerRunState, type RunnerTarget } from "../types.js";
+export type PreparedTaskRunnerExecution = {
+    bundle: RunnerContextBundle;
+    invocation: RunnerInvocation;
+    state: RunnerRunState;
+};
+export type ExecutedTaskRunnerExecution = PreparedTaskRunnerExecution & {
+    result: RunnerResult;
+};
+export declare function assertRunnerTaskExecutable(bundle: RunnerContextBundle): void;
+export declare function renderTaskRunnerBootstrap(bundle: RunnerContextBundle, invocation?: RunnerInvocation): string;
+export declare function prepareTaskRunnerExecution(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string | null;
+    task_id: string;
+    mode: RunnerExecutionContract["mode"];
+    run_id?: string;
+    recipe?: RunnerRecipeContext;
+    target?: RunnerTarget;
+}): Promise<PreparedTaskRunnerExecution>;
+export declare function executeTaskRunnerExecution(opts: {
+    ctx?: CommandContext;
+    cwd: string;
+    rootOverride?: string | null;
+    task_id: string;
+    run_id?: string;
+    recipe?: RunnerRecipeContext;
+    target?: RunnerTarget;
+}): Promise<ExecutedTaskRunnerExecution>;
+//# sourceMappingURL=task-run.d.ts.map

package/dist/runner/usecases/task-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-run.d.ts","sourceRoot":"","sources":["../../../src/runner/usecases/task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAgBhG,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,GAAG;IACtE,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAiGF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAc5E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,MAAM,CAiCR;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAmFvC;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAgDvC"}

package/dist/runner/usecases/task-run.js

@@ -0,0 +1,278 @@
+import { exitCodeForError } from "../../cli/exit-codes.js";
+import { loadCommandContext } from "../../commands/shared/task-backend.js";
+import { CliError } from "../../shared/errors.js";
+import { evolveRunnerRunState } from "../artifacts.js";
+import { createRunnerAdapter } from "../adapters/index.js";
+import { readRecipeRunProfile } from "../adapters/recipe-run-profile.js";
+import { collectRunnerBasePrompts } from "../context/base-prompts.js";
+import { assembleRunnerTaskContext } from "../context/task-context.js";
+import { applyRunnerPolicyRefusal, buildRunnerPolicyDecision } from "../policy-decision.js";
+import { createRunnerRunId } from "../run-id.js";
+import { persistRunnerOutcomeToTask } from "../task-state.js";
+import { RunnerRunRepository } from "../run-repository.js";
+import { resolveTaskRunnerPaths } from "../task-run-paths.js";
+import { resolveRunnerTimeoutPolicy, resolveRunnerTracePolicy } from "../config.js";
+import { normalizeRecipeArtifactPrefixes } from "../result-manifest-policy.js";
+import { RUNNER_API_VERSION, RUNNER_BUNDLE_SCHEMA_VERSION, } from "../types.js";
+class RunnerPreparationCliError extends CliError {
+    bundle;
+    state;
+    constructor(opts) {
+        super({
+            exitCode: opts.cause.exitCode,
+            code: opts.cause.code,
+            message: opts.cause.message,
+            context: opts.cause.context,
+        });
+        this.bundle = opts.bundle;
+        this.state = opts.state;
+    }
+}
+function isEnforcedCapabilityLevel(level) {
+    return level === "native" || level === "wrapper";
+}
+function assertRunnerPolicyCompatibility(bundle) {
+    const profile = readRecipeRunProfile(bundle.recipe);
+    if (!profile)
+        return;
+    const adapterId = bundle.execution.adapter_id;
+    const capabilities = bundle.execution.adapter_capabilities;
+    if (profile.sandbox) {
+        const sandboxCapability = capabilities?.fields.sandbox;
+        if (isEnforcedCapabilityLevel(sandboxCapability?.level) &&
+            sandboxCapability?.supported_values &&
+            !sandboxCapability.supported_values.includes(profile.sandbox)) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_RUNTIME"),
+                code: "E_RUNTIME",
+                message: `Runner adapter ${JSON.stringify(adapterId)} does not support recipe sandbox ` +
+                    `${JSON.stringify(profile.sandbox)}; supported values: ${sandboxCapability.supported_values.join(", ")}.`,
+                context: {
+                    adapter_id: adapterId,
+                    policy_field: "sandbox",
+                    declared_value: profile.sandbox,
+                    capability: sandboxCapability,
+                },
+            });
+        }
+    }
+    if (profile.writes_artifacts_to && profile.writes_artifacts_to.length > 0) {
+        normalizeRecipeArtifactPrefixes(profile.writes_artifacts_to);
+    }
+}
+async function writeRunnerRefusalArtifacts(opts) {
+    const repository = RunnerRunRepository.fromBundle(opts.bundle);
+    const prepared = await repository.writePrepared({
+        bundle: opts.bundle,
+        bootstrap_markdown: renderTaskRunnerBootstrap(opts.bundle),
+    });
+    const result = {
+        status: "failed",
+        exit_code: opts.error.exitCode ?? exitCodeForError("E_RUNTIME"),
+        started_at: prepared.created_at,
+        ended_at: prepared.created_at,
+        summary: opts.error.message,
+        stderr_summary: opts.error.message,
+    };
+    const refused = evolveRunnerRunState({
+        state: prepared,
+        status: "failed",
+        result,
+        updated_at: prepared.created_at,
+    });
+    await repository.writeState(refused);
+    await repository.appendEvent({
+        at: prepared.created_at,
+        type: "runner_refused",
+        message: `runner refused before adapter prepare: ${opts.error.message}`,
+        data: opts.error.context
+            ? {
+                code: opts.error.code,
+                exit_code: opts.error.exitCode,
+                ...opts.error.context,
+            }
+            : {
+                code: opts.error.code,
+                exit_code: opts.error.exitCode,
+            },
+    });
+    return refused;
+}
+export function assertRunnerTaskExecutable(bundle) {
+    const task = bundle.task;
+    if (!task)
+        return;
+    const status = String(task.data.status || "TODO")
+        .trim()
+        .toUpperCase();
+    if (status === "DOING")
+        return;
+    throw new CliError({
+        exitCode: 2,
+        code: "E_USAGE",
+        message: `${task.task_id}: runner execution requires task status DOING ` +
+            `(current=${JSON.stringify(status)}; use \`agentplane task start-ready ${task.task_id} --author <ROLE> --body "Start: ..."\` first).`,
+    });
+}
+export function renderTaskRunnerBootstrap(bundle, invocation) {
+    const targetLabel = bundle.target.kind === "task"
+        ? `task ${bundle.target.task_id}`
+        : `recipe scenario ${bundle.target.recipe_id}:${bundle.target.scenario_id}`;
+    return [
+        "# agentplane runner bootstrap",
+        "",
+        "This invocation is already inside an approved runner execution.",
+        "- Do not run repository startup commands such as `agentplane config show`, `agentplane quickstart`, `agentplane task list`, `git status`, or `git rev-parse` unless the bundle explicitly requires them as task work.",
+        "- Do not create, approve, start, verify, finish, block, or rerun tasks unless the bundle explicitly requires task metadata edits.",
+        "- Do not recursively invoke runner entrypoints such as `agentplane task run` or `agentplane scenario execute` from inside this run.",
+        "- Open bundle.json immediately, execute the requested work directly, and stop when the requested outcome is satisfied.",
+        "",
+        `- target: ${targetLabel}`,
+        `- adapter: ${bundle.execution.adapter_id}`,
+        `- mode: ${bundle.execution.mode}`,
+        `- run_id: ${bundle.execution.run_id}`,
+        `- bundle_path: ${bundle.execution.artifact_paths.bundle_path}`,
+        `- result_path: ${bundle.execution.artifact_paths.result_path}`,
+        `- bootstrap_path: ${bundle.execution.artifact_paths.bootstrap_path}`,
+        "",
+        "Use bundle.json as the complete runner input. Do not reconstruct prompts from CLI argv.",
+        "Execute-mode runs must write a valid JSON result manifest to result_path before exiting.",
+        "Minimal manifest example:",
+        '{"schema_version":1,"status":"success","summary":"Completed.","capabilities_used":["runner.exec"]}',
+        "",
+        "Prepared invocation:",
+        "",
+        invocation
+            ? `- argv: ${invocation.argv.join(" ")}`
+            : "- argv: <not prepared; preflight refused>",
+    ].join("\n");
+}
+export async function prepareTaskRunnerExecution(opts) {
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    const taskEnvelope = await assembleRunnerTaskContext({
+        ctx,
+        cwd: opts.cwd,
+        rootOverride: opts.rootOverride ?? null,
+        task_id: opts.task_id,
+    });
+    const base_prompts = await collectRunnerBasePrompts({
+        git_root: taskEnvelope.repository.git_root,
+        owner_id: taskEnvelope.task.data.owner,
+        agents_dir: ctx.config.paths.agents_dir,
+        recipe: opts.recipe,
+    });
+    const adapter = createRunnerAdapter(ctx.config);
+    const configured_adapter_id = adapter.id === "custom" ? "custom" : "codex";
+    const run_id = opts.run_id ?? createRunnerRunId();
+    const artifact_paths = resolveTaskRunnerPaths({
+        git_root: taskEnvelope.repository.git_root,
+        workflow_dir: taskEnvelope.repository.workflow_dir,
+        task_id: opts.task_id,
+        run_id,
+    });
+    const bundle = {
+        schema_version: RUNNER_BUNDLE_SCHEMA_VERSION,
+        runner_api_version: RUNNER_API_VERSION,
+        target: opts.target ?? { kind: "task", task_id: opts.task_id },
+        base_prompts,
+        repository: taskEnvelope.repository,
+        task: taskEnvelope.task,
+        recipe: opts.recipe,
+        execution: {
+            adapter_id: configured_adapter_id,
+            mode: opts.mode,
+            run_id,
+            artifact_paths,
+            trace_policy: resolveRunnerTracePolicy(ctx.config),
+            timeout_policy: resolveRunnerTimeoutPolicy(ctx.config),
+            approvals: {
+                require_plan: ctx.config.agents?.approvals.require_plan,
+                require_verify: ctx.config.agents?.approvals.require_verify,
+                require_network: ctx.config.agents?.approvals.require_network,
+            },
+        },
+    };
+    bundle.execution.adapter_capabilities = adapter.describeCapabilities(bundle);
+    bundle.execution.policy_decision = buildRunnerPolicyDecision({
+        adapter_id: bundle.execution.adapter_id,
+        capabilities: bundle.execution.adapter_capabilities,
+        recipe: bundle.recipe,
+    });
+    assertRunnerTaskExecutable(bundle);
+    try {
+        assertRunnerPolicyCompatibility(bundle);
+    }
+    catch (err) {
+        if (err instanceof CliError) {
+            bundle.execution.policy_decision = applyRunnerPolicyRefusal({
+                decision: bundle.execution.policy_decision ??
+                    buildRunnerPolicyDecision({
+                        adapter_id: bundle.execution.adapter_id,
+                        capabilities: bundle.execution.adapter_capabilities,
+                        recipe: bundle.recipe,
+                    }),
+                error: err,
+            });
+            const state = await writeRunnerRefusalArtifacts({ bundle, error: err });
+            throw new RunnerPreparationCliError({ cause: err, bundle, state });
+        }
+        throw err;
+    }
+    const invocation = await adapter.prepare(bundle);
+    const repository = RunnerRunRepository.fromBundle(bundle);
+    const state = await repository.writePrepared({
+        bundle,
+        bootstrap_markdown: renderTaskRunnerBootstrap(bundle, invocation),
+        invocation,
+    });
+    return { bundle, invocation, state };
+}
+export async function executeTaskRunnerExecution(opts) {
+    const ctx = opts.ctx ??
+        (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
+    let prepared;
+    try {
+        prepared = await prepareTaskRunnerExecution({
+            ctx,
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            task_id: opts.task_id,
+            mode: "execute",
+            run_id: opts.run_id,
+            recipe: opts.recipe,
+            target: opts.target,
+        });
+    }
+    catch (err) {
+        if (err instanceof RunnerPreparationCliError) {
+            await persistRunnerOutcomeToTask({
+                ctx,
+                task_id: opts.task_id,
+                bundle: err.bundle,
+                state: err.state,
+            });
+        }
+        throw err;
+    }
+    const adapter = createRunnerAdapter(ctx.config);
+    const result = await adapter.execute(prepared.invocation);
+    const repository = RunnerRunRepository.fromInvocation(prepared.invocation);
+    const state = (await repository.readState()) ??
+        evolveRunnerRunState({
+            state: prepared.state,
+            status: result.status,
+            result,
+            updated_at: result.ended_at,
+        });
+    await persistRunnerOutcomeToTask({
+        ctx,
+        task_id: opts.task_id,
+        bundle: prepared.bundle,
+        state,
+    });
+    return {
+        ...prepared,
+        result,
+    };
+}

package/dist/shared/agent-emoji.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-emoji.d.ts","sourceRoot":"","sources":["../../src/shared/agent-emoji.ts"],"names":[],"mappings":"AAkCA,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}
+{"version":3,"file":"agent-emoji.d.ts","sourceRoot":"","sources":["../../src/shared/agent-emoji.ts"],"names":[],"mappings":"AAmCA,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}

package/dist/shared/agent-emoji.js

@@ -28,6 +28,7 @@ function fallbackEmojiForAgentId(agentId) {
     const idx = stableHash32(agentId) % FALLBACK_EMOJIS.length;
     return FALLBACK_EMOJIS[idx] ?? "🧩";
 }
+// Prefer an explicit agent-level commit_emoji before falling back to deterministic defaults.
 export async function resolveCommitEmojiForAgent(opts) {
     const agentId = opts.agentId.trim();
     if (!agentId)

package/dist/shared/errors.d.ts

@@ -1,4 +1,4 @@
-export type ErrorCode = "E_USAGE" | "E_VALIDATION" | "E_IO" | "E_GIT" | "E_BACKEND" | "E_NETWORK" | "E_INTERNAL";
+export type ErrorCode = "E_USAGE" | "E_VALIDATION" | "E_IO" | "E_GIT" | "E_BACKEND" | "E_NETWORK" | "E_RUNTIME" | "E_INTERNAL";
 export declare class CliError extends Error {
     readonly exitCode: number;
     readonly code: ErrorCode;

package/dist/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAMF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAiBnF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEtC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAMF;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAiBnF"}

package/dist/shared/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/shared/guards.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/shared/guards.ts"],"names":[],"mappings":"AACA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/shared/guards.js

@@ -1,3 +1,4 @@
+// Narrow unknown values to plain object-like records.
 export function isRecord(value) {
     return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }

package/dist/shared/protected-paths.d.ts

@@ -9,6 +9,16 @@ export declare function taskArtifactPrefixes(opts: {
     workflowDir?: string;
     taskId?: string;
 }): string[];
+export declare function protectedPathAllowPrefixes(opts: {
+    tasksPath: string;
+    workflowDir?: string;
+    taskId?: string;
+    allowTasks?: boolean;
+    allowPolicy?: boolean;
+    allowConfig?: boolean;
+    allowHooks?: boolean;
+    allowCI?: boolean;
+}): string[];
 export declare function getProtectedPathOverride(kind: ProtectedPathKind): ProtectedPathOverride;
 export declare function protectedPathKindForFile(opts: {
     filePath: string;

package/dist/shared/protected-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protected-paths.d.ts","sourceRoot":"","sources":["../../src/shared/protected-paths.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAYF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,EAAE,CAOX;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAkBvF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iBAAiB,GAAG,IAAI,CAsC3B"}
+{"version":3,"file":"protected-paths.d.ts","sourceRoot":"","sources":["../../src/shared/protected-paths.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAYF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,EAAE,CAOX;AAYD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,MAAM,EAAE,CAkBX;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,GAAG,qBAAqB,CAkBvF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,iBAAiB,GAAG,IAAI,CAsC3B"}

package/dist/shared/protected-paths.js

@@ -16,6 +16,39 @@ export function taskArtifactPrefixes(opts) {
         out.add(workflowPrefix);
     return [...out].toSorted((a, b) => a.localeCompare(b));
 }
+const POLICY_PATH_PREFIXES = [
+    "AGENTS.md",
+    "CLAUDE.md",
+    "packages/agentplane/assets/AGENTS.md",
+    ".agentplane/agents",
+];
+const CONFIG_PATH_PREFIXES = [".agentplane/config.json", ".agentplane/backends"];
+const HOOK_PATH_PREFIXES = ["lefthook.yml"];
+const CI_PATH_PREFIXES = [".github/workflows", ".github/actions"];
+export function protectedPathAllowPrefixes(opts) {
+    const out = new Set();
+    if (opts.allowTasks) {
+        for (const prefix of taskArtifactPrefixes(opts))
+            out.add(prefix);
+    }
+    if (opts.allowPolicy) {
+        for (const prefix of POLICY_PATH_PREFIXES)
+            out.add(prefix);
+    }
+    if (opts.allowConfig) {
+        for (const prefix of CONFIG_PATH_PREFIXES)
+            out.add(prefix);
+    }
+    if (opts.allowHooks) {
+        for (const prefix of HOOK_PATH_PREFIXES)
+            out.add(prefix);
+    }
+    if (opts.allowCI) {
+        for (const prefix of CI_PATH_PREFIXES)
+            out.add(prefix);
+    }
+    return [...out].toSorted((a, b) => a.localeCompare(b));
+}
 export function getProtectedPathOverride(kind) {
     switch (kind) {
         case "tasks": {

package/dist/shared/repo-cli-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-cli-version.d.ts","sourceRoot":"","sources":["../../src/shared/repo-cli-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,WAAW,GACX,qBAAqB,GACrB,2BAA2B,CAAC;AAEhC,MAAM,MAAM,yBAAyB,GAAG;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAKjF;AA8BD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,GACzB,yBAAyB,CAuC3B"}
+{"version":3,"file":"repo-cli-version.d.ts","sourceRoot":"","sources":["../../src/shared/repo-cli-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAQ5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,MAAM,mBAAmB,GAC3B,cAAc,GACd,WAAW,GACX,qBAAqB,GACrB,2BAA2B,CAAC;AAEhC,MAAM,MAAM,yBAAyB,GAAG;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAKjF;AA+BD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,GACzB,yBAAyB,CAuC3B"}

package/dist/shared/repo-cli-version.js

@@ -1,3 +1,4 @@
+import { FRAMEWORK_DEV_BOOTSTRAP_COMMAND, FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND, FRAMEWORK_DEV_REINSTALL_SCRIPT, FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND, } from "../../bin/framework-dev-contract.js";
 import { compareVersions } from "./version-compare.js";
 export function getRepoExpectedCliVersion(config) {
     const raw = config.framework.cli.expected_version;
@@ -9,22 +10,23 @@ export function getRepoExpectedCliVersion(config) {
 function buildRecovery(runtime, expectedVersion) {
     switch (runtime.mode) {
         case "global-installed": {
-            return `Run: npm i -g agentplane@${expectedVersion}. Then verify: agentplane runtime explain`;
+            return `Run: npm i -g agentplane@${expectedVersion}. Then verify: ${FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND}`;
         }
         case "global-in-framework":
         case "global-forced-in-framework": {
             const prefix = runtime.mode === "global-forced-in-framework"
                 ? "Unset AGENTPLANE_USE_GLOBAL_IN_FRAMEWORK=1 if forced global mode is not intentional. "
                 : "";
-            return (`${prefix}Run: scripts/reinstall-global-agentplane.sh. ` +
-                "Fallback: node packages/agentplane/bin/agentplane.js runtime explain. " +
-                "Then verify: agentplane runtime explain");
+            return (`${prefix}Run: ${FRAMEWORK_DEV_BOOTSTRAP_COMMAND}. ` +
+                `If the global PATH command should resolve this checkout, then run: ${FRAMEWORK_DEV_REINSTALL_SCRIPT}. ` +
+                `Repo-local verify: ${FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND}. ` +
+                `Then verify: ${FRAMEWORK_DEV_GLOBAL_VERIFY_COMMAND}`);
         }
         case "repo-local":
         case "repo-local-handoff": {
             return (`Sync this framework checkout to agentplane ${expectedVersion} or lower ` +
                 "framework.cli.expected_version if the repository intentionally targets an older CLI. " +
-                "Then verify: agentplane runtime explain");
+                `Then verify: ${FRAMEWORK_DEV_REPO_LOCAL_VERIFY_COMMAND}`);
         }
     }
 }

package/dist/shared/task-doc-conflicts.d.ts

@@ -0,0 +1,12 @@
+export declare function assertExpectedTaskDoc(opts: {
+    taskId: string;
+    currentDoc: string;
+    expectedDoc: string | null | undefined;
+}): void;
+export declare function assertExpectedTaskSection(opts: {
+    taskId: string;
+    currentDoc: string;
+    section: string;
+    expectedText: string | null | undefined;
+}): void;
+//# sourceMappingURL=task-doc-conflicts.d.ts.map