@unbrained/pm-cli 2026.8.13 → 2026.8.15

package/dist/sdk/cli-contracts/runtime-contracts.js

@@ -4,7 +4,7 @@
  * Implements the pm contracts command surface and its agent-facing runtime behavior.
  */
 
-!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]="651d4904-cae5-503b-8418-93bc44a413ad")}catch(e){}}();
+!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]="8cdd82c3-979e-5f7f-bc72-592c7e55f11c")}catch(e){}}();
 import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
@@ -18,6 +18,7 @@ import { PM_ERROR_CODE_CATALOG } from "../generated-error-code-catalog.js";
 import { resolvePmCommandOutputEnvelope, } from "../output-contracts.js";
 import { PM_COMMAND_EXIT_OUTCOME_CONTRACTS, resolvePmCommandExitContract, } from "./command-exit-contracts.js";
 import { BUILTIN_RELATIONSHIP_KINDS } from "../relationship-kinds/contract.js";
+import { ASSURANCE_GATE_TRIGGERS, ASSURANCE_MEASUREMENT_SOURCE_KINDS, } from "../governance/assurance.js";
 const AGENT_BOOTSTRAP_FLAGS = new Map([
     [
         "claim",
@@ -224,19 +225,33 @@ const COMMAND_INTENTS = new Map([
     ["activity", "Read activity."],
     ["aggregate", "Group counts."],
     ["append", "Append body."],
+    ["assurance", "Evaluate assurance."],
+    ["beads", "Manage Beads interoperability."],
+    ["cal", "Manage calendar integration."],
+    ["calendar", "Manage calendar integration."],
+    ["changelog", "Generate changelog output."],
     ["claim", "Claim work."],
     ["close", "Close work."],
+    ["close-many", "Close matching work."],
+    ["close-task", "Close task work."],
+    ["command-kit", "Inspect command authoring primitives."],
     ["comments", "Manage comments."],
+    ["comments-audit", "Audit comment governance."],
     ["completion", "Generate shell completions."],
     ["config", "Manage settings."],
     ["context", "Build context."],
     ["contracts", "Inspect contracts."],
     ["copy", "Copy work."],
     ["create", "Create work."],
+    ["dedupe-audit", "Audit duplicate work."],
+    ["dedupe-merge", "Merge duplicate work."],
     ["delete", "Delete work."],
     ["deps", "Manage deps."],
     ["duplicates", "Find duplicate clusters."],
     ["docs", "Link docs."],
+    ["eval", "Run evaluations."],
+    ["event", "Manage events."],
+    ["events", "Read events."],
     ["files", "Link files."],
     ["focus", "Manage focus."],
     ["gc", "Clean caches."],
@@ -248,26 +263,53 @@ const COMMAND_INTENTS = new Map([
     ["history", "Inspect history."],
     ["init", "Initialize workspace."],
     ["install", "Install packages."],
+    ["item", "Mutate work through typed operations."],
     ["learnings", "Manage learnings."],
     ["list", "List work."],
+    ["list-all", "List work across every status."],
+    ["list-blocked", "List blocked work."],
+    ["list-canceled", "List canceled work."],
+    ["list-closed", "List closed work."],
+    ["list-draft", "List draft work."],
+    ["list-in-progress", "List in-progress work."],
+    ["list-open", "List open work."],
+    ["meet", "Record meeting context."],
+    ["merge", "Manage tracker merges."],
     ["next", "Pick next work."],
     ["notes", "Manage notes."],
+    ["normalize", "Normalize tracker data."],
     ["ops", "Run operations."],
     ["package", "Manage packages."],
+    ["packages", "Manage packages."],
+    ["pause-task", "Pause task work."],
     ["plan", "Manage plans."],
     ["profile", "Manage profiles."],
     ["reindex", "Refresh search index."],
     ["release", "Release claim."],
+    ["remind", "Manage reminders."],
     ["restore", "Restore history."],
     ["schema", "Customize schema."],
     ["search", "Search work."],
+    ["search-advanced", "Run advanced search."],
+    ["start-task", "Start task work."],
     ["stats", "Show stats."],
     ["telemetry", "Manage telemetry."],
+    ["templates", "Manage work templates."],
     ["test", "Run linked tests."],
+    ["test-all", "Run all linked tests."],
+    ["test-runs", "Inspect background test runs."],
+    ["todos", "Manage source-code todos."],
+    ["twin", "Manage repository twins."],
     ["update", "Update work."],
+    ["update-many", "Update matching work."],
     ["upgrade", "Upgrade packages."],
     ["validate", "Validate data."],
+    ["vcs", "Inspect version-control context."],
     ["workspace", "Manage portable workspace primitives."],
+    ["history-author-acknowledge", "Acknowledge reviewed history authors."],
+    ["history-compact", "Compact history."],
+    ["history-redact", "Redact sensitive history values."],
+    ["history-repair", "Repair history integrity."],
 ]);
 // Lifecycle subcommand flag contracts for `pm extension`. Only `init` differs
 // between extension and package: `pm package init` / `pm packages init`
@@ -701,29 +743,29 @@ function collectExtensionCommandContracts(runtimeProbe) {
     const contracts = [];
     for (const command of [...extensionCommands].sort((left, right) => left.localeCompare(right))) {
         const definition = definitionsByCommand.get(command);
-        if (definition) {
-            contracts.push({
-                ...definition,
-                flags: definition.flags.length > 0
-                    ? definition.flags
-                    : (flagsByCommand.get(command)?.flags ?? []),
-            });
-            continue;
-        }
-        contracts.push({
-            command,
-            action: normalizeActionNameFromCommand(command),
-            source: null,
-            description: null,
-            intent: null,
-            arguments: [],
-            flags: flagsByCommand.get(command)?.flags ?? [],
-            examples: [],
-            failure_hints: [],
-        });
+        contracts.push(buildCollectedExtensionCommandContract(command, definition, flagsByCommand.get(command)?.flags ?? []));
     }
     return contracts;
 }
+function buildCollectedExtensionCommandContract(command, definition, registeredFlags) {
+    if (definition) {
+        return {
+            ...definition,
+            flags: definition.flags.length > 0 ? definition.flags : registeredFlags,
+        };
+    }
+    return {
+        command,
+        action: normalizeActionNameFromCommand(command),
+        source: null,
+        description: null,
+        intent: null,
+        arguments: [],
+        flags: registeredFlags,
+        examples: [],
+        failure_hints: [],
+    };
+}
 function extensionSchemaPropertyNameFromFlag(flag) {
     const normalized = flag.flag.replace(/^-+/, "").trim();
     if (normalized.length === 0) {
@@ -1287,7 +1329,8 @@ function resolveContractsSelection(options) {
         fullOutput,
         omitUnfilteredSchema: unfilteredDefaultBriefMode,
         omitUnfilteredCommandFlags: unfilteredDefaultBriefMode,
-        omitUnfilteredCommanderAliases: unfilteredDefaultBriefMode,
+        omitUnfilteredCommanderAliases: unfilteredDefaultBriefMode ||
+            (selectedCommand !== undefined && !fullOutput),
     };
 }
 function assertSingleContractsProjection(selection) {
@@ -1564,55 +1607,109 @@ function resolveContractsCommands(selection, actionContext) {
 function resolveOutputCommands(_selection, commands) {
     return commands;
 }
-function summarizeCommandIntent(command) {
-    const rootCommand = command.split(" ")[0];
-    return (COMMAND_INTENTS.get(command) ??
-        COMMAND_INTENTS.get(rootCommand) ??
-        "Inspect flags.");
-}
 function canonicalSummaryCommand(command) {
     const rootCommand = command.split(" ")[0];
-    if (rootCommand.startsWith("list-")) {
+    if (rootCommand.startsWith("list-"))
         return "list";
-    }
-    if (rootCommand.startsWith("history-")) {
+    if (rootCommand.startsWith("history-"))
         return "history";
-    }
-    if (rootCommand === "ctx") {
-        return "context";
-    }
-    if (rootCommand === "packages") {
-        return "package";
-    }
     return COMMAND_ALIAS_TO_CANONICAL.get(rootCommand) ?? rootCommand;
 }
-function buildCommandSummarySurface(commands) {
-    const rootsByCanonical = new Map();
-    for (const command of commands) {
-        const root = command.split(" ")[0];
-        const canonical = canonicalSummaryCommand(root);
-        const roots = rootsByCanonical.get(canonical) ?? new Set();
-        roots.add(root);
-        rootsByCanonical.set(canonical, roots);
+const COMMAND_OPERATION_INTENTS = new Map([
+    ["activate", "Activate"],
+    ["adopt", "Adopt"],
+    ["adopt-all", "Adopt all"],
+    ["catalog", "Catalog"],
+    ["complete", "Complete"],
+    ["create", "Create"],
+    ["deactivate", "Deactivate"],
+    ["delete", "Delete"],
+    ["describe", "Describe"],
+    ["doctor", "Diagnose"],
+    ["explore", "Explore"],
+    ["init", "Initialize"],
+    ["inspect", "Inspect"],
+    ["install", "Install"],
+    ["list", "List"],
+    ["manage", "Manage"],
+    ["migrate", "Migrate"],
+    ["mutate", "Mutate"],
+    ["reload", "Reload"],
+    ["restore", "Restore"],
+    ["run", "Run"],
+    ["snapshot", "Manage snapshots for"],
+    ["uninstall", "Uninstall"],
+]);
+const COMMAND_INTENT_SUBJECT_OVERRIDES = new Map([
+    ["extension adopt-all", "extensions"],
+    ["package adopt-all", "packages"],
+    ["workspace snapshot list", "workspace snapshots"],
+]);
+function summarizeCommandIntent(command, extensionContracts) {
+    const declared = COMMAND_INTENTS.get(command) ??
+        (command.includes(" ")
+            ? undefined
+            : COMMAND_INTENTS.get(canonicalSummaryCommand(command)));
+    if (declared !== undefined) {
+        return { intent: declared, intent_source: "command" };
+    }
+    const extensionContract = extensionContracts.find((contract) => splitCommandPathAliases(contract.command).includes(command));
+    if (extensionContract?.intent !== null &&
+        extensionContract?.intent !== undefined) {
+        return { intent: extensionContract.intent, intent_source: "command" };
+    }
+    if (extensionContract?.description !== null &&
+        extensionContract?.description !== undefined) {
+        return {
+            intent: extensionContract.description,
+            intent_source: "description",
+        };
     }
-    const rootCommands = [...rootsByCanonical.keys()]
+    const tokens = command.split(" ");
+    const operation = tokens.at(-1);
+    const subject = tokens.slice(0, -1).join(" ");
+    const verb = COMMAND_OPERATION_INTENTS.get(operation);
+    const intentSubject = COMMAND_INTENT_SUBJECT_OVERRIDES.get(command) ?? subject;
+    return {
+        intent: verb === undefined || subject.length === 0
+            ? `Run ${command}.`
+            : `${verb} ${intentSubject}.`,
+        intent_source: "generated",
+    };
+}
+function buildCommandSummarySurface(commands, extensionContracts = []) {
+    return [...new Set(commands.map(normalizeCommandPath))]
         .filter((command) => command.length > 0)
-        .sort((left, right) => left.localeCompare(right));
-    return rootCommands.map((command) => {
+        .sort((left, right) => left.localeCompare(right))
+        .map((command) => {
         const budget = resolvePmCommandOutputBudget(command, {
             generateFallback: true,
         });
-        const availableFlags = new Set(resolveCoreCommandFlags(command).map((contract) => contract.flag));
-        const flags = (AGENT_BOOTSTRAP_FLAGS.get(command) ?? AGENT_BOUNDED_FLAG_PRIORITY).filter((flag) => availableFlags.has(flag));
-        const aliases = [...rootsByCanonical.get(command)]
-            .filter((root) => root !== command)
-            .sort((left, right) => left.localeCompare(right));
+        const rootCommand = command.split(" ")[0];
+        const canonicalRoot = COMMAND_ALIAS_TO_CANONICAL.get(rootCommand) ??
+            (rootCommand.startsWith("list-")
+                ? "list"
+                : rootCommand.startsWith("history-")
+                    ? "history"
+                    : rootCommand);
+        const availableFlags = new Set([
+            ...resolveCoreCommandFlags(command).map((contract) => contract.flag),
+            ...extensionContracts
+                .filter((contract) => splitCommandPathAliases(contract.command).includes(command))
+                .flatMap((contract) => contract.flags.map((flag) => flag.flag)),
+        ]);
+        const flags = (AGENT_BOOTSTRAP_FLAGS.get(command) ??
+            AGENT_BOOTSTRAP_FLAGS.get(canonicalRoot) ??
+            AGENT_BOUNDED_FLAG_PRIORITY).filter((flag) => availableFlags.has(flag));
+        const intent = summarizeCommandIntent(command, extensionContracts);
         return {
             command,
-            ...(aliases.length > 0 ? { aliases } : {}),
-            intent: summarizeCommandIntent(command),
+            ...intent,
             ...(flags.length > 0 ? { flags } : {}),
             default_max_estimated_tokens: budget.default_max_estimated_tokens,
+            default_max_estimated_tokens_by_format: {
+                ...budget.default_max_estimated_tokens_by_format,
+            },
         };
     });
 }
@@ -1686,20 +1783,26 @@ function createContractsResult(selection, schemaContext, actionContext, outputCo
             : {}),
     };
 }
-function attachRuntimeContractsResult(result, runtime) {
+function attachRuntimeContractsResult(result, runtime, selection) {
+    const selectedCommand = selection.selectedCommand;
     result.runtime_schema = {
         statuses: runtime.statusRegistry.definitions.map((definition) => definition.id),
         open_status: runtime.statusRegistry.open_status,
         close_status: runtime.statusRegistry.close_status,
         canceled_status: runtime.statusRegistry.canceled_status,
         types: [...runtime.typeRegistry.types],
-        fields_by_command: Object.fromEntries([...runtime.runtimeFieldRegistry.command_to_fields.entries()].map(([command, definitions]) => [
+        fields_by_command: Object.fromEntries([...runtime.runtimeFieldRegistry.command_to_fields.entries()]
+            .filter(([command]) => selectedCommand === undefined || command === selectedCommand)
+            .map(([command, definitions]) => [
             command,
             [
                 ...new Set(definitions.map((definition) => `--${definition.cli_flag}`)),
             ].sort((left, right) => left.localeCompare(right)),
         ])),
     };
+    if (selectedCommand !== undefined && !selection.fullOutput) {
+        return;
+    }
     result.extension_contracts = {
         capabilities: [...PM_EXTENSION_CAPABILITY_CONTRACTS],
         services: [...PM_EXTENSION_SERVICE_NAME_CONTRACTS],
@@ -1782,11 +1885,13 @@ function attachCommanderAliasContractsResult(result, selection) {
         result.commander_aliases = buildCommanderAliasSurface();
         return;
     }
-    result.commander_aliases_omitted_reason = "unfiltered_default_brief";
+    result.commander_aliases_omitted_reason = selection.selectedCommand
+        ? "command_scoped"
+        : "unfiltered_default_brief";
 }
 /** Attach the compact agent-facing command semantics shared by summary and full projections. */
-function attachAgentCommandContractsResult(result, outputCommands) {
-    result.command_summaries = buildCommandSummarySurface(outputCommands);
+function attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts) {
+    result.command_summaries = buildCommandSummarySurface(outputCommands, extensionCommandContracts);
     result.output_policy = {
         token_estimate: "ceil(utf8_bytes / 4)",
         degradation_ladder: [...PM_OUTPUT_DEGRADATION_STEPS],
@@ -1804,20 +1909,26 @@ export async function runContracts(options, global) {
     const commands = resolveContractsCommands(selection, actionContext);
     const outputCommands = resolveOutputCommands(selection, commands);
     const result = createContractsResult(selection, schemaContext, actionContext, outputCommands);
+    const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
     if (selection.summary || selection.fullOutput) {
-        attachAgentCommandContractsResult(result, outputCommands);
+        attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts);
     }
     if (selection.summary) {
         return result;
     }
     const commandAliases = buildCommandAliasSurface(commands);
-    const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
     if (!(selection.flagsOnly && !selection.fullOutput)) {
-        attachRuntimeContractsResult(result, runtime);
+        attachRuntimeContractsResult(result, runtime, selection);
     }
     attachSchemaContractsResult(result, selection, schemaContext, extensionCommandContracts);
     attachFlagContractsResult(result, selection, runtime, outputCommands, commandAliases);
     attachCommanderAliasContractsResult(result, selection);
+    if (selection.selectedCommand === "assurance" || selection.fullOutput) {
+        result.assurance_contracts = {
+            measurement_source_kinds: [...ASSURANCE_MEASUREMENT_SOURCE_KINDS],
+            gate_triggers: [...ASSURANCE_GATE_TRIGGERS],
+        };
+    }
     // pm-4os2: snapshot the static MCP tool surface in the full projection so
     // `pnpm contracts:check` (CI static gate) fails on unintended inputSchema
     // drift in src/mcp/tool-definitions.ts.
@@ -1872,4 +1983,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=651d4904-cae5-503b-8418-93bc44a413ad
+//# debugId=8cdd82c3-979e-5f7f-bc72-592c7e55f11c

package/dist/sdk/cli-contracts/tool-parameter-tables.js

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Tool Parameter Tables.
  */
 
-!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]="9a679120-6f16-5588-b4d4-91c90a2fe385")}catch(e){}}();
+!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]="ddb90f7e-f3ca-56d8-be75-13e238da306c")}catch(e){}}();
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 import { PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS } from "../read-output-session.js";
 import { ASSURANCE_DEFINITION_SCHEMA } from "./schemas/assurance-definition.js";
@@ -20,7 +20,9 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     outputLimit: {
         anyOf: [{ type: "integer", minimum: 1 }, { const: "unbounded" }],
     },
-    outputBudget: { type: "integer", minimum: 1 },
+    outputBudget: {
+        anyOf: [{ type: "integer", minimum: 1 }, { const: "unbounded" }],
+    },
     outputFormat: { type: "string", enum: ["json", "toon"] },
     outputSession: {
         anyOf: [
@@ -55,6 +57,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
             },
         ],
     },
+    outputCursor: { type: "string", minLength: 1 },
     outputRowContract: { type: "boolean" },
     path: { type: "string" },
     pmExecutable: { type: "string" },
@@ -476,6 +479,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     edit: { type: "integer", minimum: 1 },
     delete: { type: "integer", minimum: 1 },
     dryRun: { type: "boolean" },
+    normalizeProvenance: { type: "boolean" },
     all: { type: "boolean" },
     clear: { type: "boolean" },
     cliOnly: { type: "boolean" },
@@ -940,8 +944,8 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [10, "unbounded"],
     },
     outputBudget: {
-        description: "Universal estimated-token ceiling for a read result.",
-        examples: [600, 1200],
+        description: "Universal estimated-token ceiling for a read result, or unbounded to disable the shared ceiling.",
+        examples: [600, 1200, "unbounded"],
     },
     outputFormat: {
         description: "Universal read-result encoding selector.",
@@ -959,6 +963,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
             },
         ],
     },
+    outputCursor: {
+        description: "Opaque continuation cursor returned when a declared row collection is compacted by the output budget.",
+    },
     outputRowContract: {
         description: "Include the row selector and TOON row-encoding contract on a read result.",
     },
@@ -1393,6 +1400,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     dryRun: {
         description: "Preview command effects without mutating storage artifacts.",
     },
+    normalizeProvenance: {
+        description: "For history-repair: remove invalid legacy provenance observations and emit only aggregate privacy-safe repair evidence.",
+    },
     all: {
         description: "For history-repair action: scan every stream for drift and repair each drifted stream in one audited pass (mutually exclusive with id).",
     },
@@ -2049,4 +2059,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=9a679120-6f16-5588-b4d4-91c90a2fe385
+//# debugId=ddb90f7e-f3ca-56d8-be75-13e238da306c

package/dist/sdk/cli-contracts/tool-schema.js

@@ -7,7 +7,7 @@
  * consumers from a single source of truth.
  */
 
-!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]="d4550d60-3907-528e-b984-c8ca90b7a4e8")}catch(e){}}();
+!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]="aa58e280-0a39-5285-a451-811e60481661")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { TOOL_CREATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, } from "./tool-option-contracts.js";
@@ -31,6 +31,7 @@ const PM_TOOL_READ_OUTPUT_PARAMETER_KEYS = [
     "outputBudget",
     "outputFormat",
     "outputSession",
+    "outputCursor",
     "outputRowContract",
 ];
 /** Canonical top-level MCP properties that take precedence over runtime custom fields. */
