@unbrained/pm-cli 2026.8.8 → 2026.8.10

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]="adf76b7b-fc29-5b35-b33a-5ae008cbc8e7")}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]="081c3d07-0cf1-5bad-80ff-2d37be8ee887")}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, 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, 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, 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";
+import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_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";
 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";
 import { getActiveContextIntentContracts, } from "../context-intent-contracts.js";
@@ -17,6 +17,7 @@ import { resolvePmCommandVisibilityTier, } from "../agent-capability-contracts.j
 import { PM_ERROR_CODE_CATALOG } from "../generated-error-code-catalog.js";
 import { resolvePmCommandOutputEnvelope, } from "../output-contracts.js";
 import { PM_COMMAND_EXIT_OUTCOME_CONTRACTS, resolvePmCommandExitContract, } from "./command-exit-contracts.js";
+import { BUILTIN_RELATIONSHIP_KINDS } from "../relationship-kinds/contract.js";
 const AGENT_BOOTSTRAP_FLAGS = new Map([
     [
         "claim",
@@ -307,6 +308,8 @@ const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ["create", CREATE_FLAG_CONTRACTS],
     ["item mutate", ITEM_MUTATE_FLAG_CONTRACTS],
     ["item complete", ITEM_COMPLETE_FLAG_CONTRACTS],
+    ["copy", COPY_FLAG_CONTRACTS],
+    ["focus", FOCUS_FLAG_CONTRACTS],
     ["update", UPDATE_FLAG_CONTRACTS],
     ["update-many", UPDATE_MANY_FLAG_CONTRACTS],
     ["upgrade", UPGRADE_FLAG_CONTRACTS],
@@ -1718,6 +1721,20 @@ function attachRuntimeContractsResult(result, runtime) {
         close_validation_modes: [...GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES],
         workflow_enforcement_modes: [...GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES],
     };
+    result.relationship_kind_contracts = [
+        ...BUILTIN_RELATIONSHIP_KINDS,
+        ...(runtime.runtimeProbe.registrations?.relationship_kinds ?? []).flatMap((registration) => registration.definitions),
+    ]
+        .sort((left, right) => left.kind.localeCompare(right.kind))
+        .map((definition) => ({
+        canonical: definition.kind,
+        aliases: [...(definition.aliases ?? [])],
+        ...(definition.inverse === undefined
+            ? {}
+            : { inverse: definition.inverse }),
+        ordering: definition.ordering,
+        hierarchy: definition.hierarchy,
+    }));
 }
 function attachSchemaContractsResult(result, selection, schemaContext, extensionCommandContracts) {
     if (selection.flagsOnly || selection.availabilityOnly) {
@@ -1854,4 +1871,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=adf76b7b-fc29-5b35-b33a-5ae008cbc8e7
+//# debugId=081c3d07-0cf1-5bad-80ff-2d37be8ee887

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

@@ -170,6 +170,9 @@ export declare const TOOL_CREATE_OPTION_CONTRACT_SOURCE: readonly [{
 }, {
     readonly param: "allowMissingParent";
     readonly flag: "--allow-missing-parent";
+}, {
+    readonly param: "allowUnresolvedDeps";
+    readonly flag: "--allow-unresolved-deps";
 }, {
     readonly param: "allowDuplicate";
     readonly flag: "--allow-duplicate";
@@ -325,6 +328,9 @@ export declare const TOOL_UPDATE_OPTION_CONTRACT_SOURCE: readonly [{
 }, {
     readonly param: "allowMissingParent";
     readonly flag: "--allow-missing-parent";
+}, {
+    readonly param: "allowUnresolvedDeps";
+    readonly flag: "--allow-unresolved-deps";
 }, {
     readonly param: "dep";
     readonly flag: "--dep";

package/dist/sdk/cli-contracts/tool-option-contracts.js

@@ -1,6 +1,6 @@
 /** Returns fresh option contract objects so exported arrays cannot share mutable entries. */
 
-!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]="13ab1164-d2b1-5954-80e8-08c6b12779da")}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]="26955ae3-1aca-503e-9492-46652285d17a")}catch(e){}}();
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -183,6 +183,7 @@ export const TOOL_CREATE_OPTION_CONTRACT_SOURCE = [
     { param: "message", flag: "--message", allowEmpty: true },
     { param: "assignee", flag: "--assignee" },
     { param: "allowMissingParent", flag: "--allow-missing-parent" },
+    { param: "allowUnresolvedDeps", flag: "--allow-unresolved-deps" },
     { param: "allowDuplicate", flag: "--allow-duplicate", booleanish: true },
     { param: "reminder", flag: "--reminder", repeatable: true },
     { param: "event", flag: "--event", repeatable: true },
@@ -235,6 +236,7 @@ export const TOOL_UPDATE_OPTION_CONTRACT_SOURCE = [
     { param: "message", flag: "--message", allowEmpty: true },
     { param: "assignee", flag: "--assignee" },
     { param: "allowMissingParent", flag: "--allow-missing-parent" },
+    { param: "allowUnresolvedDeps", flag: "--allow-unresolved-deps" },
     { param: "dep", flag: "--dep", repeatable: true },
     { param: "depRemove", flag: "--dep-remove", repeatable: true },
     { param: "replaceDeps", flag: "--replace-deps" },
@@ -421,4 +423,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=13ab1164-d2b1-5954-80e8-08c6b12779da
+//# debugId=26955ae3-1aca-503e-9492-46652285d17a

package/dist/sdk/cli-contracts/tool-parameter-tables.js

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Tool Parameter Tables.
  */
 
-!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]="35c4b819-02d6-582a-a7eb-fe3f4a4903d9")}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]="6e0b4ff7-5aca-562b-b36c-c0c53987138d")}catch(e){}}();
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 import { PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS } from "../read-output-session.js";
 /** Public contract for pm tool parameter properties, shared by SDK and presentation-layer consumers. */
