@unbrained/pm-cli 2026.10.4 → 2026.10.5

package/dist/cli.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="51825a77-c7de-51ca-aa9e-4362278019ec")}catch(e2){}})();import fs from"node:fs";import*as nodeModule from"node:module";import os from"node:os";import path from"node:path";import{fileURLToPath}from"node:url";import{runCliWithBundleIntegrity}from"./cli/bundle-integrity.js";import{runRuntimeCompatibleCli}from"./cli/runtime-compatibility-boundary.js";import{registerInvocationProfile}from"./cli/invocation-profile.js";import{pruneCompileCacheGenerations,resolveCompileCacheGeneration}from"./sdk/compile-cache.js";function enableNodeCompileCache(){const{enableCompileCache}=nodeModule;if(typeof enableCompileCache!=="function"||process.env.PM_CLI_DISABLE_COMPILE_CACHE==="1"){return}const userCacheKey=typeof process.getuid==="function"?String(process.getuid()):os.userInfo().username.replace(/[^a-zA-Z0-9._-]/g,"_");const configuredCacheDir=process.env.PM_CLI_COMPILE_CACHE_DIR;const defaultCacheRoot=path.join(os.tmpdir(),`pm-cli-node-compile-cache-${userCacheKey}`);const generation=resolveCompileCacheGeneration(readPackageVersionForPath(fileURLToPath(import.meta.url)));const cacheDir=configuredCacheDir??path.join(defaultCacheRoot,generation);try{if(configuredCacheDir===void 0){pruneCompileCacheGenerations(defaultCacheRoot,generation)}enableCompileCache(cacheDir)}catch{}}function findPackageJson(startPath){let current=path.dirname(path.resolve(startPath));while(true){const candidate=path.join(current,"package.json");if(fs.existsSync(candidate)){return candidate}const parent=path.dirname(current);if(parent===current){return void 0}current=parent}}function printFastVersionIfRequested(){const args=process.argv.slice(2);const versionArgs=args.filter(arg=>arg!=="--no-extensions"&&arg!=="--profile");if(versionArgs.length!==1||versionArgs[0]!=="--version"&&versionArgs[0]!=="-V"){return false}const version=readPackageVersionForPath(fileURLToPath(import.meta.url));if(version===void 0){return false}console.log(version);return true}function readPackageVersionForPath(startPath){const packageJsonPath=findPackageJson(startPath);if(!packageJsonPath){return void 0}try{const parsed=JSON.parse(fs.readFileSync(packageJsonPath,"utf8"));if(typeof parsed.version!=="string"){return void 0}return parsed.version}catch{return void 0}}const _testOnly={enableNodeCompileCache,findPackageJson,printFastVersionIfRequested,readPackageVersionForPath};registerInvocationProfile(process.argv.slice(2));if(!printFastVersionIfRequested()){enableNodeCompileCache();const cliEntrypointPath=fileURLToPath(import.meta.url);const executingVersion=readPackageVersionForPath(cliEntrypointPath);const invocationArgv=process.argv.slice(2);await runRuntimeCompatibleCli({executingVersion,projectRoot:process.cwd(),argv:invocationArgv,allowStale:process.env.PM_ALLOW_STALE_CLI==="1",run:()=>runCliWithBundleIntegrity(invocationArgv,cliEntrypointPath,()=>import("./cli-bundle/main.js"),process.stderr.write.bind(process.stderr)),writeError:process.stderr.write.bind(process.stderr)})}export{_testOnly};
+(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]="84b9d77a-1a51-5563-a210-e9c8640c56de")}catch{}})();import fs from"node:fs";import*as nodeModule from"node:module";import os from"node:os";import path from"node:path";import{fileURLToPath}from"node:url";import{runCliWithBundleIntegrity}from"./cli/bundle-integrity.js";import{runRuntimeCompatibleCli}from"./cli/runtime-compatibility-boundary.js";import{registerInvocationProfile}from"./cli/invocation-profile.js";import{pruneCompileCacheGenerations,resolveCompileCacheGeneration}from"./sdk/compile-cache.js";function enableNodeCompileCache(){const{enableCompileCache}=nodeModule;if(typeof enableCompileCache!="function"||process.env.PM_CLI_DISABLE_COMPILE_CACHE==="1")return;const userCacheKey=typeof process.getuid=="function"?String(process.getuid()):os.userInfo().username.replace(/[^a-zA-Z0-9._-]/g,"_"),configuredCacheDir=process.env.PM_CLI_COMPILE_CACHE_DIR,defaultCacheRoot=path.join(os.tmpdir(),`pm-cli-node-compile-cache-${userCacheKey}`),generation=resolveCompileCacheGeneration(readPackageVersionForPath(fileURLToPath(import.meta.url))),cacheDir=configuredCacheDir??path.join(defaultCacheRoot,generation);try{configuredCacheDir===void 0&&pruneCompileCacheGenerations(defaultCacheRoot,generation),enableCompileCache(cacheDir)}catch{}}function findPackageJson(startPath){let current=path.dirname(path.resolve(startPath));for(;;){const candidate=path.join(current,"package.json");if(fs.existsSync(candidate))return candidate;const parent=path.dirname(current);if(parent===current)return;current=parent}}function printFastVersionIfRequested(){const versionArgs=process.argv.slice(2).filter(arg=>arg!=="--no-extensions"&&arg!=="--profile");if(versionArgs.length!==1||versionArgs[0]!=="--version"&&versionArgs[0]!=="-V")return!1;const version=readPackageVersionForPath(fileURLToPath(import.meta.url));return version===void 0?!1:(console.log(version),!0)}function readPackageVersionForPath(startPath){const packageJsonPath=findPackageJson(startPath);if(packageJsonPath)try{const parsed=JSON.parse(fs.readFileSync(packageJsonPath,"utf8"));return typeof parsed.version!="string"?void 0:parsed.version}catch{return}}const _testOnly={enableNodeCompileCache,findPackageJson,printFastVersionIfRequested,readPackageVersionForPath};if(registerInvocationProfile(process.argv.slice(2)),!printFastVersionIfRequested()){enableNodeCompileCache();const cliEntrypointPath=fileURLToPath(import.meta.url),executingVersion=readPackageVersionForPath(cliEntrypointPath),invocationArgv=process.argv.slice(2);await runRuntimeCompatibleCli({executingVersion,projectRoot:process.cwd(),argv:invocationArgv,allowStale:process.env.PM_ALLOW_STALE_CLI==="1",run:()=>runCliWithBundleIntegrity(invocationArgv,cliEntrypointPath,()=>import("./cli-bundle/main.js"),process.stderr.write.bind(process.stderr)),writeError:process.stderr.write.bind(process.stderr)})}export{_testOnly};
 //# sourceMappingURL=cli.js.map

package/dist/core/checkpoint/checkpoint-gc.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fe72275e-b195-5a7e-b963-a9f159f9c67c")}catch(e2){}})();import{isFileMissingError}from"../fs/fs-utils.js";import fs from"node:fs/promises";import path from"node:path";const MILLISECONDS_PER_DAY=864e5;function readCheckpointCreatedAt(raw){let parsed;try{parsed=JSON.parse(raw)}catch{return null}if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){return null}const createdAt=parsed.created_at;return typeof createdAt==="string"?createdAt:null}async function collectCheckpointFiles(checkpointsDir,warnings){let dirEntries;try{dirEntries=await fs.readdir(checkpointsDir,{withFileTypes:true})}catch(error){if(isFileMissingError(error)){return[]}throw error}const files=[];for(const entry of dirEntries){if(entry.isDirectory()){const subdir=path.join(checkpointsDir,entry.name);let nested;try{nested=await fs.readdir(subdir)}catch(error){if(!isFileMissingError(error)){warnings.push(`checkpoint_subdir_unreadable:${entry.name}`)}continue}for(const file of nested){if(file.endsWith(".json")){files.push(`${entry.name}/${file}`)}}}else if(entry.name.endsWith(".json")){files.push(entry.name)}}return files.sort()}async function runCheckpointGc(pmRoot,options){const{dryRun,hooks}=options;const nowMs=options.now??Date.now();const retentionMs=Math.max(0,options.retentionDays)*MILLISECONDS_PER_DAY;const checkpointsDir=path.join(pmRoot,"checkpoints");const result={scanned:0,removed:[],retained:[],warnings:[],entries:[]};const files=await collectCheckpointFiles(checkpointsDir,result.warnings);for(const relName of files){const absPath=path.join(checkpointsDir,relName);const relPath=`checkpoints/${relName}`;result.scanned+=1;if(hooks?.onRead){result.warnings.push(...await hooks.onRead(absPath))}let raw;try{raw=await fs.readFile(absPath,"utf8")}catch(readError){if(isFileMissingError(readError)){result.scanned-=1;continue}result.warnings.push(`checkpoint_unreadable:${relName}`);result.retained.push(relPath);result.entries.push({file:relPath,created_at:null,age_seconds:null,stale:false,reason:"unparseable"});continue}const createdAt=readCheckpointCreatedAt(raw);const createdAtMs=createdAt===null?Number.NaN:Date.parse(createdAt);if(!Number.isFinite(createdAtMs)){result.warnings.push(`checkpoint_unparseable:${relName}`);result.retained.push(relPath);result.entries.push({file:relPath,created_at:createdAt,age_seconds:null,stale:false,reason:"unparseable"});continue}const ageMs=nowMs-createdAtMs;const entry={file:relPath,created_at:createdAt,age_seconds:Math.floor(ageMs/1e3),stale:ageMs>retentionMs,reason:ageMs>retentionMs?"expired":"active"};if(!entry.stale){result.retained.push(relPath);result.entries.push(entry);continue}if(!dryRun){try{await fs.unlink(absPath)}catch(unlinkError){if(!isFileMissingError(unlinkError)){result.warnings.push(`checkpoint_remove_failed:${relName}`);result.retained.push(relPath);result.entries.push(entry);continue}}if(hooks?.onWrite){result.warnings.push(...await hooks.onWrite(absPath))}}result.removed.push(relPath);result.entries.push(entry)}return result}export{runCheckpointGc};
+(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]="4fe37a62-2d0f-55f6-bb98-7162e7e8b8fe")}catch{}})();import{isFileMissingError}from"../fs/fs-utils.js";import fs from"node:fs/promises";import path from"node:path";const MILLISECONDS_PER_DAY=864e5;function readCheckpointCreatedAt(raw){let parsed;try{parsed=JSON.parse(raw)}catch{return null}if(typeof parsed!="object"||parsed===null||Array.isArray(parsed))return null;const createdAt=parsed.created_at;return typeof createdAt=="string"?createdAt:null}async function collectCheckpointFiles(checkpointsDir,warnings){let dirEntries;try{dirEntries=await fs.readdir(checkpointsDir,{withFileTypes:!0})}catch(error){if(isFileMissingError(error))return[];throw error}const files=[];for(const entry of dirEntries)if(entry.isDirectory()){const subdir=path.join(checkpointsDir,entry.name);let nested;try{nested=await fs.readdir(subdir)}catch(error){isFileMissingError(error)||warnings.push(`checkpoint_subdir_unreadable:${entry.name}`);continue}for(const file of nested)file.endsWith(".json")&&files.push(`${entry.name}/${file}`)}else entry.name.endsWith(".json")&&files.push(entry.name);return files.sort()}async function runCheckpointGc(pmRoot,options){const{dryRun,hooks}=options,nowMs=options.now??Date.now(),retentionMs=Math.max(0,options.retentionDays)*MILLISECONDS_PER_DAY,checkpointsDir=path.join(pmRoot,"checkpoints"),result={scanned:0,removed:[],retained:[],warnings:[],entries:[]},files=await collectCheckpointFiles(checkpointsDir,result.warnings);for(const relName of files){const absPath=path.join(checkpointsDir,relName),relPath=`checkpoints/${relName}`;result.scanned+=1,hooks?.onRead&&result.warnings.push(...await hooks.onRead(absPath));let raw;try{raw=await fs.readFile(absPath,"utf8")}catch(readError){if(isFileMissingError(readError)){result.scanned-=1;continue}result.warnings.push(`checkpoint_unreadable:${relName}`),result.retained.push(relPath),result.entries.push({file:relPath,created_at:null,age_seconds:null,stale:!1,reason:"unparseable"});continue}const createdAt=readCheckpointCreatedAt(raw),createdAtMs=createdAt===null?Number.NaN:Date.parse(createdAt);if(!Number.isFinite(createdAtMs)){result.warnings.push(`checkpoint_unparseable:${relName}`),result.retained.push(relPath),result.entries.push({file:relPath,created_at:createdAt,age_seconds:null,stale:!1,reason:"unparseable"});continue}const ageMs=nowMs-createdAtMs,entry={file:relPath,created_at:createdAt,age_seconds:Math.floor(ageMs/1e3),stale:ageMs>retentionMs,reason:ageMs>retentionMs?"expired":"active"};if(!entry.stale){result.retained.push(relPath),result.entries.push(entry);continue}if(!dryRun){try{await fs.unlink(absPath)}catch(unlinkError){if(!isFileMissingError(unlinkError)){result.warnings.push(`checkpoint_remove_failed:${relName}`),result.retained.push(relPath),result.entries.push(entry);continue}}hooks?.onWrite&&result.warnings.push(...await hooks.onWrite(absPath))}result.removed.push(relPath),result.entries.push(entry)}return result}export{runCheckpointGc};
 //# sourceMappingURL=checkpoint-gc.js.map

package/dist/core/checkpoint/mutation-checkpoint.js

