@unbrained/pm-cli 2026.8.22 → 2026.8.24

package/dist/sdk/config.js

@@ -4,7 +4,7 @@
  * Implements the pm config 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]="5918331a-46e9-5699-b85d-89f49a27d341")}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]="2f750f85-6c55-5f0f-b5c0-396764839d2a")}catch(e){}}();
 import { resolveConfigPositionalValue, } from "../core/config/positional-value.js";
 import { NESTED_SETTING_DESCRIPTORS, parseNestedSettingValue, readNestedSettingValue, resolveNestedSettingDescriptor, writeNestedSettingValue, } from "../core/config/nested-settings.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
@@ -16,6 +16,7 @@ import { resolveItemTypesFilePath } from "../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { createUnknownSubcommandError } from "./agent/subcommand-recovery.js";
+import { planAgentIdentityVocabularyMutation, summarizeAgentIdentityVocabulary, } from "./agent/identity-config.js";
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 import { getSettingsPath, resolveGlobalPmRoot, resolvePmRoot, } from "../core/store/paths.js";
@@ -99,7 +100,15 @@ const CONFIG_KEY_ALIASES = {
         "governance_force_required_for_stale_lock",
     ],
     test_result_tracking: ["test-result-tracking", "test_result_tracking"],
+    untrusted_linked_test_execution: [
+        "untrusted-linked-test-execution",
+        "untrusted_linked_test_execution",
+    ],
     telemetry_tracking: ["telemetry-tracking", "telemetry_tracking"],
+    agent_identity_vocabulary: [
+        "agent-identity-vocabulary",
+        "agent_identity_vocabulary",
+    ],
     context: ["context"],
 };
 // Canonical kebab-case forms (first alias entry per key). Used for the invalid-key