@@ -164,6 +164,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     },
     idOnly: { type: "boolean" },
     allowMissingParent: { type: "boolean" },
+    allowUnresolvedDeps: { type: "boolean" },
     allowDuplicate: { type: "boolean" },
     duplicateOf: { type: "string" },
     configAction: { type: "string", enum: ["get", "set", "list", "export"] },
@@ -979,6 +980,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
     allowDuplicate: {
         description: "Explicitly proceed when strict similarity governance finds likely duplicate items.",
     },
+    allowUnresolvedDeps: {
+        description: "Permit unresolved local dependency targets while returning dependency_target_unresolved warning receipts. Cross-workspace references should use source_kind=external instead.",
+        examples: [true],
+    },
     requiredTypes: {
         description: "Restrict a custom field's requirement to specific item types (schema add-field).",
         examples: [["Bug"], ["Story", "Spike"]],
@@ -1074,7 +1079,7 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [["error path covered by a regression test"]],
     },
     removeAc: {
-        description: "Acceptance criteria removed individually by exact text match (one criterion per entry).",
+        description: "Acceptance criteria removed individually by exact text match; the mutation fails atomically if any selector is unmatched (one criterion per entry).",
         examples: [["superseded manual QA step"]],
     },
     removeTags: {
@@ -1106,7 +1111,7 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [60, "120"],
     },
     acceptanceCriteria: {
-        description: "Acceptance criteria text.",
+        description: "Complete acceptance-criteria text supplied while creating or replacing an item field.",
     },
     author: {
         description: "Intentional mutation-author override. Agent harness identity is automatic when omitted.",
@@ -1764,6 +1769,16 @@ export const PM_TOOL_PARAMETER_METADATA = {
  * because its single `name` property must cover every action at once.
  */
 export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
+    update: {
+        acceptanceCriteria: {
+            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
+        },
+    },
+    "update-many": {
+        acceptanceCriteria: {
+            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
+        },
+    },
     stats: {
         since: {
             description: "Inclusive ISO 8601 timestamp or negative duration lower bound for provenance and fleet analytics.",
@@ -1907,4 +1922,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=35c4b819-02d6-582a-a7eb-fe3f4a4903d9
+//# debugId=6e0b4ff7-5aca-562b-b36c-c0c53987138d

package/dist/sdk/cli-contracts/tool-schema.js

@@ -7,7 +7,7 @@
  * consumers from a single source of truth.
  */
 
-!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]="d9f01e68-6b54-5861-a4b5-ae40613c2047")}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]="4ce3417b-2ccc-5304-8275-30f6eb749db8")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { TOOL_CREATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, } from "./tool-option-contracts.js";
@@ -784,8 +784,21 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         required: ["id", "target"],
         optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
     },
