@unbrained/pm-cli 2026.8.12 → 2026.8.14

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]="c0995490-5838-5c91-af77-9ce387e41a1f")}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";
@@ -224,19 +224,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 +262,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 +742,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) {
@@ -1564,55 +1605,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,
+            },
         };
     });
 }
@@ -1785,8 +1880,8 @@ function attachCommanderAliasContractsResult(result, selection) {
     result.commander_aliases_omitted_reason = "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,14 +1899,14 @@ 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);
     }
@@ -1872,4 +1967,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=651d4904-cae5-503b-8418-93bc44a413ad
+//# debugId=c0995490-5838-5c91-af77-9ce387e41a1f

package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts

@@ -303,6 +303,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
             negative_control?: undefined;
             assertion_ids?: undefined;
             triggers?: undefined;
+            provider_policy?: undefined;
         };
         oneOf?: undefined;
         allOf?: undefined;
@@ -463,6 +464,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
             source?: undefined;
             assertion_ids?: undefined;
             triggers?: undefined;
+            provider_policy?: undefined;
         };
     } | {
         type: string;
@@ -491,6 +493,36 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                     enum: string[];
                 };
             };
+            provider_policy: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    allowed_providers: {
+                        type: string;
+                        items: {
+                            type: string;
+                            minLength: number;
+                        };
+                    };
+                    triggers: {
+                        type: string;
+                        additionalProperties: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                max_cost_class: {
+                                    enum: string[];
+                                };
+                                allow_network: {
+                                    type: string;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
             max_cost?: undefined;
             source?: undefined;
             measurement_id?: undefined;

package/dist/sdk/cli-contracts/schemas/assurance-definition.js

@@ -4,7 +4,7 @@
  * Defines the strict JSON Schema accepted by assurance definition mutations.
  */
 
-!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]="2d81fb20-890a-553b-b761-d60caf56b502")}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]="19a97f60-3b6e-5653-a652-02aebaf5afdd")}catch(e){}}();
 const ASSURANCE_VALUE_SCHEMA = {
     oneOf: [{ type: "number" }, { type: "array", items: { type: "string" } }],
 };
@@ -244,9 +244,32 @@ export const ASSURANCE_DEFINITION_SCHEMA = {
                         ],
                     },
                 },
+                provider_policy: {
+                    type: "object",
+                    additionalProperties: false,
+                    required: ["allowed_providers", "triggers"],
+                    properties: {
+                        allowed_providers: {
+                            type: "array",
+                            items: { type: "string", minLength: 1 },
+                        },
+                        triggers: {
+                            type: "object",
+                            additionalProperties: {
+                                type: "object",
+                                additionalProperties: false,
+                                required: ["max_cost_class", "allow_network"],
+                                properties: {
+                                    max_cost_class: { enum: ["low", "medium", "high"] },
+                                    allow_network: { type: "boolean" },
+                                },
+                            },
+                        },
+                    },
+                },
             },
         },
     ],
 };
 //# sourceMappingURL=assurance-definition.js.map
-//# debugId=2d81fb20-890a-553b-b761-d60caf56b502
+//# debugId=19a97f60-3b6e-5653-a652-02aebaf5afdd

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]="6cdf1fd1-7328-5bae-9238-d317f6efba8a")}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]="9a679120-6f16-5588-b4d4-91c90a2fe385")}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";
@@ -219,6 +219,8 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     acceptanceCriteria: { type: "string" },
     author: { type: "string" },
     message: { type: "string" },
+    owner: { type: "string" },
+    enforcement: { type: "string" },
     assignee: { type: "string" },
     assigneeFilter: { type: "string", enum: ["assigned", "unassigned"] },
     parent: { type: "string" },
@@ -646,8 +648,24 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES = {
         },
         subcommand: {
             type: "string",
-            enum: ["list", "show", "put", "remove", "run", "verdicts"],
+            enum: [
+                "list",
+                "show",
+                "put",
+                "remove",
+                "run",
+                "verdicts",
+                "presets",
+                "apply",
+                "derive",
+                "promote",
+            ],
+        },
+        preset: {
+            type: "string",
+            enum: ["software-delivery", "research", "agent-evaluation", "operations"],
         },
