@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/agent/subcommand-recovery.js

@@ -1,84 +1,2 @@
-/**
- * @module sdk/agent/subcommand-recovery
- *
- * Provides one SDK-owned refusal contract for unknown positional subcommands.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a9b23a46-0bba-5174-8793-dfc37016d1fb")}catch(e){}}();
-import { levenshteinDistanceWithinLimit } from "../../core/shared/levenshtein.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError, } from "../../core/shared/errors.js";
-/** Catalog-only alias retained for consumers of the former package lifecycle code. */
-export const UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES = [
-    { code: "unknown_lifecycle_action" },
-];
-function nearestSubcommand(token, allowed) {
-    const normalized = token.trim().toLowerCase();
-    if (normalized.length === 0)
-        return undefined;
-    const maxDistance = Math.floor(normalized.length / 3);
-    return allowed
-        .map((candidate) => ({
-        candidate,
-        distance: levenshteinDistanceWithinLimit(normalized, candidate.toLowerCase(), maxDistance) ?? Number.POSITIVE_INFINITY,
-    }))
-        .filter(({ distance }) => Number.isFinite(distance))
-        .sort((left, right) => left.distance !== right.distance
-        ? left.distance - right.distance
-        : left.candidate.localeCompare(right.candidate))[0]?.candidate;
-}
-function renderCommand(tokens) {
-    return ["pm", ...tokens]
-        .map((token) => /^[A-Za-z0-9_./:@=-]+$/u.test(token) ? token : JSON.stringify(token))
-        .join(" ");
-}
-/** Build the shared typed refusal used by CLI, SDK, MCP, and packages. */
-export function createUnknownSubcommandError(options) {
-    const commandPath = options.command_path.trim().replaceAll(/\s+/gu, " ");
-    const normalizedToken = options.token.trim();
-    const token = normalizedToken.length === 0 ? "<empty>" : normalizedToken;
-    const allowed = [...new Set(options.allowed.map((value) => value.trim()))]
-        .filter(Boolean)
-        .sort((left, right) => left.localeCompare(right));
-    if (commandPath.length === 0 || token.length === 0 || allowed.length === 0) {
-        throw new TypeError("Unknown-subcommand contracts require a path, token, and allowed set");
-    }
-    const commandTokens = commandPath.split(" ");
-    const trailingArgs = options.trailing_args ?? [];
-    const displayName = options.display_name ?? `pm ${commandPath}`;
-    const tokenKind = options.token_kind ?? "subcommand";
-    const nearest = options.retry_command
-        ? undefined
-        : nearestSubcommand(token, allowed);
-    const attemptedCommand = renderCommand([
-        ...commandTokens,
-        token,
-        ...trailingArgs,
-    ]);
-    const suggestedRetry = options.retry_command ??
-        (nearest
-            ? renderCommand([...commandTokens, nearest, ...trailingArgs])
-            : undefined);
-    return new PmCliError(`Unknown ${displayName} ${tokenKind} "${token}". Allowed: ${allowed.join(", ")}${options.message_suffix ?? ""}`, options.exit_code ?? EXIT_CODE.USAGE, {
-        code: "unknown_subcommand",
-        reason: "unknown_positional_token",
-        examples: [
-            ...(suggestedRetry ? [suggestedRetry] : []),
-            ...(options.examples ?? []),
-            `pm ${commandPath} --help`,
-        ],
-        nextSteps: suggestedRetry
-            ? [`Retry with the suggested command: ${suggestedRetry}`]
-            : ["Choose one value from recovery.allowed_values."],
-        recovery: {
-            attempted_command: attemptedCommand,
-            allowed_values: allowed,
-            suggested_retry: suggestedRetry,
-            fallback_candidates: options.fallback_candidates,
-        },
-    });
-}
-/** Test-only access to deterministic nearest-match behavior. */
-export const _testOnly = { nearestSubcommand, renderCommand };
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8ed4af4c-40cf-5902-930b-78a4758871b2")}catch(e2){}})();import{levenshteinDistanceWithinLimit}from"../../core/shared/levenshtein.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";const UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES=[{code:"unknown_lifecycle_action"}];function nearestSubcommand(token,allowed){const normalized=token.trim().toLowerCase();if(normalized.length===0)return void 0;const maxDistance=Math.floor(normalized.length/3);return allowed.map(candidate=>({candidate,distance:levenshteinDistanceWithinLimit(normalized,candidate.toLowerCase(),maxDistance)??Number.POSITIVE_INFINITY})).filter(({distance})=>Number.isFinite(distance)).sort((left,right)=>left.distance!==right.distance?left.distance-right.distance:left.candidate.localeCompare(right.candidate))[0]?.candidate}function renderCommand(tokens){return["pm",...tokens].map(token=>/^[A-Za-z0-9_./:@=-]+$/u.test(token)?token:JSON.stringify(token)).join(" ")}function createUnknownSubcommandError(options){const commandPath=options.command_path.trim().replaceAll(/\s+/gu," ");const normalizedToken=options.token.trim();const token=normalizedToken.length===0?"<empty>":normalizedToken;const allowed=[...new Set(options.allowed.map(value=>value.trim()))].filter(Boolean).sort((left,right)=>left.localeCompare(right));if(commandPath.length===0||token.length===0||allowed.length===0){throw new TypeError("Unknown-subcommand contracts require a path, token, and allowed set")}const commandTokens=commandPath.split(" ");const trailingArgs=options.trailing_args??[];const displayName=options.display_name??`pm ${commandPath}`;const tokenKind=options.token_kind??"subcommand";const nearest=options.retry_command?void 0:nearestSubcommand(token,allowed);const attemptedCommand=renderCommand([...commandTokens,token,...trailingArgs]);const suggestedRetry=options.retry_command??(nearest?renderCommand([...commandTokens,nearest,...trailingArgs]):void 0);return new PmCliError(`Unknown ${displayName} ${tokenKind} "${token}". Allowed: ${allowed.join(", ")}${options.message_suffix??""}`,options.exit_code??EXIT_CODE.USAGE,{code:"unknown_subcommand",reason:"unknown_positional_token",examples:[...suggestedRetry?[suggestedRetry]:[],...options.examples??[],`pm ${commandPath} --help`],nextSteps:suggestedRetry?[`Retry with the suggested command: ${suggestedRetry}`]:["Choose one value from recovery.allowed_values."],recovery:{attempted_command:attemptedCommand,allowed_values:allowed,suggested_retry:suggestedRetry,fallback_candidates:options.fallback_candidates}})}const _testOnly={nearestSubcommand,renderCommand};export{UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES,_testOnly,createUnknownSubcommandError};
 //# sourceMappingURL=subcommand-recovery.js.map