@@ -1,3 +1,3 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="93b04081-a71a-5987-8fb6-09a8d045c1da")}catch(e2){}})();import{readFile}from"node:fs/promises";import path from"node:path";import{pathExists,readFileIfExists}from"../fs/fs-utils.js";import{createFileAtomic}from"../fs/atomic-create.js";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{toErrorMessage}from"../shared/primitives.js";import{nowIso}from"../shared/time.js";function normalizeCheckpointId(raw){const trimmed=raw.trim();if(!trimmed){throw new PmCliError("--rollback requires a non-empty checkpoint ID",EXIT_CODE.USAGE)}if(!/^[a-zA-Z0-9._-]+$/.test(trimmed)){throw new PmCliError("--rollback checkpoint ID must match [a-zA-Z0-9._-]+",EXIT_CODE.USAGE)}return trimmed}function createCheckpointId(prefix,nowValue){const compactTimestamp=nowValue.replace(/[-:.TZ]/g,"").slice(0,14);const randomSuffix=Math.random().toString(36).slice(2,8);return`${prefix}-${compactTimestamp}-${randomSuffix}`}function checkpointDirectoryPath(pmRoot,subdir){return path.join(pmRoot,"checkpoints",subdir)}function checkpointFilePath(pmRoot,subdir,checkpointId){return path.join(checkpointDirectoryPath(pmRoot,subdir),`${checkpointId}.json`)}async function writeMutationCheckpoint(pmRoot,subdir,checkpointId,payload){const filePath=checkpointFilePath(pmRoot,subdir,checkpointId);const raw=`${JSON.stringify(payload,null,2)}
-`;if(!await createFileAtomic(filePath,raw)&&await readFileIfExists(filePath)!==raw){throw new PmCliError(`Checkpoint ${checkpointId} already exists with different contents; use a new checkpoint ID.`,EXIT_CODE.CONFLICT)}return filePath}function parseCheckpointItems(record,checkpointId){if(!Array.isArray(record.items)){throw new PmCliError(`Checkpoint ${checkpointId} is missing items`,EXIT_CODE.GENERIC_FAILURE)}return record.items.map(entry=>{if(!entry||typeof entry!=="object"){throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`,EXIT_CODE.GENERIC_FAILURE)}const row=entry;if(typeof row.id!=="string"||row.id.trim().length===0){throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`,EXIT_CODE.GENERIC_FAILURE)}if(typeof row.target_updated_at!=="string"||row.target_updated_at.trim().length===0){throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without target_updated_at`,EXIT_CODE.GENERIC_FAILURE)}return{id:row.id.trim(),target_updated_at:row.target_updated_at.trim()}})}async function loadMutationCheckpoint(pmRoot,subdir,rawCheckpointId,schemaVersion){const normalizedId=normalizeCheckpointId(rawCheckpointId);const filePath=checkpointFilePath(pmRoot,subdir,normalizedId);if(!await pathExists(filePath)){throw new PmCliError(`Checkpoint ${normalizedId} not found`,EXIT_CODE.NOT_FOUND)}const raw=await readFile(filePath,"utf8");let parsed;try{parsed=JSON.parse(raw)}catch(error){throw new PmCliError(`Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`,EXIT_CODE.GENERIC_FAILURE)}if(!parsed||typeof parsed!=="object"){throw new PmCliError(`Checkpoint ${normalizedId} is invalid`,EXIT_CODE.GENERIC_FAILURE)}const record=parsed;if(record.schema_version!==schemaVersion){throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`,EXIT_CODE.GENERIC_FAILURE)}const items=parseCheckpointItems(record,normalizedId);return{record,items,path:filePath,id:typeof record.id==="string"?record.id:normalizedId,created_at:typeof record.created_at==="string"?record.created_at:nowIso(),author:typeof record.author==="string"?record.author:"unknown"}}async function restoreCheckpointItems(items,restore){const rows=[];const restoredIds=[];for(const entry of items){try{const restored=await restore(entry.id,entry.target_updated_at);rows.push({id:entry.id,status:"restored",changed_fields:restored.changed_fields,warnings:restored.warnings});restoredIds.push(entry.id)}catch(error){rows.push({id:entry.id,status:"failed",error:toErrorMessage(error)})}}return{rows,restored_ids:restoredIds,failed_count:rows.filter(row=>row.status==="failed").length}}export{checkpointDirectoryPath,checkpointFilePath,createCheckpointId,loadMutationCheckpoint,normalizeCheckpointId,restoreCheckpointItems,writeMutationCheckpoint};
+(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]="da661b46-841c-526d-88bc-976e007e8fbe")}catch{}})();import{readFile}from"node:fs/promises";import path from"node:path";import{pathExists,readFileIfExists}from"../fs/fs-utils.js";import{createFileAtomic}from"../fs/atomic-create.js";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";import{toErrorMessage}from"../shared/primitives.js";import{nowIso}from"../shared/time.js";function normalizeCheckpointId(raw){const trimmed=raw.trim();if(!trimmed)throw new PmCliError("--rollback requires a non-empty checkpoint ID",EXIT_CODE.USAGE);if(!/^[a-zA-Z0-9._-]+$/.test(trimmed))throw new PmCliError("--rollback checkpoint ID must match [a-zA-Z0-9._-]+",EXIT_CODE.USAGE);return trimmed}function createCheckpointId(prefix,nowValue){const compactTimestamp=nowValue.replace(/[-:.TZ]/g,"").slice(0,14),randomSuffix=Math.random().toString(36).slice(2,8);return`${prefix}-${compactTimestamp}-${randomSuffix}`}function checkpointDirectoryPath(pmRoot,subdir){return path.join(pmRoot,"checkpoints",subdir)}function checkpointFilePath(pmRoot,subdir,checkpointId){return path.join(checkpointDirectoryPath(pmRoot,subdir),`${checkpointId}.json`)}async function writeMutationCheckpoint(pmRoot,subdir,checkpointId,payload){const filePath=checkpointFilePath(pmRoot,subdir,checkpointId),raw=`${JSON.stringify(payload,null,2)}
+`;if(!await createFileAtomic(filePath,raw)&&await readFileIfExists(filePath)!==raw)throw new PmCliError(`Checkpoint ${checkpointId} already exists with different contents; use a new checkpoint ID.`,EXIT_CODE.CONFLICT);return filePath}function parseCheckpointItems(record,checkpointId){if(!Array.isArray(record.items))throw new PmCliError(`Checkpoint ${checkpointId} is missing items`,EXIT_CODE.GENERIC_FAILURE);return record.items.map(entry=>{if(!entry||typeof entry!="object")throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`,EXIT_CODE.GENERIC_FAILURE);const row=entry;if(typeof row.id!="string"||row.id.trim().length===0)throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`,EXIT_CODE.GENERIC_FAILURE);if(typeof row.target_updated_at!="string"||row.target_updated_at.trim().length===0)throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without target_updated_at`,EXIT_CODE.GENERIC_FAILURE);return{id:row.id.trim(),target_updated_at:row.target_updated_at.trim()}})}async function loadMutationCheckpoint(pmRoot,subdir,rawCheckpointId,schemaVersion){const normalizedId=normalizeCheckpointId(rawCheckpointId),filePath=checkpointFilePath(pmRoot,subdir,normalizedId);if(!await pathExists(filePath))throw new PmCliError(`Checkpoint ${normalizedId} not found`,EXIT_CODE.NOT_FOUND);const raw=await readFile(filePath,"utf8");let parsed;try{parsed=JSON.parse(raw)}catch(error){throw new PmCliError(`Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`,EXIT_CODE.GENERIC_FAILURE)}if(!parsed||typeof parsed!="object")throw new PmCliError(`Checkpoint ${normalizedId} is invalid`,EXIT_CODE.GENERIC_FAILURE);const record=parsed;if(record.schema_version!==schemaVersion)throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`,EXIT_CODE.GENERIC_FAILURE);const items=parseCheckpointItems(record,normalizedId);return{record,items,path:filePath,id:typeof record.id=="string"?record.id:normalizedId,created_at:typeof record.created_at=="string"?record.created_at:nowIso(),author:typeof record.author=="string"?record.author:"unknown"}}async function restoreCheckpointItems(items,restore){const rows=[],restoredIds=[];for(const entry of items)try{const restored=await restore(entry.id,entry.target_updated_at);rows.push({id:entry.id,status:"restored",changed_fields:restored.changed_fields,warnings:restored.warnings}),restoredIds.push(entry.id)}catch(error){rows.push({id:entry.id,status:"failed",error:toErrorMessage(error)})}return{rows,restored_ids:restoredIds,failed_count:rows.filter(row=>row.status==="failed").length}}export{checkpointDirectoryPath,checkpointFilePath,createCheckpointId,loadMutationCheckpoint,normalizeCheckpointId,restoreCheckpointItems,writeMutationCheckpoint};
 //# sourceMappingURL=mutation-checkpoint.js.map

package/dist/core/config/nested-settings.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2d4017d7-771b-53a1-ae56-71df7e1a0ac4")}catch(e2){}})();const NESTED_SETTING_DESCRIPTORS=[{key:"search_provider",path:"search.provider",kind:"string",summary:"Search embedding provider name (e.g. openai, ollama, or an extension provider)."},{key:"search_default_mode",path:"search.default_mode",kind:"string",choices:["auto","keyword","semantic","hybrid"],summary:"Mode a bare pm search runs in: auto (hybrid when semantic search is explicitly configured and runnable, else keyword), or a pinned keyword, semantic, or hybrid."},{key:"search_mutation_refresh_policy",path:"search.mutation_refresh_policy",kind:"string",choices:["cache_only","semantic_configured","semantic_auto"],summary:"Mutation-time search refresh policy: cache_only, semantic_configured, or semantic_auto."},{key:"search_query_expansion_enabled",path:"search.query_expansion.enabled",kind:"boolean",summary:"Enable or disable query expansion for semantic/hybrid search."},{key:"search_query_expansion_provider",path:"search.query_expansion.provider",kind:"string",summary:"Query expansion provider name (built-in openai/ollama or extension provider)."},{key:"search_rerank_enabled",path:"search.rerank.enabled",kind:"boolean",summary:"Enable or disable post-retrieval reranking for hybrid search."},{key:"search_rerank_model",path:"search.rerank.model",kind:"string",summary:"Rerank model name override used by built-in providers."},{key:"search_rerank_top_k",path:"search.rerank.top_k",kind:"integer",min:1,summary:"Number of top hybrid candidates to rerank when rerank is enabled."},{key:"search_embedding_model",path:"search.embedding_model",kind:"string",summary:"Default embedding model name (overrides provider-specific model when set)."},{key:"search_embedding_corpus_max_characters",path:"search.embedding_corpus_max_characters",kind:"integer",min:1,summary:"Maximum semantic corpus characters per item before truncation."},{key:"search_embedding_batch_size",path:"search.embedding_batch_size",kind:"integer",min:1,summary:"Number of items embedded per request batch."},{key:"search_embedding_timeout_ms",path:"search.embedding_timeout_ms",kind:"integer",min:1,summary:"Per-request embedding timeout in milliseconds."},{key:"search_score_threshold",path:"search.score_threshold",kind:"number",summary:"Minimum score for a hit to be returned (0 keeps all matches)."},{key:"search_hybrid_semantic_weight",path:"search.hybrid_semantic_weight",kind:"ratio",summary:"Hybrid mode semantic weight in [0, 1] (1-weight goes to keyword)."},{key:"search_max_results",path:"search.max_results",kind:"integer",min:1,summary:"Default upper bound on search hits when --limit is not supplied."},{key:"search_bm25_k1",path:"search.bm25.k1",kind:"number",min:0,summary:"Offline BM25 term-frequency saturation (k1); higher saturates repeated terms slower (default 1.2)."},{key:"search_bm25_b",path:"search.bm25.b",kind:"ratio",summary:"Offline BM25 document-length normalization (b) in [0, 1]; 0 disables, 1 fully normalizes (default 0.75)."},{key:"openai_base_url",path:"providers.openai.base_url",kind:"string",summary:"OpenAI-compatible API base URL (LM Studio/vLLM also use this)."},{key:"openai_api_key",path:"providers.openai.api_key",kind:"string",summary:"OpenAI-compatible API key."},{key:"openai_model",path:"providers.openai.model",kind:"string",summary:"OpenAI-compatible embedding model name."},{key:"ollama_base_url",path:"providers.ollama.base_url",kind:"string",summary:"Ollama API base URL (typically http://localhost:11434)."},{key:"ollama_model",path:"providers.ollama.model",kind:"string",summary:"Ollama embedding model name (e.g. nomic-embed-text)."},{key:"vector_store_adapter",path:"vector_store.adapter",kind:"string",summary:"Vector store adapter name (lancedb, qdrant, or an extension adapter)."},{key:"vector_store_collection_name",path:"vector_store.collection_name",kind:"string",non_empty:true,summary:"Vector collection/table name shared by Qdrant and LanceDB adapters."},{key:"qdrant_url",path:"vector_store.qdrant.url",kind:"string",summary:"Qdrant HTTP API URL."},{key:"qdrant_api_key",path:"vector_store.qdrant.api_key",kind:"string",summary:"Qdrant API key (empty if running unauthenticated)."},{key:"lancedb_path",path:"vector_store.lancedb.path",kind:"string",summary:"LanceDB storage path (relative to pm root or absolute)."},{key:"id_prefix",path:"id_prefix",kind:"string",non_empty:true,summary:'Prefix for generated item IDs (e.g. "pm" produces pm-xxxx).'},{key:"author_default",path:"author_default",kind:"string",non_empty:true,summary:"Default author recorded on mutations when --author is not supplied."},{key:"agent_identity_probes_enabled",path:"agent_identity.probes_enabled",kind:"boolean",summary:"Allow privacy-bounded local harness provenance probes; no network or subprocess access is permitted."},{key:"mutation_guard_require_attributed_author",path:"mutation_guard.require_attributed_author",kind:"boolean",summary:"Reject mutations whose effective author resolves to unknown."},{key:"mutation_guard_secret_guard",path:"mutation_guard.secret_guard",kind:"string",choices:["off","advise","block"],summary:"Detect credential-shaped mutation content: off, advise, or block."},{key:"mutation_guard_stale_in_progress_hours",path:"mutation_guard.stale_in_progress_hours",kind:"integer",min:1,summary:"Age threshold for unclaimed in-progress work surfaced by health."},{key:"governance_duplicate_detection_mode",path:"governance.duplicate_detection_mode",kind:"string",choices:["off","advisory","strict"],summary:"Create/copy duplicate governance: off, advisory, or strict explicit-bypass enforcement."},{key:"governance_duplicate_detection_threshold",path:"governance.duplicate_detection_threshold",kind:"ratio",summary:"Minimum shared similarity score in [0, 1] for create/copy duplicate governance."},{key:"governance_duplicate_detection_limit",path:"governance.duplicate_detection_limit",kind:"integer",min:0,max:20,summary:"Maximum likely duplicates returned by create/copy governance (0-20)."},{key:"output_default_format",path:"output.default_format",kind:"string",choices:["toon","json"],summary:"Default output format for commands that support it: toon or json."},{key:"ux_deprecation_hints",path:"ux.deprecation_hints",kind:"boolean",summary:"Emit one stderr migration hint for deprecated command aliases."},{key:"locks_ttl_seconds",path:"locks.ttl_seconds",kind:"integer",min:1,summary:"Claim/lock time-to-live in seconds before a stale lock can be reclaimed."},{key:"locks_wait_ms",path:"locks.wait_ms",kind:"integer",min:0,summary:"Bounded jittered wait in milliseconds before a contended item mutation fails with lock_conflict; 0 fails fast. PM_LOCK_WAIT_MS overrides per invocation."},{key:"ids_token_length",path:"ids.token_length",kind:"integer",min:4,max:12,summary:"Random base36 token length for newly minted item ids (4-12, default 4). Raise it to shrink cross-branch id collision odds in concurrent multi-agent workflows (pm-pibw)."},{key:"checkpoints_retention_days",path:"checkpoints.retention_days",kind:"integer",min:1,summary:"Age in days above which pm gc --scope checkpoints prunes bulk-mutation rollback checkpoints."},{key:"schema_unknown_field_policy",path:"schema.unknown_field_policy",kind:"string",choices:["allow","warn","reject"],summary:"How item I/O handles metadata keys not in the field registry: allow, warn, or reject."},{key:"history_compact_policy_enabled",path:"history.compact_policy.enabled",kind:"boolean",summary:"Enable the history-compaction advisory: pm health warns on over-threshold streams."},{key:"history_compact_policy_max_entries",path:"history.compact_policy.max_entries",kind:"integer",min:1,summary:"Entry count above which a history stream is flagged (and the default pm history-compact --all-over threshold)."},{key:"history_compact_policy_trigger",path:"history.compact_policy.trigger",kind:"string",choices:["health_warn","auto"],summary:"History-compaction policy intent: health_warn (advisory only) or auto (scheduled sweeps expected)."}];const DESCRIPTOR_BY_KEY=new Map(NESTED_SETTING_DESCRIPTORS.flatMap(descriptor=>[[descriptor.key,descriptor],[descriptor.path.toLowerCase().replaceAll("-","_"),descriptor]]));function resolveNestedSettingDescriptor(raw){if(typeof raw!=="string"){return void 0}const normalized=raw.trim().toLowerCase().replaceAll("-","_");if(normalized.length===0){return void 0}return DESCRIPTOR_BY_KEY.get(normalized)}function parseNestedBooleanValue(descriptor,rawValue){const normalized=rawValue.trim().toLowerCase();if(normalized==="true"||normalized==="1"||normalized==="yes"||normalized==="on"){return{ok:true,parsed:{descriptor,value:true}}}if(normalized==="false"||normalized==="0"||normalized==="no"||normalized==="off"){return{ok:true,parsed:{descriptor,value:false}}}return{ok:false,error:{message:`Config set ${descriptor.key} requires a boolean value (true|false), got "${rawValue}"`}}}function parseNestedStringValue(descriptor,rawValue,trimmed){if(descriptor.non_empty===true&&trimmed.length===0){return{ok:false,error:{message:`Config set ${descriptor.key} requires a non-empty value`}}}if(descriptor.choices&&!descriptor.choices.includes(trimmed)){return{ok:false,error:{message:`Config set ${descriptor.key} must be one of ${descriptor.choices.join("|")}, got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value:trimmed}}}function parseFiniteNestedNumber(descriptor,rawValue,trimmed){if(trimmed.length===0){return{ok:false,error:{message:`Config set ${descriptor.key} requires a non-empty value`}}}const parsed=Number(trimmed);if(!Number.isFinite(parsed)){return{ok:false,error:{message:`Config set ${descriptor.key} requires a finite number, got "${rawValue}"`}}}return{ok:true,value:parsed}}function parseNestedIntegerValue(descriptor,rawValue,value){if(!Number.isInteger(value)||value<0){return{ok:false,error:{message:`Config set ${descriptor.key} requires a non-negative integer, got "${rawValue}"`}}}if(descriptor.min!==void 0&&value<descriptor.min){return{ok:false,error:{message:`Config set ${descriptor.key} requires an integer >= ${descriptor.min}, got "${rawValue}" (the runtime silently ignores 0 here and falls back to the default)`}}}if(descriptor.max!==void 0&&value>descriptor.max){return{ok:false,error:{message:`Config set ${descriptor.key} requires an integer <= ${descriptor.max}, got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value}}}function parseNestedRatioValue(descriptor,rawValue,value){if(value<0||value>1){return{ok:false,error:{message:`Config set ${descriptor.key} requires a number in [0, 1], got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value}}}function parseNestedNumberValue(descriptor,rawValue,value){if(descriptor.min!==void 0&&value<descriptor.min){return{ok:false,error:{message:`Config set ${descriptor.key} requires a number >= ${descriptor.min}, got "${rawValue}"`}}}return{ok:true,parsed:{descriptor,value}}}function parseNestedSettingValue(descriptor,rawValue){if(typeof rawValue!=="string"){return{ok:false,error:{message:`Config set ${descriptor.key} requires a string value`}}}const trimmed=rawValue.trim();if(descriptor.kind==="boolean"){return parseNestedBooleanValue(descriptor,rawValue)}if(descriptor.kind==="string"){return parseNestedStringValue(descriptor,rawValue,trimmed)}const parsed=parseFiniteNestedNumber(descriptor,rawValue,trimmed);if(!parsed.ok){return{ok:false,error:parsed.error}}if(descriptor.kind==="integer"){return parseNestedIntegerValue(descriptor,rawValue,parsed.value)}if(descriptor.kind==="ratio"){return parseNestedRatioValue(descriptor,rawValue,parsed.value)}return parseNestedNumberValue(descriptor,rawValue,parsed.value)}function readNestedSettingValue(settings,descriptor){const segments=descriptor.path.split(".");let cursor=settings;for(const segment of segments){if(typeof cursor!=="object"||cursor===null){return null}const property=Object.getOwnPropertyDescriptor(cursor,segment);if(!property||!Object.hasOwn(property,"value")){return null}cursor=property.value}if(typeof cursor==="string"||typeof cursor==="number"||typeof cursor==="boolean"){return cursor}return null}function writeNestedSettingValue(settings,descriptor,value){const segments=descriptor.path.split(".");if(segments.some(segment=>segment.length===0||["__proto__","constructor","prototype"].includes(segment))){throw new Error("Unsafe settings path")}let cursor=settings;for(let index=0;index<segments.length-1;index+=1){const segment=segments[index];const existing=Object.getOwnPropertyDescriptor(cursor,segment)?.value;if(typeof existing!=="object"||existing===null||Array.isArray(existing)){const next={};Object.defineProperty(cursor,segment,{value:next,writable:true,enumerable:true,configurable:true});cursor=next}else{cursor=existing}}const leafKey=segments[segments.length-1];const previous=Object.getOwnPropertyDescriptor(cursor,leafKey)?.value;if(previous===value){return false}Object.defineProperty(cursor,leafKey,{value,writable:true,enumerable:true,configurable:true});return true}export{NESTED_SETTING_DESCRIPTORS,parseNestedSettingValue,readNestedSettingValue,resolveNestedSettingDescriptor,writeNestedSettingValue};
+(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]="2ae4f6da-17c5-5024-89a2-bb0a4be9a683")}catch{}})();const NESTED_SETTING_DESCRIPTORS=[{key:"search_provider",path:"search.provider",kind:"string",summary:"Search embedding provider name (e.g. openai, ollama, or an extension provider)."},{key:"search_default_mode",path:"search.default_mode",kind:"string",choices:["auto","keyword","semantic","hybrid"],summary:"Mode a bare pm search runs in: auto (hybrid when semantic search is explicitly configured and runnable, else keyword), or a pinned keyword, semantic, or hybrid."},{key:"search_mutation_refresh_policy",path:"search.mutation_refresh_policy",kind:"string",choices:["cache_only","semantic_configured","semantic_auto"],summary:"Mutation-time search refresh policy: cache_only, semantic_configured, or semantic_auto."},{key:"search_query_expansion_enabled",path:"search.query_expansion.enabled",kind:"boolean",summary:"Enable or disable query expansion for semantic/hybrid search."},{key:"search_query_expansion_provider",path:"search.query_expansion.provider",kind:"string",summary:"Query expansion provider name (built-in openai/ollama or extension provider)."},{key:"search_rerank_enabled",path:"search.rerank.enabled",kind:"boolean",summary:"Enable or disable post-retrieval reranking for hybrid search."},{key:"search_rerank_model",path:"search.rerank.model",kind:"string",summary:"Rerank model name override used by built-in providers."},{key:"search_rerank_top_k",path:"search.rerank.top_k",kind:"integer",min:1,summary:"Number of top hybrid candidates to rerank when rerank is enabled."},{key:"search_embedding_model",path:"search.embedding_model",kind:"string",summary:"Default embedding model name (overrides provider-specific model when set)."},{key:"search_embedding_corpus_max_characters",path:"search.embedding_corpus_max_characters",kind:"integer",min:1,summary:"Maximum semantic corpus characters per item before truncation."},{key:"search_embedding_batch_size",path:"search.embedding_batch_size",kind:"integer",min:1,summary:"Number of items embedded per request batch."},{key:"search_embedding_timeout_ms",path:"search.embedding_timeout_ms",kind:"integer",min:1,summary:"Per-request embedding timeout in milliseconds."},{key:"search_score_threshold",path:"search.score_threshold",kind:"number",summary:"Minimum score for a hit to be returned (0 keeps all matches)."},{key:"search_hybrid_semantic_weight",path:"search.hybrid_semantic_weight",kind:"ratio",summary:"Hybrid mode semantic weight in [0, 1] (1-weight goes to keyword)."},{key:"search_max_results",path:"search.max_results",kind:"integer",min:1,summary:"Default upper bound on search hits when --limit is not supplied."},{key:"search_bm25_k1",path:"search.bm25.k1",kind:"number",min:0,summary:"Offline BM25 term-frequency saturation (k1); higher saturates repeated terms slower (default 1.2)."},{key:"search_bm25_b",path:"search.bm25.b",kind:"ratio",summary:"Offline BM25 document-length normalization (b) in [0, 1]; 0 disables, 1 fully normalizes (default 0.75)."},{key:"openai_base_url",path:"providers.openai.base_url",kind:"string",summary:"OpenAI-compatible API base URL (LM Studio/vLLM also use this)."},{key:"openai_api_key",path:"providers.openai.api_key",kind:"string",summary:"OpenAI-compatible API key."},{key:"openai_model",path:"providers.openai.model",kind:"string",summary:"OpenAI-compatible embedding model name."},{key:"ollama_base_url",path:"providers.ollama.base_url",kind:"string",summary:"Ollama API base URL (typically http://localhost:11434)."},{key:"ollama_model",path:"providers.ollama.model",kind:"string",summary:"Ollama embedding model name (e.g. nomic-embed-text)."},{key:"vector_store_adapter",path:"vector_store.adapter",kind:"string",summary:"Vector store adapter name (lancedb, qdrant, or an extension adapter)."},{key:"vector_store_collection_name",path:"vector_store.collection_name",kind:"string",non_empty:!0,summary:"Vector collection/table name shared by Qdrant and LanceDB adapters."},{key:"qdrant_url",path:"vector_store.qdrant.url",kind:"string",summary:"Qdrant HTTP API URL."},{key:"qdrant_api_key",path:"vector_store.qdrant.api_key",kind:"string",summary:"Qdrant API key (empty if running unauthenticated)."},{key:"lancedb_path",path:"vector_store.lancedb.path",kind:"string",summary:"LanceDB storage path (relative to pm root or absolute)."},{key:"id_prefix",path:"id_prefix",kind:"string",non_empty:!0,summary:'Prefix for generated item IDs (e.g. "pm" produces pm-xxxx).'},{key:"author_default",path:"author_default",kind:"string",non_empty:!0,summary:"Default author recorded on mutations when --author is not supplied."},{key:"agent_identity_probes_enabled",path:"agent_identity.probes_enabled",kind:"boolean",summary:"Allow privacy-bounded local harness provenance probes; no network or subprocess access is permitted."},{key:"mutation_guard_require_attributed_author",path:"mutation_guard.require_attributed_author",kind:"boolean",summary:"Reject mutations whose effective author resolves to unknown."},{key:"mutation_guard_secret_guard",path:"mutation_guard.secret_guard",kind:"string",choices:["off","advise","block"],summary:"Detect credential-shaped mutation content: off, advise, or block."},{key:"mutation_guard_stale_in_progress_hours",path:"mutation_guard.stale_in_progress_hours",kind:"integer",min:1,summary:"Age threshold for unclaimed in-progress work surfaced by health."},{key:"governance_duplicate_detection_mode",path:"governance.duplicate_detection_mode",kind:"string",choices:["off","advisory","strict"],summary:"Create/copy duplicate governance: off, advisory, or strict explicit-bypass enforcement."},{key:"governance_duplicate_detection_threshold",path:"governance.duplicate_detection_threshold",kind:"ratio",summary:"Minimum shared similarity score in [0, 1] for create/copy duplicate governance."},{key:"governance_duplicate_detection_limit",path:"governance.duplicate_detection_limit",kind:"integer",min:0,max:20,summary:"Maximum likely duplicates returned by create/copy governance (0-20)."},{key:"output_default_format",path:"output.default_format",kind:"string",choices:["toon","json"],summary:"Default output format for commands that support it: toon or json."},{key:"ux_deprecation_hints",path:"ux.deprecation_hints",kind:"boolean",summary:"Emit one stderr migration hint for deprecated command aliases."},{key:"locks_ttl_seconds",path:"locks.ttl_seconds",kind:"integer",min:1,summary:"Claim/lock time-to-live in seconds before a stale lock can be reclaimed."},{key:"locks_wait_ms",path:"locks.wait_ms",kind:"integer",min:0,summary:"Bounded jittered wait in milliseconds before a contended item mutation fails with lock_conflict; 0 fails fast. PM_LOCK_WAIT_MS overrides per invocation."},{key:"ids_token_length",path:"ids.token_length",kind:"integer",min:4,max:12,summary:"Random base36 token length for newly minted item ids (4-12, default 4). Raise it to shrink cross-branch id collision odds in concurrent multi-agent workflows (pm-pibw)."},{key:"checkpoints_retention_days",path:"checkpoints.retention_days",kind:"integer",min:1,summary:"Age in days above which pm gc --scope checkpoints prunes bulk-mutation rollback checkpoints."},{key:"schema_unknown_field_policy",path:"schema.unknown_field_policy",kind:"string",choices:["allow","warn","reject"],summary:"How item I/O handles metadata keys not in the field registry: allow, warn, or reject."},{key:"history_compact_policy_enabled",path:"history.compact_policy.enabled",kind:"boolean",summary:"Enable the history-compaction advisory: pm health warns on over-threshold streams."},{key:"history_compact_policy_max_entries",path:"history.compact_policy.max_entries",kind:"integer",min:1,summary:"Entry count above which a history stream is flagged (and the default pm history-compact --all-over threshold)."},{key:"history_compact_policy_trigger",path:"history.compact_policy.trigger",kind:"string",choices:["health_warn","auto"],summary:"History-compaction policy intent: health_warn (advisory only) or auto (scheduled sweeps expected)."}],DESCRIPTOR_BY_KEY=new Map(NESTED_SETTING_DESCRIPTORS.flatMap(descriptor=>[[descriptor.key,descriptor],[descriptor.path.toLowerCase().replaceAll("-","_"),descriptor]]));function resolveNestedSettingDescriptor(raw){if(typeof raw!="string")return;const normalized=raw.trim().toLowerCase().replaceAll("-","_");if(normalized.length!==0)return DESCRIPTOR_BY_KEY.get(normalized)}function parseNestedBooleanValue(descriptor,rawValue){const normalized=rawValue.trim().toLowerCase();return normalized==="true"||normalized==="1"||normalized==="yes"||normalized==="on"?{ok:!0,parsed:{descriptor,value:!0}}:normalized==="false"||normalized==="0"||normalized==="no"||normalized==="off"?{ok:!0,parsed:{descriptor,value:!1}}:{ok:!1,error:{message:`Config set ${descriptor.key} requires a boolean value (true|false), got "${rawValue}"`}}}function parseNestedStringValue(descriptor,rawValue,trimmed){return descriptor.non_empty===!0&&trimmed.length===0?{ok:!1,error:{message:`Config set ${descriptor.key} requires a non-empty value`}}:descriptor.choices&&!descriptor.choices.includes(trimmed)?{ok:!1,error:{message:`Config set ${descriptor.key} must be one of ${descriptor.choices.join("|")}, got "${rawValue}"`}}:{ok:!0,parsed:{descriptor,value:trimmed}}}function parseFiniteNestedNumber(descriptor,rawValue,trimmed){if(trimmed.length===0)return{ok:!1,error:{message:`Config set ${descriptor.key} requires a non-empty value`}};const parsed=Number(trimmed);return Number.isFinite(parsed)?{ok:!0,value:parsed}:{ok:!1,error:{message:`Config set ${descriptor.key} requires a finite number, got "${rawValue}"`}}}function parseNestedIntegerValue(descriptor,rawValue,value){return!Number.isInteger(value)||value<0?{ok:!1,error:{message:`Config set ${descriptor.key} requires a non-negative integer, got "${rawValue}"`}}:descriptor.min!==void 0&&value<descriptor.min?{ok:!1,error:{message:`Config set ${descriptor.key} requires an integer >= ${descriptor.min}, got "${rawValue}" (the runtime silently ignores 0 here and falls back to the default)`}}:descriptor.max!==void 0&&value>descriptor.max?{ok:!1,error:{message:`Config set ${descriptor.key} requires an integer <= ${descriptor.max}, got "${rawValue}"`}}:{ok:!0,parsed:{descriptor,value}}}function parseNestedRatioValue(descriptor,rawValue,value){return value<0||value>1?{ok:!1,error:{message:`Config set ${descriptor.key} requires a number in [0, 1], got "${rawValue}"`}}:{ok:!0,parsed:{descriptor,value}}}function parseNestedNumberValue(descriptor,rawValue,value){return descriptor.min!==void 0&&value<descriptor.min?{ok:!1,error:{message:`Config set ${descriptor.key} requires a number >= ${descriptor.min}, got "${rawValue}"`}}:{ok:!0,parsed:{descriptor,value}}}function parseNestedSettingValue(descriptor,rawValue){if(typeof rawValue!="string")return{ok:!1,error:{message:`Config set ${descriptor.key} requires a string value`}};const trimmed=rawValue.trim();if(descriptor.kind==="boolean")return parseNestedBooleanValue(descriptor,rawValue);if(descriptor.kind==="string")return parseNestedStringValue(descriptor,rawValue,trimmed);const parsed=parseFiniteNestedNumber(descriptor,rawValue,trimmed);return parsed.ok?descriptor.kind==="integer"?parseNestedIntegerValue(descriptor,rawValue,parsed.value):descriptor.kind==="ratio"?parseNestedRatioValue(descriptor,rawValue,parsed.value):parseNestedNumberValue(descriptor,rawValue,parsed.value):{ok:!1,error:parsed.error}}function readNestedSettingValue(settings,descriptor){const segments=descriptor.path.split(".");let cursor=settings;for(const segment of segments){if(typeof cursor!="object"||cursor===null)return null;const property=Object.getOwnPropertyDescriptor(cursor,segment);if(!property||!Object.hasOwn(property,"value"))return null;cursor=property.value}return typeof cursor=="string"||typeof cursor=="number"||typeof cursor=="boolean"?cursor:null}function writeNestedSettingValue(settings,descriptor,value){const segments=descriptor.path.split(".");if(segments.some(segment=>segment.length===0||["__proto__","constructor","prototype"].includes(segment)))throw new Error("Unsafe settings path");let cursor=settings;for(let index=0;index<segments.length-1;index+=1){const segment=segments[index],existing=Object.getOwnPropertyDescriptor(cursor,segment)?.value;if(typeof existing!="object"||existing===null||Array.isArray(existing)){const next={};Object.defineProperty(cursor,segment,{value:next,writable:!0,enumerable:!0,configurable:!0}),cursor=next}else cursor=existing}const leafKey=segments[segments.length-1];return Object.getOwnPropertyDescriptor(cursor,leafKey)?.value===value?!1:(Object.defineProperty(cursor,leafKey,{value,writable:!0,enumerable:!0,configurable:!0}),!0)}export{NESTED_SETTING_DESCRIPTORS,parseNestedSettingValue,readNestedSettingValue,resolveNestedSettingDescriptor,writeNestedSettingValue};
 //# sourceMappingURL=nested-settings.js.map

