@unbrained/pm-cli 2026.8.22 → 2026.8.24

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]="4f1bb829-c6be-5a3e-90f2-4b0062aa2dac")}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]="8724f8ed-1236-5779-9e97-dc4b35866839")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
     {
         code: "missing_cli_flag",
@@ -122,6 +122,7 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
             "cli/main.ts",
             "cli/register-mutation.ts",
             "core/telemetry/observability.ts",
+            "sdk/governance/assurance-action.ts",
             "sdk/history-redact.ts",
             "sdk/invocation-author.ts",
         ],
@@ -543,6 +544,78 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "redundant_edge",
         aliases: [],
     },
+    {
+        code: "refusal_allowed_values_mismatch",
+        meaning: "Refusal allowed values mismatch condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "refusal_allowed_values_mismatch",
+        aliases: [],
+    },
+    {
+        code: "refusal_error_code_mismatch",
+        meaning: "Refusal error 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/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "refusal_error_code_mismatch",
+        aliases: [],
+    },
+    {
+        code: "refusal_exit_code_mismatch",
+        meaning: "Refusal 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/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "refusal_exit_code_mismatch",
+        aliases: [],
+    },
+    {
+        code: "refusal_mutated_state",
+        meaning: "Refusal mutated state condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "refusal_mutated_state",
+        aliases: [],
+    },
+    {
+        code: "refusal_probe_missing",
+        meaning: "Refusal probe missing condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "refusal_probe_missing",
+        aliases: [],
+    },
+    {
+        code: "refusal_recovery_failed",
+        meaning: "Refusal recovery failed condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "refusal_recovery_failed",
+        aliases: [],
+    },
     {
         code: "reindex_already_running",
         meaning: "Reindex already running condition.",
@@ -1111,6 +1184,18 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         canonical_code: "undeclared_observation",
         aliases: [],
     },
+    {
+        code: "unexpected_refusal_probe",
+        meaning: "Unexpected refusal probe condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/refusal-corpus-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "unexpected_refusal_probe",
+        aliases: [],
+    },
     {
         code: "unknown_command",
         meaning: "Unknown command condition.",
@@ -1990,4 +2075,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=4f1bb829-c6be-5a3e-90f2-4b0062aa2dac
+//# debugId=8724f8ed-1236-5779-9e97-dc4b35866839

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

@@ -4,7 +4,7 @@
  * Normalizes the assurance action vocabulary once for CLI, SDK, and MCP hosts.
  */
 
-!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]="57c12241-812d-5db6-9a07-ca256152b130")}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]="f66a964d-1352-5523-ab91-5177d0d93ce8")}catch(e){}}();
 import { createHash } from "node:crypto";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
@@ -18,6 +18,7 @@ import { resolvePmRoot } from "../runtime-primitives.js";
 import { parseRuntimeInteger, readRuntimeString } from "../runtime-input.js";
 import { analyzeDefectChangeRisk, buildDefectRecurrenceIndex, parseDefectChangeRiskRequest, } from "./defect-recurrence.js";
 import { defectRecurrenceItemSignals } from "./defect-recurrence-signals.js";
