@unbrained/pm-cli 2026.10.5 → 2026.10.6

package/.claude-plugin/marketplace.json

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

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 2026.10.6 - 2026-10-06
+
+### Fixed
+
+- GH-1394: Define audited owned-subtree replacement for complete-next settings mutations ([pm-gh1394](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1394.toon))
+- GH-1393: Seed truthful schema-context settings history for linked tests ([pm-gh1393](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1393.toon))
+- GH-1411: Compose amount and token ceilings without stale cursors or skipped rows ([pm-gh1411](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1411.toon))
+- GH-1386: remove conflicting global output projection from get recovery retries ([pm-gh1386](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1386.toon))
+- GH-1408: Reduce omission receipt overhead for explicit scalar field projections ([pm-gh1408](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1408.toon))
+- GH-1409/GH-1410: Preserve declared blocker spelling when resolving imported source IDs ([pm-gh1409](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1409.toon))
+- GH-1398: Preserve bare-help discovery before CLI mutations ([pm-gh1398](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1398.toon))
+- GH-1392: Keep extension diagnostics read-only and resolve npm-managed freshness ([pm-gh1392](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gh1392.toon))
+- PR watch reports success when a mandatory check never reports ([pm-zpwfzy](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-zpwfzy.toon))
+- Verify immutable Codecov assets and authenticated Cloud report uploads ([pm-2x67z9](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-2x67z9.toon))
+
+### Security
+
+- CodeQL 43: keep worker-bridge debug diagnostics free of raw arguments and stderr ([pm-cql43](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-cql43.toon))
+- Dependabot 47 and Scorecard 29: patch indexed source-map offset denial of service ([pm-dba47](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-dba47.toon))
+- Adopt CodeQL 4.38.2 and TruffleHog 3.97.9 immutable scanner updates ([pm-gh1404](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-gh1404.toon))
+
+### Other
+
+- Refresh aged SonarJS 4.2.2 and TypeScript-ESLint 8.71 quality tooling ([pm-l8dzdv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-l8dzdv.toon))
+
 ## 2026.10.5 - 2026-10-05
 
 ### Fixed
@@ -1869,8 +1894,8 @@
 
 ### Other
 
-- Docstring coverage regressed below achieved-100% by PR\#536 extraction files; quality:static floors never ratcheted and mask drift; drop dead closure-pattern export ([pm-fb3i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-fb3i.toon))
 - PR review helper: watch GitHub checks and enforce thread-scoped replies ([pm-0fxa](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-0fxa.toon))
+- Docstring coverage regressed below achieved-100% by PR\#536 extraction files; quality:static floors never ratcheted and mask drift; drop dead closure-pattern export ([pm-fb3i](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-fb3i.toon))
 - Token-budget context packer: diversity-aware selection, projection degradation, and bounded output for pm context/next ([pm-55ra](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-55ra.toon))
 - Complete public linked-resource SDK primitives and actionable dependency governance ([pm-jcvg](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-jcvg.toon))
 

