@unbrained/pm-cli 2026.8.11 → 2026.8.13

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

@@ -73,6 +73,9 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         equals: {
                             type: string[];
                         };
+                        state: {
+                            enum: string[];
+                        };
                         dependency_kind?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
@@ -81,7 +84,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -103,6 +105,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
                         op?: undefined;
@@ -110,7 +113,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -138,13 +140,13 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         types?: undefined;
                         tags?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         op?: undefined;
                         author?: undefined;
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -176,11 +178,11 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                         expression?: undefined;
@@ -241,6 +243,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         operation?: undefined;
                         op?: undefined;
@@ -248,7 +251,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         expression?: undefined;
                     };
                     allOf?: undefined;
@@ -269,6 +271,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         tags?: undefined;
                         field?: undefined;
                         equals?: undefined;
+                        state?: undefined;
                         dependency_kind?: undefined;
                         operation?: undefined;
                         parameters?: undefined;
@@ -277,7 +280,6 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
                         harness?: undefined;
                         model?: undefined;
                         link?: undefined;
-                        state?: undefined;
                         provider?: undefined;
                         key?: undefined;
                     };
@@ -301,6 +303,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
             negative_control?: undefined;
             assertion_ids?: undefined;
             triggers?: undefined;
+            provider_policy?: undefined;
         };
         oneOf?: undefined;
         allOf?: undefined;
@@ -461,6 +464,7 @@ export declare const ASSURANCE_DEFINITION_SCHEMA: {
             source?: undefined;
             assertion_ids?: undefined;
             triggers?: undefined;
+            provider_policy?: undefined;
         };
     } | {
         type: string;
@@ -489,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]="13e7d51c-8464-578c-8780-5ddb6e029705")}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" } }],
 };
@@ -14,7 +14,7 @@ const ITEMS_FIELD_CONDITIONAL_SCHEMA = {
 // Keep the JSON Schema keyword visible while avoiding unicorn/no-thenable,
 // which intentionally rejects object literals with a `then` property.
 Reflect.set(ITEMS_FIELD_CONDITIONAL_SCHEMA, "then", {
-    required: ["equals"],
+    oneOf: [{ required: ["equals"] }, { required: ["state"] }],
 });
 /** JSON Schema for measurement, assertion, and gate assurance definitions. */
 export const ASSURANCE_DEFINITION_SCHEMA = {
@@ -41,6 +41,7 @@ export const ASSURANCE_DEFINITION_SCHEMA = {
                                 tags: { type: "array", items: { type: "string" } },
                                 field: { type: "string" },
                                 equals: { type: ["string", "number", "boolean", "null"] },
+                                state: { enum: ["present", "missing"] },
                             },
                         },
                         {
@@ -243,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=13e7d51c-8464-578c-8780-5ddb6e029705
+//# debugId=19a97f60-3b6e-5653-a652-02aebaf5afdd

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

@@ -1,6 +1,6 @@
 /** Returns fresh option contract objects so exported arrays cannot share mutable entries. */
 
-!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]="26955ae3-1aca-503e-9492-46652285d17a")}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]="e2028eff-b29e-5850-87b1-4a3e06f28964")}catch(e){}}();
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -351,6 +351,7 @@ export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
     { param: "limit", flag: "--limit" },
     { param: "unbounded", flag: "--unbounded" },
     { param: "compact", flag: "--compact" },
+    { param: "raw", flag: "--raw" },
     { param: "full", flag: "--full" },
     { param: "provenance", flag: "--provenance" },
     { param: "provenanceSummary", flag: "--provenance-summary" },
@@ -423,4 +424,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=26955ae3-1aca-503e-9492-46652285d17a
+//# debugId=e2028eff-b29e-5850-87b1-4a3e06f28964

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]="28d82e94-0359-5ae8-87f1-145f412df35e")}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";
@@ -55,6 +55,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
             },
         ],
     },
+    outputRowContract: { type: "boolean" },
     path: { type: "string" },
     pmExecutable: { type: "string" },
     timeoutMs: { type: "number" },
@@ -218,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" },
@@ -260,8 +263,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     semanticWeight: { anyOf: [{ type: "string" }, { type: "number" }] },
     op: { type: "string" },
     compact: { type: "boolean" },
+    raw: { type: "boolean" },
     brief: { type: "boolean" },
     full: { type: "boolean" },
+    includeEmpty: { type: "boolean" },
     view: { type: "string", enum: ["agenda", "day", "week", "month"] },
     date: { type: "string" },
     from: { type: "string" },
@@ -370,6 +375,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     verboseAuthorEvents: { type: "boolean" },
     match: { type: "string" },
     onlyIndex: { anyOf: [{ type: "string" }, { type: "number" }] },
