@unbrained/pm-cli 2026.8.13 → 2026.8.14

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

@@ -4,7 +4,7 @@
  * 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]="651d4904-cae5-503b-8418-93bc44a413ad")}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]="c0995490-5838-5c91-af77-9ce387e41a1f")}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, 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_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, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
@@ -224,19 +224,33 @@ const COMMAND_INTENTS = new Map([
     ["activity", "Read activity."],
     ["aggregate", "Group counts."],
     ["append", "Append body."],
+    ["assurance", "Evaluate assurance."],
+    ["beads", "Manage Beads interoperability."],
+    ["cal", "Manage calendar integration."],
+    ["calendar", "Manage calendar integration."],
+    ["changelog", "Generate changelog output."],
     ["claim", "Claim work."],
     ["close", "Close work."],
+    ["close-many", "Close matching work."],
+    ["close-task", "Close task work."],
+    ["command-kit", "Inspect command authoring primitives."],
     ["comments", "Manage comments."],
+    ["comments-audit", "Audit comment governance."],
     ["completion", "Generate shell completions."],
     ["config", "Manage settings."],
     ["context", "Build context."],
     ["contracts", "Inspect contracts."],
     ["copy", "Copy work."],
     ["create", "Create work."],
+    ["dedupe-audit", "Audit duplicate work."],
+    ["dedupe-merge", "Merge duplicate work."],
     ["delete", "Delete work."],
     ["deps", "Manage deps."],
     ["duplicates", "Find duplicate clusters."],
     ["docs", "Link docs."],
+    ["eval", "Run evaluations."],
+    ["event", "Manage events."],
+    ["events", "Read events."],
     ["files", "Link files."],
     ["focus", "Manage focus."],
     ["gc", "Clean caches."],
@@ -248,26 +262,53 @@ const COMMAND_INTENTS = new Map([
     ["history", "Inspect history."],
     ["init", "Initialize workspace."],
     ["install", "Install packages."],
+    ["item", "Mutate work through typed operations."],
     ["learnings", "Manage learnings."],
     ["list", "List work."],
+    ["list-all", "List work across every status."],
+    ["list-blocked", "List blocked work."],
+    ["list-canceled", "List canceled work."],
+    ["list-closed", "List closed work."],
+    ["list-draft", "List draft work."],
+    ["list-in-progress", "List in-progress work."],
+    ["list-open", "List open work."],
+    ["meet", "Record meeting context."],
+    ["merge", "Manage tracker merges."],
     ["next", "Pick next work."],
     ["notes", "Manage notes."],
+    ["normalize", "Normalize tracker data."],
     ["ops", "Run operations."],
     ["package", "Manage packages."],
+    ["packages", "Manage packages."],
+    ["pause-task", "Pause task work."],
     ["plan", "Manage plans."],
     ["profile", "Manage profiles."],
     ["reindex", "Refresh search index."],
     ["release", "Release claim."],
+    ["remind", "Manage reminders."],
     ["restore", "Restore history."],
     ["schema", "Customize schema."],
     ["search", "Search work."],
+    ["search-advanced", "Run advanced search."],
+    ["start-task", "Start task work."],
     ["stats", "Show stats."],
     ["telemetry", "Manage telemetry."],
+    ["templates", "Manage work templates."],
     ["test", "Run linked tests."],
+    ["test-all", "Run all linked tests."],
+    ["test-runs", "Inspect background test runs."],
+    ["todos", "Manage source-code todos."],
+    ["twin", "Manage repository twins."],
     ["update", "Update work."],
+    ["update-many", "Update matching work."],
     ["upgrade", "Upgrade packages."],
     ["validate", "Validate data."],
+    ["vcs", "Inspect version-control context."],
     ["workspace", "Manage portable workspace primitives."],
+    ["history-author-acknowledge", "Acknowledge reviewed history authors."],
+    ["history-compact", "Compact history."],
+    ["history-redact", "Redact sensitive history values."],
+    ["history-repair", "Repair history integrity."],
 ]);
 // Lifecycle subcommand flag contracts for `pm extension`. Only `init` differs
 // between extension and package: `pm package init` / `pm packages init`
@@ -701,29 +742,29 @@ function collectExtensionCommandContracts(runtimeProbe) {
     const contracts = [];
     for (const command of [...extensionCommands].sort((left, right) => left.localeCompare(right))) {
         const definition = definitionsByCommand.get(command);
-        if (definition) {
-            contracts.push({
-                ...definition,
-                flags: definition.flags.length > 0
-                    ? definition.flags
-                    : (flagsByCommand.get(command)?.flags ?? []),
-            });
-            continue;
-        }
-        contracts.push({
-            command,
-            action: normalizeActionNameFromCommand(command),
-            source: null,
-            description: null,
-            intent: null,
-            arguments: [],
-            flags: flagsByCommand.get(command)?.flags ?? [],
-            examples: [],
-            failure_hints: [],
-        });
+        contracts.push(buildCollectedExtensionCommandContract(command, definition, flagsByCommand.get(command)?.flags ?? []));
     }
     return contracts;
 }
+function buildCollectedExtensionCommandContract(command, definition, registeredFlags) {
+    if (definition) {
+        return {
+            ...definition,
+            flags: definition.flags.length > 0 ? definition.flags : registeredFlags,
+        };
+    }
+    return {
+        command,
+        action: normalizeActionNameFromCommand(command),
+        source: null,
+        description: null,
+        intent: null,
+        arguments: [],
+        flags: registeredFlags,
+        examples: [],
+        failure_hints: [],
+    };
+}
 function extensionSchemaPropertyNameFromFlag(flag) {
     const normalized = flag.flag.replace(/^-+/, "").trim();
     if (normalized.length === 0) {
@@ -1564,55 +1605,109 @@ function resolveContractsCommands(selection, actionContext) {
 function resolveOutputCommands(_selection, commands) {
     return commands;
 }
-function summarizeCommandIntent(command) {
-    const rootCommand = command.split(" ")[0];
-    return (COMMAND_INTENTS.get(command) ??
-        COMMAND_INTENTS.get(rootCommand) ??
-        "Inspect flags.");
-}
 function canonicalSummaryCommand(command) {
     const rootCommand = command.split(" ")[0];
-    if (rootCommand.startsWith("list-")) {
+    if (rootCommand.startsWith("list-"))
         return "list";
-    }
-    if (rootCommand.startsWith("history-")) {
+    if (rootCommand.startsWith("history-"))
         return "history";
-    }
-    if (rootCommand === "ctx") {
-        return "context";
-    }
-    if (rootCommand === "packages") {
-        return "package";
-    }
     return COMMAND_ALIAS_TO_CANONICAL.get(rootCommand) ?? rootCommand;
 }
-function buildCommandSummarySurface(commands) {
-    const rootsByCanonical = new Map();
-    for (const command of commands) {
-        const root = command.split(" ")[0];
-        const canonical = canonicalSummaryCommand(root);
-        const roots = rootsByCanonical.get(canonical) ?? new Set();
-        roots.add(root);
-        rootsByCanonical.set(canonical, roots);
+const COMMAND_OPERATION_INTENTS = new Map([
+    ["activate", "Activate"],
+    ["adopt", "Adopt"],
+    ["adopt-all", "Adopt all"],
+    ["catalog", "Catalog"],
+    ["complete", "Complete"],
+    ["create", "Create"],
+    ["deactivate", "Deactivate"],
+    ["delete", "Delete"],
+    ["describe", "Describe"],
+    ["doctor", "Diagnose"],
+    ["explore", "Explore"],
+    ["init", "Initialize"],
+    ["inspect", "Inspect"],
+    ["install", "Install"],
+    ["list", "List"],
+    ["manage", "Manage"],
+    ["migrate", "Migrate"],
+    ["mutate", "Mutate"],
+    ["reload", "Reload"],
+    ["restore", "Restore"],
+    ["run", "Run"],
+    ["snapshot", "Manage snapshots for"],
+    ["uninstall", "Uninstall"],
+]);
+const COMMAND_INTENT_SUBJECT_OVERRIDES = new Map([
+    ["extension adopt-all", "extensions"],
+    ["package adopt-all", "packages"],
+    ["workspace snapshot list", "workspace snapshots"],
+]);
+function summarizeCommandIntent(command, extensionContracts) {
+    const declared = COMMAND_INTENTS.get(command) ??
+        (command.includes(" ")
+            ? undefined
+            : COMMAND_INTENTS.get(canonicalSummaryCommand(command)));
+    if (declared !== undefined) {
+        return { intent: declared, intent_source: "command" };
+    }
+    const extensionContract = extensionContracts.find((contract) => splitCommandPathAliases(contract.command).includes(command));
+    if (extensionContract?.intent !== null &&
+        extensionContract?.intent !== undefined) {
+        return { intent: extensionContract.intent, intent_source: "command" };
+    }
+    if (extensionContract?.description !== null &&
+        extensionContract?.description !== undefined) {
+        return {
+            intent: extensionContract.description,
+            intent_source: "description",
+        };
     }
-    const rootCommands = [...rootsByCanonical.keys()]
+    const tokens = command.split(" ");
+    const operation = tokens.at(-1);
+    const subject = tokens.slice(0, -1).join(" ");
+    const verb = COMMAND_OPERATION_INTENTS.get(operation);
+    const intentSubject = COMMAND_INTENT_SUBJECT_OVERRIDES.get(command) ?? subject;
+    return {
+        intent: verb === undefined || subject.length === 0
+            ? `Run ${command}.`
+            : `${verb} ${intentSubject}.`,
+        intent_source: "generated",
+    };
+}
+function buildCommandSummarySurface(commands, extensionContracts = []) {
+    return [...new Set(commands.map(normalizeCommandPath))]
         .filter((command) => command.length > 0)
-        .sort((left, right) => left.localeCompare(right));
-    return rootCommands.map((command) => {
+        .sort((left, right) => left.localeCompare(right))
+        .map((command) => {
         const budget = resolvePmCommandOutputBudget(command, {
             generateFallback: true,
         });
-        const availableFlags = new Set(resolveCoreCommandFlags(command).map((contract) => contract.flag));
-        const flags = (AGENT_BOOTSTRAP_FLAGS.get(command) ?? AGENT_BOUNDED_FLAG_PRIORITY).filter((flag) => availableFlags.has(flag));
-        const aliases = [...rootsByCanonical.get(command)]
-            .filter((root) => root !== command)
-            .sort((left, right) => left.localeCompare(right));
+        const rootCommand = command.split(" ")[0];
+        const canonicalRoot = COMMAND_ALIAS_TO_CANONICAL.get(rootCommand) ??
+            (rootCommand.startsWith("list-")
+                ? "list"
+                : rootCommand.startsWith("history-")
+                    ? "history"
+                    : rootCommand);
+        const availableFlags = new Set([
+            ...resolveCoreCommandFlags(command).map((contract) => contract.flag),
+            ...extensionContracts
+                .filter((contract) => splitCommandPathAliases(contract.command).includes(command))
+                .flatMap((contract) => contract.flags.map((flag) => flag.flag)),
+        ]);
+        const flags = (AGENT_BOOTSTRAP_FLAGS.get(command) ??
+            AGENT_BOOTSTRAP_FLAGS.get(canonicalRoot) ??
+            AGENT_BOUNDED_FLAG_PRIORITY).filter((flag) => availableFlags.has(flag));
+        const intent = summarizeCommandIntent(command, extensionContracts);
         return {
             command,
-            ...(aliases.length > 0 ? { aliases } : {}),
-            intent: summarizeCommandIntent(command),
+            ...intent,
             ...(flags.length > 0 ? { flags } : {}),
             default_max_estimated_tokens: budget.default_max_estimated_tokens,
+            default_max_estimated_tokens_by_format: {
+                ...budget.default_max_estimated_tokens_by_format,
+            },
         };
     });
 }
@@ -1785,8 +1880,8 @@ function attachCommanderAliasContractsResult(result, selection) {
     result.commander_aliases_omitted_reason = "unfiltered_default_brief";
 }
 /** Attach the compact agent-facing command semantics shared by summary and full projections. */
-function attachAgentCommandContractsResult(result, outputCommands) {
-    result.command_summaries = buildCommandSummarySurface(outputCommands);
+function attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts) {
+    result.command_summaries = buildCommandSummarySurface(outputCommands, extensionCommandContracts);
     result.output_policy = {
         token_estimate: "ceil(utf8_bytes / 4)",
         degradation_ladder: [...PM_OUTPUT_DEGRADATION_STEPS],
@@ -1804,14 +1899,14 @@ export async function runContracts(options, global) {
     const commands = resolveContractsCommands(selection, actionContext);
     const outputCommands = resolveOutputCommands(selection, commands);
     const result = createContractsResult(selection, schemaContext, actionContext, outputCommands);
+    const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
     if (selection.summary || selection.fullOutput) {
-        attachAgentCommandContractsResult(result, outputCommands);
+        attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts);
     }
     if (selection.summary) {
         return result;
     }
     const commandAliases = buildCommandAliasSurface(commands);
-    const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
     if (!(selection.flagsOnly && !selection.fullOutput)) {
         attachRuntimeContractsResult(result, runtime);
     }
@@ -1872,4 +1967,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=651d4904-cae5-503b-8418-93bc44a413ad
+//# debugId=c0995490-5838-5c91-af77-9ce387e41a1f

package/dist/sdk/cli-program.js

@@ -4,7 +4,7 @@
  * Builds the reusable Commander root that embeds pm's universal global contracts.
  */
 
-!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]="b799c7c2-21b8-5c19-8565-7166e6f06a90")}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]="304d0901-79d3-593d-a789-410e28d59948")}catch(e){}}();
 import { Command } from "commander";
 import { writeStdout } from "../core/output/output.js";
 /** Create a fresh pm root program suitable for one-shot CLI or embedded hosts. */
@@ -27,7 +27,7 @@ export function createPmCliProgram(version) {
         .option("--token-accounting", "Attach a bounded per-section token-cost receipt to command output")
         .option("--output-include <fields>", "Retain comma-separated fields or sections in read output")
         .option("--output-limit <count>", "Bound rows in read output")
-        .option("--output-budget <tokens>", "Bound estimated tokens in read output")
+        .option("--output-budget <tokens|unbounded>", "Bound estimated tokens in read output or explicitly disable the default ceiling")
         .option("--output-format <toon|json>", "Select the read-output encoding")
         .option("--output-session <state>", "Carry a JSON session budget and served-item ledger across read calls")
         .option("--output-row-contract", "Include the machine-readable row selector and TOON encoding contract")
@@ -45,4 +45,4 @@ export function createPmCliProgram(version) {
         .exitOverride();
 }
 //# sourceMappingURL=cli-program.js.map
-//# debugId=b799c7c2-21b8-5c19-8565-7166e6f06a90
+//# debugId=304d0901-79d3-593d-a789-410e28d59948

package/dist/sdk/context-relevance.js

@@ -6,7 +6,7 @@
  * with core, extension, or project-specific feature stores.
  */
 
-!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]="1f898377-b606-5bfd-932d-6ce5f2f9c717")}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]="7eefe5f0-364d-559a-b365-0e7d539ee19e")}catch(e){}}();
 import { runActiveServiceOverride } from "../core/extensions/index.js";
 import { normalizeStatusForRegistry, normalizeStatusInput, } from "../core/item/status.js";
 import { compareTimestampStrings, resolveIsoOrRelative } from "../core/shared/time.js";