@@ -621,7 +622,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     },
     "history-repair": {
         // Exactly one of `id` (single stream) or `all` (bulk drift repair) is required.
-        optional: ["id", "all", "dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+        optional: [
+            "id",
+            "all",
+            "dryRun",
+            "normalizeProvenance",
+            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
+        ],
         oneOfRequired: [["id"], ["all"]],
     },
     "history-author-acknowledge": {
@@ -1573,4 +1580,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=d4550d60-3907-528e-b984-c8ca90b7a4e8
+//# debugId=aa58e280-0a39-5285-a451-811e60481661

package/dist/sdk/cli-program.js

@@ -4,7 +4,7 @@
  * Builds the reusable Commander root that embeds pm's universal global contracts.
  */
 
-!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]="b799c7c2-21b8-5c19-8565-7166e6f06a90")}catch(e){}}();
+!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]="03d46cbf-73bc-50c9-b4e6-e7329ee53076")}catch(e){}}();
 import { Command } from "commander";
 import { writeStdout } from "../core/output/output.js";
 /** Create a fresh pm root program suitable for one-shot CLI or embedded hosts. */
@@ -27,9 +27,10 @@ export function createPmCliProgram(version) {
         .option("--token-accounting", "Attach a bounded per-section token-cost receipt to command output")
         .option("--output-include <fields>", "Retain comma-separated fields or sections in read output")
         .option("--output-limit <count>", "Bound rows in read output")
-        .option("--output-budget <tokens>", "Bound estimated tokens in read output")
+        .option("--output-budget <tokens|unbounded>", "Bound estimated tokens in read output or explicitly disable the default ceiling")
         .option("--output-format <toon|json>", "Select the read-output encoding")
         .option("--output-session <state>", "Carry a JSON session budget and served-item ledger across read calls")
+        .option("--output-cursor <cursor>", "Resume a budget-compacted declared row collection")
         .option("--output-row-contract", "Include the machine-readable row selector and TOON encoding contract")
         .option("--quiet", "Suppress stdout output")
         .option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)")