@@ -130,7 +139,9 @@ const CONFIG_KEY_SUMMARIES = {
     governance_metadata_validation_profile: "Governance metadata validation profile (core|strict|custom).",
     governance_force_required_for_stale_lock: "Governance stale-lock force policy (enabled|disabled).",
     test_result_tracking: "Item-level linked test result persistence policy.",
+    untrusted_linked_test_execution: "Permit an explicit per-run override for commands not trusted by this clone.",
     telemetry_tracking: "Telemetry usage reporting policy.",
+    agent_identity_vocabulary: "Versioned exact legacy-author interpretation vocabulary (summary only).",
     context: "Context command settings (depth, section toggles, limits).",
 };
 const LIFECYCLE_PATTERN_CONFIG_KEYS = [
@@ -145,6 +156,7 @@ const CRITERIA_CONFIG_KEYS = new Set([
 ]);
 const TRACKING_CONFIG_KEYS = new Set([
     "test_result_tracking",
+    "untrusted_linked_test_execution",
     "telemetry_tracking",
 ]);
 const GOVERNANCE_BOOLEAN_CONFIG_KEYS = new Set([
@@ -232,11 +244,14 @@ function normalizeHistoryMissingStreamPolicy(value) {
     throw new PmCliError("Config set history-missing-stream-policy requires --policy with one of: auto_create, strict_error", EXIT_CODE.USAGE);
 }
 function normalizeTestResultTrackingPolicy(value) {
+    return normalizeEnabledDisabledPolicy(value, "test-result-tracking");
+}
+function normalizeEnabledDisabledPolicy(value, key) {
     const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
     if (normalized === "enabled" || normalized === "disabled") {
         return normalized;
     }
-    throw new PmCliError("Config set test-result-tracking requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
+    throw new PmCliError(`Config set ${key} requires --policy with one of: enabled, disabled`, EXIT_CODE.USAGE);
 }
 function normalizeTelemetryTrackingPolicy(value) {
     const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
@@ -320,7 +335,15 @@ function normalizeGovernanceRequireCloseReasonPolicy(value) {
     }
     throw new PmCliError("Config set governance-require-close-reason requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
 }
+const ENABLED_DISABLED_CONFLICT_POLICY_KEYS = {
+    test_result_tracking: "test-result-tracking",
+    untrusted_linked_test_execution: "untrusted-linked-test-execution",
+};
 function normalizePolicyForConflict(key, value) {
+    const enabledDisabledKey = ENABLED_DISABLED_CONFLICT_POLICY_KEYS[key];
+    if (enabledDisabledKey) {
+        return normalizeEnabledDisabledPolicy(value, enabledDisabledKey);
+    }
     switch (key) {
         case "history_missing_stream_policy":
             return normalizeHistoryMissingStreamPolicy(value);
@@ -346,8 +369,6 @@ function normalizePolicyForConflict(key, value) {
             return normalizeGovernanceWorkflowEnforcement(value);
         case "governance_force_required_for_stale_lock":
             return normalizeGovernanceForceRequiredForStaleLockPolicy(value);
-        case "test_result_tracking":
-            return normalizeTestResultTrackingPolicy(value);
         case "telemetry_tracking":
             return normalizeTelemetryTrackingPolicy(value);
         default:
@@ -477,7 +498,9 @@ const CONFIG_VALUE_READERS = {
     governance_metadata_validation_profile: (settings) => settings.governance.metadata_profile,
     governance_force_required_for_stale_lock: (settings) => settings.governance.force_required_for_stale_lock ? "enabled" : "disabled",
     test_result_tracking: (settings) => settings.testing.record_results_to_items ? "enabled" : "disabled",
+    untrusted_linked_test_execution: (settings) => settings.testing.allow_untrusted_linked_tests ? "enabled" : "disabled",
     telemetry_tracking: (settings) => settings.telemetry.enabled ? "enabled" : "disabled",
+    agent_identity_vocabulary: (settings) => summarizeAgentIdentityVocabulary(settings.agent_identity?.identity_vocabulary),
     context: (settings) => ({
         default_depth: settings.context.default_depth,
         activity_limit: settings.context.activity_limit,
@@ -642,7 +665,7 @@ function buildConfigListResult(context) {
     const keys = Object.keys(CONFIG_KEY_ALIASES).map((candidate) => ({
         key: candidate,
         aliases: CONFIG_KEY_ALIASES[candidate],
-        value_kind: candidate === "context"
+        value_kind: candidate === "context" || candidate === "agent_identity_vocabulary"
             ? "object"
             : isCriteriaConfigKey(candidate)
                 ? "string_array"
@@ -654,11 +677,13 @@ function buildConfigListResult(context) {
                 "--stale-threshold-days",
                 "--section-<name>",
             ]
-            : isCriteriaConfigKey(candidate)
-                ? ["--criterion", "--clear-criteria"]
-                : candidate === "item_format"
-                    ? ["--format"]
-                    : ["--policy"],
+            : candidate === "agent_identity_vocabulary"
+                ? ["--policy", "--value", "--criterion"]
+                : isCriteriaConfigKey(candidate)
+                    ? ["--criterion", "--clear-criteria"]
+                    : candidate === "item_format"
+                        ? ["--format"]
+                        : ["--policy"],
         summary: CONFIG_KEY_SUMMARIES[candidate],
         value: readConfigValue(context.settings, candidate),
     }));
@@ -669,9 +694,7 @@ function buildConfigListResult(context) {
         kind: descriptor.kind,
         value: readNestedSettingValue(context.settings, descriptor),
         summary: descriptor.summary,
-        ...(descriptor.choices
-            ? { choices: [...descriptor.choices] }
-            : {}),
+        ...(descriptor.choices ? { choices: [...descriptor.choices] } : {}),
         ...(descriptor.min === undefined ? {} : { min: descriptor.min }),
         ...(descriptor.max === undefined ? {} : { max: descriptor.max }),
     }));
@@ -714,6 +737,12 @@ function buildConfigGetResult(context, key) {
     if (key === "context") {
         return withWarnings({ ...base, context_settings: value }, context.warnings);
     }
+    if (key === "agent_identity_vocabulary") {
+        return withWarnings({
+            ...base,
+            identity_vocabulary: value,
+        }, context.warnings);
+    }
     if (Array.isArray(value)) {
         return withWarnings({ ...base, criteria: value }, context.warnings);
     }
@@ -987,6 +1016,16 @@ async function setTrackingConfig(context, key, options) {
         await writeConfigSettingsIfChanged(context, changed, "config:set:test_result_tracking");
         return buildPolicyResult(context, key, context.settings.testing.record_results_to_items ? "enabled" : "disabled", changed);
     }
+    if (key === "untrusted_linked_test_execution") {
+        const nextPolicy = normalizeEnabledDisabledPolicy(options.policy, "untrusted-linked-test-execution");
+        const nextEnabled = nextPolicy === "enabled";
+        const changed = context.settings.testing.allow_untrusted_linked_tests !== nextEnabled;
+        context.settings.testing.allow_untrusted_linked_tests = nextEnabled;
+        await writeConfigSettingsIfChanged(context, changed, "config:set:untrusted_linked_test_execution");
+        return buildPolicyResult(context, key, context.settings.testing.allow_untrusted_linked_tests
+            ? "enabled"
+            : "disabled", changed);
+    }
     const nextPolicy = normalizeTelemetryTrackingPolicy(options.policy);
     const nextEnabled = nextPolicy === "enabled";
     const changed = context.settings.telemetry.enabled !== nextEnabled ||
@@ -1005,6 +1044,69 @@ async function setDefinitionOfDoneConfig(context, key, options) {
     await writeConfigSettingsIfChanged(context, changed, "config:set:definition_of_done");
     return buildCriteriaResult(context, key, [...context.settings.workflow.definition_of_done], changed);
 }
+function parseAgentIdentityVocabularyOperation(raw) {
+    const policy = raw?.trim().toLowerCase().replaceAll("_", "-");
+    const dryRun = policy?.startsWith("preview-") === true;
+    const operation = dryRun ? policy.slice("preview-".length) : policy;
+    if (operation === "add" || operation === "remove" || operation === "clear") {
+        return { operation, dryRun };
+    }
+    throw new PmCliError("Config set agent-identity-vocabulary requires --policy add|remove|clear|preview-add|preview-remove|preview-clear", EXIT_CODE.USAGE);
+}
+function parseAgentIdentityVocabularyMutationValue(operation, value) {
+    if (operation === "add") {
+        const separator = value?.lastIndexOf("=") ?? -1;
+        if (separator <= 0 || separator === value.length - 1) {
+            throw new PmCliError('Config set agent-identity-vocabulary --policy add requires --value "<legacy-author>=<canonical-harness>"', EXIT_CODE.USAGE);
+        }
+        return {
+            legacy_author: value.slice(0, separator),
+            canonical_harness: value.slice(separator + 1),
+        };
+    }
+    if (operation === "remove") {
+        if (value === undefined) {
+            throw new PmCliError("Config set agent-identity-vocabulary --policy remove requires --value <legacy-author>", EXIT_CODE.USAGE);
+        }
+        return { legacy_author: value };
+    }
+    if (value !== undefined) {
+        throw new PmCliError("Config set agent-identity-vocabulary --policy clear does not accept --value", EXIT_CODE.USAGE);
+    }
+    return {};
+}
+async function setAgentIdentityVocabularyConfig(context, options) {
+    const { operation, dryRun } = parseAgentIdentityVocabularyOperation(options.policy);
+    const mutationValue = parseAgentIdentityVocabularyMutationValue(operation, options.value);
+    let planned;
+    try {
+        planned = planAgentIdentityVocabularyMutation(context.settings.agent_identity?.identity_vocabulary, {
+            operation,
+            ...mutationValue,
+            observed_authors: options.criterion,
+        });
+    }
+    catch (error) {
+        throw new PmCliError(error.message, EXIT_CODE.USAGE);
+    }
+    if (planned.preview.changed && !dryRun) {
+        context.settings.agent_identity = {
+            ...context.settings.agent_identity,
+            identity_vocabulary: planned.vocabulary,
+        };
+        await writeConfigSettingsIfChanged(context, true, `config:set:agent_identity.identity_vocabulary:${operation}:v${planned.preview.version_after}`);
+    }
+    return withWarnings({
+        scope: context.scope,
+        key: "agent_identity_vocabulary",
+        identity_vocabulary: summarizeAgentIdentityVocabulary(dryRun
+            ? context.settings.agent_identity?.identity_vocabulary
+            : planned.vocabulary),
+        vocabulary_mutation: planned.preview,
+        settings_path: context.target.settingsPath,
+        changed: planned.preview.changed && !dryRun,
+    }, context.warnings);
+}
 async function setConfigValue(context, key, options) {
     if (options.clearCriteria === true && !isCriteriaConfigKey(key)) {
         throw new PmCliError("--clear-criteria is only supported with config set criteria-list keys", EXIT_CODE.USAGE);
@@ -1015,6 +1117,9 @@ async function setConfigValue(context, key, options) {
     if (key === "context") {
         return applyContextConfig(context.settings, options, context.target, context.scope, context.warnings);
     }
+    if (key === "agent_identity_vocabulary") {
+        return setAgentIdentityVocabularyConfig(context, options);
+    }
     if (key === "definition_of_done") {
         return setDefinitionOfDoneConfig(context, key, options);
     }
@@ -1097,4 +1202,4 @@ export const _testOnlyConfigCommand = {
     normalizeWarnings,
 };
 //# sourceMappingURL=config.js.map
-//# debugId=5918331a-46e9-5699-b85d-89f49a27d341
+//# debugId=2f750f85-6c55-5f0f-b5c0-396764839d2a

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

@@ -5,7 +5,7 @@
  * workspace configuration, and packages.
  */
 
-!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]="86db3dad-99b9-5c48-be52-990f110ac81f")}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]="da15ca02-02cc-5886-8c82-610939b8581c")}catch(e){}}();
 import { AsyncLocalStorage } from "node:async_hooks";
 import { renderPmCommand } from "./command-line.js";
 import { attachOutputOmissionReceipt } from "./output-projection.js";
@@ -202,6 +202,8 @@ export function resolveContextIntentContract(command, intent, contracts = getAct
         code: "unknown_context_intent",
         reason: "unknown_intent",
         field: "for",
+        flag: "--for",
+        value: normalizedIntent,
         required: `Use a declared ${normalizedCommand} intent.`,
         why: "Intent names are command-local contracts and cannot be inferred from output section names.",
         nextSteps: [suggestedCommand],
@@ -701,4 +703,4 @@ export function attachReadOutputContracts(command, options, result) {
     return stabilizeSuppressedRowContractReceipts(Object.fromEntries(Object.entries(projected).filter(([key]) => key !== "row_contract")), options);
 }
 //# sourceMappingURL=context-intent-contracts.js.map
-//# debugId=86db3dad-99b9-5c48-be52-990f110ac81f
+//# debugId=da15ca02-02cc-5886-8c82-610939b8581c

package/dist/sdk/core-governance.d.ts

@@ -4,7 +4,7 @@
  * Defines the shared agent-provenance and CLI-completeness governance surface
  * exposed by both the focused core entrypoint and the complete SDK barrel.
  */
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, readAuthorEnvironment, registerHarnessSignalDescriptors, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, type AgentClientInfo, type AgentModelSource, type AgentProvenance, type AgentProvenanceAbsenceReason, type AgentProvenanceObservation, type AgentProvenanceOutcome, type AuthorSource, type DetectedAgentIdentity, type DiagnosedAgentIdentity, type HarnessDetectionSignals, type HarnessSignalDescriptor, type ResolvedAuthorIdentity, } from "../core/shared/author.js";
+export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_AGENT_PROVENANCE_ADAPTERS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, listAgentProvenanceAdapters, normalizeAgentProvenanceAdapterValue, readAuthorEnvironment, registerHarnessSignalDescriptors, registerAgentProvenanceAdapters, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, type AgentClientInfo, type AgentProvenanceAdapter, type AgentModelSource, type AgentProvenance, type AgentProvenanceAbsenceReason, type AgentProvenanceObservation, type AgentProvenanceOutcome, type NormalizedAgentProvenanceAdapterValue, type AuthorSource, type DetectedAgentIdentity, type DiagnosedAgentIdentity, type HarnessDetectionSignals, type HarnessSignalDescriptor, type ResolvedAuthorIdentity, } from "../core/shared/author.js";
 export { SEMANTIC_ATTRIBUTION_LIMITS, recordClaimSemanticAttribution, recordFocusSemanticAttribution, recordReleaseSemanticAttribution, resolveSemanticLineageIds, semanticAttributionAffinity, } from "./context/semantic-session-attribution.js";
 export { explainSourceTraceability, parseSourceLineRange, type SourceDecisionPath, type SourceLineRange, type SourceTraceabilityEvidence, type SourceTraceabilityExplanation, type SourceTraceabilityRationale, type SourceTraceabilityReceipt, } from "./traceability/source-traceability.js";
 export { analyzeAgentProvenanceDescriptorCoverage, evaluateSemanticAttributionCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, type AgentEpisodeGroup, type AgentModelProvenanceCoverage, type AgentProvenanceDimensionCoverage, type AgentProvenanceDescriptorCoverage, type AgentSemanticAttributionCoverage, type AgentSemanticAttributionCoverageGate, } from "./provenance.js";

package/dist/sdk/core-governance.js

@@ -5,11 +5,11 @@
  * exposed by both the focused core entrypoint and the complete SDK barrel.
  */
 
-!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]="d19cfa31-a02f-53a7-8685-5d169d6e051d")}catch(e){}}();
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, readAuthorEnvironment, registerHarnessSignalDescriptors, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
+!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]="cea03617-5e90-5683-a9d1-289087ed4646")}catch(e){}}();
+export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_AGENT_PROVENANCE_ADAPTERS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, listAgentProvenanceAdapters, normalizeAgentProvenanceAdapterValue, readAuthorEnvironment, registerHarnessSignalDescriptors, registerAgentProvenanceAdapters, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
 export { SEMANTIC_ATTRIBUTION_LIMITS, recordClaimSemanticAttribution, recordFocusSemanticAttribution, recordReleaseSemanticAttribution, resolveSemanticLineageIds, semanticAttributionAffinity, } from "./context/semantic-session-attribution.js";
 export { explainSourceTraceability, parseSourceLineRange, } from "./traceability/source-traceability.js";
 export { analyzeAgentProvenanceDescriptorCoverage, evaluateSemanticAttributionCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, } from "./provenance.js";
 export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts.js";
 //# sourceMappingURL=core-governance.js.map
