@unbrained/pm-cli 2026.10.4 → 2026.10.5

package/dist/cli/register-setup.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]="1261f2a8-b56d-5108-a130-abb46bbab3ac")}catch(e2){}})();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);const globalOptions=getGlobalOptions(command);const deprecationHints=await readSettings(resolvePmRoot(process.cwd(),globalOptions.path)).then(settings=>settings.ux.deprecation_hints);if(deprecationHints){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;const values=typeof rawCapability==="string"?[rawCapability]:Array.isArray(rawCapability)?rawCapability.filter(entry=>typeof entry==="string"):[];const 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};if(forcedAction!==void 0){normalizedOptions[EXTENSION_ACTION_OPTION_KEYS[forcedAction]]=true}const readBoolean=(...keys)=>keys.some(key=>normalizedOptions[key]===true);const readString=(...keys)=>{for(const key of keys){if(typeof normalizedOptions[key]==="string"){return normalizedOptions[key]}}return void 0};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));const 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);if(normalizedTargets.length<=1){return normalizedTargets.length===0?void 0:normalizedTargets}if(await looksLikeShellExpandedWildcard(normalizedTargets)){return["*"]}return normalizedTargets}function validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath){const wantsMarkdown=normalizedOptions.markdown===true;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){return}if(globalOptions.json){throw new PmCliError("Cannot combine --json with --markdown.",EXIT_CODE.USAGE)}if(normalizedOptions.describe!==true){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:true});await fs.writeFile(resolvedOutputPath,markdown,"utf8")}if(params.globalOptions.quiet){return}for(const warning of params.result.warnings){printError(`warning: ${warning}`)}if(params.outputPath===void 0){writeStdout(markdown)}}function applyExtensionDoctorStrictExit(result,normalizedOptions){const strictExit=Boolean(normalizedOptions.strictExit)||Boolean(normalizedOptions.failOnWarn);if(result.action!=="doctor"||!strictExit){return}const detailsRecord=result.details!==null&&typeof result.details==="object"?result.details:{};const summary=detailsRecord.summary!==null&&typeof detailsRecord.summary==="object"?detailsRecord.summary:null;const summaryStatus=summary&&typeof summary.status==="string"?summary.status:void 0;const shouldFail=result.warnings.length>0||summaryStatus!==void 0&&summaryStatus!=="ok";if(shouldFail){process.exitCode=EXIT_CODE.GENERIC_FAILURE}}async function executeExtensionCommand(target,options,command,forcedAction,vocabulary="extension"){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const effectiveVocabulary=vocabulary==="extension"?"package":vocabulary;await emitDeprecatedAliasHint(LIFECYCLE_DEPRECATION_ALIASES[vocabulary],command);const normalizedOptions=normalizeExtensionOptions(options,forcedAction,effectiveVocabulary);const outputOption=typeof normalizedOptions.output==="string"?normalizedOptions.output:void 0;const outputPath=outputOption?.trim();validateExtensionMarkdownOptions(normalizedOptions,globalOptions,outputPath);const result=await runExtension(target,normalizedOptions,globalOptions);if(normalizedOptions.markdown===true){await emitExtensionMarkdownResult({result,vocabulary:effectiveVocabulary,outputPath,globalOptions})}else{printResult(result,globalOptions)}applyExtensionDoctorStrictExit(result,normalizedOptions);if(result.ok===false){process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(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){if(error instanceof PmCliError){return{message:error.message,exit_code:error.exitCode,...error.context}}return{message:error instanceof Error?error.message:String(error),exit_code:EXIT_CODE.GENERIC_FAILURE}}async function runMultiTargetExtensionInstalls(targets,options,globalOptions){const rows=[];const warnings=[];let failureExitCode=EXIT_CODE.GENERIC_FAILURE;for(const target of targets){try{const result=await runExtension(target,options,globalOptions);const details=extractExtensionInstallDetails(result);const targetWarnings=Array.isArray(result.warnings)?result.warnings:[];warnings.push(...targetWarnings);const targetOk=result.ok===true;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);const exitCode=serializedError.exit_code;if(typeof exitCode==="number"&&failureExitCode===EXIT_CODE.GENERIC_FAILURE&&exitCode!==EXIT_CODE.GENERIC_FAILURE){failureExitCode=exitCode}rows.push({target,ok:false,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);const startedAt=Date.now();const normalizedOptions=normalizeExtensionOptions(options,"install",effectiveVocabulary);validateExtensionMarkdownOptions(normalizedOptions,globalOptions,void 0);const hasForcedGithubSource=[normalizedOptions.gh,normalizedOptions.github].some(value=>typeof value==="string"&&value.trim().length>0);if(hasForcedGithubSource){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);const failedCount=rows.filter(row=>row.ok!==true).length;const result={ok:failedCount===0,action:"install",scope:normalizedOptions.global===true?"global":"project",installed_count:normalizedOptions.dryRun===true?0:rows.length-failedCount,...normalizedOptions.dryRun===true?{dry_run:true,planned_count:rows.length-failedCount}:{},failed_count:failedCount,targets:rows,warnings:[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))};printResult(result,globalOptions);if(failedCount>0){process.exitCode=failureExitCode}if(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);const startedAt=Date.now();if(legacyAlias){await emitDeprecatedAliasHint("upgrade",command)}const result=await runUpgrade(target,command.optsWithGlobals(),globalOptions);printResult(result,globalOptions);if(!result.ok){process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=package-upgrade took_ms=${Date.now()-startedAt}`)}}function registerLifecycleCommand(program,vocabulary){const noun=vocabulary==="package"?"package":"extension";const plural=vocabulary==="package"?"packages":"extensions";const commandName=vocabulary;const 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)});if(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.");if(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);const options=command.optsWithGlobals();if(options.global===true&&(options.project===true||options.local===true)){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===true?"global":"project",name});printResult(result,globalOptions);if(!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)});if(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,false)})}}async function runInitCommandAction(prefix,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const 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===true||options.yes===true,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===true,mergeFence:options.mergeFence!==false,force:options.force===true,workspace:typeof options.workspace==="string"?options.workspace:void 0});const verbose=options.verbose===true;const emitFullTree=verbose||globalOptions.json===true;printResult(emitFullTree?result:summarizeInitResult(result,true),globalOptions);if(globalOptions.profile){printError(`profile:command=init took_ms=${Date.now()-startedAt}`)}}function resolveConfigPositionals(scope,action,key,value){const actionShorthands=new Set(["get","set","list","export"]);const scopeShorthand=scope!==void 0&&actionShorthands.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===true,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);const startedAt=Date.now();const{resolvedScope,resolvedAction,resolvedKey,resolvedValue}=resolveConfigPositionals(scope,action,key,value);const result=await runConfig(resolvedScope,resolvedAction,resolvedKey,buildConfigOptions(options),globalOptions,typeof resolvedValue==="string"?resolvedValue:void 0);printResult(result,globalOptions);if(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:true}).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:true}).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,true)})}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]="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};
 //# sourceMappingURL=register-setup.js.map

package/dist/cli/register-structured-mutation.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]="19b15a00-6395-566f-9b09-4aeb4084c10c")}catch(e2){}})();import{createStdinTokenResolver,EXIT_CODE,PmCliError,readSettings,resolveAuthor,resolvePmRoot}from"../sdk/runtime-primitives.js";import{buildItemCompletionMutations,commitItemCompletion,commitItemMutations,previewItemMutations}from"../sdk/item-transaction.js";import{runReopen}from"../sdk/lifecycle/reopen.js";import{parseAtomicMutationControls,resolveItemMutationDocument}from"../sdk/structured-mutations.js";import{collect,getGlobalOptions,invalidateSearchCachesForMutation,printResult}from"./registration-helpers.js";async function runItemReopenAction(id,reason,options,command){const globalOptions=getGlobalOptions(command);const result=await runReopen(id,reason,{status:typeof options.status==="string"?options.status:void 0,author:typeof options.author==="string"?options.author:globalOptions.author,message:typeof options.message==="string"?options.message:void 0,force:options.force===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions)}async function runItemMutateAction(options,command){const globalOptions=getGlobalOptions(command);const input=await createStdinTokenResolver().resolveValue("-","--stdin-json");if(input===void 0||input.trim().length===0){throw new PmCliError("pm item mutate requires a non-empty JSON batch on stdin.",EXIT_CODE.USAGE)}const transactionId=typeof options.transactionId==="string"?options.transactionId.trim():"";if(transactionId.length===0){throw new PmCliError("pm item mutate requires --transaction-id <value>.",EXIT_CODE.USAGE)}const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const settings=await readSettings(pmRoot);const resolved=resolveItemMutationDocument(input,{transactionId,idPrefix:settings.id_prefix});const{mutations,references}=resolved;const controls=parseAtomicMutationControls(options);const author=resolveAuthor(typeof options.author==="string"?options.author:globalOptions.author,settings.author_default);if(options.dryRun===true){const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:true,validation,mutation_count:mutations.length,mutations,references},globalOptions);return}const result=await commitItemMutations({pmRoot,transactionId,author,mutations,...controls});printResult({...result,mutation_count:mutations.length,references},globalOptions)}function resolveCompletionReason(positionalReason,optionReason){if(typeof positionalReason==="string"&&positionalReason.trim().length>0){return positionalReason.trim()}return typeof optionReason==="string"?optionReason.trim():""}async function runItemCompleteAction(id,positionalReason,options,command){const globalOptions=getGlobalOptions(command);const transactionId=typeof options.transactionId==="string"?options.transactionId.trim():"";if(transactionId.length===0){throw new PmCliError("pm item complete requires --transaction-id <value>.",EXIT_CODE.USAGE)}const reason=resolveCompletionReason(positionalReason,options.reason);if(reason.length===0){throw new PmCliError("pm item complete requires a close reason.",EXIT_CODE.USAGE)}const evidenceKeys=["file","doc","test","comment","note","learning"];const evidence=Object.fromEntries(evidenceKeys.filter(key=>options[key]!==void 0).map(key=>[key,options[key]]));const force=options.force===true;const{lockTtlSeconds,lockWaitMs}=parseAtomicMutationControls(options);const closeOptions={...typeof options.resolution==="string"?{resolution:options.resolution}:{},...typeof options.expectedResult==="string"?{expectedResult:options.expectedResult}:{},...typeof options.actualResult==="string"?{actualResult:options.actualResult}:{},...typeof options.completedAt==="string"?{completedAt:options.completedAt}:{},...typeof options.validateClose==="string"?{validateClose:options.validateClose}:{},...force?{force:true}:{}};const completion={id,reason,...Object.keys(evidence).length===0?{}:{evidence},...Object.keys(closeOptions).length===0?{}:{closeOptions},...force?{releaseOptions:{force:true}}:{}};const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const author=resolveAuthor(typeof options.author==="string"?options.author:globalOptions.author,(await readSettings(pmRoot)).author_default);if(options.dryRun===true){const mutations=buildItemCompletionMutations(completion);const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:true,validation,mutation_count:mutations.length,mutations},globalOptions);return}const result=await commitItemCompletion({pmRoot,transactionId,author,...completion,lockTtlSeconds,lockWaitMs});printResult({...result,mutation_count:Object.keys(result.results).length},globalOptions)}function registerStructuredMutationCommands(program){const itemCommand=program.commands.find(command=>command.name()==="item")??program.command("item").description("Run item lifecycle operations.");itemCommand.command("reopen <id> <reason>").option("--status <value>","Active target status: open or in_progress").option("--message <value>","Human-readable recurrence history message").option("--force","Override ownership or stale-lock conflicts").option("--author <value>","Mutation author").description("Reopen terminal work with recurrence evidence.").action(runItemReopenAction);itemCommand.command("mutate").requiredOption("--transaction-id <value>","Stable idempotency key used to resume an interrupted batch").option("--stdin-json","Read the JSON mutation array from stdin",true).option("--dry-run","Validate and preview the batch without writing").option("--create-compensation <mode>","Created-item compensation policy: close or delete","close").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--author <value>","Mutation author").description("Apply SDK-backed mutations atomically.").action(runItemMutateAction);itemCommand.command("complete <id> [reason]").requiredOption("--transaction-id <value>","Stable idempotency key for the composed completion").option("--reason <value>","Close reason when omitted positionally").option("--file <value>","Linked file evidence",collect).option("--doc <value>","Linked documentation evidence",collect).option("--test <value>","Linked test evidence",collect).option("--comment <value>","Evidence comment",collect).option("--note <value>","Completion note",collect).option("--learning <value>","Durable completion learning",collect).option("--resolution <value>","Structured resolution evidence").option("--expected-result <value>","Expected result evidence").option("--actual-result <value>","Actual result evidence").option("--completed-at <value>","Actual completion time").option("--validate-close <mode>","Close validation: off, warn, or strict").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--dry-run","Validate and preview completion without writing").option("--force","Override lifecycle and ownership conflicts").option("--author <value>","Completion author").description("Close with evidence and release the claim.").action(runItemCompleteAction)}const structuredMutationTestOnly={runItemCompleteAction,runItemMutateAction,runItemReopenAction};export{registerStructuredMutationCommands,structuredMutationTestOnly};
+(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]="5e4ef16a-2514-5b22-b271-c98501736e55")}catch{}})();import{createStdinTokenResolver,EXIT_CODE,PmCliError,readSettings,resolveAuthor,resolvePmRoot}from"../sdk/runtime-primitives.js";import{buildItemCompletionMutations,commitItemCompletion,commitItemMutations,previewItemMutations}from"../sdk/item-transaction.js";import{runReopen}from"../sdk/lifecycle/reopen.js";import{parseAtomicMutationControls,resolveItemMutationDocument}from"../sdk/structured-mutations.js";import{collect,getGlobalOptions,invalidateSearchCachesForMutation,printResult}from"./registration-helpers.js";async function runItemReopenAction(id,reason,options,command){const globalOptions=getGlobalOptions(command),result=await runReopen(id,reason,{status:typeof options.status=="string"?options.status:void 0,author:typeof options.author=="string"?options.author:globalOptions.author,message:typeof options.message=="string"?options.message:void 0,force:options.force===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions)}async function runItemMutateAction(options,command){const globalOptions=getGlobalOptions(command),input=await createStdinTokenResolver().resolveValue("-","--stdin-json");if(input===void 0||input.trim().length===0)throw new PmCliError("pm item mutate requires a non-empty JSON batch on stdin.",EXIT_CODE.USAGE);const transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item mutate requires --transaction-id <value>.",EXIT_CODE.USAGE);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),settings=await readSettings(pmRoot),resolved=resolveItemMutationDocument(input,{transactionId,idPrefix:settings.id_prefix}),{mutations,references}=resolved,controls=parseAtomicMutationControls(options),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,settings.author_default);if(options.dryRun===!0){const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations,references},globalOptions);return}const result=await commitItemMutations({pmRoot,transactionId,author,mutations,...controls});printResult({...result,mutation_count:mutations.length,references},globalOptions)}function resolveCompletionReason(positionalReason,optionReason){return typeof positionalReason=="string"&&positionalReason.trim().length>0?positionalReason.trim():typeof optionReason=="string"?optionReason.trim():""}async function runItemCompleteAction(id,positionalReason,options,command){const globalOptions=getGlobalOptions(command),transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item complete requires --transaction-id <value>.",EXIT_CODE.USAGE);const reason=resolveCompletionReason(positionalReason,options.reason);if(reason.length===0)throw new PmCliError("pm item complete requires a close reason.",EXIT_CODE.USAGE);const evidence=Object.fromEntries(["file","doc","test","comment","note","learning"].filter(key=>options[key]!==void 0).map(key=>[key,options[key]])),force=options.force===!0,{lockTtlSeconds,lockWaitMs}=parseAtomicMutationControls(options),closeOptions={...typeof options.resolution=="string"?{resolution:options.resolution}:{},...typeof options.expectedResult=="string"?{expectedResult:options.expectedResult}:{},...typeof options.actualResult=="string"?{actualResult:options.actualResult}:{},...typeof options.completedAt=="string"?{completedAt:options.completedAt}:{},...typeof options.validateClose=="string"?{validateClose:options.validateClose}:{},...force?{force:!0}:{}},completion={id,reason,...Object.keys(evidence).length===0?{}:{evidence},...Object.keys(closeOptions).length===0?{}:{closeOptions},...force?{releaseOptions:{force:!0}}:{}},pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,(await readSettings(pmRoot)).author_default);if(options.dryRun===!0){const mutations=buildItemCompletionMutations(completion),validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations},globalOptions);return}const result=await commitItemCompletion({pmRoot,transactionId,author,...completion,lockTtlSeconds,lockWaitMs});printResult({...result,mutation_count:Object.keys(result.results).length},globalOptions)}function registerStructuredMutationCommands(program){const itemCommand=program.commands.find(command=>command.name()==="item")??program.command("item").description("Run item lifecycle operations.");itemCommand.command("reopen <id> <reason>").option("--status <value>","Active target status: open or in_progress").option("--message <value>","Human-readable recurrence history message").option("--force","Override ownership or stale-lock conflicts").option("--author <value>","Mutation author").description("Reopen terminal work with recurrence evidence.").action(runItemReopenAction),itemCommand.command("mutate").requiredOption("--transaction-id <value>","Stable idempotency key used to resume an interrupted batch").option("--stdin-json","Read the JSON mutation array from stdin",!0).option("--dry-run","Validate and preview the batch without writing").option("--create-compensation <mode>","Created-item compensation policy: close or delete","close").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--author <value>","Mutation author").description("Apply SDK-backed mutations atomically.").action(runItemMutateAction),itemCommand.command("complete <id> [reason]").requiredOption("--transaction-id <value>","Stable idempotency key for the composed completion").option("--reason <value>","Close reason when omitted positionally").option("--file <value>","Linked file evidence",collect).option("--doc <value>","Linked documentation evidence",collect).option("--test <value>","Linked test evidence",collect).option("--comment <value>","Evidence comment",collect).option("--note <value>","Completion note",collect).option("--learning <value>","Durable completion learning",collect).option("--resolution <value>","Structured resolution evidence").option("--expected-result <value>","Expected result evidence").option("--actual-result <value>","Actual result evidence").option("--completed-at <value>","Actual completion time").option("--validate-close <mode>","Close validation: off, warn, or strict").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--dry-run","Validate and preview completion without writing").option("--force","Override lifecycle and ownership conflicts").option("--author <value>","Completion author").description("Close with evidence and release the claim.").action(runItemCompleteAction)}const structuredMutationTestOnly={runItemCompleteAction,runItemMutateAction,runItemReopenAction};export{registerStructuredMutationCommands,structuredMutationTestOnly};
 //# sourceMappingURL=register-structured-mutation.js.map

package/dist/cli/registration-helpers.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]="a269ae22-2e52-5b3d-aa53-cafd0a5d3062")}catch(e2){}})();export*from"../sdk/cli-contracts/registration-helpers.js";
+(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]="a269ae22-2e52-5b3d-aa53-cafd0a5d3062")}catch{}})();export*from"../sdk/cli-contracts/registration-helpers.js";
 //# sourceMappingURL=registration-helpers.js.map

package/dist/cli/runtime/activation.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]="697f96fe-38a0-5530-b54b-22cb442c130f")}catch(e2){}})();import{resolvePmCommandOperation}from"../../sdk/cli-contracts/command-aliases.js";import{parseBootstrapHelpRequest,stripGlobalBootstrapTokens}from"../bootstrap-args.js";import{normalizeExtensionCommandPath}from"../extension-command-help.js";import{getCommandPath}from"../registration-helpers.js";function collectLeadingCommandArgs(commandArgs){const leading=[];for(const arg of commandArgs??[]){if(arg.startsWith("-")){break}const normalized=normalizeExtensionCommandPath(arg);if(normalized.length===0){continue}leading.push(normalized)}return leading}function collectActivationCommandCandidates(probe){const commandPath=normalizeExtensionCommandPath(probe.commandPath??"");if(commandPath.length===0){return[]}const candidates=[commandPath];const parts=commandPath.split(" ").filter(part=>part.length>0);for(const arg of collectLeadingCommandArgs(probe.commandArgs)){parts.push(...arg.split(" ").filter(part=>part.length>0));candidates.push(parts.join(" "))}return[...new Set(candidates.flatMap(candidate=>[candidate,resolvePmCommandOperation(candidate)]))]}function activationCommandMatchesProbe(command,probe){const normalized=normalizeExtensionCommandPath(command);if(normalized.length===0){return false}const candidates=collectActivationCommandCandidates(probe);for(const candidate of candidates){if(candidate===normalized||candidate.startsWith(`${normalized} `)){return true}}if(probe.allowCommandPrefixMatch===true){return candidates.some(candidate=>normalized.startsWith(`${candidate} `))}return false}function extensionActivationCommands(extension){const explicitCommands=extension.activation?.commands;if(explicitCommands){return explicitCommands}const contributions=extension.contributions;if(!contributions){return[]}return[...entriesOrEmpty(contributions.commands),...entriesOrEmpty(contributions.command_handlers),...entriesOrEmpty(contributions.command_overrides),...entriesOrEmpty(contributions.flag_commands),...entriesOrEmpty(contributions.parser_overrides),...ownershipCommands(contributions.preflight_ownership),...ownershipCommands(contributions.renderer_ownership)]}function entriesOrEmpty(entries){return entries??[]}function ownershipCommands(entries){return entriesOrEmpty(entries).flatMap(entry=>entry.commands)}function extensionCapabilities(extension){return new Set((extension.capabilities??[]).map(capability=>capability.trim().toLowerCase()))}const GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES=new Set(["hooks","parser","preflight","renderers"]);const CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES=new Set(["commands","schema","services","importers"]);const SEARCH_EXTENSION_ACTIVATION_COMMANDS=new Set(["reindex","search","search-advanced"]);const CREATE_TEMPLATE_FLAGS=new Set(["--template"]);function hasAnyCapability(capabilities,expected){for(const capability of expected){if(capabilities.has(capability)){return true}}return false}function commandPathNeedsSearchExtensions(commandPath){const normalized=normalizeExtensionCommandPath(commandPath??"");if(normalized.length===0){return false}const[topLevel]=normalized.split(" ");return SEARCH_EXTENSION_ACTIVATION_COMMANDS.has(topLevel??normalized)}function probeUsesAnyFlag(probe,flags){for(const arg of probe.commandArgs??[]){if(!arg.startsWith("--")){continue}const[flagName]=arg.split("=",1);if(flags.has(flagName)){return true}}return false}function commandPathNeedsTemplateExtensions(probe){return normalizeExtensionCommandPath(probe.commandPath??"")==="create"&&probeUsesAnyFlag(probe,CREATE_TEMPLATE_FLAGS)}function extensionProvidesTemplatesRuntime(commands){return commands.some(command=>{const normalized=normalizeExtensionCommandPath(command);return normalized==="templates"||normalized.startsWith("templates ")})}function matchesStaticExtensionCommand(commands,probe){return commands.some(command=>activationCommandMatchesProbe(command,probe))||commandPathNeedsTemplateExtensions(probe)&&extensionProvidesTemplatesRuntime(commands)}function hasGlobalExtensionContributions(contributions){const contributionCounts=[entriesOrEmpty(contributions.hooks).length,(contributions.preflight_overrides??0)-entriesOrEmpty(contributions.preflight_ownership).length,entriesOrEmpty(contributions.item_types).length,entriesOrEmpty(contributions.item_fields).length,entriesOrEmpty(contributions.relationship_kinds).length,entriesOrEmpty(contributions.service_overrides).length,entriesOrEmpty(contributions.assurance_providers).length,entriesOrEmpty(contributions.renderer_overrides).length-entriesOrEmpty(contributions.renderer_ownership).length];return contributionCounts.some(count=>count>0)}function resolveStaticExtensionActivationDecision(extension,probe){const explicitCommands=extension.activation?.commands??[];if(explicitCommands.length>0){return matchesStaticExtensionCommand(explicitCommands,probe)}const commands=extensionActivationCommands(extension);if(matchesStaticExtensionCommand(commands,probe))return true;if(extensionCapabilities(extension).has("search")&&commandPathNeedsSearchExtensions(probe.commandPath)){return true}if(extension.contributions){return hasGlobalExtensionContributions(extension.contributions)}return void 0}function extensionNeedsActivationForProbe(extension,probe){const staticDecision=resolveStaticExtensionActivationDecision(extension,probe);if(staticDecision!==void 0)return staticDecision;const capabilities=extensionCapabilities(extension);if(hasAnyCapability(capabilities,GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)){return true}if(hasAnyCapability(capabilities,CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES)){return true}return false}function discoveryNeedsActivationForProbe(discovery,probe){if(discovery.effective.length===0){return false}const hasCommandProbe=buildRuntimeExtensionActivationScope(probe)!=="all";if(!hasCommandProbe){return discovery.effective.some(extension=>{const capabilities=extensionCapabilities(extension);return extensionActivationCommands(extension).length>0||hasAnyCapability(capabilities,GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)||hasAnyCapability(capabilities,CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES)||capabilities.has("search")})}return discovery.effective.some(extension=>extensionNeedsActivationForProbe(extension,probe))}function buildRuntimeExtensionActivationScope(probe){if(normalizeExtensionCommandPath(probe.commandPath??"").split(" ")[0]==="completion"){return"all"}const commandPath=collectActivationCommandCandidates(probe).filter(candidate=>candidate.split(" ").every(part=>!part.startsWith("-"))).sort((left,right)=>right.length-left.length)[0]??normalizeExtensionCommandPath(probe.commandPath??"");if(commandPath.length===0){return"all"}const args=commandPathNeedsTemplateExtensions(probe)?"--template":"";const prefix=probe.allowCommandPrefixMatch===true?"prefix":"exact";return`${prefix}:${commandPath}:${args}`}function buildRuntimeExtensionFilterForProbe(probe){return buildRuntimeExtensionActivationScope(probe)==="all"?void 0:extension=>extensionNeedsActivationForProbe(extension,probe)}function buildBootstrapActivationProbe(invocationArgv){const helpRequest=parseBootstrapHelpRequest(invocationArgv);if(helpRequest.requested&&helpRequest.commandPathTokens.length>0){const[commandPath,...commandArgs]=helpRequest.commandPathTokens;return{commandPath,commandArgs,allowCommandPrefixMatch:true}}const stripped=stripGlobalBootstrapTokens(invocationArgv);const commandIndex=stripped.findIndex(token=>token.trim().length>0&&!token.startsWith("-"));if(commandIndex<0){return{}}return{commandPath:stripped[commandIndex],commandArgs:stripped.slice(commandIndex+1),allowCommandPrefixMatch:helpRequest.requested}}function collectParsedActivationCommandArgs(command){const commandArgs=command.args.map(String);const commandPath=normalizeExtensionCommandPath(getCommandPath(command));if(commandPath==="create"){const options=command.optsWithGlobals();if(typeof options.template==="string"&&options.template.trim().length>0){commandArgs.push("--template")}}return commandArgs}export{activationCommandMatchesProbe,buildBootstrapActivationProbe,buildRuntimeExtensionActivationScope,buildRuntimeExtensionFilterForProbe,collectActivationCommandCandidates,collectLeadingCommandArgs,collectParsedActivationCommandArgs,commandPathNeedsSearchExtensions,commandPathNeedsTemplateExtensions,discoveryNeedsActivationForProbe,extensionActivationCommands,extensionCapabilities,extensionNeedsActivationForProbe,extensionProvidesTemplatesRuntime,hasAnyCapability,hasGlobalExtensionContributions,matchesStaticExtensionCommand,probeUsesAnyFlag,resolveStaticExtensionActivationDecision};
+(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]="c0826cb1-5181-51b3-9ad9-0cd7a3d2c4b3")}catch{}})();import{resolvePmCommandOperation}from"../../sdk/cli-contracts/command-aliases.js";import{parseBootstrapHelpRequest,stripGlobalBootstrapTokens}from"../bootstrap-args.js";import{normalizeExtensionCommandPath}from"../extension-command-help.js";import{getCommandPath}from"../registration-helpers.js";function collectLeadingCommandArgs(commandArgs){const leading=[];for(const arg of commandArgs??[]){if(arg.startsWith("-"))break;const normalized=normalizeExtensionCommandPath(arg);normalized.length!==0&&leading.push(normalized)}return leading}function collectActivationCommandCandidates(probe){const commandPath=normalizeExtensionCommandPath(probe.commandPath??"");if(commandPath.length===0)return[];const candidates=[commandPath],parts=commandPath.split(" ").filter(part=>part.length>0);for(const arg of collectLeadingCommandArgs(probe.commandArgs))parts.push(...arg.split(" ").filter(part=>part.length>0)),candidates.push(parts.join(" "));return[...new Set(candidates.flatMap(candidate=>[candidate,resolvePmCommandOperation(candidate)]))]}function activationCommandMatchesProbe(command,probe){const normalized=normalizeExtensionCommandPath(command);if(normalized.length===0)return!1;const candidates=collectActivationCommandCandidates(probe);for(const candidate of candidates)if(candidate===normalized||candidate.startsWith(`${normalized} `))return!0;return probe.allowCommandPrefixMatch===!0?candidates.some(candidate=>normalized.startsWith(`${candidate} `)):!1}function extensionActivationCommands(extension){const explicitCommands=extension.activation?.commands;if(explicitCommands)return explicitCommands;const contributions=extension.contributions;return contributions?[...entriesOrEmpty(contributions.commands),...entriesOrEmpty(contributions.command_handlers),...entriesOrEmpty(contributions.command_overrides),...entriesOrEmpty(contributions.flag_commands),...entriesOrEmpty(contributions.parser_overrides),...ownershipCommands(contributions.preflight_ownership),...ownershipCommands(contributions.renderer_ownership)]:[]}function entriesOrEmpty(entries){return entries??[]}function ownershipCommands(entries){return entriesOrEmpty(entries).flatMap(entry=>entry.commands)}function extensionCapabilities(extension){return new Set((extension.capabilities??[]).map(capability=>capability.trim().toLowerCase()))}const GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES=new Set(["hooks","parser","preflight","renderers"]),CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES=new Set(["commands","schema","services","importers"]),SEARCH_EXTENSION_ACTIVATION_COMMANDS=new Set(["reindex","search","search-advanced"]),CREATE_TEMPLATE_FLAGS=new Set(["--template"]);function hasAnyCapability(capabilities,expected){for(const capability of expected)if(capabilities.has(capability))return!0;return!1}function commandPathNeedsSearchExtensions(commandPath){const normalized=normalizeExtensionCommandPath(commandPath??"");if(normalized.length===0)return!1;const[topLevel]=normalized.split(" ");return SEARCH_EXTENSION_ACTIVATION_COMMANDS.has(topLevel??normalized)}function probeUsesAnyFlag(probe,flags){for(const arg of probe.commandArgs??[]){if(!arg.startsWith("--"))continue;const[flagName]=arg.split("=",1);if(flags.has(flagName))return!0}return!1}function commandPathNeedsTemplateExtensions(probe){return normalizeExtensionCommandPath(probe.commandPath??"")==="create"&&probeUsesAnyFlag(probe,CREATE_TEMPLATE_FLAGS)}function extensionProvidesTemplatesRuntime(commands){return commands.some(command=>{const normalized=normalizeExtensionCommandPath(command);return normalized==="templates"||normalized.startsWith("templates ")})}function matchesStaticExtensionCommand(commands,probe){return commands.some(command=>activationCommandMatchesProbe(command,probe))||commandPathNeedsTemplateExtensions(probe)&&extensionProvidesTemplatesRuntime(commands)}function hasGlobalExtensionContributions(contributions){return[entriesOrEmpty(contributions.hooks).length,(contributions.preflight_overrides??0)-entriesOrEmpty(contributions.preflight_ownership).length,entriesOrEmpty(contributions.item_types).length,entriesOrEmpty(contributions.item_fields).length,entriesOrEmpty(contributions.relationship_kinds).length,entriesOrEmpty(contributions.service_overrides).length,entriesOrEmpty(contributions.assurance_providers).length,entriesOrEmpty(contributions.renderer_overrides).length-entriesOrEmpty(contributions.renderer_ownership).length].some(count=>count>0)}function resolveStaticExtensionActivationDecision(extension,probe){const explicitCommands=extension.activation?.commands??[];if(explicitCommands.length>0)return matchesStaticExtensionCommand(explicitCommands,probe);const commands=extensionActivationCommands(extension);if(matchesStaticExtensionCommand(commands,probe)||extensionCapabilities(extension).has("search")&&commandPathNeedsSearchExtensions(probe.commandPath))return!0;if(extension.contributions)return hasGlobalExtensionContributions(extension.contributions)}function extensionNeedsActivationForProbe(extension,probe){const staticDecision=resolveStaticExtensionActivationDecision(extension,probe);if(staticDecision!==void 0)return staticDecision;const capabilities=extensionCapabilities(extension);return!!(hasAnyCapability(capabilities,GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)||hasAnyCapability(capabilities,CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES))}function discoveryNeedsActivationForProbe(discovery,probe){return discovery.effective.length===0?!1:buildRuntimeExtensionActivationScope(probe)!=="all"?discovery.effective.some(extension=>extensionNeedsActivationForProbe(extension,probe)):discovery.effective.some(extension=>{const capabilities=extensionCapabilities(extension);return extensionActivationCommands(extension).length>0||hasAnyCapability(capabilities,GLOBAL_EXTENSION_ACTIVATION_CAPABILITIES)||hasAnyCapability(capabilities,CONSERVATIVE_EXTENSION_ACTIVATION_CAPABILITIES)||capabilities.has("search")})}function buildRuntimeExtensionActivationScope(probe){if(normalizeExtensionCommandPath(probe.commandPath??"").split(" ")[0]==="completion")return"all";const commandPath=collectActivationCommandCandidates(probe).filter(candidate=>candidate.split(" ").every(part=>!part.startsWith("-"))).sort((left,right)=>right.length-left.length)[0]??normalizeExtensionCommandPath(probe.commandPath??"");if(commandPath.length===0)return"all";const args=commandPathNeedsTemplateExtensions(probe)?"--template":"";return`${probe.allowCommandPrefixMatch===!0?"prefix":"exact"}:${commandPath}:${args}`}function buildRuntimeExtensionFilterForProbe(probe){return buildRuntimeExtensionActivationScope(probe)==="all"?void 0:extension=>extensionNeedsActivationForProbe(extension,probe)}function buildBootstrapActivationProbe(invocationArgv){const helpRequest=parseBootstrapHelpRequest(invocationArgv);if(helpRequest.requested&&helpRequest.commandPathTokens.length>0){const[commandPath,...commandArgs]=helpRequest.commandPathTokens;return{commandPath,commandArgs,allowCommandPrefixMatch:!0}}const stripped=stripGlobalBootstrapTokens(invocationArgv),commandIndex=stripped.findIndex(token=>token.trim().length>0&&!token.startsWith("-"));return commandIndex<0?{}:{commandPath:stripped[commandIndex],commandArgs:stripped.slice(commandIndex+1),allowCommandPrefixMatch:helpRequest.requested}}function collectParsedActivationCommandArgs(command){const commandArgs=command.args.map(String);if(normalizeExtensionCommandPath(getCommandPath(command))==="create"){const options=command.optsWithGlobals();typeof options.template=="string"&&options.template.trim().length>0&&commandArgs.push("--template")}return commandArgs}export{activationCommandMatchesProbe,buildBootstrapActivationProbe,buildRuntimeExtensionActivationScope,buildRuntimeExtensionFilterForProbe,collectActivationCommandCandidates,collectLeadingCommandArgs,collectParsedActivationCommandArgs,commandPathNeedsSearchExtensions,commandPathNeedsTemplateExtensions,discoveryNeedsActivationForProbe,extensionActivationCommands,extensionCapabilities,extensionNeedsActivationForProbe,extensionProvidesTemplatesRuntime,hasAnyCapability,hasGlobalExtensionContributions,matchesStaticExtensionCommand,probeUsesAnyFlag,resolveStaticExtensionActivationDecision};
 //# sourceMappingURL=activation.js.map

package/dist/cli/runtime/invocation-options.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]="b9f5ccc6-1a28-5269-983a-fd6e0d0e1a74")}catch(e2){}})();import{resolveSubcommandFlagContractsForCommand}from"../../sdk/cli-contracts.js";import{resolvePmCommandOperation}from"../../sdk/cli-contracts/command-aliases.js";import{PM_READ_OUTPUT_SURFACE_CONTRACTS,applyReadOutputIncludeModes,readOutputIncludeModeOptions,resolveReadOutputSurface}from"../../sdk/read-output-contracts.js";import{EXIT_CODE,PmCliError}from"../../sdk/runtime-primitives.js";import{extractProvidedOptionFlags}from"../argv-utils.js";import{normalizeExtensionCommandPath}from"../extension-command-help.js";import{coerceLooseCommandOptionsWithFlagDefinitions,collectLooseCommandOptionKeysForDefinitions,parseLooseCommandOptions,validateLooseCommandOptionsWithFlagDefinitions}from"../extension-command-options.js";import{getCommandPath,setResolvedGlobalOptions}from"../registration-helpers.js";const READ_OUTPUT_INVOCATION_PROVENANCE=Symbol.for("pm.readOutputInvocationProvenance");function copyReadOutputInvocationProvenance(source,target){const provenance=Reflect.get(source,READ_OUTPUT_INVOCATION_PROVENANCE);if(provenance!==void 0){Reflect.set(target,READ_OUTPUT_INVOCATION_PROVENANCE,provenance)}}function recordCliReadOutputInvocationProvenance(actionCommand,commandPath,commandOptions){const surface=resolveReadOutputSurface(commandPath,commandOptions);if(!surface)return;let rootCommand=actionCommand;while(rootCommand.parent)rootCommand=rootCommand.parent;const rawArgs=rootCommand.rawArgs;const providedFlags=new Set(extractProvidedOptionFlags(rawArgs.slice(2)));const contract=PM_READ_OUTPUT_SURFACE_CONTRACTS.find(candidate=>candidate.command===surface);const explicitLegacyAliases=Object.values(contract.dimensions).flatMap(dimension=>dimension.legacy_aliases.flatMap(alias=>providedFlags.has(alias.flag)?[alias.flag]:[]));const previous=Reflect.get(commandOptions,READ_OUTPUT_INVOCATION_PROVENANCE);Reflect.set(commandOptions,READ_OUTPUT_INVOCATION_PROVENANCE,{canonical_include_modes:previous?.canonical_include_modes??[],explicit_legacy_aliases:explicitLegacyAliases,cli_invocation_observed:true});copyReadOutputInvocationProvenance(commandOptions,actionCommand)}function collectCommandInvocationOptions(command){const allOptions=command.optsWithGlobals();const commandPath=getCommandPath(command);if(resolvePmCommandOperation(commandPath)===commandPath)return allOptions;const ownOptions=command.opts();for(let parent=command.parent;parent?.parent;parent=parent.parent){for(const option of parent.options){const key=option.attributeName();const suppliedOnParent=parent.getOptionValueSource(key)==="cli";if(suppliedOnParent&&!command.options.some(candidate=>candidate.long===option.long)){throw new PmCliError(`Unknown option '${option.long}' for ${commandPath}`,EXIT_CODE.USAGE,{code:"unknown_option",flag:option.long,required:`Use options declared by pm ${commandPath} --help.`})}if(suppliedOnParent&&command.getOptionValueSource(key)!=="cli"){const value=parent.getOptionValue(key);command.setOptionValueWithSource(key,value,"cli")}if(key in ownOptions){allOptions[key]=ownOptions[key]}else{delete allOptions[key]}}}return allOptions}function forwardReadOutputIncludeModes(actionCommand,commandPath,globalOptions,commandOptions){recordCliReadOutputInvocationProvenance(actionCommand,commandPath,commandOptions);const requested=globalOptions.outputInclude;if(requested===void 0)return;const{selectors,modes}=applyReadOutputIncludeModes(commandPath,requested,commandOptions);if(commandPath==="get"&&typeof commandOptions.fields==="string"){actionCommand.setOptionValueWithSource("fields",commandOptions.fields,"cli")}if(modes.length===0)return;copyReadOutputInvocationProvenance(commandOptions,actionCommand);const modeOptions=readOutputIncludeModeOptions(commandPath);for(const mode of modes){const key=modeOptions.get(mode);const value=commandOptions[key];actionCommand.setOptionValueWithSource(key,value,"cli")}const residual=selectors.length>0?selectors.join(","):void 0;if(residual===void 0){delete globalOptions.outputInclude}else{globalOptions.outputInclude=residual}for(let scope=actionCommand;scope;scope=scope.parent){scope.setOptionValueWithSource("outputInclude",residual,"cli")}setResolvedGlobalOptions(actionCommand,globalOptions)}function extractCommandScopedOptions(command,commandArgs,extensionFlagDefinitions=[]){const allOptions=collectCommandInvocationOptions(command);const scoped={...allOptions};copyReadOutputInvocationProvenance(command,scoped);delete scoped.json;delete scoped.quiet;delete scoped.path;delete scoped.pmPath;delete scoped.noExtensions;delete scoped.extensions;delete scoped.profile;delete scoped.pager;delete scoped.changedFields;delete scoped.fullChangedFields;delete scoped.idOnly;delete scoped.lean;delete scoped.tokenAccounting;delete scoped.outputInclude;delete scoped.outputLimit;delete scoped.outputBudget;delete scoped.outputFormat;delete scoped.outputSession;const looseOptions=parseLooseCommandOptions(commandArgs);for(const[key,value]of Object.entries(looseOptions)){if(scoped[key]===void 0){scoped[key]=value}}if(extensionFlagDefinitions.length>0){const extensionOptionKeys=collectLooseCommandOptionKeysForDefinitions(extensionFlagDefinitions);const coreFlagDefinitions=resolveSubcommandFlagContractsForCommand(getCommandPath(command)).map(contract=>({long:contract.flag,short:contract.short,aliases:contract.aliases}));const optionsToValidate={...looseOptions};for(const key of extensionOptionKeys){if(scoped[key]!==void 0){optionsToValidate[key]=scoped[key]}}validateLooseCommandOptionsWithFlagDefinitions(optionsToValidate,[...coreFlagDefinitions,...extensionFlagDefinitions],getCommandPath(command));const coerced=coerceLooseCommandOptionsWithFlagDefinitions(scoped,extensionFlagDefinitions,looseOptions);copyReadOutputInvocationProvenance(scoped,coerced);return coerced}return scoped}function collectExtensionFlagDefinitionsForCommand(registrations,commandPath){const normalizedCommandPath=normalizeExtensionCommandPath(commandPath);if(normalizedCommandPath.length===0){return[]}return registrations.flags.filter(entry=>resolvePmCommandOperation(normalizeExtensionCommandPath(entry.target_command))===resolvePmCommandOperation(normalizedCommandPath)).flatMap(entry=>entry.flags)}function collectExtensionFlagDefinitionsForInvocation(registrations,commandPath,commandArgs){const exact=collectExtensionFlagDefinitionsForCommand(registrations,commandPath);const pathParts=[commandPath];let nestedMatch=[];for(const arg of commandArgs){if(arg.startsWith("-")){break}pathParts.push(arg);const nested=collectExtensionFlagDefinitionsForCommand(registrations,pathParts.join(" "));if(nested.length>0){nestedMatch=nested}}return nestedMatch.length>0?nestedMatch:exact}function dynamicCommandArguments(descriptor){return descriptor.arguments??[]}function formatDynamicCommandUsage(descriptor){const argumentSuffix=dynamicCommandArguments(descriptor).map(argument=>{const label=argument.variadic?`${argument.name}...`:argument.name;return argument.required?`<${label}>`:`[${label}]`}).join(" ");return`pm ${descriptor.command}${argumentSuffix?` ${argumentSuffix}`:""}`}function isImporterOrExporterCommandPath(registrations,commandPath){if(!registrations){return false}const normalized=normalizeExtensionCommandPath(commandPath);return registrations.importers.some(entry=>normalizeExtensionCommandPath(`${entry.importer} import`)===normalized)||registrations.exporters.some(entry=>normalizeExtensionCommandPath(`${entry.exporter} export`)===normalized)}function validateDynamicExtensionCommandArgs(descriptor,args){const descriptorArguments=dynamicCommandArguments(descriptor);const requiredCount=descriptorArguments.filter(argument=>argument.required).length;const variadic=descriptorArguments.some(argument=>argument.variadic);const maxCount=variadic?Number.POSITIVE_INFINITY:descriptorArguments.length;const failureHints=descriptor.failure_hints??[];const hintSuffix=failureHints.length>0?` ${failureHints.join(" ")}`:"";if(args.length<requiredCount){throw new PmCliError(`Missing required argument for extension command '${descriptor.command}'. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`,EXIT_CODE.USAGE)}if(args.length>maxCount){const extra=args.slice(maxCount).join(" ");throw new PmCliError(`Too many arguments for extension command '${descriptor.command}': ${extra}. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`,EXIT_CODE.USAGE)}}function formatDynamicOptionFlag(optionKey){return`--${optionKey.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/_/g,"-").toLowerCase()}`}function validateDynamicExtensionCommandOptions(descriptor,options,extensionFlagDefinitions){if(extensionFlagDefinitions.length>0){validateLooseCommandOptionsWithFlagDefinitions(options,extensionFlagDefinitions,descriptor.command);return}const unknownOptions=Object.keys(options).filter(key=>options[key]!==void 0).sort();if(unknownOptions.length===0){return}throw new PmCliError(`Unknown option '${unknownOptions.map(formatDynamicOptionFlag).join(", ")}' for extension command '${descriptor.command}'. This command does not define extension flags.`,EXIT_CODE.USAGE)}function validateDynamicExtensionCommandInvocation(descriptor,args,options,extensionFlagDefinitions){if(!descriptor){return}validateDynamicExtensionCommandArgs(descriptor,args);validateDynamicExtensionCommandOptions(descriptor,options,extensionFlagDefinitions)}export{collectExtensionFlagDefinitionsForCommand,collectExtensionFlagDefinitionsForInvocation,copyReadOutputInvocationProvenance,dynamicCommandArguments,extractCommandScopedOptions,forwardReadOutputIncludeModes,isImporterOrExporterCommandPath,recordCliReadOutputInvocationProvenance,validateDynamicExtensionCommandArgs,validateDynamicExtensionCommandInvocation};
+(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]="2fe1a4e5-3c55-5ec3-a729-2216a298c081")}catch{}})();import{resolveSubcommandFlagContractsForCommand}from"../../sdk/cli-contracts.js";import{resolvePmCommandOperation}from"../../sdk/cli-contracts/command-aliases.js";import{PM_READ_OUTPUT_SURFACE_CONTRACTS,applyReadOutputIncludeModes,readOutputIncludeModeOptions,resolveReadOutputSurface}from"../../sdk/read-output-contracts.js";import{EXIT_CODE,PmCliError}from"../../sdk/runtime-primitives.js";import{extractProvidedOptionFlags}from"../argv-utils.js";import{normalizeExtensionCommandPath}from"../extension-command-help.js";import{coerceLooseCommandOptionsWithFlagDefinitions,collectLooseCommandOptionKeysForDefinitions,parseLooseCommandOptions,validateLooseCommandOptionsWithFlagDefinitions}from"../extension-command-options.js";import{getCommandPath,setResolvedGlobalOptions}from"../registration-helpers.js";const READ_OUTPUT_INVOCATION_PROVENANCE=Symbol.for("pm.readOutputInvocationProvenance");function copyReadOutputInvocationProvenance(source,target){const provenance=Reflect.get(source,READ_OUTPUT_INVOCATION_PROVENANCE);provenance!==void 0&&Reflect.set(target,READ_OUTPUT_INVOCATION_PROVENANCE,provenance)}function recordCliReadOutputInvocationProvenance(actionCommand,commandPath,commandOptions){const surface=resolveReadOutputSurface(commandPath,commandOptions);if(!surface)return;let rootCommand=actionCommand;for(;rootCommand.parent;)rootCommand=rootCommand.parent;const rawArgs=rootCommand.rawArgs,providedFlags=new Set(extractProvidedOptionFlags(rawArgs.slice(2))),contract=PM_READ_OUTPUT_SURFACE_CONTRACTS.find(candidate=>candidate.command===surface),explicitLegacyAliases=Object.values(contract.dimensions).flatMap(dimension=>dimension.legacy_aliases.flatMap(alias=>providedFlags.has(alias.flag)?[alias.flag]:[])),previous=Reflect.get(commandOptions,READ_OUTPUT_INVOCATION_PROVENANCE);Reflect.set(commandOptions,READ_OUTPUT_INVOCATION_PROVENANCE,{canonical_include_modes:previous?.canonical_include_modes??[],explicit_legacy_aliases:explicitLegacyAliases,cli_invocation_observed:!0}),copyReadOutputInvocationProvenance(commandOptions,actionCommand)}function collectCommandInvocationOptions(command){const allOptions=command.optsWithGlobals(),commandPath=getCommandPath(command);if(resolvePmCommandOperation(commandPath)===commandPath)return allOptions;const ownOptions=command.opts();for(let parent=command.parent;parent?.parent;parent=parent.parent)for(const option of parent.options){const key=option.attributeName(),suppliedOnParent=parent.getOptionValueSource(key)==="cli";if(suppliedOnParent&&!command.options.some(candidate=>candidate.long===option.long))throw new PmCliError(`Unknown option '${option.long}' for ${commandPath}`,EXIT_CODE.USAGE,{code:"unknown_option",flag:option.long,required:`Use options declared by pm ${commandPath} --help.`});if(suppliedOnParent&&command.getOptionValueSource(key)!=="cli"){const value=parent.getOptionValue(key);command.setOptionValueWithSource(key,value,"cli")}key in ownOptions?allOptions[key]=ownOptions[key]:delete allOptions[key]}return allOptions}function forwardReadOutputIncludeModes(actionCommand,commandPath,globalOptions,commandOptions){recordCliReadOutputInvocationProvenance(actionCommand,commandPath,commandOptions);const requested=globalOptions.outputInclude;if(requested===void 0)return;const{selectors,modes}=applyReadOutputIncludeModes(commandPath,requested,commandOptions);if(commandPath==="get"&&typeof commandOptions.fields=="string"&&actionCommand.setOptionValueWithSource("fields",commandOptions.fields,"cli"),modes.length===0)return;copyReadOutputInvocationProvenance(commandOptions,actionCommand);const modeOptions=readOutputIncludeModeOptions(commandPath);for(const mode of modes){const key=modeOptions.get(mode),value=commandOptions[key];actionCommand.setOptionValueWithSource(key,value,"cli")}const residual=selectors.length>0?selectors.join(","):void 0;residual===void 0?delete globalOptions.outputInclude:globalOptions.outputInclude=residual;for(let scope=actionCommand;scope;scope=scope.parent)scope.setOptionValueWithSource("outputInclude",residual,"cli");setResolvedGlobalOptions(actionCommand,globalOptions)}function extractCommandScopedOptions(command,commandArgs,extensionFlagDefinitions=[]){const scoped={...collectCommandInvocationOptions(command)};copyReadOutputInvocationProvenance(command,scoped),delete scoped.json,delete scoped.quiet,delete scoped.path,delete scoped.pmPath,delete scoped.noExtensions,delete scoped.extensions,delete scoped.profile,delete scoped.pager,delete scoped.changedFields,delete scoped.fullChangedFields,delete scoped.idOnly,delete scoped.lean,delete scoped.tokenAccounting,delete scoped.outputInclude,delete scoped.outputLimit,delete scoped.outputBudget,delete scoped.outputFormat,delete scoped.outputSession;const looseOptions=parseLooseCommandOptions(commandArgs);for(const[key,value]of Object.entries(looseOptions))scoped[key]===void 0&&(scoped[key]=value);if(extensionFlagDefinitions.length>0){const extensionOptionKeys=collectLooseCommandOptionKeysForDefinitions(extensionFlagDefinitions),coreFlagDefinitions=resolveSubcommandFlagContractsForCommand(getCommandPath(command)).map(contract=>({long:contract.flag,short:contract.short,aliases:contract.aliases})),optionsToValidate={...looseOptions};for(const key of extensionOptionKeys)scoped[key]!==void 0&&(optionsToValidate[key]=scoped[key]);validateLooseCommandOptionsWithFlagDefinitions(optionsToValidate,[...coreFlagDefinitions,...extensionFlagDefinitions],getCommandPath(command));const coerced=coerceLooseCommandOptionsWithFlagDefinitions(scoped,extensionFlagDefinitions,looseOptions);return copyReadOutputInvocationProvenance(scoped,coerced),coerced}return scoped}function collectExtensionFlagDefinitionsForCommand(registrations,commandPath){const normalizedCommandPath=normalizeExtensionCommandPath(commandPath);return normalizedCommandPath.length===0?[]:registrations.flags.filter(entry=>resolvePmCommandOperation(normalizeExtensionCommandPath(entry.target_command))===resolvePmCommandOperation(normalizedCommandPath)).flatMap(entry=>entry.flags)}function collectExtensionFlagDefinitionsForInvocation(registrations,commandPath,commandArgs){const exact=collectExtensionFlagDefinitionsForCommand(registrations,commandPath),pathParts=[commandPath];let nestedMatch=[];for(const arg of commandArgs){if(arg.startsWith("-"))break;pathParts.push(arg);const nested=collectExtensionFlagDefinitionsForCommand(registrations,pathParts.join(" "));nested.length>0&&(nestedMatch=nested)}return nestedMatch.length>0?nestedMatch:exact}function dynamicCommandArguments(descriptor){return descriptor.arguments??[]}function formatDynamicCommandUsage(descriptor){const argumentSuffix=dynamicCommandArguments(descriptor).map(argument=>{const label=argument.variadic?`${argument.name}...`:argument.name;return argument.required?`<${label}>`:`[${label}]`}).join(" ");return`pm ${descriptor.command}${argumentSuffix?` ${argumentSuffix}`:""}`}function isImporterOrExporterCommandPath(registrations,commandPath){if(!registrations)return!1;const normalized=normalizeExtensionCommandPath(commandPath);return registrations.importers.some(entry=>normalizeExtensionCommandPath(`${entry.importer} import`)===normalized)||registrations.exporters.some(entry=>normalizeExtensionCommandPath(`${entry.exporter} export`)===normalized)}function validateDynamicExtensionCommandArgs(descriptor,args){const descriptorArguments=dynamicCommandArguments(descriptor),requiredCount=descriptorArguments.filter(argument=>argument.required).length,maxCount=descriptorArguments.some(argument=>argument.variadic)?Number.POSITIVE_INFINITY:descriptorArguments.length,failureHints=descriptor.failure_hints??[],hintSuffix=failureHints.length>0?` ${failureHints.join(" ")}`:"";if(args.length<requiredCount)throw new PmCliError(`Missing required argument for extension command '${descriptor.command}'. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`,EXIT_CODE.USAGE);if(args.length>maxCount){const extra=args.slice(maxCount).join(" ");throw new PmCliError(`Too many arguments for extension command '${descriptor.command}': ${extra}. Usage: ${formatDynamicCommandUsage(descriptor)}${hintSuffix}`,EXIT_CODE.USAGE)}}function formatDynamicOptionFlag(optionKey){return`--${optionKey.replace(/([a-z0-9])([A-Z])/g,"$1-$2").replace(/_/g,"-").toLowerCase()}`}function validateDynamicExtensionCommandOptions(descriptor,options,extensionFlagDefinitions){if(extensionFlagDefinitions.length>0){validateLooseCommandOptionsWithFlagDefinitions(options,extensionFlagDefinitions,descriptor.command);return}const unknownOptions=Object.keys(options).filter(key=>options[key]!==void 0).sort();if(unknownOptions.length!==0)throw new PmCliError(`Unknown option '${unknownOptions.map(formatDynamicOptionFlag).join(", ")}' for extension command '${descriptor.command}'. This command does not define extension flags.`,EXIT_CODE.USAGE)}function validateDynamicExtensionCommandInvocation(descriptor,args,options,extensionFlagDefinitions){descriptor&&(validateDynamicExtensionCommandArgs(descriptor,args),validateDynamicExtensionCommandOptions(descriptor,options,extensionFlagDefinitions))}export{collectExtensionFlagDefinitionsForCommand,collectExtensionFlagDefinitionsForInvocation,copyReadOutputInvocationProvenance,dynamicCommandArguments,extractCommandScopedOptions,forwardReadOutputIncludeModes,isImporterOrExporterCommandPath,recordCliReadOutputInvocationProvenance,validateDynamicExtensionCommandArgs,validateDynamicExtensionCommandInvocation};
 //# sourceMappingURL=invocation-options.js.map

package/dist/cli/runtime/projection-retry.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]="bdbd1281-8294-5bda-8053-f9fff4c34bf3")}catch(e2){}})();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"]);const BOOLEAN_PROJECTION_FLAGS=new Set(["--full","--brief","--compact"]);function consumesFlagValue(contract,valueFlags){return Boolean(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]));const 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()}`)}`)));const canonical=new Map([...GLOBAL_FLAG_CONTRACTS,...contracts].flatMap(contract=>[contract.flag,...contract.aliases??[]].map(flag=>[flag,contract.flag])));const 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,true);for(const flag of BOOLEAN_PROJECTION_FLAGS)known.set(flag,false);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 void 0;options.set(index,canonical.get(flag)??flag);if(known.get(flag)&&!token.includes("="))index+=1}return options}function withoutProjectionFlags(argv,options,flags){const removed=new Set;for(const[index,flag]of options){if(!flags.has(flag))continue;removed.add(index);if(VALUE_PROJECTION_FLAGS.has(flag)&&!argv[index].includes("="))removed.add(index+1)}return argv.filter((_,index)=>!removed.has(index))}function withProjectionFlags(argv,additions,position){argv.splice(position,0,...additions);return argv}function selectProjectionRetryMode(options,suggested){const fallback=suggested.find(token=>BOOLEAN_PROJECTION_FLAGS.has(token));if(fallback===void 0)return void 0;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;const 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]);const 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]="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};
 //# sourceMappingURL=projection-retry.js.map

package/dist/cli/runtime/selection.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]="368c57a5-6fd3-5780-8e38-3d9aea4ac3fd")}catch(e2){}})();import{Command}from"commander";import{PM_RELOCATED_COMMAND_ALIASES,findPmNamespacedCommand}from"../../sdk/cli-contracts/command-aliases.js";import{enrichCliFlagInvocationContracts}from"../../sdk/flag-invocation-contracts.js";import{GLOBAL_FLAG_CONTRACTS,resolveSubcommandFlagContractsForCommand}from"../../sdk/cli-contracts/flag-contracts.js";import{EXIT_CODE,PmCliError}from"../../sdk/runtime-primitives.js";import{redactSensitiveCommandArgs,renderPmCommand}from"../argv-utils.js";import{parseBootstrapCommandName,parseBootstrapHelpRequest,stripGlobalBootstrapTokens}from"../bootstrap-args.js";import{isFullHelpDiscovery}from"../help-content.js";const VERSION_FLAG_TOKENS=new Set(["--version","-V"]);function isStaticExtensionInventoryInvocation(invocationArgv){const tokens=stripGlobalBootstrapTokens(invocationArgv);return["package","packages","extension"].includes(tokens[0]??"")&&tokens[1]==="inventory"}function resolveStructuredMutationPreviewInvocation(invocationArgv){const tokens=stripGlobalBootstrapTokens(invocationArgv);if(tokens[0]!=="item"||!invocationArgv.includes("--dry-run"))return void 0;const probe=new Command().configureOutput({writeErr:()=>{}}).exitOverride();const registered=new Set;for(const contract of GLOBAL_FLAG_CONTRACTS){for(const flag of[contract.flag,contract.short,...contract.aliases??[]]){if(flag===void 0||registered.has(flag))continue;registered.add(flag);const takesValue=contract.value_name!==void 0||contract.flag==="--pm-path";probe.option(`${flag}${takesValue?" <value>":""}`)}}try{probe.parseOptions(invocationArgv)}catch{}const options=probe.opts();return{path:options.pmPath??options.path}}const SETUP_COMMAND_NAMES=new Set(["config","extension","init","install","package","packages","templates","upgrade"]);const LIST_QUERY_COMMAND_NAMES=new Set(["activity","aggregate","context","ctx","events","get","graph","history","list","list-all","list-blocked","list-canceled","list-closed","list-draft","list-in-progress","list-open","search"]);const MUTATION_COMMAND_NAMES=new Set(["append","close","close-many","comments","delete","deps","discover","docs","files","history-repair","history-redact","history-compact","learnings","notes","plan","restore","update","update-many","create"]);const OPERATION_COMMAND_NAMES=new Set(["claim","close-task","contracts","duplicates","gc","health","pause-task","release","start-task","stats","test","test-all","test-runs","test-runs-worker","validate"]);const MUTATING_OPERATION_COMMAND_NAMES=new Set(["claim","close-task","pause-task","release","start-task","test"]);const REGISTER_ALL_CORE_COMMAND_FAMILIES={setup:true,listQuery:true,mutation:true,operation:true};const RUNTIME_SCHEMA_FLAG_BOOTSTRAP_COMMANDS=new Set(["create","update","update-many","list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled","search","calendar","context","templates"]);function invocationRequestsVersion(invocationArgv){return invocationArgv.some(token=>VERSION_FLAG_TOKENS.has(token))}function resolveAncestorOptionRegistration(commandTokens,namespaceRoot){if(!PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.canonical_argv[0]===namespaceRoot))return void 0;const probe=new Command().configureOutput({writeErr:()=>{}}).exitOverride();for(const contract of enrichCliFlagInvocationContracts(namespaceRoot,resolveSubcommandFlagContractsForCommand(namespaceRoot))){const suffix=contract.takes_value?contract.value_required?" <value>":" [value]":"";for(const flag of[contract.flag,contract.short,...contract.aliases??[]]){if(flag!==void 0)probe.option(`${flag}${suffix}`)}}try{const parsed=probe.parseOptions(commandTokens.slice(1));if(parsed.unknown.length>0)return REGISTER_ALL_CORE_COMMAND_FAMILIES;const operation=findPmNamespacedCommand([namespaceRoot,...parsed.operands])?.alias;if(PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.alias===operation)){return{...REGISTER_ALL_CORE_COMMAND_FAMILIES,targetCommandName:operation}}}catch{return REGISTER_ALL_CORE_COMMAND_FAMILIES}return void 0}function resolveCoreCommandRegistrationSelection(invocationArgv){if(invocationRequestsVersion(invocationArgv)){return{setup:false,listQuery:false,mutation:false,operation:false}}if(invocationArgv.length===0||parseBootstrapHelpRequest(invocationArgv).requested){return REGISTER_ALL_CORE_COMMAND_FAMILIES}const commandName=parseBootstrapCommandName(invocationArgv);if(!commandName){return REGISTER_ALL_CORE_COMMAND_FAMILIES}const normalizedCommand=commandName.trim().toLowerCase();const commandTokens=stripGlobalBootstrapTokens(invocationArgv);const semanticCommand=findPmNamespacedCommand(commandTokens)?.alias;if(PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.alias===semanticCommand)){return{...REGISTER_ALL_CORE_COMMAND_FAMILIES,targetCommandName:semanticCommand}}const ancestorSelection=resolveAncestorOptionRegistration(commandTokens,normalizedCommand==="ctx"?"context":normalizedCommand);if(ancestorSelection)return ancestorSelection;if(SETUP_COMMAND_NAMES.has(normalizedCommand)){return{setup:true,listQuery:false,mutation:false,operation:false,targetCommandName:normalizedCommand}}if(LIST_QUERY_COMMAND_NAMES.has(normalizedCommand)){return{setup:false,listQuery:true,mutation:false,operation:false,targetCommandName:normalizedCommand}}if(MUTATION_COMMAND_NAMES.has(normalizedCommand)){return{setup:false,listQuery:false,mutation:true,operation:false,targetCommandName:normalizedCommand}}if(OPERATION_COMMAND_NAMES.has(normalizedCommand)){return{setup:false,listQuery:false,mutation:false,operation:true,targetCommandName:normalizedCommand}}return REGISTER_ALL_CORE_COMMAND_FAMILIES}function shouldAttachRichHelpTextForInvocation(invocationArgv){return invocationArgv.length===0||parseBootstrapHelpRequest(invocationArgv).requested||invocationArgv.includes("--explain")&&parseBootstrapCommandName(invocationArgv)===void 0}function shouldRegisterDynamicExtensionPaths(_rootProgram,invocationArgv){if(isStaticExtensionInventoryInvocation(invocationArgv)){return false}if(invocationRequestsVersion(invocationArgv)){return false}if(isFullHelpDiscovery(invocationArgv)){return true}const helpRequest=parseBootstrapHelpRequest(invocationArgv);if(helpRequest.requested){return true}const commandName=parseBootstrapCommandName(invocationArgv);if(!commandName){return false}return true}function shouldRegisterRuntimeSchemaFlags(invocationArgv){if(invocationRequestsVersion(invocationArgv)){return false}const commandName=parseBootstrapCommandName(invocationArgv);if(!commandName){return false}return RUNTIME_SCHEMA_FLAG_BOOTSTRAP_COMMANDS.has(commandName)}function redactSensitiveFlagTypo(params){const rawTypoToken=String(params.rawFrom??"");const rawTypoEqualsIndex=rawTypoToken.indexOf("=");const rawTypoFlag=rawTypoEqualsIndex>=0?rawTypoToken.slice(0,rawTypoEqualsIndex):rawTypoToken;const sensitiveCanonicalFlag=params.normalizedTokens.map(token=>{const equalsIndex=token.indexOf("=");return equalsIndex>=0?token.slice(0,equalsIndex):token}).find(token=>token==="--literal"||token==="--regex"||token==="--replacement");const typoNormalizedArgv=sensitiveCanonicalFlag?params.argv.map(token=>{const equalsIndex=token.indexOf("=");const flag=equalsIndex>=0?token.slice(0,equalsIndex):token;return flag===rawTypoFlag?equalsIndex>=0?`${sensitiveCanonicalFlag}${token.slice(equalsIndex)}`:sensitiveCanonicalFlag:token}):params.argv;const safeArgv=redactSensitiveCommandArgs(typoNormalizedArgv);const safeTypoDisplay=sensitiveCanonicalFlag&&rawTypoEqualsIndex>=0?`${rawTypoFlag}=[redacted]`:rawTypoToken;const safeNormalizedDisplay=sensitiveCanonicalFlag&&params.normalizedDisplay.includes("=")?`${sensitiveCanonicalFlag}=[redacted]`:params.normalizedDisplay;return{argv:safeArgv,normalizedDisplay:safeNormalizedDisplay,sourceDisplay:safeTypoDisplay}}function enforceExplicitRetryForFlagTypos(bootstrapInvocation){const commandName=bootstrapInvocation.commandName;if(!commandName){return}const typoEvent=bootstrapInvocation.trace.find(entry=>entry.reason==="flag_typo");if(!typoEvent){return}const normalizedTokens=Array.isArray(typoEvent.to)?typoEvent.to:[String(typoEvent.to??"")].filter(entry=>entry.length>0);const normalizedDisplay=normalizedTokens.length>0?normalizedTokens.join(" "):"the canonical flag";const mutatingCommand=MUTATION_COMMAND_NAMES.has(commandName)||MUTATING_OPERATION_COMMAND_NAMES.has(commandName);const code=mutatingCommand?"mutating_flag_typo_requires_retry":"flag_typo_requires_retry";const commandScope=mutatingCommand?"mutating option":"option";const safeTypo=redactSensitiveFlagTypo({argv:bootstrapInvocation.argv,normalizedDisplay,normalizedTokens,rawFrom:typoEvent.from});throw new PmCliError(`Refusing to auto-correct ${commandScope} ${safeTypo.sourceDisplay} to ${safeTypo.normalizedDisplay}. Retry with the canonical flag so the command is explicit.`,EXIT_CODE.USAGE,{code,examples:[renderPmCommand(safeTypo.argv)],nextSteps:["Retry the command with the canonical flag shown in examples."],recovery:{normalized_args:safeTypo.argv,suggested_retry:renderPmCommand(safeTypo.argv)}})}export{LIST_QUERY_COMMAND_NAMES,enforceExplicitRetryForFlagTypos,invocationRequestsVersion,isStaticExtensionInventoryInvocation,resolveCoreCommandRegistrationSelection,resolveStructuredMutationPreviewInvocation,shouldAttachRichHelpTextForInvocation,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags};
+(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]="0503f6e5-36d9-5afb-a17f-feef2241f984")}catch{}})();import{Command}from"commander";import{PM_RELOCATED_COMMAND_ALIASES,findPmNamespacedCommand}from"../../sdk/cli-contracts/command-aliases.js";import{enrichCliFlagInvocationContracts}from"../../sdk/flag-invocation-contracts.js";import{GLOBAL_FLAG_CONTRACTS,resolveSubcommandFlagContractsForCommand}from"../../sdk/cli-contracts/flag-contracts.js";import{EXIT_CODE,PmCliError}from"../../sdk/runtime-primitives.js";import{redactSensitiveCommandArgs,renderPmCommand}from"../argv-utils.js";import{parseBootstrapCommandName,parseBootstrapHelpRequest,stripGlobalBootstrapTokens}from"../bootstrap-args.js";import{isFullHelpDiscovery}from"../help-content.js";const VERSION_FLAG_TOKENS=new Set(["--version","-V"]);function isStaticExtensionInventoryInvocation(invocationArgv){const tokens=stripGlobalBootstrapTokens(invocationArgv);return["package","packages","extension"].includes(tokens[0]??"")&&tokens[1]==="inventory"}function resolveStructuredMutationPreviewInvocation(invocationArgv){if(stripGlobalBootstrapTokens(invocationArgv)[0]!=="item"||!invocationArgv.includes("--dry-run"))return;const probe=new Command().configureOutput({writeErr:()=>{}}).exitOverride(),registered=new Set;for(const contract of GLOBAL_FLAG_CONTRACTS)for(const flag of[contract.flag,contract.short,...contract.aliases??[]]){if(flag===void 0||registered.has(flag))continue;registered.add(flag);const takesValue=contract.value_name!==void 0||contract.flag==="--pm-path";probe.option(`${flag}${takesValue?" <value>":""}`)}try{probe.parseOptions(invocationArgv)}catch{}const options=probe.opts();return{path:options.pmPath??options.path}}const SETUP_COMMAND_NAMES=new Set(["config","extension","init","install","package","packages","templates","upgrade"]),LIST_QUERY_COMMAND_NAMES=new Set(["activity","aggregate","context","ctx","events","get","graph","history","list","list-all","list-blocked","list-canceled","list-closed","list-draft","list-in-progress","list-open","search"]),MUTATION_COMMAND_NAMES=new Set(["append","close","close-many","comments","delete","deps","discover","docs","files","history-repair","history-redact","history-compact","learnings","notes","plan","restore","update","update-many","create"]),OPERATION_COMMAND_NAMES=new Set(["claim","close-task","contracts","duplicates","gc","health","pause-task","release","start-task","stats","test","test-all","test-runs","test-runs-worker","validate"]),MUTATING_OPERATION_COMMAND_NAMES=new Set(["claim","close-task","pause-task","release","start-task","test"]),REGISTER_ALL_CORE_COMMAND_FAMILIES={setup:!0,listQuery:!0,mutation:!0,operation:!0},RUNTIME_SCHEMA_FLAG_BOOTSTRAP_COMMANDS=new Set(["create","update","update-many","list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled","search","calendar","context","templates"]);function invocationRequestsVersion(invocationArgv){return invocationArgv.some(token=>VERSION_FLAG_TOKENS.has(token))}function resolveAncestorOptionRegistration(commandTokens,namespaceRoot){if(!PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.canonical_argv[0]===namespaceRoot))return;const probe=new Command().configureOutput({writeErr:()=>{}}).exitOverride();for(const contract of enrichCliFlagInvocationContracts(namespaceRoot,resolveSubcommandFlagContractsForCommand(namespaceRoot))){const suffix=contract.takes_value?contract.value_required?" <value>":" [value]":"";for(const flag of[contract.flag,contract.short,...contract.aliases??[]])flag!==void 0&&probe.option(`${flag}${suffix}`)}try{const parsed=probe.parseOptions(commandTokens.slice(1));if(parsed.unknown.length>0)return REGISTER_ALL_CORE_COMMAND_FAMILIES;const operation=findPmNamespacedCommand([namespaceRoot,...parsed.operands])?.alias;if(PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.alias===operation))return{...REGISTER_ALL_CORE_COMMAND_FAMILIES,targetCommandName:operation}}catch{return REGISTER_ALL_CORE_COMMAND_FAMILIES}}function resolveCoreCommandRegistrationSelection(invocationArgv){if(invocationRequestsVersion(invocationArgv))return{setup:!1,listQuery:!1,mutation:!1,operation:!1};if(invocationArgv.length===0||parseBootstrapHelpRequest(invocationArgv).requested)return REGISTER_ALL_CORE_COMMAND_FAMILIES;const commandName=parseBootstrapCommandName(invocationArgv);if(!commandName)return REGISTER_ALL_CORE_COMMAND_FAMILIES;const normalizedCommand=commandName.trim().toLowerCase(),commandTokens=stripGlobalBootstrapTokens(invocationArgv),semanticCommand=findPmNamespacedCommand(commandTokens)?.alias;return PM_RELOCATED_COMMAND_ALIASES.some(alias=>alias.alias===semanticCommand)?{...REGISTER_ALL_CORE_COMMAND_FAMILIES,targetCommandName:semanticCommand}:resolveAncestorOptionRegistration(commandTokens,normalizedCommand==="ctx"?"context":normalizedCommand)||(SETUP_COMMAND_NAMES.has(normalizedCommand)?{setup:!0,listQuery:!1,mutation:!1,operation:!1,targetCommandName:normalizedCommand}:LIST_QUERY_COMMAND_NAMES.has(normalizedCommand)?{setup:!1,listQuery:!0,mutation:!1,operation:!1,targetCommandName:normalizedCommand}:MUTATION_COMMAND_NAMES.has(normalizedCommand)?{setup:!1,listQuery:!1,mutation:!0,operation:!1,targetCommandName:normalizedCommand}:OPERATION_COMMAND_NAMES.has(normalizedCommand)?{setup:!1,listQuery:!1,mutation:!1,operation:!0,targetCommandName:normalizedCommand}:REGISTER_ALL_CORE_COMMAND_FAMILIES)}function shouldAttachRichHelpTextForInvocation(invocationArgv){return invocationArgv.length===0||parseBootstrapHelpRequest(invocationArgv).requested||invocationArgv.includes("--explain")&&parseBootstrapCommandName(invocationArgv)===void 0}function shouldRegisterDynamicExtensionPaths(_rootProgram,invocationArgv){return isStaticExtensionInventoryInvocation(invocationArgv)||invocationRequestsVersion(invocationArgv)?!1:isFullHelpDiscovery(invocationArgv)||parseBootstrapHelpRequest(invocationArgv).requested?!0:!!parseBootstrapCommandName(invocationArgv)}function shouldRegisterRuntimeSchemaFlags(invocationArgv){if(invocationRequestsVersion(invocationArgv))return!1;const commandName=parseBootstrapCommandName(invocationArgv);return commandName?RUNTIME_SCHEMA_FLAG_BOOTSTRAP_COMMANDS.has(commandName):!1}function redactSensitiveFlagTypo(params){const rawTypoToken=String(params.rawFrom??""),rawTypoEqualsIndex=rawTypoToken.indexOf("="),rawTypoFlag=rawTypoEqualsIndex>=0?rawTypoToken.slice(0,rawTypoEqualsIndex):rawTypoToken,sensitiveCanonicalFlag=params.normalizedTokens.map(token=>{const equalsIndex=token.indexOf("=");return equalsIndex>=0?token.slice(0,equalsIndex):token}).find(token=>token==="--literal"||token==="--regex"||token==="--replacement"),typoNormalizedArgv=sensitiveCanonicalFlag?params.argv.map(token=>{const equalsIndex=token.indexOf("=");return(equalsIndex>=0?token.slice(0,equalsIndex):token)===rawTypoFlag?equalsIndex>=0?`${sensitiveCanonicalFlag}${token.slice(equalsIndex)}`:sensitiveCanonicalFlag:token}):params.argv,safeArgv=redactSensitiveCommandArgs(typoNormalizedArgv),safeTypoDisplay=sensitiveCanonicalFlag&&rawTypoEqualsIndex>=0?`${rawTypoFlag}=[redacted]`:rawTypoToken,safeNormalizedDisplay=sensitiveCanonicalFlag&&params.normalizedDisplay.includes("=")?`${sensitiveCanonicalFlag}=[redacted]`:params.normalizedDisplay;return{argv:safeArgv,normalizedDisplay:safeNormalizedDisplay,sourceDisplay:safeTypoDisplay}}function enforceExplicitRetryForFlagTypos(bootstrapInvocation){const commandName=bootstrapInvocation.commandName;if(!commandName)return;const typoEvent=bootstrapInvocation.trace.find(entry=>entry.reason==="flag_typo");if(!typoEvent)return;const normalizedTokens=Array.isArray(typoEvent.to)?typoEvent.to:[String(typoEvent.to??"")].filter(entry=>entry.length>0),normalizedDisplay=normalizedTokens.length>0?normalizedTokens.join(" "):"the canonical flag",mutatingCommand=MUTATION_COMMAND_NAMES.has(commandName)||MUTATING_OPERATION_COMMAND_NAMES.has(commandName),code=mutatingCommand?"mutating_flag_typo_requires_retry":"flag_typo_requires_retry",commandScope=mutatingCommand?"mutating option":"option",safeTypo=redactSensitiveFlagTypo({argv:bootstrapInvocation.argv,normalizedDisplay,normalizedTokens,rawFrom:typoEvent.from});throw new PmCliError(`Refusing to auto-correct ${commandScope} ${safeTypo.sourceDisplay} to ${safeTypo.normalizedDisplay}. Retry with the canonical flag so the command is explicit.`,EXIT_CODE.USAGE,{code,examples:[renderPmCommand(safeTypo.argv)],nextSteps:["Retry the command with the canonical flag shown in examples."],recovery:{normalized_args:safeTypo.argv,suggested_retry:renderPmCommand(safeTypo.argv)}})}export{LIST_QUERY_COMMAND_NAMES,enforceExplicitRetryForFlagTypos,invocationRequestsVersion,isStaticExtensionInventoryInvocation,resolveCoreCommandRegistrationSelection,resolveStructuredMutationPreviewInvocation,shouldAttachRichHelpTextForInvocation,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags};
 //# sourceMappingURL=selection.js.map

package/dist/cli/runtime/telemetry-outcome.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]="afcf2608-3360-5030-b5ea-b101df5829e7")}catch(e2){}})();import{isPmSuccessfulExitCode}from"../../sdk/cli-contracts/command-exit-contracts.js";import{EXIT_CODE,asRecordOrNull,deriveTelemetryCommandResolution,getActiveCommandResult,resolveTelemetryErrorCategory}from"../../sdk/runtime-primitives.js";const TELEMETRY_COMMAND_RESOLUTION_SET=new Set(["success","nonexistent_command","invalid_option","missing_required_option","missing_required_argument","invalid_usage","validation_failed","health_findings","validation_findings","conflict","runtime_failed","unknown_failed"]);const TELEMETRY_RESOLUTION_STAGE_SET=new Set(["parse","preflight","execute","unknown"]);const TELEMETRY_ERROR_CATEGORY_SET=new Set(["usage","validation","conflict","runtime","unknown"]);function readRecordString(record,...keys){if(!record){return void 0}for(const key of keys){const candidate=record[key];if(typeof candidate==="string"){const normalized=candidate.trim();if(normalized.length>0){return normalized}}}return void 0}function readRecordBoolean(record,...keys){if(!record){return void 0}for(const key of keys){const candidate=record[key];if(typeof candidate==="boolean"){return candidate}}return void 0}function readRecordNumber(record,...keys){if(!record){return void 0}for(const key of keys){const candidate=record[key];if(typeof candidate==="number"&&Number.isFinite(candidate)){return Math.max(0,Math.trunc(candidate))}}return void 0}function normalizeTelemetryCommandResolution(value){if(!value){return void 0}const normalized=value.trim().toLowerCase();if(!TELEMETRY_COMMAND_RESOLUTION_SET.has(normalized)){return void 0}return normalized}function normalizeTelemetryResolutionStage(value){if(!value){return void 0}const normalized=value.trim().toLowerCase();if(!TELEMETRY_RESOLUTION_STAGE_SET.has(normalized)){return void 0}return normalized}function normalizeTelemetryErrorCategory(value){if(!value){return void 0}const normalized=value.trim().toLowerCase();if(!TELEMETRY_ERROR_CATEGORY_SET.has(normalized)){return void 0}return normalized}function inferPostActionFailureMessage(result){const explicit=readRecordString(result,"error","message");if(explicit){return explicit}const warnings=result?.warnings;if(Array.isArray(warnings)){const firstWarning=warnings.find(value=>typeof value==="string"&&value.trim().length>0);if(typeof firstWarning==="string"){return firstWarning.trim()}}const skippedTriggered=readRecordBoolean(result,"fail_on_skipped_triggered","failOnSkippedTriggered");if(skippedTriggered){return"linked_test_fail_on_skipped_triggered"}const failedCount=readRecordNumber(result,"failed");if(typeof failedCount==="number"&&failedCount>0){return`failed_runs:${failedCount}`}const runResults=result?.run_results;if(Array.isArray(runResults)){const failedRuns=runResults.filter(entry=>{const row=asRecordOrNull(entry);return row?.status==="failed"}).length;if(failedRuns>0){return`failed_runs:${failedRuns}`}}return void 0}function inferPostActionErrorCode(ok,exitCode){if(ok){return void 0}if(exitCode===EXIT_CODE.USAGE){return"invalid_command_usage"}if(exitCode===EXIT_CODE.NOT_FOUND){return"item_not_found"}if(exitCode===EXIT_CODE.CONFLICT){return"lock_conflict"}if(exitCode===EXIT_CODE.DEPENDENCY_FAILED){return"dependency_failed"}return"command_failed"}function buildPostActionTelemetryOutcome(){const result=asRecordOrNull(getActiveCommandResult());const processExitCode=typeof process.exitCode==="number"&&Number.isFinite(process.exitCode)?Math.max(0,Math.trunc(process.exitCode)):void 0;const resultExitCode=readRecordNumber(result,"exit_code","exitCode");const exitCode=processExitCode??resultExitCode??EXIT_CODE.SUCCESS;const ok=isPmSuccessfulExitCode(exitCode);const errorCode=readRecordString(result,"error_code","errorCode")??inferPostActionErrorCode(ok,exitCode);const errorCategory=normalizeTelemetryErrorCategory(readRecordString(result,"error_category","errorCategory"))??(!ok?resolveTelemetryErrorCategory(errorCode):void 0);const errorMessage=!ok?inferPostActionFailureMessage(result)??`command_exit_${exitCode}`:void 0;const commandResolution=normalizeTelemetryCommandResolution(readRecordString(result,"command_resolution","commandResolution"))??deriveTelemetryCommandResolution({ok,errorCode,errorCategory});const resolutionStage=normalizeTelemetryResolutionStage(readRecordString(result,"resolution_stage","resolutionStage"))??"execute";return{ok,error:errorMessage,exit_code:exitCode,error_code:errorCode,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:resolutionStage}}export{buildPostActionTelemetryOutcome,inferPostActionErrorCode,inferPostActionFailureMessage,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,readRecordBoolean,readRecordNumber,readRecordString};
+(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]="6d83c356-db56-5116-9fe7-e0c27973b36f")}catch{}})();import{isPmSuccessfulExitCode}from"../../sdk/cli-contracts/command-exit-contracts.js";import{EXIT_CODE,asRecordOrNull,deriveTelemetryCommandResolution,getActiveCommandResult,resolveTelemetryErrorCategory}from"../../sdk/runtime-primitives.js";const TELEMETRY_COMMAND_RESOLUTION_SET=new Set(["success","nonexistent_command","invalid_option","missing_required_option","missing_required_argument","invalid_usage","validation_failed","health_findings","validation_findings","conflict","runtime_failed","unknown_failed"]),TELEMETRY_RESOLUTION_STAGE_SET=new Set(["parse","preflight","execute","unknown"]),TELEMETRY_ERROR_CATEGORY_SET=new Set(["usage","validation","conflict","runtime","unknown"]);function readRecordString(record,...keys){if(record)for(const key of keys){const candidate=record[key];if(typeof candidate=="string"){const normalized=candidate.trim();if(normalized.length>0)return normalized}}}function readRecordBoolean(record,...keys){if(record)for(const key of keys){const candidate=record[key];if(typeof candidate=="boolean")return candidate}}function readRecordNumber(record,...keys){if(record)for(const key of keys){const candidate=record[key];if(typeof candidate=="number"&&Number.isFinite(candidate))return Math.max(0,Math.trunc(candidate))}}function normalizeTelemetryCommandResolution(value){if(!value)return;const normalized=value.trim().toLowerCase();if(TELEMETRY_COMMAND_RESOLUTION_SET.has(normalized))return normalized}function normalizeTelemetryResolutionStage(value){if(!value)return;const normalized=value.trim().toLowerCase();if(TELEMETRY_RESOLUTION_STAGE_SET.has(normalized))return normalized}function normalizeTelemetryErrorCategory(value){if(!value)return;const normalized=value.trim().toLowerCase();if(TELEMETRY_ERROR_CATEGORY_SET.has(normalized))return normalized}function inferPostActionFailureMessage(result){const explicit=readRecordString(result,"error","message");if(explicit)return explicit;const warnings=result?.warnings;if(Array.isArray(warnings)){const firstWarning=warnings.find(value=>typeof value=="string"&&value.trim().length>0);if(typeof firstWarning=="string")return firstWarning.trim()}if(readRecordBoolean(result,"fail_on_skipped_triggered","failOnSkippedTriggered"))return"linked_test_fail_on_skipped_triggered";const failedCount=readRecordNumber(result,"failed");if(typeof failedCount=="number"&&failedCount>0)return`failed_runs:${failedCount}`;const runResults=result?.run_results;if(Array.isArray(runResults)){const failedRuns=runResults.filter(entry=>asRecordOrNull(entry)?.status==="failed").length;if(failedRuns>0)return`failed_runs:${failedRuns}`}}function inferPostActionErrorCode(ok,exitCode){if(!ok)return exitCode===EXIT_CODE.USAGE?"invalid_command_usage":exitCode===EXIT_CODE.NOT_FOUND?"item_not_found":exitCode===EXIT_CODE.CONFLICT?"lock_conflict":exitCode===EXIT_CODE.DEPENDENCY_FAILED?"dependency_failed":"command_failed"}function buildPostActionTelemetryOutcome(){const result=asRecordOrNull(getActiveCommandResult()),processExitCode=typeof process.exitCode=="number"&&Number.isFinite(process.exitCode)?Math.max(0,Math.trunc(process.exitCode)):void 0,resultExitCode=readRecordNumber(result,"exit_code","exitCode"),exitCode=processExitCode??resultExitCode??EXIT_CODE.SUCCESS,ok=isPmSuccessfulExitCode(exitCode),errorCode=readRecordString(result,"error_code","errorCode")??inferPostActionErrorCode(ok,exitCode),errorCategory=normalizeTelemetryErrorCategory(readRecordString(result,"error_category","errorCategory"))??(ok?void 0:resolveTelemetryErrorCategory(errorCode)),errorMessage=ok?void 0:inferPostActionFailureMessage(result)??`command_exit_${exitCode}`,commandResolution=normalizeTelemetryCommandResolution(readRecordString(result,"command_resolution","commandResolution"))??deriveTelemetryCommandResolution({ok,errorCode,errorCategory}),resolutionStage=normalizeTelemetryResolutionStage(readRecordString(result,"resolution_stage","resolutionStage"))??"execute";return{ok,error:errorMessage,exit_code:exitCode,error_code:errorCode,error_category:errorCategory,command_resolution:commandResolution,resolution_stage:resolutionStage}}export{buildPostActionTelemetryOutcome,inferPostActionErrorCode,inferPostActionFailureMessage,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,readRecordBoolean,readRecordNumber,readRecordString};
 //# sourceMappingURL=telemetry-outcome.js.map

package/dist/cli/runtime-compatibility-boundary.js

@@ -1,5 +1,5 @@
-!(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]="c15316ee-55fe-542f-b9e7-cbc592879487")}catch(e2){}})();import{formatPmCliErrorForDisplay,formatPmCliErrorForJson}from"./error-guidance.js";import{assertProjectRuntimeCompatibility,PmCliError}from"../sdk/environment/project-runtime-compatibility.js";import{parseBootstrapGlobalOptions}from"../sdk/cli-bootstrap.js";async function runRuntimeCompatibleCli(options){const jsonOutput=parseBootstrapGlobalOptions([...options.argv]).json;let pendingJsonWarning;try{if(options.executingVersion!==void 0){const compatibility=assertProjectRuntimeCompatibility({executingVersion:options.executingVersion,projectRoot:options.projectRoot,argv:options.argv,allowStale:options.allowStale});if(compatibility.warning!==void 0){if(jsonOutput){pendingJsonWarning=`${JSON.stringify({type:"warning",...compatibility.warning})}
-`}else{options.writeError(`[pm] warning: ${compatibility.warning.code} \u2014 ${compatibility.warning.message} Running ${compatibility.warning.executing_version}; project pin ${compatibility.warning.project_version} (${compatibility.warning.source}). ${compatibility.warning.next_steps[0]}
-`)}}}await options.run();if(pendingJsonWarning!==void 0&&Number(process.exitCode??0)===0){options.writeError(pendingJsonWarning)}}catch(error){if(!(error instanceof PmCliError))throw error;options.writeError(`${jsonOutput?JSON.stringify(formatPmCliErrorForJson(error.message,error.exitCode,error.context),null,2):formatPmCliErrorForDisplay(error.message,error.context)}
-`);process.exitCode=error.exitCode}}export{runRuntimeCompatibleCli};
+(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]="8b8f676c-1903-5f73-98b9-e20eff8d7a11")}catch{}})();import{formatPmCliErrorForDisplay,formatPmCliErrorForJson}from"./error-guidance.js";import{assertProjectRuntimeCompatibility,PmCliError}from"../sdk/environment/project-runtime-compatibility.js";import{parseBootstrapGlobalOptions}from"../sdk/cli-bootstrap.js";async function runRuntimeCompatibleCli(options){const jsonOutput=parseBootstrapGlobalOptions([...options.argv]).json;let pendingJsonWarning;try{if(options.executingVersion!==void 0){const compatibility=assertProjectRuntimeCompatibility({executingVersion:options.executingVersion,projectRoot:options.projectRoot,argv:options.argv,allowStale:options.allowStale});compatibility.warning!==void 0&&(jsonOutput?pendingJsonWarning=`${JSON.stringify({type:"warning",...compatibility.warning})}
+`:options.writeError(`[pm] warning: ${compatibility.warning.code} \u2014 ${compatibility.warning.message} Running ${compatibility.warning.executing_version}; project pin ${compatibility.warning.project_version} (${compatibility.warning.source}). ${compatibility.warning.next_steps[0]}
+`))}await options.run(),pendingJsonWarning!==void 0&&Number(process.exitCode??0)===0&&options.writeError(pendingJsonWarning)}catch(error){if(!(error instanceof PmCliError))throw error;options.writeError(`${jsonOutput?JSON.stringify(formatPmCliErrorForJson(error.message,error.exitCode,error.context),null,2):formatPmCliErrorForDisplay(error.message,error.context)}
+`),process.exitCode=error.exitCode}}export{runRuntimeCompatibleCli};
 //# sourceMappingURL=runtime-compatibility-boundary.js.map

package/dist/cli/schema/registration.js

@@ -1,4 +1,4 @@
-!(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]="19c403ea-a458-5118-992c-1c68e83c702d")}catch(e2){}})();import{stringArrayOption}from"../option-values.js";import{WORKFLOW_POLICY_ACTIONS}from"../../sdk/cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError,assertSchemaPreviewSupported,createUnknownSubcommandError}from"../../sdk/runtime-primitives.js";import*as schemaModule from"../commands/workspace/schema.js";import{looksLikeSchemaSubcommandTypo,parseSchemaOrderOption}from"../schema-registration-helpers.js";import{addHiddenOption,collect,formatHookWarnings,getGlobalOptions,printError,printResult,readOptionString,writeStdout}from"../registration-helpers.js";function dispatchSchemaMigration(schema,inputs){const kind=inputs.normalizedSubcommand;if(kind!=="rename-type"&&kind!=="rename-field"&&kind!=="remap-status"){return null}return schema.runSchemaEvolutionMigration({kind,from:inputs.typeName,to:readOptionString(inputs.options,"to"),...kind==="rename-field"&&typeof inputs.options.type==="string"?{type:inputs.options.type}:{}},{migrationId:readOptionString(inputs.options,"migrationId")??readOptionString(inputs.options,"migration_id"),dryRun:inputs.options.dryRun===true,author:inputs.author,force:inputs.force},inputs.globalOptions)}function dispatchSchemaReadRemoveOrPreset(schema,inputs){const{normalizedSubcommand,typeName,globalOptions,author,force}=inputs;switch(normalizedSubcommand){case"list":return schema.runSchemaList(globalOptions);case"show":return schema.runSchemaShow(typeName,globalOptions);case"show-status":return schema.runSchemaShowStatus(typeName,globalOptions);case"list-fields":return schema.runSchemaListFields(globalOptions);case"show-field":return schema.runSchemaShowField(typeName,globalOptions);case"remove-type":return schema.runSchemaRemoveType(typeName,{author,force},globalOptions);case"remove-field":return schema.runSchemaRemoveField(typeName,{author,force},globalOptions);case"remove-status":return schema.runSchemaRemoveStatus(typeName,{author,force},globalOptions);case"apply-preset":return schema.runSchemaApplyPreset(typeName,{author,force},globalOptions);default:return null}}async function dispatchSchemaSubcommand(schema,inputs){const{normalizedSubcommand,typeName,options,globalOptions}=inputs;const{author,force,description}=inputs;const migration=dispatchSchemaMigration(schema,inputs);if(migration)return migration;const readRemoveOrPreset=dispatchSchemaReadRemoveOrPreset(schema,inputs);if(readRemoveOrPreset)return readRemoveOrPreset;switch(normalizedSubcommand){case"add-field":return schema.runSchemaAddField(typeName,{type:typeof options.type==="string"?options.type:void 0,commands:inputs.commands,description,cliFlag:typeof options.cliFlag==="string"?options.cliFlag:void 0,alias:inputs.aliases,required:Boolean(options.required),requiredOnCreate:Boolean(options.requiredOnCreate),allowUnset:options.allowUnset!==false,requiredTypes:inputs.requiredTypes,author,force},globalOptions);case"add-status":return schema.runSchemaAddStatus(typeName,{role:inputs.roles,alias:inputs.aliases,description,order:inputs.order,author,force},globalOptions);default:if(options.infer===true){return schema.runSchemaInferTypes({minCount:inputs.minCount,apply:Boolean(options.apply),author,force},globalOptions)}return schema.runSchemaAddType(typeName,{description,defaultStatus:inputs.defaultStatus,folder:typeof options.folder==="string"?options.folder:void 0,alias:inputs.aliases,author,force},globalOptions)}}function renderSchemaResultHuman(schema,result){if("migration_id"in result){writeStdout(`${schema.formatSchemaEvolutionMigrationHuman(result)}
+(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]="f3dbaad8-f73e-5d14-aeaa-aaf077a944f6")}catch{}})();import{stringArrayOption}from"../option-values.js";import{WORKFLOW_POLICY_ACTIONS}from"../../sdk/cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError,assertSchemaPreviewSupported,createUnknownSubcommandError}from"../../sdk/runtime-primitives.js";import*as schemaModule from"../commands/workspace/schema.js";import{looksLikeSchemaSubcommandTypo,parseSchemaOrderOption}from"../schema-registration-helpers.js";import{addHiddenOption,collect,formatHookWarnings,getGlobalOptions,printError,printResult,readOptionString,writeStdout}from"../registration-helpers.js";function dispatchSchemaMigration(schema,inputs){const kind=inputs.normalizedSubcommand;return kind!=="rename-type"&&kind!=="rename-field"&&kind!=="remap-status"?null:schema.runSchemaEvolutionMigration({kind,from:inputs.typeName,to:readOptionString(inputs.options,"to"),...kind==="rename-field"&&typeof inputs.options.type=="string"?{type:inputs.options.type}:{}},{migrationId:readOptionString(inputs.options,"migrationId")??readOptionString(inputs.options,"migration_id"),dryRun:inputs.options.dryRun===!0,author:inputs.author,force:inputs.force},inputs.globalOptions)}function dispatchSchemaReadRemoveOrPreset(schema,inputs){const{normalizedSubcommand,typeName,globalOptions,author,force}=inputs;switch(normalizedSubcommand){case"list":return schema.runSchemaList(globalOptions);case"show":return schema.runSchemaShow(typeName,globalOptions);case"show-status":return schema.runSchemaShowStatus(typeName,globalOptions);case"list-fields":return schema.runSchemaListFields(globalOptions);case"show-field":return schema.runSchemaShowField(typeName,globalOptions);case"remove-type":return schema.runSchemaRemoveType(typeName,{author,force},globalOptions);case"remove-field":return schema.runSchemaRemoveField(typeName,{author,force},globalOptions);case"remove-status":return schema.runSchemaRemoveStatus(typeName,{author,force},globalOptions);case"apply-preset":return schema.runSchemaApplyPreset(typeName,{author,force},globalOptions);default:return null}}async function dispatchSchemaSubcommand(schema,inputs){const{normalizedSubcommand,typeName,options,globalOptions}=inputs,{author,force,description}=inputs,migration=dispatchSchemaMigration(schema,inputs);if(migration)return migration;const readRemoveOrPreset=dispatchSchemaReadRemoveOrPreset(schema,inputs);if(readRemoveOrPreset)return readRemoveOrPreset;switch(normalizedSubcommand){case"add-field":return schema.runSchemaAddField(typeName,{type:typeof options.type=="string"?options.type:void 0,commands:inputs.commands,description,cliFlag:typeof options.cliFlag=="string"?options.cliFlag:void 0,alias:inputs.aliases,required:!!options.required,requiredOnCreate:!!options.requiredOnCreate,allowUnset:options.allowUnset!==!1,requiredTypes:inputs.requiredTypes,author,force},globalOptions);case"add-status":return schema.runSchemaAddStatus(typeName,{role:inputs.roles,alias:inputs.aliases,description,order:inputs.order,author,force},globalOptions);default:return options.infer===!0?schema.runSchemaInferTypes({minCount:inputs.minCount,apply:!!options.apply,author,force},globalOptions):schema.runSchemaAddType(typeName,{description,defaultStatus:inputs.defaultStatus,folder:typeof options.folder=="string"?options.folder:void 0,alias:inputs.aliases,author,force},globalOptions)}}function renderSchemaResultHuman(schema,result){if("migration_id"in result){writeStdout(`${schema.formatSchemaEvolutionMigrationHuman(result)}
 `);return}switch(result.action){case"list":writeStdout(`${schema.formatSchemaListHuman(result)}
 `);return;case"show":writeStdout(`${schema.formatSchemaShowHuman(result)}
 `);return;case"show-status":writeStdout(`${schema.formatSchemaShowStatusHuman(result)}