package/dist/core/config/positional-value.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="615d2313-d6ef-51e0-93eb-6234b2f0e6cd")}catch(e2){}})();const FORMAT_KEYS=new Set(["item_format"]);const CRITERIA_KEYS=new Set(["definition_of_done","metadata_required_fields","lifecycle_stale_blocker_reason_patterns","lifecycle_closure_like_blocked_reason_patterns","lifecycle_closure_like_resolution_patterns","lifecycle_closure_like_actual_result_patterns"]);const POLICY_KEYS=new Set(["history_missing_stream_policy","sprint_release_format_policy","parent_reference_policy","metadata_validation_profile","governance_preset","governance_ownership_enforcement","governance_create_mode_default","governance_close_validation_default","governance_require_close_reason","governance_create_default_type","governance_workflow_enforcement","governance_parent_reference_policy","governance_metadata_validation_profile","governance_force_required_for_stale_lock","test_result_tracking","untrusted_linked_test_execution","telemetry_tracking","agent_identity_vocabulary"]);const ENABLED_DISABLED_POLICY_KEYS=new Set(["governance_require_close_reason","governance_force_required_for_stale_lock","test_result_tracking","untrusted_linked_test_execution","telemetry_tracking"]);const ENABLED_DISABLED_SYNONYMS={off:"disabled",on:"enabled",true:"enabled",false:"disabled",enabled:"enabled",disabled:"disabled"};function toCanonicalKey(keyOrAlias){const normalized=keyOrAlias.trim().toLowerCase().replaceAll("-","_");if(FORMAT_KEYS.has(normalized)||CRITERIA_KEYS.has(normalized)||POLICY_KEYS.has(normalized)||normalized==="context"){return normalized}return void 0}function normalizeEnabledDisabled(value){const normalized=value.trim().toLowerCase();return ENABLED_DISABLED_SYNONYMS[normalized]??value}function resolveConfigPositionalValue(canonicalKeyOrAlias,value){const key=toCanonicalKey(canonicalKeyOrAlias);if(key===void 0){return{routable:false,reason:`Unknown config key "${canonicalKeyOrAlias}" cannot route a positional value.`}}if(key==="context"){return{routable:false,reason:"Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags."}}if(FORMAT_KEYS.has(key)){return{routable:true,flag:"format",value}}if(CRITERIA_KEYS.has(key)){return{routable:true,flag:"criterion",values:[value]}}const policyValue=ENABLED_DISABLED_POLICY_KEYS.has(key)?normalizeEnabledDisabled(value):value;return{routable:true,flag:"policy",value:policyValue}}export{resolveConfigPositionalValue};
+(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]="78e92b9c-f3da-594e-8158-00409222308f")}catch{}})();const FORMAT_KEYS=new Set(["item_format"]),CRITERIA_KEYS=new Set(["definition_of_done","metadata_required_fields","lifecycle_stale_blocker_reason_patterns","lifecycle_closure_like_blocked_reason_patterns","lifecycle_closure_like_resolution_patterns","lifecycle_closure_like_actual_result_patterns"]),POLICY_KEYS=new Set(["history_missing_stream_policy","sprint_release_format_policy","parent_reference_policy","metadata_validation_profile","governance_preset","governance_ownership_enforcement","governance_create_mode_default","governance_close_validation_default","governance_require_close_reason","governance_create_default_type","governance_workflow_enforcement","governance_parent_reference_policy","governance_metadata_validation_profile","governance_force_required_for_stale_lock","test_result_tracking","untrusted_linked_test_execution","telemetry_tracking","agent_identity_vocabulary"]),ENABLED_DISABLED_POLICY_KEYS=new Set(["governance_require_close_reason","governance_force_required_for_stale_lock","test_result_tracking","untrusted_linked_test_execution","telemetry_tracking"]),ENABLED_DISABLED_SYNONYMS={off:"disabled",on:"enabled",true:"enabled",false:"disabled",enabled:"enabled",disabled:"disabled"};function toCanonicalKey(keyOrAlias){const normalized=keyOrAlias.trim().toLowerCase().replaceAll("-","_");if(FORMAT_KEYS.has(normalized)||CRITERIA_KEYS.has(normalized)||POLICY_KEYS.has(normalized)||normalized==="context")return normalized}function normalizeEnabledDisabled(value){const normalized=value.trim().toLowerCase();return ENABLED_DISABLED_SYNONYMS[normalized]??value}function resolveConfigPositionalValue(canonicalKeyOrAlias,value){const key=toCanonicalKey(canonicalKeyOrAlias);return key===void 0?{routable:!1,reason:`Unknown config key "${canonicalKeyOrAlias}" cannot route a positional value.`}:key==="context"?{routable:!1,reason:"Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags."}:FORMAT_KEYS.has(key)?{routable:!0,flag:"format",value}:CRITERIA_KEYS.has(key)?{routable:!0,flag:"criterion",values:[value]}:{routable:!0,flag:"policy",value:ENABLED_DISABLED_POLICY_KEYS.has(key)?normalizeEnabledDisabled(value):value}}export{resolveConfigPositionalValue};
 //# sourceMappingURL=positional-value.js.map

