@unbrained/pm-cli 2026.8.20 → 2026.8.21

package/dist/sdk/dependencies.js

@@ -4,9 +4,9 @@
  * Implements the pm deps 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]="ee0547d9-ae0f-5762-8bff-e25f0a3cd4d5")}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]="74a825f3-1301-5dc5-a887-c6ff68f6d7ec")}catch(e){}}();
+import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
-import { pathExists } from "../core/fs/fs-utils.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { isTerminalStatus } from "../core/item/status.js";
 import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
@@ -14,7 +14,7 @@ import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { formatBuiltInOutput } from "../core/output/output.js";
 import { listAllItemMetadataLight, locateItem, readLocatedItem, } from "../core/store/item-store.js";
-import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
+import { resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { estimatePmOutputTokens } from "./cli-contracts/agent-output-contracts.js";
 import { assertProjectionModeChoice, attachOutputOmissionReceipt, } from "./output-projection.js";
@@ -659,9 +659,7 @@ function attachDepsProjection(result, summaryOnly, legacyAliasCounts = {}) {
 /** Implements run deps for the public runtime surface of this module. */
 export async function runDeps(id, options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const format = parseFormat(options.format);
     const maxDepth = parseMaxDepth(options.maxDepth);
     const collapse = parseCollapse(options.collapse);
@@ -718,4 +716,4 @@ export async function runDeps(id, options, global) {
     return attachDepsProjection(buildTreeOrGraphDepsResult(id, format, options, index, maxDepth, collapse, global.json === true ? "json" : "toon"), false, Object.fromEntries(Object.entries(assembleWorkspaceRelationshipGraph(items, (status) => isTerminalStatus(status, statusRegistry)).legacyAliasCounts)));
 }
 //# sourceMappingURL=dependencies.js.map
-//# debugId=ee0547d9-ae0f-5762-8bff-e25f0a3cd4d5
+//# debugId=74a825f3-1301-5dc5-a887-c6ff68f6d7ec

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

@@ -1,7 +1,7 @@
 import type { Dependency, ItemFormat, RuntimeSchemaSettings } 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;
+export declare function assertValidBareDependencyFlagValue(value: string, structured: boolean, flag?: string): void;
 /**
  * Validate prospective stored dependencies against the active relationship
  * ontology before a create or update mutation writes item or history state.

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

@@ -1,6 +1,6 @@
 /** @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]="f9c9b926-c912-548e-a9c7-64c2c69767cd")}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]="d6f359cb-2bc9-5f96-8789-db91512d0bd5")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { toErrorMessage } from "../core/shared/primitives.js";
@@ -9,9 +9,15 @@ 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. */
-export function assertValidBareDependencyFlagValue(value, structured) {
+export function assertValidBareDependencyFlagValue(value, structured, flag = "--dep") {
     if (!structured && /[:,=]/.test(value)) {
-        throw new PmCliError(`Invalid --dep value "${value}". Use a bare item id or id=<id>,kind=<kind>.`, EXIT_CODE.USAGE);
+        throw new PmCliError(`Invalid ${flag} value "${value}". Use a bare item id or id=<id>,kind=<kind>.`, EXIT_CODE.USAGE, {
+            code: "dependency_flag_value_invalid",
+            reason: "malformed_dependency_shorthand",
+            flag,
+            value,
+            required: "Use a bare item id or an explicit id=<id>,kind=<kind> entry.",
+        });
     }
 }
 /**
@@ -148,4 +154,4 @@ export async function assertDependencyTargetsResolvable(params) {
     return missingTargets.map((target) => `dependency_target_unresolved:${target}`);
 }
 //# sourceMappingURL=dependency-flag-validation.js.map
-//# debugId=f9c9b926-c912-548e-a9c7-64c2c69767cd
+//# debugId=d6f359cb-2bc9-5f96-8789-db91512d0bd5

package/dist/sdk/environment/tracker-preflight.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @module sdk/environment/tracker-preflight
+ *
+ * Exposes tracker initialization and filesystem preflight primitives to SDK consumers.
+ */
+export { assertInitializedTracker, assertReadableTrackerRoot, buildTrackerInitializationRecovery, } from "../../core/store/tracker-preflight.js";

package/dist/sdk/environment/tracker-preflight.js

@@ -0,0 +1,10 @@
+/**
+ * @module sdk/environment/tracker-preflight
+ *
+ * Exposes tracker initialization and filesystem preflight primitives to SDK consumers.
+ */
+
+!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]="745b9c3b-538c-558f-b018-b406ca4318f0")}catch(e){}}();
+export { assertInitializedTracker, assertReadableTrackerRoot, buildTrackerInitializationRecovery, } from "../../core/store/tracker-preflight.js";
+//# sourceMappingURL=tracker-preflight.js.map
+//# debugId=745b9c3b-538c-558f-b018-b406ca4318f0

