@unbrained/pm-cli 2026.9.10 → 2026.9.11

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.9.10"
+    "version": "2026.9.11"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.9.10",
+      "version": "2026.9.11",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 2026.9.11 - 2026-09-11
+
+### Added
+
+- Portable integrity attestation: compare recorded history with independently retained proof bundles ([pm-3z0k](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-3z0k.toon))
+
+### Fixed
+
+- The history integrity chain hard-codes SHA-256 with no algorithm identifier, so the proof it produces has no migration path across the decades it claims to cover ([pm-bbk8we](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-bbk8we.toon))
+- Optional undefined result fields silently drop telemetry completion events ([pm-rqaqfp](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-rqaqfp.toon))
+- GH-1229: preserve bounded HTTP process-tree cleanup when POSIX liveness returns EPERM ([pm-qn9zxu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-qn9zxu.toon))
+
+### Other
+
+- Refresh jscpd 5.2 and MCP Apps 2 development contracts ([pm-qs5iiq](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-qs5iiq.toon))
+- Register advanced retrieval as a search facet ([pm-wfskfn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-wfskfn.toon))
+- Consolidate duplicate governance under item operations ([pm-fmy9ih](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-fmy9ih.toon))
+- Declare item copy and workspace merge command destinations ([pm-m6g87m](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-m6g87m.toon))
+- Refresh Sentry 10.74 with history attestation consumer verification ([pm-2us1yv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-2us1yv.toon))
+
 ## 2026.9.10 - 2026-09-10
 
 ### Changed
@@ -160,29 +180,29 @@
 
 ### Fixed
 
+- A read whose result was omitted for budget still records those items as served and included, so the usage-affinity signal learns from context the agent never received ([pm-wv47pf](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-wv47pf.toon))
+- Shape-qualified scale baselines drifted from current CLI/SDK output contracts and supported runtime ([pm-r8yytk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-r8yytk.toon))
 - Context recency is computed from updated_at, so every governance write the project mandates erases the freshness signal it ranks on ([pm-07pt16](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-07pt16.toon))
 
 ### Security
 
 - OSSF Scorecard alert \#29: qs denial-of-service advisories in the MCP Apps development dependency tree ([pm-mlpn91](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-mlpn91.toon))
 
+### Other
+
+- Refresh compatible 2026-09-01 jscpd 5.1.1 tooling ([pm-ur4swu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ur4swu.toon))
+- Refresh Sentry 10.73 and TypeScript-ESLint 8.69 with exact coverage ([pm-92tp12](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-92tp12.toon))
+
 ## 2026.9.2 - 2026-09-02
 
 ### Fixed
 
-- A read whose result was omitted for budget still records those items as served and included, so the usage-affinity signal learns from context the agent never received ([pm-wv47pf](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-wv47pf.toon))
-- Shape-qualified scale baselines drifted from current CLI/SDK output contracts and supported runtime ([pm-r8yytk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-r8yytk.toon))
 - GH-1174: Windows Node 24 receipt traversal negative control must fail closed portably ([pm-r97901](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-r97901.toon))
 
 ### Security
 
 - GH-1173: make merge-receipt evidence diagnostics source-stable and record-addressable ([pm-dn8rwl](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-dn8rwl.toon))
 
-### Other
-
-- Refresh compatible 2026-09-01 jscpd 5.1.1 tooling ([pm-ur4swu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ur4swu.toon))
-- Refresh Sentry 10.73 and TypeScript-ESLint 8.69 with exact coverage ([pm-92tp12](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-92tp12.toon))
-
 ## 2026.9.1 - 2026-09-01
 
 ### Added
@@ -197,6 +217,10 @@
 - GH-1104: health must not certify pending lossless merge receipts as reconciled ([pm-baksix](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-baksix.toon))
 - GH-1135: item_hash_version 2 still masks writer hash divergence as corruption ([pm-2qahia](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2qahia.toon))
 
+### Security
+
+- Refresh compatible GitHub Actions and tsx tooling dependencies ([pm-k47gdd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-k47gdd.toon))
+
 ### Other
 
 - Document the measured canonical agent cold-start across docs and generated guidance ([pm-ka6d](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-ka6d.toon))
@@ -216,10 +240,6 @@
 - The local preflight token-budget gate is red on a workstation and green in hosted CI for the same commit again, because the earlier remediation closed the one ambient channel that had bitten instead of closing the fixture's environment ([pm-4o7tlx](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-4o7tlx.toon))
 - The bounded legacy MCP compatibility set stops one revision short of the spec's own legacy boundary, so every current host is refused at initialize and the dual-era guarantee is unmet ([pm-edywqn](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-edywqn.toon))
 
-### Security
-
-- Refresh compatible GitHub Actions and tsx tooling dependencies ([pm-k47gdd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-k47gdd.toon))
-
 ### Deprecated
 
 - The project's own agent-facing documentation and skills instruct deprecated command spellings, so the alias-usage signal that decides when a spelling can be retired is manufactured by the instructions rather than observed from callers ([pm-q2n4vd](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-q2n4vd.toon))

package/dist/cli/command-namespaces.d.ts

@@ -5,5 +5,5 @@
  * actual node preserves its parser, action closure, flags, and nested verbs.
  */
 import type { Command } from "commander";
-/** Install available namespace leaves after core and package command registration. */
-export declare function installCommandNamespaces(program: Command): void;
+/** Relocate existing handlers; the early pass moves only parents needed by package facets. */
+export declare function installCommandNamespaces(program: Command, parentsOnly?: boolean): void;

package/dist/cli/command-namespaces.js