+import { createUnknownSubcommandError } from "../agent/subcommand-recovery.js";
 let riskIndexCache;
 /** Assurance registry and evaluation verbs shared by every transport. */
 export const ASSURANCE_ACTIONS = [
@@ -43,17 +44,36 @@ function parseAction(value) {
     if (ASSURANCE_ACTIONS.includes(value)) {
         return value;
     }
-    throw new PmCliError(`Unknown assurance action ${value}. Expected: ${ASSURANCE_ACTIONS.join(", ")}`, EXIT_CODE.USAGE);
+    throw createUnknownSubcommandError({
+        command_path: "assurance",
+        token: value,
+        allowed: ASSURANCE_ACTIONS,
+        display_name: "assurance action",
+    });
+}
+/** Throw the shared structured usage refusal for a missing assurance operand. */
+function missingAssuranceArgument(operand, detail, example) {
+    throw new PmCliError(detail, EXIT_CODE.USAGE, {
+        code: "missing_required_argument",
+        required: `Provide the missing assurance operand: ${operand}.`,
+        examples: [example],
+        recovery: { missing: [operand] },
+    });
 }
 function parseKind(value) {
-    if (value &&
-        ASSURANCE_DECLARATION_KINDS.includes(value)) {
+    if (!value) {
+        return missingAssuranceArgument("kind", `Assurance declaration kind is required. Expected: ${ASSURANCE_DECLARATION_KINDS.join(", ")}`, "pm assurance list measurement");
+    }
+    if (ASSURANCE_DECLARATION_KINDS.includes(value)) {
         return value;
     }
     throw new PmCliError(`Assurance declaration kind is required. Expected: ${ASSURANCE_DECLARATION_KINDS.join(", ")}`, EXIT_CODE.USAGE);
 }
 function parsePreset(value) {
-    if (value && ASSURANCE_PRESET_IDS.includes(value)) {
+    if (!value) {
+        return missingAssuranceArgument("preset", `Assurance preset is required. Expected: ${ASSURANCE_PRESET_IDS.join(", ")}`, "pm assurance apply software-delivery --owner <pm-item-id>");
+    }
+    if (ASSURANCE_PRESET_IDS.includes(value)) {
         return value;
     }
     throw new PmCliError(`Assurance preset is required. Expected: ${ASSURANCE_PRESET_IDS.join(", ")}`, EXIT_CODE.USAGE);
@@ -61,7 +81,7 @@ function parsePreset(value) {
 function requireOwner(input) {
     if (input.owner?.trim())
         return input.owner.trim();
-    throw new PmCliError("assurance preset and derivation actions require --owner <pm-item-id>", EXIT_CODE.USAGE);
+    return missingAssuranceArgument("owner", "assurance preset and derivation actions require --owner <pm-item-id>", "pm assurance apply software-delivery --owner <pm-item-id>");
 }
 function parseDefinition(kind, value) {
     let parsed = value;
@@ -173,7 +193,7 @@ async function runAdoptionAction(action, input, pmRoot) {
         };
     }
     if (!input.id) {
-        throw new PmCliError("assurance promote requires an assertion id", EXIT_CODE.USAGE);
+        return missingAssuranceArgument("assertion-id", "assurance promote requires an assertion id", "pm assurance promote <assertion-id> --enforcement warn");
     }
     if (input.enforcement !== "warn" && input.enforcement !== "block") {
         throw new PmCliError("assurance promote requires --enforcement warn|block", EXIT_CODE.USAGE);
@@ -186,7 +206,7 @@ async function runAdoptionAction(action, input, pmRoot) {
 }
 async function runGateAction(input, pmRoot, runtime) {
     if (!input.id) {
-        throw new PmCliError("assurance run requires a gate id", EXIT_CODE.USAGE);
+        return missingAssuranceArgument("gate-id", "assurance run requires a gate id", "pm assurance run <gate-id> --trigger ci --dry-run");
     }
     const gateId = input.id;
     if (!input.trigger) {
@@ -320,7 +340,7 @@ export async function runAssuranceAction(input, global = {}, runtime = {}) {
     if (action === "list")
         return listAssuranceDeclarations(pmRoot, kind);
     if (!input.id) {
-        throw new PmCliError(`assurance ${action} requires an id`, EXIT_CODE.USAGE);
+        return missingAssuranceArgument("id", `assurance ${action} requires an id`, `pm assurance ${action} ${kind} <id>`);
     }
     const id = input.id;
     if (action === "show") {
@@ -377,4 +397,4 @@ export function runAssuranceDispatch(args, options, global) {
     }, global);
 }
 //# sourceMappingURL=assurance-action.js.map
-//# debugId=57c12241-812d-5db6-9a07-ca256152b130
+//# debugId=f66a964d-1352-5523-ab91-5177d0d93ce8

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

@@ -231,10 +231,10 @@ declare function buildFilesCheck(items: ItemWithBody[], workspaceRoot: string, p
     warnings: string[];
     staleLinkPruneRows: StaleLinkPruneRow[];
 }>;
-declare function buildCommandReferencesCheck(items: ItemWithBody[], idPrefix: string, verboseDiagnostics: boolean): {
+declare function buildCommandReferencesCheck(items: ItemWithBody[], idPrefix: string, verboseDiagnostics: boolean, pmRoot: string): Promise<{
     check: ValidateCheck;
     warnings: string[];
-};
+}>;
 /** Apply one planned fix through the SAME audited command paths an operator would use by hand (`pm update` / `pm files --remove` / `pm docs --remove`), so every applied fix carries normal history, locking, and hook behavior. Command modules are imported lazily: plain validate runs stay read-only and never pay the mutation-stack import cost. */
 declare function applyValidateFix(fix: ValidateFixRecord, global: GlobalOptions, services: ValidateMutationServices): Promise<void>;
 declare function applyValidateFixes(applicable: ValidateFixRecord[], global: GlobalOptions, services: ValidateMutationServices): Promise<{

package/dist/sdk/governance/validate.js

@@ -4,7 +4,7 @@
  * Implements the pm validate 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]="87e3932d-26f0-5d44-ac35-5d0d7d1f4467")}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]="aca69fd7-c47a-5424-b58f-f305f690edd9")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import { realpathSync } from "node:fs";
@@ -42,6 +42,7 @@ import { createRelationshipKindRegistry, } from "../relationships.js";
 import { runDocs } from "../docs.js";
 import { runFiles } from "../files.js";
 import { extractReferencedPmItemIdsFromCommand } from "../test/linked-command-detection.js";
+import { resolveLinkedTestSourceRef, resolveLinkedTestSourceWorkspaceRoot, resolveLinkedTestTrustBatch, } from "../test/trust.js";
 import { readValidateItems, } from "./validate-item-reader.js";
 import { buildValidateHistoryDriftCheck } from "./validate-history-drift.js";
 import { buildLifecycleParentGraph, detectLifecycleParentCycles, resolveLifecycleDependencyCycleSamplePath, } from "./hierarchy-validation.js";
@@ -1710,23 +1711,40 @@ async function buildFilesCheck(items, workspaceRoot, pmRoot, fileScanMode, inclu
     };
 }
 /* c8 ignore stop */
-/* c8 ignore start -- command preview truncation formatting is covered by command-reference integration fixtures */
-function summarizeCommandReferenceRow(ownerId, referencedId, command) {
+/** Collapse a linked command to the bounded preview used in validation rows. */
+function summarizeCommandPreview(command) {
     const normalizedCommand = command.trim().replaceAll(/\s+/g, " ");
-    const commandPreview = normalizedCommand.length > 120
+    return normalizedCommand.length > 120
         ? `${normalizedCommand.slice(0, 117)}...`
         : normalizedCommand;
-    return `${ownerId}:${referencedId}:${commandPreview}`;
 }
-/* c8 ignore stop */
+/** Join command-reference identity and its bounded preview for diagnostics. */
+function summarizeCommandReferenceRow(ownerId, referencedId, command) {
+    return `${ownerId}:${referencedId}:${summarizeCommandPreview(command)}`;
+}
+/** Render portable diagnostics for linked tests that this clone has not trusted. */
+function buildUntrustedLinkedTestRows(linkedTests, trustDecisions) {
+    const rows = [];
+    linkedTests.forEach(({ item, linkedTest }, index) => {
+        const trust = trustDecisions[index];
+        if (trust.trusted)
+            return;
+        const command = summarizeCommandPreview(linkedTest.command ?? "");
+        rows.push(`${item.id}:${trust.source_ref ?? "unknown"}->${trust.current_source_ref ?? "unknown"}:${command}`);
+    });
+    return rows;
+}
 /* c8 ignore start -- command-reference discovery/stale-id permutations are covered by linked-test integration suites */
-function buildCommandReferencesCheck(items, idPrefix, verboseDiagnostics) {
+async function buildCommandReferencesCheck(items, idPrefix, verboseDiagnostics, pmRoot) {
     const knownIds = new Set(items.map((item) => item.id.toLowerCase()));
     let linkedCommandsScanned = 0;
     let referencedPmIdCount = 0;
     const referencedPmIds = new Set();
     const staleReferenceRows = [];
     const linkedTests = items.flatMap((item) => (item.tests ?? []).map((linkedTest) => ({ item, linkedTest })));
+    const currentSourceRef = await resolveLinkedTestSourceRef(resolveLinkedTestSourceWorkspaceRoot());
+    const trustDecisions = await resolveLinkedTestTrustBatch(pmRoot, linkedTests.map(({ linkedTest }) => linkedTest), currentSourceRef);
+    const untrustedRows = buildUntrustedLinkedTestRows(linkedTests, trustDecisions);
     for (const { item, linkedTest } of linkedTests) {
         if (typeof linkedTest.command !== "string" ||
             linkedTest.command.trim().length === 0) {
@@ -1751,17 +1769,20 @@ function buildCommandReferencesCheck(items, idPrefix, verboseDiagnostics) {
     ]
         .filter((value) => value.length > 0)
         .sort((left, right) => left.localeCompare(right));
-    const warnings = uniqueStaleReferenceRows.length > 0
-        ? [
-            `validate_command_references_stale_pm_ids:${uniqueStaleReferenceRows.length}`,
-        ]
-        : [];
+    const warnings = [];
+    if (uniqueStaleReferenceRows.length > 0) {
+        warnings.push(`validate_command_references_stale_pm_ids:${uniqueStaleReferenceRows.length}`);
+    }
+    if (untrustedRows.length > 0) {
+        warnings.push(`validate_linked_test_trust_unacknowledged:${untrustedRows.length}`);
+    }
     const diagnosticLimit = verboseDiagnostics
         ? Number.POSITIVE_INFINITY
         : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
     const summarizedRows = summarizeList(uniqueStaleReferenceRows, diagnosticLimit);
     const summarizedStalePmIds = summarizeList(stalePmIds, diagnosticLimit);
     const summarizedReferencedPmIds = summarizeList([...referencedPmIds].sort((left, right) => left.localeCompare(right)), diagnosticLimit);
+    const summarizedUntrustedRows = summarizeList(untrustedRows, diagnosticLimit);
     return {
         check: {
             name: "command_references",
@@ -1774,6 +1795,10 @@ function buildCommandReferencesCheck(items, idPrefix, verboseDiagnostics) {
                 unique_referenced_pm_ids_count: referencedPmIds.size,
                 unique_referenced_pm_ids: summarizedReferencedPmIds.values,
                 unique_referenced_pm_ids_truncated: summarizedReferencedPmIds.truncated,
+                linked_test_trust_current_source_ref: currentSourceRef ?? null,
+                untrusted_linked_tests_count: untrustedRows.length,
+                untrusted_linked_tests: summarizedUntrustedRows.values,
+                untrusted_linked_tests_truncated: summarizedUntrustedRows.truncated,
                 stale_pm_id_references_count: uniqueStaleReferenceRows.length,
                 stale_pm_ids_count: stalePmIds.length,
                 stale_pm_ids: summarizedStalePmIds.values,
@@ -2093,7 +2118,7 @@ async function executeRequestedValidateChecks(params) {
         recordValidateCheck(state, built, fixHintsEnabled);
     }
     if (params.requestedChecks.has("command_references")) {
-        recordValidateCheck(state, buildCommandReferencesCheck(params.items, params.settings.id_prefix, fullDiagnostics), fixHintsEnabled);
+        recordValidateCheck(state, await buildCommandReferencesCheck(params.items, params.settings.id_prefix, fullDiagnostics, params.pmRoot), fixHintsEnabled);
     }
     if (params.requestedChecks.has("history_drift")) {
         recordValidateCheck(state, await buildValidateHistoryDriftCheck(params.pmRoot, params.items, fullDiagnostics), fixHintsEnabled);
@@ -2255,4 +2280,4 @@ export async function runValidate(options, global, services = {}) {
 }
 /* c8 ignore stop */
 //# sourceMappingURL=validate.js.map
-//# debugId=87e3932d-26f0-5d44-ac35-5d0d7d1f4467
+//# debugId=aca69fd7-c47a-5424-b58f-f305f690edd9

package/dist/sdk/guide-topics.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module cli/guide-topics
- *
- * Provides CLI runtime support for Guide Topics.
- */
 /** Describes one documentation file surfaced by a progressive-disclosure guide topic. */
 export interface GuideDocReference {
     /** Filesystem path used for path resolution. */

package/dist/sdk/guide-topics.js

@@ -1,9 +1,35 @@
+/**
+ * @module cli/guide-topics
+ *
+ * Provides CLI runtime support for Guide Topics.
+ */
 
-!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]="7be35c3f-df6f-5ed6-b887-a7d8d53910a7")}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]="3e5f92c9-c299-592d-a7ab-a6f9998159f0")}catch(e){}}();
+import { listPmCommandCapabilityGroups } from "./agent-capability-contracts.js";
 function normalizeTopicToken(value) {
     return value.trim().toLowerCase().replaceAll("_", "-");
 }
 const GUIDE_TOPICS = [
+    {
+        id: "capabilities",
+        aliases: ["capability-map", "families", "routing"],
+        title: "Generated Capability Routing",
+        summary: "Route work through command families generated from the canonical agent capability contract.",
+        intent: "Use this as the drift-free entrypoint when selecting a CLI, MCP, completion, documentation, or extension command surface.",
+        commands: listPmCommandCapabilityGroups().flatMap(({ commands }) => commands.map((command) => `pm ${command}`)),
+        workflows: [],
+        docs: [
+            {
+                path: "docs/generated/AGENT_CAPABILITY_ROUTING.md",
+                purpose: "Generated command-to-family routing table.",
+            },
+            {
+                path: "docs/generated/AGENT_COMMAND_SURFACE.md",
+                purpose: "Generated visibility-tier and family table.",
+            },
+        ],
+        related: ["commands", "workflows", "extensions"],
+    },
     {
         id: "quickstart",
         aliases: ["start", "getting-started", "bootstrap"],
@@ -565,4 +591,4 @@ export function resolveGuideTopic(rawTopic) {
     return TOPIC_BY_TOKEN.get(normalized) ?? null;
 }
 //# sourceMappingURL=guide-topics.js.map
-//# debugId=7be35c3f-df6f-5ed6-b887-a7d8d53910a7
+//# debugId=3e5f92c9-c299-592d-a7ab-a6f9998159f0

package/dist/sdk/history-compact.d.ts

@@ -1,4 +1,5 @@
 import { type HistoryCompactBulkSkipReason, type HistoryCompactScope } from "../core/history/history-compact-bulk.js";
+import { type BulkIdsValue } from "../core/io/bulk-ids-input.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 /** Documents the history compact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactCommandOptions {
@@ -58,7 +59,7 @@ export declare const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
 /** Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactBulkCommandOptions {
     /** Value that configures or reports ids for this contract. */
-    ids?: string[];
+    ids?: BulkIdsValue;
     /** Value that configures or reports scope for this contract. */
     scope?: HistoryCompactScope;
     /** Value that configures or reports all over for this contract. */

package/dist/sdk/history-compact.js

@@ -4,7 +4,7 @@
  * Implements the pm history compact 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]="adcf4d1b-689d-52cb-903b-5fba857707f3")}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]="31152621-df59-54a5-a28d-63119e734e6e")}catch(e){}}();
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -19,6 +19,7 @@ import { lifecycleClassifierFromStatusRegistry } from "../core/governance/metada
 import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
 import { listAllItemMetadataLight } from "../core/store/item-store.js";
 import { pathExists, readFileIfExists } from "../core/fs/fs-utils.js";
+import { normalizeBulkIdsValue, parseBulkIdsText, } from "../core/io/bulk-ids-input.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { nowIso } from "../core/shared/time.js";
@@ -301,6 +302,21 @@ export async function runHistoryCompact(id, options, global) {
 }
 /** Default entry floor below which a stream is treated as already compact. */
 export const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
+function normalizeHistoryCompactBulkOptions(options) {
+    const normalizedIdsText = normalizeBulkIdsValue(options.ids);
+    if (options.ids !== undefined && normalizedIdsText === "") {
+        throw new PmCliError("history-compact ids requires at least one valid item ID.", EXIT_CODE.USAGE, {
+            code: "bulk_ids_input_empty",
+            required: "Provide one or more string or finite numeric IDs; non-finite and unsupported selector values are rejected.",
+        });
+    }
+    return {
+        ...options,
+        ids: normalizedIdsText === undefined
+            ? undefined
+            : parseBulkIdsText(normalizedIdsText),
+    };
+}
 /** Enforce the `pm history-compact` target contract shared by the CLI and MCP surfaces: exactly one selection mode — a single item `<id>`, an explicit `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`). */
 export function assertHistoryCompactTarget(id, bulk) {
     const hasIds = bulk.ids !== undefined && bulk.ids.length > 0;
@@ -436,6 +452,7 @@ async function runHistoryCompactBulkRow(params) {
  * configured policy drives the sweep.
  */
 export async function runHistoryCompactBulk(options, global) {
+    const normalizedOptions = normalizeHistoryCompactBulkOptions(options);
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
@@ -445,14 +462,16 @@ export async function runHistoryCompactBulk(options, global) {
         settings,
         typeToFolder: typeRegistry.type_to_folder,
     });
-    const mode = options.ids !== undefined && options.ids.length > 0 ? "ids" : "scan";
+    const mode = normalizedOptions.ids !== undefined && normalizedOptions.ids.length > 0
+        ? "ids"
+        : "scan";
     const minEntries = options.minEntries ?? HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES;
     const policy = settings.history.compact_policy;
     const policyThresholdApplied = mode === "scan" && options.allOver === undefined && policy.enabled;
     const allOver = options.allOver ??
         (policyThresholdApplied ? policy.max_entries : undefined);
     const selection = selectHistoryCompactBulkTargets(candidates, {
-        ids: options.ids,
+        ids: normalizedOptions.ids,
         scope: options.scope,
         minEntries,
         allOver,
@@ -469,7 +488,7 @@ export async function runHistoryCompactBulk(options, global) {
     for (const row of selection) {
         const outcome = await runHistoryCompactBulkRow({
             row,
-            options,
+            options: normalizedOptions,
             dryRun,
             global,
         });
@@ -502,4 +521,4 @@ export async function runHistoryCompactBulk(options, global) {
     };
 }
 //# sourceMappingURL=history-compact.js.map
-//# debugId=adcf4d1b-689d-52cb-903b-5fba857707f3
+//# debugId=31152621-df59-54a5-a28d-63119e734e6e

package/dist/sdk/history-mcp.js

@@ -1,5 +1,6 @@
 
-!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]="f762b5e6-8224-531f-9dd1-f71dc18c3ddf")}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]="4888a558-7f50-5c28-8e29-fcd19180cbd4")}catch(e){}}();
+import { normalizeBulkIdsValue, parseBulkIdsText, } from "../core/io/bulk-ids-input.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { assertHistoryCompactTarget, runHistoryCompact, runHistoryCompactBulk, } from "./history-compact.js";
@@ -17,14 +18,14 @@ export function runMcpHistoryRepairAction(context) {
 /** Dispatch single or bounded bulk history compaction from an MCP payload. */
 export function runMcpHistoryCompactAction(context) {
     const idsSource = context.options.ids;
-    const ids = Array.isArray(idsSource)
-        ? idsSource.map(String).filter((value) => value.trim().length > 0)
-        : typeof idsSource === "string"
-            ? idsSource
-                .split(",")
-                .map((value) => value.trim())
-                .filter(Boolean)
-            : undefined;
+    const normalizedIds = normalizeBulkIdsValue(idsSource);
+    if (idsSource !== undefined && normalizedIds === "") {
+        throw new PmCliError("history-compact ids requires at least one valid item ID.", EXIT_CODE.USAGE, {
+            code: "bulk_ids_input_empty",
+            required: "Provide one or more string or finite numeric IDs; non-finite and unsupported selector values are rejected.",
+        });
+    }
+    const ids = normalizedIds === undefined ? undefined : parseBulkIdsText(normalizedIds);
     const allOver = parseRuntimeInteger(context.options.allOver ?? context.options.all_over, "history-compact allOver");
     const minEntries = parseRuntimeInteger(context.options.minEntries ?? context.options.min_entries, "history-compact minEntries");
     const explicitScope = readRuntimeString(context.options, "scope");
@@ -65,4 +66,4 @@ export function runMcpHistoryCompactAction(context) {
     }, context.global);
 }
 //# sourceMappingURL=history-mcp.js.map