@@ -45,4 +46,4 @@ export function createPmCliProgram(version) {
         .exitOverride();
 }
 //# sourceMappingURL=cli-program.js.map
-//# debugId=b799c7c2-21b8-5c19-8565-7166e6f06a90
+//# debugId=03d46cbf-73bc-50c9-b4e6-e7329ee53076

package/dist/sdk/context-relevance.js

@@ -6,7 +6,7 @@
  * with core, extension, or project-specific feature stores.
  */
 
-!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]="1f898377-b606-5bfd-932d-6ce5f2f9c717")}catch(e){}}();
+!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]="7eefe5f0-364d-559a-b365-0e7d539ee19e")}catch(e){}}();
 import { runActiveServiceOverride } from "../core/extensions/index.js";
 import { normalizeStatusForRegistry, normalizeStatusInput, } from "../core/item/status.js";
 import { compareTimestampStrings, resolveIsoOrRelative } from "../core/shared/time.js";
@@ -364,8 +364,16 @@ export async function runContextEvaluationScenario(scenario, reader) {
         throw new TypeError("Context evaluation scenarios require non-empty id and rationale values");
     }
     const result = scenario.surface === "context"
-        ? await reader.context({ ...scenario.options, explainRanking: true })
-        : await reader.next({ ...scenario.options, explainRanking: true });
+        ? await reader.context({
+            ...scenario.options,
+            explainRanking: true,
+            outputBudget: "unbounded",
+        })
+        : await reader.next({
+            ...scenario.options,
+            explainRanking: true,
+            outputBudget: "unbounded",
+        });
     const { rankedIds, attribution } = rankingPayloadForScenario(result, scenario.surface);
     const packet = { ...result, ranking: undefined };
     const actualTokens = estimateJsonTokens(packet);