@@ -1,2 +1,2 @@
-!(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]="294bfda8-e312-58b3-815a-0624fad5dd38")}catch(e2){}})();import{PM_RELOCATED_COMMAND_ALIASES}from"../sdk/cli-contracts/command-aliases.js";function installCommandNamespaces(program){if(!program.commands.some(command=>command.name()==="ops"))program.command("ops").description("Discover workspace diagnostics and maintenance operations.");for(const{alias,canonical_argv:[noun,verb]}of PM_RELOCATED_COMMAND_ALIASES){const sourceIndex=program.commands.findIndex(command=>command.name()===alias);if(sourceIndex<0)continue;const source=program.commands[sourceIndex];const parent=program.commands.find(command=>command.name()===noun)??program.command(noun).description(`Discover ${noun} operations.`);if(parent.commands.some(command=>command.name()===verb)){throw new Error(`Cannot install canonical command ${noun} ${verb}: destination already exists.`)}program.commands.splice(sourceIndex,1);source.name(verb);parent.enablePositionalOptions();parent.addCommand(source)}}export{installCommandNamespaces};
+!(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]="9914cd35-65dc-58f4-8a4d-69cd5d7c6849")}catch(e2){}})();import{PM_RELOCATED_COMMAND_ALIASES}from"../sdk/cli-contracts/command-aliases.js";function installCommandNamespaces(program,parentsOnly=false){if(!program.commands.some(command=>command.name()==="ops"))program.command("ops").description("Discover workspace diagnostics and maintenance operations.");for(const{alias,canonical,canonical_argv:tokens}of PM_RELOCATED_COMMAND_ALIASES){if(parentsOnly&&!PM_RELOCATED_COMMAND_ALIASES.some(entry=>entry.canonical.startsWith(`${canonical} `)))continue;const sourceIndex=program.commands.findIndex(command=>command.name()===alias);if(sourceIndex<0)continue;const source=program.commands[sourceIndex];let parent=program;for(const noun of tokens.slice(0,-1)){if(parent!==program)parent.enablePositionalOptions();parent=parent.commands.find(command=>command.name()===noun)??parent.command(noun).description(`Discover ${noun} operations.`)}const verb=tokens[tokens.length-1];if(parent.commands.some(command=>command.name()===verb)){throw new Error(`Cannot install canonical command ${canonical}: destination already exists.`)}program.commands.splice(sourceIndex,1);source.name(verb);parent.enablePositionalOptions();parent.addCommand(source)}}export{installCommandNamespaces};
 //# sourceMappingURL=command-namespaces.js.map

package/dist/cli/extension-command-help.js

