@unbrained/pm-cli 2026.8.9 → 2026.8.10

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

@@ -4,10 +4,10 @@
  * 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]="fc28e3a8-c827-5ccc-918a-12d6bf1a1592")}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]="081c3d07-0cf1-5bad-80ff-2d37be8ee887")}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, 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, 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, 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";
+import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_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";
 import { GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES, GOVERNANCE_CREATE_MODE_DEFAULT_VALUES, GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES, GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES, } from "../../types.js";
 import { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, } from "../query/list.js";
 import { getActiveContextIntentContracts, } from "../context-intent-contracts.js";
@@ -308,6 +308,8 @@ const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ["create", CREATE_FLAG_CONTRACTS],
     ["item mutate", ITEM_MUTATE_FLAG_CONTRACTS],
     ["item complete", ITEM_COMPLETE_FLAG_CONTRACTS],
+    ["copy", COPY_FLAG_CONTRACTS],
+    ["focus", FOCUS_FLAG_CONTRACTS],
     ["update", UPDATE_FLAG_CONTRACTS],
     ["update-many", UPDATE_MANY_FLAG_CONTRACTS],
     ["upgrade", UPGRADE_FLAG_CONTRACTS],
@@ -1869,4 +1871,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=fc28e3a8-c827-5ccc-918a-12d6bf1a1592
+//# debugId=081c3d07-0cf1-5bad-80ff-2d37be8ee887

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

@@ -170,6 +170,9 @@ export declare const TOOL_CREATE_OPTION_CONTRACT_SOURCE: readonly [{
 }, {
     readonly param: "allowMissingParent";
     readonly flag: "--allow-missing-parent";
+}, {
+    readonly param: "allowUnresolvedDeps";
+    readonly flag: "--allow-unresolved-deps";
 }, {
     readonly param: "allowDuplicate";
     readonly flag: "--allow-duplicate";
@@ -325,6 +328,9 @@ export declare const TOOL_UPDATE_OPTION_CONTRACT_SOURCE: readonly [{
 }, {
     readonly param: "allowMissingParent";
     readonly flag: "--allow-missing-parent";
+}, {
+    readonly param: "allowUnresolvedDeps";
+    readonly flag: "--allow-unresolved-deps";
 }, {
     readonly param: "dep";
     readonly flag: "--dep";

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]="13ab1164-d2b1-5954-80e8-08c6b12779da")}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]="26955ae3-1aca-503e-9492-46652285d17a")}catch(e){}}();
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -183,6 +183,7 @@ export const TOOL_CREATE_OPTION_CONTRACT_SOURCE = [
     { param: "message", flag: "--message", allowEmpty: true },
     { param: "assignee", flag: "--assignee" },
     { param: "allowMissingParent", flag: "--allow-missing-parent" },
+    { param: "allowUnresolvedDeps", flag: "--allow-unresolved-deps" },
     { param: "allowDuplicate", flag: "--allow-duplicate", booleanish: true },
     { param: "reminder", flag: "--reminder", repeatable: true },
     { param: "event", flag: "--event", repeatable: true },
@@ -235,6 +236,7 @@ export const TOOL_UPDATE_OPTION_CONTRACT_SOURCE = [
     { param: "message", flag: "--message", allowEmpty: true },
     { param: "assignee", flag: "--assignee" },
     { param: "allowMissingParent", flag: "--allow-missing-parent" },
+    { param: "allowUnresolvedDeps", flag: "--allow-unresolved-deps" },
     { param: "dep", flag: "--dep", repeatable: true },
     { param: "depRemove", flag: "--dep-remove", repeatable: true },
     { param: "replaceDeps", flag: "--replace-deps" },
@@ -421,4 +423,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=13ab1164-d2b1-5954-80e8-08c6b12779da
+//# debugId=26955ae3-1aca-503e-9492-46652285d17a

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]="35c4b819-02d6-582a-a7eb-fe3f4a4903d9")}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]="6e0b4ff7-5aca-562b-b36c-c0c53987138d")}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";
 /** Public contract for pm tool parameter properties, shared by SDK and presentation-layer consumers. */