package/dist/cli/register-setup.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ea264d1b-3a21-53d9-89f2-015673b60295")}catch{}})();import fs from"node:fs/promises";import path from"node:path";import{EXIT_CODE,PmCliError,readSettings,resolvePmRoot}from"../sdk/runtime-primitives.js";import{renderPmCommandAliasMigrationHint,resolvePmCommandAlias}from"../sdk/cli-contracts.js";import{collect,getGlobalOptions,printError,printResult,writeStdout}from"./registration-helpers.js";import{runExtension}from"./commands/extension/extension.js";import{SCAFFOLD_CAPABILITIES}from"./commands/extension/scaffold.js";import{renderExtensionDescribeMarkdown}from"./commands/extension/describe.js";import{runConfig}from"./commands/workspace/config.js";import{runInit,summarizeInitResult}from"./commands/workspace/init.js";import{runUpgrade}from"./commands/workspace/upgrade.js";import{inspectStaticExtensionInventory}from"../sdk/extension/static-inventory.js";const LIFECYCLE_DEPRECATION_ALIASES={extension:"extension",package:void 0};async function emitDeprecatedAliasHint(alias,command){if(!alias)return;const aliasContract=resolvePmCommandAlias(alias),globalOptions=getGlobalOptions(command);await readSettings(resolvePmRoot(process.cwd(),globalOptions.path)).then(settings=>settings.ux.deprecation_hints)&&printError(renderPmCommandAliasMigrationHint(aliasContract))}const EXTENSION_ACTION_OPTION_KEYS={init:"init",install:"install",uninstall:"uninstall",explore:"explore",manage:"manage",describe:"describe",reload:"reload",doctor:"doctor",catalog:"catalog",adopt:"adopt","adopt-all":"adoptAll",activate:"activate",deactivate:"deactivate",migrate:"migrate"};function resolveScaffoldCapability(options){const rawCapability=options.capability,values=typeof rawCapability=="string"?[rawCapability]:Array.isArray(rawCapability)?rawCapability.filter(entry=>typeof entry=="string"):[],capabilities=[...new Set(values.map(capability=>capability.trim().toLowerCase()).filter(capability=>capability.length>0))];if(capabilities.length>1)throw new PmCliError(`Multiple scaffold capabilities cannot be combined yet: ${capabilities.join(", ")}. Choose one capability per scaffold.`,EXIT_CODE.USAGE);return capabilities[0]}function normalizeExtensionOptions(options,forcedAction,vocabulary="extension"){const normalizedOptions={...options};forcedAction!==void 0&&(normalizedOptions[EXTENSION_ACTION_OPTION_KEYS[forcedAction]]=!0);const readBoolean=(...keys)=>keys.some(key=>normalizedOptions[key]===!0),readString=(...keys)=>{for(const key of keys)if(typeof normalizedOptions[key]=="string")return normalizedOptions[key]};return{init:readBoolean("init"),scaffold:readBoolean("scaffold"),install:readBoolean("install"),uninstall:readBoolean("uninstall"),explore:readBoolean("explore","list"),manage:readBoolean("manage"),describe:readBoolean("describe"),markdown:readBoolean("markdown"),reload:readBoolean("reload"),doctor:readBoolean("doctor"),catalog:readBoolean("catalog"),adopt:readBoolean("adopt"),adoptAll:readBoolean("adoptAll","adopt_all","adopt-all"),activate:readBoolean("activate"),deactivate:readBoolean("deactivate"),migrate:readBoolean("migrate"),project:readBoolean("project"),local:readBoolean("local"),global:readBoolean("global"),gh:readString("gh"),github:readString("github"),ref:readString("ref"),capability:resolveScaffoldCapability(options),declarative:readBoolean("declarative"),fields:readString("fields"),detail:readString("detail"),output:readString("output"),trace:readBoolean("trace"),watch:readBoolean("watch"),runtimeProbe:readBoolean("runtimeProbe","runtime_probe","runtime-probe"),fixManagedState:readBoolean("fixManagedState","fix_managed_state","fix-managed-state"),isolated:readBoolean("isolated"),ignoreGlobal:readBoolean("ignoreGlobal","ignore_global","ignore-global"),strictExit:readBoolean("strictExit","strict_exit","strict-exit"),failOnWarn:readBoolean("failOnWarn","fail_on_warn","fail-on-warn"),dryRun:readBoolean("dryRun","dry_run","dry-run"),vocabulary}}async function looksLikeShellExpandedWildcard(targets){const visibleEntries=(await fs.readdir(process.cwd())).filter(entry=>!entry.startsWith(".")).sort((left,right)=>left.localeCompare(right)),normalizedTargets=[...targets].sort((left,right)=>left.localeCompare(right));return visibleEntries.length===normalizedTargets.length&&visibleEntries.every((entry,index)=>entry===normalizedTargets[index])}async function normalizeInstallTargets(targets){const normalizedTargets=(targets??[]).map(target=>target.trim()).filter(target=>target.length>0);return normalizedTargets.length<=1?normalizedTargets.length===0?void 0:normalizedTargets:await looksLikeShellExpandedWildcard(normalizedTargets)?["*"]:normalizedTargets}function validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath){const wantsMarkdown=normalizedOptions.markdown===!0;if(outputPath!==void 0&&outputPath==="")throw new PmCliError("--output requires a non-empty file path.",EXIT_CODE.USAGE);if(outputPath!==void 0&&!wantsMarkdown)throw new PmCliError("--output is only supported with --markdown describe output.",EXIT_CODE.USAGE);if(wantsMarkdown){if(globalOptions.json)throw new PmCliError("Cannot combine --json with --markdown.",EXIT_CODE.USAGE);if(normalizedOptions.describe!==!0)throw new PmCliError("--markdown is only supported by the describe action.",EXIT_CODE.USAGE)}}async function emitExtensionMarkdownResult(params){const markdown=renderExtensionDescribeMarkdown(params.result.details,params.vocabulary);if(params.outputPath!==void 0){const resolvedOutputPath=path.resolve(params.outputPath);await fs.mkdir(path.dirname(resolvedOutputPath),{recursive:!0}),await fs.writeFile(resolvedOutputPath,markdown,"utf8")}if(!params.globalOptions.quiet){for(const warning of params.result.warnings)printError(`warning: ${warning}`);params.outputPath===void 0&&writeStdout(markdown)}}function applyExtensionDoctorStrictExit(result,normalizedOptions){const strictExit=!!normalizedOptions.strictExit||!!normalizedOptions.failOnWarn;if(result.action!=="doctor"||!strictExit)return;const detailsRecord=result.details!==null&&typeof result.details=="object"?result.details:{},summary=detailsRecord.summary!==null&&typeof detailsRecord.summary=="object"?detailsRecord.summary:null,summaryStatus=summary&&typeof summary.status=="string"?summary.status:void 0;(result.warnings.length>0||summaryStatus!==void 0&&summaryStatus!=="ok")&&(process.exitCode=EXIT_CODE.GENERIC_FAILURE)}async function executeExtensionCommand(target,options,command,forcedAction,vocabulary="extension"){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedOptions=normalizeExtensionOptions(options,forcedAction,effectiveVocabulary),outputPath=(typeof normalizedOptions.output=="string"?normalizedOptions.output:void 0)?.trim();validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath);const result=await runExtension(target,normalizedOptions,globalOptions);normalizedOptions.markdown===!0?await emitExtensionMarkdownResult({result,vocabulary:effectiveVocabulary,outputPath,globalOptions}):printResult(result,globalOptions),applyExtensionDoctorStrictExit(result,normalizedOptions),result.ok===!1&&(process.exitCode=EXIT_CODE.GENERIC_FAILURE),globalOptions.profile&&printError(`profile:command=extension took_ms=${Date.now()-startedAt}`)}function extractExtensionInstallDetails(result){return result.details!==null&&typeof result.details=="object"?result.details:{}}function serializeExtensionInstallError(error){return error instanceof PmCliError?{message:error.message,exit_code:error.exitCode,...error.context}:{message:error instanceof Error?error.message:String(error),exit_code:EXIT_CODE.GENERIC_FAILURE}}async function runMultiTargetExtensionInstalls(targets,options,globalOptions){const rows=[],warnings=[];let failureExitCode=EXIT_CODE.GENERIC_FAILURE;for(const target of targets)try{const result=await runExtension(target,options,globalOptions),details=extractExtensionInstallDetails(result),targetWarnings=Array.isArray(result.warnings)?result.warnings:[];warnings.push(...targetWarnings);const targetOk=result.ok===!0;rows.push({target,ok:targetOk,extension:details.extension,source:details.source,install_plan:details.install_plan,dry_run:details.dry_run,destination_path:details.destination_path,activated:details.activated,settings_changed:details.settings_changed,command_paths:details.command_paths,action_paths:details.action_paths,runtime_activation_status:details.runtime_activation_status,activation_diagnostics:details.activation_diagnostics,command_discovery:details.command_discovery,verification:details.verification,warnings:targetWarnings,...targetOk?{}:{error:{message:"Extension install returned ok=false without throwing an error.",exit_code:EXIT_CODE.GENERIC_FAILURE,code:"extension_install_soft_failed"}}})}catch(error){const serializedError=serializeExtensionInstallError(error),exitCode=serializedError.exit_code;typeof exitCode=="number"&&failureExitCode===EXIT_CODE.GENERIC_FAILURE&&exitCode!==EXIT_CODE.GENERIC_FAILURE&&(failureExitCode=exitCode),rows.push({target,ok:!1,error:serializedError})}return{rows,warnings,failureExitCode}}async function executeExtensionInstallCommand(targets,options,command,vocabulary){const effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedTargets=await normalizeInstallTargets(targets);if(normalizedTargets===void 0||normalizedTargets.length<=1){await executeExtensionCommand(normalizedTargets?.[0],options,command,"install",effectiveVocabulary);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),normalizedOptions=normalizeExtensionOptions(options,"install",effectiveVocabulary);if(validateExtensionMarkdownOptions(normalizedOptions,globalOptions,void 0),[normalizedOptions.gh,normalizedOptions.github].some(value=>typeof value=="string"&&value.trim().length>0))throw new PmCliError("Multiple install targets cannot be combined with --gh/--github. Install one GitHub source per command, or pass multiple explicit local, bundled, or npm: targets.",EXIT_CODE.USAGE,{code:"multi_target_github_install_ambiguous",required:"Use exactly one positional target with --gh/--github, or omit --gh/--github when installing multiple targets.",examples:["pm install --gh owner/repo","pm install npm:pm-guide-shell pm-todos"]});const{rows,warnings,failureExitCode}=await runMultiTargetExtensionInstalls(normalizedTargets,normalizedOptions,globalOptions),failedCount=rows.filter(row=>row.ok!==!0).length,result={ok:failedCount===0,action:"install",scope:normalizedOptions.global===!0?"global":"project",installed_count:normalizedOptions.dryRun===!0?0:rows.length-failedCount,...normalizedOptions.dryRun===!0?{dry_run:!0,planned_count:rows.length-failedCount}:{},failed_count:failedCount,targets:rows,warnings:[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))};printResult(result,globalOptions),failedCount>0&&(process.exitCode=failureExitCode),globalOptions.profile&&printError(`profile:command=extension took_ms=${Date.now()-startedAt}`)}function addExtensionScopeOptions(command){return command.option("--project","Use project extension scope (default)").option("--local","Alias for --project").option("--global","Use global extension scope")}function addPackageScopeOptions(command){return command.option("--project","Use project package scope (default)").option("--local","Alias for --project").option("--global","Use global package scope")}function addLifecycleScopeOptions(command,vocabulary){return vocabulary==="package"?addPackageScopeOptions(command):addExtensionScopeOptions(command)}function addUpgradeOptions(command){return command.option("--dry-run","Plan CLI/package upgrades without running npm or reinstalling packages").option("--cli-only","Upgrade only the pm CLI/SDK npm package").option("--packages-only","Upgrade only managed pm packages").option("--repair","Force npm global reinstall when upgrading the pm CLI/SDK").option("--tag <value>","npm dist-tag/version for CLI and registry package upgrades").option("--package-name <value>","Override the CLI package name for self-upgrade testing")}async function executeUpgradeCommand(target,command,legacyAlias){const globalOptions=getGlobalOptions(command),startedAt=Date.now();legacyAlias&&await emitDeprecatedAliasHint("upgrade",command);const result=await runUpgrade(target,command.optsWithGlobals(),globalOptions);printResult(result,globalOptions),result.ok||(process.exitCode=EXIT_CODE.GENERIC_FAILURE),globalOptions.profile&&printError(`profile:command=package-upgrade took_ms=${Date.now()-startedAt}`)}function registerLifecycleCommand(program,vocabulary){const noun=vocabulary==="package"?"package":"extension",plural=vocabulary==="package"?"packages":"extensions",commandName=vocabulary,lifecycleCommand=program.command(commandName,{hidden:vocabulary==="extension"}).argument("[target]",`${noun[0].toUpperCase()}${noun.slice(1)} source, name, or scaffold path`).option("--init",`Generate a starter ${noun} scaffold at target path`).option("--scaffold","Alias for --init").option("--capability <kind>","Starter capability for --init (default: commands)",collect).option("--install",`Install a ${noun} source`).option("--dry-run","Preview install without writes or activation").option("--uninstall",`Uninstall an installed ${noun}`).option("--explore",`List discovered ${plural} in selected scope`).option("--list","Alias for --explore").option("--manage",`List managed ${plural} and updates`).option("--describe",`Show surfaces registered by a loaded ${noun}`).option("--markdown","Render describe as Markdown").option("--output <path>","Write Markdown to a file").option("--reload",`Reload ${plural} without import cache`).option("--watch","Use watch mode with --reload").option("--doctor",`Run ${noun} diagnostics`).option("--catalog",`List bundled first-party ${noun} catalog metadata`).option("--adopt",`Adopt unmanaged ${noun}`).option("--adopt-all",`Adopt all unmanaged ${plural}`).option("--activate",`Activate a ${noun} in selected scope settings`).option("--deactivate",`Deactivate a ${noun} in selected scope settings`).option("--project",`Use project ${noun} scope (default)`).option("--local","Alias for --project").option("--global",`Use global ${noun} scope`).option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").option("--detail <mode>",`${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace","Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe","Opt-in runtime activation probe for manage output parity").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).option("--isolated",`Run doctor against project-scope ${plural} only, ignoring global registrations`).option("--ignore-global","Alias for --isolated").option("--strict-exit","Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn","Alias for --strict-exit (doctor)").description(vocabulary==="package"?"Manage package lifecycle in project or global scope.":"Manage extension lifecycle in project or global scope.").action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,void 0,vocabulary)});vocabulary==="package"&&(lifecycleCommand.alias("packages"),lifecycleCommand.option("--declarative","Scaffold the composeExtension blueprint starter (any capability)"));const initCommand=lifecycleCommand.command("init").alias("scaffold").argument("<target>","Scaffold target directory path").option("--capability <kind>",`Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`,collect).description(vocabulary==="package"?"Generate a starter package scaffold with package metadata, manifest, and entrypoint.":"Generate a starter extension scaffold with manifest and entrypoint.");vocabulary==="package"&&initCommand.option("--declarative","Scaffold the composeExtension blueprint starter (any capability)"),addLifecycleScopeOptions(initCommand,vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"init",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("install").option("--dry-run","Resolve sources and estimate copying without destination writes or activation").argument("[targets...]",`${noun[0].toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`).option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`),vocabulary).action(async(targets,_options,command)=>{await executeExtensionInstallCommand(targets,command.optsWithGlobals(),command,vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("uninstall").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Uninstall an installed ${noun}.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"uninstall",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("explore").description(`List discovered ${plural} in selected scope.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"explore",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("inventory").argument("[name]",`${noun[0].toUpperCase()}${noun.slice(1)} name or directory to inspect`).description(`Read configured ${noun} install and enablement state without activating extension code.`),vocabulary).action(async(name,_options,command)=>{const globalOptions=getGlobalOptions(command),options=command.optsWithGlobals();if(options.global===!0&&(options.project===!0||options.local===!0))throw new PmCliError("--global and --project/--local are mutually exclusive.",EXIT_CODE.USAGE);const result=await inspectStaticExtensionInventory({pmRoot:resolvePmRoot(process.cwd(),globalOptions.path),scope:options.global===!0?"global":"project",name});printResult(result,globalOptions),result.complete||(process.exitCode=EXIT_CODE.GENERIC_FAILURE)}),addLifecycleScopeOptions(lifecycleCommand.command("manage").option("--runtime-probe","Opt-in runtime activation probe for manage output parity").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).description(`List managed ${plural} with update-check metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"manage",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]",`${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).option("--markdown","Render the surface map as a Markdown reference document instead of toon/json").option("--output <path>","Write Markdown output to a file (requires --markdown)").description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"describe",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("reload").option("--watch","Use watch mode for repeated reload checks").description(`Reload ${plural} with cache-busted module imports.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"reload",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("doctor").option("--detail <mode>",`Detail mode for ${noun} diagnostics (summary|deep)`).option("--trace","Include actionable registration traces in doctor deep diagnostics").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).option("--isolated",`Run doctor against project-scope ${plural} only, ignoring global registrations`).option("--ignore-global","Alias for --isolated").option("--strict-exit","Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn","Alias for --strict-exit (doctor)").description(`Run consolidated ${noun} diagnostics (summary/deep modes).`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"doctor",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("catalog").alias("list").option("--fields <value>","Render compact comma-separated catalog fields, for example: alias,installed,install_command").description(`List bundled first-party ${noun} catalog metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"catalog",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("adopt").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).option("--gh <owner/repo[/path]>",`GitHub provenance shorthand for adopted ${noun}`).option("--github <owner/repo[/path]>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub shorthand source").description(`Adopt an existing unmanaged ${noun} into managed metadata.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"adopt",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("adopt-all").description(`Adopt all unmanaged ${plural} into managed metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"adopt-all",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("migrate").option("--dry-run","Plan active migrations without invoking extension code").description(`Plan or apply active ${noun} migrations with durable receipts.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"migrate",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("activate").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Activate a ${noun} in selected scope settings.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"activate",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("deactivate").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Deactivate a ${noun} in selected scope settings.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"deactivate",vocabulary)}),vocabulary==="package"&&addUpgradeOptions(addPackageScopeOptions(lifecycleCommand.command("upgrade").argument("[target]","Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async(target,_options,command)=>{await executeUpgradeCommand(target,command,!1)})}async function runInitCommandAction(prefix,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runInit(prefix,globalOptions,{idPrefix:typeof options.idPrefix=="string"?options.idPrefix:void 0,preset:typeof options.preset=="string"?options.preset:void 0,defaults:options.defaults===!0||options.yes===!0,author:typeof options.author=="string"?options.author:void 0,agentGuidance:typeof options.agentGuidance=="string"?options.agentGuidance:void 0,typePreset:typeof options.typePreset=="string"?options.typePreset:void 0,withPackages:options.withPackages===!0,mergeFence:options.mergeFence!==!1,force:options.force===!0,workspace:typeof options.workspace=="string"?options.workspace:void 0}),emitFullTree=options.verbose===!0||globalOptions.json===!0;printResult(emitFullTree?result:summarizeInitResult(result,!0),globalOptions),globalOptions.profile&&printError(`profile:command=init took_ms=${Date.now()-startedAt}`)}function resolveConfigPositionals(scope,action,key,value){const scopeShorthand=scope!==void 0&&new Set(["get","set","list","export"]).has(scope);return{resolvedScope:scopeShorthand?"project":scope??"project",resolvedAction:scopeShorthand?scope:action??"list",resolvedKey:scopeShorthand?action:key,resolvedValue:scopeShorthand?key:value}}function buildConfigOptions(options){return{criterion:Array.isArray(options.criterion)?options.criterion:[],format:typeof options.format=="string"?options.format:void 0,policy:typeof options.policy=="string"?options.policy:void 0,value:typeof options.value=="string"?options.value:void 0,clearCriteria:options.clearCriteria===!0,defaultDepth:typeof options.defaultDepth=="string"?options.defaultDepth:void 0,activityLimit:typeof options.activityLimit=="string"?options.activityLimit:void 0,staleThresholdDays:typeof options.staleThresholdDays=="string"?options.staleThresholdDays:void 0,sectionHierarchy:typeof options.sectionHierarchy=="string"?options.sectionHierarchy:void 0,sectionActivity:typeof options.sectionActivity=="string"?options.sectionActivity:void 0,sectionProgress:typeof options.sectionProgress=="string"?options.sectionProgress:void 0,sectionBlockers:typeof options.sectionBlockers=="string"?options.sectionBlockers:void 0,sectionFiles:typeof options.sectionFiles=="string"?options.sectionFiles:void 0,sectionWorkload:typeof options.sectionWorkload=="string"?options.sectionWorkload:void 0,sectionStaleness:typeof options.sectionStaleness=="string"?options.sectionStaleness:void 0,sectionTests:typeof options.sectionTests=="string"?options.sectionTests:void 0}}async function runConfigCommandAction(scope,action,key,value,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),{resolvedScope,resolvedAction,resolvedKey,resolvedValue}=resolveConfigPositionals(scope,action,key,value),result=await runConfig(resolvedScope,resolvedAction,resolvedKey,buildConfigOptions(options),globalOptions,typeof resolvedValue=="string"?resolvedValue:void 0);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=config took_ms=${Date.now()-startedAt}`)}const _testOnlyRegisterSetup={normalizeExtensionOptions};function registerSetupCommands(program){program.command("init").argument("[prefix-or-path]","Optional id prefix, or path-like tracker target such as ./pm-sandbox").option("--prefix, --id-prefix <value>","Set the item ID prefix (alias for the positional prefix)").option("--preset <value>","Governance preset for new setups: minimal|default|strict").option("--defaults","Use non-interactive setup defaults without opening the wizard").option("-y, --yes","Alias for --defaults (non-interactive setup)").option("--author <value>","Set the default mutation author for this project").option("--agent-guidance <mode>","Agent guidance mode: ask|add|skip|status").option("--type-preset <name>","Register domain item types during init: agile|ops|research").option("--with-packages","Install all bundled first-party packages during initialization").option("--no-merge-fence","Skip automatic merge-driver installation for a fresh Git-backed tracker").option("--workspace <dir>","Initialize repository-local tracker storage at <dir>/.agents/pm").option("--force","Allow initializing tracker files directly in a directory that looks like a workspace root").option("--verbose","Include the full resolved settings tree in the output (default output is a concise summary)").description("Initialize pm storage and defaults for the current workspace or a path-like tracker target.").action(async(prefix,options,command)=>{await runInitCommandAction(prefix,options,command)}),program.command("config").argument("[scope]","Config scope: project|global, or action shorthand list|export|get|set for project scope").argument("[action]","Config action: get|set|list|export").argument("[key]","Config key for get|set; use `pm config project list` for the complete typed inventory, including mutation-guard-* policies").argument("[value]",'Optional value for set: routed to the right typed flag by key (e.g. config set telemetry-tracking off, config set item-format toon, config set definition-of-done "Tests pass"). Equivalent to --policy/--format/--criterion. context keys still require --default-depth/--section-* flags.').option("--criterion <text>","Criteria value for definition-of-done, metadata-required-fields, or lifecycle pattern keys (repeatable for set)",collect).option("--clear-criteria","Clear criteria-list keys for config set operations").option("--format <value>","Item format for item-format key: toon").option("--policy <value>","Policy key values: history-missing-stream-policy=auto_create|strict_error; sprint-release-format-policy=warn|strict_error; parent-reference-policy=warn|strict_error; governance-preset=minimal|default|strict|custom; governance-ownership-enforcement=none|warn|strict; governance-create-mode-default=progressive|strict; governance-close-validation-default=off|warn|strict; governance-require-close-reason=enabled|disabled; governance-parent-reference-policy=warn|strict_error; governance-metadata-validation-profile=core|strict|custom; governance-force-required-for-stale-lock=enabled|disabled; governance-duplicate-detection-mode=off|advisory|strict; test-result-tracking=enabled|disabled; untrusted-linked-test-execution=enabled|disabled; telemetry-tracking=enabled|disabled").option("--value <value>","Typed nested setting value. Mutation guards: require-attributed-author=true|false, secret-guard=off|advise|block, stale-in-progress-hours=integer>=1. Kebab-case is preferred; underscore aliases remain accepted.").option("--default-depth <value>","Context default depth: brief|standard|deep").option("--activity-limit <n>","Context default activity limit").option("--stale-threshold-days <n>","Context staleness cutoff in days").option("--section-hierarchy <value>","Enable/disable context hierarchy section (true|false)").option("--section-activity <value>","Enable/disable context activity section (true|false)").option("--section-progress <value>","Enable/disable context progress section (true|false)").option("--section-blockers <value>","Enable/disable context blockers section (true|false)").option("--section-files <value>","Enable/disable context files section (true|false)").option("--section-workload <value>","Enable/disable context workload section (true|false)").option("--section-staleness <value>","Enable/disable context staleness section (true|false)").option("--section-tests <value>","Enable/disable context tests section (true|false)").description("Read or update pm settings for the current workspace or global profile.").action(async(scope,action,key,value,options,command)=>{await runConfigCommandAction(scope,action,key,value,options,command)}),registerLifecycleCommand(program,"extension"),registerLifecycleCommand(program,"package"),addPackageScopeOptions(program.command("install",{hidden:!0}).option("--dry-run","Resolve sources and estimate copying without destination writes or activation").argument("[targets...]","Package source (local path, bundled alias, npm: source, wildcard, or GitHub source)").option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").description("Install a pm package into the project package scope by default.")).action(async(targets,_options,command)=>{await emitDeprecatedAliasHint("install",command),await executeExtensionInstallCommand(targets,command.optsWithGlobals(),command,"package")}),addUpgradeOptions(addPackageScopeOptions(program.command("upgrade",{hidden:!0}).argument("[target]","Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async(target,_options,command)=>{await executeUpgradeCommand(target,command,!0)})}export{_testOnlyRegisterSetup,registerSetupCommands};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8d53e460-6a3a-5588-b1d2-0078424ff8a6")}catch{}})();import fs from"node:fs/promises";import path from"node:path";import{EXIT_CODE,PmCliError,readSettings,resolvePmRoot}from"../sdk/runtime-primitives.js";import{renderPmCommandAliasMigrationHint,resolvePmCommandAlias}from"../sdk/cli-contracts.js";import{collect,getGlobalOptions,printError,printResult,writeStdout}from"./registration-helpers.js";import{runExtension}from"./commands/extension/extension.js";import{SCAFFOLD_CAPABILITIES}from"./commands/extension/scaffold.js";import{renderExtensionDescribeMarkdown}from"./commands/extension/describe.js";import{runConfig}from"./commands/workspace/config.js";import{runInit,summarizeInitResult}from"./commands/workspace/init.js";import{runUpgrade}from"./commands/workspace/upgrade.js";import{inspectStaticExtensionInventory}from"../sdk/extension/static-inventory.js";const LIFECYCLE_DEPRECATION_ALIASES={extension:"extension",package:void 0};async function emitDeprecatedAliasHint(alias,command){if(!alias)return;const aliasContract=resolvePmCommandAlias(alias),globalOptions=getGlobalOptions(command);await readSettings(resolvePmRoot(process.cwd(),globalOptions.path)).then(settings=>settings.ux.deprecation_hints)&&printError(renderPmCommandAliasMigrationHint(aliasContract))}const EXTENSION_ACTION_OPTION_KEYS={init:"init",install:"install",uninstall:"uninstall",explore:"explore",manage:"manage",describe:"describe",reload:"reload",doctor:"doctor",catalog:"catalog",adopt:"adopt","adopt-all":"adoptAll",activate:"activate",deactivate:"deactivate",migrate:"migrate"};function resolveScaffoldCapability(options){const rawCapability=options.capability,values=typeof rawCapability=="string"?[rawCapability]:Array.isArray(rawCapability)?rawCapability.filter(entry=>typeof entry=="string"):[],capabilities=[...new Set(values.map(capability=>capability.trim().toLowerCase()).filter(capability=>capability.length>0))];if(capabilities.length>1)throw new PmCliError(`Multiple scaffold capabilities cannot be combined yet: ${capabilities.join(", ")}. Choose one capability per scaffold.`,EXIT_CODE.USAGE);return capabilities[0]}function normalizeExtensionOptions(options,forcedAction,vocabulary="extension"){const normalizedOptions={...options};forcedAction!==void 0&&(normalizedOptions[EXTENSION_ACTION_OPTION_KEYS[forcedAction]]=!0);const readBoolean=(...keys)=>keys.some(key=>normalizedOptions[key]===!0),readString=(...keys)=>{for(const key of keys)if(typeof normalizedOptions[key]=="string")return normalizedOptions[key]};return{init:readBoolean("init"),scaffold:readBoolean("scaffold"),install:readBoolean("install"),uninstall:readBoolean("uninstall"),explore:readBoolean("explore","list"),manage:readBoolean("manage"),describe:readBoolean("describe"),markdown:readBoolean("markdown"),reload:readBoolean("reload"),doctor:readBoolean("doctor"),catalog:readBoolean("catalog"),adopt:readBoolean("adopt"),adoptAll:readBoolean("adoptAll","adopt_all","adopt-all"),activate:readBoolean("activate"),deactivate:readBoolean("deactivate"),migrate:readBoolean("migrate"),project:readBoolean("project"),local:readBoolean("local"),global:readBoolean("global"),gh:readString("gh"),github:readString("github"),ref:readString("ref"),capability:resolveScaffoldCapability(options),declarative:readBoolean("declarative"),fields:readString("fields"),detail:readString("detail"),output:readString("output"),trace:readBoolean("trace"),watch:readBoolean("watch"),runtimeProbe:readBoolean("runtimeProbe","runtime_probe","runtime-probe"),offline:readBoolean("offline"),fixManagedState:readBoolean("fixManagedState","fix_managed_state","fix-managed-state"),isolated:readBoolean("isolated"),ignoreGlobal:readBoolean("ignoreGlobal","ignore_global","ignore-global"),strictExit:readBoolean("strictExit","strict_exit","strict-exit"),failOnWarn:readBoolean("failOnWarn","fail_on_warn","fail-on-warn"),dryRun:readBoolean("dryRun","dry_run","dry-run"),vocabulary}}async function looksLikeShellExpandedWildcard(targets){const visibleEntries=(await fs.readdir(process.cwd())).filter(entry=>!entry.startsWith(".")).sort((left,right)=>left.localeCompare(right)),normalizedTargets=[...targets].sort((left,right)=>left.localeCompare(right));return visibleEntries.length===normalizedTargets.length&&visibleEntries.every((entry,index)=>entry===normalizedTargets[index])}async function normalizeInstallTargets(targets){const normalizedTargets=(targets??[]).map(target=>target.trim()).filter(target=>target.length>0);return normalizedTargets.length<=1?normalizedTargets.length===0?void 0:normalizedTargets:await looksLikeShellExpandedWildcard(normalizedTargets)?["*"]:normalizedTargets}function validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath){const wantsMarkdown=normalizedOptions.markdown===!0;if(outputPath!==void 0&&outputPath==="")throw new PmCliError("--output requires a non-empty file path.",EXIT_CODE.USAGE);if(outputPath!==void 0&&!wantsMarkdown)throw new PmCliError("--output is only supported with --markdown describe output.",EXIT_CODE.USAGE);if(wantsMarkdown){if(globalOptions.json)throw new PmCliError("Cannot combine --json with --markdown.",EXIT_CODE.USAGE);if(normalizedOptions.describe!==!0)throw new PmCliError("--markdown is only supported by the describe action.",EXIT_CODE.USAGE)}}async function emitExtensionMarkdownResult(params){const markdown=renderExtensionDescribeMarkdown(params.result.details,params.vocabulary);if(params.outputPath!==void 0){const resolvedOutputPath=path.resolve(params.outputPath);await fs.mkdir(path.dirname(resolvedOutputPath),{recursive:!0}),await fs.writeFile(resolvedOutputPath,markdown,"utf8")}if(!params.globalOptions.quiet){for(const warning of params.result.warnings)printError(`warning: ${warning}`);params.outputPath===void 0&&writeStdout(markdown)}}function applyExtensionDoctorStrictExit(result,normalizedOptions){const strictExit=!!normalizedOptions.strictExit||!!normalizedOptions.failOnWarn;if(result.action!=="doctor"||!strictExit)return;const detailsRecord=result.details!==null&&typeof result.details=="object"?result.details:{},summary=detailsRecord.summary!==null&&typeof detailsRecord.summary=="object"?detailsRecord.summary:null,summaryStatus=summary&&typeof summary.status=="string"?summary.status:void 0;(result.warnings.length>0||summaryStatus!==void 0&&summaryStatus!=="ok")&&(process.exitCode=EXIT_CODE.GENERIC_FAILURE)}async function executeExtensionCommand(target,options,command,forcedAction,vocabulary="extension"){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedOptions=normalizeExtensionOptions(options,forcedAction,effectiveVocabulary),outputPath=(typeof normalizedOptions.output=="string"?normalizedOptions.output:void 0)?.trim();validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath);const result=await runExtension(target,normalizedOptions,globalOptions);normalizedOptions.markdown===!0?await emitExtensionMarkdownResult({result,vocabulary:effectiveVocabulary,outputPath,globalOptions}):printResult(result,globalOptions),applyExtensionDoctorStrictExit(result,normalizedOptions),result.ok===!1&&(process.exitCode=EXIT_CODE.GENERIC_FAILURE),globalOptions.profile&&printError(`profile:command=extension took_ms=${Date.now()-startedAt}`)}function extractExtensionInstallDetails(result){return result.details!==null&&typeof result.details=="object"?result.details:{}}function serializeExtensionInstallError(error){return error instanceof PmCliError?{message:error.message,exit_code:error.exitCode,...error.context}:{message:error instanceof Error?error.message:String(error),exit_code:EXIT_CODE.GENERIC_FAILURE}}async function runMultiTargetExtensionInstalls(targets,options,globalOptions){const rows=[],warnings=[];let failureExitCode=EXIT_CODE.GENERIC_FAILURE;for(const target of targets)try{const result=await runExtension(target,options,globalOptions),details=extractExtensionInstallDetails(result),targetWarnings=Array.isArray(result.warnings)?result.warnings:[];warnings.push(...targetWarnings);const targetOk=result.ok===!0;rows.push({target,ok:targetOk,extension:details.extension,source:details.source,install_plan:details.install_plan,dry_run:details.dry_run,destination_path:details.destination_path,activated:details.activated,settings_changed:details.settings_changed,command_paths:details.command_paths,action_paths:details.action_paths,runtime_activation_status:details.runtime_activation_status,activation_diagnostics:details.activation_diagnostics,command_discovery:details.command_discovery,verification:details.verification,warnings:targetWarnings,...targetOk?{}:{error:{message:"Extension install returned ok=false without throwing an error.",exit_code:EXIT_CODE.GENERIC_FAILURE,code:"extension_install_soft_failed"}}})}catch(error){const serializedError=serializeExtensionInstallError(error),exitCode=serializedError.exit_code;typeof exitCode=="number"&&failureExitCode===EXIT_CODE.GENERIC_FAILURE&&exitCode!==EXIT_CODE.GENERIC_FAILURE&&(failureExitCode=exitCode),rows.push({target,ok:!1,error:serializedError})}return{rows,warnings,failureExitCode}}async function executeExtensionInstallCommand(targets,options,command,vocabulary){const effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedTargets=await normalizeInstallTargets(targets);if(normalizedTargets===void 0||normalizedTargets.length<=1){await executeExtensionCommand(normalizedTargets?.[0],options,command,"install",effectiveVocabulary);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),normalizedOptions=normalizeExtensionOptions(options,"install",effectiveVocabulary);if(validateExtensionMarkdownOptions(normalizedOptions,globalOptions,void 0),[normalizedOptions.gh,normalizedOptions.github].some(value=>typeof value=="string"&&value.trim().length>0))throw new PmCliError("Multiple install targets cannot be combined with --gh/--github. Install one GitHub source per command, or pass multiple explicit local, bundled, or npm: targets.",EXIT_CODE.USAGE,{code:"multi_target_github_install_ambiguous",required:"Use exactly one positional target with --gh/--github, or omit --gh/--github when installing multiple targets.",examples:["pm install --gh owner/repo","pm install npm:pm-guide-shell pm-todos"]});const{rows,warnings,failureExitCode}=await runMultiTargetExtensionInstalls(normalizedTargets,normalizedOptions,globalOptions),failedCount=rows.filter(row=>row.ok!==!0).length,result={ok:failedCount===0,action:"install",scope:normalizedOptions.global===!0?"global":"project",installed_count:normalizedOptions.dryRun===!0?0:rows.length-failedCount,...normalizedOptions.dryRun===!0?{dry_run:!0,planned_count:rows.length-failedCount}:{},failed_count:failedCount,targets:rows,warnings:[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))};printResult(result,globalOptions),failedCount>0&&(process.exitCode=failureExitCode),globalOptions.profile&&printError(`profile:command=extension took_ms=${Date.now()-startedAt}`)}function addExtensionScopeOptions(command){return command.option("--project","Use project extension scope (default)").option("--local","Alias for --project").option("--global","Use global extension scope")}function addPackageScopeOptions(command){return command.option("--project","Use project package scope (default)").option("--local","Alias for --project").option("--global","Use global package scope")}function addLifecycleScopeOptions(command,vocabulary){return vocabulary==="package"?addPackageScopeOptions(command):addExtensionScopeOptions(command)}function addUpgradeOptions(command){return command.option("--dry-run","Plan CLI/package upgrades without running npm or reinstalling packages").option("--cli-only","Upgrade only the pm CLI/SDK npm package").option("--packages-only","Upgrade only managed pm packages").option("--repair","Force npm global reinstall when upgrading the pm CLI/SDK").option("--tag <value>","npm dist-tag/version for CLI and registry package upgrades").option("--package-name <value>","Override the CLI package name for self-upgrade testing")}async function executeUpgradeCommand(target,command,legacyAlias){const globalOptions=getGlobalOptions(command),startedAt=Date.now();legacyAlias&&await emitDeprecatedAliasHint("upgrade",command);const result=await runUpgrade(target,command.optsWithGlobals(),globalOptions);printResult(result,globalOptions),result.ok||(process.exitCode=EXIT_CODE.GENERIC_FAILURE),globalOptions.profile&&printError(`profile:command=package-upgrade took_ms=${Date.now()-startedAt}`)}function registerLifecycleCommand(program,vocabulary){const noun=vocabulary==="package"?"package":"extension",plural=vocabulary==="package"?"packages":"extensions",commandName=vocabulary,lifecycleCommand=program.command(commandName,{hidden:vocabulary==="extension"}).argument("[target]",`${noun[0].toUpperCase()}${noun.slice(1)} source, name, or scaffold path`).option("--init",`Generate a starter ${noun} scaffold at target path`).option("--scaffold","Alias for --init").option("--capability <kind>","Starter capability for --init (default: commands)",collect).option("--install",`Install a ${noun} source`).option("--dry-run","Preview install without writes or activation").option("--uninstall",`Uninstall an installed ${noun}`).option("--explore",`List discovered ${plural} in selected scope`).option("--list","Alias for --explore").option("--manage",`List managed ${plural} and updates`).option("--offline","Skip remote freshness checks during manage").option("--describe",`Show surfaces registered by a loaded ${noun}`).option("--markdown","Render describe as Markdown").option("--output <path>","Write Markdown to a file").option("--reload",`Reload ${plural} without import cache`).option("--watch","Use watch mode with --reload").option("--doctor",`Run ${noun} diagnostics`).option("--catalog",`List bundled first-party ${noun} catalog metadata`).option("--adopt",`Adopt unmanaged ${noun}`).option("--adopt-all",`Adopt all unmanaged ${plural}`).option("--activate",`Activate a ${noun} in selected scope settings`).option("--deactivate",`Deactivate a ${noun} in selected scope settings`).option("--project",`Use project ${noun} scope (default)`).option("--local","Alias for --project").option("--global",`Use global ${noun} scope`).option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").option("--detail <mode>",`${noun[0].toUpperCase()}${noun.slice(1)} diagnostics detail mode (summary|deep)`).option("--trace","Include actionable registration traces in doctor deep diagnostics").option("--runtime-probe","Opt-in runtime activation probe for manage output parity").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).option("--isolated",`Run doctor against project-scope ${plural} only, ignoring global registrations`).option("--ignore-global","Alias for --isolated").option("--strict-exit","Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn","Alias for --strict-exit (doctor)").description(vocabulary==="package"?"Manage package lifecycle in project or global scope.":"Manage extension lifecycle in project or global scope.").action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,void 0,vocabulary)});vocabulary==="package"&&(lifecycleCommand.alias("packages"),lifecycleCommand.option("--declarative","Scaffold the composeExtension blueprint starter (any capability)"));const initCommand=lifecycleCommand.command("init").alias("scaffold").argument("<target>","Scaffold target directory path").option("--capability <kind>",`Capability the starter targets (${SCAFFOLD_CAPABILITIES.join("|")}; default commands)`,collect).description(vocabulary==="package"?"Generate a starter package scaffold with package metadata, manifest, and entrypoint.":"Generate a starter extension scaffold with manifest and entrypoint.");vocabulary==="package"&&initCommand.option("--declarative","Scaffold the composeExtension blueprint starter (any capability)"),addLifecycleScopeOptions(initCommand,vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"init",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("install").option("--dry-run","Resolve sources and estimate copying without destination writes or activation").argument("[targets...]",`${noun[0].toUpperCase()}${noun.slice(1)} source (local path, bundled alias, npm: source, wildcard, or GitHub source)`).option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").description(`Install ${noun} from local path, bundled alias, npm: source, wildcard, or GitHub source.`),vocabulary).action(async(targets,_options,command)=>{await executeExtensionInstallCommand(targets,command.optsWithGlobals(),command,vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("uninstall").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Uninstall an installed ${noun}.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"uninstall",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("explore").description(`List discovered ${plural} in selected scope.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"explore",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("inventory").argument("[name]",`${noun[0].toUpperCase()}${noun.slice(1)} name or directory to inspect`).description(`Read configured ${noun} install and enablement state without activating extension code.`),vocabulary).action(async(name,_options,command)=>{const globalOptions=getGlobalOptions(command),options=command.optsWithGlobals();if(options.global===!0&&(options.project===!0||options.local===!0))throw new PmCliError("--global and --project/--local are mutually exclusive.",EXIT_CODE.USAGE);const result=await inspectStaticExtensionInventory({pmRoot:resolvePmRoot(process.cwd(),globalOptions.path),scope:options.global===!0?"global":"project",name});printResult(result,globalOptions),result.complete||(process.exitCode=EXIT_CODE.GENERIC_FAILURE)}),addLifecycleScopeOptions(lifecycleCommand.command("manage").option("--offline","Skip remote freshness checks and report unknown update availability").option("--runtime-probe","Opt-in runtime activation probe for manage output parity").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).description(`List managed ${plural} with update-check metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"manage",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("describe").argument("[target]",`${noun[0].toUpperCase()}${noun.slice(1)} name to describe (omit for every loaded ${noun})`).option("--markdown","Render the surface map as a Markdown reference document instead of toon/json").option("--output <path>","Write Markdown output to a file (requires --markdown)").description(`Map every surface a loaded ${noun} registers (commands, hooks, item types, providers, overrides, ...).`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"describe",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("reload").option("--watch","Use watch mode for repeated reload checks").description(`Reload ${plural} with cache-busted module imports.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"reload",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("doctor").option("--detail <mode>",`Detail mode for ${noun} diagnostics (summary|deep)`).option("--trace","Include actionable registration traces in doctor deep diagnostics").option("--fix-managed-state",`Adopt unmanaged ${plural} before diagnostics/update checks`).option("--isolated",`Run doctor against project-scope ${plural} only, ignoring global registrations`).option("--ignore-global","Alias for --isolated").option("--strict-exit","Return non-zero exit when doctor warnings are present (ok=false)").option("--fail-on-warn","Alias for --strict-exit (doctor)").description(`Run consolidated ${noun} diagnostics (summary/deep modes).`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"doctor",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("catalog").alias("list").option("--fields <value>","Render compact comma-separated catalog fields, for example: alias,installed,install_command").description(`List bundled first-party ${noun} catalog metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"catalog",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("adopt").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).option("--gh <owner/repo[/path]>",`GitHub provenance shorthand for adopted ${noun}`).option("--github <owner/repo[/path]>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub shorthand source").description(`Adopt an existing unmanaged ${noun} into managed metadata.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"adopt",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("adopt-all").description(`Adopt all unmanaged ${plural} into managed metadata.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"adopt-all",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("migrate").option("--dry-run","Plan active migrations without invoking extension code").description(`Plan or apply active ${noun} migrations with durable receipts.`),vocabulary).action(async(_options,command)=>{await executeExtensionCommand(void 0,command.optsWithGlobals(),command,"migrate",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("activate").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Activate a ${noun} in selected scope settings.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"activate",vocabulary)}),addLifecycleScopeOptions(lifecycleCommand.command("deactivate").argument("<target>",`${noun[0].toUpperCase()}${noun.slice(1)} name`).description(`Deactivate a ${noun} in selected scope settings.`),vocabulary).action(async(target,_options,command)=>{await executeExtensionCommand(target,command.optsWithGlobals(),command,"deactivate",vocabulary)}),vocabulary==="package"&&addUpgradeOptions(addPackageScopeOptions(lifecycleCommand.command("upgrade").argument("[target]","Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async(target,_options,command)=>{await executeUpgradeCommand(target,command,!1)})}async function runInitCommandAction(prefix,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runInit(prefix,globalOptions,{idPrefix:typeof options.idPrefix=="string"?options.idPrefix:void 0,preset:typeof options.preset=="string"?options.preset:void 0,defaults:options.defaults===!0||options.yes===!0,author:typeof options.author=="string"?options.author:void 0,agentGuidance:typeof options.agentGuidance=="string"?options.agentGuidance:void 0,typePreset:typeof options.typePreset=="string"?options.typePreset:void 0,withPackages:options.withPackages===!0,mergeFence:options.mergeFence!==!1,force:options.force===!0,workspace:typeof options.workspace=="string"?options.workspace:void 0}),emitFullTree=options.verbose===!0||globalOptions.json===!0;printResult(emitFullTree?result:summarizeInitResult(result,!0),globalOptions),globalOptions.profile&&printError(`profile:command=init took_ms=${Date.now()-startedAt}`)}function resolveConfigPositionals(scope,action,key,value){const scopeShorthand=scope!==void 0&&new Set(["get","set","list","export"]).has(scope);return{resolvedScope:scopeShorthand?"project":scope??"project",resolvedAction:scopeShorthand?scope:action??"list",resolvedKey:scopeShorthand?action:key,resolvedValue:scopeShorthand?key:value}}function buildConfigOptions(options){return{criterion:Array.isArray(options.criterion)?options.criterion:[],format:typeof options.format=="string"?options.format:void 0,policy:typeof options.policy=="string"?options.policy:void 0,value:typeof options.value=="string"?options.value:void 0,clearCriteria:options.clearCriteria===!0,defaultDepth:typeof options.defaultDepth=="string"?options.defaultDepth:void 0,activityLimit:typeof options.activityLimit=="string"?options.activityLimit:void 0,staleThresholdDays:typeof options.staleThresholdDays=="string"?options.staleThresholdDays:void 0,sectionHierarchy:typeof options.sectionHierarchy=="string"?options.sectionHierarchy:void 0,sectionActivity:typeof options.sectionActivity=="string"?options.sectionActivity:void 0,sectionProgress:typeof options.sectionProgress=="string"?options.sectionProgress:void 0,sectionBlockers:typeof options.sectionBlockers=="string"?options.sectionBlockers:void 0,sectionFiles:typeof options.sectionFiles=="string"?options.sectionFiles:void 0,sectionWorkload:typeof options.sectionWorkload=="string"?options.sectionWorkload:void 0,sectionStaleness:typeof options.sectionStaleness=="string"?options.sectionStaleness:void 0,sectionTests:typeof options.sectionTests=="string"?options.sectionTests:void 0}}async function runConfigCommandAction(scope,action,key,value,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),{resolvedScope,resolvedAction,resolvedKey,resolvedValue}=resolveConfigPositionals(scope,action,key,value),result=await runConfig(resolvedScope,resolvedAction,resolvedKey,buildConfigOptions(options),globalOptions,typeof resolvedValue=="string"?resolvedValue:void 0);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=config took_ms=${Date.now()-startedAt}`)}const _testOnlyRegisterSetup={normalizeExtensionOptions};function registerSetupCommands(program){program.command("init").argument("[prefix-or-path]","Optional id prefix, or path-like tracker target such as ./pm-sandbox").option("--prefix, --id-prefix <value>","Set the item ID prefix (alias for the positional prefix)").option("--preset <value>","Governance preset for new setups: minimal|default|strict").option("--defaults","Use non-interactive setup defaults without opening the wizard").option("-y, --yes","Alias for --defaults (non-interactive setup)").option("--author <value>","Set the default mutation author for this project").option("--agent-guidance <mode>","Agent guidance mode: ask|add|skip|status").option("--type-preset <name>","Register domain item types during init: agile|ops|research").option("--with-packages","Install all bundled first-party packages during initialization").option("--no-merge-fence","Skip automatic merge-driver installation for a fresh Git-backed tracker").option("--workspace <dir>","Initialize repository-local tracker storage at <dir>/.agents/pm").option("--force","Allow initializing tracker files directly in a directory that looks like a workspace root").option("--verbose","Include the full resolved settings tree in the output (default output is a concise summary)").description("Initialize pm storage and defaults for the current workspace or a path-like tracker target.").action(async(prefix,options,command)=>{await runInitCommandAction(prefix,options,command)}),program.command("config").argument("[scope]","Config scope: project|global, or action shorthand list|export|get|set for project scope").argument("[action]","Config action: get|set|list|export").argument("[key]","Config key for get|set; use `pm config project list` for the complete typed inventory, including mutation-guard-* policies").argument("[value]",'Optional value for set: routed to the right typed flag by key (e.g. config set telemetry-tracking off, config set item-format toon, config set definition-of-done "Tests pass"). Equivalent to --policy/--format/--criterion. context keys still require --default-depth/--section-* flags.').option("--criterion <text>","Criteria value for definition-of-done, metadata-required-fields, or lifecycle pattern keys (repeatable for set)",collect).option("--clear-criteria","Clear criteria-list keys for config set operations").option("--format <value>","Item format for item-format key: toon").option("--policy <value>","Policy key values: history-missing-stream-policy=auto_create|strict_error; sprint-release-format-policy=warn|strict_error; parent-reference-policy=warn|strict_error; governance-preset=minimal|default|strict|custom; governance-ownership-enforcement=none|warn|strict; governance-create-mode-default=progressive|strict; governance-close-validation-default=off|warn|strict; governance-require-close-reason=enabled|disabled; governance-parent-reference-policy=warn|strict_error; governance-metadata-validation-profile=core|strict|custom; governance-force-required-for-stale-lock=enabled|disabled; governance-duplicate-detection-mode=off|advisory|strict; test-result-tracking=enabled|disabled; untrusted-linked-test-execution=enabled|disabled; telemetry-tracking=enabled|disabled").option("--value <value>","Typed nested setting value. Mutation guards: require-attributed-author=true|false, secret-guard=off|advise|block, stale-in-progress-hours=integer>=1. Kebab-case is preferred; underscore aliases remain accepted.").option("--default-depth <value>","Context default depth: brief|standard|deep").option("--activity-limit <n>","Context default activity limit").option("--stale-threshold-days <n>","Context staleness cutoff in days").option("--section-hierarchy <value>","Enable/disable context hierarchy section (true|false)").option("--section-activity <value>","Enable/disable context activity section (true|false)").option("--section-progress <value>","Enable/disable context progress section (true|false)").option("--section-blockers <value>","Enable/disable context blockers section (true|false)").option("--section-files <value>","Enable/disable context files section (true|false)").option("--section-workload <value>","Enable/disable context workload section (true|false)").option("--section-staleness <value>","Enable/disable context staleness section (true|false)").option("--section-tests <value>","Enable/disable context tests section (true|false)").description("Read or update pm settings for the current workspace or global profile.").action(async(scope,action,key,value,options,command)=>{await runConfigCommandAction(scope,action,key,value,options,command)}),registerLifecycleCommand(program,"extension"),registerLifecycleCommand(program,"package"),addPackageScopeOptions(program.command("install",{hidden:!0}).option("--dry-run","Resolve sources and estimate copying without destination writes or activation").argument("[targets...]","Package source (local path, bundled alias, npm: source, wildcard, or GitHub source)").option("--gh <github-source>","Install from GitHub shorthand source (owner/repo[/path])").option("--github <github-source>","Alias for --gh").option("--ref <ref>","Git ref/branch/tag for GitHub install sources").description("Install a pm package into the project package scope by default.")).action(async(targets,_options,command)=>{await emitDeprecatedAliasHint("install",command),await executeExtensionInstallCommand(targets,command.optsWithGlobals(),command,"package")}),addUpgradeOptions(addPackageScopeOptions(program.command("upgrade",{hidden:!0}).argument("[target]","Optional managed package name/source to upgrade; omit to upgrade pm CLI and all managed packages").description("Upgrade the pm CLI/SDK and refresh managed installable pm packages."))).action(async(target,_options,command)=>{await executeUpgradeCommand(target,command,!0)})}export{_testOnlyRegisterSetup,registerSetupCommands};
 //# sourceMappingURL=register-setup.js.map

package/dist/cli/runtime/projection-retry.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6dc37841-96fc-5fc6-8c96-6f3b9ce7cde0")}catch{}})();import{parseBootstrapCommandName}from"../../sdk/cli-bootstrap.js";import{LIST_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS}from"../../sdk/cli-contracts/commander-types.js";import{GLOBAL_FLAG_CONTRACTS,resolveSubcommandFlagContractsForCommand}from"../../sdk/cli-contracts/flag-contracts.js";import{renderPmCommand}from"../argv-utils.js";const VALUE_PROJECTION_FLAGS=new Set(["--fields","--depth","--for","--token-budget"]),BOOLEAN_PROJECTION_FLAGS=new Set(["--full","--brief","--compact"]);function consumesFlagValue(contract,valueFlags){return!!(contract.flag==="--pm-path"||contract.value_name||contract.list||contract.value_type==="number"||contract.value_type==="string"||valueFlags.has(contract.flag))}function projectionOptionIndices(argv){const contracts=resolveSubcommandFlagContractsForCommand(parseBootstrapCommandName([...argv])),valueFlags=new Set([...LIST_COMMANDER_STRING_OPTION_CONTRACTS,...SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,...CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS].flatMap(contract=>contract.keys.map(key=>`--${key.replace(/[A-Z]/g,letter=>`-${letter.toLowerCase()}`)}`))),canonical=new Map([...GLOBAL_FLAG_CONTRACTS,...contracts].flatMap(contract=>[contract.flag,...contract.aliases??[]].map(flag=>[flag,contract.flag]))),known=new Map([...GLOBAL_FLAG_CONTRACTS,...contracts].flatMap(contract=>[contract.flag,...contract.aliases??[]].map(flag=>[flag,consumesFlagValue(contract,valueFlags)])));for(const flag of VALUE_PROJECTION_FLAGS)known.set(flag,!0);for(const flag of BOOLEAN_PROJECTION_FLAGS)known.set(flag,!1);const options=new Map;for(let index=0;index<argv.length;index+=1){const token=argv[index];if(token==="--")break;if(!token.startsWith("-"))continue;const flag=token.split("=")[0];if(!known.has(flag)&&!token.includes("="))return;options.set(index,canonical.get(flag)??flag),known.get(flag)&&!token.includes("=")&&(index+=1)}return options}function withoutProjectionFlags(argv,options,flags){const removed=new Set;for(const[index,flag]of options)flags.has(flag)&&(removed.add(index),VALUE_PROJECTION_FLAGS.has(flag)&&!argv[index].includes("=")&&removed.add(index+1));return argv.filter((_,index)=>!removed.has(index))}function withProjectionFlags(argv,additions,position){return argv.splice(position,0,...additions),argv}function selectProjectionRetryMode(options,suggested){const fallback=suggested.find(token=>BOOLEAN_PROJECTION_FLAGS.has(token));if(fallback===void 0)return;const selected=[...new Set(options.values())].filter(flag=>BOOLEAN_PROJECTION_FLAGS.has(flag));return selected.length===1?selected[0]:fallback}function repairProjectionRecovery(argv,code,recovery){if(!recovery||!["unknown_field_projection","projection_options_mutually_exclusive"].includes(code??""))return recovery;const suggested=recovery.suggested_retry_args,ambiguous={...recovery,suggested_retry:void 0,suggested_retry_args:void 0};if(!suggested)return ambiguous;const options=projectionOptionIndices(argv);if(!options)return ambiguous;let corrected;if(code==="unknown_field_projection"){const fieldIndex=suggested.indexOf("--fields");if(fieldIndex<0||suggested[fieldIndex+1]===void 0)return ambiguous;const position=[...options].find(([_,flag])=>flag==="--fields")?.[0]??-1;if(position<0)return ambiguous;corrected=withProjectionFlags(withoutProjectionFlags(argv,options,new Set(["--fields"])),["--fields",suggested[fieldIndex+1]],position)}else{const mode=selectProjectionRetryMode(options,suggested);if(mode===void 0)return ambiguous;const flags=new Set([...VALUE_PROJECTION_FLAGS,...BOOLEAN_PROJECTION_FLAGS]),position=[...options].find(([_,flag])=>flags.has(flag))?.[0]??-1;if(position<0)return ambiguous;corrected=withProjectionFlags(withoutProjectionFlags(argv,options,flags),[mode],position)}return{...recovery,suggested_retry:renderPmCommand(corrected),suggested_retry_args:corrected}}export{repairProjectionRecovery};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0b95b409-ef2c-59da-a628-16a2cb4f0ea6")}catch{}})();import{parseBootstrapCommandName}from"../../sdk/cli-bootstrap.js";import{LIST_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS}from"../../sdk/cli-contracts/commander-types.js";import{GLOBAL_FLAG_CONTRACTS,resolveSubcommandFlagContractsForCommand}from"../../sdk/cli-contracts/flag-contracts.js";import{renderPmCommand}from"../argv-utils.js";const VALUE_PROJECTION_FLAGS=new Set(["--fields","--output-include","--depth","--for","--token-budget"]),BOOLEAN_PROJECTION_FLAGS=new Set(["--full","--brief","--compact"]);function consumesFlagValue(contract,valueFlags){return!!(contract.flag==="--pm-path"||contract.value_name||contract.list||contract.value_type==="number"||contract.value_type==="string"||valueFlags.has(contract.flag))}function projectionOptionIndices(argv){const contracts=resolveSubcommandFlagContractsForCommand(parseBootstrapCommandName([...argv])),valueFlags=new Set([...LIST_COMMANDER_STRING_OPTION_CONTRACTS,...SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,...CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS].flatMap(contract=>contract.keys.map(key=>`--${key.replace(/[A-Z]/g,letter=>`-${letter.toLowerCase()}`)}`))),canonical=new Map([...GLOBAL_FLAG_CONTRACTS,...contracts].flatMap(contract=>[contract.flag,...contract.aliases??[]].map(flag=>[flag,contract.flag]))),known=new Map([...GLOBAL_FLAG_CONTRACTS,...contracts].flatMap(contract=>[contract.flag,...contract.aliases??[]].map(flag=>[flag,consumesFlagValue(contract,valueFlags)])));for(const flag of VALUE_PROJECTION_FLAGS)known.set(flag,!0);for(const flag of BOOLEAN_PROJECTION_FLAGS)known.set(flag,!1);const options=new Map;for(let index=0;index<argv.length;index+=1){const token=argv[index];if(token==="--")break;if(!token.startsWith("-"))continue;const flag=token.split("=")[0];if(!known.has(flag)&&!token.includes("="))return;options.set(index,canonical.get(flag)??flag),known.get(flag)&&!token.includes("=")&&(index+=1)}return options}function withoutProjectionFlags(argv,options,flags){const removed=new Set;for(const[index,flag]of options)flags.has(flag)&&(removed.add(index),VALUE_PROJECTION_FLAGS.has(flag)&&!argv[index].includes("=")&&removed.add(index+1));return argv.filter((_,index)=>!removed.has(index))}function selectProjectionRetryMode(options,suggested){const fallback=suggested.find(token=>BOOLEAN_PROJECTION_FLAGS.has(token));if(fallback===void 0)return;const selected=[...new Set(options.values())].filter(flag=>BOOLEAN_PROJECTION_FLAGS.has(flag));return selected.length===1?selected[0]:fallback}function repairProjectionRecovery(argv,code,recovery){if(!recovery||!["unknown_field_projection","projection_options_mutually_exclusive"].includes(code??""))return recovery;const suggested=recovery.suggested_retry_args,ambiguous={...recovery,suggested_retry:void 0,suggested_retry_args:void 0};if(!suggested)return ambiguous;const options=projectionOptionIndices(argv);if(!options)return ambiguous;let corrected;if(code==="unknown_field_projection"){const fieldIndex=suggested.indexOf("--fields");if(fieldIndex<0||suggested[fieldIndex+1]===void 0)return ambiguous;const position=[...options].find(([_,flag])=>flag==="--fields")?.[0]??-1;if(position<0)return ambiguous;corrected=withoutProjectionFlags(argv,options,new Set(["--fields"])),corrected.splice(position,0,"--fields",suggested[fieldIndex+1])}else{const mode=selectProjectionRetryMode(options,suggested);if(mode===void 0||![...options.values()].includes(mode))return ambiguous;const flags=new Set([...VALUE_PROJECTION_FLAGS,...BOOLEAN_PROJECTION_FLAGS].filter(flag=>flag!==mode));corrected=withoutProjectionFlags(argv,options,flags)}return{...recovery,suggested_retry:renderPmCommand(corrected),suggested_retry_args:corrected}}export{repairProjectionRecovery};
 //# sourceMappingURL=projection-retry.js.map