package/dist/sdk/eval.js

@@ -10,15 +10,15 @@
  * instead of silently degrading retrieval quality.
  */
 
-!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]="b90a064c-f423-5bf7-9fbf-1fb273c7b5af")}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]="9cc9405b-d2b8-59aa-893f-54892595788a")}catch(e){}}();
+import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { aggregateEvalMetrics, DEFAULT_EVAL_K, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_ID, evaluateRanking, parseEvalQuerySet, } from "../core/search/eval.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { coercePositiveInteger } from "../core/shared/primitives.js";
-import { pathExists } from "../core/fs/fs-utils.js";
-import { getSettingsPath, resolvePmRoot } from "../core/store/paths.js";
+import { resolvePmRoot } from "../core/store/paths.js";
 import { runSearch } from "./query/search.js";
 export { EVAL_QUERY_SET_CONTRACT, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_ID, parseEvalQuerySet, } from "../core/search/eval.js";
 /** Relative location (under the pm root) of the default golden-query set. A git-tracked, human-curated file so relevance ground truth lives alongside the tracker it evaluates. */
@@ -170,9 +170,7 @@ const buildEvalResult = (k, reports, rawMetrics, failUnder) => {
  */
 export const runEval = async (options, global) => {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const k = parseEvalK(options.k);
     const defaultMode = parseEvalMode(options.mode);
     const failUnder = parseFailUnder(options.failUnder);
@@ -190,4 +188,4 @@ export const runEval = async (options, global) => {
     return buildEvalResult(k, reports, rawMetrics, failUnder);
 };
 //# sourceMappingURL=eval.js.map
-//# debugId=b90a064c-f423-5bf7-9fbf-1fb273c7b5af
+//# debugId=9cc9405b-d2b8-59aa-893f-54892595788a

package/dist/sdk/files.js

@@ -4,10 +4,10 @@
  * Implements the pm files 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]="515cd35c-8e0e-51d4-8ad9-1cea5be8a572")}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]="ed504f2b-8b78-5fca-a4a7-7b0709a65533")}catch(e){}}();
+import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { pathExists } from "../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations, hasActiveOnReadHooks, } from "../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
@@ -15,7 +15,7 @@ import { PmCliError } from "../core/shared/errors.js";
 import { locateItem, listAllItemMetadata, mutateItem, readLocatedItem, } from "../core/store/item-store.js";
 import { readItemMetadataDerivedIndexState } from "../core/store/item-metadata-cache.js";
 import { queryLinkedFileMetadataIndex } from "../core/store/item-metadata-query-index.js";
-import { getSettingsPath, resolvePmRoot, resolveWorkspaceRoot, } from "../core/store/paths.js";
+import { resolvePmRoot, resolveWorkspaceRoot, } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { resolveAuthor } from "../core/shared/author.js";
 import { isPathWithinDirectory } from "../core/fs/path-utils.js";
@@ -371,9 +371,7 @@ async function queryFilesLookupSource(params) {
 export async function runFilesLookup(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     const workspaceRoot = resolveWorkspaceRoot(pmRoot);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const paths = await normalizeFilesLookupPaths(options.paths, workspaceRoot);
     if (options.lineRange && paths.length !== 1) {
         throw new PmCliError("Files lookup line attribution requires exactly one source path.", EXIT_CODE.USAGE);
@@ -428,9 +426,7 @@ export async function runFilesLookup(options, global) {
 export async function runFilesDiscover(id, options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     const workspaceRoot = resolveWorkspaceRoot(pmRoot);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-    }
+    await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
     const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
@@ -537,4 +533,4 @@ export async function runFilesDiscover(id, options, global) {
     };
 }
 //# sourceMappingURL=files.js.map
-//# debugId=515cd35c-8e0e-51d4-8ad9-1cea5be8a572
+//# debugId=ed504f2b-8b78-5fca-a4a7-7b0709a65533

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]="145e12fa-839c-59da-840b-e2a0f3f13065")}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]="4959a1ef-29e6-50ae-aaf8-fe078001bff6")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -494,6 +494,30 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "dependency_edge_not_allowed",
         aliases: [],
     },
+    {
+        code: "dependency_flag_value_invalid",
+        meaning: "Dependency flag value invalid condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/dependency-flag-validation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "dependency_flag_value_invalid",
+        aliases: [],
+    },
+    {
+        code: "dependency_remove_no_match",
+        meaning: "Dependency remove no match condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/lifecycle/update.ts"],
+        emitting_commands: ["update"],
+        canonical_code: "dependency_remove_no_match",
+        aliases: [],
+    },
     {
         code: "dependency_target_not_found",
         meaning: "Dependency target not found condition.",
@@ -681,7 +705,7 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         exit_code: 1,
         class: "generic_failure",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/agent/refusal-closure.ts"],
+        sources: ["sdk/agent/refusal-closure.ts", "sdk/agent/tracker-preflight-contracts.ts"],
         emitting_commands: ["*"],
         canonical_code: "error_code_mismatch",
         aliases: [],
@@ -710,6 +734,18 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "event_index_unavailable",
         aliases: [],
     },