package/dist/core/diagnostics/remediation.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fac6b840-f5f1-51f6-b643-99b48ac864ba")}catch(e2){}})();const REMEDIATION_REGISTRY=Object.freeze([{code:"missing_directory",command:"pm init",summary:"Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."},{code:"settings_read_fs_error",command:"pm config list --json",summary:"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run."},{code:"settings_read_invalid_json",command:"pm config list --json",summary:"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."},{code:"settings_read_invalid_schema",command:"pm config list --json",summary:"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."},{code:"settings_read_merge_failed",command:"pm config list --json",summary:"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."},{code:"settings:id_prefix_empty",command:"pm config list --json",summary:'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'},{code:"settings:locks_ttl_non_positive",command:"pm config list --json",summary:'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'},{code:"telemetry_state_invalid_json",command:"pm health --check-telemetry",summary:"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."},{code:"telemetry_queue_invalid_rows",command:"pm health --check-telemetry",summary:"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."},{code:"telemetry_queue_pending",command:"pm health --check-telemetry",summary:"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."},{code:"telemetry_queue_high_retries",command:"pm telemetry flush",summary:"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."},{code:"telemetry_endpoint_probe_failed",command:"pm health --check-telemetry",summary:"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."},{code:"telemetry_endpoint_probe_http_status",command:"pm health --check-telemetry",summary:"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."},{code:"telemetry_schema_version_behind",command:"pm health --check-telemetry",summary:"Client schema is behind server; upgrade pm-cli to emit the latest event shape."},{code:"telemetry_otel_export_failing",command:"pm health --check-telemetry",summary:"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."},{code:"merge_driver_configuration_missing",command:"pm merge install",summary:"Install the clone-local Git drivers required by the tracker merge fence."},{code:"merge_driver_configuration_drift",command:"pm merge install",summary:"Reinstall clone-local Git drivers after runtime or package paths change."},{code:"merge_fence_missing",command:"pm merge install",summary:"Install the active tracker's committed Git merge attributes."},{code:"merge_fence_drift",command:"pm merge install",summary:"Restore the active tracker's merge mappings while retaining sibling tracker fences."},{code:"validate_merge_driver_configuration",command:"pm merge install",summary:"Restore missing or drifted clone-local Git merge driver commands."},{code:"integrity_item_unreadable",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file could not be read; restore or repair the file at the reported path."},{code:"integrity_item_parse_failed",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file failed to parse; fix the malformed item metadata at the reported path."},{code:"integrity_item_conflict_marker",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."},{code:"integrity_history_unreadable",command:"pm history-repair <id>",summary:"A history stream could not be read; re-anchor the affected item's history chain."},{code:"integrity_history_invalid_json",command:"pm history-repair <id>",summary:"A history stream contains invalid JSON; re-anchor the affected item's history chain."},{code:"integrity_history_conflict_marker",command:"pm history-repair <id>",summary:"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."},{code:"validate_storage_unreadable_items",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path \u2014 list commands silently skip it while pm get hard-errors."},{code:"validate_storage_duplicate_item_ids",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"One item id is claimed by multiple item documents \u2014 usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work."},{code:"validate_storage_history_conflict_markers",command:"pm merge driver history <base> <ours> <theirs>",summary:"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item."},{code:"validate_storage_unparseable_history",command:"pm history-repair <id>",summary:"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations."},{code:"validate_storage_resurrected_items",command:"pm delete <id>",summary:"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner \u2014 re-delete the item, or keep it and append a mutation documenting the revival."},{code:"validate_storage_unparseable_config",command:"pm merge driver json <base> <ours> <theirs>",summary:"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate."},{code:"validate_merge_fence_drift",command:"pm merge install",summary:"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver."},{code:"validate_storage_tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command, commit the index-only removals and managed .gitignore fence, then rerun validation."},{code:"integrity_item_outdated_format_version",command:"pm validate --verbose-diagnostics",summary:"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."},{code:"integrity_item_ahead_format_version",command:"npm install -g @unbrained/pm-cli@latest",summary:"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."},{code:"tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command from the integrity check, commit the index-only removals, and keep the managed .gitignore fence."},{code:"merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts, re-apply any intended discarded values, then run pm merge reconcile; lossy receipts require explicit --force acceptance."},{code:"merge_receipts_pending",command:"pm merge reconcile",summary:"A lossless merge receipt is still pending; run pm merge reconcile to settle it (optionally preview first with --dry-run) so a green health gate certifies receipt settlement, not only intact data."},{code:"merge_receipt_evidence_invalid",command:"pm merge report --include-reconciled --json",summary:"One or more receipt candidates failed bounded-file, schema, identity, or copy-consistency validation; inspect the report's privacy-safe source, receipt id, and reason before repairing only the named evidence."},{code:"merge_receipt_history_reference_missing",command:"pm merge reconcile --dry-run",summary:"Review the bounded coordinates and recover available evidence first; for exact pre-durable clone-local-only references, rerun with --force so pm appends an audited disposition and proves the health finding is cleared without rewriting history."},{code:"validate_merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts before reconciliation; history-repair alone does not settle them, and lossy receipts require explicit --force acceptance."},{code:"history_drift_missing_stream",command:"pm history-repair <id>",summary:"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_unreadable_stream",command:"pm history-repair <id>",summary:"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_hash_mismatch",command:"pm history-repair <id>",summary:"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_chain_mismatch",command:"pm history-repair <id>",summary:"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_version_skew",command:"npm install -g @unbrained/pm-cli@latest",summary:"A history stream declares an item hash version this runtime does not support; upgrade pm to verify the chain instead of re-anchoring it."},{code:"history_drift_merge_receipt",command:"pm merge reconcile",summary:"Canonical path, changed-field, and merged-value hash evidence attributes this drift to a pending receipt; run reconciliation (optionally preview first with --dry-run) instead of repairing history directly."},{code:"history_stream_over_compact_threshold",command:"pm history-compact <id>",summary:"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."},{code:"history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"provenance_value_domain_invalid",command:"pm history-repair --all --normalize-provenance",summary:"Remove invalid bounded provenance observations from affected streams and append privacy-safe aggregate repair receipts."},{code:"validate_history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"locks_stale_count",command:"pm gc --scope locks",summary:"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."},{code:"locks_unreadable",command:"pm gc --scope locks --dry-run",summary:"Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."},{code:"extension_update_health_partial_coverage",command:"pm extension --adopt-all --project",summary:"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."},{code:"vectorization_stale_items_remaining",command:"pm health --refresh-vectors",summary:"Some items have stale embeddings; refresh vectors so semantic search results stay current."},{code:"vectorization_embedding_identity_changed",command:"pm reindex --mode semantic",summary:"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."},{code:"validate_metadata_missing_closed_at",command:"pm validate --check-metadata --auto-fix --fix-scope timestamps --dry-run",summary:"Preview closure dates proven by verified lifecycle history; inspect residuals and omit --dry-run to apply only proven dates."},{code:"validate_metadata_missing_acceptance_criteria",command:'pm update <id> --acceptance-criteria "<criteria>"',summary:"Backfill the missing acceptance criteria on the reported item(s)."},{code:"validate_metadata_missing_estimate",command:'pm update <id> --estimate "<estimate>"',summary:"Backfill the missing estimate on the reported item(s)."},{code:"validate_metadata_missing_close_reason",command:'pm update <id> --close-reason "<reason>"',summary:"Backfill the missing close reason on the reported closed item(s)."},{code:"validate_metadata_missing_reviewer",command:'pm update <id> --reviewer "<name>"',summary:"Backfill the missing reviewer on the reported item(s)."},{code:"validate_metadata_missing_risk",command:'pm update <id> --risk "<level>"',summary:"Backfill the missing risk on the reported item(s)."},{code:"validate_metadata_missing_confidence",command:'pm update <id> --confidence "<level>"',summary:"Backfill the missing confidence on the reported item(s)."},{code:"validate_metadata_missing_sprint",command:'pm update <id> --sprint "<sprint>"',summary:"Backfill the missing sprint on the reported item(s)."},{code:"validate_metadata_missing_release",command:'pm update <id> --release "<release>"',summary:"Backfill the missing release on the reported item(s)."},{code:"validate_metadata_custom_profile_missing_required_fields",command:'pm config set metadata-required-fields --criterion "<field>"',summary:"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."},{code:"validate_metadata_duplicate_issue_codes",command:'pm update <id> --title "<distinct title>"',summary:"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."},{code:"validate_resolution_missing_fields",command:'pm update <id> --resolution "<how resolved>"',summary:"Backfill resolution / expected_result / actual_result on the reported closed item(s)."},{code:"validate_lifecycle_active_closure_like_metadata",command:"pm update <id> --unset <closure-like-field>",summary:"Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."},{code:"validate_lifecycle_active_terminal_parent",command:"pm update <id> --parent <active-parent-id>",summary:"Reopen the terminal parent or move the active child under a non-terminal parent."},{code:"validate_lifecycle_stale_blockers",command:"pm update <id> --unset blocked-by --unset blocked-reason",summary:"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."},{code:"validate_lifecycle_dependency_cycles_error",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_lifecycle_dependency_cycles",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_hierarchy_parent_cycle_error",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_hierarchy_parent_cycle",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_files_missing_linked_paths",command:"pm <files|docs> <id> --remove <path>",summary:"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."},{code:"validate_files_orphaned_paths",command:"pm <files|docs> <id> --add <path>",summary:"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."},{code:"validate_files_tracked_all_strict_forces_pm_internals",command:"pm validate --check-files --include-pm-internals",summary:"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."},{code:"validate_history_drift_missing_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items missing a history stream."},{code:"validate_history_drift_unreadable_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with an unreadable history stream."},{code:"validate_history_drift_hash_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items whose content hash drifted."},{code:"validate_history_drift_chain_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with a broken history chain."},{code:"validate_history_drift_version_skews",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more history streams declare an item hash version this runtime does not support; upgrade pm to verify the chains instead of re-anchoring them."},{code:"validate_command_references_stale_pm_ids",command:'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',summary:"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."},{code:"validate_format_version_outdated_items",command:"pm validate --verbose-diagnostics",summary:"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."},{code:"validate_format_version_ahead_items",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."}]);function resolveRemediation(warning){if(typeof warning!=="string"){return void 0}const normalized=warning.trim();for(const entry of REMEDIATION_REGISTRY){if(normalized===entry.code||normalized.startsWith(`${entry.code}:`)){return entry}}return void 0}function buildRemediationMap(warnings){const map={};for(const warning of warnings){const entry=resolveRemediation(warning);if(entry!==void 0&&!Object.prototype.hasOwnProperty.call(map,entry.code)){map[entry.code]=entry.command}}return map}function buildRemediationCommands(warnings){return Object.values(buildRemediationMap(warnings))}export{REMEDIATION_REGISTRY,buildRemediationCommands,buildRemediationMap,resolveRemediation};
+(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]="3d7db45e-123f-596b-afc7-b698f2b2f45c")}catch{}})();const REMEDIATION_REGISTRY=Object.freeze([{code:"missing_directory",command:"pm init",summary:"Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."},{code:"settings_read_fs_error",command:"pm config list --json",summary:"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run."},{code:"settings_read_invalid_json",command:"pm config list --json",summary:"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."},{code:"settings_read_invalid_schema",command:"pm config list --json",summary:"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."},{code:"settings_read_merge_failed",command:"pm config list --json",summary:"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."},{code:"settings:id_prefix_empty",command:"pm config list --json",summary:'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'},{code:"settings:locks_ttl_non_positive",command:"pm config list --json",summary:'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'},{code:"telemetry_state_invalid_json",command:"pm health --check-telemetry",summary:"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."},{code:"telemetry_queue_invalid_rows",command:"pm health --check-telemetry",summary:"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."},{code:"telemetry_queue_pending",command:"pm health --check-telemetry",summary:"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."},{code:"telemetry_queue_high_retries",command:"pm telemetry flush",summary:"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."},{code:"telemetry_endpoint_probe_failed",command:"pm health --check-telemetry",summary:"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."},{code:"telemetry_endpoint_probe_http_status",command:"pm health --check-telemetry",summary:"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."},{code:"telemetry_schema_version_behind",command:"pm health --check-telemetry",summary:"Client schema is behind server; upgrade pm-cli to emit the latest event shape."},{code:"telemetry_otel_export_failing",command:"pm health --check-telemetry",summary:"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."},{code:"merge_driver_configuration_missing",command:"pm merge install",summary:"Install the clone-local Git drivers required by the tracker merge fence."},{code:"merge_driver_configuration_drift",command:"pm merge install",summary:"Reinstall clone-local Git drivers after runtime or package paths change."},{code:"merge_fence_missing",command:"pm merge install",summary:"Install the active tracker's committed Git merge attributes."},{code:"merge_fence_drift",command:"pm merge install",summary:"Restore the active tracker's merge mappings while retaining sibling tracker fences."},{code:"validate_merge_driver_configuration",command:"pm merge install",summary:"Restore missing or drifted clone-local Git merge driver commands."},{code:"integrity_item_unreadable",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file could not be read; restore or repair the file at the reported path."},{code:"integrity_item_parse_failed",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file failed to parse; fix the malformed item metadata at the reported path."},{code:"integrity_item_conflict_marker",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."},{code:"integrity_history_unreadable",command:"pm history-repair <id>",summary:"A history stream could not be read; re-anchor the affected item's history chain."},{code:"integrity_history_invalid_json",command:"pm history-repair <id>",summary:"A history stream contains invalid JSON; re-anchor the affected item's history chain."},{code:"integrity_history_conflict_marker",command:"pm history-repair <id>",summary:"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."},{code:"validate_storage_unreadable_items",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path \u2014 list commands silently skip it while pm get hard-errors."},{code:"validate_storage_duplicate_item_ids",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"One item id is claimed by multiple item documents \u2014 usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work."},{code:"validate_storage_history_conflict_markers",command:"pm merge driver history <base> <ours> <theirs>",summary:"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item."},{code:"validate_storage_unparseable_history",command:"pm history-repair <id>",summary:"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations."},{code:"validate_storage_resurrected_items",command:"pm delete <id>",summary:"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner \u2014 re-delete the item, or keep it and append a mutation documenting the revival."},{code:"validate_storage_unparseable_config",command:"pm merge driver json <base> <ours> <theirs>",summary:"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate."},{code:"validate_merge_fence_drift",command:"pm merge install",summary:"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver."},{code:"validate_storage_tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command, commit the index-only removals and managed .gitignore fence, then rerun validation."},{code:"integrity_item_outdated_format_version",command:"pm validate --verbose-diagnostics",summary:"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."},{code:"integrity_item_ahead_format_version",command:"npm install -g @unbrained/pm-cli@latest",summary:"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."},{code:"tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command from the integrity check, commit the index-only removals, and keep the managed .gitignore fence."},{code:"merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts, re-apply any intended discarded values, then run pm merge reconcile; lossy receipts require explicit --force acceptance."},{code:"merge_receipts_pending",command:"pm merge reconcile",summary:"A lossless merge receipt is still pending; run pm merge reconcile to settle it (optionally preview first with --dry-run) so a green health gate certifies receipt settlement, not only intact data."},{code:"merge_receipt_evidence_invalid",command:"pm merge report --include-reconciled --json",summary:"One or more receipt candidates failed bounded-file, schema, identity, or copy-consistency validation; inspect the report's privacy-safe source, receipt id, and reason before repairing only the named evidence."},{code:"merge_receipt_history_reference_missing",command:"pm merge reconcile --dry-run",summary:"Review the bounded coordinates and recover available evidence first; for exact pre-durable clone-local-only references, rerun with --force so pm appends an audited disposition and proves the health finding is cleared without rewriting history."},{code:"validate_merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts before reconciliation; history-repair alone does not settle them, and lossy receipts require explicit --force acceptance."},{code:"history_drift_missing_stream",command:"pm history-repair <id>",summary:"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_unreadable_stream",command:"pm history-repair <id>",summary:"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_hash_mismatch",command:"pm history-repair <id>",summary:"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_chain_mismatch",command:"pm history-repair <id>",summary:"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_version_skew",command:"npm install -g @unbrained/pm-cli@latest",summary:"A history stream declares an item hash version this runtime does not support; upgrade pm to verify the chain instead of re-anchoring it."},{code:"history_drift_merge_receipt",command:"pm merge reconcile",summary:"Canonical path, changed-field, and merged-value hash evidence attributes this drift to a pending receipt; run reconciliation (optionally preview first with --dry-run) instead of repairing history directly."},{code:"history_stream_over_compact_threshold",command:"pm history-compact <id>",summary:"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."},{code:"history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"provenance_value_domain_invalid",command:"pm history-repair --all --normalize-provenance",summary:"Remove invalid bounded provenance observations from affected streams and append privacy-safe aggregate repair receipts."},{code:"validate_history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"locks_stale_count",command:"pm gc --scope locks",summary:"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."},{code:"locks_unreadable",command:"pm gc --scope locks --dry-run",summary:"Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."},{code:"extension_update_health_partial_coverage",command:"pm extension --adopt-all --project",summary:"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."},{code:"vectorization_stale_items_remaining",command:"pm health --refresh-vectors",summary:"Some items have stale embeddings; refresh vectors so semantic search results stay current."},{code:"vectorization_embedding_identity_changed",command:"pm reindex --mode semantic",summary:"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."},{code:"validate_metadata_missing_closed_at",command:"pm validate --check-metadata --auto-fix --fix-scope timestamps --dry-run",summary:"Preview closure dates proven by verified lifecycle history; inspect residuals and omit --dry-run to apply only proven dates."},{code:"validate_metadata_missing_acceptance_criteria",command:'pm update <id> --acceptance-criteria "<criteria>"',summary:"Backfill the missing acceptance criteria on the reported item(s)."},{code:"validate_metadata_missing_estimate",command:'pm update <id> --estimate "<estimate>"',summary:"Backfill the missing estimate on the reported item(s)."},{code:"validate_metadata_missing_close_reason",command:'pm update <id> --close-reason "<reason>"',summary:"Backfill the missing close reason on the reported closed item(s)."},{code:"validate_metadata_missing_reviewer",command:'pm update <id> --reviewer "<name>"',summary:"Backfill the missing reviewer on the reported item(s)."},{code:"validate_metadata_missing_risk",command:'pm update <id> --risk "<level>"',summary:"Backfill the missing risk on the reported item(s)."},{code:"validate_metadata_missing_confidence",command:'pm update <id> --confidence "<level>"',summary:"Backfill the missing confidence on the reported item(s)."},{code:"validate_metadata_missing_sprint",command:'pm update <id> --sprint "<sprint>"',summary:"Backfill the missing sprint on the reported item(s)."},{code:"validate_metadata_missing_release",command:'pm update <id> --release "<release>"',summary:"Backfill the missing release on the reported item(s)."},{code:"validate_metadata_custom_profile_missing_required_fields",command:'pm config set metadata-required-fields --criterion "<field>"',summary:"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."},{code:"validate_metadata_duplicate_issue_codes",command:'pm update <id> --title "<distinct title>"',summary:"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."},{code:"validate_resolution_missing_fields",command:'pm update <id> --resolution "<how resolved>"',summary:"Backfill resolution / expected_result / actual_result on the reported closed item(s)."},{code:"validate_lifecycle_active_closure_like_metadata",command:"pm update <id> --unset <closure-like-field>",summary:"Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."},{code:"validate_lifecycle_active_terminal_parent",command:"pm update <id> --parent <active-parent-id>",summary:"Reopen the terminal parent or move the active child under a non-terminal parent."},{code:"validate_lifecycle_stale_blockers",command:"pm update <id> --unset blocked-by --unset blocked-reason",summary:"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."},{code:"validate_lifecycle_dependency_cycles_error",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_lifecycle_dependency_cycles",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_hierarchy_parent_cycle_error",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_hierarchy_parent_cycle",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_files_missing_linked_paths",command:"pm <files|docs> <id> --remove <path>",summary:"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."},{code:"validate_files_orphaned_paths",command:"pm <files|docs> <id> --add <path>",summary:"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."},{code:"validate_files_tracked_all_strict_forces_pm_internals",command:"pm validate --check-files --include-pm-internals",summary:"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."},{code:"validate_history_drift_missing_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items missing a history stream."},{code:"validate_history_drift_unreadable_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with an unreadable history stream."},{code:"validate_history_drift_hash_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items whose content hash drifted."},{code:"validate_history_drift_chain_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with a broken history chain."},{code:"validate_history_drift_version_skews",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more history streams declare an item hash version this runtime does not support; upgrade pm to verify the chains instead of re-anchoring them."},{code:"validate_command_references_stale_pm_ids",command:'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',summary:"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."},{code:"validate_format_version_outdated_items",command:"pm validate --verbose-diagnostics",summary:"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."},{code:"validate_format_version_ahead_items",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."}]);function resolveRemediation(warning){if(typeof warning!="string")return;const normalized=warning.trim();for(const entry of REMEDIATION_REGISTRY)if(normalized===entry.code||normalized.startsWith(`${entry.code}:`))return entry}function buildRemediationMap(warnings){const map={};for(const warning of warnings){const entry=resolveRemediation(warning);entry!==void 0&&!Object.prototype.hasOwnProperty.call(map,entry.code)&&(map[entry.code]=entry.command)}return map}function buildRemediationCommands(warnings){return Object.values(buildRemediationMap(warnings))}export{REMEDIATION_REGISTRY,buildRemediationCommands,buildRemediationMap,resolveRemediation};
 //# sourceMappingURL=remediation.js.map