-    update: { required: ["id"], optional: UPDATE_CONTRACT_PARAMETER_KEYS },
-    "update-many": { optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS },
+    update: {
+        required: ["id"],
+        optional: UPDATE_CONTRACT_PARAMETER_KEYS,
+        mutuallyExclusive: [
+            ["acceptanceCriteria", "addAc"],
+            ["acceptanceCriteria", "removeAc"],
+        ],
+    },
+    "update-many": {
+        optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS,
+        mutuallyExclusive: [
+            ["acceptanceCriteria", "addAc"],
+            ["acceptanceCriteria", "removeAc"],
+        ],
+    },
     close: {
         required: ["id"],
         optional: [
@@ -1512,4 +1525,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=d9f01e68-6b54-5861-a4b5-ae40613c2047
+//# debugId=4ce3417b-2ccc-5304-8275-30f6eb749db8

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

@@ -6,9 +6,10 @@
  * 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]="55ecd7ff-0047-5fd1-9f6f-f45602fce1bb")}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]="7ba0243e-98d1-5aef-bd47-54f0b630be58")}catch(e){}}();
 import { readFile } from "node:fs/promises";
 import path from "node:path";
+import { isFileAbsentError } from "../core/fs/fs-utils.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";
@@ -56,9 +57,11 @@ export async function readWorkspaceContextIntentContracts(pmRoot) {
         source = await readFile(declarationPath, "utf8");
     }
     catch (error) {
-        if (isRecord(error) &&
-            typeof error.code === "string" &&
-            error.code === "ENOENT") {
+        // 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.
+        if (isFileAbsentError(error)) {
             return [];
         }
         throw error;
@@ -107,4 +110,4 @@ export async function runWithDiscoveredContextIntentContracts(options, run) {
     return await runWithContextIntentContracts(layers, run);
 }
 //# sourceMappingURL=context-intent-runtime.js.map
-//# debugId=55ecd7ff-0047-5fd1-9f6f-f45602fce1bb
+//# debugId=7ba0243e-98d1-5aef-bd47-54f0b630be58

package/dist/sdk/context-signal-store.d.ts

@@ -52,7 +52,41 @@ export interface ContextSignalStoreReadResult {
     cache_status: "fresh" | "rebuilt";
     /** Non-fatal recovery diagnostics. */
     warnings: readonly string[];
+    /** Actionable meanings and executable recovery commands for every warning. */
+    warning_details?: readonly ContextSignalStoreWarningDetail[];
 }
+/** Stable recovery contract for one context signal-store warning. */
+export interface ContextSignalStoreWarningDetail {
+    /** Machine-readable warning code also present in `warnings`. */
+    code: "context_signal_store_invalid" | "context_signal_store_stale" | "context_signal_store_write_failed";
+    /** Bounded explanation of the observed derived-state condition. */
+    meaning: string;
+    /** Safe executable command that retries or confirms recovery. */
+    recovery_command: "pm context";
+    /** Expected observable effect of the recovery command. */
+    recovery_effect: string;
+}
+/** Canonical actionable contracts shared by CLI, SDK, MCP, and package hosts. */
+export declare const CONTEXT_SIGNAL_STORE_WARNING_DETAILS: {
+    readonly context_signal_store_invalid: {
+        readonly code: "context_signal_store_invalid";
+        readonly meaning: "The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.";
+        readonly recovery_command: "pm context";
+        readonly recovery_effect: "Re-read context and confirm the rebuilt snapshot can be loaded without the warning.";
+    };
+    readonly context_signal_store_stale: {
+        readonly code: "context_signal_store_stale";
+        readonly meaning: "The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.";
+        readonly recovery_command: "pm context";
+        readonly recovery_effect: "Re-read context and confirm the rebuilt snapshot is now fresh.";
+    };
+    readonly context_signal_store_write_failed: {
+        readonly code: "context_signal_store_write_failed";
+        readonly meaning: "Context signals were rebuilt in memory, but the derived snapshot could not be persisted.";
+        readonly recovery_command: "pm context";
+        readonly recovery_effect: "Retry the derived snapshot write and confirm the warning clears after storage access is restored.";
+    };
+};
 /** Workspace-bound feature-store options used by CLI, MCP, and SDK readers. */
 export interface ReadWorkspaceContextSignalsOptions extends BuildItemContextRelevanceCandidatesOptions {
     /** Tracker root containing rebuildable runtime state. */

package/dist/sdk/context-signal-store.js

@@ -6,7 +6,7 @@
  * history, while stale, absent, or corrupt snapshots rebuild transparently.
  */
 
-!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]="a502be8f-57da-53c2-8de0-118a15688d93")}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]="2a0f64cf-f6a4-5304-921d-c83b98d3a31f")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -24,6 +24,27 @@ const STORED_CONTEXT_SIGNAL_NAMES = [
     "risk_pressure",
     "knowledge_density",
 ];