+    {
+        code: "exit_code_mismatch",
+        meaning: "Exit code mismatch condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/tracker-preflight-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "exit_code_mismatch",
+        aliases: [],
+    },
     {
         code: "extension_command_activation_failed",
         meaning: "Extension command activation failed condition.",
@@ -1910,4 +1946,4 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=145e12fa-839c-59da-840b-e2a0f3f13065
+//# debugId=4959a1ef-29e6-50ae-aaf8-fe078001bff6

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

@@ -1,6 +1,6 @@
 /** 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]="8555c35d-af49-53cd-b782-e9d2fbf65d2f")}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]="d7f4f4f0-d044-5216-b2c4-d76b4d8854a9")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
     {
         code: "missing_destination",
@@ -26,6 +26,18 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "missing_directory",
         aliases: [],
     },
+    {
+        code: "missing_init_recovery",
+        meaning: "Missing init recovery condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/tracker-preflight-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_init_recovery",
+        aliases: [],
+    },
     {
         code: "missing_lifecycle_target",
         meaning: "Missing lifecycle target condition.",
@@ -74,6 +86,18 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "missing_parameter_alias",
         aliases: [],
     },
+    {
+        code: "missing_probe",
+        meaning: "Missing probe condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/tracker-preflight-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_probe",
+        aliases: [],
+    },
     {
         code: "missing_required_argument",
         meaning: "Missing required argument condition.",
@@ -483,6 +507,18 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "read_output_cursor_stale",
         aliases: [],
     },
+    {
+        code: "recovery_kind_mismatch",
+        meaning: "Recovery kind mismatch condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/tracker-preflight-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "recovery_kind_mismatch",
+        aliases: [],
+    },
     {
         code: "redundant_edge",
         meaning: "Redundant edge condition.",
@@ -586,7 +622,7 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         exit_code: 1,
         class: "generic_failure",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/agent/refusal-closure.ts"],
+        sources: ["sdk/agent/refusal-closure.ts", "sdk/agent/tracker-preflight-contracts.ts"],
         emitting_commands: ["*"],
         canonical_code: "retry_failed",
         aliases: [],
@@ -970,12 +1006,16 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         exit_code: 3,
         class: "not_found",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["cli/error-guidance.ts", "core/telemetry/observability.ts"],
+        sources: [
+            "cli/error-guidance.ts",
+            "core/store/tracker-preflight.ts",
+            "core/telemetry/observability.ts",
+        ],
         emitting_commands: ["*"],
         canonical_code: "tracker_not_initialized",
         aliases: [],
         owned_states: [
-            { state: "selected_tracker_root_is_a_regular_file", probe_id: "tracker-root-regular-file", entrypoints: ["list"], expected_exit_class: "not_found" },
+            { state: "selected_tracker_root_exists_without_settings", probe_id: "tracker-root-settings-missing", entrypoints: ["list"], expected_exit_class: "not_found" },
         ],
     },
     {
@@ -985,10 +1025,13 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         exit_code: 3,
         class: "not_found",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["core/store/item-store.ts"],
+        sources: ["core/store/tracker-preflight.ts"],
         emitting_commands: ["*"],
         canonical_code: "tracker_root_missing",
         aliases: [],
+        owned_states: [
+            { state: "selected_tracker_root_does_not_exist", probe_id: "tracker-root-missing", entrypoints: ["list"], expected_exit_class: "not_found" },
+        ],
     },
     {
         code: "tracker_root_not_directory",
@@ -997,10 +1040,13 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         exit_code: 2,
         class: "usage",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["core/store/item-store.ts"],
+        sources: ["core/store/tracker-preflight.ts"],
         emitting_commands: ["*"],
         canonical_code: "tracker_root_not_directory",
         aliases: [],
+        owned_states: [
+            { state: "selected_tracker_root_is_a_regular_file", probe_id: "tracker-root-not-directory", entrypoints: ["list"], expected_exit_class: "usage" },
+        ],
     },
     {
         code: "tracker_root_unreadable",
@@ -1009,10 +1055,13 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         exit_code: 1,
         class: "generic_failure",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["core/store/item-store.ts"],
+        sources: ["core/store/tracker-preflight.ts"],
         emitting_commands: ["*"],
         canonical_code: "tracker_root_unreadable",
         aliases: [],
+        owned_states: [
+            { state: "selected_tracker_root_is_not_readable", probe_id: "tracker-root-unreadable", entrypoints: ["list"], expected_exit_class: "generic_failure" },
+        ],
     },
     {
         code: "type_duplicate",
@@ -1219,6 +1268,18 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
             { state: "package_lifecycle_token_is_not_declared", probe_id: "package-unknown-action", entrypoints: ["package"], expected_exit_class: "usage" },
         ],
     },
+    {
+        code: "unsafe_init_recovery",
+        meaning: "Unsafe init recovery condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/tracker-preflight-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "unsafe_init_recovery",
+        aliases: [],
+    },
     {
         code: "unsupported_update_option",
         meaning: "Unsupported update option condition.",
@@ -1917,4 +1978,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=8555c35d-af49-53cd-b782-e9d2fbf65d2f
+//# debugId=d7f4f4f0-d044-5216-b2c4-d76b4d8854a9

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

@@ -3,7 +3,7 @@ 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"];
+export declare const ASSURANCE_MEASUREMENT_SOURCE_KINDS: readonly ["items", "dependency_kind", "prose_edge_gap", "graph", "validate", "health", "history", "links", "provider", "derived"];
 /** Gate lifecycle trigger. */
 export type AssuranceGateTrigger = (typeof ASSURANCE_GATE_TRIGGERS)[number];
 /** Assertion enforcement strength. */
@@ -20,6 +20,8 @@ export interface AssuranceDependencyRecord {
     id: string;
     /** Typed relationship kind. */
     kind: string;
+    /** Provenance channel that created or justified the edge. */
+    source_kind?: string;
 }
 /** Minimal item projection consumed by built-in measurement sources. */
 export interface AssuranceItemRecord {
@@ -80,6 +82,32 @@ export interface AssuranceDependencyKindSource {
     kind: "dependency_kind";
     /** Relationship kind to count. */
     dependency_kind: string;
+    /** Require an exact dependency provenance channel. */
+    source_kind?: string;
+    /** Require a dependency provenance channel with this prefix. */
+    source_kind_prefix?: string;
+    /** Require dependency provenance to be present or missing. */
+    source_kind_state?: "present" | "missing";
+}
+/** Evidence-backed exemption from prose-to-edge parity. */
+export interface AssuranceProseEdgeExemption {
+    /** Holder whose prose contains the reference. */
+    holder_id: string;
+    /** Optional referenced item; omission exempts every matching pair on the holder. */
+    target_id?: string;
+    /** Optional literal that must occur in the same prose segment as the reference. */
+    text_contains?: string;
+    /** Reviewable explanation for why no typed edge should exist. */
+    reason: string;
+}
+/** Prose-reference parity source evaluated directly over authoritative item rows. */
+export interface AssuranceProseEdgeGapSource {
+    /** Source discriminant. */
+    kind: "prose_edge_gap";
+    /** Explicit false-positive ledger; every row requires a reason. */
+    exemptions?: AssuranceProseEdgeExemption[];
+    /** Maximum diagnostic contributors retained after the counts are computed. */
+    sample_limit?: number;
 }
 /** Graph-analytics source delegated to a host adapter. */
 export interface AssuranceGraphSource {
@@ -170,7 +198,7 @@ export interface AssuranceDerivedSource {
     expression: AssuranceDerivedExpression;
 }
 /** Complete measurement source vocabulary. */
-export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;
+export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceProseEdgeGapSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;
 /** Persisted measurement declaration. */
 export interface AssuranceMeasurementDefinition {
     /** Stable registry id. */
@@ -302,6 +330,8 @@ export interface AssuranceExternalMeasurementResult {
     cost: number;
     /** Optional contributors that moved the value. */
     contributors?: string[];
+    /** Optional exact named sub-populations within the observed value. */
+    partitions?: Readonly<Record<string, number>>;
 }
 /** SDK evaluation inputs supplied by a host. */
 export interface AssuranceEvaluationContext {
@@ -348,6 +378,8 @@ export interface AssuranceMeasurementResult {
     cost: AssuranceMeasurementCost;
     /** Optional contributors. */
     contributors: string[];
+    /** Optional exact named sub-populations within the observed value. */
+    partitions?: Readonly<Record<string, number>>;
 }
 /** Structured assertion bound. */
 export interface AssuranceBound {
@@ -384,6 +416,8 @@ export interface AssuranceAssertionVerdict {
     cost: AssuranceMeasurementCost;
     /** Optional contributors. */
     contributors: string[];
+    /** Optional exact named sub-populations within the observed value. */
+    partitions?: Readonly<Record<string, number>>;
 }
 /** Complete gate verdict shared by every presentation and execution surface. */
 export interface AssuranceGateVerdict {