+        enforcement: { type: "string", enum: ["warn", "block"] },
         limit: { type: "integer", minimum: 1, maximum: 1000 },
     },
     activity: {
@@ -970,6 +988,14 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "Stable assurance gate id used to filter durable verdict history.",
         examples: ["release-readiness"],
     },
+    owner: {
+        description: "pm item that owns preset or observation-derived assurance assertions.",
+        examples: ["pm-a1b2"],
+    },
+    enforcement: {
+        description: "Explicit next assurance enforcement level.",
+        examples: ["warn", "block"],
+    },
     runId: {
         description: "Background test run identifier.",
         examples: ["tr-kq9x3f-93acde"],
@@ -1850,8 +1876,8 @@ export const PM_TOOL_PARAMETER_METADATA = {
 export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     assurance: {
         subcommand: {
-            description: "Assurance operation: list, show, put, remove, run, or verdicts.",
-            examples: ["list", "run", "verdicts"],
+            description: "Assurance operation: list, show, put, remove, run, verdicts, presets, apply, derive, or promote.",
+            examples: ["list", "run", "derive", "promote"],
         },
         kind: {
             description: "Assurance declaration kind for registry operations: measurement, assertion, or gate.",
@@ -1865,6 +1891,10 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
             description: "Maximum number of newest assurance verdicts returned.",
             examples: [10, 25],
         },
+        preset: {
+            description: "Built-in assurance project shape to preview or apply.",
+            examples: ["software-delivery", "agent-evaluation"],
+        },
     },
     update: {
         acceptanceCriteria: {
@@ -2019,4 +2049,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=6cdf1fd1-7328-5bae-9238-d317f6efba8a
+//# debugId=9a679120-6f16-5588-b4d4-91c90a2fe385

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]="5a184f36-a305-59f1-8c68-ef53cea1df1e")}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]="d4550d60-3907-528e-b984-c8ca90b7a4e8")}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";
@@ -1119,6 +1119,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "dryRun",
             "author",
             "message",
+            "preset",
+            "owner",
+            "apply",
+            "enforcement",
         ],
         conditionalRequired: [
             { property: "subcommand", value: "list", required: ["kind"] },
@@ -1130,6 +1134,17 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             },
             { property: "subcommand", value: "remove", required: ["kind", "id"] },
             { property: "subcommand", value: "run", required: ["id", "trigger"] },
+            {
+                property: "subcommand",
+                value: "apply",
+                required: ["preset", "owner"],
+            },
+            { property: "subcommand", value: "derive", required: ["owner"] },
+            {
+                property: "subcommand",
+                value: "promote",
+                required: ["id", "enforcement"],
+            },
         ],
     },
     gc: { optional: ["dryRun", "gcScope"] },
@@ -1558,4 +1573,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=5a184f36-a305-59f1-8c68-ef53cea1df1e
+//# debugId=d4550d60-3907-528e-b984-c8ca90b7a4e8

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]="304d0901-79d3-593d-a789-410e28d59948")}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,7 +27,7 @@ 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-row-contract", "Include the machine-readable row selector and TOON encoding contract")
@@ -45,4 +45,4 @@ export function createPmCliProgram(version) {
         .exitOverride();
 }
 //# sourceMappingURL=cli-program.js.map
-//# debugId=b799c7c2-21b8-5c19-8565-7166e6f06a90
+//# debugId=304d0901-79d3-593d-a789-410e28d59948

package/dist/sdk/comments.js

@@ -4,7 +4,8 @@
  * Implements the pm comments 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]="667218ac-866c-59b1-8309-18ad92434fca")}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]="a7687052-a04e-536e-ace5-a665ebd477e3")}catch(e){}}();