package/dist/core/extensions/activation-summary-markdown.js

@@ -1,3 +1,4 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2bc00b8e-0d9f-5af8-9667-d46136ff52b0")}catch(e2){}})();const MIN_HEADING_LEVEL=1;const MAX_HEADING_LEVEL=6;const SURFACE_SECTIONS=[["commands","Commands"],["command_overrides","Command overrides"],["flag_commands","Flag commands"],["item_types","Item types"],["item_fields","Item fields"],["migrations","Migrations"],["profiles","Profiles"],["importers","Importers"],["exporters","Exporters"],["search_providers","Search providers"],["vector_store_adapters","Vector store adapters"],["assurance_providers","Assurance measurement providers"],["hooks","Lifecycle hooks"],["parser_overrides","Parser overrides"],["service_overrides","Service overrides"],["renderer_overrides","Renderer overrides"]];function headingPrefix(level){return"#".repeat(level)}function code(value){if(!value.includes("`")){return`\`${value}\``}let longestRun=0;let currentRun=0;for(const char of value){currentRun=char==="`"?currentRun+1:0;longestRun=Math.max(longestRun,currentRun)}const fence="`".repeat(longestRun+1);const pad=value.startsWith("`")||value.endsWith("`")?" ":"";return`${fence}${pad}${value}${pad}${fence}`}function renderCapabilitiesLine(capabilities){if(capabilities.length===0){return"Capabilities: _none registered_"}return`Capabilities: ${capabilities.map(code).join(", ")}`}function renderSection(heading,level,entries){const lines=[`${headingPrefix(level)} ${heading}`,""];if(entries.length===0){lines.push("_None._","");return lines}lines.push(...entries.map(entry=>`- ${code(entry)}`),"");return lines}function renderPreflightSection(count,level,includeEmpty){if(count===0&&!includeEmpty){return[]}return[`${headingPrefix(level)} Preflight overrides`,"",count>0?`- ${count} registered (this surface carries no per-entry identifier)`:"_None._",""]}function renderExtensionSurfaceMarkdown(summary,options={}){const titleLevel=options.headingLevel??2;if(!Number.isInteger(titleLevel)||titleLevel<MIN_HEADING_LEVEL||titleLevel>MAX_HEADING_LEVEL){throw new RangeError(`headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`)}const sectionLevel=Math.min(titleLevel+1,MAX_HEADING_LEVEL);const includeEmpty=options.includeEmpty===true;const title=options.title??"Extension surfaces";const lines=[`${headingPrefix(titleLevel)} ${title}`,""];if(includeEmpty||summary.capabilities.length>0){lines.push(renderCapabilitiesLine(summary.capabilities),"")}for(const[field,heading]of SURFACE_SECTIONS){const entries=summary[field]??[];if(entries.length===0&&!includeEmpty){continue}lines.push(...renderSection(heading,sectionLevel,entries))}lines.push(...renderPreflightSection(summary.preflight_overrides,sectionLevel,includeEmpty));const hasAnySurface=summary.preflight_overrides>0||SURFACE_SECTIONS.some(([field])=>(summary[field]?.length??0)>0);if(!hasAnySurface&&!includeEmpty){lines.push("_This extension registers no surfaces._","")}return`${lines.join("\n").trimEnd()}
+(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]="3984f1ef-1703-5a83-a4fa-ec1cdc738572")}catch{}})();const MIN_HEADING_LEVEL=1,MAX_HEADING_LEVEL=6,SURFACE_SECTIONS=[["commands","Commands"],["command_overrides","Command overrides"],["flag_commands","Flag commands"],["item_types","Item types"],["item_fields","Item fields"],["migrations","Migrations"],["profiles","Profiles"],["importers","Importers"],["exporters","Exporters"],["search_providers","Search providers"],["vector_store_adapters","Vector store adapters"],["assurance_providers","Assurance measurement providers"],["hooks","Lifecycle hooks"],["parser_overrides","Parser overrides"],["service_overrides","Service overrides"],["renderer_overrides","Renderer overrides"]];function headingPrefix(level){return"#".repeat(level)}function code(value){if(!value.includes("`"))return`\`${value}\``;let longestRun=0,currentRun=0;for(const char of value)currentRun=char==="`"?currentRun+1:0,longestRun=Math.max(longestRun,currentRun);const fence="`".repeat(longestRun+1),pad=value.startsWith("`")||value.endsWith("`")?" ":"";return`${fence}${pad}${value}${pad}${fence}`}function renderCapabilitiesLine(capabilities){return capabilities.length===0?"Capabilities: _none registered_":`Capabilities: ${capabilities.map(code).join(", ")}`}function renderSection(heading,level,entries){const lines=[`${headingPrefix(level)} ${heading}`,""];return entries.length===0?(lines.push("_None._",""),lines):(lines.push(...entries.map(entry=>`- ${code(entry)}`),""),lines)}function renderPreflightSection(count,level,includeEmpty){return count===0&&!includeEmpty?[]:[`${headingPrefix(level)} Preflight overrides`,"",count>0?`- ${count} registered (this surface carries no per-entry identifier)`:"_None._",""]}function renderExtensionSurfaceMarkdown(summary,options={}){const titleLevel=options.headingLevel??2;if(!Number.isInteger(titleLevel)||titleLevel<1||titleLevel>6)throw new RangeError(`headingLevel must be an integer in [1, 6], received ${String(options.headingLevel)}`);const sectionLevel=Math.min(titleLevel+1,6),includeEmpty=options.includeEmpty===!0,title=options.title??"Extension surfaces",lines=[`${headingPrefix(titleLevel)} ${title}`,""];(includeEmpty||summary.capabilities.length>0)&&lines.push(renderCapabilitiesLine(summary.capabilities),"");for(const[field,heading]of SURFACE_SECTIONS){const entries=summary[field]??[];entries.length===0&&!includeEmpty||lines.push(...renderSection(heading,sectionLevel,entries))}return lines.push(...renderPreflightSection(summary.preflight_overrides,sectionLevel,includeEmpty)),!(summary.preflight_overrides>0||SURFACE_SECTIONS.some(([field])=>(summary[field]?.length??0)>0))&&!includeEmpty&&lines.push("_This extension registers no surfaces._",""),`${lines.join(`
+`).trimEnd()}
 `}export{renderExtensionSurfaceMarkdown};
 //# sourceMappingURL=activation-summary-markdown.js.map

