@unbrained/pm-cli 2026.8.20 → 2026.8.22

package/dist/sdk/cli-contracts/agent-output-contracts.js

@@ -6,7 +6,7 @@
  * output policy without coupling package authors to pm's renderer.
  */
 
-!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]="23b3a820-f205-506b-9507-dbd60087f62e")}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]="b3f5a4bc-d853-530e-8f5e-d682d8b93c9d")}catch(e){}}();
 import { PM_CORE_COMMAND_NAMES } from "./enum-contracts.js";
 /** Stable degradation stages applied when an output exceeds its token budget. */
 export const PM_OUTPUT_DEGRADATION_STEPS = [
@@ -23,6 +23,21 @@ export const PM_OUTPUT_BUDGET_CLASSES = [
     "discovery",
     "governance",
 ];
+/** Stable diagnostic families that require independent output ceilings. */
+export const PM_DIAGNOSTIC_OUTPUT_CLASSES = [
+    "error",
+    "warning",
+    "validation_summary",
+    "recovery_bundle",
+];
+/** Deterministic diagnostic degradation stages, from richest to smallest. */
+export const PM_DIAGNOSTIC_DEGRADATION_STEPS = [
+    "full",
+    "omit_explanation",
+    "limit_collections",
+    "compact_recovery",
+    "action_only",
+];
 const MUTATION_COMMANDS = new Set([
     "append",
     "claim",
@@ -84,6 +99,29 @@ const DEFAULT_MAX_ESTIMATED_TOKENS = {
 };
 const JSON_BUDGET_NUMERATOR = 3;
 const JSON_BUDGET_DENOMINATOR = 2;
+const MINIMUM_DIAGNOSTIC_BUDGET = 192;
+const DIAGNOSTIC_DEFAULT_BUDGETS = {
+    error: { text: 768, json: 2_000 },
+    warning: { text: 768, json: 2_000 },
+    validation_summary: { text: 1_500, json: 3_000 },
+    recovery_bundle: { text: 768, json: 2_000 },
+};
+/** Public default contract for every diagnostic family. */
+export const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS = PM_DIAGNOSTIC_OUTPUT_CLASSES.map((diagnosticClass) => ({
+    diagnostic_class: diagnosticClass,
+    default_max_estimated_tokens_by_format: DIAGNOSTIC_DEFAULT_BUDGETS[diagnosticClass],
+    minimum_max_estimated_tokens: MINIMUM_DIAGNOSTIC_BUDGET,
+    degradation_ladder: PM_DIAGNOSTIC_DEGRADATION_STEPS,
+    corrective_action_paths: [
+        "required",
+        "recovery.suggested_retry",
+        "recovery.suggested_retry_args",
+        "recovery.next_best_command",
+        "next_steps[0]",
+    ],
+    token_estimate: "ceil(utf8_bytes / 4)",
+}));
+const DIAGNOSTIC_BUDGET_BY_CLASS = new Map(PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS.map((contract) => [contract.diagnostic_class, contract]));
 /** Infer the conservative workload class for a core or package command. */
 export function inferPmOutputBudgetClass(command) {
     const [rootCommand = ""] = command.trim().split(/\s+/u);
@@ -150,5 +188,289 @@ export function resolvePmCommandOutputBudget(command, options = {}) {
 export function estimatePmOutputTokens(utf8Bytes) {
     return Math.ceil(Math.max(0, utf8Bytes) / 4);
 }
+/** Resolve the binding output contract for one diagnostic family. */
+export function resolvePmDiagnosticOutputBudget(diagnosticClass) {
+    const contract = DIAGNOSTIC_BUDGET_BY_CLASS.get(diagnosticClass);
+    if (contract === undefined) {
+        throw new TypeError(`diagnosticClass must be one of: ${PM_DIAGNOSTIC_OUTPUT_CLASSES.join(", ")}`);
+    }
+    return contract;
+}
+function estimateJsonDiagnosticTokens(value) {
+    return estimatePmOutputTokens(Buffer.byteLength(JSON.stringify(value, null, 2), "utf8"));
+}
+function isDiagnosticRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function compactDiagnosticRecovery(value) {
+    if (!isDiagnosticRecord(value))
+        return undefined;
+    const compact = {};
+    for (const key of [
+        "suggested_retry",
+        "suggested_retry_args",
+        "next_best_command",
+        "allowed_values",
+        "candidate_commands",
+        "missing",
+        "missing_required_fields",
+        "option_scope",
+        "retry_after_ms",
+    ]) {
+        const candidate = value[key];
+        if (Array.isArray(candidate))
+            compact[key] = candidate.slice(0, 3);
+        else if (candidate !== undefined)
+            compact[key] = candidate;
+    }
+    return Object.keys(compact).length > 0 ? compact : undefined;
+}
+function truncateDiagnosticString(value, maximum) {
+    if (typeof value !== "string" || value.length <= maximum)
+        return value;
+    return `${value.slice(0, Math.max(1, maximum - 3))}...`;
+}
+function truncateDiagnosticUtf8Text(value, maximumBytes) {
+    if (Buffer.byteLength(value, "utf8") <= maximumBytes)
+        return value;
+    const suffix = "...";
+    const codePoints = Array.from(value);
+    let lower = 0;
+    let upper = codePoints.length;
+    while (lower < upper) {
+        const middle = Math.ceil((lower + upper) / 2);
+        const candidate = `${codePoints.slice(0, middle).join("")}${suffix}`;
+        if (Buffer.byteLength(candidate, "utf8") <= maximumBytes)
+            lower = middle;
+        else
+            upper = middle - 1;
+    }
+    return `${codePoints.slice(0, lower).join("")}${suffix}`;
+}
+function prioritizeDiagnosticFields(diagnostic) {
+    const prioritized = {};
+    for (const key of [
+        "code",
+        "required",
+        "recovery",
+        "next_steps",
+        "exit_code",
+        "type",
+        "title",
+        "detail",
+        "why",
+        "examples",
+    ]) {
+        if (Object.hasOwn(diagnostic, key) && diagnostic[key] !== undefined) {
+            prioritized[key] = diagnostic[key];
+        }
+    }
+    for (const [key, value] of Object.entries(diagnostic)) {
+        if (key !== "__proto__" && !Object.hasOwn(prioritized, key)) {
+            prioritized[key] = value;
+        }
+    }
+    return prioritized;
+}
+const DIAGNOSTIC_COLLECTION_LIMIT_STAGES = new Set(["limit_collections", "compact_recovery", "action_only"]);
+const DIAGNOSTIC_RECOVERY_COMPACTION_STAGES = new Set(["compact_recovery", "action_only"]);
+function actionOnlyDiagnostic(candidate) {
+    const actionOnly = {
+        code: typeof candidate.code === "string" ? candidate.code : "diagnostic",
+        required: truncateDiagnosticString(candidate.required, 160) ??
+            "Inspect the diagnostic code and retry with corrected input.",
+    };
+    const recovery = compactDiagnosticRecovery(candidate.recovery);
+    if (recovery !== undefined) {
+        actionOnly.recovery = recovery;
+    }
+    else if (Array.isArray(candidate.next_steps)) {
+        actionOnly.next_steps = candidate.next_steps.slice(0, 1);
+    }
+    if (candidate.exit_code !== undefined)
+        actionOnly.exit_code = candidate.exit_code;
+    if (candidate.type !== undefined)
+        actionOnly.type = candidate.type;
+    return actionOnly;
+}
+function diagnosticCandidate(diagnostic, stage) {
+    const candidate = structuredClone(diagnostic);
+    if (stage !== "full") {
+        delete candidate.why;
+        delete candidate.examples;
+    }
+    if (DIAGNOSTIC_COLLECTION_LIMIT_STAGES.has(stage)) {
+        for (const [key, value] of Object.entries(candidate)) {
+            if (Array.isArray(value))
+                candidate[key] = value.slice(0, 3);
+        }
+    }
+    if (DIAGNOSTIC_RECOVERY_COMPACTION_STAGES.has(stage)) {
+        const recovery = compactDiagnosticRecovery(candidate.recovery);
+        if (recovery)
+            candidate.recovery = recovery;
+        else
+            delete candidate.recovery;
+    }
+    if (stage !== "action_only")
+        return prioritizeDiagnosticFields(candidate);
+    return actionOnlyDiagnostic(candidate);
+}
+function attachDiagnosticReceipt(candidate, receipt) {
+    const projected = {
+        ...candidate,
+        diagnostic_output: { ...receipt, estimated_tokens: 0 },
+    };
+    for (let attempt = 0; attempt < 4; attempt += 1) {
+        const estimatedTokens = estimateJsonDiagnosticTokens(projected);
+        const outputReceipt = projected.diagnostic_output;
+        if (outputReceipt.estimated_tokens === estimatedTokens)
+            break;
+        outputReceipt.estimated_tokens = estimatedTokens;
+    }
+    return projected;
+}
+function shrinkMinimalDiagnosticCandidate(candidate, receipt, budget) {
+    let fallback = attachDiagnosticReceipt(candidate, receipt);
+    for (const optionalField of ["recovery", "exit_code"]) {
+        if (estimateJsonDiagnosticTokens(fallback) <= budget ||
+            candidate[optionalField] === undefined) {
+            continue;
+        }
+        delete candidate[optionalField];
+        fallback = attachDiagnosticReceipt(candidate, receipt);
+    }
+    let maximumActionBytes = 40;
+    while (estimateJsonDiagnosticTokens(fallback) > budget &&
+        maximumActionBytes > 4) {
+        maximumActionBytes -= 4;
+        candidate.code = truncateDiagnosticUtf8Text(String(candidate.code), maximumActionBytes);
+        candidate.required = truncateDiagnosticUtf8Text(String(candidate.required), maximumActionBytes);
+        fallback = attachDiagnosticReceipt(candidate, receipt);
+    }
+    return fallback;
+}
+function createMinimalDiagnosticFallback(projected, budget) {
+    const receipt = projected.diagnostic_output;
+    const { estimated_tokens: _estimatedTokens, ...receiptWithoutEstimate } = receipt;
+    const boundedOmittedFields = receiptWithoutEstimate.omitted_fields
+        .slice(0, 8)
+        .map((field) => truncateDiagnosticUtf8Text(field, 32));
+    const boundedReceipt = {
+        ...receiptWithoutEstimate,
+        omitted_fields: boundedOmittedFields,
+        ...(receiptWithoutEstimate.omitted_fields.length >
+            boundedOmittedFields.length
+            ? {
+                omitted_fields_overflow_count: receiptWithoutEstimate.omitted_fields.length -
+                    boundedOmittedFields.length,
+            }
+            : {}),
+    };
+    const recoveryCandidate = compactDiagnosticRecovery(projected.recovery);
+    const recovery = recoveryCandidate && estimateJsonDiagnosticTokens(recoveryCandidate) <= 48
+        ? recoveryCandidate
+        : undefined;
+    const candidate = {
+        code: truncateDiagnosticUtf8Text(String(projected.code), 320),
+        required: truncateDiagnosticUtf8Text(String(projected.required), 320),
+        ...(recovery ? { recovery } : {}),
+        ...(projected.exit_code !== undefined
+            ? { exit_code: projected.exit_code }
+            : {}),
+    };
+    let fallback = attachDiagnosticReceipt(candidate, boundedReceipt);
+    while (estimateJsonDiagnosticTokens(fallback) > budget &&
+        boundedReceipt.omitted_fields.length > 0) {
+        boundedReceipt.omitted_fields.pop();
+        boundedReceipt.omitted_fields_overflow_count =
+            receiptWithoutEstimate.omitted_fields.length -
+                boundedReceipt.omitted_fields.length;
+        fallback = attachDiagnosticReceipt(candidate, boundedReceipt);
+    }
+    fallback = shrinkMinimalDiagnosticCandidate(candidate, boundedReceipt, budget);
+    return fallback;
+}
+/**
+ * Bind a JSON diagnostic to its declared ceiling while preserving the first
+ * corrective action and reporting every top-level omission.
+ */
+export function projectPmDiagnosticOutput(diagnostic, options = {}) {
+    const diagnosticRecord = diagnostic;
+    const diagnosticClass = options.diagnosticClass ?? "error";
+    const contract = resolvePmDiagnosticOutputBudget(diagnosticClass);
+    const explicitBudget = options.maxEstimatedTokens;
+    if (explicitBudget !== undefined &&
+        (!Number.isSafeInteger(explicitBudget) ||
+            explicitBudget < contract.minimum_max_estimated_tokens)) {
+        throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);
+    }
+    const budget = explicitBudget ?? contract.default_max_estimated_tokens_by_format.json;
+    const originalEstimatedTokens = estimateJsonDiagnosticTokens(diagnosticRecord);
+    const originalFields = Object.keys(diagnosticRecord);
+    if (originalEstimatedTokens <= budget) {
+        return prioritizeDiagnosticFields(structuredClone(diagnosticRecord));
+    }
+    let projected;
+    for (const [index, stage] of contract.degradation_ladder.entries()) {
+        const candidate = diagnosticCandidate(diagnosticRecord, stage);
+        const omittedFields = originalFields.filter((field) => !Object.hasOwn(candidate, field));
+        const withReceipt = attachDiagnosticReceipt(candidate, {
+            diagnostic_class: diagnosticClass,
+            format: "json",
+            budget,
+            budget_source: explicitBudget === undefined ? "default" : "explicit",
+            original_estimated_tokens: originalEstimatedTokens,
+            truncated: index > 0,
+            degradation_steps: contract.degradation_ladder.slice(0, index + 1),
+            omitted_fields: omittedFields,
+        });
+        projected = withReceipt;
+        if (estimateJsonDiagnosticTokens(withReceipt) <= budget)
+            break;
+    }
+    if (estimateJsonDiagnosticTokens(projected) > budget) {
+        projected = createMinimalDiagnosticFallback(projected, budget);
+    }
+    return projected;
+}
+/** Bind human-readable diagnostics without ever truncating the corrective action away. */
+export function projectPmDiagnosticText(output, correctiveAction, options = {}) {
+    const diagnosticClass = options.diagnosticClass ?? "error";
+    const contract = resolvePmDiagnosticOutputBudget(diagnosticClass);
+    const explicitBudget = options.maxEstimatedTokens;
+    if (explicitBudget !== undefined &&
+        (!Number.isSafeInteger(explicitBudget) ||
+            explicitBudget < contract.minimum_max_estimated_tokens)) {
+        throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);
+    }
+    const budget = explicitBudget ?? contract.default_max_estimated_tokens_by_format.text;
+    const originalEstimatedTokens = estimatePmOutputTokens(Buffer.byteLength(output, "utf8"));
+    const truncated = originalEstimatedTokens > budget;
+    const actionPrefix = "What is required:\n  ";
+    const actionSuffix = `\n\nDiagnostic output exceeded its declared ${budget}-token ceiling; rerun with structured JSON for the bounded recovery envelope.`;
+    const correctiveActionText = correctiveAction.trim() ||
+        "Inspect the diagnostic code and retry with corrected input.";
+    const availableActionBytes = Math.max(1, budget * 4 - Buffer.byteLength(`${actionPrefix}${actionSuffix}`, "utf8"));
+    const projectedOutput = truncated
+        ? `${actionPrefix}${truncateDiagnosticUtf8Text(correctiveActionText, availableActionBytes)}${actionSuffix}`
+        : output;
+    return {
+        output: projectedOutput,
+        diagnostic_output: {
+            diagnostic_class: diagnosticClass,
+            format: "text",
+            budget,
+            budget_source: explicitBudget === undefined ? "default" : "explicit",
+            original_estimated_tokens: originalEstimatedTokens,
+            estimated_tokens: estimatePmOutputTokens(Buffer.byteLength(projectedOutput, "utf8")),
+            truncated,
+            degradation_steps: truncated
+                ? [...contract.degradation_ladder]
+                : ["full"],
+            omitted_fields: truncated ? ["explanation", "collections"] : [],
+        },
+    };
+}
 //# sourceMappingURL=agent-output-contracts.js.map
-//# debugId=23b3a820-f205-506b-9507-dbd60087f62e
+//# debugId=b3f5a4bc-d853-530e-8f5e-d682d8b93c9d

package/dist/sdk/cli-contracts/commander-mutation-options.js

@@ -1,6 +1,6 @@
 /** Creates commander option registration contracts using the validated operation inputs. */
 
-!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]="93ce68bd-3140-5361-a6d0-bc60c7304a29")}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]="be7e506f-c48f-5dfb-9fed-ba1e74fa60ff")}catch(e){}}();
 export const CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     {
         target: "title",
@@ -969,7 +969,7 @@ export const UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
         target: "depRemove",
         keys: ["depRemove", "dep_remove"],
         option: "--dep-remove <value>",
-        description: "Remove dependencies by id or id=<id>,kind=<value>,source_kind=<value> selectors (repeatable)",
+        description: "Remove by dependency id or exact row signature (repeatable)",
         repeatable: true,
         aliasOptions: [
             {
@@ -1079,4 +1079,4 @@ export const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_
 /** Public contract for update commander repeatable option contracts, shared by SDK and presentation-layer consumers. */
 export const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.filter((entry) => entry.repeatable === true).map((entry) => ({ target: entry.target, keys: entry.keys }));
 //# sourceMappingURL=commander-mutation-options.js.map
-//# debugId=93ce68bd-3140-5361-a6d0-bc60c7304a29
+//# debugId=be7e506f-c48f-5dfb-9fed-ba1e74fa60ff

package/dist/sdk/cli-contracts/runtime-contracts.d.ts

@@ -5,7 +5,7 @@
  */
 import { type GlobalOptions, type ExtensionRegistrationRegistry, type RegisteredExtensionCommandDefinition, type RegisteredExtensionFlagDefinitions, type RuntimeFieldRegistry, readSettings } from "../runtime-primitives.js";
 import { type McpToolContract } from "../../mcp/tool-definitions.js";
-import { PM_TOOL_ACTIONS, type CliFlagContract, type CommanderOptionAliasContract, type PmCommandOutputBudgetContract, type PmCommandAliasContract } from "../cli-contracts.js";
+import { PM_TOOL_ACTIONS, type CliFlagContract, type CommanderOptionAliasContract, type PmCommandOutputBudgetContract, type PmDiagnosticOutputBudgetContract, type PmCommandAliasContract } from "../cli-contracts.js";
 import { type ListCommandName, type ListProjectionMode } from "../query/list.js";
 import { type PmContextIntentContract } from "../context-intent-contracts.js";
 import { type PmReadOutputSurfaceContract } from "../read-output-contracts.js";
@@ -187,6 +187,8 @@ export interface ContractsResult {
         budget: PmCommandOutputBudgetContract;
         envelope: PmCommandOutputEnvelopeContract;
     }>;
+    /** Binding ceilings and action-preserving degradation for diagnostic families. */
+    diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[];
     /** Stable outcome vocabulary and exhaustive per-command process exit sets. */
     command_exit_contracts?: {
         vocabulary: readonly PmCommandExitOutcomeContract[];

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

@@ -4,10 +4,10 @@
  * Implements the pm contracts command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b07d8f62-6c75-52fd-9956-52cec211303c")}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]="e8f1efca-4e83-570f-8c33-96f0405035b0")}catch(e){}}();
 import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
-import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
+import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
 import { PM_POSITIONAL_ACTION_FLAG_CONTRACTS } from "./flag-contracts.js";
 import { GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES, GOVERNANCE_CREATE_MODE_DEFAULT_VALUES, GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES, GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES, } from "../../types.js";
 import { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, } from "../query/list.js";
@@ -2023,6 +2023,7 @@ export async function runContracts(options, global) {
         result.error_codes = PM_ERROR_CODE_CATALOG;
         result.command_output_contracts =
             buildCommandOutputContracts(outputCommands);
+        result.diagnostic_output_contracts = PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS;
         result.command_exit_contracts = {
             vocabulary: PM_COMMAND_EXIT_OUTCOME_CONTRACTS,
             command_sets: buildCommandExitContractGroups(outputCommands),
@@ -2064,4 +2065,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=b07d8f62-6c75-52fd-9956-52cec211303c
+//# debugId=e8f1efca-4e83-570f-8c33-96f0405035b0

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

@@ -25,4 +25,4 @@ export type { PmActionSchemaContract } from "./cli-contracts/tool-schema.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";
 export type { PmActionToolInputSchemaOptions, PmToolCustomFieldCollision, } from "./cli-contracts/tool-schema.js";
 export { analyzeSdkCliParameterCompleteness, type SdkCliActionParameterCoverage, type SdkCliCompletenessContractSource, type SdkCliParameterCoverageEntry, type SdkCliParameterDisposition, } from "./cli-contracts/completeness.js";
-export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, resolvePmCommandOutputBudget, type PmCommandOutputBudgetContract, type PmOutputBudgetClass, type PmOutputDegradationStep, } from "./cli-contracts/agent-output-contracts.js";
+export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_DEGRADATION_STEPS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_CLASSES, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, projectPmDiagnosticOutput, projectPmDiagnosticText, resolvePmDiagnosticOutputBudget, resolvePmCommandOutputBudget, type PmCommandOutputBudgetContract, type PmDiagnosticDegradationStep, type PmDiagnosticOutputBudgetContract, type PmDiagnosticOutputClass, type PmDiagnosticOutputReceipt, type PmOutputBudgetClass, type PmOutputDegradationStep, type PmProjectedDiagnostic, type PmProjectedTextDiagnostic, } from "./cli-contracts/agent-output-contracts.js";

package/dist/sdk/cli-contracts.js

@@ -1,5 +1,5 @@
 
-!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]="b6cdec8f-ca7d-58a2-9d67-cf6c1eb91324")}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]="8f665958-197a-5f20-8904-0a59a623f30f")}catch(e){}}();
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, } from "./cli-contracts/command-aliases.js";
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
@@ -13,6 +13,6 @@ export { PM_POSITIONAL_ACTION_CONTRACTS, } from "./cli-contracts/grammar-contrac
 export { withFlagAliasMetadata, compactFlagAliasContracts, resolvePmPositionalActionFlagContracts, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, toCompletionFlagString, } from "./cli-contracts/flag-contracts.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";
 export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts/completeness.js";
