@unbrained/pm-cli 2026.9.20 → 2026.9.22

package/dist/cli/register-operations.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]="c5ff47ea-87e0-5c51-b84a-6b1c03d62ed9")}catch(e2){}})();import{resolvePmCommandAlias,renderPmCommandAliasMigrationHint}from"../sdk/cli-contracts/command-aliases.js";import{setActiveCommandResult,EXIT_CODE,PmCliError,createUnknownSubcommandError,resolveAuthor,resolvePmRoot,readSettings}from"../sdk/runtime-primitives.js";import{runStartTask,runPauseTask,runCloseTask}from"../sdk/lifecycle/task-composition.js";import{parseStatsAnalyticsJson}from"./stats-analytics-json.js";import{createWorkspaceSnapshot,deleteWorkspaceSnapshot,inspectWorkspaceSnapshot,listWorkspaceSnapshots,planWorkspaceSnapshotRestore,restoreWorkspaceSnapshotWithRecovery,WORKSPACE_SNAPSHOT_ACTIONS}from"../sdk/workspace-snapshot.js";import{readWorkspacePosition}from"../sdk/governance/workspace-position.js";import{runClaim,runClaimNext,runRelease}from"./commands/claim.js";import{runContracts}from"./commands/contracts.js";import{runDuplicates}from"./commands/duplicates.js";import{runGc}from"./commands/gc.js";import{runHealth}from"./commands/health.js";import{runStats}from"./commands/stats.js";import{runTelemetry}from"./commands/telemetry.js";import{runTest}from"./commands/test.js";import{runTestAll}from"./commands/test-all.js";import{runStartBackgroundRun,runTestRunsWorker}from"./commands/test-runs.js";import{runValidate}from"./commands/validate.js";import{buildBackgroundTestAllCommandArgs,applyActiveCommandResultService,buildBackgroundTestCommandArgs,addHiddenOption,collect,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";import{registerAssuranceCommand}from"./register-assurance.js";function resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand){const normalizedNamespace=namespaceOrSubcommand?.trim().toLowerCase();const normalizedSubcommand=subcommand?.trim().toLowerCase();if(normalizedNamespace===void 0||normalizedNamespace.length===0){return normalizedSubcommand}if(normalizedNamespace==="local-analytics"){return normalizedSubcommand&&normalizedSubcommand.length>0?normalizedSubcommand:"status"}if(normalizedSubcommand!==void 0&&normalizedSubcommand.length>0){throw createUnknownSubcommandError({command_path:"telemetry",token:`${namespaceOrSubcommand} ${subcommand}`,allowed:["status","flush","stats","clear","local-analytics"],token_kind:"path",examples:["pm telemetry stats --limit 10","pm telemetry local-analytics status --json"]})}return normalizedNamespace}function collectTestMutationValues(options){return{addValues:Array.isArray(options.add)?options.add:[],addJsonValues:Array.isArray(options.addJson)?options.addJson:[],removeValues:Array.isArray(options.remove)?options.remove:[],removeIndexValues:Array.isArray(options.removeIndex)?options.removeIndex:[]}}function validateBackgroundTestOptions(options,values){if(options.background!==true){return}if(options.run!==true){throw new PmCliError("--background requires --run",EXIT_CODE.USAGE)}if(options.acknowledgeLinkedTests===true){throw new PmCliError("--background cannot be combined with --acknowledge-linked-tests; acknowledgement is a non-executing foreground operation",EXIT_CODE.USAGE)}if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||values.removeIndexValues.length>0){throw new PmCliError("--background does not support --add/--add-json/--remove/--remove-index; update linked tests first, then run in background",EXIT_CODE.USAGE)}}async function runBackgroundLinkedTests(id,options,globalOptions,values){const result=await runStartBackgroundRun({kind:"test",commandArgs:buildBackgroundTestCommandArgs(id,{...options,add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues}),targetId:id,author:typeof options.author==="string"?options.author:void 0,noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result,globalOptions)}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,list:Boolean(options.list),run:Boolean(options.run),match:typeof options.match==="string"?options.match:void 0,onlyIndex:typeof options.onlyIndex==="string"||typeof options.onlyIndex==="number"?options.onlyIndex:void 0,onlyLast:Boolean(options.onlyLast),timeout:typeof options.timeout==="string"?options.timeout:void 0,progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:typeof options.pmContext==="string"?options.pmContext:void 0,overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:typeof options.workspaceContext==="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),acknowledgeLinkedTests:Boolean(options.acknowledgeLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext),author:typeof options.author==="string"?options.author:void 0,message:typeof options.message==="string"?options.message:void 0,force:Boolean(options.force),measure:Array.isArray(options.measure)?options.measure:[],metricBelow:typeof options.metricBelow==="string"?options.metricBelow:void 0,metricDiff:typeof options.metricDiff==="string"?options.metricDiff:void 0}}const _testOnlyRegisterOperations={buildRunTestOptions,buildRunTestAllOptions,runWorkspacePositionAction,validateBackgroundTestOptions};async function runForegroundLinkedTests(id,options,globalOptions,values){const result=await runTest(id,buildRunTestOptions(options,values),globalOptions);if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===true||values.removeIndexValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(result.run_results.some(entry=>entry.status==="failed")||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const values=collectTestMutationValues(options);validateBackgroundTestOptions(options,values);if(options.background===true){await runBackgroundLinkedTests(id,options,globalOptions,values)}else{await runForegroundLinkedTests(id,options,globalOptions,values)}if(globalOptions.profile){printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author");const assignee=readOptionString(options,"assignee");if(author!==void 0&&assignee!==void 0&&author!==assignee){throw new PmCliError("Lifecycle ownership received conflicting --author and --assignee values; use one actor value for both aliases.",EXIT_CODE.USAGE,{code:"conflicting_lifecycle_owner",examples:["pm claim pm-123","pm claim pm-123 --start","pm release pm-123"]})}return{author:author??assignee,message:readOptionString(options,"message")}}async function runTestAllAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const runInBackground=options.background===true;if(runInBackground){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result2,globalOptions);if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}return}const result=await runTestAll(buildRunTestAllOptions(options),globalOptions);await invalidateSearchCachesForMutation(globalOptions,{ids:result.results.map(entry=>entry.id)});printResult(result,globalOptions);if(result.failed>0||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}}function buildRunTestAllOptions(options){return{status:readOptionString(options,"status"),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset"),timeout:readOptionString(options,"timeout"),progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext)}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics"));const result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===true,storage:options.storage===true,metadataCoverage:options.metadataCoverage===true,byAssignee:options.byAssignee===true,byTag:options.byTag===true,byPriority:options.byPriority===true,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===true,...analytics});if(result.recorded_observations?.some(entry=>entry.changed)===true){await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])})}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const threshold=readOptionString(options,"threshold");const limit=readOptionString(options,"limit");const result=await runDuplicates(globalOptions,{...options.exhaustive===true?{exhaustive:true}:{},status:Array.isArray(options.status)&&options.status.length>0?options.status:void 0,since:readOptionString(options,"since"),...threshold===void 0?{}:{threshold:Number(threshold)},...limit===void 0?{}:{limit:Number(limit)}});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);const result=await runHealth(globalOptions,{strictExit,strictDirectories:Boolean(options.strictDirectories),requireMergeDrivers:Boolean(options.requireMergeDrivers),checkOnly:Boolean(options.checkOnly),checkTelemetry:Boolean(options.checkTelemetry),noRefresh:Boolean(options.noRefresh),refreshVectors:Boolean(options.refreshVectors),verboseStaleItems:Boolean(options.verboseStaleItems),verboseAuthorEvents:Boolean(options.verboseAuthorEvents),brief:Boolean(options.brief),summary:Boolean(options.summary)||strictExit,skipVectors:Boolean(options.skipVectors),skipIntegrity:Boolean(options.skipIntegrity),skipDrift:Boolean(options.skipDrift),full:Boolean(options.full)});printResult(result,globalOptions);if(strictExit&&!result.ok){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"health_findings",error_category:"validation",command_resolution:"health_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runValidate({checkMetadata:Boolean(options.checkMetadata),metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:Boolean(options.checkResolution),checkCompleteness:Boolean(options.checkCompleteness),checkLifecycle:Boolean(options.checkLifecycle),checkStaleBlockers:Boolean(options.checkStaleBlockers),dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:Boolean(options.checkFiles),checkCommandReferences:Boolean(options.checkCommandReferences),scanMode:readOptionString(options,"scanMode"),includePmInternals:Boolean(options.includePmInternals),verboseFileLists:Boolean(options.verboseFileLists),verboseDiagnostics:Boolean(options.verboseDiagnostics),allAffectedIds:Boolean(options.allAffectedIds),checkHistoryDrift:Boolean(options.checkHistoryDrift),checkStorageIntegrity:Boolean(options.checkStorageIntegrity),fixHints:Boolean(options.fixHints),autoFix:Boolean(options.autoFix),dryRun:Boolean(options.dryRun),fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:Boolean(options.pruneMissing),counts:Boolean(options.counts),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);if(strictExit&&(result.has_warnings||!result.ok)){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"validation_findings",error_category:"validation",command_resolution:"validation_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runGc(globalOptions,{dryRun:options.dryRun===true,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const normalizedAction=action.trim().toLowerCase();if(!WORKSPACE_SNAPSHOT_ACTIONS.some(entry=>entry===normalizedAction)){throw createUnknownSubcommandError({command_path:"workspace snapshot",token:action,allowed:WORKSPACE_SNAPSHOT_ACTIONS,display_name:"workspace snapshot",token_kind:"action",examples:["pm workspace snapshot create before-migration","pm workspace snapshot restore before-migration"]})}if(normalizedAction==="list"){printResult(await listWorkspaceSnapshots(pmRoot),globalOptions);return}if(normalizedAction==="create"){printResult(await createWorkspaceSnapshot(pmRoot,target===void 0?{}:{name:target}),globalOptions);return}if(target===void 0){throw new PmCliError(`pm workspace snapshot ${normalizedAction} requires a snapshot name or fingerprint`,EXIT_CODE.USAGE)}if(normalizedAction==="inspect"){printResult(await inspectWorkspaceSnapshot(pmRoot,target),globalOptions);return}if(normalizedAction==="restore"){if(options.dryRun===true){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===true,author:resolveAuthor(readOptionString(options,"author"),settings.author_default),message:readOptionString(options,"message"),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms}),globalOptions);return}printResult(await deleteWorkspaceSnapshot(pmRoot,target),globalOptions)}async function runWorkspacePositionAction(_options,command){const globalOptions=getGlobalOptions(command);printResult(await readWorkspacePosition(globalOptions),globalOptions)}async function runContractsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:Boolean(options.summary),schemaOnly:Boolean(options.schemaOnly),flagsOnly:Boolean(options.flagsOnly),availabilityOnly:Boolean(options.availabilityOnly),runtimeOnly:Boolean(options.runtimeOnly)||Boolean(options.activeOnly),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}}async function runClaimAction(id,options,command){if(options.start===true){requireClaimTarget(id,false);await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===true,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===true);const result=options.next===true?await runClaimNext(Boolean(options.force),globalOptions,lifecycleOptions,{type:typeof options.type==="string"?options.type:void 0,tag:typeof options.tag==="string"?options.tag:void 0,priority:options.priority,assigneeFilter:typeof options.assigneeFilter==="string"?options.assigneeFilter:void 0,parent:typeof options.parent==="string"?options.parent:void 0,sprint:typeof options.sprint==="string"?options.sprint:void 0,release:typeof options.release==="string"?options.release:void 0,includeDecisions:options.includeDecisions===true,includeGates:options.includeGates===true,includeContainers:options.includeContainers===true,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===true||options.explain_ranking===true}):await runClaim(id,Boolean(options.force),globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=claim took_ms=${Date.now()-startedAt}`)}}function requireClaimTarget(id,next){if(!next&&!id)throw new PmCliError("Specify an item id or pass --next",EXIT_CODE.USAGE);if(next&&id)throw new PmCliError("Specify either an item id or --next, not both",EXIT_CODE.USAGE)}async function runReleaseAction(id,options,command){if(options.pause===true){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runRelease(id,Boolean(options.force),globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===true});await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command);const alias=resolvePmCommandAlias(command.name());if(!alias||global2.json||global2.quiet)return;const settings=await readSettings(resolvePmRoot(process.cwd(),global2.path));if(settings.ux?.deprecation_hints)printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force),next:options.next===true,ifAvailable:options.ifAvailable===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=start-task took_ms=${Date.now()-startedAt}`)}}async function runPauseTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=pause-task took_ms=${Date.now()-startedAt}`)}}async function runCloseTaskAction(id,reason,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close-task took_ms=${Date.now()-startedAt}`)}}function addLinkedTestExecutionOptions(command){return command.option("--background","Run linked tests in managed background mode").option("--timeout <seconds>","Default run timeout in seconds").option("--progress","Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>","Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear environment variable(s) for linked-test runs (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>","PM linked-test context mode: schema|tracker|auto (default: schema)").option("--override-linked-pm-context","Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Force run-level --workspace-context over per-linked-test metadata").option("--allow-untrusted-linked-tests","Execute untrusted linked commands when project policy also permits it").option("--fail-on-context-mismatch","Fail linked PM commands when context item counts differ").option("--fail-on-skipped","Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run","Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context","Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context")}function registerOperationCommands(program){registerAssuranceCommand(program);const testCommand=program.command("test").argument("<id>","Item id").option("--add <value>","Add verified isolated test (CSV/markdown or stdin)",collect).option("--add-json <value>","Add verified isolated test (JSON object/array or stdin)",collect).option("--remove <value>","Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin)",collect).option("--remove-index <n>","Remove the 1-based linked-test index from --list order (repeatable)",collect).option("--list","List linked tests without mutating").option("--run","Run linked test commands").option("--match <value>","Run only linked tests whose command/path contains this substring").option("--only-index <n>","Run only the 1-based linked-test index from --list order").option("--only-last","Run only the most recently added linked test");testCommand.option("--acknowledge-linked-tests","Trust the item's current linked commands in this clone without executing them");addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...] evidence; repeatable",collect).option("--metric-below <value>","Return evidence below name=value").option("--metric-diff <name>","Diff the latest two values").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage tests linked to an item and optionally run them.").action(runTestCommandAction);const testAllCommand=program.command("test-all").description("Run linked tests across matching items.").option("--status <value>","Filter items by status before running tests").option("--limit <n>","Limit matching items before running linked tests").option("--offset <n>","Skip matching items before running linked tests");addLinkedTestExecutionOptions(testAllCommand).action(runTestAllAction);program.command("test-runs-worker",{hidden:true}).argument("<runId>","Background run id").description("Internal background worker command.").action(async(runId,_options,command)=>{const globalOptions=getGlobalOptions(command);await runTestRunsWorker(runId,globalOptions)});program.command("telemetry").argument("[namespace-or-subcommand]","Telemetry subcommand: status, flush, stats, clear (default: status)").argument("[subcommand]","Compatibility alias target for local-analytics: status, flush, stats, clear").option("--limit <n>","Maximum command groups returned by telemetry stats").description("Inspect and manage local telemetry queue/runtime state.").action(runTelemetryAction);program.command("duplicates").description("Find duplicate clusters across all statuses.").option("--status <value>","Statuses (repeatable or comma-separated)",collect,[]).option("--since <value>","Created at or after this time").option("--threshold <value>","Minimum similarity (0-1)").option("--limit <n>","Maximum clusters").option("--exhaustive","Score all pairs within the safety bound").action(runDuplicatesAction);program.command("stats").description("Show project tracker statistics.").option("--include-empty","Restore zero-count registered item-type and lifecycle-status buckets").option("--storage","Include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries)").option("--metadata-coverage","Include metadata coverage % (acceptance_criteria, estimated_minutes, resolution, tags, parent) overall and by type").option("--by-assignee","Include a lifecycle-bucketed item breakdown grouped by assignee").option("--by-tag","Include a lifecycle-bucketed item breakdown grouped by tag").option("--by-priority","Include a lifecycle-bucketed item breakdown grouped by priority").option("--tag-prefix <value>","With --by-tag: only count tags starting with this prefix (e.g. domain:)").option("--field-utilization","Report content-field utilization rates (notes/learnings/files/docs/tests/comments/deps/body) for governance analysis").option("--analytics <json>","Improvement ledger/history analytics JSON").action(runStatsAction);program.command("health").description("Show project tracker health checks.").option("--strict-directories","Treat optional item-type directories as required failures").option("--require-merge-drivers","Treat absent clone-local merge drivers as a required health failure").option("--check-only","Run read-only health diagnostics without refreshing vectors").option("--check-telemetry","Probe telemetry endpoint health and include network diagnostics").option("--no-refresh","Disable automatic vector refresh attempts during health checks").option("--refresh-vectors","Explicitly enable vector refresh attempts during health checks").option("--verbose-stale-items","Include full stale vectorization ID lists in health output").option("--verbose-author-events","Include every actionable unknown-author event coordinate for review or disposition").option("--brief","Emit compact health details for low-token agent checks").option("--summary","Emit one-line-style health status with check names and warning count").option("--skip-vectors","Skip vectorization check for a faster run").option("--skip-integrity","Skip item/history file integrity check for a faster run").option("--skip-drift","Skip history drift hash check for a faster run").option("--full","Run all checks including slow integrity, drift, and vectorization checks").option("--strict-exit","Return non-zero exit when health is not ok and default to actionable summary output; use --full for complete details").option("--fail-on-warn","Alias for --strict-exit").action(runHealthAction);program.command("validate").description("Validate metadata, lifecycle policies, files, command references, and history.").option("--check-metadata","Run metadata completeness checks").option("--metadata-profile <value>","Metadata profile (core|strict|custom)").option("--check-resolution","Run closed-item resolution metadata checks").option("--check-completeness","Check declarative lifecycle field requirements").option("--check-lifecycle","Run active-item lifecycle governance drift checks").option("--check-stale-blockers","Include stale blocker-pattern diagnostics in lifecycle checks").option("--dependency-cycle-severity <value>","Set dependency-cycle warning policy for lifecycle checks (off|warn|error)").option("--parent-cycle-severity <value>","Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error)").option("--check-files","Run linked-file and orphaned-file checks").option("--check-command-references","Run linked-command PM-ID reference checks").option("--scan-mode <value>","Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict)").option("--include-pm-internals","Include PM storage internals in tracked-all candidate scans").option("--verbose-file-lists","Include full file-path lists for validate --check-files details").option("--verbose-diagnostics","Include full diagnostic ID lists").option("--all-affected-ids","Emit complete missing_* affected-ID lists with no truncation (implied by --json)").option("--strict-exit","Return non-zero exit when validation warnings are present").option("--fail-on-warn","Alias for --strict-exit").option("--fix-hints","Add a machine-executable fix_hints[] of pm commands to each failing check's details").option("--auto-fix","Apply safe, deterministic field backfills").option("--dry-run","Preview planned --auto-fix/--prune-missing fixes without applying them").option("--fix-scope <scope>","Grant --auto-fix scopes (metadata, resolution, estimates, timestamps, lifecycle; comma-separated or repeatable). Default: metadata, resolution; other scopes require explicit opt-in",collect).option("--prune-missing","Remove deleted-path file/doc links; preserves real files").option("--check-history-drift","Run item/history hash drift checks").option("--check-storage-integrity","Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected deletes, unparseable config/schema)").option("--counts","Keep validation counts and totals while omitting per-item diagnostic arrays").option("--full","Return the complete validation diagnostic projection").action(runValidateAction);program.command("gc").option("--dry-run","Preview cleanup targets without deleting files; without this flag, pm gc deletes matched artifacts").option("--scope <value>","Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints, transactions",collect).description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.").action(runGcAction);const workspaceCommand=program.command("workspace").description("Inspect workspace state and snapshots.");workspaceCommand.command("position").description("Show merge and history readiness.").action(runWorkspacePositionAction);workspaceCommand.command("snapshot").argument("<action>","Action: create, list, inspect, restore, delete").argument("[target]","Optional name for create; name or fingerprint otherwise").description("Manage content-addressed tracker snapshots.").option("--dry-run","Preview restore file, item, stream, and history-entry impact without mutating state").option("--force","Explicitly confirm a whole-workspace snapshot restore").option("--author <value>","Actor recorded on the restore audit event").option("--message <value>","Human-readable restore rationale").action(runWorkspaceSnapshotAction);program.command("contracts").description("Show machine-readable command and schema contracts for agents.").option("--action <value>","Filter tool schema branches to a specific action").option("--command <value>","Scope contracts output to one CLI command (narrow-by-default)").option("--summary","Return one command+intent row per top-level command for cheap agent bootstrap").option("--schema-only","Return schema-focused output only").option("--flags-only","Return command flag contracts only").option("--availability-only","Return action availability surface only").option("--runtime-only","Include only actions invocable in the current runtime").option("--active-only","Alias for --runtime-only").option("--full","Include full schema and command-flag surfaces (large; default brief output omits heavy sections for unfiltered queries)").action(runContractsAction);const claimCommand=program.command("claim").option("--start","Claim and start an explicit item").argument("[id]","Item id (omit with --next)").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force claim override").option("--if-available","Skip another author's claim (skipped=true)").option("--next","Atomically claim the next caller-available actionable item").option("--type <value>","Filter --next candidates by type").option("--tag <value>","Filter --next candidates by tag").option("--priority <value>","Filter --next candidates by priority").option("--assignee-filter <value>","Filter --next candidates: assigned|unassigned").option("--parent <id>","Scope --next candidates to a subtree").option("--sprint <value>","Filter --next candidates by sprint").option("--release <value>","Filter --next candidates by release").option("--max-attempts <n>","Bound the --next candidate walk (default 10; maximum 100)").option("--include-decisions","Allow --next to claim human-gated Decision items").option("--include-gates","Allow --next to claim outcome gates").option("--include-containers","Allow --next to claim containers with unfinished descendants").option("--token-budget <n>","Bound the estimated tokens used to rank --next candidates").option("--explain-ranking","Include ranking provenance for --next selection").description("Claim an item for active work.").action(runClaimAction);addHiddenOption(claimCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");addHiddenOption(claimCommand,"--token_budget <n>","Alias for --token-budget");addHiddenOption(claimCommand,"--explain_ranking","Alias for --explain-ranking");const releaseCommand=program.command("release").option("--pause","Use open status").argument("<id>","Item id").option("--author <value>","Author").option("--message <value>","Message").option("--force","Override ownership").description("Release ownership.").action(runReleaseAction);addHiddenOption(releaseCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const startTaskCommand=program.command("start-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: claim an item and move it to in_progress.").action(runStartTaskAction);addHiddenOption(startTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const pauseTaskCommand=program.command("pause-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override when required").description("Lifecycle alias: move an item to open and release its claim.").action(runPauseTaskAction);addHiddenOption(pauseTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const closeTaskCommand=program.command("close-task",{hidden:true}).argument("<id>","Item id").argument("[reason]","Close reason text").option("--author <value>","Mutation author").option("--message <value>","History message").option("--validate-close <value>","Close-time validation mode: off|warn|strict").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: close an item and release assignment metadata.").action(runCloseTaskAction);addHiddenOption(closeTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands")}export{_testOnlyRegisterOperations,registerOperationCommands,requireClaimTarget};
+!(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]="af2cd676-7ace-5b65-aaf0-0a167a72df95")}catch(e2){}})();import{resolvePmCommandAlias,renderPmCommandAliasMigrationHint}from"../sdk/cli-contracts/command-aliases.js";import{setActiveCommandResult,EXIT_CODE,PmCliError,createUnknownSubcommandError,resolveAuthor,resolvePmRoot,readSettings}from"../sdk/runtime-primitives.js";import{runStartTask,runPauseTask,runCloseTask}from"../sdk/lifecycle/task-composition.js";import{parseStatsAnalyticsJson}from"./stats-analytics-json.js";import{createWorkspaceSnapshot,deleteWorkspaceSnapshot,inspectWorkspaceSnapshot,listWorkspaceSnapshots,planWorkspaceSnapshotRestore,restoreWorkspaceSnapshotWithRecovery,WORKSPACE_SNAPSHOT_ACTIONS}from"../sdk/workspace-snapshot.js";import{readWorkspacePosition}from"../sdk/governance/workspace-position.js";import{runClaim,runClaimNext,runRelease}from"./commands/lifecycle/claim.js";import{runContracts}from"./commands/workspace/contracts.js";import{runDuplicates}from"./commands/query/duplicates.js";import{runGc}from"./commands/governance/gc.js";import{runHealth}from"./commands/governance/health.js";import{runStats}from"./commands/query/stats.js";import{runTelemetry}from"./commands/governance/telemetry.js";import{runTest}from"./commands/test/test.js";import{runTestAll}from"./commands/test/test-all.js";import{runStartBackgroundRun,runTestRunsWorker}from"./commands/test/test-runs.js";import{runValidate}from"./commands/governance/validate.js";import{buildBackgroundTestAllCommandArgs,applyActiveCommandResultService,buildBackgroundTestCommandArgs,addHiddenOption,collect,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";import{registerAssuranceCommand}from"./register-assurance.js";function resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand){const normalizedNamespace=namespaceOrSubcommand?.trim().toLowerCase();const normalizedSubcommand=subcommand?.trim().toLowerCase();if(normalizedNamespace===void 0||normalizedNamespace.length===0){return normalizedSubcommand}if(normalizedNamespace==="local-analytics"){return normalizedSubcommand&&normalizedSubcommand.length>0?normalizedSubcommand:"status"}if(normalizedSubcommand!==void 0&&normalizedSubcommand.length>0){throw createUnknownSubcommandError({command_path:"telemetry",token:`${namespaceOrSubcommand} ${subcommand}`,allowed:["status","flush","stats","clear","local-analytics"],token_kind:"path",examples:["pm telemetry stats --limit 10","pm telemetry local-analytics status --json"]})}return normalizedNamespace}function collectTestMutationValues(options){return{addValues:Array.isArray(options.add)?options.add:[],addJsonValues:Array.isArray(options.addJson)?options.addJson:[],removeValues:Array.isArray(options.remove)?options.remove:[],removeIndexValues:Array.isArray(options.removeIndex)?options.removeIndex:[]}}function validateBackgroundTestOptions(options,values){if(options.background!==true){return}if(options.run!==true){throw new PmCliError("--background requires --run",EXIT_CODE.USAGE)}if(options.acknowledgeLinkedTests===true){throw new PmCliError("--background cannot be combined with --acknowledge-linked-tests; acknowledgement is a non-executing foreground operation",EXIT_CODE.USAGE)}if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||values.removeIndexValues.length>0){throw new PmCliError("--background does not support --add/--add-json/--remove/--remove-index; update linked tests first, then run in background",EXIT_CODE.USAGE)}}async function runBackgroundLinkedTests(id,options,globalOptions,values){const result=await runStartBackgroundRun({kind:"test",commandArgs:buildBackgroundTestCommandArgs(id,{...options,add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues}),targetId:id,author:typeof options.author==="string"?options.author:void 0,noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result,globalOptions)}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,list:Boolean(options.list),run:Boolean(options.run),match:typeof options.match==="string"?options.match:void 0,onlyIndex:typeof options.onlyIndex==="string"||typeof options.onlyIndex==="number"?options.onlyIndex:void 0,onlyLast:Boolean(options.onlyLast),timeout:typeof options.timeout==="string"?options.timeout:void 0,progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:typeof options.pmContext==="string"?options.pmContext:void 0,overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:typeof options.workspaceContext==="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),acknowledgeLinkedTests:Boolean(options.acknowledgeLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext),author:typeof options.author==="string"?options.author:void 0,message:typeof options.message==="string"?options.message:void 0,force:Boolean(options.force),measure:Array.isArray(options.measure)?options.measure:[],metricBelow:typeof options.metricBelow==="string"?options.metricBelow:void 0,metricDiff:typeof options.metricDiff==="string"?options.metricDiff:void 0}}const _testOnlyRegisterOperations={buildRunTestOptions,buildRunTestAllOptions,runWorkspacePositionAction,validateBackgroundTestOptions};async function runForegroundLinkedTests(id,options,globalOptions,values){const result=await runTest(id,buildRunTestOptions(options,values),globalOptions);if(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===true||values.removeIndexValues.length>0){await invalidateSearchCachesForMutation(globalOptions,result)}printResult(result,globalOptions);if(result.run_results.some(entry=>entry.status==="failed")||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const values=collectTestMutationValues(options);validateBackgroundTestOptions(options,values);if(options.background===true){await runBackgroundLinkedTests(id,options,globalOptions,values)}else{await runForegroundLinkedTests(id,options,globalOptions,values)}if(globalOptions.profile){printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author");const assignee=readOptionString(options,"assignee");if(author!==void 0&&assignee!==void 0&&author!==assignee){throw new PmCliError("Lifecycle ownership received conflicting --author and --assignee values; use one actor value for both aliases.",EXIT_CODE.USAGE,{code:"conflicting_lifecycle_owner",examples:["pm claim pm-123","pm claim pm-123 --start","pm release pm-123"]})}return{author:author??assignee,message:readOptionString(options,"message")}}async function runTestAllAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const runInBackground=options.background===true;if(runInBackground){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===true},globalOptions);printResult(result2,globalOptions);if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}return}const result=await runTestAll(buildRunTestAllOptions(options),globalOptions);await invalidateSearchCachesForMutation(globalOptions,{ids:result.results.map(entry=>entry.id)});printResult(result,globalOptions);if(result.failed>0||result.fail_on_skipped_triggered===true){process.exitCode=EXIT_CODE.DEPENDENCY_FAILED}if(globalOptions.profile){printError(`profile:command=test-all took_ms=${Date.now()-startedAt}`)}}function buildRunTestAllOptions(options){return{status:readOptionString(options,"status"),limit:readOptionString(options,"limit"),offset:readOptionString(options,"offset"),timeout:readOptionString(options,"timeout"),progress:Boolean(options.progress),envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:Boolean(options.sharedHostSafe),pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:Boolean(options.overrideLinkedPmContext),workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:Boolean(options.overrideLinkedWorkspaceContext),allowUntrustedLinkedTests:Boolean(options.allowUntrustedLinkedTests),failOnContextMismatch:Boolean(options.failOnContextMismatch),failOnSkipped:Boolean(options.failOnSkipped),failOnEmptyTestRun:Boolean(options.failOnEmptyTestRun),requireAssertionsForPm:Boolean(options.requireAssertionsForPm),checkContext:Boolean(options.checkContext),autoPmContext:Boolean(options.autoPmContext)}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics"));const result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===true,storage:options.storage===true,metadataCoverage:options.metadataCoverage===true,byAssignee:options.byAssignee===true,byTag:options.byTag===true,byPriority:options.byPriority===true,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===true,...analytics});if(result.recorded_observations?.some(entry=>entry.changed)===true){await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])})}printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const threshold=readOptionString(options,"threshold");const limit=readOptionString(options,"limit");const result=await runDuplicates(globalOptions,{...options.exhaustive===true?{exhaustive:true}:{},status:Array.isArray(options.status)&&options.status.length>0?options.status:void 0,since:readOptionString(options,"since"),...threshold===void 0?{}:{threshold:Number(threshold)},...limit===void 0?{}:{limit:Number(limit)}});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);const result=await runHealth(globalOptions,{strictExit,strictDirectories:Boolean(options.strictDirectories),requireMergeDrivers:Boolean(options.requireMergeDrivers),checkOnly:Boolean(options.checkOnly),checkTelemetry:Boolean(options.checkTelemetry),noRefresh:Boolean(options.noRefresh),refreshVectors:Boolean(options.refreshVectors),verboseStaleItems:Boolean(options.verboseStaleItems),verboseAuthorEvents:Boolean(options.verboseAuthorEvents),brief:Boolean(options.brief),summary:Boolean(options.summary)||strictExit,skipVectors:Boolean(options.skipVectors),skipIntegrity:Boolean(options.skipIntegrity),skipDrift:Boolean(options.skipDrift),full:Boolean(options.full)});printResult(result,globalOptions);if(strictExit&&!result.ok){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"health_findings",error_category:"validation",command_resolution:"health_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runValidate({checkMetadata:Boolean(options.checkMetadata),metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:Boolean(options.checkResolution),checkCompleteness:Boolean(options.checkCompleteness),checkLifecycle:Boolean(options.checkLifecycle),checkStaleBlockers:Boolean(options.checkStaleBlockers),dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:Boolean(options.checkFiles),checkCommandReferences:Boolean(options.checkCommandReferences),scanMode:readOptionString(options,"scanMode"),includePmInternals:Boolean(options.includePmInternals),verboseFileLists:Boolean(options.verboseFileLists),verboseDiagnostics:Boolean(options.verboseDiagnostics),allAffectedIds:Boolean(options.allAffectedIds),checkHistoryDrift:Boolean(options.checkHistoryDrift),checkStorageIntegrity:Boolean(options.checkStorageIntegrity),fixHints:Boolean(options.fixHints),autoFix:Boolean(options.autoFix),dryRun:Boolean(options.dryRun),fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:Boolean(options.pruneMissing),counts:Boolean(options.counts),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);const strictExit=Boolean(options.strictExit)||Boolean(options.failOnWarn);if(strictExit&&(result.has_warnings||!result.ok)){setActiveCommandResult({...result,exit_code:EXIT_CODE.GENERIC_FAILURE,error_code:"validation_findings",error_category:"validation",command_resolution:"validation_findings",resolution_stage:"execute"});process.exitCode=EXIT_CODE.GENERIC_FAILURE}if(globalOptions.profile){printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runGc(globalOptions,{dryRun:options.dryRun===true,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const normalizedAction=action.trim().toLowerCase();if(!WORKSPACE_SNAPSHOT_ACTIONS.some(entry=>entry===normalizedAction)){throw createUnknownSubcommandError({command_path:"workspace snapshot",token:action,allowed:WORKSPACE_SNAPSHOT_ACTIONS,display_name:"workspace snapshot",token_kind:"action",examples:["pm workspace snapshot create before-migration","pm workspace snapshot restore before-migration"]})}if(normalizedAction==="list"){printResult(await listWorkspaceSnapshots(pmRoot),globalOptions);return}if(normalizedAction==="create"){printResult(await createWorkspaceSnapshot(pmRoot,target===void 0?{}:{name:target}),globalOptions);return}if(target===void 0){throw new PmCliError(`pm workspace snapshot ${normalizedAction} requires a snapshot name or fingerprint`,EXIT_CODE.USAGE)}if(normalizedAction==="inspect"){printResult(await inspectWorkspaceSnapshot(pmRoot,target),globalOptions);return}if(normalizedAction==="restore"){if(options.dryRun===true){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===true,author:resolveAuthor(readOptionString(options,"author"),settings.author_default),message:readOptionString(options,"message"),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms}),globalOptions);return}printResult(await deleteWorkspaceSnapshot(pmRoot,target),globalOptions)}async function runWorkspacePositionAction(_options,command){const globalOptions=getGlobalOptions(command);printResult(await readWorkspacePosition(globalOptions),globalOptions)}async function runContractsAction(options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:Boolean(options.summary),schemaOnly:Boolean(options.schemaOnly),flagsOnly:Boolean(options.flagsOnly),availabilityOnly:Boolean(options.availabilityOnly),runtimeOnly:Boolean(options.runtimeOnly)||Boolean(options.activeOnly),full:Boolean(options.full)},globalOptions);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}}async function runClaimAction(id,options,command){if(options.start===true){requireClaimTarget(id,false);await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===true,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===true);const result=options.next===true?await runClaimNext(Boolean(options.force),globalOptions,lifecycleOptions,{type:typeof options.type==="string"?options.type:void 0,tag:typeof options.tag==="string"?options.tag:void 0,priority:options.priority,assigneeFilter:typeof options.assigneeFilter==="string"?options.assigneeFilter:void 0,parent:typeof options.parent==="string"?options.parent:void 0,sprint:typeof options.sprint==="string"?options.sprint:void 0,release:typeof options.release==="string"?options.release:void 0,includeDecisions:options.includeDecisions===true,includeGates:options.includeGates===true,includeContainers:options.includeContainers===true,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===true||options.explain_ranking===true}):await runClaim(id,Boolean(options.force),globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=claim took_ms=${Date.now()-startedAt}`)}}function requireClaimTarget(id,next){if(!next&&!id)throw new PmCliError("Specify an item id or pass --next",EXIT_CODE.USAGE);if(next&&id)throw new PmCliError("Specify either an item id or --next, not both",EXIT_CODE.USAGE)}async function runReleaseAction(id,options,command){if(options.pause===true){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runRelease(id,Boolean(options.force),globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===true});await invalidateSearchCachesForMutation(globalOptions,result);printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions);if(globalOptions.profile){printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command);const alias=resolvePmCommandAlias(command.name());if(!alias||global2.json||global2.quiet)return;const settings=await readSettings(resolvePmRoot(process.cwd(),global2.path));if(settings.ux?.deprecation_hints)printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force),next:options.next===true,ifAvailable:options.ifAvailable===true},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=start-task took_ms=${Date.now()-startedAt}`)}}async function runPauseTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=pause-task took_ms=${Date.now()-startedAt}`)}}async function runCloseTaskAction(id,reason,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command);const startedAt=Date.now();const result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:Boolean(options.force)},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release);printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=close-task took_ms=${Date.now()-startedAt}`)}}function addLinkedTestExecutionOptions(command){return command.option("--background","Run linked tests in managed background mode").option("--timeout <seconds>","Default run timeout in seconds").option("--progress","Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>","Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear environment variable(s) for linked-test runs (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>","PM linked-test context mode: schema|tracker|auto (default: schema)").option("--override-linked-pm-context","Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Force run-level --workspace-context over per-linked-test metadata").option("--allow-untrusted-linked-tests","Execute untrusted linked commands when project policy also permits it").option("--fail-on-context-mismatch","Fail linked PM commands when context item counts differ").option("--fail-on-skipped","Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run","Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context","Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context")}function registerOperationCommands(program){registerAssuranceCommand(program);const testCommand=program.command("test").argument("<id>","Item id").option("--add <value>","Add verified isolated test (CSV/markdown or stdin)",collect).option("--add-json <value>","Add verified isolated test (JSON object/array or stdin)",collect).option("--remove <value>","Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin)",collect).option("--remove-index <n>","Remove the 1-based linked-test index from --list order (repeatable)",collect).option("--list","List linked tests without mutating").option("--run","Run linked test commands").option("--match <value>","Run only linked tests whose command/path contains this substring").option("--only-index <n>","Run only the 1-based linked-test index from --list order").option("--only-last","Run only the most recently added linked test");testCommand.option("--acknowledge-linked-tests","Trust the item's current linked commands in this clone without executing them");addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...] evidence; repeatable",collect).option("--metric-below <value>","Return evidence below name=value").option("--metric-diff <name>","Diff the latest two values").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage tests linked to an item and optionally run them.").action(runTestCommandAction);const testAllCommand=program.command("test-all").description("Run linked tests across matching items.").option("--status <value>","Filter items by status before running tests").option("--limit <n>","Limit matching items before running linked tests").option("--offset <n>","Skip matching items before running linked tests");addLinkedTestExecutionOptions(testAllCommand).action(runTestAllAction);program.command("test-runs-worker",{hidden:true}).argument("<runId>","Background run id").description("Internal background worker command.").action(async(runId,_options,command)=>{const globalOptions=getGlobalOptions(command);await runTestRunsWorker(runId,globalOptions)});program.command("telemetry").argument("[namespace-or-subcommand]","Telemetry subcommand: status, flush, stats, clear (default: status)").argument("[subcommand]","Compatibility alias target for local-analytics: status, flush, stats, clear").option("--limit <n>","Maximum command groups returned by telemetry stats").description("Inspect and manage local telemetry queue/runtime state.").action(runTelemetryAction);program.command("duplicates").description("Find duplicate clusters across all statuses.").option("--status <value>","Statuses (repeatable or comma-separated)",collect,[]).option("--since <value>","Created at or after this time").option("--threshold <value>","Minimum similarity (0-1)").option("--limit <n>","Maximum clusters").option("--exhaustive","Score all pairs within the safety bound").action(runDuplicatesAction);program.command("stats").description("Show project tracker statistics.").option("--include-empty","Restore zero-count registered item-type and lifecycle-status buckets").option("--storage","Include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries)").option("--metadata-coverage","Include metadata coverage % (acceptance_criteria, estimated_minutes, resolution, tags, parent) overall and by type").option("--by-assignee","Include a lifecycle-bucketed item breakdown grouped by assignee").option("--by-tag","Include a lifecycle-bucketed item breakdown grouped by tag").option("--by-priority","Include a lifecycle-bucketed item breakdown grouped by priority").option("--tag-prefix <value>","With --by-tag: only count tags starting with this prefix (e.g. domain:)").option("--field-utilization","Report content-field utilization rates (notes/learnings/files/docs/tests/comments/deps/body) for governance analysis").option("--analytics <json>","Improvement ledger/history analytics JSON").action(runStatsAction);program.command("health").description("Show project tracker health checks.").option("--strict-directories","Treat optional item-type directories as required failures").option("--require-merge-drivers","Treat absent clone-local merge drivers as a required health failure").option("--check-only","Run read-only health diagnostics without refreshing vectors").option("--check-telemetry","Probe telemetry endpoint health and include network diagnostics").option("--no-refresh","Disable automatic vector refresh attempts during health checks").option("--refresh-vectors","Explicitly enable vector refresh attempts during health checks").option("--verbose-stale-items","Include full stale vectorization ID lists in health output").option("--verbose-author-events","Include every actionable unknown-author event coordinate for review or disposition").option("--brief","Emit compact health details for low-token agent checks").option("--summary","Emit one-line-style health status with check names and warning count").option("--skip-vectors","Skip vectorization check for a faster run").option("--skip-integrity","Skip item/history file integrity check for a faster run").option("--skip-drift","Skip history drift hash check for a faster run").option("--full","Run all checks including slow integrity, drift, and vectorization checks").option("--strict-exit","Return non-zero exit when health is not ok and default to actionable summary output; use --full for complete details").option("--fail-on-warn","Alias for --strict-exit").action(runHealthAction);program.command("validate").description("Validate metadata, lifecycle policies, files, command references, and history.").option("--check-metadata","Run metadata completeness checks").option("--metadata-profile <value>","Metadata profile (core|strict|custom)").option("--check-resolution","Run closed-item resolution metadata checks").option("--check-completeness","Check declarative lifecycle field requirements").option("--check-lifecycle","Run active-item lifecycle governance drift checks").option("--check-stale-blockers","Include stale blocker-pattern diagnostics in lifecycle checks").option("--dependency-cycle-severity <value>","Set dependency-cycle warning policy for lifecycle checks (off|warn|error)").option("--parent-cycle-severity <value>","Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error)").option("--check-files","Run linked-file and orphaned-file checks").option("--check-command-references","Run linked-command PM-ID reference checks").option("--scan-mode <value>","Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict)").option("--include-pm-internals","Include PM storage internals in tracked-all candidate scans").option("--verbose-file-lists","Include full file-path lists for validate --check-files details").option("--verbose-diagnostics","Include full diagnostic ID lists").option("--all-affected-ids","Emit complete missing_* affected-ID lists with no truncation (implied by --json)").option("--strict-exit","Return non-zero exit when validation warnings are present").option("--fail-on-warn","Alias for --strict-exit").option("--fix-hints","Add a machine-executable fix_hints[] of pm commands to each failing check's details").option("--auto-fix","Apply safe, deterministic field backfills").option("--dry-run","Preview planned --auto-fix/--prune-missing fixes without applying them").option("--fix-scope <scope>","Grant --auto-fix scopes (metadata, resolution, estimates, timestamps, lifecycle; comma-separated or repeatable). Default: metadata, resolution; other scopes require explicit opt-in",collect).option("--prune-missing","Remove deleted-path file/doc links; preserves real files").option("--check-history-drift","Run item/history hash drift checks").option("--check-storage-integrity","Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected deletes, unparseable config/schema)").option("--counts","Keep validation counts and totals while omitting per-item diagnostic arrays").option("--full","Return the complete validation diagnostic projection").action(runValidateAction);program.command("gc").option("--dry-run","Preview cleanup targets without deleting files; without this flag, pm gc deletes matched artifacts").option("--scope <value>","Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints, transactions",collect).description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.").action(runGcAction);const workspaceCommand=program.command("workspace").description("Inspect workspace state and snapshots.");workspaceCommand.command("position").description("Show merge and history readiness.").action(runWorkspacePositionAction);workspaceCommand.command("snapshot").argument("<action>","Action: create, list, inspect, restore, delete").argument("[target]","Optional name for create; name or fingerprint otherwise").description("Manage content-addressed tracker snapshots.").option("--dry-run","Preview restore file, item, stream, and history-entry impact without mutating state").option("--force","Explicitly confirm a whole-workspace snapshot restore").option("--author <value>","Actor recorded on the restore audit event").option("--message <value>","Human-readable restore rationale").action(runWorkspaceSnapshotAction);program.command("contracts").description("Show machine-readable command and schema contracts for agents.").option("--action <value>","Filter tool schema branches to a specific action").option("--command <value>","Scope contracts output to one CLI command (narrow-by-default)").option("--summary","Return one command+intent row per top-level command for cheap agent bootstrap").option("--schema-only","Return schema-focused output only").option("--flags-only","Return command flag contracts only").option("--availability-only","Return action availability surface only").option("--runtime-only","Include only actions invocable in the current runtime").option("--active-only","Alias for --runtime-only").option("--full","Include full schema and command-flag surfaces (large; default brief output omits heavy sections for unfiltered queries)").action(runContractsAction);const claimCommand=program.command("claim").option("--start","Claim and start an explicit item").argument("[id]","Item id (omit with --next)").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force claim override").option("--if-available","Skip another author's claim (skipped=true)").option("--next","Atomically claim the next caller-available actionable item").option("--type <value>","Filter --next candidates by type").option("--tag <value>","Filter --next candidates by tag").option("--priority <value>","Filter --next candidates by priority").option("--assignee-filter <value>","Filter --next candidates: assigned|unassigned").option("--parent <id>","Scope --next candidates to a subtree").option("--sprint <value>","Filter --next candidates by sprint").option("--release <value>","Filter --next candidates by release").option("--max-attempts <n>","Bound the --next candidate walk (default 10; maximum 100)").option("--include-decisions","Allow --next to claim human-gated Decision items").option("--include-gates","Allow --next to claim outcome gates").option("--include-containers","Allow --next to claim containers with unfinished descendants").option("--token-budget <n>","Bound the estimated tokens used to rank --next candidates").option("--explain-ranking","Include ranking provenance for --next selection").description("Claim an item for active work.").action(runClaimAction);addHiddenOption(claimCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");addHiddenOption(claimCommand,"--token_budget <n>","Alias for --token-budget");addHiddenOption(claimCommand,"--explain_ranking","Alias for --explain-ranking");const releaseCommand=program.command("release").option("--pause","Use open status").argument("<id>","Item id").option("--author <value>","Author").option("--message <value>","Message").option("--force","Override ownership").description("Release ownership.").action(runReleaseAction);addHiddenOption(releaseCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const startTaskCommand=program.command("start-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: claim an item and move it to in_progress.").action(runStartTaskAction);addHiddenOption(startTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const pauseTaskCommand=program.command("pause-task",{hidden:true}).argument("<id>","Item id").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override when required").description("Lifecycle alias: move an item to open and release its claim.").action(runPauseTaskAction);addHiddenOption(pauseTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands");const closeTaskCommand=program.command("close-task",{hidden:true}).argument("<id>","Item id").argument("[reason]","Close reason text").option("--author <value>","Mutation author").option("--message <value>","History message").option("--validate-close <value>","Close-time validation mode: off|warn|strict").option("--force","Force ownership or terminal override when required").description("Lifecycle alias: close an item and release assignment metadata.").action(runCloseTaskAction);addHiddenOption(closeTaskCommand,"--assignee <value>","Alias for --author on lifecycle ownership commands")}export{_testOnlyRegisterOperations,registerOperationCommands,requireClaimTarget};
 //# sourceMappingURL=register-operations.js.map

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]="a8ac0dcc-067d-55e1-ae02-15ba3f9ecd34")}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.js";import{SCAFFOLD_CAPABILITIES}from"./commands/extension/scaffold.js";import{renderExtensionDescribeMarkdown}from"./commands/extension/describe.js";import{runConfig}from"./commands/config.js";import{runInit,summarizeInitResult}from"./commands/init.js";import{runUpgrade}from"./commands/upgrade.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","Resolve install sources and estimate copying without destination 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} with update-check metadata`).option("--describe",`Map every surface a loaded ${noun} registers (optionally one by name)`).option("--markdown","Render describe output as a Markdown reference document (describe only)").option("--output <path>","Write describe Markdown to a file (requires --markdown)").option("--reload",`Reload ${plural} with cache-busted module imports`).option("--watch","Use watch mode with --reload").option("--doctor",`Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog",`List bundled first-party ${noun} catalog metadata`).option("--adopt",`Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all",`Adopt all unmanaged ${plural} into managed metadata`).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("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="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]="b04d19bc-04b2-54e4-af48-5f930e1167dd")}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";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","Resolve install sources and estimate copying without destination 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} with update-check metadata`).option("--describe",`Map every surface a loaded ${noun} registers (optionally one by name)`).option("--markdown","Render describe output as a Markdown reference document (describe only)").option("--output <path>","Write describe Markdown to a file (requires --markdown)").option("--reload",`Reload ${plural} with cache-busted module imports`).option("--watch","Use watch mode with --reload").option("--doctor",`Run consolidated ${noun} diagnostics (summary/deep modes)`).option("--catalog",`List bundled first-party ${noun} catalog metadata`).option("--adopt",`Adopt an existing unmanaged ${noun} into managed metadata`).option("--adopt-all",`Adopt all unmanaged ${plural} into managed metadata`).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("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};
 //# sourceMappingURL=register-setup.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]="d1ddac78-73cb-5c53-beee-feb4f691917f")}catch(e2){}})();import{stringArrayOption}from"../option-values.js";import{WORKFLOW_POLICY_ACTIONS}from"../../sdk/cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError,createUnknownSubcommandError}from"../../sdk/runtime-primitives.js";import*as schemaModule from"../commands/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="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]="cb103163-4289-5731-9e72-06b69adb3b81")}catch(e2){}})();import{stringArrayOption}from"../option-values.js";import{WORKFLOW_POLICY_ACTIONS}from"../../sdk/cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError,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)}
 `);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)}

package/dist/cli/stats-analytics-json.d.ts

@@ -4,6 +4,6 @@
  * Validates the compact JSON adapter used to keep the agent-facing stats CLI
  * contract bounded while preserving the fully typed SDK and MCP primitives.
  */
-import type { StatsCommandOptions } from "./commands/stats.js";
+import type { StatsCommandOptions } from "./commands/query/stats.js";
 /** Parse and strictly validate the compact CLI improvement-analytics payload. */
 export declare function parseStatsAnalyticsJson(input: string | undefined): StatsCommandOptions;

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]="5197f5ed-ed11-536e-b0da-00fe90a1a1a1")}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="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};
 //# sourceMappingURL=stats-analytics-json.js.map