package/dist/core/extensions/activation-summary.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f7999053-cf48-5588-b8c8-570789086dac")}catch(e2){}})();import{collectUsedExtensionCapabilities,normalizeExtensionName}from"./capability-usage.js";const HOOK_REGISTRY_FIELD_TO_KIND=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function describeExtensionActivation(activation,options={}){const filters=new Set;if(options.extensionName!==void 0){filters.add(normalizeExtensionName(options.extensionName))}for(const name of options.extensionNames??[]){filters.add(normalizeExtensionName(name))}const matches=name=>filters.size===0||filters.has(normalizeExtensionName(name));const collect=(entries,identify)=>sortUnique(entries.filter(entry=>matches(entry.name)).map(identify));const collectFlat=(entries,expand)=>sortUnique(entries.filter(entry=>matches(entry.name)).flatMap(expand));const{registrations,commands,parsers,preflight,services,renderers,hooks}=activation;const relationshipKinds=collectFlat(registrations.relationship_kinds??[],entry=>entry.definitions.map(definition=>definition.kind));const rendererOwnership=renderers.overrides.filter(entry=>matches(entry.name)&&((entry.commands?.length??0)>0||entry.resultDiscriminator!==void 0)).map(entry=>({format:entry.format,commands:[...entry.commands??[]],result_discriminator:entry.resultDiscriminator!==void 0})).sort((left,right)=>left.format.localeCompare(right.format));const assuranceProviders=collect(registrations.assurance_providers??[],entry=>entry.definition.id);return{capabilities:collectUsedExtensionCapabilities(activation,options),commands:collect(registrations.commands,entry=>entry.command),command_overrides:collect(commands.overrides,entry=>entry.command),command_handlers:collect(commands.handlers,entry=>entry.command),hooks:HOOK_REGISTRY_FIELD_TO_KIND.filter(([field])=>hooks[field].some(entry=>matches(entry.name))).map(([,kind])=>kind),flag_commands:collect(registrations.flags,entry=>entry.target_command),item_types:collectFlat(registrations.item_types,entry=>entry.types.map(type=>type.name)),item_fields:collectFlat(registrations.item_fields,entry=>entry.fields.map(field=>field.name)),...relationshipKinds.length>0?{relationship_kinds:relationshipKinds}:{},migrations:collectFlat(registrations.migrations,entry=>typeof entry.definition.id==="string"?[entry.definition.id]:[]),profiles:collect(registrations.profiles,entry=>entry.profile.name),importers:collect(registrations.importers,entry=>entry.importer),exporters:collect(registrations.exporters,entry=>entry.exporter),search_providers:collect(registrations.search_providers,entry=>entry.definition.name),vector_store_adapters:collect(registrations.vector_store_adapters,entry=>entry.definition.name),...assuranceProviders.length>0?{assurance_providers:assuranceProviders}:{},parser_overrides:collect(parsers.overrides,entry=>entry.command),service_overrides:collect(services.overrides,entry=>entry.service),renderer_overrides:collect(renderers.overrides,entry=>entry.format),...rendererOwnership.length>0?{renderer_ownership:rendererOwnership}:{},preflight_overrides:preflight.overrides.filter(entry=>matches(entry.name)).length,preflight_ownership:preflight.overrides.filter(entry=>matches(entry.name)).map(entry=>({commands:[...entry.commands??[]]}))}}function sortUnique(values){return[...new Set(values)].sort((left,right)=>left.localeCompare(right))}export{describeExtensionActivation};
+(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]="184c43e0-a543-5b0b-ac09-9139ba5ded6a")}catch{}})();import{collectUsedExtensionCapabilities,normalizeExtensionName}from"./capability-usage.js";const HOOK_REGISTRY_FIELD_TO_KIND=[["beforeCommand","before_command"],["beforeMutation","before_mutation"],["afterCommand","after_command"],["onWrite","on_write"],["onRead","on_read"],["onIndex","on_index"]];function describeExtensionActivation(activation,options={}){const filters=new Set;options.extensionName!==void 0&&filters.add(normalizeExtensionName(options.extensionName));for(const name of options.extensionNames??[])filters.add(normalizeExtensionName(name));const matches=name=>filters.size===0||filters.has(normalizeExtensionName(name)),collect=(entries,identify)=>sortUnique(entries.filter(entry=>matches(entry.name)).map(identify)),collectFlat=(entries,expand)=>sortUnique(entries.filter(entry=>matches(entry.name)).flatMap(expand)),{registrations,commands,parsers,preflight,services,renderers,hooks}=activation,relationshipKinds=collectFlat(registrations.relationship_kinds??[],entry=>entry.definitions.map(definition=>definition.kind)),rendererOwnership=renderers.overrides.filter(entry=>matches(entry.name)&&((entry.commands?.length??0)>0||entry.resultDiscriminator!==void 0)).map(entry=>({format:entry.format,commands:[...entry.commands??[]],result_discriminator:entry.resultDiscriminator!==void 0})).sort((left,right)=>left.format.localeCompare(right.format)),assuranceProviders=collect(registrations.assurance_providers??[],entry=>entry.definition.id);return{capabilities:collectUsedExtensionCapabilities(activation,options),commands:collect(registrations.commands,entry=>entry.command),command_overrides:collect(commands.overrides,entry=>entry.command),command_handlers:collect(commands.handlers,entry=>entry.command),hooks:HOOK_REGISTRY_FIELD_TO_KIND.filter(([field])=>hooks[field].some(entry=>matches(entry.name))).map(([,kind])=>kind),flag_commands:collect(registrations.flags,entry=>entry.target_command),item_types:collectFlat(registrations.item_types,entry=>entry.types.map(type=>type.name)),item_fields:collectFlat(registrations.item_fields,entry=>entry.fields.map(field=>field.name)),...relationshipKinds.length>0?{relationship_kinds:relationshipKinds}:{},migrations:collectFlat(registrations.migrations,entry=>typeof entry.definition.id=="string"?[entry.definition.id]:[]),profiles:collect(registrations.profiles,entry=>entry.profile.name),importers:collect(registrations.importers,entry=>entry.importer),exporters:collect(registrations.exporters,entry=>entry.exporter),search_providers:collect(registrations.search_providers,entry=>entry.definition.name),vector_store_adapters:collect(registrations.vector_store_adapters,entry=>entry.definition.name),...assuranceProviders.length>0?{assurance_providers:assuranceProviders}:{},parser_overrides:collect(parsers.overrides,entry=>entry.command),service_overrides:collect(services.overrides,entry=>entry.service),renderer_overrides:collect(renderers.overrides,entry=>entry.format),...rendererOwnership.length>0?{renderer_ownership:rendererOwnership}:{},preflight_overrides:preflight.overrides.filter(entry=>matches(entry.name)).length,preflight_ownership:preflight.overrides.filter(entry=>matches(entry.name)).map(entry=>({commands:[...entry.commands??[]]}))}}function sortUnique(values){return[...new Set(values)].sort((left,right)=>left.localeCompare(right))}export{describeExtensionActivation};
 //# sourceMappingURL=activation-summary.js.map

package/dist/core/extensions/activation-transaction.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="44b86710-2d6f-57fe-912d-1cf7482a4f86")}catch(e2){}})();function captureExtensionActivationRollback(state){const lengths={beforeCommand:state.hooks.beforeCommand.length,beforeMutation:state.hooks.beforeMutation.length,afterCommand:state.hooks.afterCommand.length,onWrite:state.hooks.onWrite.length,onRead:state.hooks.onRead.length,onIndex:state.hooks.onIndex.length,commandOverrides:state.commands.overrides.length,commandHandlers:state.commands.handlers.length,parserOverrides:state.parsers.overrides.length,preflightOverrides:state.preflight.overrides.length,serviceOverrides:state.services.overrides.length,rendererOverrides:state.renderers.overrides.length,registrations:Object.fromEntries(Object.entries(state.registrations).map(([key,value])=>[key,value.length]))};return()=>{state.hooks.beforeCommand.length=lengths.beforeCommand;state.hooks.beforeMutation.length=lengths.beforeMutation;state.hooks.afterCommand.length=lengths.afterCommand;state.hooks.onWrite.length=lengths.onWrite;state.hooks.onRead.length=lengths.onRead;state.hooks.onIndex.length=lengths.onIndex;state.commands.overrides.length=lengths.commandOverrides;state.commands.handlers.length=lengths.commandHandlers;state.parsers.overrides.length=lengths.parserOverrides;state.preflight.overrides.length=lengths.preflightOverrides;state.services.overrides.length=lengths.serviceOverrides;state.renderers.overrides.length=lengths.rendererOverrides;for(const[key,length]of Object.entries(lengths.registrations)){state.registrations[key].length=length}}}export{captureExtensionActivationRollback};
+(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]="559b05dc-0290-5a7c-97b9-ef1e5e8670ba")}catch{}})();function captureExtensionActivationRollback(state){const lengths={beforeCommand:state.hooks.beforeCommand.length,beforeMutation:state.hooks.beforeMutation.length,afterCommand:state.hooks.afterCommand.length,onWrite:state.hooks.onWrite.length,onRead:state.hooks.onRead.length,onIndex:state.hooks.onIndex.length,commandOverrides:state.commands.overrides.length,commandHandlers:state.commands.handlers.length,parserOverrides:state.parsers.overrides.length,preflightOverrides:state.preflight.overrides.length,serviceOverrides:state.services.overrides.length,rendererOverrides:state.renderers.overrides.length,registrations:Object.fromEntries(Object.entries(state.registrations).map(([key,value])=>[key,value.length]))};return()=>{state.hooks.beforeCommand.length=lengths.beforeCommand,state.hooks.beforeMutation.length=lengths.beforeMutation,state.hooks.afterCommand.length=lengths.afterCommand,state.hooks.onWrite.length=lengths.onWrite,state.hooks.onRead.length=lengths.onRead,state.hooks.onIndex.length=lengths.onIndex,state.commands.overrides.length=lengths.commandOverrides,state.commands.handlers.length=lengths.commandHandlers,state.parsers.overrides.length=lengths.parserOverrides,state.preflight.overrides.length=lengths.preflightOverrides,state.services.overrides.length=lengths.serviceOverrides,state.renderers.overrides.length=lengths.rendererOverrides;for(const[key,length]of Object.entries(lengths.registrations))state.registrations[key].length=length}}export{captureExtensionActivationRollback};
 //# sourceMappingURL=activation-transaction.js.map

package/dist/core/extensions/capability-usage.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="71c44385-0182-50f8-8e05-3aeebfe57ad9")}catch(e2){}})();import{normalizeKnownExtensionCapability}from"./extension-capability-aliases.js";const EXTENSION_CAPABILITY_REGISTRATION_SURFACES={commands:["registerCommand","command override","command handler"],renderers:["registerRenderer"],hooks:["hooks.beforeCommand","hooks.beforeMutation","hooks.afterCommand","hooks.onWrite","hooks.onRead","hooks.onIndex"],schema:["registerFlags","registerItemFields","registerItemTypes","registerRelationshipKinds","registerMigration","registerProfile"],importers:["registerImporter","registerExporter"],search:["registerSearchProvider","registerVectorStoreAdapter"],parser:["registerParser"],preflight:["registerPreflight"],services:["registerService","registerAssuranceMeasurementProvider"]};const USAGE_KEY_SEPARATOR=":";function usageKey(layer,name){return`${layer}${USAGE_KEY_SEPARATOR}${normalizeExtensionName(name)}`}function usageKeyName(key){return key.slice(key.indexOf(USAGE_KEY_SEPARATOR)+1)}function normalizeExtensionName(name){return name.trim().toLowerCase()}function normalizeDeclaredCapabilities(capabilities){if(!Array.isArray(capabilities)){return[]}const known=new Set;for(const capability of capabilities){const normalized=normalizeKnownExtensionCapability(capability);if(normalized!==null){known.add(normalized)}}return[...known].sort((left,right)=>left.localeCompare(right))}function attributeCapabilityUsage(activation){const usage=new Map;const record=(entries,capability)=>{for(const entry of entries){const key=usageKey(entry.layer,entry.name);let exercised=usage.get(key);if(exercised===void 0){exercised=new Set;usage.set(key,exercised)}exercised.add(capability)}};const{registrations,commands,parsers,preflight,services,renderers,hooks}=activation;record(registrations.commands,"commands");record(commands.overrides,"commands");record(commands.handlers,"commands");record(registrations.flags,"schema");record(registrations.item_fields,"schema");record(registrations.item_types,"schema");record(registrations.relationship_kinds??[],"schema");record(registrations.migrations,"schema");record(registrations.profiles,"schema");record(registrations.importers,"importers");record(registrations.exporters,"importers");record(registrations.search_providers,"search");record(registrations.vector_store_adapters,"search");record(parsers.overrides,"parser");record(preflight.overrides,"preflight");record(services.overrides,"services");record(registrations.assurance_providers??[],"services");record(renderers.overrides,"renderers");record(hooks.beforeCommand,"hooks");record(hooks.beforeMutation,"hooks");record(hooks.afterCommand,"hooks");record(hooks.onWrite,"hooks");record(hooks.onRead,"hooks");record(hooks.onIndex,"hooks");return usage}function collectUsedExtensionCapabilities(activation,options={}){const usage=attributeCapabilityUsage(activation);const filters=new Set;if(options.extensionName!==void 0){filters.add(normalizeExtensionName(options.extensionName))}for(const name of options.extensionNames??[]){filters.add(normalizeExtensionName(name))}const used=new Set;for(const[key,capabilities]of usage){if(filters.size>0&&!filters.has(usageKeyName(key))){continue}for(const capability of capabilities){used.add(capability)}}return[...used].sort((left,right)=>left.localeCompare(right))}function reconcileExtensionCapabilityUsage(loaded,activation){const usage=attributeCapabilityUsage(activation);const reconciliations=[];for(const extension of loaded){const declared=normalizeDeclaredCapabilities(extension.capabilities);if(declared.length===0){continue}const exercised=usage.get(usageKey(extension.layer,extension.name))??new Set;const used=[...exercised].sort((left,right)=>left.localeCompare(right));const unused=declared.filter(capability=>!exercised.has(capability));reconciliations.push({layer:extension.layer,name:extension.name,declared,used,unused})}return reconciliations}export{EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,normalizeExtensionName,reconcileExtensionCapabilityUsage};
+(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]="d8844150-afb4-5f2e-a005-4cfb8482660c")}catch{}})();import{normalizeKnownExtensionCapability}from"./extension-capability-aliases.js";const EXTENSION_CAPABILITY_REGISTRATION_SURFACES={commands:["registerCommand","command override","command handler"],renderers:["registerRenderer"],hooks:["hooks.beforeCommand","hooks.beforeMutation","hooks.afterCommand","hooks.onWrite","hooks.onRead","hooks.onIndex"],schema:["registerFlags","registerItemFields","registerItemTypes","registerRelationshipKinds","registerMigration","registerProfile"],importers:["registerImporter","registerExporter"],search:["registerSearchProvider","registerVectorStoreAdapter"],parser:["registerParser"],preflight:["registerPreflight"],services:["registerService","registerAssuranceMeasurementProvider"]},USAGE_KEY_SEPARATOR=":";function usageKey(layer,name){return`${layer}${USAGE_KEY_SEPARATOR}${normalizeExtensionName(name)}`}function usageKeyName(key){return key.slice(key.indexOf(USAGE_KEY_SEPARATOR)+1)}function normalizeExtensionName(name){return name.trim().toLowerCase()}function normalizeDeclaredCapabilities(capabilities){if(!Array.isArray(capabilities))return[];const known=new Set;for(const capability of capabilities){const normalized=normalizeKnownExtensionCapability(capability);normalized!==null&&known.add(normalized)}return[...known].sort((left,right)=>left.localeCompare(right))}function attributeCapabilityUsage(activation){const usage=new Map,record=(entries,capability)=>{for(const entry of entries){const key=usageKey(entry.layer,entry.name);let exercised=usage.get(key);exercised===void 0&&(exercised=new Set,usage.set(key,exercised)),exercised.add(capability)}},{registrations,commands,parsers,preflight,services,renderers,hooks}=activation;return record(registrations.commands,"commands"),record(commands.overrides,"commands"),record(commands.handlers,"commands"),record(registrations.flags,"schema"),record(registrations.item_fields,"schema"),record(registrations.item_types,"schema"),record(registrations.relationship_kinds??[],"schema"),record(registrations.migrations,"schema"),record(registrations.profiles,"schema"),record(registrations.importers,"importers"),record(registrations.exporters,"importers"),record(registrations.search_providers,"search"),record(registrations.vector_store_adapters,"search"),record(parsers.overrides,"parser"),record(preflight.overrides,"preflight"),record(services.overrides,"services"),record(registrations.assurance_providers??[],"services"),record(renderers.overrides,"renderers"),record(hooks.beforeCommand,"hooks"),record(hooks.beforeMutation,"hooks"),record(hooks.afterCommand,"hooks"),record(hooks.onWrite,"hooks"),record(hooks.onRead,"hooks"),record(hooks.onIndex,"hooks"),usage}function collectUsedExtensionCapabilities(activation,options={}){const usage=attributeCapabilityUsage(activation),filters=new Set;options.extensionName!==void 0&&filters.add(normalizeExtensionName(options.extensionName));for(const name of options.extensionNames??[])filters.add(normalizeExtensionName(name));const used=new Set;for(const[key,capabilities]of usage)if(!(filters.size>0&&!filters.has(usageKeyName(key))))for(const capability of capabilities)used.add(capability);return[...used].sort((left,right)=>left.localeCompare(right))}function reconcileExtensionCapabilityUsage(loaded,activation){const usage=attributeCapabilityUsage(activation),reconciliations=[];for(const extension of loaded){const declared=normalizeDeclaredCapabilities(extension.capabilities);if(declared.length===0)continue;const exercised=usage.get(usageKey(extension.layer,extension.name))??new Set,used=[...exercised].sort((left,right)=>left.localeCompare(right)),unused=declared.filter(capability=>!exercised.has(capability));reconciliations.push({layer:extension.layer,name:extension.name,declared,used,unused})}return reconciliations}export{EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,normalizeExtensionName,reconcileExtensionCapabilityUsage};
 //# sourceMappingURL=capability-usage.js.map