@@ -1,6 +1,6 @@
-!(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]="3c82c125-73b7-5f75-bc3c-3d83d4b7d7f8")}catch(e2){}})();import{Option}from"commander";function normalizeExtensionCommandPath(commandPath){return commandPath.trim().toLowerCase().split(/\s+/).filter(part=>part.length>0).join(" ")}function buildCanonicalExtensionAliases(handlers,definitions){const aliases=new Map;for(const handler of handlers){const alias=normalizeExtensionCommandPath(handler.command);for(const definition of definitions){if(definition.layer!==handler.layer||definition.name!==handler.name){continue}const canonical=normalizeExtensionCommandPath(definition.command);const parts=canonical.split(" ");const action=parts.at(-1);const suffix=parts.slice(1).join(" ");const expectedAlias=suffix?`${parts[0]}-${action} ${suffix}`:`${parts[0]}-${action}`;if(action&&alias===expectedAlias){aliases.set(alias,canonical);break}}}return aliases}function extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalizedMissing,descriptors){if(!commandName||!normalizedMissing){return void 0}let descriptor;let matchedTokenCount=0;for(const[index,token]of invocationArgv.entries()){if(token!==commandName){continue}const commandTokens=invocationArgv.slice(index);for(const[path,candidate]of descriptors.entries()){const pathTokens=path.split(" ");if(pathTokens.length>matchedTokenCount&&pathTokens.every((pathToken,pathIndex)=>commandTokens[pathIndex]===pathToken)){descriptor=candidate;matchedTokenCount=pathTokens.length}}}const flag=descriptor?.flags.find(candidate=>candidate.long===normalizedMissing||candidate.short===normalizedMissing);if(!flag){return void 0}return resolveExtensionFlagArity(flag).takesValue}function toNonEmptyFlagString(value){if(typeof value!=="string"){return null}const trimmed=value.trim();return trimmed.length>0?trimmed:null}function toOptionalBoolean(value){return typeof value==="boolean"?value:void 0}function resolveExtensionFlagArity(definition){const valueType=toNonEmptyFlagString(definition.value_type)??toNonEmptyFlagString(definition.type);const declaredValueName=toNonEmptyFlagString(definition.value_name);const takesValue=valueType!=="boolean"&&(declaredValueName!==null||valueType!==null||toOptionalBoolean(definition.required)===true||toOptionalBoolean(definition.list)===true);return{takesValue,valueName:takesValue?declaredValueName??"value":null}}function formatDynamicExtensionFlagHelpLine(definition){const visible=toOptionalBoolean(definition.visible);if(visible===false){return null}const longName=toNonEmptyFlagString(definition.long);if(!longName||!longName.startsWith("--")||longName.length<3){return null}const shortName=toNonEmptyFlagString(definition.short);const shortPrefix=shortName&&shortName.startsWith("-")&&!shortName.startsWith("--")?`${shortName}, `:"";const valueName=toNonEmptyFlagString(definition.value_name);const valueSuffix=valueName?` <${valueName}>`:"";const description=toNonEmptyFlagString(definition.description)??"Extension-provided option.";const markers=[];if(toOptionalBoolean(definition.required)===true){markers.push("required")}if(toOptionalBoolean(definition.enabled)===false){markers.push("disabled")}const markerSuffix=markers.length>0?` [${markers.join(", ")}]`:"";return`${shortPrefix}${longName}${valueSuffix}  ${description}${markerSuffix}`}function buildDynamicExtensionFlagHelp(definitions){const lines=[...new Set(definitions.map(formatDynamicExtensionFlagHelpLine).filter(line=>line!==null))].sort((left,right)=>left.localeCompare(right));if(lines.length===0){return null}return`
+!(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]="cd9e5ba1-3a9b-5891-8617-9922574872fe")}catch(e2){}})();import{Option}from"commander";import{PM_RELOCATED_COMMAND_ALIASES}from"../sdk/cli-contracts/command-aliases.js";function normalizeExtensionCommandPath(commandPath){return commandPath.trim().toLowerCase().split(/\s+/).filter(part=>part.length>0).join(" ")}function buildCanonicalExtensionAliases(handlers,definitions){const aliases=new Map;for(const handler of handlers){const alias=normalizeExtensionCommandPath(handler.command);for(const definition of definitions){if(definition.layer!==handler.layer||definition.name!==handler.name){continue}const canonical=normalizeExtensionCommandPath(definition.command);const parts=canonical.split(" ");const action=parts.at(-1);const suffix=parts.slice(1).join(" ");const expectedAlias=suffix?`${parts[0]}-${action} ${suffix}`:`${parts[0]}-${action}`;if(action&&alias===expectedAlias){aliases.set(alias,canonical);break}}}return aliases}function extensionFlagTakesValueForInvocation(invocationArgv,commandName,normalizedMissing,descriptors){if(!commandName||!normalizedMissing){return void 0}let descriptor;let matchedTokenCount=0;for(const[index,token]of invocationArgv.entries()){if(token!==commandName){continue}const commandTokens=invocationArgv.slice(index);for(const[path,candidate]of descriptors.entries()){const pathTokens=path.split(" ");if(pathTokens.length>matchedTokenCount&&pathTokens.every((pathToken,pathIndex)=>commandTokens[pathIndex]===pathToken)){descriptor=candidate;matchedTokenCount=pathTokens.length}}}const flag=descriptor?.flags.find(candidate=>candidate.long===normalizedMissing||candidate.short===normalizedMissing);if(!flag){return void 0}return resolveExtensionFlagArity(flag).takesValue}function toNonEmptyFlagString(value){if(typeof value!=="string"){return null}const trimmed=value.trim();return trimmed.length>0?trimmed:null}function toOptionalBoolean(value){return typeof value==="boolean"?value:void 0}function resolveExtensionFlagArity(definition){const valueType=toNonEmptyFlagString(definition.value_type)??toNonEmptyFlagString(definition.type);const declaredValueName=toNonEmptyFlagString(definition.value_name);const takesValue=valueType!=="boolean"&&(declaredValueName!==null||valueType!==null||toOptionalBoolean(definition.required)===true||toOptionalBoolean(definition.list)===true);return{takesValue,valueName:takesValue?declaredValueName??"value":null}}function formatDynamicExtensionFlagHelpLine(definition){const visible=toOptionalBoolean(definition.visible);if(visible===false){return null}const longName=toNonEmptyFlagString(definition.long);if(!longName||!longName.startsWith("--")||longName.length<3){return null}const shortName=toNonEmptyFlagString(definition.short);const shortPrefix=shortName&&shortName.startsWith("-")&&!shortName.startsWith("--")?`${shortName}, `:"";const valueName=toNonEmptyFlagString(definition.value_name);const valueSuffix=valueName?` <${valueName}>`:"";const description=toNonEmptyFlagString(definition.description)??"Extension-provided option.";const markers=[];if(toOptionalBoolean(definition.required)===true){markers.push("required")}if(toOptionalBoolean(definition.enabled)===false){markers.push("disabled")}const markerSuffix=markers.length>0?` [${markers.join(", ")}]`:"";return`${shortPrefix}${longName}${valueSuffix}  ${description}${markerSuffix}`}function buildDynamicExtensionFlagHelp(definitions){const lines=[...new Set(definitions.map(formatDynamicExtensionFlagHelpLine).filter(line=>line!==null))].sort((left,right)=>left.localeCompare(right));if(lines.length===0){return null}return`
 Extension-provided flags:
-  ${lines.join("\n  ")}`}function collectDynamicExtensionFlagHelpByCommand(registrations){const grouped=new Map;for(const registration of registrations){const commandPath=normalizeExtensionCommandPath(registration.target_command);if(commandPath.length===0){continue}const existing=grouped.get(commandPath)??[];existing.push(...registration.flags);grouped.set(commandPath,existing)}const entries=[...grouped.entries()].sort(([left],[right])=>left.localeCompare(right));const helpByCommand=new Map;for(const[commandPath,definitions]of entries){const helpText=buildDynamicExtensionFlagHelp(definitions);if(!helpText){continue}helpByCommand.set(commandPath,helpText)}return helpByCommand}function normalizeExtensionCommandAction(commandPath,action){if(typeof action!=="string"||action.trim().length===0){return commandPath.replace(/\s+/g,"-")}return action.trim().toLowerCase()}function normalizeExtensionCommandStringList(values){if(!Array.isArray(values)){return[]}const normalized=[];const seen=new Set;for(const value of values){if(typeof value!=="string"){continue}const trimmed=value.trim();if(trimmed.length===0||seen.has(trimmed)){continue}seen.add(trimmed);normalized.push(trimmed)}return normalized}function normalizeExtensionCommandArguments(values){if(!Array.isArray(values)){return[]}return values.map(value=>{const name=typeof value.name==="string"?value.name.trim():"";if(name.length===0){return null}const normalized={name,required:value.required===true,variadic:value.variadic===true};if(typeof value.description==="string"&&value.description.trim().length>0){normalized.description=value.description.trim()}return normalized}).filter(entry=>entry!==null)}function collectExtensionDefinitionsByCommand(commandDefinitions){const definitionsByCommand=new Map;for(const definition of commandDefinitions){const commandPath=normalizeExtensionCommandPath(definition.command);if(commandPath.length===0){continue}const description=typeof definition.description==="string"&&definition.description.trim().length>0?definition.description.trim():void 0;const intent=typeof definition.intent==="string"&&definition.intent.trim().length>0?definition.intent.trim():void 0;definitionsByCommand.set(commandPath,{command:commandPath,action:normalizeExtensionCommandAction(commandPath,definition.action),description,intent,examples:normalizeExtensionCommandStringList(definition.examples),failure_hints:normalizeExtensionCommandStringList(definition.failure_hints),arguments:normalizeExtensionCommandArguments(definition.arguments),flags:[],tier:definition.tier??"standard",family:definition.family??"extensions",source:{layer:definition.layer,name:definition.name,package:definition.source_package}})}return definitionsByCommand}function collectExtensionFlagsByCommand(flagRegistrations){const flagsByCommand=new Map;for(const registration of flagRegistrations){const commandPath=normalizeExtensionCommandPath(registration.target_command);if(commandPath.length===0){continue}const existing=flagsByCommand.get(commandPath)??[];existing.push(...registration.flags);flagsByCommand.set(commandPath,existing)}return flagsByCommand}function collectExtensionHelpCommandSet(commandHandlers,definitionsByCommand,flagsByCommand){const commandSet=new Set;for(const commandPath of commandHandlers){const normalized=normalizeExtensionCommandPath(commandPath);if(normalized.length>0){commandSet.add(normalized)}}for(const commandPath of definitionsByCommand.keys()){commandSet.add(commandPath)}for(const commandPath of flagsByCommand.keys()){commandSet.add(commandPath)}return commandSet}function resolveFlattenedAliasDescriptor(commandPath,definitionsByCommand,canonicalAliases){const canonical=canonicalAliases.get(commandPath);return canonical?definitionsByCommand.get(canonical):void 0}function collectExtensionCommandHelpDescriptors(commandHandlers,commandDefinitions,flagRegistrations,canonicalAliases=new Map){const definitionsByCommand=collectExtensionDefinitionsByCommand(commandDefinitions);const flagsByCommand=collectExtensionFlagsByCommand(flagRegistrations);const commandSet=collectExtensionHelpCommandSet(commandHandlers,definitionsByCommand,flagsByCommand);const descriptors=new Map;const sortedCommands=[...commandSet].sort((left,right)=>left.localeCompare(right));for(const commandPath of sortedCommands){const definition=resolveFlattenedAliasDescriptor(commandPath,definitionsByCommand,canonicalAliases)??definitionsByCommand.get(commandPath);const flags=flagsByCommand.get(commandPath)??(definition?flagsByCommand.get(definition.command):void 0)??[];if(definition){descriptors.set(commandPath,{...definition,command:commandPath,flags});continue}descriptors.set(commandPath,{command:commandPath,action:normalizeExtensionCommandAction(commandPath,void 0),examples:[],failure_hints:[],arguments:[],flags,tier:"standard",family:"extensions"})}return descriptors}function buildExtensionArgumentToken(argument){const variadicSuffix=argument.variadic?"...":"";if(argument.required){return`<${argument.name}${variadicSuffix}>`}return`[${argument.name}${variadicSuffix}]`}function applyDynamicExtensionArguments(command,descriptor){for(const argument of descriptor.arguments){command.argument(buildExtensionArgumentToken(argument),argument.description??"Extension argument.")}}function normalizeDynamicExtensionOptionNames(definition){const visible=toOptionalBoolean(definition.visible);if(visible===false){return null}const longName=toNonEmptyFlagString(definition.long);const shortName=toNonEmptyFlagString(definition.short);const normalizedShort=shortName&&shortName.startsWith("-")&&!shortName.startsWith("--")?shortName:null;const normalizedLong=longName&&longName.startsWith("--")&&longName.length>2?longName:null;const optionNames=[normalizedShort,normalizedLong].filter(entry=>entry!==null);return optionNames.length>0?optionNames:null}function formatDynamicExtensionOptionFlags(definition){const optionNames=normalizeDynamicExtensionOptionNames(definition);if(!optionNames){return null}const{valueName}=resolveExtensionFlagArity(definition);const optionValueSuffix=valueName?` <${valueName}>`:"";return`${optionNames.join(", ")}${optionValueSuffix}`}function formatDynamicExtensionParseOptionFlags(definition){const optionNames=normalizeDynamicExtensionOptionNames(definition);if(!optionNames){return null}const{valueName}=resolveExtensionFlagArity(definition);const valueSuffix=valueName?` <${valueName}>`:"";return`${optionNames.join(", ")}${valueSuffix}`}function formatDynamicExtensionOptionDescription(definition){const description=toNonEmptyFlagString(definition.description)??"Extension-provided option.";const markers=[];if(toOptionalBoolean(definition.required)===true){markers.push("required")}if(toOptionalBoolean(definition.enabled)===false){markers.push("disabled")}const markerSuffix=markers.length>0?` [${markers.join(", ")}]`:"";return`${description}${markerSuffix}`}function commandAlreadyHasOption(command,definition){const longName=toNonEmptyFlagString(definition.long);const shortName=toNonEmptyFlagString(definition.short);return command.options.some(option=>{const optionWithNames=option;return longName!==null&&optionWithNames.long===longName||shortName!==null&&optionWithNames.short===shortName})}function applyDynamicExtensionFlagOptions(command,definitions){for(const definition of definitions){if(commandAlreadyHasOption(command,definition)){continue}const flags=formatDynamicExtensionParseOptionFlags(definition);if(!flags){continue}const description=formatDynamicExtensionOptionDescription(definition);if(definition.list!==true){command.option(flags,description);continue}command.addOption(new Option(flags,description).argParser((value,previous=[])=>[...Array.isArray(previous)?previous:[previous],value]))}}function buildResidualDynamicExtensionFlagHelp(command,definitions){return buildDynamicExtensionFlagHelp(definitions.filter(definition=>!commandAlreadyHasOption(command,definition)))}function buildDynamicExtensionHelpOptionSummary(definition){const flags=formatDynamicExtensionOptionFlags(definition);if(!flags){return null}const longName=toNonEmptyFlagString(definition.long);const shortName=toNonEmptyFlagString(definition.short);const normalizedLong=longName&&longName.startsWith("--")&&longName.length>2?longName:null;const normalizedShort=shortName&&shortName.startsWith("-")&&!shortName.startsWith("--")?shortName:null;const{takesValue,valueName}=resolveExtensionFlagArity(definition);const required=toOptionalBoolean(definition.required)===true;return{flags,long:normalizedLong,short:normalizedShort,description:formatDynamicExtensionOptionDescription(definition),takes_value:takesValue,value_required:takesValue,value_name:valueName,variadic:false,required,aliases:[],alias_for:null}}function buildDynamicExtensionHelpOptionSummaries(descriptor){if(!descriptor){return[]}const summaries=[];const seen=new Set;for(const definition of descriptor.flags){const summary=buildDynamicExtensionHelpOptionSummary(definition);if(!summary||seen.has(summary.flags)){continue}seen.add(summary.flags);summaries.push(summary)}return summaries}function mergeHelpOptionSummaries(base,extension){if(extension.length===0){return base}const merged=[...base];const seen=new Set(base.map(entry=>entry.flags));for(const entry of extension){if(seen.has(entry.flags)){continue}seen.add(entry.flags);merged.push(entry)}return merged}function buildDynamicExtensionCommandMetadataHelp(descriptor){const lines=[];if(descriptor.intent){lines.push(`Intent: ${descriptor.intent}`)}if(descriptor.action){lines.push(`Action contract: ${descriptor.action}`)}if(descriptor.examples.length>0){lines.push("Examples:");for(const example of descriptor.examples){lines.push(`  - ${example}`)}}if(descriptor.failure_hints.length>0){lines.push("Common failure hints:");for(const hint of descriptor.failure_hints){lines.push(`  - ${hint}`)}}if(lines.length===0){return null}return`
+  ${lines.join("\n  ")}`}function collectDynamicExtensionFlagHelpByCommand(registrations){const grouped=new Map;for(const registration of registrations){const commandPath=normalizeExtensionCommandPath(registration.target_command);if(commandPath.length===0){continue}const existing=grouped.get(commandPath)??[];existing.push(...registration.flags);grouped.set(commandPath,existing)}const entries=[...grouped.entries()].sort(([left],[right])=>left.localeCompare(right));const helpByCommand=new Map;for(const[commandPath,definitions]of entries){const helpText=buildDynamicExtensionFlagHelp(definitions);if(!helpText){continue}helpByCommand.set(commandPath,helpText)}return helpByCommand}function normalizeExtensionCommandAction(commandPath,action){if(typeof action!=="string"||action.trim().length===0){return commandPath.replace(/\s+/g,"-")}return action.trim().toLowerCase()}function normalizeExtensionCommandStringList(values){if(!Array.isArray(values)){return[]}const normalized=[];const seen=new Set;for(const value of values){if(typeof value!=="string"){continue}const trimmed=value.trim();if(trimmed.length===0||seen.has(trimmed)){continue}seen.add(trimmed);normalized.push(trimmed)}return normalized}function normalizeExtensionCommandArguments(values){if(!Array.isArray(values)){return[]}return values.map(value=>{const name=typeof value.name==="string"?value.name.trim():"";if(name.length===0){return null}const normalized={name,required:value.required===true,variadic:value.variadic===true};if(typeof value.description==="string"&&value.description.trim().length>0){normalized.description=value.description.trim()}return normalized}).filter(entry=>entry!==null)}function collectExtensionDefinitionsByCommand(commandDefinitions){const definitionsByCommand=new Map;for(const definition of commandDefinitions){const commandPath=normalizeExtensionCommandPath(definition.command);if(commandPath.length===0){continue}const description=typeof definition.description==="string"&&definition.description.trim().length>0?definition.description.trim():void 0;const intent=typeof definition.intent==="string"&&definition.intent.trim().length>0?definition.intent.trim():void 0;definitionsByCommand.set(commandPath,{command:commandPath,action:normalizeExtensionCommandAction(commandPath,definition.action),description,intent,examples:normalizeExtensionCommandStringList(definition.examples),failure_hints:normalizeExtensionCommandStringList(definition.failure_hints),arguments:normalizeExtensionCommandArguments(definition.arguments),flags:[],tier:definition.tier??"standard",family:definition.family??"extensions",source:{layer:definition.layer,name:definition.name,package:definition.source_package}})}return definitionsByCommand}function collectExtensionFlagsByCommand(flagRegistrations){const flagsByCommand=new Map;for(const registration of flagRegistrations){const commandPath=normalizeExtensionCommandPath(registration.target_command);if(commandPath.length===0){continue}const existing=flagsByCommand.get(commandPath)??[];existing.push(...registration.flags);flagsByCommand.set(commandPath,existing)}return flagsByCommand}function collectExtensionHelpCommandSet(commandHandlers,definitionsByCommand,flagsByCommand){const commandSet=new Set;for(const commandPath of commandHandlers){const normalized=normalizeExtensionCommandPath(commandPath);if(normalized.length>0){commandSet.add(normalized)}}for(const commandPath of definitionsByCommand.keys()){commandSet.add(commandPath)}for(const commandPath of flagsByCommand.keys()){commandSet.add(commandPath)}return commandSet}function resolveFlattenedAliasDescriptor(commandPath,definitionsByCommand,canonicalAliases){const canonical=canonicalAliases.get(commandPath);return canonical?definitionsByCommand.get(canonical):void 0}function collectExtensionCommandHelpDescriptors(commandHandlers,commandDefinitions,flagRegistrations,canonicalAliases=new Map){const definitionsByCommand=collectExtensionDefinitionsByCommand(commandDefinitions);const flagsByCommand=collectExtensionFlagsByCommand(flagRegistrations);const commandSet=collectExtensionHelpCommandSet(commandHandlers,definitionsByCommand,flagsByCommand);const descriptors=new Map;const sortedCommands=[...commandSet].sort((left,right)=>left.localeCompare(right));for(const commandPath of sortedCommands){const definition=resolveFlattenedAliasDescriptor(commandPath,definitionsByCommand,canonicalAliases)??definitionsByCommand.get(commandPath);const flags=flagsByCommand.get(commandPath)??(definition?flagsByCommand.get(definition.command):void 0)??[];if(definition){descriptors.set(commandPath,{...definition,command:commandPath,flags});continue}descriptors.set(commandPath,{command:commandPath,action:normalizeExtensionCommandAction(commandPath,void 0),examples:[],failure_hints:[],arguments:[],flags,tier:"standard",family:"extensions"})}return descriptors}function buildExtensionArgumentToken(argument){const variadicSuffix=argument.variadic?"...":"";if(argument.required){return`<${argument.name}${variadicSuffix}>`}return`[${argument.name}${variadicSuffix}]`}function applyDynamicExtensionArguments(command,descriptor){for(const argument of descriptor.arguments){command.argument(buildExtensionArgumentToken(argument),argument.description??"Extension argument.")}}function normalizeDynamicExtensionOptionNames(definition){const visible=toOptionalBoolean(definition.visible);if(visible===false){return null}const longName=toNonEmptyFlagString(definition.long);const shortName=toNonEmptyFlagString(definition.short);const normalizedShort=shortName&&shortName.startsWith("-")&&!shortName.startsWith("--")?shortName:null;const normalizedLong=longName&&longName.startsWith("--")&&longName.length>2?longName:null;const optionNames=[normalizedShort,normalizedLong].filter(entry=>entry!==null);return optionNames.length>0?optionNames:null}function formatDynamicExtensionOptionFlags(definition){const optionNames=normalizeDynamicExtensionOptionNames(definition);if(!optionNames){return null}const{valueName}=resolveExtensionFlagArity(definition);const optionValueSuffix=valueName?` <${valueName}>`:"";return`${optionNames.join(", ")}${optionValueSuffix}`}function formatDynamicExtensionParseOptionFlags(definition){const optionNames=normalizeDynamicExtensionOptionNames(definition);if(!optionNames){return null}const{valueName}=resolveExtensionFlagArity(definition);const valueSuffix=valueName?` <${valueName}>`:"";return`${optionNames.join(", ")}${valueSuffix}`}function formatDynamicExtensionOptionDescription(definition){const description=toNonEmptyFlagString(definition.description)??"Extension-provided option.";const markers=[];if(toOptionalBoolean(definition.required)===true){markers.push("required")}if(toOptionalBoolean(definition.enabled)===false){markers.push("disabled")}const markerSuffix=markers.length>0?` [${markers.join(", ")}]`:"";return`${description}${markerSuffix}`}function commandAlreadyHasOption(command,definition){const longName=toNonEmptyFlagString(definition.long);const shortName=toNonEmptyFlagString(definition.short);return command.options.some(option=>{const optionWithNames=option;return longName!==null&&optionWithNames.long===longName||shortName!==null&&optionWithNames.short===shortName})}function applyDynamicExtensionFlagOptions(command,definitions){for(const definition of definitions){if(commandAlreadyHasOption(command,definition)){continue}const flags=formatDynamicExtensionParseOptionFlags(definition);if(!flags){continue}const description=formatDynamicExtensionOptionDescription(definition);const option=new Option(flags,description);option.negate=false;if(definition.list!==true){command.addOption(option);continue}command.addOption(option.argParser((value,previous=[])=>[...Array.isArray(previous)?previous:[previous],value]))}}function buildResidualDynamicExtensionFlagHelp(command,definitions){return buildDynamicExtensionFlagHelp(definitions.filter(definition=>!commandAlreadyHasOption(command,definition)))}function buildDynamicExtensionHelpOptionSummary(definition){const flags=formatDynamicExtensionOptionFlags(definition);if(!flags){return null}const longName=toNonEmptyFlagString(definition.long);const shortName=toNonEmptyFlagString(definition.short);const normalizedLong=longName&&longName.startsWith("--")&&longName.length>2?longName:null;const normalizedShort=shortName&&shortName.startsWith("-")&&!shortName.startsWith("--")?shortName:null;const{takesValue,valueName}=resolveExtensionFlagArity(definition);const required=toOptionalBoolean(definition.required)===true;return{flags,long:normalizedLong,short:normalizedShort,description:formatDynamicExtensionOptionDescription(definition),takes_value:takesValue,value_required:takesValue,value_name:valueName,variadic:false,required,aliases:[],alias_for:null}}function buildDynamicExtensionHelpOptionSummaries(descriptor){if(!descriptor){return[]}const summaries=[];const seen=new Set;for(const definition of descriptor.flags){const summary=buildDynamicExtensionHelpOptionSummary(definition);if(!summary||seen.has(summary.flags)){continue}seen.add(summary.flags);summaries.push(summary)}return summaries}function mergeHelpOptionSummaries(base,extension){if(extension.length===0){return base}const merged=[...base];const seen=new Set(base.map(entry=>entry.flags));for(const entry of extension){if(seen.has(entry.flags)){continue}seen.add(entry.flags);merged.push(entry)}return merged}function buildDynamicExtensionCommandMetadataHelp(descriptor){const lines=[];if(descriptor.intent){lines.push(`Intent: ${descriptor.intent}`)}if(descriptor.action){lines.push(`Action contract: ${descriptor.action}`)}if(descriptor.examples.length>0){lines.push("Examples:");for(const example of descriptor.examples){lines.push(`  - ${example}`)}}if(descriptor.failure_hints.length>0){lines.push("Common failure hints:");for(const hint of descriptor.failure_hints){lines.push(`  - ${hint}`)}}if(lines.length===0){return null}return`
 Extension command metadata:
-  ${lines.join("\n  ")}`}function commandAliases(command){const commandRecord=command;if(typeof commandRecord.aliases==="function"){return commandRecord.aliases().map(value=>value.trim().toLowerCase()).filter(value=>value.length>0)}if(typeof commandRecord.alias==="function"){const alias=commandRecord.alias();if(typeof alias==="string"&&alias.trim().length>0){return[alias.trim().toLowerCase()]}}if(Array.isArray(commandRecord._aliases)){return commandRecord._aliases.map(value=>value.trim().toLowerCase()).filter(value=>value.length>0)}return[]}function findDirectChildCommand(parent,name){const normalizedTarget=name.trim().toLowerCase();return parent.commands.find(entry=>{if(entry.name().trim().toLowerCase()===normalizedTarget){return true}return commandAliases(entry).includes(normalizedTarget)})??null}function findCommandByPath(root,pathParts){let current=root;for(const part of pathParts){const next=findDirectChildCommand(current,part);if(!next){return null}current=next}return current}const extensionCreatedCommands=new WeakSet;function ensureCommandPath(root,pathParts){if(pathParts.length===0){return null}let current=root;for(let index=0;index<pathParts.length;index+=1){const part=pathParts[index];const existing=findDirectChildCommand(current,part);if(existing){current=existing;continue}const created=current.command(part);extensionCreatedCommands.add(created);if(index<pathParts.length-1){created.description("Extension-provided command group.");created.action(()=>{created.help()})}else{created.description("Extension-provided command path.")}current=created}return current}function findExtensionCommandPathCollision(root,pathParts){let current=root;const traversed=[];for(const part of pathParts){const existing=findDirectChildCommand(current,part);if(!existing){return null}traversed.push(part);if(!extensionCreatedCommands.has(existing)){return{core_path:traversed.join(" "),extension_path:pathParts.join(" ")}}current=existing}return null}function buildExtensionCommandCollisionWarning(root,commandPath,aliases,descriptor){const pathParts=commandPath.split(" ").filter(part=>part.length>0);const collision=findExtensionCommandPathCollision(root,pathParts);if(!collision||collision.core_path===commandPath&&!aliases.has(commandPath)){return null}const extensionOwner=descriptor?.source?.package??descriptor?.source?.name??"unknown-extension";return`extension_command_collision:${collision.extension_path}:core_owner=pm-cli:${collision.core_path}:extension_owner=${extensionOwner}`}function collectSafeExtensionCommandPaths(root,commandHandlers,descriptors,aliases,onCollision){return[...new Set([...commandHandlers,...descriptors.keys()])].filter(commandPath=>commandPath.trim().length>0).sort((left,right)=>left.localeCompare(right)).filter(commandPath=>{const warning=buildExtensionCommandCollisionWarning(root,commandPath,aliases,descriptors.get(commandPath));if(!warning)return true;onCollision(warning);return false})}function reportExtensionCommandCollision(activationWarnings,report,warning){activationWarnings.push(warning);report(`[pm] warning: ${warning}; core command preserved. Rename or namespace the extension command alias.`)}export{applyDynamicExtensionArguments,applyDynamicExtensionFlagOptions,buildCanonicalExtensionAliases,buildDynamicExtensionCommandMetadataHelp,buildDynamicExtensionHelpOptionSummaries,buildExtensionCommandCollisionWarning,buildResidualDynamicExtensionFlagHelp,collectDynamicExtensionFlagHelpByCommand,collectExtensionCommandHelpDescriptors,collectSafeExtensionCommandPaths,commandAliases,ensureCommandPath,extensionFlagTakesValueForInvocation,findCommandByPath,findDirectChildCommand,findExtensionCommandPathCollision,mergeHelpOptionSummaries,normalizeExtensionCommandPath,reportExtensionCommandCollision,resolveExtensionFlagArity};
+  ${lines.join("\n  ")}`}function commandAliases(command){const commandRecord=command;if(typeof commandRecord.aliases==="function"){return commandRecord.aliases().map(value=>value.trim().toLowerCase()).filter(value=>value.length>0)}if(typeof commandRecord.alias==="function"){const alias=commandRecord.alias();if(typeof alias==="string"&&alias.trim().length>0){return[alias.trim().toLowerCase()]}}if(Array.isArray(commandRecord._aliases)){return commandRecord._aliases.map(value=>value.trim().toLowerCase()).filter(value=>value.length>0)}return[]}function findDirectChildCommand(parent,name){const normalizedTarget=name.trim().toLowerCase();return parent.commands.find(entry=>{if(entry.name().trim().toLowerCase()===normalizedTarget){return true}return commandAliases(entry).includes(normalizedTarget)})??null}function findCommandByPath(root,pathParts){let current=root;for(const part of pathParts){const next=findDirectChildCommand(current,part);if(!next){return null}current=next}return current}const extensionCreatedCommands=new WeakSet;function ensureCommandPath(root,pathParts){if(pathParts.length===0){return null}let current=root;for(let index=0;index<pathParts.length;index+=1){const part=pathParts[index];if(index>0&&PM_RELOCATED_COMMAND_ALIASES.some(entry=>entry.canonical===pathParts.join(" ")))current.enablePositionalOptions();const existing=findDirectChildCommand(current,part);if(existing){current=existing;continue}const created=current.command(part);extensionCreatedCommands.add(created);if(index<pathParts.length-1){created.description("Extension-provided command group.");created.action(()=>{created.help()})}else{created.description("Extension-provided command path.")}current=created}return current}function findExtensionCommandPathCollision(root,pathParts){let current=root;const traversed=[];for(const part of pathParts){const existing=findDirectChildCommand(current,part);if(!existing){return null}traversed.push(part);if(!extensionCreatedCommands.has(existing)){return{core_path:traversed.join(" "),extension_path:pathParts.join(" ")}}current=existing}return null}function buildExtensionCommandCollisionWarning(root,commandPath,aliases,descriptor){const pathParts=commandPath.split(" ").filter(part=>part.length>0);const collision=findExtensionCommandPathCollision(root,pathParts);const declaredFacet=PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.canonical===commandPath&&alias.alias===descriptor?.action);if(!collision||collision.core_path===commandPath&&!aliases.has(commandPath)||declaredFacet&&!aliases.has(commandPath)){return null}const extensionOwner=descriptor?.source?.package??descriptor?.source?.name??"unknown-extension";return`extension_command_collision:${collision.extension_path}:core_owner=pm-cli:${collision.core_path}:extension_owner=${extensionOwner}`}function collectSafeExtensionCommandPaths(root,commandHandlers,descriptors,aliases,onCollision){return[...new Set([...commandHandlers,...descriptors.keys()])].filter(commandPath=>commandPath.trim().length>0).sort((left,right)=>left.localeCompare(right)).filter(commandPath=>{const warning=buildExtensionCommandCollisionWarning(root,commandPath,aliases,descriptors.get(commandPath));if(!warning)return true;onCollision(warning);return false})}function reportExtensionCommandCollision(activationWarnings,report,warning){activationWarnings.push(warning);report(`[pm] warning: ${warning}; core command preserved. Rename or namespace the extension command alias.`)}export{applyDynamicExtensionArguments,applyDynamicExtensionFlagOptions,buildCanonicalExtensionAliases,buildDynamicExtensionCommandMetadataHelp,buildDynamicExtensionHelpOptionSummaries,buildExtensionCommandCollisionWarning,buildResidualDynamicExtensionFlagHelp,collectDynamicExtensionFlagHelpByCommand,collectExtensionCommandHelpDescriptors,collectSafeExtensionCommandPaths,commandAliases,ensureCommandPath,extensionFlagTakesValueForInvocation,findCommandByPath,findDirectChildCommand,findExtensionCommandPathCollision,mergeHelpOptionSummaries,normalizeExtensionCommandPath,reportExtensionCommandCollision,resolveExtensionFlagArity};
 //# sourceMappingURL=extension-command-help.js.map