@@ -164,6 +164,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     },
     idOnly: { type: "boolean" },
     allowMissingParent: { type: "boolean" },
+    allowUnresolvedDeps: { type: "boolean" },
     allowDuplicate: { type: "boolean" },
     duplicateOf: { type: "string" },
     configAction: { type: "string", enum: ["get", "set", "list", "export"] },
@@ -979,6 +980,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
     allowDuplicate: {
         description: "Explicitly proceed when strict similarity governance finds likely duplicate items.",
     },
+    allowUnresolvedDeps: {
+        description: "Permit unresolved local dependency targets while returning dependency_target_unresolved warning receipts. Cross-workspace references should use source_kind=external instead.",
+        examples: [true],
+    },
     requiredTypes: {
         description: "Restrict a custom field's requirement to specific item types (schema add-field).",
         examples: [["Bug"], ["Story", "Spike"]],
@@ -1074,7 +1079,7 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [["error path covered by a regression test"]],
     },
     removeAc: {
-        description: "Acceptance criteria removed individually by exact text match (one criterion per entry).",
+        description: "Acceptance criteria removed individually by exact text match; the mutation fails atomically if any selector is unmatched (one criterion per entry).",
         examples: [["superseded manual QA step"]],
     },
     removeTags: {
@@ -1106,7 +1111,7 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [60, "120"],
     },
     acceptanceCriteria: {
-        description: "Acceptance criteria text.",
+        description: "Complete acceptance-criteria text supplied while creating or replacing an item field.",
     },
     author: {
         description: "Intentional mutation-author override. Agent harness identity is automatic when omitted.",
@@ -1764,6 +1769,16 @@ export const PM_TOOL_PARAMETER_METADATA = {
  * because its single `name` property must cover every action at once.
  */
 export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
+    update: {
+        acceptanceCriteria: {
+            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
+        },
+    },
+    "update-many": {
+        acceptanceCriteria: {
+            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
+        },
+    },
     stats: {
         since: {
             description: "Inclusive ISO 8601 timestamp or negative duration lower bound for provenance and fleet analytics.",
@@ -1907,4 +1922,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=35c4b819-02d6-582a-a7eb-fe3f4a4903d9
+//# debugId=6e0b4ff7-5aca-562b-b36c-c0c53987138d

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]="d9f01e68-6b54-5861-a4b5-ae40613c2047")}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]="4ce3417b-2ccc-5304-8275-30f6eb749db8")}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";
@@ -784,8 +784,21 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         required: ["id", "target"],
         optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
     },
-    update: { required: ["id"], optional: UPDATE_CONTRACT_PARAMETER_KEYS },
-    "update-many": { optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS },
+    update: {
+        required: ["id"],
+        optional: UPDATE_CONTRACT_PARAMETER_KEYS,
+        mutuallyExclusive: [
+            ["acceptanceCriteria", "addAc"],
+            ["acceptanceCriteria", "removeAc"],
+        ],
+    },
+    "update-many": {
+        optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS,
+        mutuallyExclusive: [
+            ["acceptanceCriteria", "addAc"],
+            ["acceptanceCriteria", "removeAc"],
+        ],
+    },
     close: {
         required: ["id"],
         optional: [
@@ -1512,4 +1525,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=d9f01e68-6b54-5861-a4b5-ae40613c2047
+//# debugId=4ce3417b-2ccc-5304-8275-30f6eb749db8

package/dist/sdk/context-intent-runtime.js

@@ -6,9 +6,10 @@
  * SDK entrypoint.
  */
 
-!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]="55ecd7ff-0047-5fd1-9f6f-f45602fce1bb")}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]="7ba0243e-98d1-5aef-bd47-54f0b630be58")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { isFileAbsentError } from "../core/fs/fs-utils.js";
 import { runWithContextIntentContracts, } from "./context-intent-contracts.js";
 /** Conventional workspace declaration file relative to the tracker root. */
 export const PM_CONTEXT_INTENTS_FILE = "context-intents.json";
