@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/cli/register-operations.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b4ba0a5c-0934-5b1c-97cc-d7ad07374867")}catch{}})();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";import{assertTestMeasurementRun}from"../sdk/test/prerequisites.js";function resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand){const normalizedNamespace=namespaceOrSubcommand?.trim().toLowerCase(),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===!0){if(options.run!==!0)throw new PmCliError("--background requires --run",EXIT_CODE.USAGE);if(options.acknowledgeLinkedTests===!0)throw new PmCliError("--background cannot be combined with --acknowledge-linked-tests; acknowledgement is a non-executing foreground operation",EXIT_CODE.USAGE);if(options.update!==void 0||options.updateIndex!==void 0||options.setJson!==void 0||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 or metadata edits; 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===!0},globalOptions);printResult(result,globalOptions)}function buildTestEditOptions(options){return{update:typeof options.update=="string"?options.update:void 0,updateIndex:typeof options.updateIndex=="string"||typeof options.updateIndex=="number"?options.updateIndex:void 0,setJson:typeof options.setJson=="string"?options.setJson:void 0}}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,...buildTestEditOptions(options),list:!!options.list,run:!!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:!!options.onlyLast,timeout:typeof options.timeout=="string"?options.timeout:void 0,progress:!!options.progress,envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:!!options.sharedHostSafe,pmContext:typeof options.pmContext=="string"?options.pmContext:void 0,overrideLinkedPmContext:!!options.overrideLinkedPmContext,workspaceContext:typeof options.workspaceContext=="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:!!options.overrideLinkedWorkspaceContext,allowUntrustedLinkedTests:!!options.allowUntrustedLinkedTests,acknowledgeLinkedTests:!!options.acknowledgeLinkedTests,failOnContextMismatch:!!options.failOnContextMismatch,failOnSkipped:!!options.failOnSkipped,failOnEmptyTestRun:!!options.failOnEmptyTestRun,requireAssertionsForPm:!!options.requireAssertionsForPm,checkContext:!!options.checkContext,autoPmContext:!!options.autoPmContext,author:typeof options.author=="string"?options.author:void 0,message:typeof options.message=="string"?options.message:void 0,force:!!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);(options.update!==void 0||options.updateIndex!==void 0||options.setJson!==void 0||values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===!0||values.removeIndexValues.length>0)&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),(result.run_results.some(entry=>entry.status==="failed"||entry.status==="refused")||result.fail_on_skipped_triggered===!0)&&(process.exitCode=EXIT_CODE.DEPENDENCY_FAILED)}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),values=collectTestMutationValues(options);options.background===!0&&assertTestMeasurementRun(id,buildRunTestOptions(options,values),globalOptions,resolvePmRoot(process.cwd(),globalOptions.path),!0),validateBackgroundTestOptions(options,values),options.background===!0?await runBackgroundLinkedTests(id,options,globalOptions,values):await runForegroundLinkedTests(id,options,globalOptions,values),globalOptions.profile&&printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author"),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),startedAt=Date.now();if(options.background===!0){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===!0},globalOptions);printResult(result2,globalOptions),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),(result.failed>0||result.fail_on_skipped_triggered===!0)&&(process.exitCode=EXIT_CODE.DEPENDENCY_FAILED),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:!!options.progress,envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:!!options.sharedHostSafe,pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:!!options.overrideLinkedPmContext,workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:!!options.overrideLinkedWorkspaceContext,allowUntrustedLinkedTests:!!options.allowUntrustedLinkedTests,failOnContextMismatch:!!options.failOnContextMismatch,failOnSkipped:!!options.failOnSkipped,failOnEmptyTestRun:!!options.failOnEmptyTestRun,requireAssertionsForPm:!!options.requireAssertionsForPm,checkContext:!!options.checkContext,autoPmContext:!!options.autoPmContext}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics")),result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===!0,storage:options.storage===!0,metadataCoverage:options.metadataCoverage===!0,byAssignee:options.byAssignee===!0,byTag:options.byTag===!0,byPriority:options.byPriority===!0,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===!0,...analytics});result.recorded_observations?.some(entry=>entry.changed)===!0&&await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])}),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),threshold=readOptionString(options,"threshold"),limit=readOptionString(options,"limit"),result=await runDuplicates(globalOptions,{...options.exhaustive===!0?{exhaustive:!0}:{},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),globalOptions.profile&&printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),strictExit=!!options.strictExit||!!options.failOnWarn,result=await runHealth(globalOptions,{strictExit,strictDirectories:!!options.strictDirectories,requireMergeDrivers:!!options.requireMergeDrivers,checkOnly:!!options.checkOnly,checkTelemetry:!!options.checkTelemetry,noRefresh:!!options.noRefresh,refreshVectors:!!options.refreshVectors,verboseStaleItems:!!options.verboseStaleItems,verboseAuthorEvents:!!options.verboseAuthorEvents,brief:!!options.brief,summary:!!options.summary||strictExit,skipVectors:!!options.skipVectors,skipIntegrity:!!options.skipIntegrity,skipDrift:!!options.skipDrift,full:!!options.full});printResult(result,globalOptions),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),globalOptions.profile&&printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runValidate({checkMetadata:!!options.checkMetadata,metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:!!options.checkResolution,checkCompleteness:!!options.checkCompleteness,checkLifecycle:!!options.checkLifecycle,checkStaleBlockers:!!options.checkStaleBlockers,dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:!!options.checkFiles,checkCommandReferences:!!options.checkCommandReferences,scanMode:readOptionString(options,"scanMode"),includePmInternals:!!options.includePmInternals,verboseFileLists:!!options.verboseFileLists,verboseDiagnostics:!!options.verboseDiagnostics,allAffectedIds:!!options.allAffectedIds,checkHistoryDrift:!!options.checkHistoryDrift,checkStorageIntegrity:!!options.checkStorageIntegrity,fixHints:!!options.fixHints,autoFix:!!options.autoFix,dryRun:!!options.dryRun,fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:!!options.pruneMissing,counts:!!options.counts,full:!!options.full},globalOptions);printResult(result,globalOptions),(options.strictExit||options.failOnWarn)&&(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),globalOptions.profile&&printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runGc(globalOptions,{dryRun:options.dryRun===!0,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command),pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),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===!0){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===!0,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),startedAt=Date.now(),result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:!!options.summary,schemaOnly:!!options.schemaOnly,flagsOnly:!!options.flagsOnly,availabilityOnly:!!options.availabilityOnly,runtimeOnly:!!options.runtimeOnly||!!options.activeOnly,full:!!options.full},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}async function runClaimAction(id,options,command){if(options.start===!0){requireClaimTarget(id,!1),await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===!0,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===!0);const result=options.next===!0?await runClaimNext(!!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===!0,includeGates:options.includeGates===!0,includeContainers:options.includeContainers===!0,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===!0||options.explain_ranking===!0}):await runClaim(id,!!options.force,globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),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===!0){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runRelease(id,!!options.force,globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===!0});await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command),alias=resolvePmCommandAlias(command.name());!alias||global2.json||global2.quiet||(await readSettings(resolvePmRoot(process.cwd(),global2.path))).ux?.deprecation_hints&&printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:!!options.force,next:options.next===!0,ifAvailable:options.ifAvailable===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update),printResult(result,globalOptions),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),startedAt=Date.now(),result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release),printResult(result,globalOptions),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),startedAt=Date.now(),result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release),printResult(result,globalOptions),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 stderr progress (automatic in TTY)").option("--env-set <value>","Set run environment (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear run environment (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe run defaults").option("--pm-context <mode>","PM test context: schema|tracker|auto|none (default: schema)").option("--override-linked-pm-context","Override stored context with --pm-context").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Override stored context with --workspace-context").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","Fail successful commands reporting zero executed tests").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Check PM context before execution").option("--auto-pm-context","Route mismatched PM tracker reads 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 exact command/path (command=<value>, path=<value>, or stdin -)",collect).option("--remove-index <n>","Remove 1-based --list position (repeatable)",collect).option("--list","List linked tests without mutating").option("--update <value>","Edit exact command or path=<value>").option("--update-index <n>","Edit current 1-based --list position").option("--set-json <value>","Metadata patch; null clears optional fields").option("--run","Run linked test commands").option("--match <value>","Run matching command/path substring").option("--only-index <n>","Run 1-based --list position").option("--only-last","Run most recently added test");testCommand.option("--acknowledge-linked-tests","Trust current commands in this clone without execution"),addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...]; requires --run",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:!0}).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:!0}).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:!0}).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:!0}).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=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8d5029c0-2d6e-5d39-8239-545a5841694e")}catch{}})();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";import{assertTestMeasurementRun}from"../sdk/test/prerequisites.js";function resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand){const normalizedNamespace=namespaceOrSubcommand?.trim().toLowerCase(),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===!0){if(options.run!==!0)throw new PmCliError("--background requires --run",EXIT_CODE.USAGE);if(options.acknowledgeLinkedTests===!0)throw new PmCliError("--background cannot be combined with --acknowledge-linked-tests; acknowledgement is a non-executing foreground operation",EXIT_CODE.USAGE);if(options.update!==void 0||options.updateIndex!==void 0||options.setJson!==void 0||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 or metadata edits; 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===!0},globalOptions);printResult(result,globalOptions)}function buildTestEditOptions(options){return{update:typeof options.update=="string"?options.update:void 0,updateIndex:typeof options.updateIndex=="string"||typeof options.updateIndex=="number"?options.updateIndex:void 0,setJson:typeof options.setJson=="string"?options.setJson:void 0}}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,...buildTestEditOptions(options),list:!!options.list,run:!!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:!!options.onlyLast,timeout:typeof options.timeout=="string"?options.timeout:void 0,progress:!!options.progress,envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:!!options.sharedHostSafe,pmContext:typeof options.pmContext=="string"?options.pmContext:void 0,overrideLinkedPmContext:!!options.overrideLinkedPmContext,workspaceContext:typeof options.workspaceContext=="string"?options.workspaceContext:void 0,overrideLinkedWorkspaceContext:!!options.overrideLinkedWorkspaceContext,allowUntrustedLinkedTests:!!options.allowUntrustedLinkedTests,acknowledgeLinkedTests:!!options.acknowledgeLinkedTests,failOnContextMismatch:!!options.failOnContextMismatch,failOnSkipped:!!options.failOnSkipped,failOnEmptyTestRun:!!options.failOnEmptyTestRun,requireAssertionsForPm:!!options.requireAssertionsForPm,checkContext:!!options.checkContext,autoPmContext:!!options.autoPmContext,author:typeof options.author=="string"?options.author:void 0,message:typeof options.message=="string"?options.message:void 0,force:!!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);(options.update!==void 0||options.updateIndex!==void 0||options.setJson!==void 0||values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||options.run===!0||values.removeIndexValues.length>0)&&await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),(result.run_results.some(entry=>entry.status==="failed"||entry.status==="refused")||result.fail_on_skipped_triggered===!0)&&(process.exitCode=EXIT_CODE.DEPENDENCY_FAILED)}async function runTestCommandAction(id,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),values=collectTestMutationValues(options);options.background===!0&&assertTestMeasurementRun(id,buildRunTestOptions(options,values),globalOptions,resolvePmRoot(process.cwd(),globalOptions.path),!0),validateBackgroundTestOptions(options,values),options.background===!0?await runBackgroundLinkedTests(id,options,globalOptions,values):await runForegroundLinkedTests(id,options,globalOptions,values),globalOptions.profile&&printError(`profile:command=test took_ms=${Date.now()-startedAt}`)}function buildLifecycleMutationOptions(options){const author=readOptionString(options,"author"),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),startedAt=Date.now();if(options.background===!0){const result2=await runStartBackgroundRun({kind:"test-all",commandArgs:buildBackgroundTestAllCommandArgs(options),statusFilter:readOptionString(options,"status"),noExtensions:globalOptions.noExtensions===!0},globalOptions);printResult(result2,globalOptions),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),(result.failed>0||result.fail_on_skipped_triggered===!0)&&(process.exitCode=EXIT_CODE.DEPENDENCY_FAILED),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:!!options.progress,envSet:Array.isArray(options.envSet)?options.envSet:[],envClear:Array.isArray(options.envClear)?options.envClear:[],sharedHostSafe:!!options.sharedHostSafe,pmContext:readOptionString(options,"pmContext"),overrideLinkedPmContext:!!options.overrideLinkedPmContext,workspaceContext:readOptionString(options,"workspaceContext"),overrideLinkedWorkspaceContext:!!options.overrideLinkedWorkspaceContext,allowUntrustedLinkedTests:!!options.allowUntrustedLinkedTests,failOnContextMismatch:!!options.failOnContextMismatch,failOnSkipped:!!options.failOnSkipped,failOnEmptyTestRun:!!options.failOnEmptyTestRun,requireAssertionsForPm:!!options.requireAssertionsForPm,checkContext:!!options.checkContext,autoPmContext:!!options.autoPmContext}}async function runTelemetryAction(namespaceOrSubcommand,subcommand,options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runTelemetry({subcommand:resolveTelemetrySubcommand(namespaceOrSubcommand,subcommand),limit:readOptionString(options,"limit")},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=telemetry took_ms=${Date.now()-startedAt}`)}async function runStatsAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),analytics=parseStatsAnalyticsJson(readOptionString(options,"analytics")),result=await runStats(globalOptions,{includeEmpty:options.includeEmpty===!0,storage:options.storage===!0,metadataCoverage:options.metadataCoverage===!0,byAssignee:options.byAssignee===!0,byTag:options.byTag===!0,byPriority:options.byPriority===!0,tagPrefix:readOptionString(options,"tagPrefix"),fieldUtilization:options.fieldUtilization===!0,...analytics});result.recorded_observations?.some(entry=>entry.changed)===!0&&await invalidateSearchCachesForMutation(globalOptions,{ids:result.recorded_observations?.flatMap(entry=>entry.observation.item_id?[entry.observation.item_id]:[])}),printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=stats took_ms=${Date.now()-startedAt}`)}async function runDuplicatesAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),threshold=readOptionString(options,"threshold"),limit=readOptionString(options,"limit"),result=await runDuplicates(globalOptions,{...options.exhaustive===!0?{exhaustive:!0}:{},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),globalOptions.profile&&printError(`profile:command=duplicates took_ms=${Date.now()-startedAt}`)}async function runHealthAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),strictExit=!!options.strictExit||!!options.failOnWarn,result=await runHealth(globalOptions,{strictExit,strictDirectories:!!options.strictDirectories,requireMergeDrivers:!!options.requireMergeDrivers,checkOnly:!!options.checkOnly,checkTelemetry:!!options.checkTelemetry,noRefresh:!!options.noRefresh,refreshVectors:!!options.refreshVectors,verboseStaleItems:!!options.verboseStaleItems,verboseAuthorEvents:!!options.verboseAuthorEvents,brief:!!options.brief,summary:!!options.summary||strictExit,skipVectors:!!options.skipVectors,skipIntegrity:!!options.skipIntegrity,skipDrift:!!options.skipDrift,full:!!options.full});printResult(result,globalOptions),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),globalOptions.profile&&printError(`profile:command=health took_ms=${Date.now()-startedAt}`)}async function runValidateAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runValidate({checkMetadata:!!options.checkMetadata,metadataProfile:readOptionString(options,"metadataProfile"),checkResolution:!!options.checkResolution,checkCompleteness:!!options.checkCompleteness,checkLifecycle:!!options.checkLifecycle,checkStaleBlockers:!!options.checkStaleBlockers,dependencyCycleSeverity:readOptionString(options,"dependencyCycleSeverity"),parentCycleSeverity:readOptionString(options,"parentCycleSeverity"),checkFiles:!!options.checkFiles,checkCommandReferences:!!options.checkCommandReferences,scanMode:readOptionString(options,"scanMode"),includePmInternals:!!options.includePmInternals,verboseFileLists:!!options.verboseFileLists,verboseDiagnostics:!!options.verboseDiagnostics,allAffectedIds:!!options.allAffectedIds,checkHistoryDrift:!!options.checkHistoryDrift,checkStorageIntegrity:!!options.checkStorageIntegrity,fixHints:!!options.fixHints,autoFix:!!options.autoFix,dryRun:!!options.dryRun,fixScope:Array.isArray(options.fixScope)?options.fixScope:void 0,pruneMissing:!!options.pruneMissing,counts:!!options.counts,full:!!options.full},globalOptions);printResult(result,globalOptions),(options.strictExit||options.failOnWarn)&&(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),globalOptions.profile&&printError(`profile:command=validate took_ms=${Date.now()-startedAt}`)}async function runGcAction(options,command){const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runGc(globalOptions,{dryRun:options.dryRun===!0,scope:Array.isArray(options.scope)?options.scope:[]});printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=gc took_ms=${Date.now()-startedAt}`)}async function runWorkspaceSnapshotAction(action,target,options,command){const globalOptions=getGlobalOptions(command),pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),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===!0){printResult(await planWorkspaceSnapshotRestore(pmRoot,target),globalOptions);return}const settings=await readSettings(pmRoot);printResult(await restoreWorkspaceSnapshotWithRecovery(pmRoot,target,{force:options.force===!0,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),startedAt=Date.now(),result=await runContracts({action:readOptionString(options,"action"),command:readOptionString(options,"command"),summary:!!options.summary,schemaOnly:!!options.schemaOnly,flagsOnly:!!options.flagsOnly,availabilityOnly:!!options.availabilityOnly,runtimeOnly:!!options.runtimeOnly||!!options.activeOnly,full:!!options.full},globalOptions);printResult(result,globalOptions),globalOptions.profile&&printError(`profile:command=contracts took_ms=${Date.now()-startedAt}`)}async function runClaimAction(id,options,command){if(options.start===!0){requireClaimTarget(id,!1),await runStartTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),lifecycleOptions={...buildLifecycleMutationOptions(options),ifAvailable:options.ifAvailable===!0,maxAttempts:options.maxAttempts};requireClaimTarget(id,options.next===!0);const result=options.next===!0?await runClaimNext(!!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===!0,includeGates:options.includeGates===!0,includeContainers:options.includeContainers===!0,tokenBudget:options.tokenBudget??options.token_budget,explainRanking:options.explainRanking===!0||options.explain_ranking===!0}):await runClaim(id,!!options.force,globalOptions,lifecycleOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions),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===!0){await runPauseTaskAction(id,options,command);return}const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runRelease(id,!!options.force,globalOptions,{...buildLifecycleMutationOptions(options),ownershipReleaseBypass:options.ownershipReleaseBypass===!0,handoff:options.handoff});await invalidateSearchCachesForMutation(globalOptions,result),printResult(await applyActiveCommandResultService("release",[id],options,globalOptions,result),globalOptions),globalOptions.profile&&printError(`profile:command=release took_ms=${Date.now()-startedAt}`)}async function printLifecycleAliasHint(command){const global2=getGlobalOptions(command),alias=resolvePmCommandAlias(command.name());!alias||global2.json||global2.quiet||(await readSettings(resolvePmRoot(process.cwd(),global2.path))).ux?.deprecation_hints&&printError(renderPmCommandAliasMigrationHint(alias))}async function runStartTaskAction(id,options,command){await printLifecycleAliasHint(command);const globalOptions=getGlobalOptions(command),startedAt=Date.now(),result=await runStartTask(id,{...buildLifecycleMutationOptions(options),force:!!options.force,next:options.next===!0,ifAvailable:options.ifAvailable===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.update),printResult(result,globalOptions),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),startedAt=Date.now(),result=await runPauseTask(id,{...buildLifecycleMutationOptions(options),handoff:readOptionString(options,"handoff"),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release),printResult(result,globalOptions),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),startedAt=Date.now(),result=await runCloseTask(id,reason,{...buildLifecycleMutationOptions(options),validateClose:readOptionString(options,"validateClose"),force:!!options.force},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result.release),printResult(result,globalOptions),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 stderr progress (automatic in TTY)").option("--env-set <value>","Set run environment (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear run environment (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe run defaults").option("--pm-context <mode>","PM test context: schema|tracker|auto|none (default: schema)").option("--override-linked-pm-context","Override stored context with --pm-context").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Override stored context with --workspace-context").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","Fail successful commands reporting zero executed tests").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Check PM context before execution").option("--auto-pm-context","Route mismatched PM tracker reads 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 exact command/path (command=<value>, path=<value>, or stdin -)",collect).option("--remove-index <n>","Remove 1-based --list position (repeatable)",collect).option("--list","List linked tests without mutating").option("--update <value>","Edit exact command or path=<value>").option("--update-index <n>","Edit current 1-based --list position").option("--set-json <value>","Metadata patch; null clears optional fields").option("--run","Run linked test commands").option("--match <value>","Run matching command/path substring").option("--only-index <n>","Run 1-based --list position").option("--only-last","Run most recently added test");testCommand.option("--acknowledge-linked-tests","Trust current commands in this clone without execution"),addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...]; requires --run",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:!0}).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").option("--handoff <status>","Needs --message").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:!0}).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:!0}).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:!0}).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.d.ts

@@ -6,11 +6,11 @@
 import type { Command } from "commander";
 type ExtensionSubcommandAction = "init" | "install" | "uninstall" | "explore" | "manage" | "describe" | "reload" | "doctor" | "catalog" | "adopt" | "adopt-all" | "activate" | "deactivate" | "migrate";
 type LifecycleCommandVocabulary = "extension" | "package";
-declare function normalizeExtensionOptions(options: Record<string, unknown>, forcedAction?: ExtensionSubcommandAction, vocabulary?: LifecycleCommandVocabulary): Record<string, unknown>;
+declare function normalizeExtensionOptions(options:Record<string,unknown>,forcedAction?:ExtensionSubcommandAction,vocabulary?:LifecycleCommandVocabulary):Record<string,unknown>;
 /** Internal setup helpers exposed only for deterministic unit coverage. */
-export declare const _testOnlyRegisterSetup: {
-normalizeExtensionOptions: typeof normalizeExtensionOptions;
+export declare const _testOnlyRegisterSetup:{
+normalizeExtensionOptions:typeof normalizeExtensionOptions;
 };
 /** Register initialization, configuration, package, and extension setup commands. */
-export declare function registerSetupCommands(program: Command): void;
+export declare function registerSetupCommands(program:Command):void;
 export {};

package/dist/cli/register-structured-mutation.d.ts

@@ -1,20 +1,15 @@
-/**
- * @module cli/register-structured-mutation
- *
- * Registers the noun-first CLI adapter for public SDK atomic item mutations.
- */
 import type { Command } from "commander";
-declare function runItemReopenAction(id: string, reason: string, options: Record<string, unknown>, command: Command): Promise<void>;
+declare function runItemReopenAction(id:string,reason:string,options:Record<string,unknown>,command:Command):Promise<void>;
 /** Preview or commit the ordered item plan through the shared lifecycle coordinator. */
-declare function runItemMutateAction(options: Record<string, unknown>, command: Command): Promise<void>;
+declare function runItemMutateAction(options:Record<string,unknown>,command:Command):Promise<void>;
 /** Compose completion evidence, closure and release before previewing or committing the plan. */
-declare function runItemCompleteAction(id: string, positionalReason: string | undefined, options: Record<string, unknown>, command: Command): Promise<void>;
+declare function runItemCompleteAction(id:string,positionalReason:string | undefined,options:Record<string,unknown>,command:Command):Promise<void>;
 /** Register `pm item mutate`, the stable noun-first atomic batch surface. */
-export declare function registerStructuredMutationCommands(program: Command): void;
+export declare function registerStructuredMutationCommands(program:Command):void;
 /** Internal action hooks used by exhaustive source-level registration tests. */
-export declare const structuredMutationTestOnly: {
-runItemCompleteAction: typeof runItemCompleteAction;
-runItemMutateAction: typeof runItemMutateAction;
-runItemReopenAction: typeof runItemReopenAction;
+export declare const structuredMutationTestOnly:{
+runItemCompleteAction:typeof runItemCompleteAction;
+runItemMutateAction:typeof runItemMutateAction;
+runItemReopenAction:typeof runItemReopenAction;
 };
 export {};

package/dist/cli/register-structured-mutation.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b8e1992a-e8ca-5c6f-8721-f8a5401f1ef1")}catch{}})();import{createStdinTokenResolver,EXIT_CODE,PmCliError,readSettings,resolveAuthor,resolvePmRoot}from"../sdk/runtime-primitives.js";import{buildItemCompletionMutations,commitItemCompletion,commitItemMutations,previewItemMutations}from"../sdk/item-transaction.js";import{runReopen}from"../sdk/lifecycle/reopen.js";import{parseAtomicMutationControls,resolveItemMutationDocument}from"../sdk/structured-mutations.js";import{collect,getGlobalOptions,invalidateSearchCachesForMutation,printResult}from"./registration-helpers.js";async function runItemReopenAction(id,reason,options,command){const globalOptions=getGlobalOptions(command),expectedResult=options.expectedResult??options.expected,result=await runReopen(id,reason,{status:typeof options.status=="string"?options.status:void 0,expectedResult:typeof expectedResult=="string"?expectedResult:void 0,author:typeof options.author=="string"?options.author:globalOptions.author,message:typeof options.message=="string"?options.message:void 0,force:options.force===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions)}async function runItemMutateAction(options,command){const globalOptions=getGlobalOptions(command),input=await createStdinTokenResolver().resolveValue("-","--stdin-json");if(input===void 0||input.trim().length===0)throw new PmCliError("pm item mutate requires a non-empty JSON batch on stdin.",EXIT_CODE.USAGE);const transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item mutate requires --transaction-id <value>.",EXIT_CODE.USAGE);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),settings=await readSettings(pmRoot),resolved=resolveItemMutationDocument(input,{transactionId,idPrefix:settings.id_prefix}),{mutations,references}=resolved,controls=parseAtomicMutationControls(options),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,settings.author_default);if(options.dryRun===!0){const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations,references},globalOptions);return}const result=await commitItemMutations({pmRoot,transactionId,author,mutations,...controls});printResult({...result,mutation_count:mutations.length,references},globalOptions)}function resolveCompletionReason(positionalReason,optionReason){return typeof positionalReason=="string"&&positionalReason.trim().length>0?positionalReason.trim():typeof optionReason=="string"?optionReason.trim():""}async function runItemCompleteAction(id,positionalReason,options,command){const globalOptions=getGlobalOptions(command),transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item complete requires --transaction-id <value>.",EXIT_CODE.USAGE);const reason=resolveCompletionReason(positionalReason,options.reason);if(reason.length===0)throw new PmCliError("pm item complete requires a close reason.",EXIT_CODE.USAGE);const evidence=Object.fromEntries(["file","doc","test","comment","note","learning"].filter(key=>options[key]!==void 0).map(key=>[key,options[key]])),force=options.force===!0,{lockTtlSeconds,lockWaitMs}=parseAtomicMutationControls(options),closeOptions={...typeof options.resolution=="string"?{resolution:options.resolution}:{},...typeof options.expectedResult=="string"?{expectedResult:options.expectedResult}:{},...typeof options.actualResult=="string"?{actualResult:options.actualResult}:{},...typeof options.completedAt=="string"?{completedAt:options.completedAt}:{},...typeof options.validateClose=="string"?{validateClose:options.validateClose}:{},...force?{force:!0}:{}},completion={id,reason,...Object.keys(evidence).length===0?{}:{evidence},...Object.keys(closeOptions).length===0?{}:{closeOptions},...force?{releaseOptions:{force:!0}}:{}},pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,(await readSettings(pmRoot)).author_default);if(options.dryRun===!0){const mutations=buildItemCompletionMutations(completion),validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations},globalOptions);return}const result=await commitItemCompletion({pmRoot,transactionId,author,...completion,lockTtlSeconds,lockWaitMs});printResult({...result,mutation_count:Object.keys(result.results).length},globalOptions)}function registerStructuredMutationCommands(program){const itemCommand=program.commands.find(command=>command.name()==="item")??program.command("item").description("Run item lifecycle operations.");itemCommand.command("reopen <id> <reason>").option("--status <value>","Active target status: open or in_progress").option("--expected-result <value>","Current active planning expectation; otherwise the receipt offers recovery").option("--expected <value>","Alias for --expected-result").option("--message <value>","Human-readable recurrence history message").option("--force","Override ownership or stale-lock conflicts").option("--author <value>","Mutation author").description("Reopen terminal work with recurrence evidence.").action(runItemReopenAction),itemCommand.command("mutate").requiredOption("--transaction-id <value>","Stable idempotency key used to resume an interrupted batch").option("--stdin-json","Read the JSON mutation array from stdin",!0).option("--dry-run","Validate and preview the batch without writing").option("--create-compensation <mode>","Created-item compensation policy: close or delete","close").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--author <value>","Mutation author").description("Apply SDK-backed mutations atomically.").action(runItemMutateAction),itemCommand.command("complete <id> [reason]").requiredOption("--transaction-id <value>","Stable idempotency key for the composed completion").option("--reason <value>","Close reason when omitted positionally").option("--file <value>","Linked file evidence",collect).option("--doc <value>","Linked documentation evidence",collect).option("--test <value>","Linked test evidence",collect).option("--comment <value>","Evidence comment",collect).option("--note <value>","Completion note",collect).option("--learning <value>","Durable completion learning",collect).option("--resolution <value>","Structured resolution evidence").option("--expected-result <value>","Expected result evidence").option("--actual-result <value>","Actual result evidence").option("--completed-at <value>","Actual completion time").option("--validate-close <mode>","Close validation: off, warn, or strict").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--dry-run","Validate and preview completion without writing").option("--force","Override lifecycle and ownership conflicts").option("--author <value>","Completion author").description("Close with evidence and release the claim.").action(runItemCompleteAction)}const structuredMutationTestOnly={runItemCompleteAction,runItemMutateAction,runItemReopenAction};export{registerStructuredMutationCommands,structuredMutationTestOnly};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4853228f-bd17-5266-970b-10bd2f6941f9")}catch{}})();import{readFile}from"node:fs/promises";import path from"node:path";import{createStdinTokenResolver,EXIT_CODE,PmCliError,readSettings,resolveAuthor,resolvePmRoot}from"../sdk/runtime-primitives.js";import{describeUnknownError}from"../sdk/error-runtime.js";import{planItemMutationDocument}from"../sdk/lifecycle/structured-mutation-plan.js";import{buildItemCompletionMutations,commitItemCompletion,commitItemMutations,previewItemMutations}from"../sdk/item-transaction.js";import{runReopen}from"../sdk/lifecycle/reopen.js";import{parseAtomicMutationControls}from"../sdk/structured-mutations.js";import{collect,getGlobalOptions,invalidateSearchCachesForMutation,printResult}from"./registration-helpers.js";async function runItemReopenAction(id,reason,options,command){const globalOptions=getGlobalOptions(command),expectedResult=options.expectedResult??options.expected,result=await runReopen(id,reason,{status:typeof options.status=="string"?options.status:void 0,expectedResult:typeof expectedResult=="string"?expectedResult:void 0,author:typeof options.author=="string"?options.author:globalOptions.author,message:typeof options.message=="string"?options.message:void 0,force:options.force===!0},globalOptions);await invalidateSearchCachesForMutation(globalOptions,result),printResult(result,globalOptions)}async function readItemMutateInput(options,command){const from=typeof options.from=="string"?options.from.trim():"";if(from.length>0&&from!=="-"){if(command.getOptionValueSource("stdinJson")==="cli")throw new PmCliError("pm item mutate cannot combine --from <path> with explicit --stdin-json. Select one input source.",EXIT_CODE.USAGE);try{return await readFile(path.resolve(process.cwd(),from),"utf8")}catch(error){throw new PmCliError(`pm item mutate could not read --from ${from}: ${describeUnknownError(error)}`,EXIT_CODE.USAGE,{code:"mutation_document_unreadable",required:"Pass a readable JSON, JSON Lines, or envelope document path, or `-` for stdin.",why:"The whole document must be available before any tracker write begins."})}}return await createStdinTokenResolver().resolveValue("-","--stdin-json")??""}async function runItemMutateAction(options,command){const globalOptions=getGlobalOptions(command),input=await readItemMutateInput(options,command);if(input.trim().length===0)throw new PmCliError("pm item mutate requires a non-empty JSON batch on stdin or via --from <path>.",EXIT_CODE.USAGE);if(options.transactionId!==void 0&&(typeof options.transactionId!="string"||options.transactionId.trim().length===0))throw new PmCliError("pm item mutate requires --transaction-id <value> to be non-empty when provided.",EXIT_CODE.USAGE);const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),settings=await readSettings(pmRoot),plan=await planItemMutationDocument({pmRoot,input,settings,...typeof options.transactionId=="string"?{transactionId:options.transactionId}:{},...typeof options.upsertKey=="string"?{upsertKey:options.upsertKey}:{}}),{mutations,references,rows}=plan,transactionId=plan.transaction_id,receipt={transaction_id:transactionId,transaction_id_source:plan.transaction_id_source,...plan.upsert_key===void 0?{}:{upsert_key:plan.upsert_key}},controls=parseAtomicMutationControls(options),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,settings.author_default);if(options.dryRun===!0){const validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({...receipt,dry_run:!0,validation,mutation_count:mutations.length,mutations,references,rows},globalOptions);return}const result=await commitItemMutations({pmRoot,transactionId,author,mutations,...controls});printResult({...result,...receipt,mutation_count:mutations.length,references,rows},globalOptions)}function resolveCompletionReason(positionalReason,optionReason){return typeof positionalReason=="string"&&positionalReason.trim().length>0?positionalReason.trim():typeof optionReason=="string"?optionReason.trim():""}async function runItemCompleteAction(id,positionalReason,options,command){const globalOptions=getGlobalOptions(command),transactionId=typeof options.transactionId=="string"?options.transactionId.trim():"";if(transactionId.length===0)throw new PmCliError("pm item complete requires --transaction-id <value>.",EXIT_CODE.USAGE);const reason=resolveCompletionReason(positionalReason,options.reason);if(reason.length===0)throw new PmCliError("pm item complete requires a close reason.",EXIT_CODE.USAGE);const evidence=Object.fromEntries(["file","doc","test","comment","note","learning"].filter(key=>options[key]!==void 0).map(key=>[key,options[key]])),force=options.force===!0,{lockTtlSeconds,lockWaitMs}=parseAtomicMutationControls(options),closeOptions={...typeof options.resolution=="string"?{resolution:options.resolution}:{},...typeof options.expectedResult=="string"?{expectedResult:options.expectedResult}:{},...typeof options.actualResult=="string"?{actualResult:options.actualResult}:{},...typeof options.completedAt=="string"?{completedAt:options.completedAt}:{},...typeof options.validateClose=="string"?{validateClose:options.validateClose}:{},...force?{force:!0}:{}},completion={id,reason,...Object.keys(evidence).length===0?{}:{evidence},...Object.keys(closeOptions).length===0?{}:{closeOptions},...force?{releaseOptions:{force:!0}}:{}},pmRoot=resolvePmRoot(process.cwd(),globalOptions.path),author=resolveAuthor(typeof options.author=="string"?options.author:globalOptions.author,(await readSettings(pmRoot)).author_default);if(options.dryRun===!0){const mutations=buildItemCompletionMutations(completion),validation=await previewItemMutations({pmRoot,transactionId,author,mutations});printResult({transaction_id:transactionId,dry_run:!0,validation,mutation_count:mutations.length,mutations},globalOptions);return}const result=await commitItemCompletion({pmRoot,transactionId,author,...completion,lockTtlSeconds,lockWaitMs});printResult({...result,mutation_count:Object.keys(result.results).length},globalOptions)}function registerStructuredMutationCommands(program){const itemCommand=program.commands.find(command=>command.name()==="item")??program.command("item").description("Run item lifecycle operations.");itemCommand.command("reopen <id> <reason>").option("--status <value>","Active target status: open or in_progress").option("--expected-result <value>","Current active planning expectation; otherwise the receipt offers recovery").option("--expected <value>","Alias for --expected-result").option("--message <value>","Human-readable recurrence history message").option("--force","Override ownership or stale-lock conflicts").option("--author <value>","Mutation author").description("Reopen terminal work with recurrence evidence.").action(runItemReopenAction),itemCommand.command("mutate").option("--transaction-id <value>","Stable idempotency key used to resume an interrupted batch; derived from the document when omitted").option("--stdin-json","Read the JSON mutation array from stdin",!0).option("--from <path>","Read the JSON, JSON Lines, or envelope document from a file (- for stdin)").option("--upsert-key <field>","Update the existing item whose field matches instead of creating a duplicate").option("--dry-run","Validate and preview the batch without writing").option("--create-compensation <mode>","Created-item compensation policy: close or delete","close").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--author <value>","Mutation author").description("Apply SDK-backed mutations atomically.").action(runItemMutateAction),itemCommand.command("complete <id> [reason]").requiredOption("--transaction-id <value>","Stable idempotency key for the composed completion").option("--reason <value>","Close reason when omitted positionally").option("--file <value>","Linked file evidence",collect).option("--doc <value>","Linked documentation evidence",collect).option("--test <value>","Linked test evidence",collect).option("--comment <value>","Evidence comment",collect).option("--note <value>","Completion note",collect).option("--learning <value>","Durable completion learning",collect).option("--resolution <value>","Structured resolution evidence").option("--expected-result <value>","Expected result evidence").option("--actual-result <value>","Actual result evidence").option("--completed-at <value>","Actual completion time").option("--validate-close <mode>","Close validation: off, warn, or strict").option("--lock-ttl-seconds <n>","Workspace transaction lock lifetime in seconds").option("--lock-wait-ms <n>","Maximum time to wait for the workspace transaction lock").option("--dry-run","Validate and preview completion without writing").option("--force","Override lifecycle and ownership conflicts").option("--author <value>","Completion author").description("Close with evidence and release the claim.").action(runItemCompleteAction)}const structuredMutationTestOnly={runItemCompleteAction,runItemMutateAction,runItemReopenAction};export{registerStructuredMutationCommands,structuredMutationTestOnly};
 //# sourceMappingURL=register-structured-mutation.js.map

package/dist/cli/runtime/activation.d.ts

@@ -6,46 +6,46 @@ import { Command } from "commander";
 import { type ExtensionDiscoveryResult } from "../../sdk/runtime-primitives.js";
 /** Normalized command path, arguments and provided options used to select extension activation without importing extension code. */
 interface RuntimeExtensionActivationProbe {
-commandPath?: string;
-commandArgs?: string[];
-allowCommandPrefixMatch?: boolean;
+commandPath?:string;
+commandArgs?:string[];
+allowCommandPrefixMatch?:boolean;
 }
 /** Collect positional words before the first option to probe the requested command path. */
-declare function collectLeadingCommandArgs(commandArgs: readonly string[] | undefined): string[];
+declare function collectLeadingCommandArgs(commandArgs:readonly string[] | undefined):string[];
 /** Match leading command paths against both native history spellings and stable extension operation identities. */
-declare function collectActivationCommandCandidates(probe: RuntimeExtensionActivationProbe): string[];
+declare function collectActivationCommandCandidates(probe:RuntimeExtensionActivationProbe):string[];
 /** Compare an extension activation command with the normalized invocation probe. */
-declare function activationCommandMatchesProbe(command: string, probe: RuntimeExtensionActivationProbe): boolean;
+declare function activationCommandMatchesProbe(command:string,probe:RuntimeExtensionActivationProbe):boolean;
 /** Read and normalize the command paths declared by an extension activation manifest. */
-declare function extensionActivationCommands(extension: ExtensionDiscoveryResult["effective"][number]): string[];
+declare function extensionActivationCommands(extension:ExtensionDiscoveryResult["effective"][number]):string[];
 /** Collect the capabilities declared by one discovered extension. */
-declare function extensionCapabilities(extension: ExtensionDiscoveryResult["effective"][number]): Set<string>;
+declare function extensionCapabilities(extension:ExtensionDiscoveryResult["effective"][number]):Set<string>;
 /** Test whether any declared capability belongs to the capability family required by an invocation. */
-declare function hasAnyCapability(capabilities: Set<string>, expected: Set<string>): boolean;
+declare function hasAnyCapability(capabilities:Set<string>,expected:Set<string>):boolean;
 /** Identify command paths that require search provider or vector-store registrations. */
-declare function commandPathNeedsSearchExtensions(commandPath: string | undefined): boolean;
+declare function commandPathNeedsSearchExtensions(commandPath:string | undefined):boolean;
 /** Check the provided invocation flags against one activation-sensitive flag family. */
-declare function probeUsesAnyFlag(probe: RuntimeExtensionActivationProbe, flags: Set<string>): boolean;
+declare function probeUsesAnyFlag(probe:RuntimeExtensionActivationProbe,flags:Set<string>):boolean;
 /** Identify invocations that consume extension-provided create templates. */
-declare function commandPathNeedsTemplateExtensions(probe: RuntimeExtensionActivationProbe): boolean;
+declare function commandPathNeedsTemplateExtensions(probe:RuntimeExtensionActivationProbe):boolean;
 /** Recognize runtime template contributions that require extension activation. */
-declare function extensionProvidesTemplatesRuntime(commands: readonly string[]): boolean;
+declare function extensionProvidesTemplatesRuntime(commands:readonly string[]):boolean;
 /** Match direct command paths plus the built-in create-template bridge. */
-declare function matchesStaticExtensionCommand(commands: readonly string[], probe: RuntimeExtensionActivationProbe): boolean;
+declare function matchesStaticExtensionCommand(commands:readonly string[],probe:RuntimeExtensionActivationProbe):boolean;
 /** Identify contribution surfaces that participate in global runtime behavior. */
-declare function hasGlobalExtensionContributions(contributions: NonNullable<ExtensionDiscoveryResult["effective"][number]["contributions"]>): boolean;
+declare function hasGlobalExtensionContributions(contributions:NonNullable<ExtensionDiscoveryResult["effective"][number]["contributions"]>):boolean;
 /** Resolve an exact activation verdict from declared commands and contributions. */
-declare function resolveStaticExtensionActivationDecision(extension: ExtensionDiscoveryResult["effective"][number], probe: RuntimeExtensionActivationProbe): boolean | undefined;
+declare function resolveStaticExtensionActivationDecision(extension:ExtensionDiscoveryResult["effective"][number],probe:RuntimeExtensionActivationProbe):boolean | undefined;
 /** Combine static contributions and capability fallbacks to decide whether one extension must activate. */
-declare function extensionNeedsActivationForProbe(extension: ExtensionDiscoveryResult["effective"][number], probe: RuntimeExtensionActivationProbe): boolean;
+declare function extensionNeedsActivationForProbe(extension:ExtensionDiscoveryResult["effective"][number],probe:RuntimeExtensionActivationProbe):boolean;
 /** Decide whether installed providers must activate for a targeted invocation or complete command discovery. */
-declare function discoveryNeedsActivationForProbe(discovery: ExtensionDiscoveryResult, probe: RuntimeExtensionActivationProbe): boolean;
+declare function discoveryNeedsActivationForProbe(discovery:ExtensionDiscoveryResult,probe:RuntimeExtensionActivationProbe):boolean;
 /** Build a deterministic activation scope; completion and unconstrained discovery include every installed command provider. */
-declare function buildRuntimeExtensionActivationScope(probe: RuntimeExtensionActivationProbe): string;
+declare function buildRuntimeExtensionActivationScope(probe:RuntimeExtensionActivationProbe):string;
 /** Create the loader predicate for extensions needed by the current invocation. */
-declare function buildRuntimeExtensionFilterForProbe(probe: RuntimeExtensionActivationProbe): ((extension: ExtensionDiscoveryResult["effective"][number]) => boolean) | undefined;
+declare function buildRuntimeExtensionFilterForProbe(probe:RuntimeExtensionActivationProbe):((extension:ExtensionDiscoveryResult["effective"][number]) => boolean) | undefined;
 /** Build an activation probe from bootstrap argv before Commander registration. */
-declare function buildBootstrapActivationProbe(invocationArgv: string[]): RuntimeExtensionActivationProbe;
+declare function buildBootstrapActivationProbe(invocationArgv:string[]):RuntimeExtensionActivationProbe;
 /** Collect the command arguments retained by Commander for an activation probe. */
-declare function collectParsedActivationCommandArgs(command: Command): string[];
-export { RuntimeExtensionActivationProbe, activationCommandMatchesProbe, buildBootstrapActivationProbe, buildRuntimeExtensionActivationScope, buildRuntimeExtensionFilterForProbe, collectActivationCommandCandidates, collectLeadingCommandArgs, collectParsedActivationCommandArgs, commandPathNeedsSearchExtensions, commandPathNeedsTemplateExtensions, discoveryNeedsActivationForProbe, extensionActivationCommands, extensionCapabilities, extensionNeedsActivationForProbe, extensionProvidesTemplatesRuntime, hasAnyCapability, hasGlobalExtensionContributions, matchesStaticExtensionCommand, probeUsesAnyFlag, resolveStaticExtensionActivationDecision };
+declare function collectParsedActivationCommandArgs(command:Command):string[];
+export { RuntimeExtensionActivationProbe,activationCommandMatchesProbe,buildBootstrapActivationProbe,buildRuntimeExtensionActivationScope,buildRuntimeExtensionFilterForProbe,collectActivationCommandCandidates,collectLeadingCommandArgs,collectParsedActivationCommandArgs,commandPathNeedsSearchExtensions,commandPathNeedsTemplateExtensions,discoveryNeedsActivationForProbe,extensionActivationCommands,extensionCapabilities,extensionNeedsActivationForProbe,extensionProvidesTemplatesRuntime,hasAnyCapability,hasGlobalExtensionContributions,matchesStaticExtensionCommand,probeUsesAnyFlag,resolveStaticExtensionActivationDecision };

package/dist/cli/runtime/invocation-options.d.ts

@@ -3,13 +3,13 @@
  * Preserves global-option boundaries, contributed flag schemas and read-output provenance.
  */
 import { Command } from "commander";
-import { type FlagDefinition, type GlobalOptions, createEmptyExtensionRegistrationRegistry } from "../../sdk/runtime-primitives.js";
+import { type FlagDefinition,type GlobalOptions,createEmptyExtensionRegistrationRegistry } from "../../sdk/runtime-primitives.js";
 import { type ExtensionCommandHelpDescriptor } from "../extension-command-help.js";
 import { type LooseCommandFlagDefinition } from "../extension-command-options.js";
 /** Carry private read-output provenance across Commander's option rebuilds. */
-declare function copyReadOutputInvocationProvenance(source: object, target: object): void;
+declare function copyReadOutputInvocationProvenance(source:object,target:object):void;
 /** Record the exact compatibility flags present in the raw CLI invocation. */
-declare function recordCliReadOutputInvocationProvenance(actionCommand: Command, commandPath: string, commandOptions: Record<string, unknown>): void;
+declare function recordCliReadOutputInvocationProvenance(actionCommand:Command,commandPath:string,commandOptions:Record<string,unknown>):void;
 /**
  * Hand canonical `--output-include` projection modes to the command that owns
  * them, leaving only field selectors for post-execution projection.
@@ -18,15 +18,15 @@ declare function recordCliReadOutputInvocationProvenance(actionCommand: Command,
  * emitted migration hint promises; a mode can only be honoured before the
  * command computes its rows, so it cannot be resolved by the output layer.
  */
-declare function forwardReadOutputIncludeModes(actionCommand: Command, commandPath: string, globalOptions: GlobalOptions, commandOptions: Record<string, unknown>): void;
+declare function forwardReadOutputIncludeModes(actionCommand:Command,commandPath:string,globalOptions:GlobalOptions,commandOptions:Record<string,unknown>):void;
 /** Separate handler options from global controls, then validate and coerce contributed flags against the command's declared schema. */
-declare function extractCommandScopedOptions(command: Command, commandArgs: string[], extensionFlagDefinitions?: LooseCommandFlagDefinition[]): Record<string, unknown>;
+declare function extractCommandScopedOptions(command:Command,commandArgs:string[],extensionFlagDefinitions?:LooseCommandFlagDefinition[]):Record<string,unknown>;
 /** Join contributed flags by stable operation identity so canonical and compatibility command paths share the same schema. */
-declare function collectExtensionFlagDefinitionsForCommand(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, commandPath: string): FlagDefinition[];
+declare function collectExtensionFlagDefinitionsForCommand(registrations:ReturnType<typeof createEmptyExtensionRegistrationRegistry>,commandPath:string):FlagDefinition[];
 /** Collect contributed flag definitions for the command paths traversed by this invocation. */
-declare function collectExtensionFlagDefinitionsForInvocation(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry>, commandPath: string, commandArgs: string[]): FlagDefinition[];
+declare function collectExtensionFlagDefinitionsForInvocation(registrations:ReturnType<typeof createEmptyExtensionRegistrationRegistry>,commandPath:string,commandArgs:string[]):FlagDefinition[];
 /** Read contributed positional argument definitions for a dynamic command. */
-declare function dynamicCommandArguments(descriptor: ExtensionCommandHelpDescriptor): ExtensionCommandHelpDescriptor["arguments"];
+declare function dynamicCommandArguments(descriptor:ExtensionCommandHelpDescriptor):ExtensionCommandHelpDescriptor["arguments"];
 /**
  * Reports whether {@link commandPath} is the generated command path of a
  * registered importer (`<name> import`) or exporter (`<name> export`). Importers
@@ -35,9 +35,9 @@ declare function dynamicCommandArguments(descriptor: ExtensionCommandHelpDescrip
  * `registerCommand` commands intentionally accept positionals via `context.args`
  * and are excluded.
  */
-declare function isImporterOrExporterCommandPath(registrations: ReturnType<typeof createEmptyExtensionRegistrationRegistry> | null, commandPath: string): boolean;
+declare function isImporterOrExporterCommandPath(registrations:ReturnType<typeof createEmptyExtensionRegistrationRegistry> | null,commandPath:string):boolean;
 /** Reject missing required or excess positional arguments before invoking a contributed handler. */
-declare function validateDynamicExtensionCommandArgs(descriptor: ExtensionCommandHelpDescriptor, args: string[]): void;
+declare function validateDynamicExtensionCommandArgs(descriptor:ExtensionCommandHelpDescriptor,args:string[]):void;
 /** Validate contributed arguments and options together before extension dispatch. */
-declare function validateDynamicExtensionCommandInvocation(descriptor: ExtensionCommandHelpDescriptor | undefined, args: string[], options: Record<string, unknown>, extensionFlagDefinitions: LooseCommandFlagDefinition[]): void;
-export { collectExtensionFlagDefinitionsForCommand, collectExtensionFlagDefinitionsForInvocation, copyReadOutputInvocationProvenance, dynamicCommandArguments, extractCommandScopedOptions, forwardReadOutputIncludeModes, isImporterOrExporterCommandPath, recordCliReadOutputInvocationProvenance, validateDynamicExtensionCommandArgs, validateDynamicExtensionCommandInvocation };
+declare function validateDynamicExtensionCommandInvocation(descriptor:ExtensionCommandHelpDescriptor | undefined,args:string[],options:Record<string,unknown>,extensionFlagDefinitions:LooseCommandFlagDefinition[]):void;
+export { collectExtensionFlagDefinitionsForCommand,collectExtensionFlagDefinitionsForInvocation,copyReadOutputInvocationProvenance,dynamicCommandArguments,extractCommandScopedOptions,forwardReadOutputIncludeModes,isImporterOrExporterCommandPath,recordCliReadOutputInvocationProvenance,validateDynamicExtensionCommandArgs,validateDynamicExtensionCommandInvocation };

package/dist/cli/runtime/invocation-options.js

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

package/dist/cli/runtime/projection-retry.d.ts

@@ -6,4 +6,4 @@
  */
 import type { PmCliErrorRecoveryPayload } from "../../sdk/runtime-primitives.js";
 /** Preserve the original read invocation when correcting known projection refusals. */
-export declare function repairProjectionRecovery(argv: readonly string[], code: string | undefined, recovery: PmCliErrorRecoveryPayload | undefined): PmCliErrorRecoveryPayload | undefined;
+export declare function repairProjectionRecovery(argv:readonly string[],code:string | undefined,recovery:PmCliErrorRecoveryPayload | undefined):PmCliErrorRecoveryPayload | undefined;

package/dist/cli/runtime/selection.d.ts

@@ -5,31 +5,31 @@
 import { Command } from "commander";
 import { normalizeBootstrapInvocation } from "../bootstrap-args.js";
 /** Recognize the read-only package inventory before extension bootstrap. */
-declare function isStaticExtensionInventoryInvocation(invocationArgv: string[]): boolean;
+declare function isStaticExtensionInventoryInvocation(invocationArgv:string[]):boolean;
 /** Protect literal preview candidates in the item namespace until the real parser settles the selected action; host-owned global grammar also captures the tracker roots. */
-declare function resolveStructuredMutationPreviewInvocation(invocationArgv: string[]): {
-path: string | undefined;
+declare function resolveStructuredMutationPreviewInvocation(invocationArgv:string[]):{
+path:string | undefined;
 } | undefined;
 /** Core read command names used to select the list/query registration family. */
-declare const LIST_QUERY_COMMAND_NAMES: Set<string>;
+declare const LIST_QUERY_COMMAND_NAMES:Set<string>;
 /** Registration-family switches computed from one CLI invocation. */
 interface CoreCommandRegistrationSelection {
-setup: boolean;
-listQuery: boolean;
-mutation: boolean;
-operation: boolean;
-targetCommandName?: string;
+setup:boolean;
+listQuery:boolean;
+mutation:boolean;
+operation:boolean;
+targetCommandName?:string;
 }
 /** Recognize version requests before loading command families. */
-declare function invocationRequestsVersion(invocationArgv: string[]): boolean;
+declare function invocationRequestsVersion(invocationArgv:string[]):boolean;
 /** Load only the selected core registration family, retaining complete discovery for help and unknown paths. */
-declare function resolveCoreCommandRegistrationSelection(invocationArgv: string[]): CoreCommandRegistrationSelection;
+declare function resolveCoreCommandRegistrationSelection(invocationArgv:string[]):CoreCommandRegistrationSelection;
 /** Decide whether the invocation needs the expanded help text attached to registered commands. */
-declare function shouldAttachRichHelpTextForInvocation(invocationArgv: string[]): boolean;
+declare function shouldAttachRichHelpTextForInvocation(invocationArgv:string[]):boolean;
 /** Decide whether extension command paths must be registered for this invocation. */
-declare function shouldRegisterDynamicExtensionPaths(_rootProgram: Command, invocationArgv: string[]): boolean;
+declare function shouldRegisterDynamicExtensionPaths(_rootProgram:Command,invocationArgv:string[]):boolean;
 /** Decide whether the invocation needs flags supplied by the runtime item schema. */
-declare function shouldRegisterRuntimeSchemaFlags(invocationArgv: string[]): boolean;
+declare function shouldRegisterRuntimeSchemaFlags(invocationArgv:string[]):boolean;
 /** Refuse unknown flags with correction guidance while requiring an explicit retry for mutations. */
-declare function enforceExplicitRetryForFlagTypos(bootstrapInvocation: ReturnType<typeof normalizeBootstrapInvocation>): void;
-export { CoreCommandRegistrationSelection, LIST_QUERY_COMMAND_NAMES, enforceExplicitRetryForFlagTypos, invocationRequestsVersion, isStaticExtensionInventoryInvocation, resolveStructuredMutationPreviewInvocation, resolveCoreCommandRegistrationSelection, shouldAttachRichHelpTextForInvocation, shouldRegisterDynamicExtensionPaths, shouldRegisterRuntimeSchemaFlags };
+declare function enforceExplicitRetryForFlagTypos(bootstrapInvocation:ReturnType<typeof normalizeBootstrapInvocation>):void;
+export { CoreCommandRegistrationSelection,LIST_QUERY_COMMAND_NAMES,enforceExplicitRetryForFlagTypos,invocationRequestsVersion,isStaticExtensionInventoryInvocation,resolveStructuredMutationPreviewInvocation,resolveCoreCommandRegistrationSelection,shouldAttachRichHelpTextForInvocation,shouldRegisterDynamicExtensionPaths,shouldRegisterRuntimeSchemaFlags };

package/dist/cli/runtime/telemetry-outcome.d.ts

@@ -1,20 +1,20 @@
-import { type TelemetryCommandOutcome, type TelemetryCommandResolution, type TelemetryErrorCategory, type TelemetryResolutionStage } from "../../sdk/runtime-primitives.js";
+import { type TelemetryCommandOutcome,type TelemetryCommandResolution,type TelemetryErrorCategory,type TelemetryResolutionStage } from "../../sdk/runtime-primitives.js";
 /** Read a string-valued field from a structured command result without coercion. */
-declare function readRecordString(record: Record<string, unknown> | null, ...keys: string[]): string | undefined;
+declare function readRecordString(record:Record<string,unknown> | null,...keys:string[]):string | undefined;
 /** Read a boolean-valued field from a structured command result without coercion. */
-declare function readRecordBoolean(record: Record<string, unknown> | null, ...keys: string[]): boolean | undefined;
+declare function readRecordBoolean(record:Record<string,unknown> | null,...keys:string[]):boolean | undefined;
 /** Read a number-valued field from a structured command result without coercion. */
-declare function readRecordNumber(record: Record<string, unknown> | null, ...keys: string[]): number | undefined;
+declare function readRecordNumber(record:Record<string,unknown> | null,...keys:string[]):number | undefined;
 /** Accept only declared command-resolution values for telemetry receipts. */
-declare function normalizeTelemetryCommandResolution(value: string | undefined): TelemetryCommandResolution | undefined;
+declare function normalizeTelemetryCommandResolution(value:string | undefined):TelemetryCommandResolution | undefined;
 /** Accept only declared resolution-stage values for telemetry receipts. */
-declare function normalizeTelemetryResolutionStage(value: string | undefined): TelemetryResolutionStage | undefined;
+declare function normalizeTelemetryResolutionStage(value:string | undefined):TelemetryResolutionStage | undefined;
 /** Accept only declared error-category values for telemetry receipts. */
-declare function normalizeTelemetryErrorCategory(value: string | undefined): TelemetryErrorCategory | undefined;
+declare function normalizeTelemetryErrorCategory(value:string | undefined):TelemetryErrorCategory | undefined;
 /** Derive a completion failure message from the command result and process outcome. */
-declare function inferPostActionFailureMessage(result: Record<string, unknown> | null): string | undefined;
+declare function inferPostActionFailureMessage(result:Record<string,unknown> | null):string | undefined;
 /** Derive the canonical completion error code from the structured result. */
-declare function inferPostActionErrorCode(ok: boolean, exitCode: number): string | undefined;
+declare function inferPostActionErrorCode(ok:boolean,exitCode:number):string | undefined;
 /** Combine structured command receipts and exit state into a terminal telemetry outcome. */
-declare function buildPostActionTelemetryOutcome(): TelemetryCommandOutcome;
-export { buildPostActionTelemetryOutcome, inferPostActionErrorCode, inferPostActionFailureMessage, normalizeTelemetryCommandResolution, normalizeTelemetryErrorCategory, normalizeTelemetryResolutionStage, readRecordBoolean, readRecordNumber, readRecordString };
+declare function buildPostActionTelemetryOutcome():TelemetryCommandOutcome;
+export { buildPostActionTelemetryOutcome,inferPostActionErrorCode,inferPostActionFailureMessage,normalizeTelemetryCommandResolution,normalizeTelemetryErrorCategory,normalizeTelemetryResolutionStage,readRecordBoolean,readRecordNumber,readRecordString };