@@ -364,8 +364,16 @@ export async function runContextEvaluationScenario(scenario, reader) {
         throw new TypeError("Context evaluation scenarios require non-empty id and rationale values");
     }
     const result = scenario.surface === "context"
-        ? await reader.context({ ...scenario.options, explainRanking: true })
-        : await reader.next({ ...scenario.options, explainRanking: true });
+        ? await reader.context({
+            ...scenario.options,
+            explainRanking: true,
+            outputBudget: "unbounded",
+        })
+        : await reader.next({
+            ...scenario.options,
+            explainRanking: true,
+            outputBudget: "unbounded",
+        });
     const { rankedIds, attribution } = rankingPayloadForScenario(result, scenario.surface);
     const packet = { ...result, ranking: undefined };
     const actualTokens = estimateJsonTokens(packet);
@@ -422,4 +430,4 @@ export async function runContextEvaluationCorpus(scenarios, reader, thresholds)
     return summarizeContextEvaluationReports(reports, thresholds);
 }
 //# sourceMappingURL=context-relevance.js.map
-//# debugId=1f898377-b606-5bfd-932d-6ce5f2f9c717
+//# debugId=7eefe5f0-364d-559a-b365-0e7d539ee19e

package/dist/sdk/governance/assurance.js

@@ -7,7 +7,7 @@
  * one deterministic SDK path.
  */
 