+    removeIndex: {
+        type: "array",
+        items: { anyOf: [{ type: "string" }, { type: "number" }] },
+    },
     onlyLast: { type: "boolean" },
     envSet: { type: "array", items: { type: "string" } },
     envClear: { type: "array", items: { type: "string" } },
@@ -639,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: {
@@ -934,6 +959,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
             },
         ],
     },
+    outputRowContract: {
+        description: "Include the row selector and TOON row-encoding contract on a read result.",
+    },
     profile: {
         description: "Emit deterministic timing diagnostics to stderr.",
     },
@@ -960,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"],
@@ -1299,6 +1335,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "Run only the 1-based linked-test index from pm test <id> --list order.",
         examples: [1, "2"],
     },
+    removeIndex: {
+        description: "Remove linked tests by their 1-based positions from pm test <id> --list order; repeatable and lossless for commands containing commas or equals signs.",
+        examples: [[1], ["2", "4"]],
+    },
     onlyLast: {
         description: "Run only the most recently added linked-test entry.",
     },
@@ -1656,6 +1696,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     compact: {
         description: "Render compact projection output for search and list-family actions.",
     },
+    raw: {
+        description: "For activity, restore the compact per-event stream instead of the default item digest.",
+    },
     brief: {
         description: "Emit compact low-token output for commands that support terse projections or health details.",
         examples: [true],
@@ -1663,6 +1706,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     full: {
         description: "Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history.",
     },
+    includeEmpty: {
+        description: "For stats, restore zero-count registered type and lifecycle-status buckets.",
+    },
     fields: {
         description: "Comma-separated projection fields for get, search, list-family, or context outputs. Valid field names are command-specific (e.g. score/matched_fields apply to search; context projects focus-row fields such as priority/deadline/completion_pct).",
         examples: [
@@ -1830,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.",
@@ -1845,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: {
@@ -1999,4 +2049,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=28d82e94-0359-5ae8-87f1-145f412df35e
+//# debugId=9a679120-6f16-5588-b4d4-91c90a2fe385

package/dist/sdk/cli-contracts/tool-schema.d.ts

@@ -90,8 +90,8 @@ export interface PmActionToolInputSchemaOptions {
  * `PM_TOOL_PARAMETERS_SCHEMA`, eliminating a hand-maintained MCP schema table.
  */
 export declare function buildPmActionToolInputSchema(action: PmToolAction, options?: PmActionToolInputSchemaOptions): Record<string, unknown>;
-/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and the contract tests all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz). Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.6.0";
+/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
+export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.7.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.

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]="9882d78a-8742-5d50-b345-debe47322b65")}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";
@@ -31,6 +31,7 @@ const PM_TOOL_READ_OUTPUT_PARAMETER_KEYS = [
     "outputBudget",
     "outputFormat",
     "outputSession",
+    "outputRowContract",
 ];
 /** Canonical top-level MCP properties that take precedence over runtime custom fields. */
 export const PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES = new Set([
@@ -959,6 +960,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "add",
             "addJson",
             "remove",
+            "removeIndex",
             "run",
             "match",
             "onlyIndex",
@@ -1027,6 +1029,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     },
     stats: {
         optional: [
+            "includeEmpty",
             "storage",
             "metadataCoverage",
             "fieldUtilization",
@@ -1116,6 +1119,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "dryRun",
             "author",
             "message",
+            "preset",
+            "owner",
+            "apply",
+            "enforcement",
         ],
         conditionalRequired: [
             { property: "subcommand", value: "list", required: ["kind"] },
@@ -1127,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"] },
@@ -1472,8 +1490,8 @@ function createLazyContractSchema(build) {
         },
     });
 }
-/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and the contract tests all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz). Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.6.0";
+/** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.7.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
@@ -1555,4 +1573,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=9882d78a-8742-5d50-b345-debe47322b65
+//# 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]="a410d336-c332-56fc-9a5d-7841a2b3dfa5")}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]="b799c7c2-21b8-5c19-8565-7166e6f06a90")}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. */
@@ -30,6 +30,7 @@ export function createPmCliProgram(version) {
         .option("--output-budget <tokens>", "Bound estimated tokens in read output")
         .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")
         .option("--quiet", "Suppress stdout output")
         .option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)")
         .option("--full-changed-fields", "Restore the legacy full mutation envelope and changed_fields array")
@@ -44,4 +45,4 @@ export function createPmCliProgram(version) {
         .exitOverride();
 }
 //# sourceMappingURL=cli-program.js.map
-//# debugId=a410d336-c332-56fc-9a5d-7841a2b3dfa5
+//# debugId=b799c7c2-21b8-5c19-8565-7166e6f06a90

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