@@ -56,9 +57,11 @@ export async function readWorkspaceContextIntentContracts(pmRoot) {
         source = await readFile(declarationPath, "utf8");
     }
     catch (error) {
-        if (isRecord(error) &&
-            typeof error.code === "string" &&
-            error.code === "ENOENT") {
+        // Absent declarations are the norm. `ENOTDIR` counts as absent too: when
+        // the tracker root is a regular file the declaration cannot exist, and the
+        // authoritative root guard downstream owns that refusal — this optional
+        // read must not pre-empt it with a raw runtime fault.
+        if (isFileAbsentError(error)) {
             return [];
         }
         throw error;
@@ -107,4 +110,4 @@ export async function runWithDiscoveredContextIntentContracts(options, run) {
     return await runWithContextIntentContracts(layers, run);
 }
 //# sourceMappingURL=context-intent-runtime.js.map
-//# debugId=55ecd7ff-0047-5fd1-9f6f-f45602fce1bb
+//# debugId=7ba0243e-98d1-5aef-bd47-54f0b630be58

package/dist/sdk/context-signal-store.d.ts

@@ -52,7 +52,41 @@ export interface ContextSignalStoreReadResult {
     cache_status: "fresh" | "rebuilt";
     /** Non-fatal recovery diagnostics. */
     warnings: readonly string[];
+    /** Actionable meanings and executable recovery commands for every warning. */
+    warning_details?: readonly ContextSignalStoreWarningDetail[];
 }
+/** Stable recovery contract for one context signal-store warning. */
+export interface ContextSignalStoreWarningDetail {
+    /** Machine-readable warning code also present in `warnings`. */
+    code: "context_signal_store_invalid" | "context_signal_store_stale" | "context_signal_store_write_failed";
+    /** Bounded explanation of the observed derived-state condition. */
+    meaning: string;
+    /** Safe executable command that retries or confirms recovery. */
+    recovery_command: "pm context";
+    /** Expected observable effect of the recovery command. */
+    recovery_effect: string;
+}
+/** Canonical actionable contracts shared by CLI, SDK, MCP, and package hosts. */
+export declare const CONTEXT_SIGNAL_STORE_WARNING_DETAILS: {
+    readonly context_signal_store_invalid: {
+        readonly code: "context_signal_store_invalid";
+        readonly meaning: "The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.";
+        readonly recovery_command: "pm context";
+        readonly recovery_effect: "Re-read context and confirm the rebuilt snapshot can be loaded without the warning.";
+    };
+    readonly context_signal_store_stale: {
+        readonly code: "context_signal_store_stale";
+        readonly meaning: "The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.";
+        readonly recovery_command: "pm context";
+        readonly recovery_effect: "Re-read context and confirm the rebuilt snapshot is now fresh.";
+    };
+    readonly context_signal_store_write_failed: {
+        readonly code: "context_signal_store_write_failed";
+        readonly meaning: "Context signals were rebuilt in memory, but the derived snapshot could not be persisted.";
+        readonly recovery_command: "pm context";
+        readonly recovery_effect: "Retry the derived snapshot write and confirm the warning clears after storage access is restored.";
+    };
+};
 /** Workspace-bound feature-store options used by CLI, MCP, and SDK readers. */
 export interface ReadWorkspaceContextSignalsOptions extends BuildItemContextRelevanceCandidatesOptions {
     /** Tracker root containing rebuildable runtime state. */

package/dist/sdk/context-signal-store.js

@@ -6,7 +6,7 @@
  * history, while stale, absent, or corrupt snapshots rebuild transparently.
  */
 
-!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]="a502be8f-57da-53c2-8de0-118a15688d93")}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]="2a0f64cf-f6a4-5304-921d-c83b98d3a31f")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -24,6 +24,27 @@ const STORED_CONTEXT_SIGNAL_NAMES = [
     "risk_pressure",
     "knowledge_density",
 ];