-!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]="e491ddd9-60e7-51fd-b0c7-4f6e86ee56f9")}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]="07889857-2176-5659-96f7-8f5591f4c692")}catch(e){}}();
 import { createHash } from "node:crypto";
 import path from "node:path";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -669,9 +669,9 @@ export async function evaluateAssuranceGate(gateId, document, context, options)
     validateAssuranceDocument(document);
     const gateDefinition = document.gates.find((entry) => entry.id === gateId);
     if (!gateDefinition)
-        throw new TypeError(`assurance gate ${gateId} not found`);
+        throw new AssuranceEvaluationRefusalError(`assurance gate ${gateId} not found`);
     if (!gateDefinition.triggers.includes(options.trigger)) {
-        throw new TypeError(`assurance gate ${gateId} does not declare trigger ${options.trigger}`);
+        throw new AssuranceEvaluationRefusalError(`assurance gate ${gateId} does not declare trigger ${options.trigger}`);
     }
     enforceGateProviderPolicy(gateDefinition, document, context, options.trigger);
     const assertions = await mapWithConcurrency(gateDefinition.assertion_ids, EVALUATION_CONCURRENCY, async (id) => {
@@ -940,4 +940,4 @@ export async function listAssuranceVerdicts(pmRoot, options = {}) {
         .slice(0, limit);
 }
 //# sourceMappingURL=assurance.js.map
-//# debugId=e491ddd9-60e7-51fd-b0c7-4f6e86ee56f9
+//# debugId=07889857-2176-5659-96f7-8f5591f4c692

package/dist/sdk/governance/health.js

@@ -4,7 +4,7 @@
  * Implements the pm health 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]="5cee1eaa-73f3-5709-867f-a8d73081da8b")}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]="97fd3651-47de-5505-be2b-bc466313e91f")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