package/dist/cli/main.d.ts

@@ -92,7 +92,9 @@ declare function handleGenericRunPmCliError(params: {
         commandResolution: TelemetryCommandResolution;
     }>;
 }): Promise<void>;
+/** Separate handler options from global controls, then validate and coerce contributed flags against the command's declared schema. */
 declare function extractCommandScopedOptions(command: Command, commandArgs: string[], extensionFlagDefinitions?: LooseCommandFlagDefinition[]): Record<string, unknown>;
+/** Join contributed flags by stable operation identity so canonical and compatibility command paths share the same schema. */
 declare function collectExtensionFlagDefinitionsForCommand(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, commandPath: string): FlagDefinition[];
 declare function collectExtensionFlagDefinitionsForInvocation(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, commandPath: string, commandArgs: string[]): FlagDefinition[];
 /**
@@ -134,7 +136,9 @@ declare function hasGlobalExtensionContributions(contributions: NonNullable<Exte
 /** Resolve an exact activation verdict from declared commands and contributions. */
 declare function resolveStaticExtensionActivationDecision(extension: ExtensionDiscoveryResult["effective"][number], probe: RuntimeExtensionActivationProbe): boolean | undefined;
 declare function extensionNeedsActivationForProbe(extension: ExtensionDiscoveryResult["effective"][number], probe: RuntimeExtensionActivationProbe): boolean;
+/** Decide whether installed providers must activate for a targeted invocation or complete command discovery. */
 declare function discoveryNeedsActivationForProbe(discovery: ExtensionDiscoveryResult, probe: RuntimeExtensionActivationProbe): boolean;
+/** Build a deterministic activation scope; completion and unconstrained discovery include every installed command provider. */
 declare function buildRuntimeExtensionActivationScope(probe: RuntimeExtensionActivationProbe): string;
 declare function buildRuntimeExtensionFilterForProbe(probe: RuntimeExtensionActivationProbe): ((extension: ExtensionDiscoveryResult["effective"][number]) => boolean) | undefined;
 declare function buildBootstrapActivationProbe(invocationArgv: string[]): RuntimeExtensionActivationProbe;