+/** Canonical actionable contracts shared by CLI, SDK, MCP, and package hosts. */
+export const CONTEXT_SIGNAL_STORE_WARNING_DETAILS = {
+    context_signal_store_invalid: {
+        code: "context_signal_store_invalid",
+        meaning: "The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.",
+        recovery_command: "pm context",
+        recovery_effect: "Re-read context and confirm the rebuilt snapshot can be loaded without the warning.",
+    },
+    context_signal_store_stale: {
+        code: "context_signal_store_stale",
+        meaning: "The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.",
+        recovery_command: "pm context",
+        recovery_effect: "Re-read context and confirm the rebuilt snapshot is now fresh.",
+    },
+    context_signal_store_write_failed: {
+        code: "context_signal_store_write_failed",
+        meaning: "Context signals were rebuilt in memory, but the derived snapshot could not be persisted.",
+        recovery_command: "pm context",
+        recovery_effect: "Retry the derived snapshot write and confirm the warning clears after storage access is restored.",
+    },
+};
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -245,6 +266,7 @@ export class ContextSignalStore {
             })),
             cache_status: fresh ? "fresh" : "rebuilt",
             warnings,
+            warning_details: warnings.map((warning) => CONTEXT_SIGNAL_STORE_WARNING_DETAILS[warning]),
         };
     }
 }
@@ -288,4 +310,4 @@ export async function readWorkspaceContextSignals(items, options) {
     return store.readOrRebuild(items, { ...options, sourceCursor, source });
 }
 //# sourceMappingURL=context-signal-store.js.map
-//# debugId=a502be8f-57da-53c2-8de0-118a15688d93
+//# debugId=2a0f64cf-f6a4-5304-921d-c83b98d3a31f

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

@@ -4,6 +4,6 @@
  * 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, detectAgentIdentity, detectHarnessIdentity, readAuthorEnvironment, registerHarnessSignalDescriptors, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, type AgentClientInfo, type AgentModelSource, type AgentProvenance, type AgentProvenanceObservation, type AuthorSource, type DetectedAgentIdentity, type HarnessDetectionSignals, type HarnessSignalDescriptor, type ResolvedAuthorIdentity, } from "../core/shared/author.js";