@@ -12,5 +12,5 @@
 `);break;case"add-status":writeStdout(`${schema.formatSchemaAddStatusHuman(result)}
 `);break;case"remove-status":writeStdout(`${schema.formatSchemaRemoveStatusHuman(result)}
 `);break;default:writeStdout(`${schema.formatSchemaAddTypeHuman(result)}
-`);break}if(result.warnings.length>0){printError(`schema ${result.action} warnings: ${formatHookWarnings(result.warnings)}`)}}function splitCollectedCommaList(raw){if(!Array.isArray(raw)){return void 0}return raw.flatMap(value=>value.split(",")).map(value=>value.trim()).filter(value=>value.length>0)}async function runSchemaAction(subcommand,name,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const{SCHEMA_SUBCOMMANDS}=schemaModule;let normalizedSubcommand=(subcommand??"").trim().toLowerCase();let typeName=name;assertSchemaSubcommandPresent(normalizedSubcommand,SCHEMA_SUBCOMMANDS);if(!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)&&typeName===void 0&&!looksLikeSchemaSubcommandTypo(subcommand)){typeName=subcommand;normalizedSubcommand="add-type"}if(!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)){throw createUnknownSubcommandError({command_path:"schema",token:normalizedSubcommand,allowed:SCHEMA_SUBCOMMANDS})}const policyAction=WORKFLOW_POLICY_ACTIONS.find(action=>action===normalizedSubcommand);assertSchemaPreviewSupported(normalizedSubcommand,options.dryRun===true);if(policyAction){printResult(await schemaModule.runWorkflowPolicyAction(policyAction,name,{definition:options.definition,policy:readOptionString(options,"policy"),message:readOptionString(options,"message"),author:readOptionString(options,"author"),dryRun:options.dryRun===true},globalOptions),globalOptions)}else{const result=await dispatchSchemaSubcommand(schemaModule,{normalizedSubcommand,typeName,options,aliases:stringArrayOption(options.alias),roles:stringArrayOption(options.role),commands:splitCollectedCommaList(options.commands),requiredTypes:splitCollectedCommaList(options.requiredTypes),defaultStatus:readOptionString(options,"defaultStatus")??readOptionString(options,"default_status"),order:parseSchemaOrderOption(options.order),minCount:parseSchemaOrderOption(options.minCount),author:readOptionString(options,"author"),force:Boolean(options.force),description:readOptionString(options,"description"),globalOptions});if(globalOptions.json===true||globalOptions.defaultOutputFormat==="json"){printResult(result,globalOptions)}else if(!globalOptions.quiet){renderSchemaResultHuman(schemaModule,result)}}if(globalOptions.profile){printError(`profile:command=schema took_ms=${Date.now()-startedAt}`)}}function assertSchemaSubcommandPresent(normalizedSubcommand,allowed){if(normalizedSubcommand){return}throw new PmCliError(`pm schema requires a subcommand. Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:["pm schema list","pm schema show Task","pm schema show-status open",'pm schema add-type Spike --description "Time-boxed investigation" --default-status open',"pm schema remove-type Spike","pm schema add-status review --role active --alias in_review","pm schema remove-status review","pm schema add-field severity_level --type string --commands create,update","pm schema list-fields","pm schema apply-preset agile","pm schema add-type --infer --min-count 10","pm schema rename-type Spike --to Experiment --migration-id spike-v2 --dry-run","pm schema rename-field severity --to impact --migration-id severity-v2","pm schema remap-status review --to verifying --migration-id review-v2"]})}function registerSchemaCommand(program){const schemaCommand=program.command("schema").option("--definition <json>","Policy or proposed fields JSON").option("--policy <id>","Policy id for policy-approve").option("--message <text>","Audit rationale for a policy mutation").argument("[subcommand]","Required; schema verb (list/show, add/remove, rename/remap, policy-*), or custom type shorthand").argument("[name]","Definition/source name or item id; policy-mode: advise|refuse").option("--description <text>","Type, status, or field description").option("--default-status <status>","Default status for this type").option("--folder <dir>","Storage folder for items of this custom type").option("--alias <name>","Alias for the custom type, status, or field flag (repeatable, csv-friendly)",collect).option("--role <value>","Lifecycle role for a custom status (repeatable): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel",collect).option("--order <n>","Display/sort order for a custom status").optionsGroup("Field options (add-field):").option("--type <type>","Value type for a custom field (add-field): string, number, boolean, string_array, array, object").option("--commands <list>","Field commands (repeatable/csv): create, update, update_many, list, search, calendar, context",collect).option("--cli-flag <flag>","Override the auto-derived CLI flag for a custom field (add-field)").option("--required","Mark a custom field as always required (add-field)").option("--required-on-create","Mark a custom field as required at create time (add-field)").option("--no-allow-unset","Disallow clearing a custom field via --unset (add-field)").option("--required-types <list>","Restrict a custom field's requirement to specific item types (add-field; repeatable, comma-friendly)",collect).optionsGroup("Type inference and migration options:").option("--infer","Infer custom item types from title-prefix conventions (add-type; preview unless --apply)").option("--min-count <n>","Minimum items sharing a prefix for add-type --infer (default 10)").option("--apply","Register inferred types (add-type --infer); without it the command previews only").option("--to <name>","Target definition name for rename/remap migrations").option("--migration-id <id>","Stable idempotency key for a resumable schema migration").option("--dry-run","Preview rename/remap migrations and workflow-policy actions without writes").option("--author <value>","Mutation author").option("--force","Force ownership/lock override").description("Manage types, statuses, fields, presets, and workflow policies.");addHiddenOption(schemaCommand,"--default_status <status>","Alias for --default-status",false);addHiddenOption(schemaCommand,"--migration_id <id>","Alias for --migration-id",false);schemaCommand.action(runSchemaAction)}export{registerSchemaCommand};
+`);break}result.warnings.length>0&&printError(`schema ${result.action} warnings: ${formatHookWarnings(result.warnings)}`)}function splitCollectedCommaList(raw){if(Array.isArray(raw))return raw.flatMap(value=>value.split(",")).map(value=>value.trim()).filter(value=>value.length>0)}async function runSchemaAction(subcommand,name,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),{SCHEMA_SUBCOMMANDS}=schemaModule;let normalizedSubcommand=(subcommand??"").trim().toLowerCase(),typeName=name;if(assertSchemaSubcommandPresent(normalizedSubcommand,SCHEMA_SUBCOMMANDS),!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand)&&typeName===void 0&&!looksLikeSchemaSubcommandTypo(subcommand)&&(typeName=subcommand,normalizedSubcommand="add-type"),!SCHEMA_SUBCOMMANDS.includes(normalizedSubcommand))throw createUnknownSubcommandError({command_path:"schema",token:normalizedSubcommand,allowed:SCHEMA_SUBCOMMANDS});const policyAction=WORKFLOW_POLICY_ACTIONS.find(action=>action===normalizedSubcommand);if(assertSchemaPreviewSupported(normalizedSubcommand,options.dryRun===!0),policyAction)printResult(await schemaModule.runWorkflowPolicyAction(policyAction,name,{definition:options.definition,policy:readOptionString(options,"policy"),message:readOptionString(options,"message"),author:readOptionString(options,"author"),dryRun:options.dryRun===!0},globalOptions),globalOptions);else{const result=await dispatchSchemaSubcommand(schemaModule,{normalizedSubcommand,typeName,options,aliases:stringArrayOption(options.alias),roles:stringArrayOption(options.role),commands:splitCollectedCommaList(options.commands),requiredTypes:splitCollectedCommaList(options.requiredTypes),defaultStatus:readOptionString(options,"defaultStatus")??readOptionString(options,"default_status"),order:parseSchemaOrderOption(options.order),minCount:parseSchemaOrderOption(options.minCount),author:readOptionString(options,"author"),force:!!options.force,description:readOptionString(options,"description"),globalOptions});globalOptions.json===!0||globalOptions.defaultOutputFormat==="json"?printResult(result,globalOptions):globalOptions.quiet||renderSchemaResultHuman(schemaModule,result)}globalOptions.profile&&printError(`profile:command=schema took_ms=${Date.now()-startedAt}`)}function assertSchemaSubcommandPresent(normalizedSubcommand,allowed){if(!normalizedSubcommand)throw new PmCliError(`pm schema requires a subcommand. Allowed: ${allowed.join(", ")}`,EXIT_CODE.USAGE,{code:"missing_required_argument",examples:["pm schema list","pm schema show Task","pm schema show-status open",'pm schema add-type Spike --description "Time-boxed investigation" --default-status open',"pm schema remove-type Spike","pm schema add-status review --role active --alias in_review","pm schema remove-status review","pm schema add-field severity_level --type string --commands create,update","pm schema list-fields","pm schema apply-preset agile","pm schema add-type --infer --min-count 10","pm schema rename-type Spike --to Experiment --migration-id spike-v2 --dry-run","pm schema rename-field severity --to impact --migration-id severity-v2","pm schema remap-status review --to verifying --migration-id review-v2"]})}function registerSchemaCommand(program){const schemaCommand=program.command("schema").option("--definition <json>","Policy or proposed fields JSON").option("--policy <id>","Policy id for policy-approve").option("--message <text>","Audit rationale for a policy mutation").argument("[subcommand]","Required; schema verb (list/show, add/remove, rename/remap, policy-*), or custom type shorthand").argument("[name]","Definition/source name or item id; policy-mode: advise|refuse").option("--description <text>","Type, status, or field description").option("--default-status <status>","Default status for this type").option("--folder <dir>","Storage folder for items of this custom type").option("--alias <name>","Alias for the custom type, status, or field flag (repeatable, csv-friendly)",collect).option("--role <value>","Lifecycle role for a custom status (repeatable): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel",collect).option("--order <n>","Display/sort order for a custom status").optionsGroup("Field options (add-field):").option("--type <type>","Value type for a custom field (add-field): string, number, boolean, string_array, array, object").option("--commands <list>","Field commands (repeatable/csv): create, update, update_many, list, search, calendar, context",collect).option("--cli-flag <flag>","Override the auto-derived CLI flag for a custom field (add-field)").option("--required","Mark a custom field as always required (add-field)").option("--required-on-create","Mark a custom field as required at create time (add-field)").option("--no-allow-unset","Disallow clearing a custom field via --unset (add-field)").option("--required-types <list>","Restrict a custom field's requirement to specific item types (add-field; repeatable, comma-friendly)",collect).optionsGroup("Type inference and migration options:").option("--infer","Infer custom item types from title-prefix conventions (add-type; preview unless --apply)").option("--min-count <n>","Minimum items sharing a prefix for add-type --infer (default 10)").option("--apply","Register inferred types (add-type --infer); without it the command previews only").option("--to <name>","Target definition name for rename/remap migrations").option("--migration-id <id>","Stable idempotency key for a resumable schema migration").option("--dry-run","Preview rename/remap migrations and workflow-policy actions without writes").option("--author <value>","Mutation author").option("--force","Force ownership/lock override").description("Manage types, statuses, fields, presets, and workflow policies.");addHiddenOption(schemaCommand,"--default_status <status>","Alias for --default-status",!1),addHiddenOption(schemaCommand,"--migration_id <id>","Alias for --migration-id",!1),schemaCommand.action(runSchemaAction)}export{registerSchemaCommand};
 //# sourceMappingURL=registration.js.map

package/dist/cli/schema-registration-helpers.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]="89de1556-ed75-5c37-bc98-164490364567")}catch(e2){}})();import{EXIT_CODE,PmCliError,isPureSnakeCaseAlias}from"../sdk/runtime-primitives.js";const SCHEMA_SHORTHAND_RESERVED_PREFIXES=["add-","apply-","list-","remove-","show-"];const SCHEMA_SHORTHAND_RESERVED_TOKENS=new Set(["field","fields","help","status","statuses","type","types"]);function looksLikeSchemaSubcommandTypo(value){const trimmed=value.trim();const normalized=trimmed.toLowerCase();if(normalized.length===0){return false}return trimmed[0]===normalized[0]||SCHEMA_SHORTHAND_RESERVED_TOKENS.has(normalized)||SCHEMA_SHORTHAND_RESERVED_PREFIXES.some(prefix=>normalized.startsWith(prefix))}function parseSchemaOrderOption(raw){if(raw===void 0||raw===null){return void 0}if(typeof raw==="number"){if(!Number.isInteger(raw)){throw new PmCliError("--order must be a finite integer.",EXIT_CODE.USAGE)}return raw}if(typeof raw==="string"){if(raw.trim().length===0){return void 0}const parsed=Number(raw);if(!Number.isInteger(parsed)){throw new PmCliError("--order must be a finite integer.",EXIT_CODE.USAGE)}return parsed}throw new PmCliError("--order must be a finite integer.",EXIT_CODE.USAGE)}export{isPureSnakeCaseAlias,looksLikeSchemaSubcommandTypo,parseSchemaOrderOption};
+(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]="016842ad-f6e8-56a4-9b9f-f4eaf4c1be71")}catch{}})();import{EXIT_CODE,PmCliError,isPureSnakeCaseAlias}from"../sdk/runtime-primitives.js";const SCHEMA_SHORTHAND_RESERVED_PREFIXES=["add-","apply-","list-","remove-","show-"],SCHEMA_SHORTHAND_RESERVED_TOKENS=new Set(["field","fields","help","status","statuses","type","types"]);function looksLikeSchemaSubcommandTypo(value){const trimmed=value.trim(),normalized=trimmed.toLowerCase();return normalized.length===0?!1:trimmed[0]===normalized[0]||SCHEMA_SHORTHAND_RESERVED_TOKENS.has(normalized)||SCHEMA_SHORTHAND_RESERVED_PREFIXES.some(prefix=>normalized.startsWith(prefix))}function parseSchemaOrderOption(raw){if(raw!=null){if(typeof raw=="number"){if(!Number.isInteger(raw))throw new PmCliError("--order must be a finite integer.",EXIT_CODE.USAGE);return raw}if(typeof raw=="string"){if(raw.trim().length===0)return;const parsed=Number(raw);if(!Number.isInteger(parsed))throw new PmCliError("--order must be a finite integer.",EXIT_CODE.USAGE);return parsed}throw new PmCliError("--order must be a finite integer.",EXIT_CODE.USAGE)}}export{isPureSnakeCaseAlias,looksLikeSchemaSubcommandTypo,parseSchemaOrderOption};
 //# sourceMappingURL=schema-registration-helpers.js.map

package/dist/cli/search-refresh.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-!(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]="d7f84fe3-8eb4-585e-b4f1-2414a4beec4c")}catch(e2){}})();import{runSearchRefreshWorkerEntrypoint}from"../sdk/search-refresh-worker.js";await runSearchRefreshWorkerEntrypoint();
+(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]="d7f84fe3-8eb4-585e-b4f1-2414a4beec4c")}catch{}})();import{runSearchRefreshWorkerEntrypoint}from"../sdk/search-refresh-worker.js";await runSearchRefreshWorkerEntrypoint();
 //# sourceMappingURL=search-refresh.js.map

package/dist/cli/stats-analytics-json.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]="3ae42f02-fdd3-5ca6-8c0b-e01e5f6bd95d")}catch(e2){}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";const STATS_ANALYTICS_JSON_FIELDS=new Map([["measurements","boolean"],["metric","string"],["measurementLimit","number"],["observe","string_array"],["direction","direction"],["measurementSource","string"],["measurementItem","string"],["measurementRevision","string"],["author","string"],["message","string"],["provenanceCoverage","boolean"],["fleetAttribution","boolean"],["since","string"],["eventLimit","number"],["minimumSample","number"]]);const IMPROVEMENT_DIRECTIONS=new Set(["higher","lower","target"]);const ACCEPTED_STATS_ANALYTICS_JSON_FIELDS=[...STATS_ANALYTICS_JSON_FIELDS.keys()].sort((left,right)=>left.localeCompare(right)).join(", ");function isStatsAnalyticsValue(expected,value){if(expected==="boolean")return typeof value==="boolean";if(expected==="string")return typeof value==="string";if(expected==="number")return typeof value==="number";if(expected==="string_array"){return Array.isArray(value)&&value.every(entry=>typeof entry==="string")}return expected==="direction"&&IMPROVEMENT_DIRECTIONS.has(value)}function parseStatsAnalyticsJson(input){if(input===void 0)return{};let parsed;try{parsed=JSON.parse(input)}catch(error){throw new PmCliError(`--analytics must be valid JSON: ${String(error)}`,EXIT_CODE.USAGE)}if(parsed===null||typeof parsed!=="object"||Array.isArray(parsed)){throw new PmCliError("--analytics must be a JSON object.",EXIT_CODE.USAGE)}for(const[key,value]of Object.entries(parsed)){const expected=STATS_ANALYTICS_JSON_FIELDS.get(key);if(!isStatsAnalyticsValue(expected,value)){throw new PmCliError(expected===void 0?`Unknown --analytics field "${key}". Accepted fields: ${ACCEPTED_STATS_ANALYTICS_JSON_FIELDS}.`:`--analytics field "${key}" must be ${expected.replace("_"," ")}.`,EXIT_CODE.USAGE)}}return parsed}export{parseStatsAnalyticsJson};
+(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]="c3d9f24a-7089-5d60-ab12-93d03b86da80")}catch{}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";const STATS_ANALYTICS_JSON_FIELDS=new Map([["measurements","boolean"],["metric","string"],["measurementLimit","number"],["observe","string_array"],["direction","direction"],["measurementSource","string"],["measurementItem","string"],["measurementRevision","string"],["author","string"],["message","string"],["provenanceCoverage","boolean"],["fleetAttribution","boolean"],["since","string"],["eventLimit","number"],["minimumSample","number"]]),IMPROVEMENT_DIRECTIONS=new Set(["higher","lower","target"]),ACCEPTED_STATS_ANALYTICS_JSON_FIELDS=[...STATS_ANALYTICS_JSON_FIELDS.keys()].sort((left,right)=>left.localeCompare(right)).join(", ");function isStatsAnalyticsValue(expected,value){return expected==="boolean"?typeof value=="boolean":expected==="string"?typeof value=="string":expected==="number"?typeof value=="number":expected==="string_array"?Array.isArray(value)&&value.every(entry=>typeof entry=="string"):expected==="direction"&&IMPROVEMENT_DIRECTIONS.has(value)}function parseStatsAnalyticsJson(input){if(input===void 0)return{};let parsed;try{parsed=JSON.parse(input)}catch(error){throw new PmCliError(`--analytics must be valid JSON: ${String(error)}`,EXIT_CODE.USAGE)}if(parsed===null||typeof parsed!="object"||Array.isArray(parsed))throw new PmCliError("--analytics must be a JSON object.",EXIT_CODE.USAGE);for(const[key,value]of Object.entries(parsed)){const expected=STATS_ANALYTICS_JSON_FIELDS.get(key);if(!isStatsAnalyticsValue(expected,value))throw new PmCliError(expected===void 0?`Unknown --analytics field "${key}". Accepted fields: ${ACCEPTED_STATS_ANALYTICS_JSON_FIELDS}.`:`--analytics field "${key}" must be ${expected.replace("_"," ")}.`,EXIT_CODE.USAGE)}return parsed}export{parseStatsAnalyticsJson};
 //# sourceMappingURL=stats-analytics-json.js.map