package/dist/core/extensions/command-hook-context.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b2cf7f56-432d-5c74-ba0f-248c42a97255")}catch(e2){}})();import{createEmptyExtensionHookRegistry}from"./extension-registries.js";function createCoreCommandHookContext(options){return{...options,hooks:createEmptyExtensionHookRegistry(),profileEnabled:Boolean(options.globalOptions.profile),migrationBlockers:[]}}export{createCoreCommandHookContext};
+(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]="b1a38f8c-8f65-59e2-bddf-ed0606a0f0b5")}catch{}})();import{createEmptyExtensionHookRegistry}from"./extension-registries.js";function createCoreCommandHookContext(options){return{...options,hooks:createEmptyExtensionHookRegistry(),profileEnabled:!!options.globalOptions.profile,migrationBlockers:[]}}export{createCoreCommandHookContext};
 //# sourceMappingURL=command-hook-context.js.map

package/dist/core/extensions/command-metadata-contract.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="34536eba-0f92-5599-a807-5b39b000e733")}catch(e2){}})();const EXTENSION_COMMAND_CAPABILITY_FAMILIES=Object.freeze(["workspace","intake","context","lifecycle","evidence","graph","quality","automation","extensions","internal"]);export{EXTENSION_COMMAND_CAPABILITY_FAMILIES};
+(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]="34536eba-0f92-5599-a807-5b39b000e733")}catch{}})();const EXTENSION_COMMAND_CAPABILITY_FAMILIES=Object.freeze(["workspace","intake","context","lifecycle","evidence","graph","quality","automation","extensions","internal"]);export{EXTENSION_COMMAND_CAPABILITY_FAMILIES};
 //# sourceMappingURL=command-metadata-contract.js.map

package/dist/core/extensions/command-visibility-tier.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ca48c32a-e4e0-5da5-b9cb-b1f713646bad")}catch(e2){}})();import{assertOptionalStringField}from"./registration-validation.js";import{EXTENSION_COMMAND_CAPABILITY_FAMILIES}from"./command-metadata-contract.js";const COMMAND_CAPABILITY_FAMILIES=new Set(EXTENSION_COMMAND_CAPABILITY_FAMILIES);function assertCommandCapabilityFamily(family){if(family!==void 0&&!COMMAND_CAPABILITY_FAMILIES.has(String(family))){throw new Error(`registerCommand definition.family must be one of: ${EXTENSION_COMMAND_CAPABILITY_FAMILIES.join(", ")}`)}}function assertCommandDefinitionMetadataStrings(definition){assertOptionalStringField("registerCommand definition.action",definition.action);assertOptionalStringField("registerCommand definition.family",definition.family);assertOptionalStringField("registerCommand definition.description",definition.description);assertOptionalStringField("registerCommand definition.intent",definition.intent);assertOptionalStringField("registerCommand definition.tier",definition.tier);const tier=definition.tier;if(tier!==void 0&&tier!=="core"&&tier!=="standard"&&tier!=="full"&&tier!=="internal"){throw new Error("registerCommand definition.tier must be core, standard, full, or internal")}assertCommandCapabilityFamily(definition.family)}export{assertCommandDefinitionMetadataStrings};
+(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]="60fd882d-7c92-5be5-bf46-7e3c128bfb58")}catch{}})();import{assertOptionalStringField}from"./registration-validation.js";import{EXTENSION_COMMAND_CAPABILITY_FAMILIES}from"./command-metadata-contract.js";const COMMAND_CAPABILITY_FAMILIES=new Set(EXTENSION_COMMAND_CAPABILITY_FAMILIES);function assertCommandCapabilityFamily(family){if(family!==void 0&&!COMMAND_CAPABILITY_FAMILIES.has(String(family)))throw new Error(`registerCommand definition.family must be one of: ${EXTENSION_COMMAND_CAPABILITY_FAMILIES.join(", ")}`)}function assertCommandDefinitionMetadataStrings(definition){assertOptionalStringField("registerCommand definition.action",definition.action),assertOptionalStringField("registerCommand definition.family",definition.family),assertOptionalStringField("registerCommand definition.description",definition.description),assertOptionalStringField("registerCommand definition.intent",definition.intent),assertOptionalStringField("registerCommand definition.tier",definition.tier);const tier=definition.tier;if(tier!==void 0&&tier!=="core"&&tier!=="standard"&&tier!=="full"&&tier!=="internal")throw new Error("registerCommand definition.tier must be core, standard, full, or internal");assertCommandCapabilityFamily(definition.family)}export{assertCommandDefinitionMetadataStrings};
 //# sourceMappingURL=command-visibility-tier.js.map

package/dist/core/extensions/contribution-inventory.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7d96fda0-1f2f-5e34-99da-c3c5ad0f53f6")}catch(e2){}})();import{normalizeCommandName}from"./extension-runtime-helpers.js";const COMMAND_PATH_FIELDS=new Set(["commands","command_overrides","command_handlers","flag_commands","parser_overrides"]);const STRING_LIST_FIELDS=["commands","command_overrides","command_handlers","hooks","flag_commands","item_types","item_fields","relationship_kinds","migrations","profiles","importers","exporters","search_providers","vector_store_adapters","assurance_providers","parser_overrides","service_overrides","renderer_overrides"];function applyContributionStringLists(record,inventory){for(const field of STRING_LIST_FIELDS){const raw=record[field];if(raw===void 0)continue;if(!Array.isArray(raw)||raw.some(entry=>typeof entry!=="string")){return false}const values=raw.map(entry=>COMMAND_PATH_FIELDS.has(field)?normalizeCommandName(entry):entry.trim()).filter(entry=>entry.length>0);inventory[field]=[...new Set(values)].sort((left,right)=>left.localeCompare(right))}return true}function normalizeRendererOwnership(value){if(!Array.isArray(value))return null;const ownership=[];for(const rawEntry of value){if(typeof rawEntry!=="object"||rawEntry===null)return null;const entry=rawEntry;if(entry.format!=="json"&&entry.format!=="toon"||!Array.isArray(entry.commands)||entry.commands.some(command=>typeof command!=="string")||typeof entry.result_discriminator!=="boolean"){return null}ownership.push({format:entry.format,commands:[...new Set(entry.commands.map(command=>normalizeCommandName(command)))].sort((left,right)=>left.localeCompare(right)),result_discriminator:entry.result_discriminator})}return ownership.sort((left,right)=>left.format.localeCompare(right.format))}function normalizePreflightOwnership(value){if(!Array.isArray(value))return null;const ownership=[];for(const rawEntry of value){if(typeof rawEntry!=="object"||rawEntry===null)return null;const commands=rawEntry.commands;if(!Array.isArray(commands)||commands.some(command=>typeof command!=="string")){return null}ownership.push({commands:[...new Set(commands.map(command=>normalizeCommandName(command)))].filter(command=>command.length>0).sort((left,right)=>left.localeCompare(right))})}return ownership}function normalizeExtensionContributionInventory(value){if(value===void 0||value===null)return void 0;if(typeof value!=="object"||Array.isArray(value))return null;const record=value;if(record.schema_version!==1)return null;const inventory={schema_version:1};if(!applyContributionStringLists(record,inventory))return null;const preflightCount=record.preflight_overrides;if(preflightCount!==void 0&&(!Number.isInteger(preflightCount)||preflightCount<0)){return null}if(typeof preflightCount==="number"){inventory.preflight_overrides=preflightCount}const rawRendererOwnership=record.renderer_ownership;if(rawRendererOwnership!==void 0){const ownership=normalizeRendererOwnership(rawRendererOwnership);if(ownership===null)return null;inventory.renderer_ownership=ownership}const rawPreflightOwnership=record.preflight_ownership;if(rawPreflightOwnership!==void 0){const ownership=normalizePreflightOwnership(rawPreflightOwnership);if(ownership===null)return null;inventory.preflight_ownership=ownership}return inventory}function createExtensionContributionInventory(summary){return{schema_version:1,commands:summary.commands,command_overrides:summary.command_overrides,command_handlers:summary.command_handlers,hooks:summary.hooks,flag_commands:summary.flag_commands,item_types:summary.item_types,item_fields:summary.item_fields,...summary.relationship_kinds?{relationship_kinds:summary.relationship_kinds}:{},migrations:summary.migrations,profiles:summary.profiles,importers:summary.importers,exporters:summary.exporters,search_providers:summary.search_providers,vector_store_adapters:summary.vector_store_adapters,...summary.assurance_providers?{assurance_providers:summary.assurance_providers}:{},parser_overrides:summary.parser_overrides,service_overrides:summary.service_overrides,renderer_overrides:summary.renderer_overrides,...summary.renderer_ownership?{renderer_ownership:summary.renderer_ownership}:{},preflight_overrides:summary.preflight_overrides,...summary.preflight_ownership?{preflight_ownership:summary.preflight_ownership}:{}}}export{createExtensionContributionInventory,normalizeExtensionContributionInventory};
+(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]="615b4955-a30d-5d45-a86d-4bcf7bd9bd7a")}catch{}})();import{normalizeCommandName}from"./extension-runtime-helpers.js";const COMMAND_PATH_FIELDS=new Set(["commands","command_overrides","command_handlers","flag_commands","parser_overrides"]),STRING_LIST_FIELDS=["commands","command_overrides","command_handlers","hooks","flag_commands","item_types","item_fields","relationship_kinds","migrations","profiles","importers","exporters","search_providers","vector_store_adapters","assurance_providers","parser_overrides","service_overrides","renderer_overrides"];function applyContributionStringLists(record,inventory){for(const field of STRING_LIST_FIELDS){const raw=record[field];if(raw===void 0)continue;if(!Array.isArray(raw)||raw.some(entry=>typeof entry!="string"))return!1;const values=raw.map(entry=>COMMAND_PATH_FIELDS.has(field)?normalizeCommandName(entry):entry.trim()).filter(entry=>entry.length>0);inventory[field]=[...new Set(values)].sort((left,right)=>left.localeCompare(right))}return!0}function normalizeRendererOwnership(value){if(!Array.isArray(value))return null;const ownership=[];for(const rawEntry of value){if(typeof rawEntry!="object"||rawEntry===null)return null;const entry=rawEntry;if(entry.format!=="json"&&entry.format!=="toon"||!Array.isArray(entry.commands)||entry.commands.some(command=>typeof command!="string")||typeof entry.result_discriminator!="boolean")return null;ownership.push({format:entry.format,commands:[...new Set(entry.commands.map(command=>normalizeCommandName(command)))].sort((left,right)=>left.localeCompare(right)),result_discriminator:entry.result_discriminator})}return ownership.sort((left,right)=>left.format.localeCompare(right.format))}function normalizePreflightOwnership(value){if(!Array.isArray(value))return null;const ownership=[];for(const rawEntry of value){if(typeof rawEntry!="object"||rawEntry===null)return null;const commands=rawEntry.commands;if(!Array.isArray(commands)||commands.some(command=>typeof command!="string"))return null;ownership.push({commands:[...new Set(commands.map(command=>normalizeCommandName(command)))].filter(command=>command.length>0).sort((left,right)=>left.localeCompare(right))})}return ownership}function normalizeExtensionContributionInventory(value){if(value==null)return;if(typeof value!="object"||Array.isArray(value))return null;const record=value;if(record.schema_version!==1)return null;const inventory={schema_version:1};if(!applyContributionStringLists(record,inventory))return null;const preflightCount=record.preflight_overrides;if(preflightCount!==void 0&&(!Number.isInteger(preflightCount)||preflightCount<0))return null;typeof preflightCount=="number"&&(inventory.preflight_overrides=preflightCount);const rawRendererOwnership=record.renderer_ownership;if(rawRendererOwnership!==void 0){const ownership=normalizeRendererOwnership(rawRendererOwnership);if(ownership===null)return null;inventory.renderer_ownership=ownership}const rawPreflightOwnership=record.preflight_ownership;if(rawPreflightOwnership!==void 0){const ownership=normalizePreflightOwnership(rawPreflightOwnership);if(ownership===null)return null;inventory.preflight_ownership=ownership}return inventory}function createExtensionContributionInventory(summary){return{schema_version:1,commands:summary.commands,command_overrides:summary.command_overrides,command_handlers:summary.command_handlers,hooks:summary.hooks,flag_commands:summary.flag_commands,item_types:summary.item_types,item_fields:summary.item_fields,...summary.relationship_kinds?{relationship_kinds:summary.relationship_kinds}:{},migrations:summary.migrations,profiles:summary.profiles,importers:summary.importers,exporters:summary.exporters,search_providers:summary.search_providers,vector_store_adapters:summary.vector_store_adapters,...summary.assurance_providers?{assurance_providers:summary.assurance_providers}:{},parser_overrides:summary.parser_overrides,service_overrides:summary.service_overrides,renderer_overrides:summary.renderer_overrides,...summary.renderer_ownership?{renderer_ownership:summary.renderer_ownership}:{},preflight_overrides:summary.preflight_overrides,...summary.preflight_ownership?{preflight_ownership:summary.preflight_ownership}:{}}}export{createExtensionContributionInventory,normalizeExtensionContributionInventory};
 //# sourceMappingURL=contribution-inventory.js.map

