@unbrained/pm-cli 2026.8.17 → 2026.8.18

package/dist/sdk/agent/refusal-reachability.js

@@ -5,8 +5,8 @@
  * generated public error-code catalog.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="70af2366-a675-5631-8edb-4ebeef4bb786")}catch(e){}}();
-import { stripTypeScriptTypes } from "node: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]="7b488d32-9f92-5a80-965e-e2555cd49315")}catch(e){}}();
+import * as nodeModule from "node:module";
 /** Recovery-reference kinds emitted by structured refusal envelopes. */
 export const PM_RECOVERY_REFERENCE_KINDS = [
     "suggested_retry",
@@ -237,7 +237,7 @@ function isPatternLikeObjectClosure(tokens, index) {
 }
 /** Parse static object-literal members without treating patterns or labels as producers. */
 function scanSourcePropertyTokens(source) {
-    const tokens = tokenizeExecutableSource(stripTypeScriptTypes(source, { mode: "strip" }));
+    const tokens = tokenizeExecutableSource(nodeModule.stripTypeScriptTypes(source, { mode: "strip" }));
     const properties = [];
     const stack = [];
     for (const [index, token] of tokens.entries()) {
@@ -567,4 +567,4 @@ export function verifyPmRecoveryReferences(obligations, observations) {
     };
 }
 //# sourceMappingURL=refusal-reachability.js.map
-//# debugId=70af2366-a675-5631-8edb-4ebeef4bb786
+//# debugId=7b488d32-9f92-5a80-965e-e2555cd49315

package/dist/sdk/authoring.d.ts

@@ -15,4 +15,4 @@ export { planProfileApplication, type ProfileApplicationPlan, type ProfileChange
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "../core/extensions/capability-usage.js";
 export { renderExtensionSurfaceMarkdown, type ExtensionSurfaceMarkdownOptions, } from "../core/extensions/activation-summary-markdown.js";
 export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.js";
-export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
+export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExporterArtifactOutputContract, ExporterRegistrationOptions, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExporterArtifactOutputContract, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";

package/dist/sdk/authoring.js

@@ -4,7 +4,7 @@
  * Provides the focused extension and package authoring surface.
  */
 
-!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]="99a9b24a-4bc7-50da-8333-e76086f0e303")}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]="6260572c-1496-58ef-9377-0825f4183bc6")}catch(e){}}();
 export * from "./compose.js";
 export * from "./define.js";
 export * from "./extension-contracts.js";
@@ -18,4 +18,4 @@ export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabil
 export { renderExtensionSurfaceMarkdown, } from "../core/extensions/activation-summary-markdown.js";
 export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.js";
 //# sourceMappingURL=authoring.js.map
-//# debugId=99a9b24a-4bc7-50da-8333-e76086f0e303
+//# debugId=6260572c-1496-58ef-9377-0825f4183bc6

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

@@ -3,8 +3,8 @@
  *
  * Provides public bootstrap argument normalization for embedded CLI hosts.
  */
-import { EXECUTABLE_COMMAND_ALIASES, type CliFlagContract } from "./cli-contracts.js";
-export { EXECUTABLE_COMMAND_ALIASES };
+import { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type CliFlagContract, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration } from "./cli-contracts.js";
+export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration, };
 /** Documents the bootstrap global options payload exchanged by command, SDK, and package integrations. */
 export interface BootstrapGlobalOptions {
     /** Filesystem path used for path resolution. */

package/dist/sdk/cli-bootstrap.js

@@ -4,9 +4,9 @@
  * Provides public bootstrap argument normalization for embedded CLI hosts.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="eccdb2d2-da6f-555b-ba1b-8339f9b64f1a")}catch(e){}}();
-import { EXECUTABLE_COMMAND_ALIASES, resolveSubcommandFlagContractsForCommand, } from "./cli-contracts.js";
-export { EXECUTABLE_COMMAND_ALIASES };
+!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]="d45455ca-9496-5b8c-906c-d33d3d890e68")}catch(e){}}();
+import { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, resolveSubcommandFlagContractsForCommand, } from "./cli-contracts.js";
+export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, };
 import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