@@ -422,4 +430,4 @@ export async function runContextEvaluationCorpus(scenarios, reader, thresholds)
     return summarizeContextEvaluationReports(reports, thresholds);
 }
 //# sourceMappingURL=context-relevance.js.map
-//# debugId=1f898377-b606-5bfd-932d-6ce5f2f9c717
+//# debugId=7eefe5f0-364d-559a-b365-0e7d539ee19e

package/dist/sdk/core.d.ts

@@ -7,8 +7,8 @@ export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT
 export * from "./core-governance.js";
 export * from "./agent-session-context.js";
 export { isAlreadyClaimedError } from "./lifecycle/claim.js";
-export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
+export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
 export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
-export type { PmReadOutputBudgetExceeded, PmReadOutputDimension, PmReadOutputLegacyAlias, PmReadOutputOptions, PmReadOutputReceipt, PmReadOutputResult, PmReadOutputResultFor, PmReadOutputSurface, PmReadOutputSurfaceContract, } from "./read-output-contracts.js";
+export type { PmReadOutputBudgetExceeded, PmReadOutputContinuation, PmReadOutputCursorEnvelope, PmReadOutputDimension, PmReadOutputLegacyAlias, PmReadOutputOptions, PmReadOutputReceipt, PmReadOutputResult, PmReadOutputResultFor, PmReadOutputSurface, PmReadOutputSurfaceContract, } from "./read-output-contracts.js";
 export type { PmReadOutputSessionReceipt, PmReadOutputSessionReference, PmReadOutputSessionState, } from "./read-output-session.js";
 export type { ItemDocument, ItemMetadata, ItemStatus, ItemType, PmSettings, } from "../types/index.js";