+/** Canonical actionable contracts shared by CLI, SDK, MCP, and package hosts. */
+export const CONTEXT_SIGNAL_STORE_WARNING_DETAILS = {
+    context_signal_store_invalid: {
+        code: "context_signal_store_invalid",
+        meaning: "The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.",
+        recovery_command: "pm context",
+        recovery_effect: "Re-read context and confirm the rebuilt snapshot can be loaded without the warning.",
+    },
+    context_signal_store_stale: {
+        code: "context_signal_store_stale",
+        meaning: "The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.",
+        recovery_command: "pm context",
+        recovery_effect: "Re-read context and confirm the rebuilt snapshot is now fresh.",
+    },
+    context_signal_store_write_failed: {
+        code: "context_signal_store_write_failed",
+        meaning: "Context signals were rebuilt in memory, but the derived snapshot could not be persisted.",
+        recovery_command: "pm context",
+        recovery_effect: "Retry the derived snapshot write and confirm the warning clears after storage access is restored.",
+    },
+};
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -245,6 +266,7 @@ export class ContextSignalStore {
             })),
             cache_status: fresh ? "fresh" : "rebuilt",
             warnings,
+            warning_details: warnings.map((warning) => CONTEXT_SIGNAL_STORE_WARNING_DETAILS[warning]),
         };
     }
 }
@@ -288,4 +310,4 @@ export async function readWorkspaceContextSignals(items, options) {
     return store.readOrRebuild(items, { ...options, sourceCursor, source });
 }
 //# sourceMappingURL=context-signal-store.js.map
-//# debugId=a502be8f-57da-53c2-8de0-118a15688d93
+//# debugId=2a0f64cf-f6a4-5304-921d-c83b98d3a31f

package/dist/sdk/dependency-flag-validation.d.ts

@@ -1,4 +1,4 @@
-import type { Dependency } from "../types/index.js";
+import type { Dependency, ItemFormat } from "../types/index.js";
 import { type RelationshipKindRegistry } from "./relationships.js";
 /** Reject malformed shorthand before item-id prefix normalization can create a dangling graph node. */
 export declare function assertValidBareDependencyFlagValue(value: string, structured: boolean): void;
@@ -7,3 +7,17 @@ export declare function assertValidBareDependencyFlagValue(value: string, struct
  * ontology before a create or update mutation writes item or history state.
  */
 export declare function assertDependencyEdgesAllowed(holderId: string, dependencies: readonly Dependency[] | undefined, registry?: RelationshipKindRegistry): void;
+/**
+ * Resolve every newly supplied local dependency before a mutation commits.
+ * Explicit external provenance bypasses workspace lookup, while the opt-in
+ * unresolved mode returns durable warning tokens instead of pretending that
+ * the graph edge resolved successfully.
+ */
+export declare function assertDependencyTargetsResolvable(params: {
+    pmRoot: string;
+    dependencies: readonly Dependency[] | undefined;
+    idPrefix: string;
+    itemFormat: ItemFormat;
+    typeToFolder: Record<string, string>;
+    allowUnresolved?: boolean;
+}): Promise<string[]>;

package/dist/sdk/dependency-flag-validation.js

@@ -1,9 +1,11 @@
 /** @module cli/commands/dependency-flag-validation */
 
-!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]="1c1314f1-b54f-562c-b6f0-950fcac4c9cc")}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]="e7cd6092-ed18-52ea-94a0-03bed42eb858")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { toErrorMessage } from "../core/shared/primitives.js";
+import { locateItem } from "../core/store/item-store.js";
+import { isExternalDependencySourceKind } from "./dependency-provenance.js";
 import { resolveWorkspaceRelationshipKindRegistry } from "./graph/assembly.js";
 import { assertRelationshipEdgeAllowed, } from "./relationships.js";
 /** Reject malformed shorthand before item-id prefix normalization can create a dangling graph node. */
@@ -29,5 +31,55 @@ export function assertDependencyEdgesAllowed(holderId, dependencies, registry =
         }
     }
 }
