@unbrained/pm-cli 2026.8.20 → 2026.8.22

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/extension/install-sources.d.ts

@@ -91,7 +91,7 @@ export declare function runGitCommand(args: string[], execRunner?: typeof execFi
 export declare function resolveNpmCommandName(platform?: NodeJS.Platform): "npm" | "npm.cmd";
 /** Implements should run npm command in shell for the public runtime surface of this module. */
 export declare function shouldRunNpmCommandInShell(platform?: NodeJS.Platform): boolean;
-declare function runNpmCommand(args: string[], cwd?: string, execRunner?: typeof execFileAsync, platform?: NodeJS.Platform): Promise<string>;
+declare function runNpmCommand(args: string[], cwd?: string, execRunner?: typeof execFileAsync, platform?: NodeJS.Platform, environment?: NodeJS.ProcessEnv): Promise<string>;
 declare function npmPackageNameFromSpec(spec: string): string;
 /** Implements check whether npm not found error for the public runtime surface of this module. */
 export declare function isNpmNotFoundError(error: unknown): boolean;

package/dist/sdk/extension/install-sources.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Install Sources.
  */
 
-!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]="8994c8e2-8e3a-5e00-a3ca-7bd553c045d7")}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]="89b84412-aa15-5868-95b3-c8d898b1f480")}catch(e){}}();
 import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -200,12 +200,15 @@ export function resolveNpmCommandName(platform = process.platform) {
 export function shouldRunNpmCommandInShell(platform = process.platform) {
     return platform === "win32";
 }
-async function runNpmCommand(args, cwd, execRunner = execFileAsync, platform = process.platform) {
+async function runNpmCommand(args, cwd, execRunner = execFileAsync, platform = process.platform, environment = process.env) {
     const npmCommand = resolveNpmCommandName(platform);
+    const env = Object.fromEntries(Object.entries(environment).filter(([key]) => key.toLowerCase() !== "npm_config_allow_scripts"));
+    env.NPM_CONFIG_ALLOW_SCRIPTS = "";
     try {
         const result = await execRunner(npmCommand, args, {
             cwd,
             encoding: "utf8",
+            env,
             shell: shouldRunNpmCommandInShell(platform),
         });
         return (result.stdout ?? "").trim();
@@ -959,4 +962,4 @@ export const _testOnlyInstallSources = {
     runNpmCommand,
 };
 //# sourceMappingURL=install-sources.js.map
-//# debugId=8994c8e2-8e3a-5e00-a3ca-7bd553c045d7
+//# debugId=89b84412-aa15-5868-95b3-c8d898b1f480

package/dist/sdk/extension/output-ownership.d.ts

@@ -4,6 +4,7 @@ interface OutputActivationSummary {
             service: string;
             layer: string;
             name: string;
+            passThrough?: boolean;
         }>;
     };
     renderers: {

package/dist/sdk/extension/output-ownership.js

@@ -4,7 +4,7 @@
  * Classifies output overrides against manifest-declared command ownership.
  */
 
-!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]="0dc7b063-dc72-595f-8e40-8a06f9db69e1")}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]="e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998")}catch(e){}}();
 import { normalizeExtensionNameForMatch } from "./shared.js";
 /** Collect doctor warnings for output overrides without an explicit command or result ownership boundary. */
 export function collectGlobalOutputOverrideDoctorWarnings(activationResult, loadResult) {
@@ -13,6 +13,7 @@ export function collectGlobalOutputOverrideDoctorWarnings(activationResult, load
         : []));
     const serviceWarnings = activationResult.services.overrides
         .filter((entry) => entry.service === "output_format")
+        .filter((entry) => entry.passThrough !== true)
         .filter((entry) => !commandScopedOwners.has(`${entry.layer}:${normalizeExtensionNameForMatch(entry.name)}`))
         .map((entry) => `extension_output_service_override_global:${entry.service}:${entry.layer}:${entry.name}`);
     const rendererWarnings = activationResult.renderers.overrides
@@ -22,4 +23,4 @@ export function collectGlobalOutputOverrideDoctorWarnings(activationResult, load
     return [...new Set([...serviceWarnings, ...rendererWarnings])].sort((left, right) => left.localeCompare(right));
 }
 //# sourceMappingURL=output-ownership.js.map
-//# debugId=0dc7b063-dc72-595f-8e40-8a06f9db69e1
+//# debugId=e5a4cea9-ac5d-5bda-9f7c-6cf8cf9e9998

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]="2903ebb9-541a-5636-ae3c-e996d3f0cec4")}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.",
@@ -926,6 +962,42 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "github_source_entry_unbuilt",
         aliases: [],
     },
+    {
+        code: "hierarchy_cardinality_created",
+        meaning: "Hierarchy cardinality created condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/hierarchy-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "hierarchy_cardinality_created",
+        aliases: [],
+    },
+    {
+        code: "hierarchy_cycle_created",
+        meaning: "Hierarchy cycle created condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/hierarchy-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "hierarchy_cycle_created",
+        aliases: [],
+    },
+    {
+        code: "hierarchy_parent_divergence_created",
+        meaning: "Hierarchy parent divergence created condition.",
+        stability: "provisional",
+        exit_code: 4,
+        class: "conflict",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/graph/hierarchy-integrity.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "hierarchy_parent_divergence_created",
+        aliases: [],
+    },
     {
         code: "history_author_acknowledge_plan_conflict",
         meaning: "History author acknowledge plan conflict condition.",
@@ -1896,18 +1968,6 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "missing_budget",
         aliases: [],
     },
-    {
-        code: "missing_cli_flag",
-        meaning: "Missing cli flag condition.",
-        stability: "provisional",
-        exit_code: 1,
-        class: "generic_failure",
-        recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
-        emitting_commands: ["*"],
-        canonical_code: "missing_cli_flag",
-        aliases: [],
-    },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=145e12fa-839c-59da-840b-e2a0f3f13065
+//# debugId=2903ebb9-541a-5636-ae3c-e996d3f0cec4

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

@@ -1,7 +1,19 @@
 /** 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]="4f1bb829-c6be-5a3e-90f2-4b0062aa2dac")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
+    {
+        code: "missing_cli_flag",
+        meaning: "Missing cli flag condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_cli_flag",
+        aliases: [],
+    },
     {
         code: "missing_destination",
         meaning: "Missing destination condition.",
@@ -26,6 +38,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 +98,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 +519,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 +634,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 +1018,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 +1037,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 +1052,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 +1067,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 +1280,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 +1990,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=4f1bb829-c6be-5a3e-90f2-4b0062aa2dac

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 {