-//# debugId=a9b23a46-0bba-5174-8793-dfc37016d1fb

package/dist/sdk/agent/task-transcript-contracts.js

@@ -1,198 +1,2 @@
-/**
- * @module sdk/agent-task-transcript-contracts
- *
- * Defines and validates replayable agent-task transcripts without adding the
- * SDK-only parser to ordinary CLI command bundles.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="006109f8-cb09-5a91-8929-7ac7521753b6")}catch(e){}}();
-import { isPmSuccessfulExitCode, resolvePmCommandExitContract, } from "../cli-contracts/command-exit-contracts.js";
-import { parseBootstrapCommandName } from "../cli-contracts/bootstrap-command-scanner.js";
-import { PM_OUTPUT_ENVELOPE_KINDS, resolvePmCommandOutputEnvelope, } from "../output-contracts.js";
-/** Stable schema version for replayable agent-task transcript corpora. */
-export const PM_AGENT_TASK_TRANSCRIPT_VERSION = 2;
-/** Supported strategies for measuring one transcript step's output cost. */
-export const PM_AGENT_TASK_ACCOUNTING_MODES = [
-    "self_reported",
-    "independent_transport",
-];
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function readTranscriptString(value, field) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        throw new TypeError(`${field} must be a non-empty string`);
-    }
-    return value.trim();
-}
-function readTranscriptStringArray(value, field, preserveWhitespace = false) {
-    if (!Array.isArray(value) || value.length === 0) {
-        throw new TypeError(`${field} must be a non-empty string array`);
-    }
-    return value.map((entry, index) => {
-        const normalized = readTranscriptString(entry, `${field}[${String(index)}]`);
-        return preserveWhitespace ? entry : normalized;
-    });
-}
-function readOptionalTranscriptString(value, field) {
-    return value === undefined ? undefined : readTranscriptString(value, field);
-}
-function readExpectedFieldValues(value, field) {
-    if (value === undefined)
-        return undefined;
-    if (!isRecord(value) || Object.keys(value).length === 0) {
-        throw new TypeError(`${field} must be a non-empty object`);
-    }
-    const entries = Object.entries(value).map(([path, expectedValue]) => {
-        if (path.length === 0 ||
-            path.split(".").some((segment) => segment.length === 0)) {
-            throw new TypeError(`${field} must use dot-separated own-property paths`);
-        }
-        if (expectedValue !== null &&
-            typeof expectedValue !== "string" &&
-            typeof expectedValue !== "boolean" &&
-            (typeof expectedValue !== "number" || !Number.isFinite(expectedValue))) {
-            throw new TypeError(`${field} values must be JSON primitives`);
-        }
-        return [path, expectedValue];
-    });
-    return Object.fromEntries(entries);
-}
-function assertTranscriptStepOutputContract(field, args, exitCode, outputKind, errorCode, refusalSurface) {
-    if (outputKind === "refusal") {
-        if (isPmSuccessfulExitCode(exitCode) ||
-            errorCode === undefined ||
-            refusalSurface === undefined) {
-            throw new TypeError(`${field} refusal steps require a non-success exit, error code, and refusal surface`);
-        }
-        return;
-    }
-    if (errorCode !== undefined || refusalSurface !== undefined) {
-        throw new TypeError(`${field} only refusal steps may declare expected_error_code or expected_refusal_surface`);
-    }
-    const command = parseBootstrapCommandName(args);
-    if (command === undefined) {
-        throw new TypeError(`${field}.args must identify a command after global flags`);
-    }
-    const exitContract = resolvePmCommandExitContract(command);
-    if (!isPmSuccessfulExitCode(exitCode) ||
-        (exitCode !== 0 &&
-            !exitContract?.exit_codes.some((declaredExitCode) => declaredExitCode === exitCode))) {
-        throw new TypeError(`${field} successful output must use exit code 0 or a command-declared successful effect exit`);
-    }
-    const declaredKind = resolvePmCommandOutputEnvelope(command).kind;
-    if (outputKind !== declaredKind) {
-        throw new TypeError(`${field} expected ${outputKind}, but ${command} declares ${declaredKind}`);
-    }
-}
-function parseAgentTaskTranscriptStep(value, taskId, index) {
-    if (!isRecord(value)) {
-        throw new TypeError(`tasks.${taskId}.steps[${String(index)}] must be an object`);
-    }
-    const field = `tasks.${taskId}.steps[${String(index)}]`;
-    const id = readTranscriptString(value.id, `${field}.id`);
-    const args = readTranscriptStringArray(value.args, `${field}.args`, true);
-    const expectedExitCode = value.expected_exit_code;
-    if (typeof expectedExitCode !== "number" ||
-        !Number.isSafeInteger(expectedExitCode)) {
-        throw new TypeError(`${field}.expected_exit_code must be a safe integer`);
-    }
-    const rawOutputKind = value.expected_output_kind;
-    if (rawOutputKind !== "refusal" &&
-        !PM_OUTPUT_ENVELOPE_KINDS.includes(rawOutputKind)) {
-        throw new TypeError(`${field}.expected_output_kind is unsupported`);
-    }
-    const expectedOutputKind = rawOutputKind;
-    const rawAccountingMode = value.expected_accounting_mode;
-    if (!PM_AGENT_TASK_ACCOUNTING_MODES.includes(rawAccountingMode)) {
-        throw new TypeError(`${field}.expected_accounting_mode is unsupported`);
-    }
-    const expectedAccountingMode = rawAccountingMode;
-    if (expectedAccountingMode === "independent_transport" &&
-        expectedOutputKind !== "refusal") {
-        throw new TypeError(`${field} independent_transport accounting is supported only for refusal steps`);
-    }
-    const requiredFields = readTranscriptStringArray(value.required_fields, `${field}.required_fields`);
-    if (requiredFields.some((requiredField) => requiredField.split(".").some((segment) => segment.length === 0))) {
-        throw new TypeError(`${field}.required_fields must contain dot-separated own-property paths`);
-    }
-    const expectedFieldValues = readExpectedFieldValues(value.expected_field_values, `${field}.expected_field_values`);
-    const expectedErrorCode = readOptionalTranscriptString(value.expected_error_code, `${field}.expected_error_code`);
-    const expectedRefusalSurface = readOptionalTranscriptString(value.expected_refusal_surface, `${field}.expected_refusal_surface`);
-    const recoveryFor = readOptionalTranscriptString(value.recovery_for, `${field}.recovery_for`);
-    assertTranscriptStepOutputContract(field, args, expectedExitCode, expectedOutputKind, expectedErrorCode, expectedRefusalSurface);
-    return {
-        id,
-        args,
-        expected_exit_code: expectedExitCode,
-        expected_output_kind: expectedOutputKind,
-        expected_accounting_mode: expectedAccountingMode,
-        required_fields: requiredFields,
-        ...(expectedFieldValues
-            ? { expected_field_values: expectedFieldValues }
-            : {}),
-        ...(expectedErrorCode ? { expected_error_code: expectedErrorCode } : {}),
-        ...(expectedRefusalSurface
-            ? { expected_refusal_surface: expectedRefusalSurface }
-            : {}),
-        ...(recoveryFor ? { recovery_for: recoveryFor } : {}),
-    };
-}
-function parseAgentTaskTranscript(value, index) {
-    if (!isRecord(value)) {
-        throw new TypeError(`tasks[${String(index)}] must be an object`);
-    }
-    const id = readTranscriptString(value.id, `tasks[${String(index)}].id`);
-    const description = readTranscriptString(value.description, `tasks.${id}.description`);
-    if (!Array.isArray(value.steps) || value.steps.length === 0) {
-        throw new TypeError(`tasks.${id}.steps must be a non-empty array`);
-    }
-    const steps = value.steps.map((step, stepIndex) => parseAgentTaskTranscriptStep(step, id, stepIndex));
-    const priorSteps = new Map();
-    for (const step of steps) {
-        if (priorSteps.has(step.id)) {
-            throw new TypeError(`tasks.${id} contains duplicate step id ${step.id}`);
-        }
-        if (step.recovery_for !== undefined) {
-            const refusal = priorSteps.get(step.recovery_for);
-            if (refusal?.expected_output_kind !== "refusal" ||
-                step.expected_output_kind === "refusal") {
-                throw new TypeError(`tasks.${id}.${step.id} recovery_for must reference an earlier refusal and declare successful output`);
-            }
-        }
-        priorSteps.set(step.id, step);
-    }
-    if (steps.at(-1)?.expected_output_kind === "refusal") {
-        throw new TypeError(`tasks.${id} completed task must terminate with successful output`);
-    }
-    for (const step of steps) {
-        if (step.expected_output_kind === "refusal" &&
-            !steps.some((candidate) => candidate.recovery_for === step.id)) {
-            throw new TypeError(`tasks.${id}.${step.id} refusal must have a later successful recovery_for step`);
-        }
-    }
-    return { id, description, steps };
-}
-/** Parse and fail closed on malformed or internally inconsistent transcripts. */
-export function parsePmAgentTaskTranscriptCorpus(value) {
-    if (!isRecord(value)) {
-        throw new TypeError("agent-task transcript corpus must be an object");
-    }
-    if (value.version !== PM_AGENT_TASK_TRANSCRIPT_VERSION) {
-        throw new TypeError(`agent-task transcript corpus version must be ${String(PM_AGENT_TASK_TRANSCRIPT_VERSION)}`);
-    }
-    if (!Array.isArray(value.tasks) || value.tasks.length === 0) {
-        throw new TypeError("agent-task transcript corpus tasks must be non-empty");
-    }
-    const tasks = value.tasks.map((task, index) => parseAgentTaskTranscript(task, index));
-    const taskIds = new Set();
-    for (const task of tasks) {
-        if (taskIds.has(task.id)) {
-            throw new TypeError(`duplicate agent-task transcript id ${task.id}`);
-        }
-        taskIds.add(task.id);
-    }
-    return { version: PM_AGENT_TASK_TRANSCRIPT_VERSION, tasks };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4d2bee02-8003-578c-9d25-32755534f8ff")}catch(e2){}})();import{isPmSuccessfulExitCode,resolvePmCommandExitContract}from"../cli-contracts/command-exit-contracts.js";import{findBootstrapCommandTokenIndex,parseBootstrapCommandName}from"../cli-contracts/bootstrap-command-scanner.js";import{resolvePmHistoryOperation}from"../cli-contracts/command-aliases.js";import{PM_OUTPUT_ENVELOPE_KINDS,resolvePmCommandOutputEnvelope}from"../output-contracts.js";const PM_AGENT_TASK_TRANSCRIPT_VERSION=2;const PM_AGENT_TASK_ACCOUNTING_MODES=["self_reported","independent_transport"];function isRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function readTranscriptString(value,field){if(typeof value!=="string"||value.trim().length===0){throw new TypeError(`${field} must be a non-empty string`)}return value.trim()}function readTranscriptStringArray(value,field,preserveWhitespace=false){if(!Array.isArray(value)||value.length===0){throw new TypeError(`${field} must be a non-empty string array`)}return value.map((entry,index)=>{const normalized=readTranscriptString(entry,`${field}[${String(index)}]`);return preserveWhitespace?entry:normalized})}function readOptionalTranscriptString(value,field){return value===void 0?void 0:readTranscriptString(value,field)}function readExpectedFieldValues(value,field){if(value===void 0)return void 0;if(!isRecord(value)||Object.keys(value).length===0){throw new TypeError(`${field} must be a non-empty object`)}const entries=Object.entries(value).map(([path,expectedValue])=>{if(path.length===0||path.split(".").some(segment=>segment.length===0)){throw new TypeError(`${field} must use dot-separated own-property paths`)}if(expectedValue!==null&&typeof expectedValue!=="string"&&typeof expectedValue!=="boolean"&&(typeof expectedValue!=="number"||!Number.isFinite(expectedValue))){throw new TypeError(`${field} values must be JSON primitives`)}return[path,expectedValue]});return Object.fromEntries(entries)}function assertTranscriptStepOutputContract(field,args,exitCode,outputKind,errorCode,refusalSurface){if(outputKind==="refusal"){if(isPmSuccessfulExitCode(exitCode)||errorCode===void 0||refusalSurface===void 0){throw new TypeError(`${field} refusal steps require a non-success exit, error code, and refusal surface`)}return}if(errorCode!==void 0||refusalSurface!==void 0){throw new TypeError(`${field} only refusal steps may declare expected_error_code or expected_refusal_surface`)}const commandIndex=findBootstrapCommandTokenIndex(args);if(commandIndex===void 0){throw new TypeError(`${field}.args must identify a command after global flags`)}let command=args[commandIndex].trim().toLowerCase();if(command==="history"){const operation=parseBootstrapCommandName(args.slice(commandIndex+1));if(operation!==void 0){command=resolvePmHistoryOperation(`history ${operation}`)}}const exitContract=resolvePmCommandExitContract(command);if(!isPmSuccessfulExitCode(exitCode)||exitCode!==0&&!exitContract?.exit_codes.some(declaredExitCode=>declaredExitCode===exitCode)){throw new TypeError(`${field} successful output must use exit code 0 or a command-declared successful effect exit`)}const declaredKind=resolvePmCommandOutputEnvelope(command).kind;if(outputKind!==declaredKind){throw new TypeError(`${field} expected ${outputKind}, but ${command} declares ${declaredKind}`)}}function parseAgentTaskTranscriptStep(value,taskId,index){if(!isRecord(value)){throw new TypeError(`tasks.${taskId}.steps[${String(index)}] must be an object`)}const field=`tasks.${taskId}.steps[${String(index)}]`;const id=readTranscriptString(value.id,`${field}.id`);const args=readTranscriptStringArray(value.args,`${field}.args`,true);const expectedExitCode=value.expected_exit_code;if(typeof expectedExitCode!=="number"||!Number.isSafeInteger(expectedExitCode)){throw new TypeError(`${field}.expected_exit_code must be a safe integer`)}const rawOutputKind=value.expected_output_kind;if(rawOutputKind!=="refusal"&&!PM_OUTPUT_ENVELOPE_KINDS.includes(rawOutputKind)){throw new TypeError(`${field}.expected_output_kind is unsupported`)}const expectedOutputKind=rawOutputKind;const rawAccountingMode=value.expected_accounting_mode;if(!PM_AGENT_TASK_ACCOUNTING_MODES.includes(rawAccountingMode)){throw new TypeError(`${field}.expected_accounting_mode is unsupported`)}const expectedAccountingMode=rawAccountingMode;if(expectedAccountingMode==="independent_transport"&&expectedOutputKind!=="refusal"){throw new TypeError(`${field} independent_transport accounting is supported only for refusal steps`)}const requiredFields=readTranscriptStringArray(value.required_fields,`${field}.required_fields`);if(requiredFields.some(requiredField=>requiredField.split(".").some(segment=>segment.length===0))){throw new TypeError(`${field}.required_fields must contain dot-separated own-property paths`)}const expectedFieldValues=readExpectedFieldValues(value.expected_field_values,`${field}.expected_field_values`);const expectedErrorCode=readOptionalTranscriptString(value.expected_error_code,`${field}.expected_error_code`);const expectedRefusalSurface=readOptionalTranscriptString(value.expected_refusal_surface,`${field}.expected_refusal_surface`);const recoveryFor=readOptionalTranscriptString(value.recovery_for,`${field}.recovery_for`);assertTranscriptStepOutputContract(field,args,expectedExitCode,expectedOutputKind,expectedErrorCode,expectedRefusalSurface);return{id,args,expected_exit_code:expectedExitCode,expected_output_kind:expectedOutputKind,expected_accounting_mode:expectedAccountingMode,required_fields:requiredFields,...expectedFieldValues?{expected_field_values:expectedFieldValues}:{},...expectedErrorCode?{expected_error_code:expectedErrorCode}:{},...expectedRefusalSurface?{expected_refusal_surface:expectedRefusalSurface}:{},...recoveryFor?{recovery_for:recoveryFor}:{}}}function parseAgentTaskTranscript(value,index){if(!isRecord(value)){throw new TypeError(`tasks[${String(index)}] must be an object`)}const id=readTranscriptString(value.id,`tasks[${String(index)}].id`);const description=readTranscriptString(value.description,`tasks.${id}.description`);if(!Array.isArray(value.steps)||value.steps.length===0){throw new TypeError(`tasks.${id}.steps must be a non-empty array`)}const steps=value.steps.map((step,stepIndex)=>parseAgentTaskTranscriptStep(step,id,stepIndex));const priorSteps=new Map;for(const step of steps){if(priorSteps.has(step.id)){throw new TypeError(`tasks.${id} contains duplicate step id ${step.id}`)}if(step.recovery_for!==void 0){const refusal=priorSteps.get(step.recovery_for);if(refusal?.expected_output_kind!=="refusal"||step.expected_output_kind==="refusal"){throw new TypeError(`tasks.${id}.${step.id} recovery_for must reference an earlier refusal and declare successful output`)}}priorSteps.set(step.id,step)}if(steps.at(-1)?.expected_output_kind==="refusal"){throw new TypeError(`tasks.${id} completed task must terminate with successful output`)}for(const step of steps){if(step.expected_output_kind==="refusal"&&!steps.some(candidate=>candidate.recovery_for===step.id)){throw new TypeError(`tasks.${id}.${step.id} refusal must have a later successful recovery_for step`)}}return{id,description,steps}}function parsePmAgentTaskTranscriptCorpus(value){if(!isRecord(value)){throw new TypeError("agent-task transcript corpus must be an object")}if(value.version!==PM_AGENT_TASK_TRANSCRIPT_VERSION){throw new TypeError(`agent-task transcript corpus version must be ${String(PM_AGENT_TASK_TRANSCRIPT_VERSION)}`)}if(!Array.isArray(value.tasks)||value.tasks.length===0){throw new TypeError("agent-task transcript corpus tasks must be non-empty")}const tasks=value.tasks.map((task,index)=>parseAgentTaskTranscript(task,index));const taskIds=new Set;for(const task of tasks){if(taskIds.has(task.id)){throw new TypeError(`duplicate agent-task transcript id ${task.id}`)}taskIds.add(task.id)}return{version:PM_AGENT_TASK_TRANSCRIPT_VERSION,tasks}}export{PM_AGENT_TASK_ACCOUNTING_MODES,PM_AGENT_TASK_TRANSCRIPT_VERSION,parsePmAgentTaskTranscriptCorpus};
 //# sourceMappingURL=task-transcript-contracts.js.map
-//# debugId=006109f8-cb09-5a91-8929-7ac7521753b6

package/dist/sdk/agent/tracker-preflight-contracts.js

@@ -1,127 +1,2 @@
-/**
- * @module sdk/agent/tracker-preflight-contracts
- *
- * Declares and scores executable recovery for tracker filesystem preflight failures.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="941a11a9-f756-56b3-9dc1-8afd78bc9328")}catch(e){}}();
-const TRACKER_PREFLIGHT_RECOVERY_CONTRACTS = [
-    {
-        probe_id: "tracker-root-missing",
-        failure_kind: "missing_root",
-        expected_error_code: "tracker_root_missing",
-        expected_exit_code: 3,
-        recovery_kind: "initialize",
-    },
-    {
-        probe_id: "tracker-root-settings-missing",
-        failure_kind: "settings_missing",
-        expected_error_code: "tracker_not_initialized",
-        expected_exit_code: 3,
-        recovery_kind: "initialize",
-    },
-    {
-        probe_id: "tracker-root-not-directory",
-        failure_kind: "not_directory",
-        expected_error_code: "tracker_root_not_directory",
-        expected_exit_code: 2,
-        recovery_kind: "select_directory",
-    },
-    {
-        probe_id: "tracker-root-unreadable",
-        failure_kind: "unreadable_root",
-        expected_error_code: "tracker_root_unreadable",
-        expected_exit_code: 1,
-        recovery_kind: "repair_permissions",
-    },
-];
-/** Return defensive copies of every core tracker preflight recovery contract. */
-export function listTrackerPreflightRecoveryContracts() {
-    return TRACKER_PREFLIGHT_RECOVERY_CONTRACTS.map((contract) => ({
-        ...contract,
-    }));
-}
-function findTrackerPreflightObservationFindings(contract, observation) {
-    const findings = [];
-    if (observation.error_code !== contract.expected_error_code) {
-        findings.push({
-            code: "error_code_mismatch",
-            probe_id: contract.probe_id,
-            detail: `Expected ${contract.expected_error_code}, received ${observation.error_code}.`,
-        });
-    }
-    if (observation.exit_code !== contract.expected_exit_code) {
-        findings.push({
-            code: "exit_code_mismatch",
-            probe_id: contract.probe_id,
-            detail: `Expected exit ${contract.expected_exit_code}, received ${observation.exit_code}.`,
-        });
-    }
-    if (observation.recovery_kind !== contract.recovery_kind) {
-        findings.push({
-            code: "recovery_kind_mismatch",
-            probe_id: contract.probe_id,
-            detail: `Expected ${contract.recovery_kind}, received ${observation.recovery_kind}.`,
-        });
-    }
-    const initIndex = observation.suggested_retry_args.indexOf("init");
-    const validInitCommand = initIndex === 0 ||
-        (initIndex === 2 &&
-            observation.suggested_retry_args[0] === "--pm-path" &&
-            observation.suggested_retry_args[1]?.length > 0);
-    if (contract.recovery_kind === "initialize" && !validInitCommand) {
-        findings.push({
-            code: "missing_init_recovery",
-            probe_id: contract.probe_id,
-            detail: "Missing and uninitialized roots must emit a tokenized init retry.",
-        });
-    }
-    if (observation.unsafe_init_recommended ||
-        (contract.recovery_kind !== "initialize" &&
-            observation.suggested_retry_args.includes("init"))) {
-        findings.push({
-            code: "unsafe_init_recovery",
-            probe_id: contract.probe_id,
-            detail: "A tracker root that cannot be initialized safely must not recommend initialization.",
-        });
-    }
-    if (!observation.retry_succeeded) {
-        findings.push({
-            code: "retry_failed",
-            probe_id: contract.probe_id,
-            detail: "The emitted retry or safe alternate-root recovery did not execute successfully.",
-        });
-    }
-    return findings;
-}
-/** Score runtime observations against the complete tracker preflight recovery corpus. */
-export function scoreTrackerPreflightRecoveryClosure(observations) {
-    const observationsByProbe = new Map(observations.map((observation) => [observation.probe_id, observation]));
-    const findings = [];
-    let closedProbeCount = 0;
-    for (const contract of TRACKER_PREFLIGHT_RECOVERY_CONTRACTS) {
-        const observation = observationsByProbe.get(contract.probe_id);
-        if (observation === undefined) {
-            findings.push({
-                code: "missing_probe",
-                probe_id: contract.probe_id,
-                detail: "No runtime observation was supplied for this contract.",
-            });
-            continue;
-        }
-        const observationFindings = findTrackerPreflightObservationFindings(contract, observation);
-        findings.push(...observationFindings);
-        if (observationFindings.length === 0)
-            closedProbeCount += 1;
-    }
-    findings.sort((left, right) => left.probe_id.localeCompare(right.probe_id) ||
-        left.code.localeCompare(right.code));
-    return {
-        ok: findings.length === 0,
-        probe_count: TRACKER_PREFLIGHT_RECOVERY_CONTRACTS.length,
-        closed_probe_count: closedProbeCount,
-        findings,
-    };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5053cc84-63e5-50d3-9a4c-00c2a485ed69")}catch(e2){}})();const TRACKER_PREFLIGHT_RECOVERY_CONTRACTS=[{probe_id:"tracker-root-missing",failure_kind:"missing_root",expected_error_code:"tracker_root_missing",expected_exit_code:3,recovery_kind:"initialize"},{probe_id:"tracker-root-settings-missing",failure_kind:"settings_missing",expected_error_code:"tracker_not_initialized",expected_exit_code:3,recovery_kind:"initialize"},{probe_id:"tracker-root-not-directory",failure_kind:"not_directory",expected_error_code:"tracker_root_not_directory",expected_exit_code:2,recovery_kind:"select_directory"},{probe_id:"tracker-root-unreadable",failure_kind:"unreadable_root",expected_error_code:"tracker_root_unreadable",expected_exit_code:1,recovery_kind:"repair_permissions"}];function listTrackerPreflightRecoveryContracts(){return TRACKER_PREFLIGHT_RECOVERY_CONTRACTS.map(contract=>({...contract}))}function findTrackerPreflightObservationFindings(contract,observation){const findings=[];if(observation.error_code!==contract.expected_error_code){findings.push({code:"error_code_mismatch",probe_id:contract.probe_id,detail:`Expected ${contract.expected_error_code}, received ${observation.error_code}.`})}if(observation.exit_code!==contract.expected_exit_code){findings.push({code:"exit_code_mismatch",probe_id:contract.probe_id,detail:`Expected exit ${contract.expected_exit_code}, received ${observation.exit_code}.`})}if(observation.recovery_kind!==contract.recovery_kind){findings.push({code:"recovery_kind_mismatch",probe_id:contract.probe_id,detail:`Expected ${contract.recovery_kind}, received ${observation.recovery_kind}.`})}const initIndex=observation.suggested_retry_args.indexOf("init");const validInitCommand=initIndex===0||initIndex===2&&observation.suggested_retry_args[0]==="--pm-path"&&observation.suggested_retry_args[1]?.length>0;if(contract.recovery_kind==="initialize"&&!validInitCommand){findings.push({code:"missing_init_recovery",probe_id:contract.probe_id,detail:"Missing and uninitialized roots must emit a tokenized init retry."})}if(observation.unsafe_init_recommended||contract.recovery_kind!=="initialize"&&observation.suggested_retry_args.includes("init")){findings.push({code:"unsafe_init_recovery",probe_id:contract.probe_id,detail:"A tracker root that cannot be initialized safely must not recommend initialization."})}if(!observation.retry_succeeded){findings.push({code:"retry_failed",probe_id:contract.probe_id,detail:"The emitted retry or safe alternate-root recovery did not execute successfully."})}return findings}function scoreTrackerPreflightRecoveryClosure(observations){const observationsByProbe=new Map(observations.map(observation=>[observation.probe_id,observation]));const findings=[];let closedProbeCount=0;for(const contract of TRACKER_PREFLIGHT_RECOVERY_CONTRACTS){const observation=observationsByProbe.get(contract.probe_id);if(observation===void 0){findings.push({code:"missing_probe",probe_id:contract.probe_id,detail:"No runtime observation was supplied for this contract."});continue}const observationFindings=findTrackerPreflightObservationFindings(contract,observation);findings.push(...observationFindings);if(observationFindings.length===0)closedProbeCount+=1}findings.sort((left,right)=>left.probe_id.localeCompare(right.probe_id)||left.code.localeCompare(right.code));return{ok:findings.length===0,probe_count:TRACKER_PREFLIGHT_RECOVERY_CONTRACTS.length,closed_probe_count:closedProbeCount,findings}}export{listTrackerPreflightRecoveryContracts,scoreTrackerPreflightRecoveryClosure};
 //# sourceMappingURL=tracker-preflight-contracts.js.map
-//# debugId=941a11a9-f756-56b3-9dc1-8afd78bc9328