+/**
+ * Resolve every newly supplied local dependency before a mutation commits.
+ * Explicit external provenance bypasses workspace lookup, while the opt-in
+ * unresolved mode returns durable warning tokens instead of pretending that
+ * the graph edge resolved successfully.
+ */
+export async function assertDependencyTargetsResolvable(params) {
+    const localTargets = [
+        ...new Set((params.dependencies ?? [])
+            .filter((dependency) => !isExternalDependencySourceKind(dependency.source_kind))
+            .map((dependency) => dependency.id)),
+    ];
+    const resolutions = await Promise.all(localTargets.map(async (target) => ({
+        target,
+        located: await locateItem(params.pmRoot, target, params.idPrefix, params.itemFormat, params.typeToFolder),
+    })));
+    const targets = resolutions
+        .filter(({ located }) => located === null)
+        .map(({ target }) => target)
+        .sort((left, right) => (left < right ? -1 : 1));
+    if (targets.length === 0) {
+        return [];
+    }
+    if (params.allowUnresolved === true) {
+        return targets.map((target) => `dependency_target_unresolved:${target}`);
+    }
+    throw new PmCliError(`Dependency target${targets.length === 1 ? "" : "s"} not found: ${targets.join(", ")}`, EXIT_CODE.NOT_FOUND, {
+        code: "dependency_target_not_found",
+        reason: "unresolved_local_dependency",
+        required: "Every local dependency target must exist before the edge is committed.",
+        why: "Fail-fast target resolution prevents dangling graph nodes and preserves reliable traversal semantics.",
+        unresolved_targets: targets,
+        examples: [
+            "--dep id=<existing-item-id>,kind=related",
+            "--dep id=<external-id>,kind=related,source_kind=external",
+            "--allow-unresolved-deps --dep id=<future-item-id>,kind=related",
+        ],
+        nextSteps: [
+            `Create or correct ${targets.length === 1 ? "the target" : "the targets"}, then retry the mutation.`,
+            "Use source_kind=external for a cross-workspace reference.",
+            "Use --allow-unresolved-deps only when the dangling local edge is intentional.",
+        ],
+        recovery: {
+            recovery_mode: "compact",
+            missing: targets,
+            suggested_flags: ["--allow-unresolved-deps"],
+            suggested_retry: `pm search "${targets[0]}" --limit 10`,
+        },
+    });
+}
 //# sourceMappingURL=dependency-flag-validation.js.map
-//# debugId=1c1314f1-b54f-562c-b6f0-950fcac4c9cc
+//# debugId=e7cd6092-ed18-52ea-94a0-03bed42eb858

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

@@ -4,10 +4,34 @@
  * Generated by scripts/generate-error-code-catalog.mjs. Do not edit manually.
  */
 
-!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]="bcb7a0a9-268f-5cf8-aefc-766b67e92168")}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]="94952ea0-bfe7-5d64-9ac4-101c483b4c55")}catch(e){}}();
 import { definePmErrorCodeCatalog } from "./error-code-catalog.js";
 /** Exhaustive catalog generated from literal error guidance declarations. */
 export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
+    {
+        code: "acceptance_criteria_mutation_conflict",
+        meaning: "Acceptance criteria mutation conflict condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/update.ts"],
+        emitting_commands: ["update", "update-many"],
+        canonical_code: "acceptance_criteria_mutation_conflict",
+        aliases: [],
+    },
+    {
+        code: "acceptance_criteria_remove_unmatched",
+        meaning: "Acceptance criteria remove unmatched condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/update-many.ts", "sdk/lifecycle/update.ts"],
+        emitting_commands: ["update", "update-many"],
+        canonical_code: "acceptance_criteria_remove_unmatched",
+        aliases: [],
+    },
     {
         code: "acceptance_criteria_semicolon_forbidden",
         meaning: "Acceptance criteria semicolon forbidden condition.",
@@ -308,6 +332,42 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         canonical_code: "conflicting_lifecycle_owner",
         aliases: [],
     },
