@unbrained/pm-cli 2026.10.11 → 2026.10.13

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]="83eb6904-cf04-5c83-8281-0b8b8bb04d48")}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";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(values.addValues.length>0||values.addJsonValues.length>0||values.removeValues.length>0||values.removeIndexValues.length>0)throw new PmCliError("--background does not support --add/--add-json/--remove/--remove-index; update linked tests first, then run in background",EXIT_CODE.USAGE)}}async function runBackgroundLinkedTests(id,options,globalOptions,values){const result=await runStartBackgroundRun({kind:"test",commandArgs:buildBackgroundTestCommandArgs(id,{...options,add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues}),targetId:id,author:typeof options.author=="string"?options.author:void 0,noExtensions:globalOptions.noExtensions===!0},globalOptions);printResult(result,globalOptions)}function buildRunTestOptions(options,values){return{add:values.addValues,addJson:values.addJsonValues,remove:values.removeValues,removeIndex:values.removeIndexValues,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);(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")||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);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 linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>","Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)",collect).option("--env-clear <value>","Clear environment variable(s) for linked-test runs (NAME, repeatable)",collect).option("--shared-host-safe","Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>","PM test context: schema|tracker|auto|none (default: schema)").option("--override-linked-pm-context","Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--workspace-context <mode>","Source-workspace mode: source|isolated|snapshot (default: source)").option("--override-linked-workspace-context","Force run-level --workspace-context over per-linked-test metadata").option("--allow-untrusted-linked-tests","Execute untrusted linked commands when project policy also permits it").option("--fail-on-context-mismatch","Fail linked PM commands when context item counts differ").option("--fail-on-skipped","Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run","Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm","Require assertion metadata for linked PM command tests").option("--check-context","Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context","Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context")}function registerOperationCommands(program){registerAssuranceCommand(program);const testCommand=program.command("test").argument("<id>","Item id").option("--add <value>","Add verified isolated test (CSV/markdown or stdin)",collect).option("--add-json <value>","Add verified isolated test (JSON object/array or stdin)",collect).option("--remove <value>","Remove linked test entry by exact command/path (command=<value> and path=<value> preserve commas and equals signs; or - for stdin)",collect).option("--remove-index <n>","Remove the 1-based linked-test index from --list order (repeatable)",collect).option("--list","List linked tests without mutating").option("--run","Run linked test commands").option("--match <value>","Run only linked tests whose command/path contains this substring").option("--only-index <n>","Run only the 1-based linked-test index from --list order").option("--only-last","Run only the most recently added linked test");testCommand.option("--acknowledge-linked-tests","Trust the item's current linked commands in this clone without executing them"),addLinkedTestExecutionOptions(testCommand).option("--measure <value>","Record name=value[,unit=...][,threshold=...] evidence; repeatable",collect).option("--metric-below <value>","Return evidence below name=value").option("--metric-diff <name>","Diff the latest two values").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership override").description("Manage tests linked to an item and optionally run them.").action(runTestCommandAction);const testAllCommand=program.command("test-all").description("Run linked tests across matching items.").option("--status <value>","Filter items by status before running tests").option("--limit <n>","Limit matching items before running linked tests").option("--offset <n>","Skip matching items before running linked tests");addLinkedTestExecutionOptions(testAllCommand).action(runTestAllAction),program.command("test-runs-worker",{hidden:!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]="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};
 //# sourceMappingURL=register-operations.js.map

package/dist/cli/register-setup.d.ts

@@ -9,7 +9,7 @@ type LifecycleCommandVocabulary = "extension" | "package";
 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;
+normalizeExtensionOptions: typeof normalizeExtensionOptions;
 };
 /** Register initialization, configuration, package, and extension setup commands. */
 export declare function registerSetupCommands(program: Command): void;

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

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

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

@@ -6,9 +6,9 @@ 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[];

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

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

@@ -8,17 +8,17 @@ import { normalizeBootstrapInvocation } from "../bootstrap-args.js";
 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;
+path: string | undefined;
 } | undefined;
 /** Core read command names used to select the list/query registration family. */
 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;

package/dist/cli/runtime-compatibility-boundary.d.ts

@@ -1,17 +1,17 @@
 /** Options for one early CLI compatibility check and deferred dispatch. */
 export interface RuntimeCompatibleCliOptions {
-    /** Version of the executable package, when its manifest was readable. */
-    executingVersion?: string;
-    /** Project root whose local package and lock metadata governs mutation. */
-    projectRoot: string;
-    /** CLI invocation arguments after the executable path. */
-    argv: readonly string[];
-    /** Explicit recovery override for one invocation. */
-    allowStale: boolean;
-    /** Deferred CLI bundle dispatch, called only after compatibility succeeds. */
-    run: () => Promise<void>;
-    /** Error sink used by the executable transport. */
-    writeError: (message: string) => void;
+/** Version of the executable package, when its manifest was readable. */
+executingVersion?: string;
+/** Project root whose local package and lock metadata governs mutation. */
+projectRoot: string;
+/** CLI invocation arguments after the executable path. */
+argv: readonly string[];
+/** Explicit recovery override for one invocation. */
+allowStale: boolean;
+/** Deferred CLI bundle dispatch, called only after compatibility succeeds. */
+run: () => Promise<void>;
+/** Error sink used by the executable transport. */
+writeError: (message: string) => void;
 }
 /** Apply SDK compatibility/output policy, emitting structured read warnings only after successful dispatch. */
 export declare function runRuntimeCompatibleCli(options: RuntimeCompatibleCliOptions): Promise<void>;

