@unbrained/pm-cli 2026.8.14 → 2026.8.15

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]="304d0901-79d3-593d-a789-410e28d59948")}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. */
@@ -30,6 +30,7 @@ export function createPmCliProgram(version) {
         .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=304d0901-79d3-593d-a789-410e28d59948
+//# debugId=03d46cbf-73bc-50c9-b4e6-e7329ee53076

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

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

@@ -1,31 +1,7 @@
 /** Generated partition 2 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]="b129c0ca-3d57-551c-945c-300547b74ff5")}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]="5d64a86d-6ba6-5bbe-a83a-9703690a851e")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
-    {
-        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: [],
-    },
     {
         code: "merge_git_config_unwritable",
         meaning: "Merge git config unwritable condition.",
@@ -363,6 +339,54 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "project_runtime_stale_read",
         aliases: [],
     },
+    {
+        code: "provenance_value_domain_invalid",
+        meaning: "Provenance value domain invalid condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "provenance_value_domain_invalid",
+        aliases: [],
+    },
+    {
+        code: "read_output_cursor_command_mismatch",
+        meaning: "Read output cursor command mismatch condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/read-output/continuation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "read_output_cursor_command_mismatch",
+        aliases: [],
+    },
+    {
+        code: "read_output_cursor_invalid",
+        meaning: "Read output cursor invalid condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/read-output/continuation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "read_output_cursor_invalid",
+        aliases: [],
+    },
+    {
+        code: "read_output_cursor_stale",
+        meaning: "Read output cursor stale condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/read-output/continuation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "read_output_cursor_stale",
+        aliases: [],
+    },
     {
         code: "redundant_edge",
         meaning: "Redundant edge condition.",
@@ -1605,4 +1629,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=b129c0ca-3d57-551c-945c-300547b74ff5
+//# debugId=5d64a86d-6ba6-5bbe-a83a-9703690a851e

package/dist/sdk/governance/assurance-action.d.ts

@@ -6,6 +6,7 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import { type AssuranceBundleMutationReceipt, type AssuranceDeclaration, type AssuranceGateVerdict, type AssuranceMutationReceipt } from "./assurance.js";
 import { type AssuranceDerivedProposal, type AssurancePreset, type AssurancePresetId } from "./assurance-presets.js";
+import { type CreateAssuranceWorkspaceContextOptions } from "./assurance-runtime.js";
 /** Assurance registry and evaluation verbs shared by every transport. */
 export declare const ASSURANCE_ACTIONS: readonly ["list", "show", "put", "remove", "run", "verdicts", "presets", "apply", "derive", "promote"];
 /** Assurance declaration kinds shared by every transport. */
@@ -49,6 +50,11 @@ export interface AssuranceActionInput {
     /** Explicit next assertion enforcement level. */
     enforcement?: string;
 }
+/** Embedding-host capabilities used only while evaluating assurance actions. */
+export interface AssuranceActionRuntimeOptions {
+    /** Workspace adapters and provider capabilities supplied by an SDK host. */
+    workspace?: Omit<CreateAssuranceWorkspaceContextOptions, "tree_id" | "trigger">;
+}
 /** Result union returned by transport-neutral assurance execution. */
 export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | AssuranceBundleMutationReceipt | AssurancePreset | {
     items: AssuranceDerivedProposal[];
@@ -89,6 +95,6 @@ export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationRece
     };
 };
 /** Execute one assurance request through the public assurance SDK primitives. */
-export declare function runAssuranceAction(input: AssuranceActionInput, global?: Pick<GlobalOptions, "path">): Promise<AssuranceActionResult>;
+export declare function runAssuranceAction(input: AssuranceActionInput, global?: Pick<GlobalOptions, "path">, runtime?: AssuranceActionRuntimeOptions): Promise<AssuranceActionResult>;
 /** Normalize a generic SDK or MCP argument envelope into one assurance request. */
 export declare function runAssuranceDispatch(args: Record<string, unknown>, options: Record<string, unknown>, global: GlobalOptions): Promise<AssuranceActionResult>;

package/dist/sdk/governance/assurance-action.js

@@ -1,12 +1,12 @@
 