package/dist/sdk/core.js

@@ -4,12 +4,12 @@
  * Provides the stable item lifecycle client and universal project data types.
  */
 
-!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]="2e0a2422-64c7-5ad3-867c-04479171fa27")}catch(e){}}();
+!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]="dfc95179-77dd-5762-9bcc-c6bb461ff553")}catch(e){}}();
 export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, restore, search, update, } from "./runtime.js";
 export * from "./core-governance.js";
 export * from "./agent-session-context.js";
 export { isAlreadyClaimedError } from "./lifecycle/claim.js";
-export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
+export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
 export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
 //# sourceMappingURL=core.js.map
-//# debugId=2e0a2422-64c7-5ad3-867c-04479171fa27
+//# debugId=dfc95179-77dd-5762-9bcc-c6bb461ff553

package/dist/sdk/generated/generated-error-code-catalog-part-1.js

@@ -1,6 +1,6 @@
 /** Generated partition 1 of the exhaustive error-code catalog. */
 
-!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]="92b7b390-4d50-5210-8209-9ade302498c2")}catch(e){}}();
+!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]="3891c17c-c79d-54d4-8b62-da8fe9c1eaf4")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -1592,6 +1592,30 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "manifest_capabilities_absent",
         aliases: [],
     },
+    {
+        code: "merge_conflict_markers_detected",
+        meaning: "Merge conflict markers detected condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/item/item-format.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "merge_conflict_markers_detected",
+        aliases: ["history_merge_conflict_markers_detected"],
+    },
+    {
+        code: "merge_decisions_unreviewed",
+        meaning: "Merge decisions unreviewed condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "merge_decisions_unreviewed",
+        aliases: [],
+    },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=92b7b390-4d50-5210-8209-9ade302498c2
+//# debugId=3891c17c-c79d-54d4-8b62-da8fe9c1eaf4