@@ -917,6 +917,9 @@ const HEALTH_DETAIL_SUMMARIZERS = {
         unreadable_streams: summarizeStringList(details.unreadable_streams, limit),
         hash_mismatches: summarizeStringList(details.hash_mismatches, limit),
         chain_mismatches: summarizeStringList(details.chain_mismatches, limit),
+        workspace_state_mismatches: summarizeStringList(details.workspace_state_mismatches, limit),
+        workspace_state_missing: summarizeStringList(details.workspace_state_missing, limit),
+        workspace_state_unreadable: summarizeStringList(details.workspace_state_unreadable, limit),
         skipped: details.skipped,
     }),
     vectorization: (details, limit) => ({
@@ -1351,12 +1354,15 @@ async function buildLocksCheck(pmRoot) {
 }
 async function buildHistoryDriftCheck(pmRoot, items) {
     const cacheHitVerification = "metadata";
-    const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems, } = await scanHistoryDrift(pmRoot, items, { cacheHitVerification });
+    const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems, workspaceStateMismatches, workspaceStateMissing, workspaceStateUnreadable, } = await scanHistoryDrift(pmRoot, items, { cacheHitVerification });
     const warnings = [
         ...missingStreams.map((id) => `history_drift_missing_stream:${id}`),
         ...unreadableStreams.map((id) => `history_drift_unreadable_stream:${id}`),
         ...hashMismatches.map((id) => `history_drift_hash_mismatch:${id}`),
         ...chainMismatches.map((id) => `history_drift_chain_mismatch:${id}`),
+        ...workspaceStateMismatches.map((documentPath) => `history_drift_workspace_state_mismatch:${documentPath}`),
+        ...workspaceStateMissing.map((documentPath) => `history_drift_workspace_state_missing:${documentPath}`),
+        ...workspaceStateUnreadable.map((documentPath) => `history_drift_workspace_state_unreadable:${documentPath}`),
     ];
     return {
         check: {
@@ -1373,11 +1379,17 @@ async function buildHistoryDriftCheck(pmRoot, items) {
                     unreadable_streams: unreadableStreams.length,
                     hash_mismatches: hashMismatches.length,
                     chain_mismatches: chainMismatches.length,
+                    workspace_state_mismatches: workspaceStateMismatches.length,
+                    workspace_state_missing: workspaceStateMissing.length,
+                    workspace_state_unreadable: workspaceStateUnreadable.length,
                 },
                 missing_streams: missingStreams,
                 unreadable_streams: unreadableStreams,
                 hash_mismatches: hashMismatches,
                 chain_mismatches: chainMismatches,
+                workspace_state_mismatches: workspaceStateMismatches,
+                workspace_state_missing: workspaceStateMissing,
+                workspace_state_unreadable: workspaceStateUnreadable,
             },
         },
         warnings,
@@ -2007,4 +2019,4 @@ export const _testOnlyHealthCommand = {
     warningCode,
 };
 //# sourceMappingURL=health.js.map
-//# debugId=5cee1eaa-73f3-5709-867f-a8d73081da8b
+//# debugId=97fd3651-47de-5505-be2b-bc466313e91f

package/dist/sdk/governance/validate-history-drift.d.ts

@@ -0,0 +1,7 @@
+import type { ValidateCheck } from "./validate.js";
+import type { ValidateItem } from "./validate-item-reader.js";
+/** Build the validation warning and bounded evidence projection for history drift. */
+export declare function buildValidateHistoryDriftCheck(pmRoot: string, items: ValidateItem[], verboseDiagnostics: boolean): Promise<{
+    check: ValidateCheck;
+    warnings: string[];
+}>;

package/dist/sdk/governance/validate-history-drift.js

@@ -0,0 +1,68 @@
+/**
+ * @module sdk/governance/validate-history-drift
+ *
+ * Projects append-only item and workspace singleton drift into the validation
+ * check contract without adding history-specific weight to the main validate
+ * orchestration module.
+ */
+
+!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]="a1261d65-222c-5c6c-8634-a4413a91aba9")}catch(e){}}();
+import { scanHistoryDrift } from "../../core/history/drift-scan.js";
+const DEFAULT_DIAGNOSTIC_LIMIT = 5;
+/** Build the validation warning and bounded evidence projection for history drift. */
+export async function buildValidateHistoryDriftCheck(pmRoot, items, verboseDiagnostics) {
+    const drift = await scanHistoryDrift(pmRoot, items);
+    const warningCounts = [
+        ["validate_history_drift_missing_streams", drift.missingStreams.length],
+        ["validate_history_drift_unreadable_streams", drift.unreadableStreams.length],
+        ["validate_history_drift_hash_mismatches", drift.hashMismatches.length],
+        ["validate_history_drift_chain_mismatches", drift.chainMismatches.length],
+        [
+            "validate_history_drift_workspace_state_mismatches",
+            drift.workspaceStateMismatches.length,
+        ],
+        [
+            "validate_history_drift_workspace_state_missing",
+            drift.workspaceStateMissing.length,
+        ],
+        [
+            "validate_history_drift_workspace_state_unreadable",
+            drift.workspaceStateUnreadable.length,
+        ],
+    ];
+    const warnings = warningCounts
+        .filter(([, count]) => count > 0)
+        .map(([code, count]) => `${code}:${count}`);
+    const diagnosticLimit = verboseDiagnostics
+        ? Number.POSITIVE_INFINITY
+        : DEFAULT_DIAGNOSTIC_LIMIT;
+    const driftedItems = drift.driftedItems.slice(0, diagnosticLimit);
+    return {
+        check: {
+            name: "history_drift",
+            status: warnings.length === 0 ? "ok" : "warn",
+            ok: warnings.length === 0,
+            details: {
+                checked_items: items.length,
+                drifted_items_count: drift.driftedItems.length,
+                drifted_items: driftedItems,
+                drifted_items_truncated: driftedItems.length < drift.driftedItems.length,
+                counts: {
+                    missing_streams: drift.missingStreams.length,
+                    unreadable_streams: drift.unreadableStreams.length,
+                    hash_mismatches: drift.hashMismatches.length,
+                    chain_mismatches: drift.chainMismatches.length,
+                    workspace_state_mismatches: drift.workspaceStateMismatches.length,
+                    workspace_state_missing: drift.workspaceStateMissing.length,
+                    workspace_state_unreadable: drift.workspaceStateUnreadable.length,
+                },
+                workspace_state_mismatches: drift.workspaceStateMismatches,
+                workspace_state_missing: drift.workspaceStateMissing,
+                workspace_state_unreadable: drift.workspaceStateUnreadable,
+            },
+        },
+        warnings,
+    };
+}
+//# sourceMappingURL=validate-history-drift.js.map
+//# debugId=a1261d65-222c-5c6c-8634-a4413a91aba9

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]="7dd04a2f-1798-5c16-8740-5b7094f81cc0")}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]="7b47a375-e72c-5108-bd93-75dd8cf93218")}catch(e){}}();
 import fs from "node:fs/promises";
 import { realpathSync } from "node:fs";
 import { execFile } from "node:child_process";