-!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]="36dfa230-06bd-5902-a0c9-94a7c34cda90")}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]="06d21369-1339-54b2-8d78-442f02e24cef")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { ASSURANCE_GATE_TRIGGERS, evaluateAssuranceGate, getAssuranceDeclaration, listAssuranceDeclarations, listAssuranceVerdicts, putAssuranceDeclaration, recordAssuranceVerdict, removeAssuranceDeclaration, } from "./assurance.js";
 import { ASSURANCE_PRESET_IDS, acceptAssuranceProposals, applyAssurancePreset, createAssurancePreset, deriveAssuranceProposals, promoteAssuranceAssertion, } from "./assurance-presets.js";
 import { MAX_ASSURANCE_VERDICT_LIMIT } from "./assurance-limits.js";
 import { normalizeAssuranceEvaluation, normalizeAssuranceMutation, } from "./assurance-mutation-error.js";
-import { createAssuranceWorkspaceContext } from "./assurance-runtime.js";
+import { createAssuranceWorkspaceContext, } from "./assurance-runtime.js";
 import { resolvePmRoot } from "../runtime-primitives.js";
 import { parseRuntimeInteger, readRuntimeString } from "../runtime-input.js";
 /** Assurance registry and evaluation verbs shared by every transport. */
@@ -173,7 +173,7 @@ async function runAdoptionAction(action, input, pmRoot) {
         message: input.message,
     }));
 }