+    {
+        code: "context_signal_store_invalid",
+        meaning: "Context signal store invalid condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/context-signal-store.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_signal_store_invalid",
+        aliases: [],
+    },
+    {
+        code: "context_signal_store_stale",
+        meaning: "Context signal store stale condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/context-signal-store.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_signal_store_stale",
+        aliases: [],
+    },
+    {
+        code: "context_signal_store_write_failed",
+        meaning: "Context signal store write failed condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/context-signal-store.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "context_signal_store_write_failed",
+        aliases: [],
+    },
     {
         code: "context_takes_no_item_argument",
         meaning: "Context takes no item argument condition.",
@@ -356,6 +416,18 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
         canonical_code: "dependency_edge_not_allowed",
         aliases: [],
     },
+    {
+        code: "dependency_target_not_found",
+        meaning: "Dependency target not found condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/dependency-flag-validation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "dependency_target_not_found",
+        aliases: [],
+    },
     {
         code: "duplicate_command",
         meaning: "Duplicate command condition.",
@@ -3057,4 +3129,4 @@ export const PM_ERROR_CODE_CATALOG = definePmErrorCodeCatalog([
     },
 ]);
 //# sourceMappingURL=generated-error-code-catalog.js.map
-//# debugId=bcb7a0a9-268f-5cf8-aefc-766b67e92168
+//# debugId=94952ea0-bfe7-5d64-9ac4-101c483b4c55

package/dist/sdk/governance/health.js

@@ -4,7 +4,7 @@
  * Implements the pm health 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]="97e1ed14-cd36-5910-b829-4619af6080e1")}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]="539b0cb4-5e20-51e2-a33e-1a43ca961f05")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
@@ -28,7 +28,7 @@ import { toNonEmptyStringOrUndefined } from "../../core/shared/primitives.js";
 import { nowIso } from "../../core/shared/time.js";
 import { parseItemDocument } from "../../core/item/item-format.js";
 import { effectiveItemFormatVersion, scanItemFormatVersions, } from "../../core/item/item-format-version.js";
-import { listAllItemMetadata, listAllItemMetadataWithBody, } from "../../core/store/item-store.js";
+import { listAllItemMetadataLight, listAllItemMetadataWithBody, } from "../../core/store/item-store.js";
 import { PM_TELEMETRY_SOURCE_CONTEXT_VALUES, TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS, TELEMETRY_SCHEMA_VERSION, } from "../../core/telemetry/runtime.js";
 import { getItemFormatFromPath, getSettingsPath, ITEM_FILE_EXTENSIONS, resolveGlobalPmRoot, resolvePmRoot, } from "../../core/store/paths.js";
 import { readSettingsWithMetadata } from "../../core/store/settings.js";