@@ -895,4 +895,4 @@ export const _testOnly = {
     resolveCanonicalFlag,
 };
 //# sourceMappingURL=cli-bootstrap.js.map
-//# debugId=eccdb2d2-da6f-555b-ba1b-8339f9b64f1a
+//# debugId=d45455ca-9496-5b8c-906c-d33d3d890e68

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

@@ -1,7 +1,39 @@
 /**
  * @module sdk/cli-contracts/command-aliases
  *
- * Defines executable command aliases shared by bootstrap parsing and SDK package scaffolding.
+ * Declares command aliases once so CLI registration, bootstrap parsing,
+ * contracts, completions, and package authors can share one compatibility
+ * policy instead of maintaining parallel spelling lists.
  */
-/** High-frequency executable aliases whose targets accept the same positional and flag contracts. */
+/** Lifecycle policy applied to a command alias. */
+export type PmCommandAliasLifecycle = "permanent" | "deprecated";
+/** Registration mechanism used to preserve an alias invocation. */
+export type PmCommandAliasRegistration = "bootstrap" | "commander";
+/** Machine-readable compatibility contract for one executable command alias. */
+export interface PmCommandAliasContract {
+    /** Legacy or ergonomic spelling accepted at the command root. */
+    alias: string;
+    /** Canonical command path agents should discover and generate. */
+    canonical: string;
+    /** Canonical tokens inserted before user-provided options and arguments. */
+    canonical_argv: readonly string[];
+    /** Whether the alias is permanent ergonomics or migration-only compatibility. */
+    lifecycle: PmCommandAliasLifecycle;
+    /** Whether default help and completion discovery omit the alias. */
+    hidden: boolean;
+    /** Runtime layer that keeps the alias executable. */
+    registration: PmCommandAliasRegistration;
+    /** PM item that owns the compatibility disposition. */
+    owner: string;
+}
+/**
+ * Public command-alias table. Deprecated aliases must remain executable but
+ * are intentionally absent from default help and completion discovery.
+ */
+export declare const PM_COMMAND_ALIAS_CONTRACTS: readonly PmCommandAliasContract[];
+/** High-frequency executable aliases whose targets accept identical arguments. */
 export declare const EXECUTABLE_COMMAND_ALIASES: Readonly<Record<string, string>>;
+/** Resolve one declared command alias without inferring from its spelling. */
+export declare function resolvePmCommandAlias(alias: string): PmCommandAliasContract | undefined;
+/** Render the stable one-line migration hint emitted for deprecated aliases. */
+export declare function renderPmCommandAliasMigrationHint(contract: PmCommandAliasContract): string;

package/dist/sdk/cli-contracts/command-aliases.js

@@ -1,19 +1,70 @@
 /**
  * @module sdk/cli-contracts/command-aliases
  *
- * Defines executable command aliases shared by bootstrap parsing and SDK package scaffolding.
+ * Declares command aliases once so CLI registration, bootstrap parsing,
+ * contracts, completions, and package authors can share one compatibility
+ * policy instead of maintaining parallel spelling lists.
+ */
+/**
+ * Public command-alias table. Deprecated aliases must remain executable but
+ * are intentionally absent from default help and completion discovery.
  */