package/dist/core/extensions/exporter-output-contract.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1729c469-5e9c-5d8c-8137-ec506c9fd31b")}catch(e2){}})();import{cloneContextSnapshot}from"./extension-runtime-helpers.js";import{asRegistrationRecord,assertOptionalStringField}from"./registration-validation.js";function normalizeExporterArtifactOutput(value){const candidate=asRegistrationRecord("registerExporter options.output",value);const allowedKeys=new Set(["channel","receipt","media_type"]);for(const key of Object.keys(candidate)){if(!allowedKeys.has(key)){throw new TypeError(`registerExporter options.output contains unsupported field ${key}`)}}if(candidate.channel!=="stdout"&&candidate.channel!=="file"){throw new TypeError("registerExporter options.output.channel must be stdout|file")}if(candidate.receipt!==void 0&&candidate.receipt!=="suppress"&&candidate.receipt!=="render"){throw new TypeError("registerExporter options.output.receipt must be suppress|render")}if(candidate.channel==="stdout"&&candidate.receipt==="render"){throw new TypeError("registerExporter stdout artifacts cannot render a host receipt")}assertOptionalStringField("registerExporter options.output.media_type",candidate.media_type);return{channel:candidate.channel,receipt:candidate.receipt??(candidate.channel==="stdout"?"suppress":"render"),...typeof candidate.media_type==="string"?{media_type:candidate.media_type}:{}}}function resolveImportExportArtifactOutput(method,resolvedOptions,descriptionWasDeclared){if(method==="registerImporter"&&resolvedOptions.output!==void 0){throw new TypeError("registerImporter options.output is exporter-only")}if(method!=="registerExporter"||resolvedOptions.output===void 0){return void 0}const output=normalizeExporterArtifactOutput(resolvedOptions.output);if(!descriptionWasDeclared&&output.channel==="stdout"){resolvedOptions.description="Export items with the registered extension adapter. Artifact bytes are written exclusively to stdout and the host receipt is suppressed by default."}return output}function buildImportExportContext(context,registration,action){return{registration,action,command:context.command,args:cloneContextSnapshot(context.args),options:cloneContextSnapshot(context.options),global:cloneContextSnapshot(context.global),pm_root:context.pm_root,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel,...context.sdk===void 0?{}:{sdk:context.sdk}}}export{buildImportExportContext,normalizeExporterArtifactOutput,resolveImportExportArtifactOutput};
+(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]="07cb237c-3956-5997-85f8-972d2ee490d0")}catch{}})();import{cloneContextSnapshot}from"./extension-runtime-helpers.js";import{asRegistrationRecord,assertOptionalStringField}from"./registration-validation.js";function normalizeExporterArtifactOutput(value){const candidate=asRegistrationRecord("registerExporter options.output",value),allowedKeys=new Set(["channel","receipt","media_type"]);for(const key of Object.keys(candidate))if(!allowedKeys.has(key))throw new TypeError(`registerExporter options.output contains unsupported field ${key}`);if(candidate.channel!=="stdout"&&candidate.channel!=="file")throw new TypeError("registerExporter options.output.channel must be stdout|file");if(candidate.receipt!==void 0&&candidate.receipt!=="suppress"&&candidate.receipt!=="render")throw new TypeError("registerExporter options.output.receipt must be suppress|render");if(candidate.channel==="stdout"&&candidate.receipt==="render")throw new TypeError("registerExporter stdout artifacts cannot render a host receipt");return assertOptionalStringField("registerExporter options.output.media_type",candidate.media_type),{channel:candidate.channel,receipt:candidate.receipt??(candidate.channel==="stdout"?"suppress":"render"),...typeof candidate.media_type=="string"?{media_type:candidate.media_type}:{}}}function resolveImportExportArtifactOutput(method,resolvedOptions,descriptionWasDeclared){if(method==="registerImporter"&&resolvedOptions.output!==void 0)throw new TypeError("registerImporter options.output is exporter-only");if(method!=="registerExporter"||resolvedOptions.output===void 0)return;const output=normalizeExporterArtifactOutput(resolvedOptions.output);return!descriptionWasDeclared&&output.channel==="stdout"&&(resolvedOptions.description="Export items with the registered extension adapter. Artifact bytes are written exclusively to stdout and the host receipt is suppressed by default."),output}function buildImportExportContext(context,registration,action){return{registration,action,command:context.command,args:cloneContextSnapshot(context.args),options:cloneContextSnapshot(context.options),global:cloneContextSnapshot(context.global),pm_root:context.pm_root,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel,...context.sdk===void 0?{}:{sdk:context.sdk}}}export{buildImportExportContext,normalizeExporterArtifactOutput,resolveImportExportArtifactOutput};
 //# sourceMappingURL=exporter-output-contract.js.map

package/dist/core/extensions/extension-candidate.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b35d854e-5025-5999-abe7-507f1a25647f")}catch(e2){}})();function buildReadyExtensionCandidate(params){if(!params.extensionReady||!params.enabledForLoad)return null;return{layer:params.layer,directory:params.directory,manifest_path:params.manifestPath,entry_path:params.entryPath,manifest:params.manifest,source_package:params.sourceIdentity?.package_name,source_aliases:params.sourceIdentity?.aliases,contributions:params.sourceIdentity?.contributions}}export{buildReadyExtensionCandidate};
+(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]="fc2e7eac-cd1c-5885-aa27-e98455008a4f")}catch{}})();function buildReadyExtensionCandidate(params){return!params.extensionReady||!params.enabledForLoad?null:{layer:params.layer,directory:params.directory,manifest_path:params.manifestPath,entry_path:params.entryPath,manifest:params.manifest,source_package:params.sourceIdentity?.package_name,source_aliases:params.sourceIdentity?.aliases,contributions:params.sourceIdentity?.contributions}}export{buildReadyExtensionCandidate};
 //# sourceMappingURL=extension-candidate.js.map

package/dist/core/extensions/extension-capability-aliases.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1ddb0411-5fdd-56af-a524-0f6830c288a5")}catch(e2){}})();import{KNOWN_EXTENSION_CAPABILITIES,EXTENSION_CAPABILITY_CONTRACT_VERSION,EXTENSION_CAPABILITY_LEGACY_ALIASES}from"./extension-types.js";import{levenshteinDistanceWithinLimit}from"../shared/levenshtein.js";function normalizeNames(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((a,b)=>a.localeCompare(b))}function isKnownExtensionCapability(value){return KNOWN_EXTENSION_CAPABILITIES.includes(value)}function normalizeKnownExtensionCapability(value){const normalized=value.trim().toLowerCase();return isKnownExtensionCapability(normalized)?normalized:null}function collectUnknownExtensionCapabilities(capabilities){return capabilities.filter(capability=>!isKnownExtensionCapability(capability))}function resolveLegacyExtensionCapabilityAlias(capability){const normalized=capability.trim().toLowerCase();if(normalized.length===0){return null}return EXTENSION_CAPABILITY_LEGACY_ALIASES[normalized]??null}function normalizeManifestCapabilities(rawCapabilities){const normalizedCapabilities=normalizeNames([...rawCapabilities].map(value=>value.toLowerCase()));const remappedCapabilities=[];const legacyAliases=[];for(const capability of normalizedCapabilities){const legacyAliasTarget=resolveLegacyExtensionCapabilityAlias(capability);if(legacyAliasTarget){remappedCapabilities.push(legacyAliasTarget);legacyAliases.push({alias:capability,target:legacyAliasTarget});continue}remappedCapabilities.push(capability)}const dedupedLegacyAliases=[...new Map(legacyAliases.map(entry=>[`${entry.alias}>${entry.target}`,entry])).values()].sort((left,right)=>left.alias.localeCompare(right.alias));return{capabilities:normalizeNames(remappedCapabilities),legacy_aliases:dedupedLegacyAliases}}function suggestKnownExtensionCapability(capability){const normalized=capability.trim().toLowerCase();if(normalized.length===0){return null}const legacyAlias=resolveLegacyExtensionCapabilityAlias(normalized);if(legacyAlias){return legacyAlias}const maxDistance=Math.max(1,Math.floor(normalized.length*.34));let bestMatch=null;let bestDistance=Number.POSITIVE_INFINITY;for(const candidate of KNOWN_EXTENSION_CAPABILITIES){const distance=levenshteinDistanceWithinLimit(normalized,candidate,maxDistance);if(distance!==null&&distance<bestDistance){bestDistance=distance;bestMatch=candidate}}return bestMatch}function formatUnknownExtensionCapabilityWarning(layer,name,capability){const allowed=KNOWN_EXTENSION_CAPABILITIES.join(",");const suggested=suggestKnownExtensionCapability(capability)??"none";return`extension_capability_unknown:${layer}:${name}:${capability}:allowed=${allowed}:suggested=${suggested}`}function formatLegacyExtensionCapabilityAliasWarning(layer,name,aliases){const aliasesToken=aliases.map(entry=>`${entry.alias}>${entry.target}`).join(",");return`extension_capability_legacy_alias:${layer}:${name}:aliases=${aliasesToken}`}function parseUnknownExtensionCapabilityWarning(warning){const match=/^extension_capability_unknown:(global|project):([^:]+):([^:]+):allowed=([^:]+):suggested=([^:]+)$/.exec(warning.trim());if(!match){return null}const[,layerRaw,name,capability,allowedRaw,suggestedRaw]=match;const layer=layerRaw;const allowed_capabilities=allowedRaw.split(",").map(value=>value.trim()).filter(value=>value.length>0);const legacyAlias=resolveLegacyExtensionCapabilityAlias(capability);const suggestedFromWarning=suggestedRaw==="none"?void 0:suggestedRaw;const suggested_capability=suggestedFromWarning??legacyAlias??void 0;const suggestion_source=suggested_capability?legacyAlias===suggested_capability?"legacy_alias":"nearest_match":void 0;return{layer,name,capability,allowed_capabilities,capability_contract_version:EXTENSION_CAPABILITY_CONTRACT_VERSION,suggested_capability,suggestion_source,legacy_alias_target:legacyAlias??void 0}}function parseLegacyExtensionCapabilityAliasWarning(warning){const match=/^extension_capability_legacy_alias:(global|project):([^:]+):aliases=(.+)$/.exec(warning.trim());if(!match){return[]}const[,layerRaw,name,aliasesRaw]=match;const layer=layerRaw;const allowedCapabilities=[...KNOWN_EXTENSION_CAPABILITIES];const parsed=[];for(const token of aliasesRaw.split(",")){const[rawAlias,rawTarget]=token.split(">");const alias=rawAlias?.trim();const target=rawTarget?.trim().toLowerCase();if(!alias||!target||!isKnownExtensionCapability(target)){continue}parsed.push({layer,name,capability:alias,allowed_capabilities:allowedCapabilities,capability_contract_version:EXTENSION_CAPABILITY_CONTRACT_VERSION,suggested_capability:target,suggestion_source:"legacy_alias",legacy_alias_target:target})}return parsed}export{collectUnknownExtensionCapabilities,formatLegacyExtensionCapabilityAliasWarning,formatUnknownExtensionCapabilityWarning,isKnownExtensionCapability,normalizeKnownExtensionCapability,normalizeManifestCapabilities,normalizeNames,parseLegacyExtensionCapabilityAliasWarning,parseUnknownExtensionCapabilityWarning,resolveLegacyExtensionCapabilityAlias,suggestKnownExtensionCapability};
+(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]="7359c10a-4c56-57ea-8254-fc26b19e5c84")}catch{}})();import{KNOWN_EXTENSION_CAPABILITIES,EXTENSION_CAPABILITY_CONTRACT_VERSION,EXTENSION_CAPABILITY_LEGACY_ALIASES}from"./extension-types.js";import{levenshteinDistanceWithinLimit}from"../shared/levenshtein.js";function normalizeNames(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((a,b)=>a.localeCompare(b))}function isKnownExtensionCapability(value){return KNOWN_EXTENSION_CAPABILITIES.includes(value)}function normalizeKnownExtensionCapability(value){const normalized=value.trim().toLowerCase();return isKnownExtensionCapability(normalized)?normalized:null}function collectUnknownExtensionCapabilities(capabilities){return capabilities.filter(capability=>!isKnownExtensionCapability(capability))}function resolveLegacyExtensionCapabilityAlias(capability){const normalized=capability.trim().toLowerCase();return normalized.length===0?null:EXTENSION_CAPABILITY_LEGACY_ALIASES[normalized]??null}function normalizeManifestCapabilities(rawCapabilities){const normalizedCapabilities=normalizeNames([...rawCapabilities].map(value=>value.toLowerCase())),remappedCapabilities=[],legacyAliases=[];for(const capability of normalizedCapabilities){const legacyAliasTarget=resolveLegacyExtensionCapabilityAlias(capability);if(legacyAliasTarget){remappedCapabilities.push(legacyAliasTarget),legacyAliases.push({alias:capability,target:legacyAliasTarget});continue}remappedCapabilities.push(capability)}const dedupedLegacyAliases=[...new Map(legacyAliases.map(entry=>[`${entry.alias}>${entry.target}`,entry])).values()].sort((left,right)=>left.alias.localeCompare(right.alias));return{capabilities:normalizeNames(remappedCapabilities),legacy_aliases:dedupedLegacyAliases}}function suggestKnownExtensionCapability(capability){const normalized=capability.trim().toLowerCase();if(normalized.length===0)return null;const legacyAlias=resolveLegacyExtensionCapabilityAlias(normalized);if(legacyAlias)return legacyAlias;const maxDistance=Math.max(1,Math.floor(normalized.length*.34));let bestMatch=null,bestDistance=Number.POSITIVE_INFINITY;for(const candidate of KNOWN_EXTENSION_CAPABILITIES){const distance=levenshteinDistanceWithinLimit(normalized,candidate,maxDistance);distance!==null&&distance<bestDistance&&(bestDistance=distance,bestMatch=candidate)}return bestMatch}function formatUnknownExtensionCapabilityWarning(layer,name,capability){const allowed=KNOWN_EXTENSION_CAPABILITIES.join(","),suggested=suggestKnownExtensionCapability(capability)??"none";return`extension_capability_unknown:${layer}:${name}:${capability}:allowed=${allowed}:suggested=${suggested}`}function formatLegacyExtensionCapabilityAliasWarning(layer,name,aliases){const aliasesToken=aliases.map(entry=>`${entry.alias}>${entry.target}`).join(",");return`extension_capability_legacy_alias:${layer}:${name}:aliases=${aliasesToken}`}function parseUnknownExtensionCapabilityWarning(warning){const match=/^extension_capability_unknown:(global|project):([^:]+):([^:]+):allowed=([^:]+):suggested=([^:]+)$/.exec(warning.trim());if(!match)return null;const[,layerRaw,name,capability,allowedRaw,suggestedRaw]=match,layer=layerRaw,allowed_capabilities=allowedRaw.split(",").map(value=>value.trim()).filter(value=>value.length>0),legacyAlias=resolveLegacyExtensionCapabilityAlias(capability),suggested_capability=(suggestedRaw==="none"?void 0:suggestedRaw)??legacyAlias??void 0;return{layer,name,capability,allowed_capabilities,capability_contract_version:EXTENSION_CAPABILITY_CONTRACT_VERSION,suggested_capability,suggestion_source:suggested_capability?legacyAlias===suggested_capability?"legacy_alias":"nearest_match":void 0,legacy_alias_target:legacyAlias??void 0}}function parseLegacyExtensionCapabilityAliasWarning(warning){const match=/^extension_capability_legacy_alias:(global|project):([^:]+):aliases=(.+)$/.exec(warning.trim());if(!match)return[];const[,layerRaw,name,aliasesRaw]=match,layer=layerRaw,allowedCapabilities=[...KNOWN_EXTENSION_CAPABILITIES],parsed=[];for(const token of aliasesRaw.split(",")){const[rawAlias,rawTarget]=token.split(">"),alias=rawAlias?.trim(),target=rawTarget?.trim().toLowerCase();!alias||!target||!isKnownExtensionCapability(target)||parsed.push({layer,name,capability:alias,allowed_capabilities:allowedCapabilities,capability_contract_version:EXTENSION_CAPABILITY_CONTRACT_VERSION,suggested_capability:target,suggestion_source:"legacy_alias",legacy_alias_target:target})}return parsed}export{collectUnknownExtensionCapabilities,formatLegacyExtensionCapabilityAliasWarning,formatUnknownExtensionCapabilityWarning,isKnownExtensionCapability,normalizeKnownExtensionCapability,normalizeManifestCapabilities,normalizeNames,parseLegacyExtensionCapabilityAliasWarning,parseUnknownExtensionCapabilityWarning,resolveLegacyExtensionCapabilityAlias,suggestKnownExtensionCapability};
 //# sourceMappingURL=extension-capability-aliases.js.map