@@ -322,7 +322,10 @@ async function buildIntegrityCheck(pmRoot, typeToFolder, schema, requireMergeDri
         : await auditMergeDriverConfiguration(gitWorkspaceRoot);
     const pendingMergeReceipts = gitWorkspaceRoot === null
         ? []
-        : await listMergeReceipts(gitWorkspaceRoot, { includeLossless: true });
+        : await listMergeReceipts(gitWorkspaceRoot, {
+            includeLossless: true,
+            pmRoot,
+        });
     const { pendingDecisions: pendingMergeDecisions, lossless: losslessMergeReceipts, } = partitionMergeReceipts(pendingMergeReceipts);
     const mergeDriverInstallationMissing = mergeDriverAudit?.status === "missing" &&
         mergeDriverAudit.missing_keys.length === 5 &&
@@ -1652,7 +1655,7 @@ function resolveHealthSkipPolicy(options) {
 }
 async function readHealthItems(params) {
     if (params.skipPolicy.skipDrift && params.skipPolicy.skipVectors) {
-        return listAllItemMetadata(params.pmRoot, params.settings.item_format, params.typeRegistry.type_to_folder, params.itemReadWarnings, params.settings.schema);
+        return listAllItemMetadataLight(params.pmRoot, params.settings.item_format, params.typeRegistry.type_to_folder, params.itemReadWarnings, params.settings.schema);
     }
     return listAllItemMetadataWithBody(params.pmRoot, params.settings.item_format, params.typeRegistry.type_to_folder, params.itemReadWarnings, params.settings.schema);
 }
@@ -1702,7 +1705,7 @@ const resolveUnknownAuthorEventCount = (authorAttribution) => authorAttribution.
 /** Preserve actionable-author semantics for current and legacy scan payloads. */
 const resolveActionableUnknownAuthorEventCount = (authorAttribution) => authorAttribution.actionable_unknown_event_count ??
     resolveUnknownAuthorEventCount(authorAttribution);
-function buildStorageHealthCheck(items, settings, historySummary, authorAttribution, staleInProgress, provenanceResolverOutcomes) {
+function buildStorageHealthCheck(items, settings, historySummary, authorAttribution, staleInProgress, provenanceResolverOutcomes, provenanceInvalidValues) {
     const unknownAuthorEventCount = resolveUnknownAuthorEventCount(authorAttribution);
     const actionableUnknownAuthorEventCount = resolveActionableUnknownAuthorEventCount(authorAttribution);
     const hasAuthorEvents = unknownAuthorEventCount > 0;
@@ -1738,6 +1741,9 @@ function buildStorageHealthCheck(items, settings, historySummary, authorAttribut
             ...(provenanceResolverOutcomes.length > 0
                 ? { provenance_resolver_outcomes: provenanceResolverOutcomes }
                 : {}),
+            ...(provenanceInvalidValues.length > 0
+                ? { provenance_invalid_values: provenanceInvalidValues }
+                : {}),
             ...(historySummary.max_entries !== null
                 ? {
                     compact_policy: {
@@ -1881,6 +1887,7 @@ export async function runHealth(global, options = {}) {
     }));
     const provenanceResolverHealth = await scanProvenanceResolverHealth(pmRoot);
     const provenanceResolverOutcomes = provenanceResolverHealth.outcomes;
+    const provenanceInvalidValues = provenanceResolverHealth.invalid_values;
     const provenanceWarnings = provenanceResolverHealth.warnings;
     const locksCheck = await buildLocksCheck(pmRoot);
     const integrityCheck = skipPolicy.skipIntegrity
@@ -1898,7 +1905,7 @@ export async function runHealth(global, options = {}) {
         buildSettingsValuesHealthCheck(settingWarnings),
         telemetryCheck.check,
         extensionCheck.check,
-        buildStorageHealthCheck(items, settings, historySummary, authorAttribution, staleInProgress.scan, provenanceResolverOutcomes),
+        buildStorageHealthCheck(items, settings, historySummary, authorAttribution, staleInProgress.scan, provenanceResolverOutcomes, provenanceInvalidValues),
         locksCheck.check,
         integrityCheck.check,
         historyDriftCheck.check,
@@ -1983,4 +1990,4 @@ export const _testOnlyHealthCommand = {
     warningCode,
 };
 //# sourceMappingURL=health.js.map
-//# debugId=97e1ed14-cd36-5910-b829-4619af6080e1
+//# debugId=539b0cb4-5e20-51e2-a33e-1a43ca961f05

package/dist/sdk/governance/provenance-health.d.ts

@@ -11,10 +11,23 @@ export interface ProvenanceResolverHealthOutcome {
     /** Attempted events that produced a bounded value. */
     successes: number;
 }
+/** Aggregate for legacy provenance values that violate the bounded domain. */
+export interface ProvenanceValueHealthFinding {
+    /** Detected harness namespace. */
+    harness: string;
+    /** Provenance dimension containing the invalid value. */
+    dimension: string;
+    /** Privacy-safe invalid-value class. */
+    kind: "boolean" | "single_digit";
+    /** Events containing this invalid value class. */
+    count: number;
+}
 /** Bounded provenance health result suitable for `pm health` adapters. */
 export interface ProvenanceResolverHealthScan {
     /** Stable resolver outcome aggregates. */
     outcomes: ProvenanceResolverHealthOutcome[];
+    /** Aggregated invalid legacy values without retaining the values themselves. */
+    invalid_values: ProvenanceValueHealthFinding[];
     /** Advisory warnings for attempted resolvers with no success. */
     warnings: string[];
     /** Number of nonblank history events inspected. */