+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 { analyzeAgentProvenanceDescriptorCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, type AgentEpisodeGroup, type AgentModelProvenanceCoverage, type AgentProvenanceDimensionCoverage, type AgentProvenanceDescriptorCoverage, } from "./provenance.js";
 export { analyzeSdkCliParameterCompleteness, type SdkCliActionParameterCoverage, type SdkCliCompletenessContractSource, type SdkCliParameterCoverageEntry, type SdkCliParameterDisposition, } from "./cli-contracts.js";

package/dist/sdk/core-governance.js

@@ -5,9 +5,9 @@
  * 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]="80b8e2af-4dcf-59e8-bfbf-38124db887bf")}catch(e){}}();
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, 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]="7442357d-52b9-5461-9ac4-3acd898334da")}catch(e){}}();
+export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, readAuthorEnvironment, registerHarnessSignalDescriptors, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
 export { analyzeAgentProvenanceDescriptorCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, } from "./provenance.js";
 export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts.js";
 //# sourceMappingURL=core-governance.js.map
-//# debugId=80b8e2af-4dcf-59e8-bfbf-38124db887bf
+//# debugId=7442357d-52b9-5461-9ac4-3acd898334da

package/dist/sdk/dependencies.d.ts

@@ -109,6 +109,8 @@ export interface DepsResult {
     edge_count: number;
     /** Counting convention used by edge_count. */
     edge_basis: "deduplicated_directed";
+    /** Stored legacy relationship aliases grouped by spelling across the workspace. */
+    legacy_alias_counts?: Record<string, number>;
     /**
      * Number of missing entries represented by this result.
      *

package/dist/sdk/dependencies.js

@@ -4,7 +4,7 @@
  * 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]="a3535267-c69a-5a44-bdf9-02925e02aaeb")}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]="ee0547d9-ae0f-5762-8bff-e25f0a3cd4d5")}catch(e){}}();
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
 import { pathExists } from "../core/fs/fs-utils.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
@@ -637,7 +637,7 @@ function buildTreeOrGraphDepsResult(id, format, options, index, maxDepth, collap
         budget.reasons.add("token_budget");
     }
 }
-function attachDepsProjection(result, summaryOnly) {
+function attachDepsProjection(result, summaryOnly, legacyAliasCounts = {}) {
     const group = {
         name: result.format === "tree"
             ? "dependency_tree"
@@ -648,6 +648,7 @@ function attachDepsProjection(result, summaryOnly) {
     };
     return {
         ...result,
+        legacy_alias_counts: legacyAliasCounts,
         projection: {
             mode: summaryOnly ? "summary" : "full",
             declared_field_groups: [group],
@@ -705,16 +706,16 @@ export async function runDeps(id, options, global) {
             rootEvidence,
             summaryOnly,
             outputFormat: global.json === true ? "json" : "toon",
-        }), summaryOnly);
+        }), summaryOnly, lookup.assembly.legacyAliasCounts);
     }
     if (summaryOnly) {
         return attachDepsProjection({
             id,
             format,
             ...countDependencyGraph(id, index, maxDepth),
-        }, true);
+        }, true, Object.fromEntries(Object.entries(assembleWorkspaceRelationshipGraph(items, (status) => isTerminalStatus(status, statusRegistry)).legacyAliasCounts)));
     }
-    return attachDepsProjection(buildTreeOrGraphDepsResult(id, format, options, index, maxDepth, collapse, global.json === true ? "json" : "toon"), false);
+    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=a3535267-c69a-5a44-bdf9-02925e02aaeb
+//# debugId=ee0547d9-ae0f-5762-8bff-e25f0a3cd4d5

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

@@ -1,4 +1,4 @@
-import type { Dependency } from "../types/index.js";
+import type { Dependency, ItemFormat } 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;
@@ -7,3 +7,17 @@ export declare function assertValidBareDependencyFlagValue(value: string, struct
  * ontology before a create or update mutation writes item or history state.
  */
 export declare function assertDependencyEdgesAllowed(holderId: string, dependencies: readonly Dependency[] | undefined, registry?: RelationshipKindRegistry): void;
+/**
+ * Resolve every newly supplied local dependency before a mutation commits.
+ * Explicit external provenance bypasses workspace lookup, while the opt-in
+ * unresolved mode returns durable warning tokens instead of pretending that
+ * the graph edge resolved successfully.
+ */
+export declare function assertDependencyTargetsResolvable(params: {
+    pmRoot: string;
+    dependencies: readonly Dependency[] | undefined;
+    idPrefix: string;
+    itemFormat: ItemFormat;
+    typeToFolder: Record<string, string>;
+    allowUnresolved?: boolean;
+}): Promise<string[]>;

package/dist/sdk/dependency-flag-validation.js

@@ -1,9 +1,11 @@
 /** @module cli/commands/dependency-flag-validation */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1c1314f1-b54f-562c-b6f0-950fcac4c9cc")}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]="e7cd6092-ed18-52ea-94a0-03bed42eb858")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { toErrorMessage } from "../core/shared/primitives.js";
+import { locateItem } from "../core/store/item-store.js";
+import { isExternalDependencySourceKind } from "./dependency-provenance.js";
 import { resolveWorkspaceRelationshipKindRegistry } from "./graph/assembly.js";
 import { assertRelationshipEdgeAllowed, } from "./relationships.js";
 /** Reject malformed shorthand before item-id prefix normalization can create a dangling graph node. */
@@ -29,5 +31,55 @@ export function assertDependencyEdgesAllowed(holderId, dependencies, registry =
         }
     }
 }