-/** High-frequency executable aliases whose targets accept the same positional and flag 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]="940f11a8-f40d-5169-ba74-e91920d32c4a")}catch(e){}}();
-export const EXECUTABLE_COMMAND_ALIASES = {
-    fetch: "get",
-    read: "get",
-    show: "get",
-    view: "get",
-    comment: "comments",
-    note: "notes",
-    learning: "learnings",
-};
+!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]="cde15ba9-270e-5e05-baba-7dafbe1bd5da")}catch(e){}}();
+export const PM_COMMAND_ALIAS_CONTRACTS = [
+    ...[
+        ["fetch", "get"],
+        ["read", "get"],
+        ["show", "get"],
+        ["view", "get"],
+        ["comment", "comments"],
+        ["note", "notes"],
+        ["learning", "learnings"],
+    ].map(([alias, canonical]) => ({
+        alias,
+        canonical,
+        canonical_argv: [canonical],
+        lifecycle: "permanent",
+        hidden: false,
+        registration: "bootstrap",
+        owner: "pm-pbyu",
+    })),
+    {
+        alias: "list-all",
+        canonical: "list",
+        canonical_argv: ["list", "--all"],
+        lifecycle: "deprecated",
+        hidden: true,
+        registration: "commander",
+        owner: "pm-pfqi",
+    },
+    ...[
+        ["list-draft", "draft"],
+        ["list-open", "open"],
+        ["list-in-progress", "in_progress"],
+        ["list-blocked", "blocked"],
+        ["list-closed", "closed"],
+        ["list-canceled", "canceled"],
+    ].map(([alias, status]) => ({
+        alias,
+        canonical: "list",
+        canonical_argv: ["list", "--status", status],
+        lifecycle: "deprecated",
+        hidden: true,
+        registration: "commander",
+        owner: "pm-pfqi",
+    })),
+];
+/** High-frequency executable aliases whose targets accept identical arguments. */
+export const EXECUTABLE_COMMAND_ALIASES = Object.fromEntries(PM_COMMAND_ALIAS_CONTRACTS.filter((contract) => contract.registration === "bootstrap").map((contract) => [contract.alias, contract.canonical]));
+/** Resolve one declared command alias without inferring from its spelling. */
+export function resolvePmCommandAlias(alias) {
+    const normalized = alias.trim().toLowerCase();
+    return PM_COMMAND_ALIAS_CONTRACTS.find((contract) => contract.alias === normalized);
+}
+/** Render the stable one-line migration hint emitted for deprecated aliases. */
+export function renderPmCommandAliasMigrationHint(contract) {
+    return `Deprecated command \`${contract.alias}\`; use \`pm ${contract.canonical_argv.join(" ")}\`.`;
+}
 //# sourceMappingURL=command-aliases.js.map
-//# debugId=940f11a8-f40d-5169-ba74-e91920d32c4a
+//# debugId=cde15ba9-270e-5e05-baba-7dafbe1bd5da

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

@@ -46,6 +46,10 @@ export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction> | PmE
  * package verbs are flattened for transports that expose one action string.
  */
 export declare const PM_TOOL_ACTIONS: readonly PmToolAction[];
+/** Deprecated compatibility actions accepted by the SDK but omitted from canonical MCP discovery. */
+export declare const PM_DEPRECATED_TOOL_ACTIONS: readonly PmToolAction[];
+/** Canonical actions presented to MCP clients and unscoped contract consumers. */
+export declare const PM_DISCOVERABLE_TOOL_ACTIONS: readonly PmToolAction[];
 /** Static CLI-to-tool action parity evidence used by quality gates and tests. */
 export declare function analyzePmToolActionParity(cliCommands?: readonly string[], toolActions?: readonly string[], waivers?: Readonly<Record<string, string>>): {
     missing_cli_actions: string[];

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

@@ -4,8 +4,9 @@
  * Defines SDK command-contract metadata for Enum 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]="818ca284-2aaa-5d35-b280-8c963d443b0c")}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]="d05ce92b-bee8-5cce-afc2-8c7901306a30")}catch(e){}}();
 import { KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_SERVICE_NAMES, KNOWN_EXTENSION_TRUST_MODES, } from "../../core/extensions/extension-types.js";
+import { PM_COMMAND_ALIAS_CONTRACTS } from "./command-aliases.js";
 /** Public contract for pm extension capability contracts, shared by SDK and presentation-layer consumers. */
 export const PM_EXTENSION_CAPABILITY_CONTRACTS = [
     ...KNOWN_EXTENSION_CAPABILITIES,
@@ -160,6 +161,12 @@ export const PM_TOOL_ACTIONS = Object.freeze(PM_CORE_COMMAND_NAMES.flatMap((comm
     }
     return [command];
 }));