-async function runGateAction(input, pmRoot) {
+async function runGateAction(input, pmRoot, runtime) {
     if (!input.id) {
         throw new PmCliError("assurance run requires a gate id", EXIT_CODE.USAGE);
     }
@@ -188,6 +188,7 @@ async function runGateAction(input, pmRoot) {
     const [document, workspaceContext] = await Promise.all([
         readDocument(pmRoot),
         createAssuranceWorkspaceContext(pmRoot, {
+            ...runtime.workspace,
             tree_id: input.tree,
             trigger,
         }),
@@ -205,7 +206,7 @@ async function runGateAction(input, pmRoot) {
     return verdict;
 }
 /** Execute one assurance request through the public assurance SDK primitives. */
-export async function runAssuranceAction(input, global = {}) {
+export async function runAssuranceAction(input, global = {}, runtime = {}) {
     const action = parseAction(input.action);
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     if (action === "presets" ||
@@ -218,7 +219,7 @@ export async function runAssuranceAction(input, global = {}) {
         return runVerdictsAction(input, pmRoot);
     }
     if (action === "run") {
-        return runGateAction(input, pmRoot);
+        return runGateAction(input, pmRoot, runtime);
     }
     const kind = parseKind(input.kind);
     if (action === "list")
@@ -281,4 +282,4 @@ export function runAssuranceDispatch(args, options, global) {
     }, global);
 }
 //# sourceMappingURL=assurance-action.js.map
-//# debugId=36dfa230-06bd-5902-a0c9-94a7c34cda90
+//# debugId=06d21369-1339-54b2-8d78-442f02e24cef

package/dist/sdk/governance/assurance-mutation-error.d.ts

@@ -1,3 +1,29 @@
+/** Machine-readable location of a refused assurance evaluation. */
+export interface AssuranceEvaluationRefusalContext {
+    /** Gate being evaluated. */
+    gate_id?: string;
+    /** Assertion whose measurement failed. */
+    assertion_id?: string;
+    /** Measurement whose source failed. */
+    measurement_id?: string;
+    /** Measurement source discriminant. */
+    source_kind?: string;
+    /** Field selected from a graph, validate, or health result. */
+    field?: string;
+    /** Validate or health check selected by the source. */
+    check?: string;
+}
+/** Machine-readable location of a failed measurement source resolution. */
+export interface AssuranceSourceResolutionContext {
+    /** Measurement that owns the failed source, once evaluation identifies it. */
+    measurement_id?: string;
+    /** Measurement source discriminant. */
+    source_kind: string;
+    /** Field selected from the source result. */
+    field: string;
+    /** Optional validate or health check selector. */
+    check?: string;
+}
 /** Expected declaration-validation or mutation-policy refusal. */
 export declare class AssuranceMutationRefusalError extends TypeError {
     /** Create one typed refusal while retaining TypeError compatibility for SDK callers. */
@@ -5,8 +31,23 @@ export declare class AssuranceMutationRefusalError extends TypeError {
 }
 /** Expected gate-policy refusal caused by an incomplete or disallowed provider contract. */
 export declare class AssuranceEvaluationRefusalError extends TypeError {
+    /** Structured evaluation location retained across CLI, SDK, and MCP. */
+    readonly context: AssuranceEvaluationRefusalContext;
     /** Create one typed refusal while retaining TypeError compatibility for SDK callers. */
-    constructor(message: string);
+    constructor(message: string, context?: AssuranceEvaluationRefusalContext);
+}
+/** Expected failure to resolve one declared external measurement source. */
+export declare class AssuranceSourceResolutionError extends TypeError {
+    /** Measurement that owns the failed source, once evaluation identifies it. */
+    readonly measurement_id?: string;
+    /** Measurement source discriminant. */
+    readonly source_kind: string;
+    /** Field selected from the source result. */
+    readonly field: string;
+    /** Optional validate or health check selector. */
+    readonly check?: string;
+    /** Create one source-local refusal before gate context is attached. */
+    constructor(message: string, context: AssuranceSourceResolutionContext);
 }
 /** Normalize only expected assurance mutation refusals for CLI and MCP hosts. */
 export declare function normalizeAssuranceMutation<T>(operation: () => Promise<T>): Promise<T>;

package/dist/sdk/governance/assurance-mutation-error.js

@@ -5,7 +5,7 @@
  * faults before transport layers normalize them into stable usage errors.
  */
 
-!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]="93a32771-bf95-5df4-8019-b6be45a5051b")}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]="d2d5135a-8110-527e-8530-653b25b792a4")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 /** Expected declaration-validation or mutation-policy refusal. */
@@ -18,10 +18,33 @@ export class AssuranceMutationRefusalError extends TypeError {
 }
 /** Expected gate-policy refusal caused by an incomplete or disallowed provider contract. */
 export class AssuranceEvaluationRefusalError extends TypeError {
+    /** Structured evaluation location retained across CLI, SDK, and MCP. */
+    context;
     /** Create one typed refusal while retaining TypeError compatibility for SDK callers. */
-    constructor(message) {
+    constructor(message, context = {}) {
         super(message);
         this.name = "AssuranceEvaluationRefusalError";
+        this.context = context;
+    }
+}
+/** Expected failure to resolve one declared external measurement source. */
+export class AssuranceSourceResolutionError extends TypeError {
+    /** Measurement that owns the failed source, once evaluation identifies it. */
+    measurement_id;
+    /** Measurement source discriminant. */
+    source_kind;
+    /** Field selected from the source result. */
+    field;
+    /** Optional validate or health check selector. */
+    check;
+    /** Create one source-local refusal before gate context is attached. */
+    constructor(message, context) {
+        super(message);
+        this.name = "AssuranceSourceResolutionError";
+        this.measurement_id = context.measurement_id;
+        this.source_kind = context.source_kind;
+        this.field = context.field;
+        this.check = context.check;
     }
 }
 /** Normalize only expected assurance mutation refusals for CLI and MCP hosts. */
@@ -49,10 +72,11 @@ export async function normalizeAssuranceEvaluation(operation) {
             throw new PmCliError(error.message, EXIT_CODE.USAGE, {
                 code: "invalid_argument_value",
                 reason: "assurance_evaluation_refused",
+                ...error.context,
             });
         }
         throw error;
     }
 }
 //# sourceMappingURL=assurance-mutation-error.js.map
-//# debugId=93a32771-bf95-5df4-8019-b6be45a5051b
+//# debugId=d2d5135a-8110-527e-8530-653b25b792a4

package/dist/sdk/governance/assurance-runtime.js

@@ -5,12 +5,13 @@
  * and verdict semantics in the host-neutral assurance module.
  */
 
-!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]="7c99dfd8-2fa4-56c4-8191-229701eab251")}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]="f9c26dab-b2fb-5ca0-b575-682b4b0bb830")}catch(e){}}();
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { runGraph } from "../graph/run.js";
 import { runHealth } from "./health.js";
 import { runValidate } from "./validate.js";
+import { AssuranceSourceResolutionError } from "./assurance-mutation-error.js";
 import { getActiveExtensionRegistrations, resolvePortableWorkspaceContext, } from "../../core/extensions/index.js";
 import { resolveRegisteredAssuranceMeasurementProvider } from "../../core/extensions/runtime-registrations.js";
 import { stableStringify } from "../../core/shared/serialization.js";
@@ -86,13 +87,13 @@ async function runRegisteredProvider(provider, source, pmRoot, trigger) {
         clearTimeout(timeoutHandle);
     }
 }