package/dist/cli-bundle/bundle-manifest.json

@@ -1 +1 @@
-{"schema_version":1,"generation":"696d42b433862dc6e191b65f5d2b83b57f9957eafad35adcdb8ad828597397e2","files":[{"path":"chunks/chunk-2JYTSTQP.js","sha256":"85b8aaab16e994840ec3113bf41b5a4a4e7d7967abe5fa466b87ce8cb948faaf"},{"path":"chunks/chunk-2JYTSTQP.js.map","sha256":"3e7a41501667302c45be0a3e1156523a60d3db0b650be7cd5975f383b0b67756"},{"path":"chunks/chunk-BXSXT5Z6.js","sha256":"f652a12b0224808eaf1fda519bb9b07a8ac3afd49bc8692f96beaa8ebf3650ce"},{"path":"chunks/chunk-BXSXT5Z6.js.map","sha256":"f93a7ce28c2be6e02729f12b3a259f774dfad354af303243f0ee9b716d8937de"},{"path":"chunks/chunk-DEZPZOQ7.js","sha256":"ef11ddab9ecc9533cac75ccc8ca41058a59382dfbe3262033fa21c7264d73b0d"},{"path":"chunks/chunk-DEZPZOQ7.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"chunks/chunk-ESRACL6K.js","sha256":"b7935e8590f383c6cfe0e3b60fb34617b245992029a611e35c242ba0e7c3de80"},{"path":"chunks/chunk-ESRACL6K.js.map","sha256":"1af6d2b3589428b4f33fd1637a1714b8a8731bf06e173a7dff48d097687b8b05"},{"path":"chunks/chunk-K2UTE75T.js","sha256":"5ea0322ebcfd61dc7050373731dc2346a7d118feb53fdac3f5d1b81536dec6a3"},{"path":"chunks/chunk-K2UTE75T.js.map","sha256":"c43602cd3cf04ccecc1f5261ca311d9d66f8fe228f26b20a9837f63a5f5f2b09"},{"path":"chunks/chunk-KNW3RSLS.js","sha256":"8a73038fa562a32e310e19926d4582bcbc48d002e782d07a5c361e9df4c3a058"},{"path":"chunks/chunk-KNW3RSLS.js.map","sha256":"d5599aa6e37a74c71a8a41c1368409ef1b4b25a84e83ccd45eed8af01d669b60"},{"path":"chunks/chunk-MEWBSWE3.js","sha256":"14f2f5a24998c37fb0e29277778020a06d057caab045f42136fdcecb880da101"},{"path":"chunks/chunk-MEWBSWE3.js.map","sha256":"cb711da3a5d5ded1dcfcf1ac1cf0a1b515f795eb29bf42c0309f4f493fea9c74"},{"path":"chunks/chunk-OBLO45UM.js","sha256":"366b433ea4e006943180965a024431ad78ff6277ff1e1840b91b4ff091ab0539"},{"path":"chunks/chunk-OBLO45UM.js.map","sha256":"6b34a8705de6f3da0cea90f67a38f66525bb3d9c19a79f0f7d8a47290729ee05"},{"path":"chunks/chunk-RBPOO46D.js","sha256":"6523fb9d7016454b9d95a5b37451f2637116f4be645a5a49a6c8c72b1ca413ab"},{"path":"chunks/chunk-RBPOO46D.js.map","sha256":"5da34788523e8c041c37860bff267aaa93fc9b5fcc8889ed91b8322fcce2d7b9"},{"path":"chunks/chunk-RUT3CCAG.js","sha256":"5bf1e7bcb95bf1e342c2502d7663d2a1e109b85e53e9f32f15debc9dfb111bac"},{"path":"chunks/chunk-RUT3CCAG.js.map","sha256":"a5389a37cb9a81411ca6c79b3c503e0dc4c671953ad15774e05cc84e2225e9df"},{"path":"chunks/chunk-S445XEYT.js","sha256":"1629ce5d5836f591077f80a4daac752f5272b2a420d7176aad8d4470fa698024"},{"path":"chunks/chunk-S445XEYT.js.map","sha256":"6fd279b7be9c6be35b8c167ca9cf6f8347dab5eb241870f1e4f22ae9185bdd5d"},{"path":"chunks/chunk-SGFQQXFD.js","sha256":"27cfd4152f894bbd21c5d4f1d8ba40ea447d11983ec3b09a578d8bbc787522d7"},{"path":"chunks/chunk-SGFQQXFD.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"chunks/chunk-SSY4OSJR.js","sha256":"fa4d2d9dfb8ec5730f7c06ac8582f4a28888a3c78758e8aaab788fe2238cb29b"},{"path":"chunks/chunk-SSY4OSJR.js.map","sha256":"6aa792909322de88c511d97945d7c4fe91bb69cf9413f57e0a706ea10e9c57d9"},{"path":"chunks/chunk-YMLF6QT7.js","sha256":"e8633a2cae7eb997392165039915a74db54495005f770c542b3517efeedd8d01"},{"path":"chunks/chunk-YMLF6QT7.js.map","sha256":"e3fb07f07a6fa50e8dcb0099e663f236805aac551a277f8caf8ba72fff3621b9"},{"path":"chunks/chunk-ZWRLAOA4.js","sha256":"9b528a34d1beefb890e0d77f1a0f5517de6ed291c95e6f1a8818bede1c0f44b5"},{"path":"chunks/chunk-ZWRLAOA4.js.map","sha256":"3ef6aaaab9d223b065b678a7eb29cc8fb1a241156372d5809b00812dd5a84afb"},{"path":"chunks/register-list-query-T6BOR67M.js","sha256":"2d36fcd55405cc17b62f484708ec6f55ee8f68e4ba85b722d16ef726d6ee64e7"},{"path":"chunks/register-list-query-T6BOR67M.js.map","sha256":"e19ba32fa75b0e4f97fb2d9458527574eca136ae3b68a700ef113cbf12bd6097"},{"path":"chunks/register-mutation-6NXR7SAJ.js","sha256":"e692469a7bbb0fc9b754351a551cc3ec63cfa5179cc6cb8905392dbc60c5a811"},{"path":"chunks/register-mutation-6NXR7SAJ.js.map","sha256":"c8f080808fe8dd71e91daa6e39baeaa50f069b8201e3b0464cb5fd48c992a637"},{"path":"chunks/register-operations-PDOBQZUJ.js","sha256":"2635f5184c2f9c5975fabf4133c53999e53c62eb6cbfdb83c502d3d021cc1bef"},{"path":"chunks/register-operations-PDOBQZUJ.js.map","sha256":"ca43c66d37818e8cde2059d638bad2a730015c1ecdbad6c92403db8e715b25a3"},{"path":"chunks/register-setup-MAYFPKBX.js","sha256":"28798ad31f6e5b6ddcbb092510cd0ddb5d532d867e8f23995d0dc7addc73a45e"},{"path":"chunks/register-setup-MAYFPKBX.js.map","sha256":"8d0b4b046e9171902d34fc24470baef90c50e8c9ea4a62fd2d698fb406cec70e"},{"path":"focused-chunks/chunk-2CJWTLQG.js","sha256":"deb1d846c19c33f310da0e823404992b8a1a2509113e951e6c53d3f177502bc1"},{"path":"focused-chunks/chunk-2CJWTLQG.js.map","sha256":"76dbee9d26f6956fae78f2447f0cd69c38a7bf6a6e2bb0933ce788573e45de68"},{"path":"focused-chunks/chunk-52UJEHEV.js","sha256":"8d67f54dc645bc15f05552fe1e26acd938611886970d0ecf58246d563a6fb7e3"},{"path":"focused-chunks/chunk-52UJEHEV.js.map","sha256":"c44cb6d89bd61c40a4d7da9fa9be421c1f5e57a278b83639c0a78ed9b97f4265"},{"path":"focused-chunks/chunk-AU6VJGTY.js","sha256":"adb78f09026ab5121355ea30dc98fb6351835aff39288028f82db611dc746973"},{"path":"focused-chunks/chunk-AU6VJGTY.js.map","sha256":"5c9cd60c3b5a6589afc40d0f2d21135b9970f2da2e5fb6e80b0924f3463f87cf"},{"path":"focused-chunks/chunk-B3YW6H2I.js","sha256":"6d6a23b7818a8b0bf44cbe2943e52fbdd31dcb9db2a39d41d8c93a5e62c1e2ee"},{"path":"focused-chunks/chunk-B3YW6H2I.js.map","sha256":"7dec2d9465f99271c8647b0f13580773c3f716b05c17b952e5fd349c04116164"},{"path":"focused-chunks/chunk-DMSADMEU.js","sha256":"98db742f39586057f8b12c74fe9edeebf919a84b22e0990ae5e24908474dc76e"},{"path":"focused-chunks/chunk-DMSADMEU.js.map","sha256":"5921f606b225ba4190883e651ea103a63d439da84555f992cda3e9b21e230f51"},{"path":"focused-chunks/chunk-EIOQNLBQ.js","sha256":"f8643336013d54147f7b180b41b1cef346eef0e7d331af699f971e53bf3e1da6"},{"path":"focused-chunks/chunk-EIOQNLBQ.js.map","sha256":"f44108b13cb540ecfc6b6218c6a7f7521477b4cb89c831e5548ce79184b0117a"},{"path":"focused-chunks/chunk-GVGFUD52.js","sha256":"c47cb29f7ea4258a3abbda095ffe0ba446f4a2258157d52c4ba3286d8bfc9537"},{"path":"focused-chunks/chunk-GVGFUD52.js.map","sha256":"79ca1896215749ec59dc6aa9546bd4c8315075cf6a4c9720d0be851a51bcfdbf"},{"path":"focused-chunks/chunk-JGFSSR3G.js","sha256":"b58f88eaef76684e791605617f09baf9be75abe14ab58d2bf509bcb17fb168a6"},{"path":"focused-chunks/chunk-JGFSSR3G.js.map","sha256":"e6617734dcf030194f1bacbe24e93213412bef6f539b1bb241058774814e65b5"},{"path":"focused-chunks/chunk-KNJR2WUO.js","sha256":"1394fbe82bd7d0597b3deb7f8a158b0cbf2401f955fd61b2f8f8f2c2cde9da4b"},{"path":"focused-chunks/chunk-KNJR2WUO.js.map","sha256":"20749ec10f9892d1d9430a7d6bcd0bf0f83bb8c91a909f9c62871945d8f76494"},{"path":"focused-chunks/chunk-MJQ253F3.js","sha256":"6ffb3bebd034241e93344f2ee9f1f3ef6b5ef8d44942bf9be5544a3237cf46d4"},{"path":"focused-chunks/chunk-MJQ253F3.js.map","sha256":"a2569ff7f435b5a1aae49d38c41ca8620d6153c8bf4c00c61bdc7264c4af4da5"},{"path":"focused-chunks/chunk-PBCYGO7X.js","sha256":"9d9a453a7b0f42ae79ac2fe450089734aa88711c0b60e7c344138cec0e2b6c9b"},{"path":"focused-chunks/chunk-PBCYGO7X.js.map","sha256":"e938ef0bc2bd10a14ffea780a96ac45fb591c25366d7cb9788da75147cd9b5d0"},{"path":"focused-chunks/chunk-PLTTMQAW.js","sha256":"8029def23807eb471876a8ce51b38bd6476d28dba32597774255433c60605837"},{"path":"focused-chunks/chunk-PLTTMQAW.js.map","sha256":"dff3ff9950a4f09ab39a4095eb75616c9222261021633610931bbbad00358f12"},{"path":"focused-chunks/chunk-SIEGIPNT.js","sha256":"2817cd3d0a3864baa7eb2c480db67f4a78758b8eab3bfa12d98496992027ebd9"},{"path":"focused-chunks/chunk-SIEGIPNT.js.map","sha256":"89f2bc0d9b5d62ce0b0b8d7f914e9583de89d54294eca1c715b95230e1e2ed7d"},{"path":"focused-chunks/chunk-W5AE7GKZ.js","sha256":"3d7ad0155d17900b46d826ecd2d1d90a69b17453e45c3050da986f8480604482"},{"path":"focused-chunks/chunk-W5AE7GKZ.js.map","sha256":"fe860b039561780930e399da5013c9b8e39dd90cb73a4e2f44562dd1b769409c"},{"path":"focused-chunks/chunk-WAOXID5J.js","sha256":"95b0bebfbe00d4f62165417f5b6a1ed80ce0e59ed0c8b3b286e5de9b26f89202"},{"path":"focused-chunks/chunk-WAOXID5J.js.map","sha256":"b18ce126e128112da9d3e61c031b117dcf0c3f8740dd008785445992816e81ef"},{"path":"focused-chunks/chunk-WOEZJUA2.js","sha256":"8c9aa13d03353bd1556b50e7853e28871a5a519606355edd6342eff3f0dd41d8"},{"path":"focused-chunks/chunk-WOEZJUA2.js.map","sha256":"e4fcac9448136a84e614f973dbf73fdecb49dd7011c5449c3c13419f9b2d33e6"},{"path":"focused-chunks/chunk-YLVHHWHN.js","sha256":"aed33cc3c5024b75a909cf5c01ac1d0161d9f56cc87c9c7638662f82a4d94626"},{"path":"focused-chunks/chunk-YLVHHWHN.js.map","sha256":"2536922ae21f29b6d28033a35d9aba3d921ee26867d733ba0a76857c97366cd9"},{"path":"main.js","sha256":"819a3cbff0e5d838bf116a0e7473ec0b463f88e012d558f2219f4c707e6cd3b6"},{"path":"main.js.map","sha256":"26f6787d82e1ae430b57e1201b8a5a17c274dd1343f658afc7fee061aef71cda"},{"path":"sdk-authoring.js","sha256":"f7eeae7dbe830deff2fa9837347e97d52212b57bfc1196ce15a7b7006822d8b0"},{"path":"sdk-authoring.js.map","sha256":"250eb6359393501e749d3ae54b9d302f75e3ab6ba4f59a502842a33800f41750"},{"path":"sdk-contracts.js","sha256":"3682d4daa0f2862e1a4da91a3372c43ec996ffe72fd757abb0d0e6f66cf876de"},{"path":"sdk-contracts.js.map","sha256":"8f75401945db3e8549c1de7a0f9324ff51099e4ed917b6e466a3904463fe1591"},{"path":"sdk-core.js","sha256":"f338466caf1bcb144e208dae5f61051c870d48b81fe2cb99d007a5594d010d40"},{"path":"sdk-core.js.map","sha256":"b3f449c3c18d20024c1f996c2cf3ce0a00addfd55842922c335bf5d76ac5ea68"},{"path":"sdk-governance.js","sha256":"9d5c7999e0a5e49820eb9f928d8391bf60e5d5fbbbeff601a063fdb11e93c1b9"},{"path":"sdk-governance.js.map","sha256":"ee430347ce9118cb11c65cde39e1101348b3cedf4473fdd9b24102a0a303e8b8"},{"path":"sdk-graph.js","sha256":"bc6f96bb0114ebac60e439eeb3beced212c0f03d0eeee13f44de69659934d65c"},{"path":"sdk-graph.js.map","sha256":"c0e972f04b85e701088177b7c84913dcd2446e0af547e3cb6c323d7d190baa12"},{"path":"sdk-merge.js","sha256":"12794dbe5920e8ca9d7aa8124322b2a90b7ee23dbcafb593094222fd69d87022"},{"path":"sdk-merge.js.map","sha256":"034cfc363ac998897ec614ca887bc288731b57e0d8e40af1299bcb466eb49d2f"},{"path":"sdk-query.js","sha256":"3eeb5eb651df3b30a97b512eb53ed37f2ece00409ddbe384efdab200f795e0f1"},{"path":"sdk-query.js.map","sha256":"52772ee7b4a20bd183d69a59518450ef025dbbe13e0cb8b56cb6826a729a36b1"},{"path":"sdk-runtime.js","sha256":"ca7820d4386a325b3510e84489086a24582d8cb58d62e45e65f7c69925b8c9ad"},{"path":"sdk-runtime.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"sdk-testing.js","sha256":"0a8c4e98c87fb996dc2fe11aa394c08bbf2ff42c45813f2775d69d27fd04bcad"},{"path":"sdk-testing.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"sdk.js","sha256":"bb8ee40b02c01e7fab2f0fae47efbb38bc88712362a507ba87cd0d1b3c471e86"},{"path":"sdk.js.map","sha256":"84a4c861d06f8f1f2205785d8e902cdde4c76d76f17f2ca906c74f9a91e5745d"}]}
+{"schema_version":1,"generation":"496e39238e4e24122c327d4044dbe04e6b54c3d10098978177c6df036c3d423a","files":[{"path":"chunks/chunk-AM2XOZKE.js","sha256":"6a04baee6eed2db485fbd863e97ca805b3a80a8730d60a79716fa550d304b11f"},{"path":"chunks/chunk-AM2XOZKE.js.map","sha256":"c43602cd3cf04ccecc1f5261ca311d9d66f8fe228f26b20a9837f63a5f5f2b09"},{"path":"chunks/chunk-APWPC4ZZ.js","sha256":"8f6cf70220ccda9397a868f99bc0e2893239ccaa92c332e95f22da70d76aac74"},{"path":"chunks/chunk-APWPC4ZZ.js.map","sha256":"6fd279b7be9c6be35b8c167ca9cf6f8347dab5eb241870f1e4f22ae9185bdd5d"},{"path":"chunks/chunk-DEZPZOQ7.js","sha256":"ef11ddab9ecc9533cac75ccc8ca41058a59382dfbe3262033fa21c7264d73b0d"},{"path":"chunks/chunk-DEZPZOQ7.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"chunks/chunk-DJDRHJBP.js","sha256":"363a6096c5fdf45749b4a131fac1ec463fe115c2c969b4d5659a8e7816bb2133"},{"path":"chunks/chunk-DJDRHJBP.js.map","sha256":"e63bec9f198bb851a996a97c587c9c9b5a38508dc69ecd96eb94e33652cdb4d3"},{"path":"chunks/chunk-DUK5DHI6.js","sha256":"493da90b1aa0e0e03a3a51f73c15a8a6b53b3720403197d5e914b66966af57fa"},{"path":"chunks/chunk-DUK5DHI6.js.map","sha256":"a5389a37cb9a81411ca6c79b3c503e0dc4c671953ad15774e05cc84e2225e9df"},{"path":"chunks/chunk-HXHFKXLV.js","sha256":"c50ced851aaaa853e5ace4b3530429a808c0dadffbdfdc53c3f53a5e55ee3c83"},{"path":"chunks/chunk-HXHFKXLV.js.map","sha256":"e973479f265ccf8e2165e740433cabf2f2d91885c998ed1e064d82d149aec0fc"},{"path":"chunks/chunk-IFPJDJUM.js","sha256":"250ac1a13d9d570b7b8365276111bc274158bb57bc556dd573520d56ac8af63c"},{"path":"chunks/chunk-IFPJDJUM.js.map","sha256":"0b6ffeaf2edbcb79c683fc085fc83af95f7579a1bdd6b2bc3e8b4f7bbaad4ad8"},{"path":"chunks/chunk-LBDWFWPK.js","sha256":"9c8947d58f561a7b2bcb80c9f716c7656d7bedf629c727cfefbc06417d95ce45"},{"path":"chunks/chunk-LBDWFWPK.js.map","sha256":"6b34a8705de6f3da0cea90f67a38f66525bb3d9c19a79f0f7d8a47290729ee05"},{"path":"chunks/chunk-N5EXRYCZ.js","sha256":"5b9f87eac0ce98afdeb153fbbde513c53419cd39fe43547905b0499934b446c0"},{"path":"chunks/chunk-N5EXRYCZ.js.map","sha256":"3ef6aaaab9d223b065b678a7eb29cc8fb1a241156372d5809b00812dd5a84afb"},{"path":"chunks/chunk-PSNS537F.js","sha256":"6c4cd7d14ea2e65d98277a914ee3e71e825dde66af040923505eb921beb0fb92"},{"path":"chunks/chunk-PSNS537F.js.map","sha256":"65e9277409540a63bbc715b04072e80d30167818e05108e5a214c03963c4b6a2"},{"path":"chunks/chunk-RL45OYTL.js","sha256":"6d4b63608a126f9f6698e456f33020f18e9d44d3c00269f464d0b525f28e52d5"},{"path":"chunks/chunk-RL45OYTL.js.map","sha256":"54285f39b52dd579a3299849c6605c80cdcac0cb588c430e125a004a97e01f39"},{"path":"chunks/chunk-SGFQQXFD.js","sha256":"27cfd4152f894bbd21c5d4f1d8ba40ea447d11983ec3b09a578d8bbc787522d7"},{"path":"chunks/chunk-SGFQQXFD.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"chunks/chunk-UBTYYZIE.js","sha256":"7b2467fd9a7130e53c9124db5c3d2a815bc32fba08513b18d74c74ccf096ae14"},{"path":"chunks/chunk-UBTYYZIE.js.map","sha256":"254e13a70ed1fd93498c0474e7087a193aa9ae51a79859480125fcde2caa0ead"},{"path":"chunks/chunk-WYZGZV2M.js","sha256":"5a9a473e53560dd4e1e7af11c038b55c111b0247b2ae40860aa9ed2846f557f9"},{"path":"chunks/chunk-WYZGZV2M.js.map","sha256":"0210004b359e9cbddb13b3c9dccdba1fd6e73247109e22dcb3f007088a6cf593"},{"path":"chunks/chunk-YH6H3UVE.js","sha256":"acdff0ac2b6737a84732e96e3423ebcd3c7f5e62232d72b3ec3f5fdefcd51a7b"},{"path":"chunks/chunk-YH6H3UVE.js.map","sha256":"6aa792909322de88c511d97945d7c4fe91bb69cf9413f57e0a706ea10e9c57d9"},{"path":"chunks/register-list-query-BJ742QOR.js","sha256":"e2561f6cc6cb63a48d3e5138ce2449bc32b0a8300c24f98336e5cf8c9cb97ad7"},{"path":"chunks/register-list-query-BJ742QOR.js.map","sha256":"e19ba32fa75b0e4f97fb2d9458527574eca136ae3b68a700ef113cbf12bd6097"},{"path":"chunks/register-mutation-GGGBRIH2.js","sha256":"b0f12129d1421a77963fe7df9b5a47e5c34a04781e3fcfb27a8447dc79797393"},{"path":"chunks/register-mutation-GGGBRIH2.js.map","sha256":"c41e6ea8770f9288cbd1b8fe79dafa35b53babd9962de6b5401d63711e86df8d"},{"path":"chunks/register-operations-E6HXYHNM.js","sha256":"82401197a106d920bd9d94cfd4be79ff138b81d31609e1e0e53d73afab255dc0"},{"path":"chunks/register-operations-E6HXYHNM.js.map","sha256":"0292106a7c257876ebe20dff857708ccaebcc4d3373923d0292416a55d2f5faa"},{"path":"chunks/register-setup-4ZVTVEPY.js","sha256":"0678edebed3bb359e8fb480ed5cfc46c60d92b9f45cb0faef3d208883dd370de"},{"path":"chunks/register-setup-4ZVTVEPY.js.map","sha256":"8d0b4b046e9171902d34fc24470baef90c50e8c9ea4a62fd2d698fb406cec70e"},{"path":"focused-chunks/chunk-3LQEBXU5.js","sha256":"819cdabdd7d38e41d79ba184d7bc0a1b9fc304165830cc4da6b05ee344724144"},{"path":"focused-chunks/chunk-3LQEBXU5.js.map","sha256":"d300be4b5554ce61f6bb5beee5c0ce89052d439c0a9dc6059f38fb21c17d7c74"},{"path":"focused-chunks/chunk-6BTUISKV.js","sha256":"6c6dd129baa9482e57a8dba8ba377ce4e195cccd6d471fdab6a152abf9998dd7"},{"path":"focused-chunks/chunk-6BTUISKV.js.map","sha256":"dff3ff9950a4f09ab39a4095eb75616c9222261021633610931bbbad00358f12"},{"path":"focused-chunks/chunk-73UNAJHD.js","sha256":"5e76667b05b31c45a278c9190fb74e187c8eb763539a05d2041e5f8165eeb21b"},{"path":"focused-chunks/chunk-73UNAJHD.js.map","sha256":"47bb4846cf438e74dd8e3d43fef86e7d7c763d98332edfe2584d0af201394df0"},{"path":"focused-chunks/chunk-DVK7VKZL.js","sha256":"4d837ecf1c2c366099f0be6939353db70d8f589b21799c80b4fc264dcf66c3cf"},{"path":"focused-chunks/chunk-DVK7VKZL.js.map","sha256":"b18ce126e128112da9d3e61c031b117dcf0c3f8740dd008785445992816e81ef"},{"path":"focused-chunks/chunk-F5J3ATMV.js","sha256":"9963d17d53629088fec74905a2f423884e61e86b2e9129dc4c0c903e5659df24"},{"path":"focused-chunks/chunk-F5J3ATMV.js.map","sha256":"181e235036170221c6164d33894ae1f0653ddb70e2693b10128c287f1c3c5c74"},{"path":"focused-chunks/chunk-IIKFTJVC.js","sha256":"69e6837a631011bc203795655945cc743da4a09b313e8c0792cf0da1a6fba9dc"},{"path":"focused-chunks/chunk-IIKFTJVC.js.map","sha256":"82fe9a9d20c6cc0613d5859e3922e6f51f1a06c448c265dacb77ec7abd3e5514"},{"path":"focused-chunks/chunk-IOTNG6CN.js","sha256":"c04aace28440d8863f8509a25f31e2933840c11a99c413ae46a84ec8b6417e81"},{"path":"focused-chunks/chunk-IOTNG6CN.js.map","sha256":"b2d445686a2845e47f2245410b55a007234d9db7328e0e4799be37606b39aa77"},{"path":"focused-chunks/chunk-KGFRQ34R.js","sha256":"e215a07b1985733548f034e9924753c33533c75527b8d6eab32c37e4875acd91"},{"path":"focused-chunks/chunk-KGFRQ34R.js.map","sha256":"5c9cd60c3b5a6589afc40d0f2d21135b9970f2da2e5fb6e80b0924f3463f87cf"},{"path":"focused-chunks/chunk-NNW5BS5L.js","sha256":"5fb330ddff4ae5a05dd170bcbed11feecb7e36df2ee19c9b7561a2c26ed59eb6"},{"path":"focused-chunks/chunk-NNW5BS5L.js.map","sha256":"d614b1676205d858c9d89bc26e452999660859dd694eef762b98b8d09ddd6ebe"},{"path":"focused-chunks/chunk-QMNAY25P.js","sha256":"8dbffcfad5faab29d82504d3f90995142c7b2a10089c9b8f10751eace97d5281"},{"path":"focused-chunks/chunk-QMNAY25P.js.map","sha256":"96bb32c44384b0fea61c6102f0b13f38fee038ef556e6c70c42030ae6ec29076"},{"path":"focused-chunks/chunk-R23T7GFZ.js","sha256":"b6e33e55ed133db21451edd43fa87a4164ff9c5f2f2576b9208ec92884f093d6"},{"path":"focused-chunks/chunk-R23T7GFZ.js.map","sha256":"fe860b039561780930e399da5013c9b8e39dd90cb73a4e2f44562dd1b769409c"},{"path":"focused-chunks/chunk-RAA7SVRA.js","sha256":"5b27423147f4bf6bcde274e98d2c0d895f68c88f851f58c6e54bfafa7c594571"},{"path":"focused-chunks/chunk-RAA7SVRA.js.map","sha256":"ca6d9df86a31c8d49516b89faf611afbf38f418ff73228761c1a1d1469c79cef"},{"path":"focused-chunks/chunk-RU6GCFN3.js","sha256":"80be09f87393150f979bfcee7df5dd39813c569c3634463bb5686a812417f44c"},{"path":"focused-chunks/chunk-RU6GCFN3.js.map","sha256":"c44cb6d89bd61c40a4d7da9fa9be421c1f5e57a278b83639c0a78ed9b97f4265"},{"path":"focused-chunks/chunk-S6ITXQ5T.js","sha256":"5ad36fac63359071fec5672e214633cdbce7ddbb14afe239c747ba717d8c8e93"},{"path":"focused-chunks/chunk-S6ITXQ5T.js.map","sha256":"cd18bb1af97a4f3d412e96581d64a1018e1f52b5bfebf5f1c40f4857356bbdd4"},{"path":"focused-chunks/chunk-SOB7X4FJ.js","sha256":"a4dd3aa3efac8b60a3912743c5e08bd698be6d460fd45749718e2cab9107537c"},{"path":"focused-chunks/chunk-SOB7X4FJ.js.map","sha256":"5921f606b225ba4190883e651ea103a63d439da84555f992cda3e9b21e230f51"},{"path":"focused-chunks/chunk-UPJA45K7.js","sha256":"2e5d7173ddb903660dd801b4d0254e6dabf6f27c14f7e119a4fb7e8cdba59ed7"},{"path":"focused-chunks/chunk-UPJA45K7.js.map","sha256":"ccab085912aed30ff35ff1df59d323576fa9dcfb6da3fc656768658b88892a67"},{"path":"focused-chunks/chunk-YLVHHWHN.js","sha256":"aed33cc3c5024b75a909cf5c01ac1d0161d9f56cc87c9c7638662f82a4d94626"},{"path":"focused-chunks/chunk-YLVHHWHN.js.map","sha256":"2536922ae21f29b6d28033a35d9aba3d921ee26867d733ba0a76857c97366cd9"},{"path":"main.js","sha256":"960f6e9b9ddc4f1076a62a44ddeb855117922ad5b024d561a97a544d4fce9562"},{"path":"main.js.map","sha256":"8686ae69d4796169e286cd64c2a9ac2de4a3d708d91200079bde2dc74287bf31"},{"path":"sdk-authoring.js","sha256":"dc19521ef9a1f738ac3ebd130958983c3d401b96076c747055341bcc7602489a"},{"path":"sdk-authoring.js.map","sha256":"250eb6359393501e749d3ae54b9d302f75e3ab6ba4f59a502842a33800f41750"},{"path":"sdk-contracts.js","sha256":"69f2646098961e81dfaabe18524857bc19fd9431a80b7a94b0cb8677de67d67b"},{"path":"sdk-contracts.js.map","sha256":"cbeb0d5ff35d8dbaf2e521a5e101e0e5f6fbfce5d58de25df8c67b56b40ec89f"},{"path":"sdk-core.js","sha256":"7b84d288c9d40fe9ba1cf3c6d8f8ca7e74b67ca21d1caf668ee0d94e3f9a939f"},{"path":"sdk-core.js.map","sha256":"b6c1eb99ca71db5f1eee0282eb0c46f18709d7161679a45a496c91464c163faf"},{"path":"sdk-governance.js","sha256":"62d98bf235bf7df5b53c51b9d0e88a256c89ef07ab61f74479a66a0e06726904"},{"path":"sdk-governance.js.map","sha256":"812e652e36552981e1f84683466d68c7fba93a58b7c615601afccf58fde920db"},{"path":"sdk-graph.js","sha256":"6b725fdd147d79d955a9bc98e4351e8c37471c494d83bda8c4d28191ac0729e3"},{"path":"sdk-graph.js.map","sha256":"05da677844e43fd80df4ea657bc3a0d960bde35860a077b2b22f117f2aee0a0a"},{"path":"sdk-merge.js","sha256":"b168d4d3da5327c8c9bede57b6fe1d8ab63ea7da0180fccd29e9e71dd025f829"},{"path":"sdk-merge.js.map","sha256":"4d5e658e23e93d53db46346aa4671c63d16a98366b38a6a8f84e38e3f730c10c"},{"path":"sdk-query.js","sha256":"ffcd200ab5139db1d235004f41bc0011c03ce9a0729ca7ad6a5222be2f076897"},{"path":"sdk-query.js.map","sha256":"52772ee7b4a20bd183d69a59518450ef025dbbe13e0cb8b56cb6826a729a36b1"},{"path":"sdk-runtime.js","sha256":"90c2615c767bab74b497f3025baf8bff2ed41666549900d609c7c40069bd1bdb"},{"path":"sdk-runtime.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"sdk-testing.js","sha256":"75f8b0ea059c53e61f723dd887a27281a5639e6f76b1ee69c5638fb77dc727fe"},{"path":"sdk-testing.js.map","sha256":"ed562b0bba7ee7214e56ac7f728054b3496bec4597c94a4eb7b4179e6f5cb1c9"},{"path":"sdk.js","sha256":"9fa1b96259dfc7d96d2f700b5829f4ebcc7a2a2dbd173eb0fac1054fdb59437a"},{"path":"sdk.js.map","sha256":"8e8853859890c1d12c13c03552d7ad19bd4ecc93f4ae6b79376d264748783506"}]}