-export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, resolvePmCommandOutputBudget, } from "./cli-contracts/agent-output-contracts.js";
+export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_DEGRADATION_STEPS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_CLASSES, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, projectPmDiagnosticOutput, projectPmDiagnosticText, resolvePmDiagnosticOutputBudget, resolvePmCommandOutputBudget, } from "./cli-contracts/agent-output-contracts.js";
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=b6cdec8f-ca7d-58a2-9d67-cf6c1eb91324
+//# debugId=8f665958-197a-5f20-8904-0a59a623f30f

package/dist/sdk/config.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @module sdk/config
+ *
+ * Implements the pm config command surface and its agent-facing runtime behavior.
+ */
 import { type ConfigKey } from "../core/config/positional-value.js";
 import { type NestedSettingDescriptor } from "../core/config/nested-settings.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";

package/dist/sdk/config.js

@@ -4,8 +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]="a9a8d99c-df4e-55b3-81f5-27124d598c5f")}catch(e){}}();
-import { pathExists } from "../core/fs/fs-utils.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]="5918331a-46e9-5699-b85d-89f49a27d341")}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";
@@ -17,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 { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 import { getSettingsPath, resolveGlobalPmRoot, resolvePmRoot, } from "../core/store/paths.js";
 import { readSettingsWithMetadata, writeSettings, } from "../core/store/settings.js";
@@ -503,8 +503,8 @@ async function resolveSettingsTarget(scope, global) {
         ? resolvePmRoot(cwd, global.path)
         : resolveGlobalPmRoot(cwd);
     const settingsPath = getSettingsPath(pmRoot);
-    if (scope === "project" && !(await pathExists(settingsPath))) {
-        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    if (scope === "project") {
+        await assertInitializedTracker(pmRoot);
     }
     return { pmRoot, settingsPath };
 }
@@ -1097,4 +1097,4 @@ export const _testOnlyConfigCommand = {
     normalizeWarnings,
 };
 //# sourceMappingURL=config.js.map
-//# debugId=a9a8d99c-df4e-55b3-81f5-27124d598c5f
+//# debugId=5918331a-46e9-5699-b85d-89f49a27d341

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

@@ -6,10 +6,11 @@
  * SDK entrypoint.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7ba0243e-98d1-5aef-bd47-54f0b630be58")}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]="1a7548f2-93a0-5dfc-9d9a-c5aef4656c7c")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { isFileAbsentError } from "../core/fs/fs-utils.js";
+import { assertReadableTrackerRoot } from "./environment/tracker-preflight.js";
 import { runWithContextIntentContracts, } from "./context-intent-contracts.js";
 /** Conventional workspace declaration file relative to the tracker root. */
 export const PM_CONTEXT_INTENTS_FILE = "context-intents.json";
@@ -59,11 +60,13 @@ export async function readWorkspaceContextIntentContracts(pmRoot) {
     catch (error) {
         // Absent declarations are the norm. `ENOTDIR` counts as absent too: when
         // the tracker root is a regular file the declaration cannot exist, and the
-        // authoritative root guard downstream owns that refusal — this optional
-        // read must not pre-empt it with a raw runtime fault.
+        // authoritative root guard downstream owns that refusal. Other read
+        // failures first pass through the same root guard so permissions failures
+        // cannot pre-empt it with an unclassified runtime fault.
         if (isFileAbsentError(error)) {
             return [];
         }
+        await assertReadableTrackerRoot(pmRoot);
         throw error;
     }
     let parsed;
@@ -110,4 +113,4 @@ export async function runWithDiscoveredContextIntentContracts(options, run) {
     return await runWithContextIntentContracts(layers, run);
 }
 //# sourceMappingURL=context-intent-runtime.js.map
-//# debugId=7ba0243e-98d1-5aef-bd47-54f0b630be58
+//# debugId=1a7548f2-93a0-5dfc-9d9a-c5aef4656c7c

package/dist/sdk/contracts.d.ts

@@ -16,4 +16,5 @@ export * from "./output-contracts.js";
 export * from "./read-output-contracts.js";
 export * from "./agent/refusal-closure.js";
 export * from "./agent/closed-domain-contracts.js";
+export * from "./agent/tracker-preflight-contracts.js";
 export type { PmReadOutputSessionReceipt, PmReadOutputSessionState, } from "./read-output-session.js";

package/dist/sdk/contracts.js

@@ -4,7 +4,7 @@
  * Exposes command and action contract data without loading SDK runtime code.
  */
 
-!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]="8e9dc315-4c5a-5cb0-befc-e0dbbf7e8571")}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]="8bdc03e5-c5cd-5842-b438-cf7bc79863f0")}catch(e){}}();
 export * from "./cli-contracts.js";
 export * from "./cli-contracts/grammar-contracts.js";
 export * from "./cli-contracts/command-exit-contracts.js";
@@ -18,5 +18,6 @@ export * from "./output-contracts.js";
 export * from "./read-output-contracts.js";
 export * from "./agent/refusal-closure.js";
 export * from "./agent/closed-domain-contracts.js";
+export * from "./agent/tracker-preflight-contracts.js";
 //# sourceMappingURL=contracts.js.map
-//# debugId=8e9dc315-4c5a-5cb0-befc-e0dbbf7e8571
+//# debugId=8bdc03e5-c5cd-5842-b438-cf7bc79863f0

package/dist/sdk/dependencies.js

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

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

@@ -1,7 +1,7 @@
 import type { Dependency, ItemFormat, RuntimeSchemaSettings } from "../types/index.js";
 import { type RelationshipKindRegistry } from "./relationships.js";
 /** Reject malformed shorthand before item-id prefix normalization can create a dangling graph node. */
-export declare function assertValidBareDependencyFlagValue(value: string, structured: boolean): void;
+export declare function assertValidBareDependencyFlagValue(value: string, structured: boolean, flag?: string): void;
 /**
  * Validate prospective stored dependencies against the active relationship
  * ontology before a create or update mutation writes item or history state.