+/**
+ * Resolve every newly supplied local dependency before a mutation commits.
+ * Explicit external provenance bypasses workspace lookup, while the opt-in
+ * unresolved mode returns durable warning tokens instead of pretending that
+ * the graph edge resolved successfully.
+ */
+export async function assertDependencyTargetsResolvable(params) {
+    const localTargets = [
+        ...new Set((params.dependencies ?? [])
+            .filter((dependency) => !isExternalDependencySourceKind(dependency.source_kind))
+            .map((dependency) => dependency.id)),
+    ];
+    const resolutions = await Promise.all(localTargets.map(async (target) => ({
+        target,
+        located: await locateItem(params.pmRoot, target, params.idPrefix, params.itemFormat, params.typeToFolder),
+    })));
+    const targets = resolutions
+        .filter(({ located }) => located === null)
+        .map(({ target }) => target)
+        .sort((left, right) => (left < right ? -1 : 1));
+    if (targets.length === 0) {
+        return [];
+    }
+    if (params.allowUnresolved === true) {
+        return targets.map((target) => `dependency_target_unresolved:${target}`);
+    }
+    throw new PmCliError(`Dependency target${targets.length === 1 ? "" : "s"} not found: ${targets.join(", ")}`, EXIT_CODE.NOT_FOUND, {
+        code: "dependency_target_not_found",
+        reason: "unresolved_local_dependency",
+        required: "Every local dependency target must exist before the edge is committed.",
+        why: "Fail-fast target resolution prevents dangling graph nodes and preserves reliable traversal semantics.",
+        unresolved_targets: targets,
+        examples: [
+            "--dep id=<existing-item-id>,kind=related",
+            "--dep id=<external-id>,kind=related,source_kind=external",
+            "--allow-unresolved-deps --dep id=<future-item-id>,kind=related",
+        ],
+        nextSteps: [
+            `Create or correct ${targets.length === 1 ? "the target" : "the targets"}, then retry the mutation.`,
+            "Use source_kind=external for a cross-workspace reference.",
+            "Use --allow-unresolved-deps only when the dangling local edge is intentional.",
+        ],
+        recovery: {
+            recovery_mode: "compact",
+            missing: targets,
+            suggested_flags: ["--allow-unresolved-deps"],
+            suggested_retry: `pm search "${targets[0]}" --limit 10`,
+        },
+    });
+}
 //# sourceMappingURL=dependency-flag-validation.js.map