+import { isFileAbsentError } from "../core/fs/fs-utils.js";
 import { readFile } from "node:fs/promises";
 import { EXIT_CODE, PmCliError, createStdinTokenResolver, } from "./runtime-primitives.js";
 import { isErrnoError, parseAnnotationTextInput, runAnnotationCommand, } from "./annotations.js";
@@ -36,7 +37,7 @@ async function resolveCommentTextSource(options, stdinResolver) {
         return { value: fileInput, emptyFlag: "--file" };
     }
     catch (error) {
-        if (isErrnoError(error) && error.code === "ENOENT") {
+        if (isErrnoError(error) && isFileAbsentError(error)) {
             throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);
         }
         const detail = error instanceof Error ? error.message : String(error);
@@ -122,4 +123,4 @@ export async function runComments(id, options, global) {
     });
 }
 //# sourceMappingURL=comments.js.map
-//# debugId=667218ac-866c-59b1-8309-18ad92434fca
+//# debugId=a7687052-a04e-536e-ace5-a665ebd477e3

package/dist/sdk/compile-cache.js

@@ -5,7 +5,8 @@
  * compile-cache generations.
  */
 
-!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]="6748a283-bc93-5783-98c1-d1a7f2fdce4e")}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]="611e9aba-d08e-5c1a-89c9-c7fda0cc9bc9")}catch(e){}}();
+import { isFileMissingError } from "../core/fs/fs-utils.js";
 import fs from "node:fs";
 import path from "node:path";
 const COMPILE_CACHE_CONCURRENT_GRACE_MS = 5 * 60 * 1000;
@@ -44,7 +45,7 @@ export function pruneCompileCacheGenerations(cacheRoot, currentGeneration) {
         catch (error) {
             if (error instanceof Error &&
                 "code" in error &&
-                error.code === "ENOENT") {
+                isFileMissingError(error)) {
                 return [];
             }
             throw error;
@@ -70,4 +71,4 @@ export function pruneCompileCacheGenerations(cacheRoot, currentGeneration) {
     return { retained: normalizedGeneration, removed };
 }
 //# sourceMappingURL=compile-cache.js.map
-//# debugId=6748a283-bc93-5783-98c1-d1a7f2fdce4e
+//# debugId=611e9aba-d08e-5c1a-89c9-c7fda0cc9bc9

package/dist/sdk/compose.d.ts

@@ -25,7 +25,7 @@
  * declarative (`composeExtension`) authoring styles live together. Both are
  * re-exported from the SDK barrel, so the public API is unchanged.
  */
-import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, ExtensionApi, ExtensionCapability, ExtensionManifest, ExtensionServiceName, Exporter, FlagDefinition, ImportExportRegistrationOptions, Importer, OnIndexHook, OnReadHook, OnWriteHook, OutputRendererFormat, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, VectorStoreAdapterDefinition } from "../core/extensions/loader.js";
+import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, ExtensionApi, ExtensionCapability, ExtensionManifest, ExtensionServiceName, Exporter, FlagDefinition, ImportExportRegistrationOptions, Importer, OnIndexHook, OnReadHook, OnWriteHook, OutputRendererFormat, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, VectorStoreAdapterDefinition, AssuranceMeasurementProviderDefinition } from "../core/extensions/loader.js";
 import type { ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
 import type { ProjectProfileRegistrationInput } from "../core/profile/profile-presets.js";
 import type { PmMaxVersionExceededMode } from "../core/extensions/extension-types.js";
@@ -152,6 +152,8 @@ export interface ExtensionBlueprint {
     searchProviders?: SearchProviderDefinition[];
     /** Vector store adapters registered via `api.registerVectorStoreAdapter(adapter)`. */
     vectorStoreAdapters?: VectorStoreAdapterDefinition[];
+    /** Assurance measurement providers registered via `api.registerAssuranceMeasurementProvider(provider)`. */
+    assuranceProviders?: AssuranceMeasurementProviderDefinition[];
     /** Importers registered via `api.registerImporter(name, importer, options?)`. */
     importers?: ExtensionBlueprintImporter[];
     /** Exporters registered via `api.registerExporter(name, exporter, options?)`. */