+/** Deprecated compatibility actions accepted by the SDK but omitted from canonical MCP discovery. */
+export const PM_DEPRECATED_TOOL_ACTIONS = Object.freeze(PM_COMMAND_ALIAS_CONTRACTS.filter((contract) => contract.lifecycle === "deprecated" &&
+    contract.registration === "commander" &&
+    PM_TOOL_ACTIONS.includes(contract.alias)).map((contract) => contract.alias));
+/** Canonical actions presented to MCP clients and unscoped contract consumers. */
+export const PM_DISCOVERABLE_TOOL_ACTIONS = Object.freeze(PM_TOOL_ACTIONS.filter((action) => !PM_DEPRECATED_TOOL_ACTIONS.includes(action)));
 /** Static CLI-to-tool action parity evidence used by quality gates and tests. */
 export function analyzePmToolActionParity(cliCommands = PM_CORE_COMMAND_NAMES, toolActions = PM_TOOL_ACTIONS, waivers = PM_CLI_ONLY_TOOL_ACTION_WAIVERS) {
     const toolActionSet = new Set(toolActions);
@@ -191,4 +198,4 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 //# sourceMappingURL=enum-contracts.js.map
-//# debugId=818ca284-2aaa-5d35-b280-8c963d443b0c
+//# debugId=d05ce92b-bee8-5cce-afc2-8c7901306a30

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

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="c82d9b50-274f-585d-be0e-9a0c5067b9e9")}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]="1d9df714-a6dc-5dc3-b2ff-c9325f91a443")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
 function normalizeFlagAliasKey(flag) {
@@ -136,6 +136,7 @@ export const LIST_FILTER_FLAG_CONTRACTS = withCursorSemantics([
     { flag: "--for", value_name: "intent" },
     { flag: "--token-budget", aliases: ["--token_budget"] },
     { flag: "--status", list: true },
+    { flag: "--all", value_type: "boolean" },
     { flag: "--type", list: true },
     { flag: "--tag", aliases: ["--tags"], list: true },
     { flag: "--priority", list: true },
@@ -1416,6 +1417,7 @@ export const EVENTS_FLAG_CONTRACTS = [
     { flag: "--author", repeatable: true },
     { flag: "--item", repeatable: true },
     { flag: "--limit", value_type: "number" },
+    { flag: "--cursor-mode", value_name: "batch|row" },
     { flag: "--full" },
     { flag: "--provenance" },
     { flag: "--provenance-summary" },
@@ -1636,9 +1638,7 @@ export function toUniqueFlagContracts(contracts) {
 function withSubcommandGlobalFlags(contracts) {
     return withFlagAliasMetadata(toUniqueFlagContracts([...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, ...contracts]));
 }
-const LIST_COMMAND_FLAG_ALIASES = [
-    "list",
-    "list-all",
+const FIXED_STATUS_LIST_COMMAND_ALIASES = [
     "list-draft",
     "list-open",
     "list-in-progress",
@@ -1646,6 +1646,8 @@ const LIST_COMMAND_FLAG_ALIASES = [
     "list-closed",
     "list-canceled",
 ];
+const FIXED_STATUS_LIST_FLAG_CONTRACTS = LIST_FILTER_FLAG_CONTRACTS.filter((contract) => contract.flag !== "--status" && contract.flag !== "--all");
+const ALL_STATUS_LIST_FLAG_CONTRACTS = LIST_FILTER_FLAG_CONTRACTS.filter((contract) => contract.flag !== "--status");
 // Single-token command (plus the `list`/`cal`/`ctx`/`templates` aliases) → its
 // dedicated flag-contract table. Lookups fall back to the subcommand-global set,
 // so tokens absent here (`reindex`, `help`, or any unknown command) degrade to
@@ -1653,9 +1655,11 @@ const LIST_COMMAND_FLAG_ALIASES = [
 // plain object) keeps an untrusted command token from ever resolving an inherited
 // member such as `constructor` or `toString`.
 const SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
-    ...LIST_COMMAND_FLAG_ALIASES.map((command) => [
+    ["list", LIST_FILTER_FLAG_CONTRACTS],
+    ["list-all", ALL_STATUS_LIST_FLAG_CONTRACTS],
+    ...FIXED_STATUS_LIST_COMMAND_ALIASES.map((command) => [
         command,
-        LIST_FILTER_FLAG_CONTRACTS,
+        FIXED_STATUS_LIST_FLAG_CONTRACTS,
     ]),
     ["templates", CREATE_FLAG_CONTRACTS],
     ["cal", CALENDAR_FLAG_CONTRACTS],
@@ -1821,4 +1825,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=c82d9b50-274f-585d-be0e-9a0c5067b9e9
+//# debugId=1d9df714-a6dc-5dc3-b2ff-c9325f91a443

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

@@ -0,0 +1,70 @@
+/**
+ * @module sdk/cli-contracts/grammar-contracts
+ *
+ * Declares and verifies the agent-facing noun–verb grammar. The destination
+ * census is intentionally exact: live command contracts are compared with
+ * this checked-in table in both directions so adding or removing a command
+ * cannot silently bypass the architecture decision.
+ */
+import type { PmCommandAliasContract } from "./command-aliases.js";
+/** Canonical top-level domains an agent must retain to route pm operations. */
+export declare const PM_CLI_GRAMMAR_NOUNS: readonly ["item", "list", "context", "search", "graph", "history", "workspace", "package", "ops", "plan", "contracts", "help"];
+/** Shared verbs whose meaning transfers across domain nouns. */
+export declare const PM_CLI_SHARED_VERBS: readonly ["activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "repair", "restore", "run", "show", "uninstall", "verify"];
+/** Why a current command is permitted while the grammar migration proceeds. */
+export type PmCommandDestinationDisposition = "target_noun" | "consolidation" | "package_owned" | "keep_as_is";
+/** Exact destination decision for one command emitted by runtime contracts. */
+export interface PmCommandDestinationContract {
+    /** Current executable command path. */
+    command: string;
+    /** Canonical noun that owns the capability. */
+    noun: (typeof PM_CLI_GRAMMAR_NOUNS)[number];
+    /** Canonical noun-first invocation or family destination. */
+    target: string;
+    /** Why the current spelling remains in the executable surface. */
+    disposition: PmCommandDestinationDisposition;
+    /** PM item or package identifier owning the disposition. */
+    owner: string;
+    /** Reason required only for a deliberate keep-as-is exception. */
+    reason?: string;
+}
+/** Checked-in exhaustive destination census for core and known package commands. */
+export declare const PM_COMMAND_DESTINATION_CONTRACTS: readonly PmCommandDestinationContract[];
+/** Immutable grammar policy used by contracts and the CI gate. */
+export declare const PM_CLI_GRAMMAR_CONTRACT: {
+    readonly nouns: readonly ["item", "list", "context", "search", "graph", "history", "workspace", "package", "ops", "plan", "contracts", "help"];
+    readonly shared_verbs: readonly ["activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "repair", "restore", "run", "show", "uninstall", "verify"];
+    readonly scope_before_verb: true;
+    readonly visible_top_level_ceiling: 69;
+    readonly ceiling_raise_requires_pm_item: true;
+};
+/** One self-correcting grammar-gate finding. */
+export interface PmCliGrammarFinding {
+    /** Stable diagnostic category suitable for automated remediation. */
+    code: "alias_target_missing" | "duplicate_destination" | "missing_destination" | "stale_destination" | "unknown_noun" | "visible_surface_ceiling_exceeded";
+    /** Exact command or alias spelling that violated the contract. */
+    spelling: string;
+    /** Human-readable explanation of the violated invariant. */
+    message: string;
+    /** Closest canonical invocation or corrective policy action. */
+    nearest_target: string;
+}
+/** Deterministic conformance report for the live command and alias surfaces. */
+export interface PmCliGrammarReport {
+    /** Whether every checked grammar invariant passed. */
+    ok: boolean;
+    /** Number of normalized live command paths evaluated. */
+    command_count: number;
+    /** Number of checked-in destination-census rows. */
+    destination_count: number;
+    /** Number of declared aliases omitted from default discovery. */
+    hidden_alias_count: number;
+    /** Number of distinct visible non-package single-token command paths. */
+    visible_top_level_count: number;
+    /** Maximum visible single-token command paths permitted by the ADR. */
+    visible_top_level_ceiling: number;
+    /** Self-correcting conformance diagnostics, empty when `ok` is true. */
+    findings: PmCliGrammarFinding[];
+}
+/** Verify exhaustive census parity, noun ownership, alias targets, and growth. */
+export declare function verifyPmCliGrammar(commands: readonly string[], aliases?: readonly PmCommandAliasContract[]): PmCliGrammarReport;