-//# debugId=1c1314f1-b54f-562c-b6f0-950fcac4c9cc
+//# debugId=e7cd6092-ed18-52ea-94a0-03bed42eb858

package/dist/sdk/extension/bundled-catalog.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Bundled 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]="27a2b542-853e-52e1-ad80-11bab01b07a2")}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]="259656b0-09b7-52c5-8f54-52ac29eec607")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { collectPackageExtensionDirectories, PM_PACKAGE_RESOURCE_KINDS, readPmPackageManifest, } from "../../core/packages/manifest.js";
@@ -187,7 +187,7 @@ function buildBundledCatalogLinks(manifest) {
     };
 }
 /** Build one bundled-package catalog entry from its manifest, marking it `installed` when the managed state for `scope` already records the package by built-in alias or resolved location, and projecting the metadata-only resource kinds (everything except installable `extensions`) that the package ships. */
-function buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installedBuiltinAliases, installedLocations) {
+function buildBundledCatalogPackageEntry(manifest, bundledEntry, aliases, scope, installedBuiltinAliases, installedLocations) {
     const installScopeFlag = scope === "global" ? "--global" : "--project";
     const metadataOnlyResources = Object.fromEntries(PM_PACKAGE_RESOURCE_KINDS.filter((resourceKind) => resourceKind !== "extensions")
         .map((resourceKind) => [
@@ -197,9 +197,10 @@ function buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installe
         .filter(([, entries]) => Array.isArray(entries) && entries.length > 0));
     return {
         alias: bundledEntry.alias,
+        aliases,
         bundled: true,
         available: true,
-        installed: installedBuiltinAliases.has(bundledEntry.alias) ||
+        installed: aliases.some((alias) => installedBuiltinAliases.has(alias)) ||
             installedLocations.has(path.resolve(bundledEntry.package_root)),
         install_target: bundledEntry.alias,
         install_command: `pm install ${bundledEntry.alias} ${installScopeFlag}`,
@@ -240,9 +241,20 @@ export async function buildBundledPackageCatalog(scope, global, options = {}) {
         .filter((value) => typeof value === "string" && value.trim().length > 0)
         .map((value) => value.trim().toLowerCase()));
     const packages = [];
-    for (const bundledEntry of await collectBundledPackageEntries()) {
+    const bundledEntriesByRoot = new Map();
+    for (const entry of await collectBundledPackageEntries()) {
+        const packageRoot = path.resolve(entry.package_root);
+        const groupedEntries = bundledEntriesByRoot.get(packageRoot) ?? [];
+        groupedEntries.push(entry);
+        bundledEntriesByRoot.set(packageRoot, groupedEntries);
+    }
+    for (const bundledEntries of bundledEntriesByRoot.values()) {
+        const bundledEntry = bundledEntries[0];
+        const aliases = bundledEntries
+            .map((entry) => entry.alias)
+            .sort((left, right) => left.localeCompare(right));
         const manifest = await readPmPackageManifest(bundledEntry.package_root);
-        packages.push(buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installedBuiltinAliases, installedLocations));
+        packages.push(buildBundledCatalogPackageEntry(manifest, bundledEntry, aliases, scope, installedBuiltinAliases, installedLocations));
     }
     const fields = parsePackageCatalogFields(options.fields);
     const outputPackages = fields
@@ -258,6 +270,7 @@ export async function buildBundledPackageCatalog(scope, global, options = {}) {
 }
 const PACKAGE_CATALOG_FIELD_KEYS = new Set([
     "alias",
+    "aliases",
     "bundled",
     "available",
     "installed",
@@ -317,4 +330,4 @@ export const _testOnlyBundledCatalog = {
     projectPackageCatalogEntry,
 };
 //# sourceMappingURL=bundled-catalog.js.map
-//# debugId=27a2b542-853e-52e1-ad80-11bab01b07a2
+//# debugId=259656b0-09b7-52c5-8f54-52ac29eec607