-//# debugId=f762b5e6-8224-531f-9dd1-f71dc18c3ddf
+//# debugId=4888a558-7f50-5c28-8e29-fcd19180cbd4

package/dist/sdk/index.d.ts

@@ -13,6 +13,7 @@ export { BUILTIN_CORPUS_SHAPES, PM_CORPUS_SHAPE_SCHEMA, buildCorpusShapeItemPlan
 export * from "./core-governance.js";
 export { createPmCliProgram } from "./cli-program.js";
 export { runSearchRefreshWorkerEntrypoint } from "./search-refresh-worker.js";
+export { PM_REPRODUCIBLE_PROCESS_ENV, createReproducibleProcessRunner, resolveReproducibleProcessEnvironment, runWithReproducibleProcessEnvironment, type ReproducibleExecutionSettings, type ReproducibleProcessEnvironment, type ReproducibleProcessRunner, } from "./reproducibility/process.js";
 export { PM_WORKSPACE_RECIPE_SCHEMA, defineWorkspaceRecipe, executeWorkspaceRecipe, runWithWorkspaceRecipe, type WorkspaceRecipe, type WorkspaceRecipeJsonValue, type WorkspaceRecipeOperation, } from "./workspace-recipe.js";
 export { SNAPSHOT_SCHEMA, WORKSPACE_SNAPSHOT_ACTIONS, createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshot, restoreWorkspaceSnapshotWithRecovery, type CreateWorkspaceSnapshotResult, type RestoreWorkspaceSnapshotOptions, type RestoreWorkspaceSnapshotResult, type WorkspaceSnapshotHistoryImpact, type WorkspaceSnapshotManifest, type WorkspaceSnapshotReference, type WorkspaceSnapshotRestorePlan, } from "./workspace-snapshot.js";
 export { flushTelemetryQueue } from "./telemetry-flush.js";
@@ -48,6 +49,7 @@ export { discoverNearbyPmRoot } from "./tracker-root-discovery.js";
 export { assertInitializedTracker, assertReadableTrackerRoot, buildTrackerInitializationRecovery, } from "./environment/tracker-preflight.js";
 export { _testOnly as _testOnlyTemplates, type TemplateSource, } from "./templates.js";
 export { runConfig, _testOnlyConfigCommand, type NestedSettingResultValue, } from "./config.js";
+export * from "./agent/identity-config.js";
 export { INIT_AGENT_GUIDANCE_MODE_VALUES, runInitAgentGuidance, _testOnly as _testOnlyInitAgentGuidance, type InitAgentGuidanceMode, type InitAgentGuidanceSummary, type RunInitAgentGuidanceOptions, type RunInitAgentGuidanceResult, } from "./init-agent-guidance.js";
 export { runInit, summarizeInitResult, _testOnly as _testOnlyInit, type InitAgentGuidanceResult, type InitConciseResult, type InitInstalledPackagesSummary, type InitRegisteredTypePresetSummary, type InitTargetResolution, type InitTypePresetName, } from "./init.js";
 export { PROFILE_SUBCOMMANDS, formatProfileApplyHuman, formatProfileLintHuman, formatProfileListHuman, formatProfileShowHuman, runProfileApply, runProfileLint, runProfileList, runProfileShow, type ProfileApplyDimension, type ProfileComposition, type ProfileListEntry, } from "./profile.js";
@@ -57,7 +59,7 @@ export type { LocatedItem } from "../core/store/item-store.js";
 export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, type PmPackageCatalogLinkMap, type PmPackageCatalogMediaMap, type PmPackageCatalogMetadata, type PmPackageManifest, type PmPackageResourceKind, type PmPackageResourceMap, } from "../core/packages/manifest.js";
 export type { CommanderOptionAliasContract, CommanderOptionRegistrationContract, } from "./cli-contracts.js";
 export { ACTIVITY_FLAG_CONTRACTS, ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_ACTION_OPTION_KEYS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_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_SCOPE_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PLAN_FLAG_CONTRACTS, PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_DEGRADATION_STEPS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_CLASSES, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_CORE_COMMAND_NAMES, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, 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_PROVIDER_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_ACTIONS, analyzePmToolActionParity, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, PROFILE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, verifyToolOptionCliParity, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, compactFlagAliasContracts, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, projectPmDiagnosticOutput, projectPmDiagnosticText, analyzeSdkCliParameterCompleteness, isPmExtensionCapabilityContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, isPmExtensionServiceNameContract, isPmToolAction, hasSubcommandFlagContractsForCommand, readFirstStringFromCommanderOptions, readFirstValueFromCommanderOptions, readStringArrayFromCommanderOptions, resolvePmPositionalActionFlagContracts, resolveSubcommandFlagContractsForCommand, resolvePmCommandOutputBudget, resolvePmDiagnosticOutputBudget, resolvePmToolCustomFieldCollision, toCompletionFlagString, withFlagAliasMetadata, } from "./cli-contracts.js";