-//# debugId=d19cfa31-a02f-53a7-8685-5d169d6e051d
+//# debugId=cea03617-5e90-5683-a9d1-289087ed4646

package/dist/sdk/extension/scaffold.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Scaffold.
  */
 
-!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]="30dfc6e4-27c5-56c0-981b-94e85b780f1f")}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]="5321d574-4de4-5f94-99db-0c49639673fc")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathExists } from "../../core/fs/fs-utils.js";
@@ -1483,6 +1483,12 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
                     "",
                     "  // The starter provider reads only document title/id, so `settings` is a minimal",
                     "  // typed stub and `documents` carry just the fields it inspects.",
+                    "  const settings = {",
+                    "    testing: {",
+                    "      record_results_to_items: false,",
+                    "      allow_untrusted_linked_tests: false,",
+                    "    },",
+                    "  } as PmSettings;",
                     "  const query = await ext.runSearchProvider({",
                     `    provider: ${JSON.stringify(searchProviderName)},`,
                     '    operation: "query",',
@@ -1491,7 +1497,7 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
                     '      mode: "semantic",',
                     '      tokens: ["sync"],',
                     "      options: {},",
-                    "      settings: {} as PmSettings,",
+                    "      settings,",
                     "      documents: [",
                     '        { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },',
                     '        { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },',