@@ -14,7 +14,6 @@ import { buildRemediationCommands } from "../../core/diagnostics/remediation.js"
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { collectRegisteredItemFieldNames } from "../../core/extensions/item-fields.js";
 import { isFileMissingError, pathExists } from "../../core/fs/fs-utils.js";
-import { scanHistoryDrift } from "../../core/history/drift-scan.js";
 import { normalizeStatusInput } from "../../core/item/status.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
@@ -43,6 +42,7 @@ import { runDocs } from "../docs.js";
 import { runFiles } from "../files.js";
 import { extractReferencedPmItemIdsFromCommand } from "../test/linked-command-detection.js";
 import { readValidateItems, } from "./validate-item-reader.js";
+import { buildValidateHistoryDriftCheck } from "./validate-history-drift.js";
 const FILE_SCAN_DIRECTORIES = ["src", "tests", "docs"];
 const FILE_SCAN_ROOT_FILES = [
     "README.md",
@@ -1767,48 +1767,6 @@ async function buildFilesCheck(items, workspaceRoot, pmRoot, fileScanMode, inclu
     };
 }
 /* c8 ignore stop */
-/* c8 ignore start -- history-drift warning/count projection permutations are covered by drift integration tests */
-async function buildHistoryDriftCheck(pmRoot, items, verboseDiagnostics) {
-    const { missingStreams, unreadableStreams, hashMismatches, chainMismatches, driftedItems, } = await scanHistoryDrift(pmRoot, items);
-    const warnings = [];
-    if (missingStreams.length > 0) {
-        warnings.push(`validate_history_drift_missing_streams:${missingStreams.length}`);
-    }
-    if (unreadableStreams.length > 0) {
-        warnings.push(`validate_history_drift_unreadable_streams:${unreadableStreams.length}`);
-    }
-    if (hashMismatches.length > 0) {
-        warnings.push(`validate_history_drift_hash_mismatches:${hashMismatches.length}`);
-    }
-    if (chainMismatches.length > 0) {
-        warnings.push(`validate_history_drift_chain_mismatches:${chainMismatches.length}`);
-    }
-    const diagnosticLimit = verboseDiagnostics
-        ? Number.POSITIVE_INFINITY
-        : DIAGNOSTIC_LIST_SUMMARY_LIMIT;
-    const summarizedDrifted = summarizeList(driftedItems, diagnosticLimit);
-    return {
-        check: {
-            name: "history_drift",
-            status: warnings.length === 0 ? "ok" : "warn",
-            ok: warnings.length === 0,
-            details: {
-                checked_items: items.length,
-                drifted_items_count: driftedItems.length,
-                drifted_items: summarizedDrifted.values,
-                drifted_items_truncated: summarizedDrifted.truncated,
-                counts: {
-                    missing_streams: missingStreams.length,
-                    unreadable_streams: unreadableStreams.length,
-                    hash_mismatches: hashMismatches.length,
-                    chain_mismatches: chainMismatches.length,
-                },
-            },
-        },
-        warnings,
-    };
-}
-/* c8 ignore stop */
 /* c8 ignore start -- command preview truncation formatting is covered by command-reference integration fixtures */
 function summarizeCommandReferenceRow(ownerId, referencedId, command) {
     const normalizedCommand = command.trim().replaceAll(/\s+/g, " ");
@@ -2195,7 +2153,7 @@ async function executeRequestedValidateChecks(params) {
         recordValidateCheck(state, buildCommandReferencesCheck(params.items, params.settings.id_prefix, fullDiagnostics), fixHintsEnabled);
     }
     if (params.requestedChecks.has("history_drift")) {
-        recordValidateCheck(state, await buildHistoryDriftCheck(params.pmRoot, params.items, fullDiagnostics), fixHintsEnabled);
+        recordValidateCheck(state, await buildValidateHistoryDriftCheck(params.pmRoot, params.items, fullDiagnostics), fixHintsEnabled);
     }
     if (params.requestedChecks.has("format_version")) {
         recordValidateCheck(state, buildFormatVersionCheck(params.items, fullDiagnostics), fixHintsEnabled);
@@ -2356,4 +2314,4 @@ export async function runValidate(options, global, services = {}) {
 }
 /* c8 ignore stop */
 //# sourceMappingURL=validate.js.map
-//# debugId=7dd04a2f-1798-5c16-8740-5b7094f81cc0
+//# debugId=7b47a375-e72c-5108-bd93-75dd8cf93218