-export type { CliFlagContract, OptionsFromContracts, PmActionSchemaContract, PmActionToolInputSchemaOptions, PmToolCustomFieldCollision, PmBulkMutationControlOptions, PmBulkMutationFilterOptions, PmCloseActionOptions, PmCloseManyActionOptions, PmCreateActionOptions, PmMutationAttributionOptions, PmOptionScalar, PmCommandOutputBudgetContract, PmDiagnosticDegradationStep, PmDiagnosticOutputBudgetContract, PmDiagnosticOutputClass, PmDiagnosticOutputReceipt, PmOutputBudgetClass, PmOutputDegradationStep, PmProjectedDiagnostic, PmProjectedTextDiagnostic, PmUpdateActionOptions, PmUpdateManyActionOptions, PmExtensionCapabilityContract, PmExtensionPolicyModeContract, PmExtensionPolicySurfaceContract, PmExtensionSandboxProfileContract, PmExtensionServiceNameContract, PmExtensionTrustModeContract, PmToolAction, SdkCliActionParameterCoverage, SdkCliCompletenessContractSource, SdkCliParameterCoverageEntry, SdkCliParameterDisposition, ToolOptionFlagContract, ToolOptionCliParityFinding, ToolOptionCliParityReport, } from "./cli-contracts.js";
+export type { CliFlagContract, OptionsFromContracts, PmActionSchemaContract, PmActionToolInputSchemaOptions, PmToolCustomFieldCollision, PmBulkMutationControlOptions, PmBulkMutationFilterOptions, PmCloseActionOptions, PmCloseManyActionOptions, PmCreateActionOptions, PmMutationAttributionOptions, PmOptionScalar, PmCommandOutputBudgetContract, PmDiagnosticDegradationStep, PmDiagnosticOutputBudgetContract, PmDiagnosticOutputClass, PmDiagnosticOutputReceipt, PmOutputBudgetClass, PmOutputDegradationStep, PmProjectedDiagnostic, PmProjectedTextDiagnostic, PmUpdateActionOptions, PmUpdateManyActionOptions, PmExtensionCapabilityContract, PmExtensionPolicyModeContract, PmExtensionPolicySurfaceContract, PmExtensionSandboxProfileContract, PmExtensionServiceNameContract, PmExtensionTrustModeContract, MergeSubcommand, PmToolAction, SdkCliActionParameterCoverage, SdkCliCompletenessContractSource, SdkCliParameterCoverageEntry, SdkCliParameterDisposition, ToolOptionFlagContract, ToolOptionCliParityFinding, ToolOptionCliParityReport, } from "./cli-contracts.js";
 export * from "./compose.js";
 export * from "./governance/assurance.js";
 export * from "./governance/assurance-action.js";