@@ -1503,14 +1509,14 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
                     "  const embedding = await ext.runSearchProvider({",
                     `    provider: ${JSON.stringify(searchProviderName)},`,
                     '    operation: "embed",',
-                    '    context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },',
+                    '    context: { input: "abc", settings, model: "starter-model" },',
                     "  });",
                     "  assert.deepEqual(embedding, [3]);",
                     "",
                     "  const vectorHits = await ext.runVectorStoreAdapter({",
                     `    adapter: ${JSON.stringify(vectorAdapterName)},`,
                     '    operation: "query",',
-                    "    context: { vector: [0.1, 0.2], limit: 2, settings: {} as PmSettings },",
+                    "    context: { vector: [0.1, 0.2], limit: 2, settings },",
                     "  });",
                     '  assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);',
                 ]),
@@ -2300,4 +2306,4 @@ export async function scaffoldExtensionProject(target, vocabulary = "extension",
     };
 }
 //# sourceMappingURL=scaffold.js.map
-//# debugId=30dfc6e4-27c5-56c0-981b-94e85b780f1f
+//# debugId=5321d574-4de4-5f94-99db-0c49639673fc

package/dist/sdk/flag-invocation-contracts.d.ts

@@ -24,6 +24,8 @@ export interface CliFlagInvocationContract extends CliFlagContract {
     input_sources: CliFlagInputSource[];
     /** Sentinel that redirects the argv value to stdin. */
     stdin_token?: "-";
+    /** Prefix that redirects the argv value to a file path. */
+    file_token_prefix?: "@";
 }
 /** Executable option arity observed from the registered Commander program. */
 export interface CliFlagArityObservation {

package/dist/sdk/flag-invocation-contracts.js

@@ -1,8 +1,8 @@
 
-!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]="0f857893-8441-54ad-af99-abaae9af864d")}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]="7ef5cc14-ad6b-5cce-a1a1-e5cfac85fbc2")}catch(e){}}();
 const FLAG_DESCRIPTIONS = Object.freeze({
     "--body": "Set the item body.",
-    "--body-file": "Read the item body from a file.",
+    "--body-file": "Read the item body from a file, or from stdin when set to -.",
     "--description": "Set the item description.",
     "--stdin": "Read the value from stdin.",
     "--stdin-json": "Read a complete JSON document from stdin.",
@@ -12,13 +12,16 @@ const STDIN_TOKEN_FLAGS = new Set([
     "--body",
     "--comment",
     "--dep",
+    "--dep-remove",
     "--description",
     "--doc",
+    "--event",
     "--field",
     "--file",
     "--learning",
     "--note",
     "--remove",
+    "--reminder",
     "--test",
     "--type-option",
 ]);
@@ -32,6 +35,22 @@ const STDIN_VALUE_COMMANDS = new Set([
     "notes",
     "test",
     "update",
+    "update-many",
+]);
+const FILE_OR_STDIN_COMMAND_FLAGS = new Set([
+    "close-many:--ids",
+    "comments:--file",
+    "create:--body-file",
+    "history-compact:--ids",
+    "learnings:--file",
+    "notes:--file",
+    "update:--body-file",
+    "update-many:--ids",
+]);
+const AT_PATH_FILE_COMMAND_FLAGS = new Set([
+    "close-many:--ids",
+    "history-compact:--ids",
+    "update-many:--ids",
 ]);
 const BOOLEAN_FLAG_PREFIXES = [
     "--allow-",
@@ -68,6 +87,7 @@ const BOOLEAN_FLAG_NAMES = new Set([
     "--all-affected-ids",
     "--all-day",
     "--all-streams",
+    "--acknowledge-linked-tests",
     "--append-stable",
     "--auto-fix",
     "--auto-pm-context",
@@ -133,6 +153,7 @@ const BOOLEAN_FLAG_NAMES = new Set([
     "--only-last",
     "--output-row-contract",
     "--override-linked-pm-context",
+    "--override-linked-workspace-context",
     "--packages-only",
     "--past",
     "--phrase-exact",
@@ -191,6 +212,9 @@ const OPTIONAL_VALUE_FLAGS = new Set(["--regression"]);
 function resolveFlagInputSources(command, flag) {
     if (flag === "--stdin" || flag === "--stdin-json")
         return ["stdin"];
+    if (FILE_OR_STDIN_COMMAND_FLAGS.has(`${command}:${flag}`)) {
+        return ["argv", "file", "stdin"];
+    }
     if (flag.endsWith("-file"))
         return ["argv", "file"];
     if (STDIN_TOKEN_FLAGS.has(flag) && STDIN_VALUE_COMMANDS.has(command)) {
@@ -241,6 +265,9 @@ export function enrichCliFlagInvocationContract(command, contract) {
             contract.flag !== "--stdin-json"
             ? { stdin_token: "-" }
             : {}),
+        ...(AT_PATH_FILE_COMMAND_FLAGS.has(`${command}:${contract.flag}`)
+            ? { file_token_prefix: "@" }
+            : {}),
     };
 }
 /** Enrich a complete command flag table without mutating package-owned rows. */
@@ -315,4 +342,4 @@ export function verifyCliFlagInvocationParity(command, declarations, observation
     };
 }
 //# sourceMappingURL=flag-invocation-contracts.js.map
-//# debugId=0f857893-8441-54ad-af99-abaae9af864d
+//# debugId=7ef5cc14-ad6b-5cce-a1a1-e5cfac85fbc2

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]="2903ebb9-541a-5636-ae3c-e996d3f0cec4")}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]="030027d7-2703-56ea-9235-64bc602a25c3")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -218,6 +218,51 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "budget_exceeded",
         aliases: [],
     },
