@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/environment/project-runtime-compatibility.js

@@ -1,3 +1,3 @@
-(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]="2d40ac36-0627-5636-9679-5669dbacf06b")}catch{}})();import fs from"node:fs";import path from"node:path";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";const PACKAGE_NAME="@unbrained/pm-cli",MUTATING_COMMANDS=new Set(["append","claim","changelog","close","close-many","close-task","comments","config","copy","create","dedupe-merge","delete","deps","docs","extension","event","events","files","focus","gc","history-author-acknowledge","history-compact","history-redact","history-repair","init","install","item","learnings","meet","merge","normalize","notes","package","packages","pause-task","plan","profile","reindex","release","remind","restore","schema","start-task","test","test-all","test-runs","test-runs-worker","telemetry","templates","twin","update","update-many","upgrade","vcs","workspace"]),GLOBAL_VALUE_FLAGS=new Set(["--author","--output-budget","--output-format","--output-include","--output-limit","--output-session","--path","--pm-path"]),VERSION_PATTERN=/\b(\d{4})\.(\d{1,2})\.(\d{1,2})(?:-(\d+))?\b/u,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN="2026.8.31";function hasAnyToken(argv,tokens){return argv.some(token=>tokens.includes(token.split("=",1)[0]))}function isPackageMutation(argv,positionals){return["activate","adopt","adopt-all","deactivate","init","install","migrate","reload","uninstall"].includes(positionals[0]??"")||hasAnyToken(argv,["--activate","--adopt","--adopt-all","--deactivate","--fix-managed-state","--init","--install","--output","--reload","--scaffold","--uninstall"])}const MIXED_COMMAND_CLASSIFIERS={changelog:(argv,positionals)=>{if(positionals[0]==="generate")return!hasAnyToken(argv,["--check"]);const exportIndex=argv.indexOf("export");return positionals[0]==="export"&&(hasAnyToken(argv,["--output"])||exportIndex>=0&&argv[exportIndex+1]!==void 0&&!argv[exportIndex+1].startsWith("-"))},comments:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),config:(_argv,positionals)=>(positionals[0]==="project"||positionals[0]==="global"?positionals[1]:positionals[0])==="set",deps:()=>!1,docs:argv=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"]),duplicates:()=>!1,events:()=>!1,extension:isPackageMutation,files:(argv,positionals)=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"])||positionals[0]==="discover"&&hasAnyToken(argv,["--apply"]),health:argv=>!hasAnyToken(argv,["--check-only","--no-refresh","--skip-vectors"]),learnings:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),merge:(_argv,positionals)=>positionals[0]!=="report",notes:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),package:isPackageMutation,packages:isPackageMutation,profile:(_argv,positionals)=>positionals[0]==="apply",schema:(argv,positionals)=>["add-field","add-status","add-type","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type"].includes(positionals[0]??"")&&!(hasAnyToken(argv,["--infer"])&&!hasAnyToken(argv,["--apply"])),telemetry:(_argv,positionals)=>positionals.slice(0,2).some(token=>["clear","flush"].includes(token)),templates:(_argv,positionals)=>positionals[0]==="save",test:argv=>hasAnyToken(argv,["--add","--add-json","--background","--measure","--remove","--resume","--run","--stop"]),validate:argv=>hasAnyToken(argv,["--auto-fix","--prune-missing"]),vcs:(_argv,positionals)=>["abandon","create","merge","propose","ref-create"].includes(positionals[0]??""),workspace:(_argv,positionals)=>positionals[0]==="snapshot"&&["create","delete","restore"].includes(positionals[1]??"")};function parseDateVersion(value){const match=value.match(VERSION_PATTERN);return match?[Number(match[1]),Number(match[2]),Number(match[3]),Number(match[4]??0)]:null}function comparePmDateVersions(left,right){const leftParts=parseDateVersion(left),rightParts=parseDateVersion(right);if(!leftParts||!rightParts)return null;for(let index=0;index<leftParts.length;index+=1){const delta=leftParts[index]-rightParts[index];if(delta!==0)return Math.sign(delta)}return 0}function historyItemHashVersionForRuntime(version){return comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1?3:2}function findIncompatibleHistoryEpochPin(pins,writerItemHashVersion){if(writerItemHashVersion===3)return pins.filter(pin=>pin.history_epoch_compatible===!1).map(pin=>({...pin,declaration:pin.declaration??pin.version})).sort((left,right)=>comparePmDateVersions(left.version,right.version))[0]}function readJsonRecord(filePath){try{const parsed=JSON.parse(fs.readFileSync(filePath,"utf8"));return typeof parsed=="object"&&parsed!==null&&!Array.isArray(parsed)?parsed:null}catch{return null}}function rangeUpperBounds(alternative){const comparators=[...alternative.matchAll(/(<=|<)\s*v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/gu)].map(match=>({inclusive:match[1]==="<=",version:match[2]})),hyphen=alternative.match(/\b\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?\s+-\s+v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/u);return hyphen?[...comparators,{inclusive:!0,version:hyphen[1]}]:comparators}function analyzeHistoryEpochRange(specification){const alternativeBounds=specification.split("||").map(alternative=>rangeUpperBounds(alternative));return{bounded:alternativeBounds.some(bounds=>bounds.length>0),compatible:alternativeBounds.some(bounds=>bounds.every(bound=>{const comparison=comparePmDateVersions(HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,bound.version);return comparison!==null&&(bound.inclusive?comparison!==1:comparison===-1)}))}}function dependencyPins(packageJson){return["dependencies","devDependencies","optionalDependencies","peerDependencies"].flatMap(field=>{const dependencies=packageJson[field];if(typeof dependencies!="object"||dependencies===null)return[];const value=dependencies[PACKAGE_NAME],specification=typeof value=="string"?value.trim():"",version=/^[<!]/u.test(specification)?void 0:specification.match(VERSION_PATTERN)?.[0];if(!version)return[];const exact=/^(?:=|v)?\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?$/u.test(specification),range=analyzeHistoryEpochRange(specification);return[{version,constraint:exact?"exact":range.bounded?"range":"minimum",...exact?{}:{declaration:specification},history_epoch_compatible:exact?comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1:range.compatible}]})}function packageLockPin(projectRoot){const packages=readJsonRecord(path.join(projectRoot,"package-lock.json"))?.packages;if(typeof packages!="object"||packages===null)return;const installed=packages["node_modules/@unbrained/pm-cli"];if(typeof installed!="object"||installed===null)return;const version=installed.version;return typeof version=="string"?version:void 0}function textLockPin(projectRoot,file){try{const lines=fs.readFileSync(path.join(projectRoot,file),"utf8").split(/\r?\n/u),packageLineIndex=lines.findIndex(line=>line.includes(PACKAGE_NAME));if(packageLineIndex<0)return;const packageIndent=lines[packageLineIndex].match(/^\s*/u)[0].length,entry=[lines[packageLineIndex]];for(let index=packageLineIndex+1;index<lines.length;index+=1){const line=lines[index],trimmed=line.trim(),indent=line.match(/^\s*/u)[0].length;if(trimmed.length>0&&indent<=packageIndent)break;entry.push(line)}return entry.join(`
-`).match(/^\s*version(?::\s*|\s+)["']?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/mu)?.[1]??entry[0].match(VERSION_PATTERN)?.[0]}catch{return}}function discoverProjectRuntimeVersionPins(projectRoot){const pins=[],projectPackage=readJsonRecord(path.join(projectRoot,"package.json"));projectPackage&&pins.push(...dependencyPins(projectPackage).map(pin=>({...pin,source:"package.json"})));const installedVersion=readJsonRecord(path.join(projectRoot,"node_modules","@unbrained","pm-cli","package.json"))?.version;typeof installedVersion=="string"&&parseDateVersion(installedVersion)&&pins.push({version:installedVersion,source:"installed-package",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(installedVersion)===3});const packageLockVersion=packageLockPin(projectRoot);packageLockVersion&&parseDateVersion(packageLockVersion)&&pins.push({version:packageLockVersion,source:"package-lock.json",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(packageLockVersion)===3});for(const file of["pnpm-lock.yaml","yarn.lock"]){const version=textLockPin(projectRoot,file);version&&pins.push({version,source:file,constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(version)===3})}return pins}function commandTokenFromArgv(argv){for(let index=0;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}if(!token.startsWith("-"))return{command:token.toLowerCase(),index}}}function isProjectMutatingInvocation(argv){const commandToken=commandTokenFromArgv(argv);if(!commandToken||hasAnyToken(argv,["--help","-h","--dry-run"]))return!1;const{command,index:commandIndex}=commandToken,positionals=[];for(let index=commandIndex+1;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}token.startsWith("-")||positionals.push(token.toLowerCase())}const mixedClassifier=MIXED_COMMAND_CLASSIFIERS[command];return mixedClassifier?mixedClassifier(argv,positionals):MUTATING_COMMANDS.has(command)}function inspectProjectRuntimeCompatibility(options){const command=commandTokenFromArgv(options.argv)?.command,mutating=isProjectMutatingInvocation(options.argv),pins=discoverProjectRuntimeVersionPins(options.projectRoot).filter(pin=>comparePmDateVersions(pin.version,options.executingVersion)!==null).sort((left,right)=>comparePmDateVersions(right.version,left.version)),newest=pins[0],stale=newest!==void 0&&comparePmDateVersions(options.executingVersion,newest.version)===-1,writerItemHashVersion=historyItemHashVersionForRuntime(options.executingVersion),incompatibleEpochPin=findIncompatibleHistoryEpochPin(pins,writerItemHashVersion),historyEpochIncompatible=mutating&&incompatibleEpochPin!==void 0,warning=stale&&!mutating?{code:"project_runtime_stale_read",executing_version:options.executingVersion,project_version:newest.version,source:newest.source,message:"This read is using an older pm runtime than the project requires.",next_steps:[`Run the command through the project's installed ${PACKAGE_NAME} ${newest.version}.`,"Install the project dependencies with its declared package manager if the local executable is missing."]}:void 0;return{compatible:!mutating||!stale&&!historyEpochIncompatible||options.allowStale===!0,executing_version:options.executingVersion,...newest?{project_version:newest.version,source:newest.source}:{},...command?{command}:{},mutating,stale,history_epoch_incompatible:historyEpochIncompatible,writer_item_hash_version:writerItemHashVersion,...incompatibleEpochPin?{incompatible_project_version:incompatibleEpochPin.declaration,incompatible_source:incompatibleEpochPin.source}:{},...warning?{warning}:{},override_applied:mutating&&(stale||historyEpochIncompatible)&&options.allowStale===!0}}function assertProjectRuntimeCompatibility(options){const result=inspectProjectRuntimeCompatibility(options);if(result.compatible)return result;throw result.history_epoch_incompatible?new PmCliError(`pm ${result.executing_version} cannot write item-hash epoch ${result.writer_item_hash_version} into a project pinned to pm ${result.incompatible_project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_history_epoch_incompatible",reason:result.incompatible_source,why:`The pinned runtime cannot read item_hash_version ${result.writer_item_hash_version}; allowing the write would break its health and validation gates.`,nextSteps:[`Upgrade the project's ${PACKAGE_NAME} pin to ${HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN} or newer before mutating tracker history.`,"For an intentional coordinated migration only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]}):new PmCliError(`pm ${result.executing_version} cannot mutate a project pinned to newer pm ${result.project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_stale_mutation",reason:result.source,why:"An older runtime can write storage, history, and merge contracts it does not understand.",nextSteps:[`Run this command through the project's installed ${PACKAGE_NAME} ${result.project_version}.`,"For an intentional recovery only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]})}export{HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,PmCliError,assertProjectRuntimeCompatibility,comparePmDateVersions,discoverProjectRuntimeVersionPins,historyItemHashVersionForRuntime,inspectProjectRuntimeCompatibility,isProjectMutatingInvocation};
+(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]="19d9b802-1efa-5716-8176-ecbf5b153ff0")}catch{}})();import fs from"node:fs";import path from"node:path";import{createRequire}from"node:module";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";const PACKAGE_NAME="@unbrained/pm-cli",MUTATING_COMMANDS=new Set(["append","claim","changelog","close","close-many","close-task","comments","config","copy","create","dedupe-merge","delete","deps","docs","extension","event","events","files","focus","gc","history-author-acknowledge","history-compact","history-redact","history-repair","init","install","item","learnings","meet","merge","normalize","notes","package","packages","pause-task","plan","profile","reindex","release","remind","restore","schema","start-task","test","test-all","test-runs","test-runs-worker","telemetry","templates","twin","update","update-many","upgrade","vcs","workspace"]),GLOBAL_VALUE_FLAGS=new Set(["--author","--output-budget","--output-format","--output-include","--output-limit","--output-session","--path","--pm-path"]),VERSION_PATTERN=/\b(\d{4})\.(\d{1,2})\.(\d{1,2})(?:-(\d+))?\b/u,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN="2026.8.31";function hasAnyToken(argv,tokens){return argv.some(token=>tokens.includes(token.split("=",1)[0]))}function isPackageMutation(argv,positionals){return["activate","adopt","adopt-all","deactivate","init","install","migrate","reload","uninstall"].includes(positionals[0]??"")||hasAnyToken(argv,["--activate","--adopt","--adopt-all","--deactivate","--fix-managed-state","--init","--install","--output","--reload","--scaffold","--uninstall"])}const MIXED_COMMAND_CLASSIFIERS={changelog:(argv,positionals)=>{if(positionals[0]==="generate")return!hasAnyToken(argv,["--check"]);const exportIndex=argv.indexOf("export");return positionals[0]==="export"&&(hasAnyToken(argv,["--output"])||exportIndex>=0&&argv[exportIndex+1]!==void 0&&!argv[exportIndex+1].startsWith("-"))},comments:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),config:(_argv,positionals)=>(positionals[0]==="project"||positionals[0]==="global"?positionals[1]:positionals[0])==="set",deps:()=>!1,docs:argv=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"]),duplicates:()=>!1,events:()=>!1,extension:isPackageMutation,files:(argv,positionals)=>hasAnyToken(argv,["--add","--add-glob","--migrate","--remove"])||positionals[0]==="discover"&&hasAnyToken(argv,["--apply"]),health:argv=>!hasAnyToken(argv,["--check-only","--no-refresh","--skip-vectors"]),learnings:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),merge:(_argv,positionals)=>positionals[0]!=="report",notes:argv=>hasAnyToken(argv,["--add","--delete","--edit","--file","--stdin"]),package:isPackageMutation,packages:isPackageMutation,profile:(_argv,positionals)=>positionals[0]==="apply",schema:(argv,positionals)=>["add-field","add-status","add-type","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type"].includes(positionals[0]??"")&&!(hasAnyToken(argv,["--infer"])&&!hasAnyToken(argv,["--apply"])),telemetry:(_argv,positionals)=>positionals.slice(0,2).some(token=>["clear","flush"].includes(token)),templates:(_argv,positionals)=>positionals[0]==="save",test:argv=>hasAnyToken(argv,["--update","--update-index","--add","--add-json","--background","--measure","--remove","--resume","--run","--stop"]),validate:argv=>hasAnyToken(argv,["--auto-fix","--prune-missing"]),vcs:(_argv,positionals)=>["abandon","create","merge","propose","ref-create"].includes(positionals[0]??""),workspace:(_argv,positionals)=>positionals[0]==="snapshot"&&["create","delete","restore"].includes(positionals[1]??"")};function parseDateVersion(value){const match=value.match(VERSION_PATTERN);return match?[Number(match[1]),Number(match[2]),Number(match[3]),Number(match[4]??0)]:null}function comparePmDateVersions(left,right){const leftParts=parseDateVersion(left),rightParts=parseDateVersion(right);if(!leftParts||!rightParts)return null;for(let index=0;index<leftParts.length;index+=1){const delta=leftParts[index]-rightParts[index];if(delta!==0)return Math.sign(delta)}return 0}function historyItemHashVersionForRuntime(version){return comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1?3:2}function findIncompatibleHistoryEpochPin(pins,writerItemHashVersion){if(writerItemHashVersion===3)return pins.filter(pin=>pin.history_epoch_compatible===!1).map(pin=>({...pin,declaration:pin.declaration??pin.version})).sort((left,right)=>comparePmDateVersions(left.version,right.version))[0]}function readJsonRecord(filePath){try{const parsed=JSON.parse(fs.readFileSync(filePath,"utf8"));return typeof parsed=="object"&&parsed!==null&&!Array.isArray(parsed)?parsed:null}catch{return null}}function rangeUpperBounds(alternative){const comparators=[...alternative.matchAll(/(<=|<)\s*v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/gu)].map(match=>({inclusive:match[1]==="<=",version:match[2]})),hyphen=alternative.match(/\b\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?\s+-\s+v?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/u);return hyphen?[...comparators,{inclusive:!0,version:hyphen[1]}]:comparators}function analyzeHistoryEpochRange(specification){const alternativeBounds=specification.split("||").map(alternative=>rangeUpperBounds(alternative));return{bounded:alternativeBounds.some(bounds=>bounds.length>0),compatible:alternativeBounds.some(bounds=>bounds.every(bound=>{const comparison=comparePmDateVersions(HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,bound.version);return comparison!==null&&(bound.inclusive?comparison!==1:comparison===-1)}))}}function dependencyDeclarations(packageJson){return["dependencies","devDependencies","optionalDependencies","peerDependencies"].flatMap(field=>{const dependencies=packageJson[field];if(typeof dependencies!="object"||dependencies===null)return[];const value=dependencies[PACKAGE_NAME];return typeof value=="string"?[value.trim()]:[]})}function dependencyPins(packageJson){return dependencyDeclarations(packageJson).flatMap(specification=>{const version=/^[<!]/u.test(specification)?void 0:specification.match(VERSION_PATTERN)?.[0];if(!version)return[];const exact=/^(?:=|v)?\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?$/u.test(specification),range=analyzeHistoryEpochRange(specification);return[{version,constraint:exact?"exact":range.bounded?"range":"minimum",...exact?{}:{declaration:specification},history_epoch_compatible:exact?comparePmDateVersions(version,HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN)!==-1:range.compatible}]})}function packageLockPin(projectRoot){const packages=readJsonRecord(path.join(projectRoot,"package-lock.json"))?.packages;if(typeof packages!="object"||packages===null)return;const installed=packages["node_modules/@unbrained/pm-cli"];if(typeof installed!="object"||installed===null)return;const version=installed.version;return typeof version=="string"?version:void 0}function textLockPin(projectRoot,file){try{const lines=fs.readFileSync(path.join(projectRoot,file),"utf8").split(/\r?\n/u),packageLineIndex=lines.findIndex(line=>line.includes(PACKAGE_NAME));if(packageLineIndex<0)return;const packageIndent=lines[packageLineIndex].match(/^\s*/u)[0].length,entry=[lines[packageLineIndex]];for(let index=packageLineIndex+1;index<lines.length;index+=1){const line=lines[index],trimmed=line.trim(),indent=line.match(/^\s*/u)[0].length;if(trimmed.length>0&&indent<=packageIndent)break;entry.push(line)}return entry.join(`
+`).match(/^\s*version(?::\s*|\s+)["']?(\d{4}\.\d{1,2}\.\d{1,2}(?:-\d+)?)/mu)?.[1]??entry[0].match(VERSION_PATTERN)?.[0]}catch{return}}function discoverProjectRuntimeVersionPins(projectRoot){const pins=[],projectPackage=readJsonRecord(path.join(projectRoot,"package.json"));projectPackage&&pins.push(...dependencyPins(projectPackage).map(pin=>({...pin,source:"package.json"})));const installedVersion=readJsonRecord(path.join(projectRoot,"node_modules","@unbrained","pm-cli","package.json"))?.version;typeof installedVersion=="string"&&parseDateVersion(installedVersion)&&pins.push({version:installedVersion,source:"installed-package",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(installedVersion)===3});const packageLockVersion=packageLockPin(projectRoot);packageLockVersion&&parseDateVersion(packageLockVersion)&&pins.push({version:packageLockVersion,source:"package-lock.json",constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(packageLockVersion)===3});for(const file of["pnpm-lock.yaml","yarn.lock"]){const version=textLockPin(projectRoot,file);version&&pins.push({version,source:file,constraint:"exact",history_epoch_compatible:historyItemHashVersionForRuntime(version)===3})}return pins}function assertProjectRuntimeFormatGuard(projectRoot,formatVersion){if(formatVersion<=1)return;const{minVersion,lt}=createRequire(import.meta.url)("semver"),declaration=dependencyDeclarations(readJsonRecord(path.join(projectRoot,"package.json"))??{}).find(specification=>{try{const minimum=minVersion(specification);return minimum!==null&&lt(minimum,"2026.10.10")}catch{return!1}}),incompatible=declaration===void 0?discoverProjectRuntimeVersionPins(projectRoot).find(pin=>comparePmDateVersions(pin.version,"2026.10.10")===-1):{version:declaration,source:"package.json"};if(incompatible)throw new PmCliError(`The project selects pm ${incompatible.version}, which cannot safely refuse item format ${formatVersion}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_item_format_incompatible",reason:incompatible.source,required:"Upgrade project pins, installed SDKs, CI hosts and Git merge drivers before writing guarded item formats.",nextSteps:["Use a pm runtime supporting the required item format throughout the project; preserve original item and history bytes, and never re-anchor history to satisfy an older host."]})}function commandTokenFromArgv(argv){for(let index=0;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}if(!token.startsWith("-"))return{command:token.toLowerCase(),index}}}function isProjectMutatingInvocation(argv){const commandToken=commandTokenFromArgv(argv);if(!commandToken||hasAnyToken(argv,["--help","-h","--dry-run"]))return!1;const{command,index:commandIndex}=commandToken,positionals=[];for(let index=commandIndex+1;index<argv.length;index+=1){const token=argv[index];if(GLOBAL_VALUE_FLAGS.has(token)){index+=1;continue}token.startsWith("-")||positionals.push(token.toLowerCase())}const mixedClassifier=MIXED_COMMAND_CLASSIFIERS[command];return mixedClassifier?mixedClassifier(argv,positionals):MUTATING_COMMANDS.has(command)}function inspectProjectRuntimeCompatibility(options){const command=commandTokenFromArgv(options.argv)?.command,mutating=isProjectMutatingInvocation(options.argv),pins=discoverProjectRuntimeVersionPins(options.projectRoot).filter(pin=>comparePmDateVersions(pin.version,options.executingVersion)!==null).sort((left,right)=>comparePmDateVersions(right.version,left.version)),newest=pins[0],stale=newest!==void 0&&comparePmDateVersions(options.executingVersion,newest.version)===-1,writerItemHashVersion=historyItemHashVersionForRuntime(options.executingVersion),incompatibleEpochPin=findIncompatibleHistoryEpochPin(pins,writerItemHashVersion),historyEpochIncompatible=mutating&&incompatibleEpochPin!==void 0,warning=stale&&!mutating?{code:"project_runtime_stale_read",executing_version:options.executingVersion,project_version:newest.version,source:newest.source,message:"This read is using an older pm runtime than the project requires.",next_steps:[`Run the command through the project's installed ${PACKAGE_NAME} ${newest.version}.`,"Install the project dependencies with its declared package manager if the local executable is missing."]}:void 0;return{compatible:!mutating||!stale&&!historyEpochIncompatible||options.allowStale===!0,executing_version:options.executingVersion,...newest?{project_version:newest.version,source:newest.source}:{},...command?{command}:{},mutating,stale,history_epoch_incompatible:historyEpochIncompatible,writer_item_hash_version:writerItemHashVersion,...incompatibleEpochPin?{incompatible_project_version:incompatibleEpochPin.declaration,incompatible_source:incompatibleEpochPin.source}:{},...warning?{warning}:{},override_applied:mutating&&(stale||historyEpochIncompatible)&&options.allowStale===!0}}function assertProjectRuntimeCompatibility(options){const result=inspectProjectRuntimeCompatibility(options);if(result.compatible)return result;throw result.history_epoch_incompatible?new PmCliError(`pm ${result.executing_version} cannot write item-hash epoch ${result.writer_item_hash_version} into a project pinned to pm ${result.incompatible_project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_history_epoch_incompatible",reason:result.incompatible_source,why:`The pinned runtime cannot read item_hash_version ${result.writer_item_hash_version}; allowing the write would break its health and validation gates.`,nextSteps:[`Upgrade the project's ${PACKAGE_NAME} pin to ${HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN} or newer before mutating tracker history.`,"For an intentional coordinated migration only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]}):new PmCliError(`pm ${result.executing_version} cannot mutate a project pinned to newer pm ${result.project_version}.`,EXIT_CODE.CONFLICT,{code:"project_runtime_stale_mutation",reason:result.source,why:"An older runtime can write storage, history, and merge contracts it does not understand.",nextSteps:[`Run this command through the project's installed ${PACKAGE_NAME} ${result.project_version}.`,"For an intentional recovery only, set PM_ALLOW_STALE_CLI=1 for this invocation and record why.","Read-only commands remain available without an override."]})}export{HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN,PmCliError,assertProjectRuntimeCompatibility,assertProjectRuntimeFormatGuard,comparePmDateVersions,discoverProjectRuntimeVersionPins,historyItemHashVersionForRuntime,inspectProjectRuntimeCompatibility,isProjectMutatingInvocation};
 //# sourceMappingURL=project-runtime-compatibility.js.map

package/dist/sdk/environment/source-context.d.ts

@@ -13,11 +13,11 @@ export type SourceContextAccessMode = "read_only" | "write";
 /** Structured policy used by SDK adapters before selecting source coordinates. */
 export interface SourceContextWritePolicy {
 /** Declared access mode, with absent legacy context retaining write behavior. */
-access: SourceContextAccessMode;
+access:SourceContextAccessMode;
 /** Whether the one-invocation write override was accepted. */
-write_override_applied: boolean;
+write_override_applied:boolean;
 /** Whether a mutation may select inherited source coordinates. */
-source_writes_allowed: boolean;
+source_writes_allowed:boolean;
 }
 /** Resolve inherited source-coordinate write policy without reading filesystem state. */
-export declare function resolveSourceContextWritePolicy(environment: Readonly<Record<string, string | undefined>>): SourceContextWritePolicy;
+export declare function resolveSourceContextWritePolicy(environment:Readonly<Record<string,string | undefined>>):SourceContextWritePolicy;

package/dist/sdk/environment/tracker-preflight.d.ts

@@ -3,4 +3,4 @@
  *
  * Exposes tracker initialization and filesystem preflight primitives to SDK consumers.
  */
-export { assertInitializedTracker, assertReadableTrackerRoot, buildTrackerInitializationRecovery, } from "../../core/store/tracker-preflight.js";
+export { assertInitializedTracker,assertReadableTrackerRoot,buildTrackerInitializationRecovery,} from "../../core/store/tracker-preflight.js";

package/dist/sdk/error-code-catalog.d.ts

@@ -11,59 +11,59 @@ export type PmErrorCodeClass = "generic_failure" | "usage" | "not_found" | "conf
 /** One externally observable refusal state and its executable entrypoint probe. */
 export interface PmRefusalStateContract {
 /** Stable semantic state owned by the error code. */
-state: string;
+state:string;
 /** Stable probe identifier implemented by the entrypoint conformance suite. */
-probe_id: string;
+probe_id:string;
 /** Public command roots through which the state must remain reachable. */
-entrypoints: string[];
+entrypoints:string[];
 /** Exit class expected when the probe reaches the state. */
-expected_exit_class: PmErrorCodeClass;
+expected_exit_class:PmErrorCodeClass;
 }
 /** Stable shell exit-code taxonomy shared by every structured error. */
-export declare const PM_ERROR_CODE_EXIT_CLASS_CONTRACTS: readonly [{
-readonly exit_code: 1;
-readonly class: "generic_failure";
-}, {
-readonly exit_code: 2;
-readonly class: "usage";
-}, {
-readonly exit_code: 3;
-readonly class: "not_found";
-}, {
-readonly exit_code: 4;
-readonly class: "conflict";
-}, {
-readonly exit_code: 5;
-readonly class: "dependency_failed";
+export declare const PM_ERROR_CODE_EXIT_CLASS_CONTRACTS:readonly [{
+readonly exit_code:1;
+readonly class:"generic_failure";
+},{
+readonly exit_code:2;
+readonly class:"usage";
+},{
+readonly exit_code:3;
+readonly class:"not_found";
+},{
+readonly exit_code:4;
+readonly class:"conflict";
+},{
+readonly exit_code:5;
+readonly class:"dependency_failed";
 }];
 /** One machine-readable error and its portable recovery contract. */
 export interface PmErrorCodeContract {
 /** Stable snake_case identifier. */
-code: string;
+code:string;
 /** Concise description of the failed condition. */
-meaning: string;
+meaning:string;
 /** Compatibility tier for package consumers. */
-stability: PmErrorCodeStability;
+stability:PmErrorCodeStability;
 /** Process exit code emitted by the CLI transport. */
-exit_code: 1 | 2 | 3 | 4 | 5;
+exit_code:1 | 2 | 3 | 4 | 5;
 /** Semantic class represented by the process exit code. */
-class: PmErrorCodeClass;
+class:PmErrorCodeClass;
 /** Actionable caller recovery guidance. */
-recovery: string;
+recovery:string;
 /** Subsystems that can emit the code. */
-sources: string[];
+sources:string[];
 /** CLI command roots inferred from executable declaration ownership. */
-emitting_commands: string[];
+emitting_commands:string[];
 /** Canonical machine identifier for this compatibility group. */
-canonical_code?: string;
+canonical_code?:string;
 /** Stable compatibility spellings that resolve to this canonical code. */
-aliases?: string[];
+aliases?:string[];
 /** Observable states this code claims, each backed by a real-entrypoint probe. */
-owned_states?: PmRefusalStateContract[];
+owned_states?:PmRefusalStateContract[];
 }
 /** Validate, normalize, sort, and freeze an error-code catalog. */
-export declare function definePmErrorCodeCatalog(declarations: readonly PmErrorCodeContract[]): readonly PmErrorCodeContract[];
+export declare function definePmErrorCodeCatalog(declarations:readonly PmErrorCodeContract[]):readonly PmErrorCodeContract[];
 /** Resolve an emitted code through its stable compatibility alias group. */
-export declare function resolveCanonicalPmErrorCodeContract(code: string, catalog: readonly PmErrorCodeContract[]): PmErrorCodeContract;
+export declare function resolveCanonicalPmErrorCodeContract(code:string,catalog:readonly PmErrorCodeContract[]):PmErrorCodeContract;
 /** Resolve one declared error contract and fail closed for unknown vocabulary. */
-export declare function resolvePmErrorCodeContract(code: string, catalog: readonly PmErrorCodeContract[]): PmErrorCodeContract;
+export declare function resolvePmErrorCodeContract(code:string,catalog:readonly PmErrorCodeContract[]):PmErrorCodeContract;

package/dist/sdk/error-runtime.d.ts

@@ -1,10 +1,10 @@
 /** Returns a stable message for errors and unknown thrown values. */
-export declare function describeUnknownError(error: unknown): string;
+export declare function describeUnknownError(error:unknown):string;
 /** Reads a finite numeric exit code from an arbitrary thrown value. */
-export declare function readThrownExitCode(error: unknown): number | undefined;
+export declare function readThrownExitCode(error:unknown):number | undefined;
 /** Normalizes thrown exit codes to a positive integer failure status. */
-export declare function normalizeThrownExitCode(exitCode: number): number;
+export declare function normalizeThrownExitCode(exitCode:number):number;
 /** Identifies errors emitted by Commander without importing its private classes. */
-export declare function isCommanderError(error: unknown): boolean;
+export declare function isCommanderError(error:unknown):boolean;
 /** Converts non-Error thrown values into errors suitable for Sentry capture. */
-export declare function wrapThrownErrorForSentry(error: unknown, message: string): Error;
+export declare function wrapThrownErrorForSentry(error:unknown,message:string):Error;

package/dist/sdk/errors.d.ts

@@ -21,30 +21,30 @@ export declare const PM_CLI_EXPECTED_ERROR_NAME = "PmCliError";
  */
 export interface PmCliExpectedError extends Error {
 /** Discriminant tag; always {@link PM_CLI_EXPECTED_ERROR_NAME}. */
-name: typeof PM_CLI_EXPECTED_ERROR_NAME;
+name:typeof PM_CLI_EXPECTED_ERROR_NAME;
 /** Positive process exit code the CLI should terminate with for this failure. */
-exitCode: number;
+exitCode:number;
 /** Stable producer-owned error code, mirrored from context when available. */
-code?: string;
+code?:string;
 /** Structured, secret-free metadata attached for diagnostics and error guidance. */
-context: PmCliErrorContext;
+context:PmCliErrorContext;
 /** Optional underlying error that triggered this one, preserved for cause chaining. */
-cause?: unknown;
+cause?:unknown;
 }
 /** A refused create operation whose canonical ID already names a persisted item. */
 export interface PmItemAlreadyExistsError extends PmCliExpectedError {
 /** Stable discriminator independent of the diagnostic message. */
-code: "item_already_exists";
+code:"item_already_exists";
 /** Creation conflicts preserve the existing conflict exit-code contract. */
-exitCode: typeof EXIT_CODE.CONFLICT;
+exitCode:typeof EXIT_CODE.CONFLICT;
 /** Canonical identity and actual persisted path for a safe subsequent read. */
-context: PmCliErrorContext & {
+context:PmCliErrorContext & {
 /** Producer-owned existing-item discriminator. */
-code: "item_already_exists";
+code:"item_already_exists";
 /** Normalized ID of the preserved existing item. */
-id: string;
+id:string;
 /** Actual document path of the preserved existing item. */
-path: string;
+path:string;
 };
 }
 /**
@@ -52,7 +52,7 @@ path: string;
  * Requires the producer code, conflict exit code and usable existing-item
  * coordinates; ownership conflicts and message lookalikes do not qualify.
  */
-export declare function isItemAlreadyExistsError(error: unknown): error is PmItemAlreadyExistsError;
+export declare function isItemAlreadyExistsError(error:unknown):error is PmItemAlreadyExistsError;
 /**
  * Options accepted by {@link createPmCliExpectedError}. Every field is optional;
  * omitted values default to the CLI usage exit code, an empty context, and no
@@ -60,11 +60,11 @@ export declare function isItemAlreadyExistsError(error: unknown): error is PmIte
  */
 export interface CreatePmCliExpectedErrorOptions {
 /** Positive exit code to assign; defaults to the usage-error code. Non-finite or non-positive values throw. */
-exitCode?: number;
+exitCode?:number;
 /** Structured, secret-free diagnostic metadata to attach to the error. */
-context?: PmCliErrorContext;
+context?:PmCliErrorContext;
 /** Underlying error to retain as a non-enumerable `cause` when provided. */
-cause?: unknown;
+cause?:unknown;
 }
 /**
  * Create a package-safe expected CLI error.
@@ -73,6 +73,6 @@ cause?: unknown;
  * shared class identity, so package authors can throw this from bundled,
  * linked, or separately installed extension code.
  */
-export declare function createPmCliExpectedError(message: string, options?: CreatePmCliExpectedErrorOptions): PmCliExpectedError;
+export declare function createPmCliExpectedError(message:string,options?:CreatePmCliExpectedErrorOptions):PmCliExpectedError;
 /** Implements check whether pm cli expected error for the public runtime surface of this module. */
-export declare function isPmCliExpectedError(error: unknown): error is PmCliExpectedError;
+export declare function isPmCliExpectedError(error:unknown):error is PmCliExpectedError;

package/dist/sdk/eval.d.ts

@@ -1,61 +1,61 @@
 import { type EvalSearchMode } from "../core/search/eval.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
-export { EVAL_QUERY_SET_CONTRACT, EVAL_QUERY_SET_EXAMPLE, EVAL_QUERY_SET_SCHEMA_ID, parseEvalQuerySet, } from "../core/search/eval.js";
+export { EVAL_QUERY_SET_CONTRACT,EVAL_QUERY_SET_EXAMPLE,EVAL_QUERY_SET_SCHEMA_ID,parseEvalQuerySet,} from "../core/search/eval.js";
 /** Relative location (under the pm root) of the default golden-query set. A git-tracked, human-curated file so relevance ground truth lives alongside the tracker it evaluates. */
-export declare const DEFAULT_EVAL_QUERIES_RELATIVE_PATH: string;
+export declare const DEFAULT_EVAL_QUERIES_RELATIVE_PATH:string;
 /** Evaluation inputs shared by SDK hosts and the CLI adapter. */
 export interface EvalOptions {
 /** Default retrieval mode for queries that do not set their own (keyword|semantic|hybrid). */
-mode?: string;
+mode?:string;
 /** Metric cutoff (`@k`); positive integer, defaults to {@link DEFAULT_EVAL_K}. */
-k?: string | number;
+k?:string | number;
 /** Gate threshold: exit non-zero when the aggregate nDCG@k falls below this `[0,1]` value. */
-failUnder?: string | number;
+failUnder?:string | number;
 /** Override path to the golden-query JSON file (defaults to `<pmRoot>/search/eval-queries.json`). */
-queries?: string;
+queries?:string;
 /** Output format override: json|toon. */
-format?: string;
+format?:string;
 }
 /** Per-query relevance report row emitted by {@link runEval}. */
 export interface EvalQueryReport {
 /** Original golden-query text used for retrieval. */
-query: string;
+query:string;
 /** Resolved retrieval mode after applying query and run defaults. */
-mode: EvalSearchMode;
+mode:EvalSearchMode;
 /** Number of unique items judged relevant to this query. */
-relevant_total: number;
+relevant_total:number;
 /** Relevant items found within the ranking cutoff. */
-retrieved_relevant: number;
+retrieved_relevant:number;
 /** Normalized discounted cumulative gain at the selected cutoff. */
-ndcg: number;
+ndcg:number;
 /** Reciprocal rank of the first relevant result, or zero when absent. */
-mrr: number;
+mrr:number;
 /** Fraction of positions at the selected cutoff containing relevant items. */
-precision: number;
+precision:number;
 /** Fraction of judged relevant items retrieved at the selected cutoff. */
-recall: number;
+recall:number;
 /** Failed per-query floors, compared against unrounded scores. */
-violations?: string[];
+violations?:string[];
 }
 /** Rounded ranking evidence and the verdict computed from unrounded metrics. */
 export interface EvalResult {
 /** Maximum ranking positions scored for each query. */
-k: number;
+k:number;
 /** Number of query entries represented by this result. */
-query_count: number;
+query_count:number;
 /** Equal-weight macro averages across all evaluated queries. */
-aggregate: {
-ndcg: number;
-mrr: number;
-precision: number;
-recall: number;
+aggregate:{
+ndcg:number;
+mrr:number;
+precision:number;
+recall:number;
 };
 /** Individual query scores and any failed declared floors. */
-queries: EvalQueryReport[];
+queries:EvalQueryReport[];
 /** Present only when `--fail-under` was supplied. */
-fail_under?: number;
+fail_under?:number;
 /** Whether every declared per-query floor and optional aggregate nDCG threshold passed. */
-passed: boolean;
+passed:boolean;
 }
 /**
  * Run the search-relevance evaluation (pm-u8n5). Loads the golden-query set
@@ -66,4 +66,4 @@ passed: boolean;
  * supplied, the aggregate `--fail-under` threshold. The CLI maps any failed
  * threshold to a non-zero exit code.
  */
-export declare const runEval: (options: EvalOptions, global: GlobalOptions) => Promise<EvalResult>;
+export declare const runEval:(options:EvalOptions,global:GlobalOptions) => Promise<EvalResult>;

package/dist/sdk/extension/author-manifest.d.ts

@@ -2,21 +2,21 @@ import { type ExtensionManifestSchemaFinding } from "../../core/extensions/manif
 /** Read-only author-workspace manifest diagnostic shared by health and doctor. */
 export interface ExtensionAuthorManifestDiagnostic {
 /** Absolute path inspected for the extension runtime manifest. */
-path: string;
+path:string;
 /** Whether the workspace declares a root extension manifest. */
-present: boolean;
+present:boolean;
 /** Parse state for absent, valid, or malformed manifest content. */
-parse_status: "absent" | "valid" | "invalid_json" | "invalid_shape";
+parse_status:"absent" | "valid" | "invalid_json" | "invalid_shape";
 /** Canonical package catalog metadata location, distinct from manifest.json. */
-package_metadata_location: "package.json#pm";
+package_metadata_location:"package.json#pm";
 /** Public schema findings when the file is a JSON object. */
-schema_findings: ExtensionManifestSchemaFinding[];
+schema_findings:ExtensionManifestSchemaFinding[];
 /** Runtime warning tokens incorporated into health/doctor status. */
-warnings: string[];
+warnings:string[];
 /** Direct author correction for every reported state. */
-remediation: string[];
+remediation:string[];
 }
 /** Inspect `<workspace>/manifest.json` without loading extension code. */
-export declare function inspectExtensionAuthorManifest(workspaceRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;
+export declare function inspectExtensionAuthorManifest(workspaceRoot:string):Promise<ExtensionAuthorManifestDiagnostic>;
 /** Inspect the author manifest for a resolved project tracker root. */
-export declare function inspectExtensionAuthorManifestAtPmRoot(pmRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;
+export declare function inspectExtensionAuthorManifestAtPmRoot(pmRoot:string):Promise<ExtensionAuthorManifestDiagnostic>;

package/dist/sdk/extension/bundled-catalog.d.ts

@@ -1,35 +1,35 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
-import type { ExtensionCommandOptions, ExtensionScope } from "../extension.js";
+import type { ExtensionCommandOptions,ExtensionScope } from "../extension.js";
 /** Implements resolve bundled extension alias source for the public runtime surface of this module. */
-export declare function resolveBundledExtensionAliasSource(input: string): Promise<string | null>;
+export declare function resolveBundledExtensionAliasSource(input:string):Promise<string | null>;
 /** Implements check whether bundled package install all target for the public runtime surface of this module. */
-export declare function isBundledPackageInstallAllTarget(input: string): boolean;
+export declare function isBundledPackageInstallAllTarget(input:string):boolean;
 /** Implements list bundled package aliases for the public runtime surface of this module. */
-export declare function listBundledPackageAliases(): Promise<string[]>;
+export declare function listBundledPackageAliases():Promise<string[]>;
 /**
  * Implements resolve bundled package root for the public runtime surface of this module.
  * Accepts every spelling agents naturally reach for: the catalog alias
  * ("kanban"), the package directory ("pm-kanban"), and the published npm name
  * ("@unbrained/pm-kanban").
  */
-export declare function resolveBundledPackageRoot(alias: string): Promise<string | null>;
+export declare function resolveBundledPackageRoot(alias:string):Promise<string | null>;
 /** Resolve the published npm package name for a bundled alias so install flows can persist it as managed-source provenance (`source.package`). Returns null when the alias is unknown or the bundled package manifest lacks a name. */
-export declare function resolveBundledPackageNpmName(alias: string): Promise<string | null>;
+export declare function resolveBundledPackageNpmName(alias:string):Promise<string | null>;
 /** Implements resolve bundled alias manifest name for the public runtime surface of this module. */
-export declare function resolveBundledAliasManifestName(input: string): Promise<string | null>;
+export declare function resolveBundledAliasManifestName(input:string):Promise<string | null>;
 /** Implements build bundled package catalog for the public runtime surface of this module. */
-export declare function buildBundledPackageCatalog(scope: ExtensionScope, global: GlobalOptions, options?: ExtensionCommandOptions): Promise<{
-total: number;
-scope: ExtensionScope;
-installable_resource_kinds: string[];
-metadata_only_resource_kinds: string[];
-packages: Array<Record<string, unknown>>;
+export declare function buildBundledPackageCatalog(scope:ExtensionScope,global:GlobalOptions,options?:ExtensionCommandOptions):Promise<{
+total:number;
+scope:ExtensionScope;
+installable_resource_kinds:string[];
+metadata_only_resource_kinds:string[];
+packages:Array<Record<string,unknown>>;
 }>;
-declare function parsePackageCatalogFields(raw: string | undefined): string[] | undefined;
-declare function projectPackageCatalogEntry(entry: Record<string, unknown>, fields: string[]): Record<string, unknown>;
+declare function parsePackageCatalogFields(raw:string | undefined):string[] | undefined;
+declare function projectPackageCatalogEntry(entry:Record<string,unknown>,fields:string[]):Record<string,unknown>;
 /** Public contract for test only bundled catalog, shared by SDK and presentation-layer consumers. */
-export declare const _testOnlyBundledCatalog: {
-parsePackageCatalogFields: typeof parsePackageCatalogFields;
-projectPackageCatalogEntry: typeof projectPackageCatalogEntry;
+export declare const _testOnlyBundledCatalog:{
+parsePackageCatalogFields:typeof parsePackageCatalogFields;
+projectPackageCatalogEntry:typeof projectPackageCatalogEntry;
 };
 export {};

package/dist/sdk/extension/concurrency.d.ts

@@ -4,4 +4,4 @@
  * Provides resource-bounded asynchronous collection transforms for extension workflows.
  */
 /** Map inputs with a fixed worker pool so remote checks cannot exhaust process resources. */
-export declare const mapWithFixedConcurrency: <Input, Output>(inputs: Input[], concurrency: number, mapper: (input: Input) => Promise<Output>) => Promise<Output[]>;
+export declare const mapWithFixedConcurrency:<Input,Output>(inputs:Input[],concurrency:number,mapper:(input:Input) => Promise<Output>) => Promise<Output[]>;

package/dist/sdk/extension/copy-scope.d.ts

@@ -1,2 +1,2 @@
 /** Decide whether a lexical source path belongs in an extension snapshot. Git metadata is always excluded; symlinks remain links. */
-export declare function includesExtensionCopyPath(source: string, destination: string, candidate: string, nestedDestination: boolean): boolean;
+export declare function includesExtensionCopyPath(source:string,destination:string,candidate:string,nestedDestination:boolean):boolean;

package/dist/sdk/extension/custom-field-collisions.d.ts

@@ -3,4 +3,4 @@
  */
 import type { activateExtensions } from "../../core/extensions/index.js";
 /** Report extension and extension-profile fields shadowed by canonical MCP inputs. */
-export declare const collectMcpCustomFieldCollisionDoctorWarnings: (activationResult: Awaited<ReturnType<typeof activateExtensions>>) => string[];
+export declare const collectMcpCustomFieldCollisionDoctorWarnings:(activationResult:Awaited<ReturnType<typeof activateExtensions>>) => string[];

package/dist/sdk/extension/describe.d.ts

@@ -17,7 +17,7 @@
  * builder is trivially unit-testable against synthetic activations.
  */
 import { type ExtensionActivationSummary } from "../../core/extensions/activation-summary.js";
-import type { ExtensionActivationResult, ExtensionLayer, ExtensionLoadResult } from "../../core/extensions/loader.js";
+import type { ExtensionActivationResult,ExtensionLayer,ExtensionLoadResult } from "../../core/extensions/loader.js";
 /** Runtime state of a described extension. `ok` loaded and activated cleanly, `failed` loaded but threw during `activate`, and `not_loaded` failed to import at all -- the latter two register nothing, so their `surfaces` are empty and the status explains why (rather than implying the extension contributes nothing). */
 export type ExtensionDescribeActivationStatus = "ok" | "failed" | "not_loaded";
 /**
@@ -32,15 +32,15 @@ export type ExtensionDescribeActivationStatus = "ok" | "failed" | "not_loaded";
  */
 export interface ExtensionSurfaceDescription {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports version for this contract. */
-version: string;
+version:string;
 /** Activation outcome reported for this extension. */
-activation_status: ExtensionDescribeActivationStatus;
+activation_status:ExtensionDescribeActivationStatus;
 /** Value that configures or reports surfaces for this contract. */
-surfaces: ExtensionActivationSummary;
+surfaces:ExtensionActivationSummary;
 }
 /**
  * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps
@@ -50,37 +50,37 @@ surfaces: ExtensionActivationSummary;
  */
 export interface ExtensionDescribeResult {
 /** Value that configures or reports target for this contract. */
-target: string | null;
+target:string | null;
 /** Value that configures or reports total for this contract. */
-total: number;
+total:number;
 /** Value that configures or reports extensions for this contract. */
-extensions: ExtensionSurfaceDescription[];
+extensions:ExtensionSurfaceDescription[];
 /** Value that configures or reports union for this contract. */
-union: ExtensionActivationSummary;
+union:ExtensionActivationSummary;
 /** Deterministic ownership table for every registered command handler or override in scope. */
-command_ownership: ExtensionCommandOwnership[];
+command_ownership:ExtensionCommandOwnership[];
 }
 /** One package claim on a command path, including whether runtime precedence selects it. */
 export interface ExtensionCommandClaimant {
 /** Extension manifest name. */
-name: string;
+name:string;
 /** Extension discovery layer. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Whether this claimant is the effective owner under the declared policy. */
-winner: boolean;
+winner:boolean;
 }
 /** Inspectable ownership and collision state for one command registry surface. */
 export interface ExtensionCommandOwnership {
 /** Full command path. */
-command: string;
+command:string;
 /** Registry surface that owns dispatch behavior. */
-surface: "handler" | "override";
+surface:"handler" | "override";
 /** Stable runtime precedence policy. */
-policy: "last_activated_wins";
+policy:"last_activated_wins";
 /** Whether more than one extension claims this path on the same surface. */
-collision: boolean;
+collision:boolean;
 /** Every claimant in activation order; exactly the final claimant is the winner. */
-claimants: ExtensionCommandClaimant[];
+claimants:ExtensionCommandClaimant[];
 }
 /**
  * Summarize, by name, every registration surface the loaded extensions exercised.
@@ -97,7 +97,7 @@ claimants: ExtensionCommandClaimant[];
  * to install without a second lookup. An unmatched `target` yields an empty
  * `extensions` array -- the caller decides whether that is a not-found error.
  */
-export declare function buildExtensionDescribeResult(target: string | undefined, loadResult: ExtensionLoadResult, activationResult: ExtensionActivationResult): ExtensionDescribeResult;
+export declare function buildExtensionDescribeResult(target:string | undefined,loadResult:ExtensionLoadResult,activationResult:ExtensionActivationResult):ExtensionDescribeResult;
 /**
  * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a
  * top-level title and scope line, one section per described extension (titled
@@ -112,4 +112,4 @@ export declare function buildExtensionDescribeResult(target: string | undefined,
  * target is already a not-found error upstream, so this is the "nothing loaded"
  * case) the document is the title plus a single explanatory note.
  */
-export declare function renderExtensionDescribeMarkdown(result: ExtensionDescribeResult, noun: string): string;
+export declare function renderExtensionDescribeMarkdown(result:ExtensionDescribeResult,noun:string):string;