@@ -122,8 +124,11 @@ export * from "./error-runtime.js";
 export * from "./error-code-catalog.js";
 export * from "./generated-error-code-catalog.js";
 export * from "./agent/refusal-reachability.js";
+export * from "./agent/refusal-closure-census.js";
 export * from "./agent/refusal-closure.js";
 export * from "./agent/closed-domain-contracts.js";
+export * from "./agent/refusal-corpus-contracts.js";
+export { MERGE_SUBCOMMAND_VALUES } from "./cli-contracts.js";
 export * from "./agent/tracker-preflight-contracts.js";
 export * from "./agent/subcommand-recovery.js";
 export * from "./flag-invocation-contracts.js";
@@ -159,7 +164,8 @@ export { runTelemetry, TELEMETRY_SUBCOMMANDS, type TelemetryCommandOptions, type
 export { classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, type LinkedTestFailureCategory, type TestCommandOptions, type TestResult, type TestRunResult, } from "./test/execution.js";
 export { TEST_RUN_MEASUREMENT_LIMIT, diffTestRunMeasurements, parseTestRunMeasurements, queryTestRunMeasurementsBelow, type TestRunMeasurementDiff, } from "./test/measurements.js";
 export { runTestAll, type TestAllCommandOptions, type TestAllItemResult, type TestAllResult, } from "./test/batch.js";
-export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, type LinkedTestPmContextMode, } from "./test/parsers.js";
+export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, parseLinkedTestWorkspaceContextMode, type LinkedTestPmContextMode, type LinkedTestWorkspaceContextMode, } from "./test/parsers.js";
+export { acknowledgeLinkedTests, attachLinkedTestMutationProvenance, attachLinkedTestProvenance, linkedTestTrustFingerprint, resolveLinkedTestSourceRef, resolveLinkedTestSourceWorkspaceRoot, resolveLinkedTestTrust, resolveLinkedTestTrustBatch, type LinkedTestTrustDecision, } from "./test/trust.js";
 export { runStartBackgroundRun, runTestRunsWorker, type StartBackgroundRunCommandOptions, type StartBackgroundRunResult, } from "./test/runs.js";
 export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, type ProfileConfigEntry, type ProfileName, type ProfilePackageRecommendation, type ProfileTemplateEntry, type ProfileTemplateOptions, type ProjectProfileDefinition, type ProjectProfileRegistrationInput, } from "../core/profile/profile-presets.js";
 export { planProfileApplication, type ProfileApplicationPlan, type ProfileChangeStatus, type ProfileComponentChange, type ProfileConfigChange, type ProfileConfigPlan, type ProfileCurrentState, type ProfilePackagePlan, type ProfileSchemaPlan, type ProfileTemplateChange, type ProfileTemplatePlan, type ProfileWorkflowChange, type ProfileWorkflowPlan, } from "../core/profile/profile-plan.js";