-function valueAtPath(input, field) {
+function valueAtPath(input, field, sourceKind, check) {
     let current = input;
     for (const segment of field.split(".")) {
         if (typeof current !== "object" ||
             current === null ||
             Array.isArray(current)) {
-            throw new TypeError(`assurance field ${field} is not present`);
+            throw new AssuranceSourceResolutionError(`assurance field ${field} is not present`, { source_kind: sourceKind, field, ...(check ? { check } : {}) });
         }
         current = current[segment];
     }
@@ -102,17 +103,17 @@ function valueAtPath(input, field) {
         current.every((entry) => typeof entry === "string")) {
         return current;
     }
-    throw new TypeError(`assurance field ${field} must resolve to a finite number or string array`);
+    throw new AssuranceSourceResolutionError(`assurance field ${field} must resolve to a finite number or string array`, { source_kind: sourceKind, field, ...(check ? { check } : {}) });
 }
-function checkValue(result, checkName, field) {
+function checkValue(result, checkName, field, sourceKind) {
     const check = result.checks.find((entry) => entry.name === checkName);
     if (!check)
-        throw new TypeError(`assurance check ${checkName} is not present`);
+        throw new AssuranceSourceResolutionError(`assurance check ${checkName} is not present`, { source_kind: sourceKind, field, check: checkName });
     const value = field === "status" || field === "ok"
         ? check.ok
             ? 0
             : 1
-        : valueAtPath(check.details, field);
+        : valueAtPath(check.details, field, sourceKind, checkName);
     return { value, population_size: 1, cost: result.checks.length };
 }
 async function resolveTreeId(pmRoot, explicit) {
@@ -205,7 +206,7 @@ export async function createAssuranceWorkspaceContext(pmRoot, options = {}) {
                 }
                 const result = await pending;
                 return {
-                    value: valueAtPath(result, source.field),
+                    value: valueAtPath(result, source.field, source.kind),
                     population_size: items.length,
                     cost: items.length,
                 };
@@ -213,12 +214,12 @@ export async function createAssuranceWorkspaceContext(pmRoot, options = {}) {
             if (source.kind === "validate") {
                 validateRun ??= runValidate({ counts: true }, global);
                 const result = await validateRun;
-                return checkValue(result, source.check, source.field);
+                return checkValue(result, source.check, source.field, source.kind);
             }
             if (source.kind === "health") {
                 healthRun ??= runHealth(global, { checkOnly: true, full: true });
                 const result = await healthRun;
-                return checkValue(result, source.check, source.field);
+                return checkValue(result, source.check, source.field, source.kind);
             }
             const hostProvider = options.providers?.[source.provider];
             if (hostProvider)
@@ -232,4 +233,4 @@ export async function createAssuranceWorkspaceContext(pmRoot, options = {}) {
     };
 }
 //# sourceMappingURL=assurance-runtime.js.map
-//# debugId=7c99dfd8-2fa4-56c4-8191-229701eab251
+//# debugId=f9c26dab-b2fb-5ca0-b575-682b4b0bb830

package/dist/sdk/governance/assurance.d.ts

@@ -2,6 +2,8 @@
 export declare const ASSURANCE_DOCUMENT_VERSION: 1;
 /** Supported lifecycle points that can evaluate a gate. */
 export declare const ASSURANCE_GATE_TRIGGERS: readonly ["pre-commit", "pre-push", "pre-merge", "ci", "pre-release", "post-release", "scheduled", "on-claim", "on-close"];
+/** Supported discriminants for built-in, delegated, and derived measurements. */
+export declare const ASSURANCE_MEASUREMENT_SOURCE_KINDS: readonly ["items", "dependency_kind", "graph", "validate", "health", "history", "links", "provider", "derived"];
 /** Gate lifecycle trigger. */
 export type AssuranceGateTrigger = (typeof ASSURANCE_GATE_TRIGGERS)[number];
 /** Assertion enforcement strength. */
@@ -401,6 +403,13 @@ export interface AssuranceGateVerdict {
     exit_code: 0 | 1;
     /** Per-assertion receipts. */
     assertions: AssuranceAssertionVerdict[];
+    /** Total assertions evaluated before any transport projection or compaction. */
+    assertions_total: number;
+    /** Stable selector for iterating assertion evidence across transports. */
+    row_contract: {
+        row_keys: ["assertions"];
+        jq_selector: ".assertions[]";
+    };
     /** Aggregate compute receipt. */
     cost: AssuranceMeasurementCost;
 }