+    {
+        code: "bulk_ids_input_empty",
+        meaning: "Bulk ids input empty condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/bulk-ids-input.ts", "sdk/history-compact.ts", "sdk/history-mcp.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bulk_ids_input_empty",
+        aliases: [],
+        owned_states: [
+            { state: "bulk_ids_stdin_contains_no_nonempty_ids", probe_id: "bulk-ids-stdin-empty", entrypoints: ["update-many"], expected_exit_class: "usage" },
+        ],
+    },
+    {
+        code: "bulk_ids_input_missing_path",
+        meaning: "Bulk ids input missing path condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/bulk-ids-input.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bulk_ids_input_missing_path",
+        aliases: [],
+        owned_states: [
+            { state: "bulk_ids_file_token_omits_its_path", probe_id: "bulk-ids-file-path-missing", entrypoints: ["update-many"], expected_exit_class: "usage" },
+        ],
+    },
+    {
+        code: "bulk_ids_input_unreadable",
+        meaning: "Bulk ids input unreadable condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/bulk-ids-input.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bulk_ids_input_unreadable",
+        aliases: [],
+        owned_states: [
+            { state: "bulk_ids_file_path_cannot_be_read", probe_id: "bulk-ids-file-unreadable", entrypoints: ["update-many"], expected_exit_class: "not_found" },
+        ],
+    },
     {
         code: "bundle_integrity_torn_install",
         meaning: "Bundle integrity torn install condition.",
@@ -1656,6 +1701,18 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "invalid_read_output_session",
         aliases: [],
     },
+    {
+        code: "invalid_reproducible_process_environment",
+        meaning: "Invalid reproducible process environment condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/reproducibility/process.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_reproducible_process_environment",
+        aliases: [],
+    },
     {
         code: "invalid_workspace_snapshot_target",
         meaning: "Invalid workspace snapshot target condition.",
@@ -1884,6 +1941,30 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "manifest_unknown_key",
         aliases: [],
     },
+    {
+        code: "mcp_annotation_file_unavailable",
+        meaning: "Mcp annotation file unavailable condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/runtime-input.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "mcp_annotation_file_unavailable",
+        aliases: [],
+    },
+    {
+        code: "mcp_stdin_unavailable",
+        meaning: "Mcp stdin unavailable condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/annotations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "mcp_stdin_unavailable",
+        aliases: [],
+    },
     {
         code: "merge_conflict_markers_detected",
         meaning: "Merge conflict markers detected condition.",
@@ -1970,4 +2051,4 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=2903ebb9-541a-5636-ae3c-e996d3f0cec4
+//# debugId=030027d7-2703-56ea-9235-64bc602a25c3