@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/cli-contracts/agent-output-contracts.js

@@ -1,4 +1,4 @@
-(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]="d956e747-cbca-5e3c-925f-e1aeb2ebbfa7")}catch{}})();import{stripVTControlCharacters}from"node:util";import{resolvePmHistoryOperation}from"./command-aliases.js";import{PM_CORE_COMMAND_NAMES}from"./enum-contracts.js";const PM_OUTPUT_DEGRADATION_STEPS=["full","compact","brief","summary","counts"],PM_OUTPUT_BUDGET_CLASSES=["mutation","read","discovery","governance"],PM_DIAGNOSTIC_OUTPUT_CLASSES=["error","warning","validation_summary","recovery_bundle"],PM_DIAGNOSTIC_DEGRADATION_STEPS=["full","omit_explanation","limit_collections","compact_recovery","action_only"],MUTATION_COMMANDS=new Set(["append","claim","close","close-many","close-task","comments","config","copy","create","delete","docs","event","files","focus","history-author-acknowledge","history-compact","history-redact","history-repair","init","item","learnings","meet","notes","pause-task","release","remind","restore","schema","start-task","update","update-many"]),DISCOVERY_COMMANDS=new Set(["contracts","extension","help","install","package","packages","profile","upgrade"]),GOVERNANCE_COMMANDS=new Set(["gc","health","merge","stats","telemetry","test","test-all","validate"]),DEFAULT_MAX_ESTIMATED_TOKENS={mutation:2e3,read:4e3,discovery:3e3,governance:6e3},JSON_BUDGET_NUMERATOR=3,JSON_BUDGET_DENOMINATOR=2,MINIMUM_DIAGNOSTIC_BUDGET=192,DIAGNOSTIC_DEFAULT_BUDGETS={error:{text:768,json:2e3},warning:{text:768,json:2e3},validation_summary:{text:1500,json:3e3},recovery_bundle:{text:768,json:2e3}},PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS=PM_DIAGNOSTIC_OUTPUT_CLASSES.map(diagnosticClass=>({diagnostic_class:diagnosticClass,default_max_estimated_tokens_by_format:DIAGNOSTIC_DEFAULT_BUDGETS[diagnosticClass],minimum_max_estimated_tokens:MINIMUM_DIAGNOSTIC_BUDGET,degradation_ladder:PM_DIAGNOSTIC_DEGRADATION_STEPS,corrective_action_paths:["required","recovery.suggested_retry","recovery.suggested_retry_args","recovery.next_best_command","next_steps[0]"],token_estimate:"ceil(utf8_bytes / 4)"})),DIAGNOSTIC_BUDGET_BY_CLASS=new Map(PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS.map(contract=>[contract.diagnostic_class,contract]));function inferPmOutputBudgetClass(command){const[rootCommand=""]=resolvePmHistoryOperation(command).split(/\s+/u);return MUTATION_COMMANDS.has(rootCommand)?"mutation":DISCOVERY_COMMANDS.has(rootCommand)?"discovery":GOVERNANCE_COMMANDS.has(rootCommand)?"governance":"read"}function createPmCommandOutputBudget(command,budgetClass=inferPmOutputBudgetClass(command)){const normalizedCommand=command.trim().replace(/\s+/gu," ");if(normalizedCommand.length===0)throw new TypeError("command must be a non-empty command path");const toonBudget=DEFAULT_MAX_ESTIMATED_TOKENS[budgetClass];return definePmCommandOutputBudget({command:normalizedCommand,budget_class:budgetClass,default_max_estimated_tokens:toonBudget,default_max_estimated_tokens_by_format:{toon:toonBudget,json:Math.ceil(toonBudget*JSON_BUDGET_NUMERATOR/JSON_BUDGET_DENOMINATOR)},degradation_ladder:PM_OUTPUT_DEGRADATION_STEPS,allows_unbounded_opt_out:!0,token_estimate:"ceil(utf8_bytes / 4)"})}function definePmCommandOutputBudget(contract){if(!Number.isSafeInteger(contract.default_max_estimated_tokens)||contract.default_max_estimated_tokens<=0)throw new RangeError("default_max_estimated_tokens must be a positive safe integer");for(const[format,ceiling]of Object.entries(contract.default_max_estimated_tokens_by_format))if(!Number.isSafeInteger(ceiling)||ceiling<=0)throw new RangeError(`default_max_estimated_tokens_by_format.${format} must be a positive safe integer`);return contract}const PM_COMMAND_OUTPUT_BUDGET_CONTRACTS=PM_CORE_COMMAND_NAMES.map(command=>createPmCommandOutputBudget(command)),OUTPUT_BUDGET_BY_COMMAND=new Map(PM_COMMAND_OUTPUT_BUDGET_CONTRACTS.map(contract=>[contract.command,contract]));function resolvePmCommandOutputBudget(command,options={}){const normalizedCommand=command.trim().replace(/\s+/gu," "),[rootCommand]=resolvePmHistoryOperation(normalizedCommand).split(" "),declared=OUTPUT_BUDGET_BY_COMMAND.get(rootCommand);return declared?{...declared,command:normalizedCommand}:options.generateFallback?createPmCommandOutputBudget(normalizedCommand):null}function estimatePmOutputTokens(utf8Bytes){return Math.ceil(Math.max(0,utf8Bytes)/4)}function resolvePmDiagnosticOutputBudget(diagnosticClass){const contract=DIAGNOSTIC_BUDGET_BY_CLASS.get(diagnosticClass);if(contract===void 0)throw new TypeError(`diagnosticClass must be one of: ${PM_DIAGNOSTIC_OUTPUT_CLASSES.join(", ")}`);return contract}function estimateJsonDiagnosticTokens(value){return estimatePmOutputTokens(Buffer.byteLength(JSON.stringify(value,null,2),"utf8"))}function isDiagnosticRecord(value){return typeof value=="object"&&value!==null&&!Array.isArray(value)}function compactDiagnosticRecovery(value){if(!isDiagnosticRecord(value))return;const compact={};for(const key of["suggested_retry","suggested_retry_args","next_best_command","allowed_values","candidate_commands","missing","missing_required_fields","option_scope","retry_after_ms"]){const candidate=value[key];Array.isArray(candidate)?compact[key]=key==="suggested_retry_args"?candidate:candidate.slice(0,3):candidate!==void 0&&(compact[key]=candidate)}return Object.keys(compact).length>0?compact:void 0}function truncateDiagnosticString(value,maximum){return typeof value!="string"||value.length<=maximum?value:`${value.slice(0,Math.max(1,maximum-3))}...`}function truncateDiagnosticUtf8Text(value,maximumBytes){if(Buffer.byteLength(value,"utf8")<=maximumBytes)return value;const suffix="...",codePoints=Array.from(value);let lower=0,upper=codePoints.length;for(;lower<upper;){const middle=Math.ceil((lower+upper)/2),candidate=`${codePoints.slice(0,middle).join("")}${suffix}`;Buffer.byteLength(candidate,"utf8")<=maximumBytes?lower=middle:upper=middle-1}return`${codePoints.slice(0,lower).join("")}${suffix}`}function prioritizeDiagnosticFields(diagnostic){const prioritized={};for(const key of["code","required","recovery","next_steps","exit_code","type","title","detail","why","examples"])Object.hasOwn(diagnostic,key)&&diagnostic[key]!==void 0&&(prioritized[key]=diagnostic[key]);for(const[key,value]of Object.entries(diagnostic))key!=="__proto__"&&!Object.hasOwn(prioritized,key)&&(prioritized[key]=value);return prioritized}const DIAGNOSTIC_COLLECTION_LIMIT_STAGES=new Set(["limit_collections","compact_recovery","action_only"]),DIAGNOSTIC_RECOVERY_COMPACTION_STAGES=new Set(["compact_recovery","action_only"]);function actionOnlyDiagnostic(candidate){const actionOnly={code:typeof candidate.code=="string"?candidate.code:"diagnostic",required:truncateDiagnosticString(candidate.required,160)??"Inspect the diagnostic code and retry with corrected input."},recovery=compactDiagnosticRecovery(candidate.recovery);return recovery!==void 0?actionOnly.recovery=recovery:Array.isArray(candidate.next_steps)&&(actionOnly.next_steps=candidate.next_steps.slice(0,1)),candidate.exit_code!==void 0&&(actionOnly.exit_code=candidate.exit_code),candidate.type!==void 0&&(actionOnly.type=candidate.type),actionOnly}function diagnosticCandidate(diagnostic,stage){const candidate=structuredClone(diagnostic);if(stage!=="full"&&(delete candidate.why,delete candidate.examples),DIAGNOSTIC_COLLECTION_LIMIT_STAGES.has(stage))for(const[key,value]of Object.entries(candidate))Array.isArray(value)&&(candidate[key]=value.slice(0,3));if(DIAGNOSTIC_RECOVERY_COMPACTION_STAGES.has(stage)){const recovery=compactDiagnosticRecovery(candidate.recovery);recovery?candidate.recovery=recovery:delete candidate.recovery}return stage!=="action_only"?prioritizeDiagnosticFields(candidate):actionOnlyDiagnostic(candidate)}function attachDiagnosticReceipt(candidate,receipt){const projected={...candidate,diagnostic_output:{...receipt,estimated_tokens:0}};for(let attempt=0;attempt<4;attempt+=1){const estimatedTokens=estimateJsonDiagnosticTokens(projected),outputReceipt=projected.diagnostic_output;if(outputReceipt.estimated_tokens===estimatedTokens)break;outputReceipt.estimated_tokens=estimatedTokens}return projected}function shrinkMinimalDiagnosticCandidate(candidate,receipt,budget){let fallback=attachDiagnosticReceipt(candidate,receipt);for(const optionalField of["recovery","exit_code"])estimateJsonDiagnosticTokens(fallback)<=budget||candidate[optionalField]===void 0||(delete candidate[optionalField],fallback=attachDiagnosticReceipt(candidate,receipt));let maximumActionBytes=40;for(;estimateJsonDiagnosticTokens(fallback)>budget&&maximumActionBytes>4;)maximumActionBytes-=4,candidate.code=truncateDiagnosticUtf8Text(String(candidate.code),maximumActionBytes),candidate.required=truncateDiagnosticUtf8Text(String(candidate.required),maximumActionBytes),fallback=attachDiagnosticReceipt(candidate,receipt);return fallback}function createMinimalDiagnosticFallback(projected,budget){const receipt=projected.diagnostic_output,{estimated_tokens:_estimatedTokens,...receiptWithoutEstimate}=receipt,boundedOmittedFields=receiptWithoutEstimate.omitted_fields.slice(0,8).map(field=>truncateDiagnosticUtf8Text(field,32)),boundedReceipt={...receiptWithoutEstimate,omitted_fields:boundedOmittedFields,...receiptWithoutEstimate.omitted_fields.length>boundedOmittedFields.length?{omitted_fields_overflow_count:receiptWithoutEstimate.omitted_fields.length-boundedOmittedFields.length}:{}},recoveryCandidate=compactDiagnosticRecovery(projected.recovery),recovery=recoveryCandidate&&estimateJsonDiagnosticTokens(recoveryCandidate)<=48?recoveryCandidate:void 0,candidate={code:truncateDiagnosticUtf8Text(String(projected.code),320),required:truncateDiagnosticUtf8Text(String(projected.required),320),...recovery?{recovery}:{},...projected.exit_code!==void 0?{exit_code:projected.exit_code}:{}};let fallback=attachDiagnosticReceipt(candidate,boundedReceipt);for(;estimateJsonDiagnosticTokens(fallback)>budget&&boundedReceipt.omitted_fields.length>0;)boundedReceipt.omitted_fields.pop(),boundedReceipt.omitted_fields_overflow_count=receiptWithoutEstimate.omitted_fields.length-boundedReceipt.omitted_fields.length,fallback=attachDiagnosticReceipt(candidate,boundedReceipt);return fallback=shrinkMinimalDiagnosticCandidate(candidate,boundedReceipt,budget),fallback}function projectPmDiagnosticOutput(diagnostic,options={}){const diagnosticRecord=diagnostic,diagnosticClass=options.diagnosticClass??"error",contract=resolvePmDiagnosticOutputBudget(diagnosticClass),explicitBudget=options.maxEstimatedTokens;if(explicitBudget!==void 0&&(!Number.isSafeInteger(explicitBudget)||explicitBudget<contract.minimum_max_estimated_tokens))throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);const budget=explicitBudget??contract.default_max_estimated_tokens_by_format.json,originalEstimatedTokens=estimateJsonDiagnosticTokens(diagnosticRecord),originalFields=Object.keys(diagnosticRecord);if(originalEstimatedTokens<=budget)return prioritizeDiagnosticFields(structuredClone(diagnosticRecord));let projected;for(const[index,stage]of contract.degradation_ladder.entries()){const candidate=diagnosticCandidate(diagnosticRecord,stage),omittedFields=originalFields.filter(field=>!Object.hasOwn(candidate,field)),withReceipt=attachDiagnosticReceipt(candidate,{diagnostic_class:diagnosticClass,format:"json",budget,budget_source:explicitBudget===void 0?"default":"explicit",original_estimated_tokens:originalEstimatedTokens,truncated:index>0,degradation_steps:contract.degradation_ladder.slice(0,index+1),omitted_fields:omittedFields});if(projected=withReceipt,estimateJsonDiagnosticTokens(withReceipt)<=budget)break}return estimateJsonDiagnosticTokens(projected)>budget&&(projected=createMinimalDiagnosticFallback(projected,budget)),projected}function sanitizeDiagnosticText(text){return stripVTControlCharacters(text).replace(/\r\n/gu,`
+(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]="c8a91fc2-57b4-5738-9428-9847ef7afadc")}catch{}})();import{stripVTControlCharacters}from"node:util";import{unicodeSafePrefix}from"../../core/shared/text-normalization.js";import{resolvePmHistoryOperation}from"./command-aliases.js";import{PM_CORE_COMMAND_NAMES}from"./enum-contracts.js";const PM_OUTPUT_DEGRADATION_STEPS=["full","compact","brief","summary","counts"],PM_OUTPUT_BUDGET_CLASSES=["mutation","read","discovery","governance"],PM_DIAGNOSTIC_OUTPUT_CLASSES=["error","warning","validation_summary","recovery_bundle"],PM_DIAGNOSTIC_DEGRADATION_STEPS=["full","omit_explanation","limit_collections","compact_recovery","action_only"],MUTATION_COMMANDS=new Set(["append","claim","close","close-many","close-task","comments","config","copy","create","delete","docs","event","files","focus","history-author-acknowledge","history-compact","history-redact","history-repair","init","item","learnings","meet","notes","pause-task","release","remind","restore","schema","start-task","update","update-many"]),DISCOVERY_COMMANDS=new Set(["contracts","extension","help","install","package","packages","profile","upgrade"]),GOVERNANCE_COMMANDS=new Set(["gc","health","merge","stats","telemetry","test","test-all","validate"]),DEFAULT_MAX_ESTIMATED_TOKENS={mutation:2e3,read:4e3,discovery:3e3,governance:6e3},JSON_BUDGET_NUMERATOR=3,JSON_BUDGET_DENOMINATOR=2,MINIMUM_DIAGNOSTIC_BUDGET=192,DIAGNOSTIC_DEFAULT_BUDGETS={error:{text:768,json:2e3},warning:{text:768,json:2e3},validation_summary:{text:1500,json:3e3},recovery_bundle:{text:768,json:2e3}},PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS=PM_DIAGNOSTIC_OUTPUT_CLASSES.map(diagnosticClass=>({diagnostic_class:diagnosticClass,default_max_estimated_tokens_by_format:DIAGNOSTIC_DEFAULT_BUDGETS[diagnosticClass],minimum_max_estimated_tokens:MINIMUM_DIAGNOSTIC_BUDGET,degradation_ladder:PM_DIAGNOSTIC_DEGRADATION_STEPS,corrective_action_paths:["required","recovery.suggested_retry","recovery.suggested_retry_args","recovery.next_best_command","next_steps[0]"],token_estimate:"ceil(utf8_bytes / 4)"})),DIAGNOSTIC_BUDGET_BY_CLASS=new Map(PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS.map(contract=>[contract.diagnostic_class,contract]));function inferPmOutputBudgetClass(command){const[rootCommand=""]=resolvePmHistoryOperation(command).split(/\s+/u);return MUTATION_COMMANDS.has(rootCommand)?"mutation":DISCOVERY_COMMANDS.has(rootCommand)?"discovery":GOVERNANCE_COMMANDS.has(rootCommand)?"governance":"read"}function createPmCommandOutputBudget(command,budgetClass=inferPmOutputBudgetClass(command)){const normalizedCommand=command.trim().replace(/\s+/gu," ");if(normalizedCommand.length===0)throw new TypeError("command must be a non-empty command path");const toonBudget=DEFAULT_MAX_ESTIMATED_TOKENS[budgetClass];return definePmCommandOutputBudget({command:normalizedCommand,budget_class:budgetClass,default_max_estimated_tokens:toonBudget,default_max_estimated_tokens_by_format:{toon:toonBudget,json:Math.ceil(toonBudget*JSON_BUDGET_NUMERATOR/JSON_BUDGET_DENOMINATOR)},degradation_ladder:PM_OUTPUT_DEGRADATION_STEPS,allows_unbounded_opt_out:!0,token_estimate:"ceil(utf8_bytes / 4)"})}function definePmCommandOutputBudget(contract){if(!Number.isSafeInteger(contract.default_max_estimated_tokens)||contract.default_max_estimated_tokens<=0)throw new RangeError("default_max_estimated_tokens must be a positive safe integer");for(const[format,ceiling]of Object.entries(contract.default_max_estimated_tokens_by_format))if(!Number.isSafeInteger(ceiling)||ceiling<=0)throw new RangeError(`default_max_estimated_tokens_by_format.${format} must be a positive safe integer`);return contract}const PM_COMMAND_OUTPUT_BUDGET_CONTRACTS=PM_CORE_COMMAND_NAMES.map(command=>createPmCommandOutputBudget(command)),OUTPUT_BUDGET_BY_COMMAND=new Map(PM_COMMAND_OUTPUT_BUDGET_CONTRACTS.map(contract=>[contract.command,contract]));function resolvePmCommandOutputBudget(command,options={}){const normalizedCommand=command.trim().replace(/\s+/gu," "),[rootCommand]=resolvePmHistoryOperation(normalizedCommand).split(" "),declared=OUTPUT_BUDGET_BY_COMMAND.get(rootCommand);return declared?{...declared,command:normalizedCommand}:options.generateFallback?createPmCommandOutputBudget(normalizedCommand):null}function estimatePmOutputTokens(utf8Bytes){return Math.ceil(Math.max(0,utf8Bytes)/4)}function resolvePmDiagnosticOutputBudget(diagnosticClass){const contract=DIAGNOSTIC_BUDGET_BY_CLASS.get(diagnosticClass);if(contract===void 0)throw new TypeError(`diagnosticClass must be one of: ${PM_DIAGNOSTIC_OUTPUT_CLASSES.join(", ")}`);return contract}function estimateJsonDiagnosticTokens(value){return estimatePmOutputTokens(Buffer.byteLength(JSON.stringify(value,null,2),"utf8"))}function isDiagnosticRecord(value){return typeof value=="object"&&value!==null&&!Array.isArray(value)}function compactDiagnosticRecovery(value){if(!isDiagnosticRecord(value))return;const compact={};for(const key of["suggested_retry","suggested_retry_args","next_best_command","allowed_values","candidate_commands","missing","missing_required_fields","option_scope","retry_after_ms"]){const candidate=value[key];Array.isArray(candidate)?compact[key]=key==="suggested_retry_args"?candidate:candidate.slice(0,3):candidate!==void 0&&(compact[key]=candidate)}return Object.keys(compact).length>0?compact:void 0}function truncateDiagnosticString(value,maximum){return typeof value!="string"||value.length<=maximum?value:`${unicodeSafePrefix(value,Math.max(1,maximum-3))}...`}function truncateDiagnosticUtf8Text(value,maximumBytes){if(Buffer.byteLength(value,"utf8")<=maximumBytes)return value;const suffix="...",codePoints=Array.from(value);let lower=0,upper=codePoints.length;for(;lower<upper;){const middle=Math.ceil((lower+upper)/2),candidate=`${codePoints.slice(0,middle).join("")}${suffix}`;Buffer.byteLength(candidate,"utf8")<=maximumBytes?lower=middle:upper=middle-1}return`${codePoints.slice(0,lower).join("")}${suffix}`}function prioritizeDiagnosticFields(diagnostic){const prioritized={};for(const key of["code","required","recovery","next_steps","exit_code","type","title","detail","why","examples"])Object.hasOwn(diagnostic,key)&&diagnostic[key]!==void 0&&(prioritized[key]=diagnostic[key]);for(const[key,value]of Object.entries(diagnostic))key!=="__proto__"&&!Object.hasOwn(prioritized,key)&&(prioritized[key]=value);return prioritized}const DIAGNOSTIC_COLLECTION_LIMIT_STAGES=new Set(["limit_collections","compact_recovery","action_only"]),DIAGNOSTIC_RECOVERY_COMPACTION_STAGES=new Set(["compact_recovery","action_only"]);function actionOnlyDiagnostic(candidate){const actionOnly={code:typeof candidate.code=="string"?candidate.code:"diagnostic",required:truncateDiagnosticString(candidate.required,160)??"Inspect the diagnostic code and retry with corrected input."},recovery=compactDiagnosticRecovery(candidate.recovery);return recovery!==void 0?actionOnly.recovery=recovery:Array.isArray(candidate.next_steps)&&(actionOnly.next_steps=candidate.next_steps.slice(0,1)),candidate.exit_code!==void 0&&(actionOnly.exit_code=candidate.exit_code),candidate.type!==void 0&&(actionOnly.type=candidate.type),actionOnly}function diagnosticCandidate(diagnostic,stage){const candidate=structuredClone(diagnostic);if(stage!=="full"&&(delete candidate.why,delete candidate.examples),DIAGNOSTIC_COLLECTION_LIMIT_STAGES.has(stage))for(const[key,value]of Object.entries(candidate))Array.isArray(value)&&(candidate[key]=value.slice(0,3));if(DIAGNOSTIC_RECOVERY_COMPACTION_STAGES.has(stage)){const recovery=compactDiagnosticRecovery(candidate.recovery);recovery?candidate.recovery=recovery:delete candidate.recovery}return stage!=="action_only"?prioritizeDiagnosticFields(candidate):actionOnlyDiagnostic(candidate)}function attachDiagnosticReceipt(candidate,receipt){const projected={...candidate,diagnostic_output:{...receipt,estimated_tokens:0}};for(let attempt=0;attempt<4;attempt+=1){const estimatedTokens=estimateJsonDiagnosticTokens(projected),outputReceipt=projected.diagnostic_output;if(outputReceipt.estimated_tokens===estimatedTokens)break;outputReceipt.estimated_tokens=estimatedTokens}return projected}function shrinkMinimalDiagnosticCandidate(candidate,receipt,budget){let fallback=attachDiagnosticReceipt(candidate,receipt);for(const optionalField of["recovery","exit_code"])estimateJsonDiagnosticTokens(fallback)<=budget||candidate[optionalField]===void 0||(delete candidate[optionalField],fallback=attachDiagnosticReceipt(candidate,receipt));let maximumActionBytes=40;for(;estimateJsonDiagnosticTokens(fallback)>budget&&maximumActionBytes>4;)maximumActionBytes-=4,candidate.code=truncateDiagnosticUtf8Text(String(candidate.code),maximumActionBytes),candidate.required=truncateDiagnosticUtf8Text(String(candidate.required),maximumActionBytes),fallback=attachDiagnosticReceipt(candidate,receipt);return fallback}function createMinimalDiagnosticFallback(projected,budget){const receipt=projected.diagnostic_output,{estimated_tokens:_estimatedTokens,...receiptWithoutEstimate}=receipt,boundedOmittedFields=receiptWithoutEstimate.omitted_fields.slice(0,8).map(field=>truncateDiagnosticUtf8Text(field,32)),boundedReceipt={...receiptWithoutEstimate,omitted_fields:boundedOmittedFields,...receiptWithoutEstimate.omitted_fields.length>boundedOmittedFields.length?{omitted_fields_overflow_count:receiptWithoutEstimate.omitted_fields.length-boundedOmittedFields.length}:{}},recoveryCandidate=compactDiagnosticRecovery(projected.recovery),recovery=recoveryCandidate&&estimateJsonDiagnosticTokens(recoveryCandidate)<=48?recoveryCandidate:void 0,candidate={code:truncateDiagnosticUtf8Text(String(projected.code),320),required:truncateDiagnosticUtf8Text(String(projected.required),320),...recovery?{recovery}:{},...projected.exit_code!==void 0?{exit_code:projected.exit_code}:{}};let fallback=attachDiagnosticReceipt(candidate,boundedReceipt);for(;estimateJsonDiagnosticTokens(fallback)>budget&&boundedReceipt.omitted_fields.length>0;)boundedReceipt.omitted_fields.pop(),boundedReceipt.omitted_fields_overflow_count=receiptWithoutEstimate.omitted_fields.length-boundedReceipt.omitted_fields.length,fallback=attachDiagnosticReceipt(candidate,boundedReceipt);return fallback=shrinkMinimalDiagnosticCandidate(candidate,boundedReceipt,budget),fallback}function projectPmDiagnosticOutput(diagnostic,options={}){const diagnosticRecord=diagnostic,diagnosticClass=options.diagnosticClass??"error",contract=resolvePmDiagnosticOutputBudget(diagnosticClass),explicitBudget=options.maxEstimatedTokens;if(explicitBudget!==void 0&&(!Number.isSafeInteger(explicitBudget)||explicitBudget<contract.minimum_max_estimated_tokens))throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);const budget=explicitBudget??contract.default_max_estimated_tokens_by_format.json,originalEstimatedTokens=estimateJsonDiagnosticTokens(diagnosticRecord),originalFields=Object.keys(diagnosticRecord);if(originalEstimatedTokens<=budget)return prioritizeDiagnosticFields(structuredClone(diagnosticRecord));let projected;for(const[index,stage]of contract.degradation_ladder.entries()){const candidate=diagnosticCandidate(diagnosticRecord,stage),omittedFields=originalFields.filter(field=>!Object.hasOwn(candidate,field)),withReceipt=attachDiagnosticReceipt(candidate,{diagnostic_class:diagnosticClass,format:"json",budget,budget_source:explicitBudget===void 0?"default":"explicit",original_estimated_tokens:originalEstimatedTokens,truncated:index>0,degradation_steps:contract.degradation_ladder.slice(0,index+1),omitted_fields:omittedFields});if(projected=withReceipt,estimateJsonDiagnosticTokens(withReceipt)<=budget)break}return estimateJsonDiagnosticTokens(projected)>budget&&(projected=createMinimalDiagnosticFallback(projected,budget)),projected}function sanitizeDiagnosticText(text){return stripVTControlCharacters(text).replace(/\r\n/gu,`
 `).replace(/[^\P{Cc}\n]/gu," ")}function projectPmDiagnosticText(output,correctiveAction,options={}){const diagnosticClass=options.diagnosticClass??"error",contract=resolvePmDiagnosticOutputBudget(diagnosticClass),explicitBudget=options.maxEstimatedTokens;if(explicitBudget!==void 0&&(!Number.isSafeInteger(explicitBudget)||explicitBudget<contract.minimum_max_estimated_tokens))throw new RangeError(`maxEstimatedTokens must be a safe integer >= ${contract.minimum_max_estimated_tokens}`);const budget=explicitBudget??contract.default_max_estimated_tokens_by_format.text,sanitizedOutput=sanitizeDiagnosticText(output),originalEstimatedTokens=estimatePmOutputTokens(Buffer.byteLength(sanitizedOutput,"utf8")),truncated=originalEstimatedTokens>budget,actionPrefix=`What is required:
   `,actionSuffix=`
 

package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts

@@ -5,19 +5,19 @@
  * normalization, error, filesystem, or item-addressing dependencies.
  */
 /** Global options that consume a following value when one is present. */
-export declare const GLOBAL_VALUE_CONSUMING_FLAGS: Set<string>;
+export declare const GLOBAL_VALUE_CONSUMING_FLAGS:Set<string>;
 /** Boolean global options ignored while locating the command token. */
-export declare const BOOTSTRAP_BOOLEAN_FLAGS: Set<string>;
+export declare const BOOTSTRAP_BOOLEAN_FLAGS:Set<string>;
 /** Whether a global value-consuming flag uses its inline `--flag=value` form. */
-export declare function isInlineGlobalValueToken(token: string): boolean;
+export declare function isInlineGlobalValueToken(token:string):boolean;
 /** Whether a bootstrap value flag consumes its following token. */
-export declare function consumesBootstrapValue(flag: string, next: string | undefined): boolean;
+export declare function consumesBootstrapValue(flag:string,next:string | undefined):boolean;
 /**
  * Locate the first command token after global flags and their values.
  *
  * A leading `--` terminates command discovery. Unknown flags are ignored so
  * later command-specific validation can return the canonical diagnostic.
  */
-export declare function findBootstrapCommandTokenIndex(argv: readonly string[]): number | undefined;
+export declare function findBootstrapCommandTokenIndex(argv:readonly string[]):number | undefined;
 /** Resolve the normalized command name from shell-free invocation arguments. */
-export declare function parseBootstrapCommandName(argv: readonly string[]): string | undefined;
+export declare function parseBootstrapCommandName(argv:readonly string[]):string | undefined;

package/dist/sdk/cli-contracts/command-aliases.d.ts

@@ -12,44 +12,44 @@ export type PmCommandAliasRegistration = "bootstrap" | "commander";
 /** Machine-readable compatibility contract for one executable command alias. */
 export interface PmCommandAliasContract {
 /** Legacy or ergonomic spelling accepted at the command root. */
-alias: string;
+alias:string;
 /** Canonical command path agents should discover and generate. */
-canonical: string;
+canonical:string;
 /** Canonical tokens inserted before user-provided options and arguments. */
-canonical_argv: readonly string[];
+canonical_argv:readonly string[];
 /** Whether the alias is permanent ergonomics or migration-only compatibility. */
-lifecycle: PmCommandAliasLifecycle;
+lifecycle:PmCommandAliasLifecycle;
 /** Whether default help and completion discovery omit the alias. */
-hidden: boolean;
+hidden:boolean;
 /** Runtime layer that keeps the alias executable. */
-registration: PmCommandAliasRegistration;
+registration:PmCommandAliasRegistration;
 /** PM item that owns the compatibility disposition. */
-owner: string;
+owner:string;
 }
 /** History namespace aliases preserve the existing SDK and MCP operation identities. */
-export declare const PM_HISTORY_COMMAND_ALIASES: readonly PmCommandAliasContract[];
+export declare const PM_HISTORY_COMMAND_ALIASES:readonly PmCommandAliasContract[];
 /** Navigation, maintenance, and event aliases share native handlers and stable SDK identities. */
-export declare const PM_CONTEXT_OPS_COMMAND_ALIASES: readonly PmCommandAliasContract[];
+export declare const PM_CONTEXT_OPS_COMMAND_ALIASES:readonly PmCommandAliasContract[];
 /** Bulk lifecycle operations retain their published SDK identities under canonical verbs. */
-export declare const PM_BULK_LIFECYCLE_COMMAND_ALIASES: readonly PmCommandAliasContract[];
+export declare const PM_BULK_LIFECYCLE_COMMAND_ALIASES:readonly PmCommandAliasContract[];
 /** Native handlers relocated into parent commands after core and package registration. */
-export declare const PM_RELOCATED_COMMAND_ALIASES: readonly PmCommandAliasContract[];
+export declare const PM_RELOCATED_COMMAND_ALIASES:readonly PmCommandAliasContract[];
 /** Native noun-verb paths whose stable operation identities survive grammar consolidation. */
-export declare const PM_NAMESPACED_COMMAND_ALIASES: readonly PmCommandAliasContract[];
+export declare const PM_NAMESPACED_COMMAND_ALIASES:readonly PmCommandAliasContract[];
 /** Find the longest declared command prefix without consuming flags or positional operands. */
-export declare function findPmNamespacedCommand(tokens: readonly string[]): PmCommandAliasContract | undefined;
+export declare function findPmNamespacedCommand(tokens:readonly string[]):PmCommandAliasContract | undefined;
 /** Resolve a native command leaf to its stable SDK operation without changing unknown paths. */
-export declare function resolvePmCommandOperation(command: string): string;
+export declare function resolvePmCommandOperation(command:string):string;
 /** Compatibility entrypoint for hosts that adopted namespace resolution with history. */
-export declare function resolvePmHistoryOperation(command: string): string;
+export declare function resolvePmHistoryOperation(command:string):string;
 /**
  * Public command-alias table. Deprecated aliases must remain executable but
  * are intentionally absent from default help and completion discovery.
  */
-export declare const PM_COMMAND_ALIAS_CONTRACTS: readonly PmCommandAliasContract[];
+export declare const PM_COMMAND_ALIAS_CONTRACTS:readonly PmCommandAliasContract[];
 /** High-frequency executable aliases whose targets accept identical arguments. */
-export declare const EXECUTABLE_COMMAND_ALIASES: Readonly<Record<string, string>>;
+export declare const EXECUTABLE_COMMAND_ALIASES:Readonly<Record<string,string>>;
 /** Resolve one declared command alias without inferring from its spelling. */
-export declare function resolvePmCommandAlias(alias: string): PmCommandAliasContract | undefined;
+export declare function resolvePmCommandAlias(alias:string):PmCommandAliasContract | undefined;
 /** Render the stable one-line migration hint emitted for deprecated aliases. */
-export declare function renderPmCommandAliasMigrationHint(contract: PmCommandAliasContract): string;
+export declare function renderPmCommandAliasMigrationHint(contract:PmCommandAliasContract):string;

package/dist/sdk/cli-contracts/command-exit-contracts.d.ts

@@ -5,114 +5,114 @@ export type PmCommandExitOutcome = "effect" | "internal_failure" | "refused_inpu
 /** Meaning and success semantics for one stable process exit. */
 export interface PmCommandExitOutcomeContract {
 /** Stable process exit visible without parsing stdout. */
-exit_code: PmCommandExitCode;
+exit_code:PmCommandExitCode;
 /** Effect-oriented result independent of implementation details. */
-outcome: PmCommandExitOutcome;
+outcome:PmCommandExitOutcome;
 /** Whether the command completed its requested control flow successfully. */
-success: boolean;
+success:boolean;
 /** Concise operator-facing meaning. */
-meaning: string;
+meaning:string;
 }
 /** Declared numeric exits for one core command path. */
 export interface PmCommandExitContract {
 /** Normalized command path. */
-command: string;
+command:string;
 /** Exhaustive exits the command may emit. */
-exit_codes: readonly PmCommandExitCode[];
+exit_codes:readonly PmCommandExitCode[];
 }
 /** One replay observation used to verify command exit declarations. */
 export interface PmCommandExitObservation {
 /** Command path executed by the replay. */
-command: string;
+command:string;
 /** Process exit observed from the real command boundary. */
-exit_code: number;
+exit_code:number;
 /** Stable replay case identifier for diagnostics. */
-replay_id: string;
+replay_id:string;
 }
 /** Drift report produced by exit-contract replay conformance. */
 export interface PmCommandExitConformanceReport {
 /** Whether all declaration and observation checks passed. */
-ok: boolean;
+ok:boolean;
 /** Expected commands without a declaration. */
-missing_commands: string[];
+missing_commands:string[];
 /** Observations whose command or numeric exit is undeclared. */
-undeclared_observations: PmCommandExitObservation[];
+undeclared_observations:PmCommandExitObservation[];
 /** Declared numeric outcomes not reached anywhere in the replay corpus. */
-unreachable_exit_codes: PmCommandExitCode[];
+unreachable_exit_codes:PmCommandExitCode[];
 }
 /** Canonical effect vocabulary for all stable CLI process exits. */
-export declare const PM_COMMAND_EXIT_OUTCOME_CONTRACTS: readonly [{
-readonly exit_code: 0;
-readonly outcome: "effect";
-readonly success: true;
-readonly meaning: "The requested operation completed with its intended effect.";
-}, {
-readonly exit_code: 1;
-readonly outcome: "internal_failure";
-readonly success: false;
-readonly meaning: "An unexpected runtime or internal failure prevented completion.";
-}, {
-readonly exit_code: 2;
-readonly outcome: "refused_input";
-readonly success: false;
-readonly meaning: "The invocation was refused because its input or composition was invalid.";
-}, {
-readonly exit_code: 3;
-readonly outcome: "refused_tracker_state";
-readonly success: false;
-readonly meaning: "The requested tracker, item, or resource was not present.";
-}, {
-readonly exit_code: 4;
-readonly outcome: "conflict";
-readonly success: false;
-readonly meaning: "Current state or concurrency prevented the requested effect.";
-}, {
-readonly exit_code: 5;
-readonly outcome: "dependency_failed";
-readonly success: false;
-readonly meaning: "A required dependency operation failed.";
-}, {
-readonly exit_code: 6;
-readonly outcome: "no_effect";
-readonly success: true;
-readonly meaning: "The request was valid and completed, but matched nothing to change.";
-}, {
-readonly exit_code: 7;
-readonly outcome: "partial_effect";
-readonly success: true;
-readonly meaning: "The request completed and changed some, but not all, selected targets.";
+export declare const PM_COMMAND_EXIT_OUTCOME_CONTRACTS:readonly [{
+readonly exit_code:0;
+readonly outcome:"effect";
+readonly success:true;
+readonly meaning:"The requested operation completed with its intended effect.";
+},{
+readonly exit_code:1;
+readonly outcome:"internal_failure";
+readonly success:false;
+readonly meaning:"An unexpected runtime or internal failure prevented completion.";
+},{
+readonly exit_code:2;
+readonly outcome:"refused_input";
+readonly success:false;
+readonly meaning:"The invocation was refused because its input or composition was invalid.";
+},{
+readonly exit_code:3;
+readonly outcome:"refused_tracker_state";
+readonly success:false;
+readonly meaning:"The requested tracker, item, or resource was not present.";
+},{
+readonly exit_code:4;
+readonly outcome:"conflict";
+readonly success:false;
+readonly meaning:"Current state or concurrency prevented the requested effect.";
+},{
+readonly exit_code:5;
+readonly outcome:"dependency_failed";
+readonly success:false;
+readonly meaning:"A required dependency operation failed.";
+},{
+readonly exit_code:6;
+readonly outcome:"no_effect";
+readonly success:true;
+readonly meaning:"The request was valid and completed, but matched nothing to change.";
+},{
+readonly exit_code:7;
+readonly outcome:"partial_effect";
+readonly success:true;
+readonly meaning:"The request completed and changed some, but not all, selected targets.";
 }];
 /** Exhaustive core command exit declarations generated from the command registry. */
-export declare const PM_COMMAND_EXIT_CONTRACTS: readonly PmCommandExitContract[];
+export declare const PM_COMMAND_EXIT_CONTRACTS:readonly PmCommandExitContract[];
 /** Stable successful process exits, including machine-distinct effect states. */
-export declare const PM_SUCCESS_EXIT_CODES: readonly [0, 6, 7];
+export declare const PM_SUCCESS_EXIT_CODES:readonly [0,6,7];
 /** Portable success effect reported by command result envelopes. */
 export type PmCommandEffect = "effect" | "no_effect" | "partial_effect" | "dependency_failed";
 /** Shell and envelope representation of one command effect or collected failure. */
 export interface PmCommandEffectReceipt {
 /** Semantic effect observed after command execution. */
-outcome: PmCommandEffect;
+outcome:PmCommandEffect;
 /** Stable shell exit paired with the effect. */
-exit_code: 0 | 5 | 6 | 7;
+exit_code:0 | 5 | 6 | 7;
 }
 /** Counts used to derive one bulk mutation's effect without parsing prose. */
 export interface PmBulkMutationEffectCounts {
 /** Rows that completed the requested mutation. */
-applied: number;
+applied:number;
 /** Rows deliberately left unchanged. */
-skipped: number;
+skipped:number;
 /** Rows whose attempted mutation failed. */
-failed: number;
+failed:number;
 /** Explicit requested identifiers that did not exist. */
-unmatched: number;
+unmatched:number;
 }
 /** Return whether an exit represents a successful command outcome. */
-export declare function isPmSuccessfulExitCode(exitCode: number): boolean;
+export declare function isPmSuccessfulExitCode(exitCode:number):boolean;
 /** Return whether an exit belongs to the declared pm process vocabulary. */
-export declare function isPmKnownExitCode(exitCode: number): exitCode is PmCommandExitCode;
+export declare function isPmKnownExitCode(exitCode:number):exitCode is PmCommandExitCode;
 /** Resolve an exact command contract, falling back to its declared root path. */
-export declare function resolvePmCommandExitContract(commandPath: string): PmCommandExitContract | undefined;
+export declare function resolvePmCommandExitContract(commandPath:string):PmCommandExitContract | undefined;
 /** Verify command coverage, observed exits, and vocabulary reachability for a replay corpus. */
-export declare function analyzePmCommandExitConformance(observations: readonly PmCommandExitObservation[], expectedCommands?: readonly string[], contracts?: readonly PmCommandExitContract[]): PmCommandExitConformanceReport;
+export declare function analyzePmCommandExitConformance(observations:readonly PmCommandExitObservation[],expectedCommands?:readonly string[],contracts?:readonly PmCommandExitContract[]):PmCommandExitConformanceReport;
 /** Derive deterministic full, empty, partial, or failed semantics for a bulk mutation. */
-export declare function derivePmBulkMutationEffect(counts: PmBulkMutationEffectCounts): PmCommandEffectReceipt;
+export declare function derivePmBulkMutationEffect(counts:PmBulkMutationEffectCounts):PmCommandEffectReceipt;

package/dist/sdk/cli-contracts/commander-mutation-options.d.ts

@@ -3,16 +3,16 @@
  *
  * Defines SDK command-contract metadata for Commander Mutation Options.
  */
-import type { CommanderOptionAliasContract, CommanderOptionRegistrationContract } from "./commander-types.js";
+import type { CommanderOptionAliasContract,CommanderOptionRegistrationContract } from "./commander-types.js";
 /** Creates commander option registration contracts using the validated operation inputs. */
-export declare const CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS: CommanderOptionRegistrationContract[];
+export declare const CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS:CommanderOptionRegistrationContract[];
 /** Creates commander string option contracts using the validated operation inputs. */
-export declare const CREATE_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const CREATE_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Creates commander repeatable option contracts using the validated operation inputs. */
-export declare const CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for update commander option registration contracts, shared by SDK and presentation-layer consumers. */
-export declare const UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS: CommanderOptionRegistrationContract[];
+export declare const UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS:CommanderOptionRegistrationContract[];
 /** Public contract for update commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for update commander repeatable option contracts, shared by SDK and presentation-layer consumers. */
-export declare const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS:CommanderOptionAliasContract[];

package/dist/sdk/cli-contracts/commander-types.d.ts

@@ -6,41 +6,41 @@
 /** Describes aliases accepted by Commander option registration contracts. */
 export interface CommanderOptionAliasContract {
 /** Canonical SDK option key receiving the selected alias value. */
-target: string;
+target:string;
 /** Commander option keys in precedence order; the first matching value wins. */
-keys: readonly string[];
+keys:readonly string[];
 }
 /** Declares Commander registration syntax and how its parsed values map to SDK options. */
 export interface CommanderOptionRegistrationContract extends CommanderOptionAliasContract {
 /** Commander flag syntax, including short aliases and argument placeholders. */
-option: string;
+option:string;
 /** Human-readable flag help displayed by Commander. */
-description: string;
+description:string;
 /** Whether Commander requires this option to be supplied. */
-required?: boolean;
+required?:boolean;
 /** Whether repeated occurrences accumulate values instead of replacing the previous value. */
-repeatable?: boolean;
+repeatable?:boolean;
 /** Inputs that customize the alias operation. */
-aliasOptions?: Array<{
-option: string;
-description: string;
+aliasOptions?:Array<{
+option:string;
+description:string;
 }>;
 }
 /** Public contract for list commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const LIST_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const LIST_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for search commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for calendar commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for context commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for next commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const NEXT_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const NEXT_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Public contract for activity commander string option contracts, shared by SDK and presentation-layer consumers. */
-export declare const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
+export declare const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS:CommanderOptionAliasContract[];
 /** Return the first string-valued alias in declared precedence order, including an explicitly empty string. */
-export declare function readFirstStringFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): string | undefined;
+export declare function readFirstStringFromCommanderOptions(options:Record<string,unknown>,contract:CommanderOptionAliasContract):string | undefined;
 /** Return the first own alias property, preserving explicitly undefined values and ignoring inherited properties. */
-export declare function readFirstValueFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): unknown;
+export declare function readFirstValueFromCommanderOptions(options:Record<string,unknown>,contract:CommanderOptionAliasContract):unknown;
 /** Concatenate string entries from all array-valued aliases in declaration order; return undefined when none remain. */
-export declare function readStringArrayFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): string[] | undefined;
+export declare function readStringArrayFromCommanderOptions(options:Record<string,unknown>,contract:CommanderOptionAliasContract):string[] | undefined;

package/dist/sdk/cli-contracts/completeness.d.ts

@@ -13,37 +13,37 @@ export type SdkCliParameterDisposition = "shared" | "compatibility_alias" | "cli
 /** One directional input in the SDK/CLI parameter-coverage matrix. */
 export interface SdkCliParameterCoverageEntry {
 /** Surface where the input is declared. */
-surface: "cli" | "sdk";
+surface:"cli" | "sdk";
 /** CLI flag or SDK parameter name. */
-input: string;
+input:string;
 /** Equivalent input on the other surface when one exists. */
-counterpart?: string;
+counterpart?:string;
 /** Machine-readable coverage or waiver classification. */
-disposition: SdkCliParameterDisposition;
+disposition:SdkCliParameterDisposition;
 /** Stable explanation suitable for a contract report or CI failure. */
-reason: string;
+reason:string;
 }
 /** Complete bidirectional parameter coverage for one public action. */
 export interface SdkCliActionParameterCoverage {
 /** Public SDK action. */
-action: PmToolAction;
+action:PmToolAction;
 /** CLI command path associated with the action. */
-command: string;
+command:string;
 /** Every canonical CLI long flag and its disposition. */
-cli: SdkCliParameterCoverageEntry[];
+cli:SdkCliParameterCoverageEntry[];
 /** Every strict SDK action parameter and its disposition. */
-sdk: SdkCliParameterCoverageEntry[];
+sdk:SdkCliParameterCoverageEntry[];
 /** Inputs lacking an approved bidirectional disposition. */
-unclassified: SdkCliParameterCoverageEntry[];
+unclassified:SdkCliParameterCoverageEntry[];
 }
 /** Injectable contract readers used by negative controls and downstream gates. */
 export interface SdkCliCompletenessContractSource {
 /** Actions to analyze. */
-actions?: readonly PmToolAction[];
+actions?:readonly PmToolAction[];
 /** Resolve long-flag contracts for a CLI command path. */
-resolveFlags?: (command: string) => CliFlagContract[];
+resolveFlags?:(command:string) => CliFlagContract[];
 /** Resolve strict SDK parameters for an action. */
-resolveParameters?: (action: PmToolAction) => string[] | undefined;
+resolveParameters?:(action:PmToolAction) => string[] | undefined;
 }
 /**
  * Analyze every public action from live CLI and strict schema contracts.
@@ -51,4 +51,4 @@ resolveParameters?: (action: PmToolAction) => string[] | undefined;
  * Unknown CLI flags fail closed as `unclassified`; SDK-only inputs remain
  * visible as per-parameter `sdk_native` dispositions for shrinking baselines.
  */
-export declare function analyzeSdkCliParameterCompleteness(source?: SdkCliCompletenessContractSource): SdkCliActionParameterCoverage[];
+export declare function analyzeSdkCliParameterCompleteness(source?:SdkCliCompletenessContractSource):SdkCliActionParameterCoverage[];

package/dist/sdk/cli-contracts/enum-contracts.d.ts

@@ -1,48 +1,48 @@
 export { WORKFLOW_POLICY_ACTIONS } from "../../core/policy/workflow-policy.js";
 /** Public contract for pm extension capability contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_CAPABILITY_CONTRACTS: readonly ["commands", "renderers", "hooks", "schema", "importers", "search", "parser", "preflight", "services"];
+export declare const PM_EXTENSION_CAPABILITY_CONTRACTS:readonly ["commands","renderers","hooks","schema","importers","search","parser","preflight","services"];
 /** Restricts pm extension capability contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionCapabilityContract = (typeof PM_EXTENSION_CAPABILITY_CONTRACTS)[number];
 /** Public contract for pm extension service name contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_SERVICE_NAME_CONTRACTS: readonly ["output_format", "error_format", "help_format", "lock_acquire", "lock_release", "history_append", "item_store_write", "item_store_delete", "context_relevance", "command_result"];
+export declare const PM_EXTENSION_SERVICE_NAME_CONTRACTS:readonly ["output_format","error_format","help_format","lock_acquire","lock_release","history_append","item_store_write","item_store_delete","context_relevance","command_result"];
 /** Restricts pm extension service name contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionServiceNameContract = (typeof PM_EXTENSION_SERVICE_NAME_CONTRACTS)[number];
 /** Public contract for pm extension policy mode contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_POLICY_MODE_CONTRACTS: readonly ["off", "warn", "enforce"];
+export declare const PM_EXTENSION_POLICY_MODE_CONTRACTS:readonly ["off","warn","enforce"];
 /** Restricts pm extension policy mode contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionPolicyModeContract = (typeof PM_EXTENSION_POLICY_MODE_CONTRACTS)[number];
 /** Public contract for pm extension trust mode contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_TRUST_MODE_CONTRACTS: readonly ["off", "warn", "enforce"];
+export declare const PM_EXTENSION_TRUST_MODE_CONTRACTS:readonly ["off","warn","enforce"];
 /** Restricts pm extension trust mode contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionTrustModeContract = (typeof PM_EXTENSION_TRUST_MODE_CONTRACTS)[number];
 /** Public contract for pm extension sandbox profile contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS: readonly ["none", "restricted", "strict"];
+export declare const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS:readonly ["none","restricted","strict"];
 /** Restricts pm extension sandbox profile contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionSandboxProfileContract = (typeof PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS)[number];
 /** Public contract for pm extension policy surface contracts, shared by SDK and presentation-layer consumers. */
-export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.beforemutation", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.relationshipkinds", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore", "services.assuranceprovider"];
+export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS:readonly ["commands.override","commands.handler","hooks.beforecommand","hooks.beforemutation","hooks.aftercommand","hooks.onwrite","hooks.onread","hooks.onindex","schema.flags","schema.itemfields","schema.itemtypes","schema.relationshipkinds","schema.migrations","schema.profiles","parser.override","preflight.override","services.override","renderers.override","importers.importer","importers.exporter","search.provider","search.vectorstore","services.assuranceprovider"];
 /** Restricts pm extension policy surface contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];
 /** Public contract for pm core command names, shared by SDK and presentation-layer consumers. */
-export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "package", "packages", "install", "upgrade", "create", "item", "copy", "focus", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "context", "ctx", "get", "graph", "search", "duplicates", "eval", "next", "history", "events", "history-redact", "history-repair", "history-compact", "history-attest", "history-author-acknowledge", "merge", "schema", "profile", "activity", "restore", "update", "update-many", "close", "close-many", "delete", "append", "comments", "notes", "learnings", "files", "docs", "deps", "plan", "test", "test-all", "telemetry", "stats", "health", "validate", "assurance", "gc", "workspace", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "meet", "event", "remind", "help"];
+export declare const PM_CORE_COMMAND_NAMES:readonly ["init","config","extension","package","packages","install","upgrade","create","item","copy","focus","list","list-all","list-draft","list-open","list-in-progress","list-blocked","list-closed","list-canceled","aggregate","context","ctx","get","graph","search","duplicates","eval","next","history","events","history-redact","history-repair","history-compact","history-attest","history-author-acknowledge","merge","schema","profile","activity","restore","update","update-many","close","close-many","delete","append","comments","notes","learnings","files","docs","deps","plan","test","test-all","telemetry","stats","health","validate","assurance","gc","workspace","contracts","claim","release","start-task","pause-task","close-task","meet","event","remind","help"];
 /** Supported values accepted by the graph subcommand contract across CLI, SDK, and MCP surfaces. */
-export declare const GRAPH_SUBCOMMAND_VALUES: readonly ["ancestors", "descendants", "predecessors", "successors", "paths", "impact", "analyze", "audit", "communities", "redundancy", "dominators", "slack", "centrality", "articulation", "plan", "index"];
+export declare const GRAPH_SUBCOMMAND_VALUES:readonly ["ancestors","descendants","predecessors","successors","paths","impact","analyze","audit","communities","redundancy","dominators","slack","centrality","articulation","plan","index"];
 /** Restricts graph subcommand values accepted by command, SDK, and MCP contracts. */
 export type GraphSubcommand = (typeof GRAPH_SUBCOMMAND_VALUES)[number];
 /** Supported values accepted by the merge subcommand contract across CLI and SDK surfaces. */
-export declare const MERGE_SUBCOMMAND_VALUES: readonly ["install", "reconcile", "report", "driver"];
+export declare const MERGE_SUBCOMMAND_VALUES:readonly ["install","reconcile","report","driver"];
 /** Restricts merge subcommand values accepted by command and SDK contracts. */
 export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];
 /** Nested lifecycle verbs flattened by SDK and MCP package actions. */
-export declare const PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS: readonly ["init", "install", "uninstall", "explore", "manage", "describe", "reload", "doctor", "catalog", "adopt", "adopt-all", "activate", "deactivate"];
+export declare const PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS:readonly ["init","install","uninstall","explore","manage","describe","reload","doctor","catalog","adopt","adopt-all","activate","deactivate"];
 /** Package-only lifecycle verbs flattened by SDK and MCP package actions. */
-export declare const PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS: readonly ["upgrade"];
+export declare const PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS:readonly ["upgrade"];
 /** Noun-first item lifecycle verbs flattened for SDK and MCP dispatch. */
-export declare const PM_ITEM_ACTION_SUBCOMMANDS: readonly ["reopen"];
+export declare const PM_ITEM_ACTION_SUBCOMMANDS:readonly ["reopen"];
 /** CLI-only presentation commands intentionally omitted from programmatic actions. */
-export declare const PM_CLI_ONLY_TOOL_ACTION_WAIVERS: {
-readonly help: "Commander help rendering has no SDK operation result.";
-readonly packages: "The plural package alias only renders package-oriented help.";
+export declare const PM_CLI_ONLY_TOOL_ACTION_WAIVERS:{
+readonly help:"Commander help rendering has no SDK operation result.";
+readonly packages:"The plural package alias only renders package-oriented help.";
 };
 type PmCoreCommandName = (typeof PM_CORE_COMMAND_NAMES)[number];
 type PmCliOnlyToolAction = keyof typeof PM_CLI_ONLY_TOOL_ACTION_WAIVERS;
@@ -50,29 +50,29 @@ type PmExtensionPackageAction = `${"extension" | "package"}-${(typeof PM_EXTENSI
 type PmPackageOnlyAction = `package-${(typeof PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS)[number]}`;
 type PmItemAction = `item-${(typeof PM_ITEM_ACTION_SUBCOMMANDS)[number]}`;
 /** Restricts pm tool action values accepted by command, SDK, and storage contracts. */
-export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | "item"> | PmExtensionPackageAction | PmPackageOnlyAction | PmItemAction;
+export type PmToolAction = Exclude<PmCoreCommandName,PmCliOnlyToolAction | "item"> | PmExtensionPackageAction | PmPackageOnlyAction | PmItemAction;
 /**
  * Public pm tool actions derived from the CLI vocabulary. Nested extension and
  * package verbs are flattened for transports that expose one action string.
  */
-export declare const PM_TOOL_ACTIONS: readonly PmToolAction[];
+export declare const PM_TOOL_ACTIONS:readonly PmToolAction[];
 /** Deprecated compatibility actions accepted by the SDK but omitted from canonical MCP discovery. */
-export declare const PM_DEPRECATED_TOOL_ACTIONS: readonly PmToolAction[];
+export declare const PM_DEPRECATED_TOOL_ACTIONS:readonly PmToolAction[];
 /** Canonical actions presented to MCP clients and unscoped contract consumers. */
-export declare const PM_DISCOVERABLE_TOOL_ACTIONS: readonly PmToolAction[];
+export declare const PM_DISCOVERABLE_TOOL_ACTIONS:readonly PmToolAction[];
 /** Static CLI-to-tool action parity evidence used by quality gates and tests. */
-export declare function analyzePmToolActionParity(cliCommands?: readonly string[], toolActions?: readonly string[], waivers?: Readonly<Record<string, string>>): {
-missing_cli_actions: string[];
-waived_cli_actions: string[];
-stale_waivers: string[];
+export declare function analyzePmToolActionParity(cliCommands?:readonly string[],toolActions?:readonly string[],waivers?:Readonly<Record<string,string>>):{
+missing_cli_actions:string[];
+waived_cli_actions:string[];
+stale_waivers:string[];
 };
 /** Implements check whether pm tool action for the public runtime surface of this module. */
-export declare function isPmToolAction(value: string): value is PmToolAction;
+export declare function isPmToolAction(value:string):value is PmToolAction;
 /** Implements check whether pm extension capability contract for the public runtime surface of this module. */
-export declare function isPmExtensionCapabilityContract(value: string): value is PmExtensionCapabilityContract;
+export declare function isPmExtensionCapabilityContract(value:string):value is PmExtensionCapabilityContract;
 /** Implements check whether pm extension service name contract for the public runtime surface of this module. */
-export declare function isPmExtensionServiceNameContract(value: string): value is PmExtensionServiceNameContract;
+export declare function isPmExtensionServiceNameContract(value:string):value is PmExtensionServiceNameContract;
 /** Implements check whether pm extension policy mode contract for the public runtime surface of this module. */
-export declare function isPmExtensionPolicyModeContract(value: string): value is PmExtensionPolicyModeContract;
+export declare function isPmExtensionPolicyModeContract(value:string):value is PmExtensionPolicyModeContract;
 /** Implements check whether pm extension policy surface contract for the public runtime surface of this module. */
-export declare function isPmExtensionPolicySurfaceContract(value: string): value is PmExtensionPolicySurfaceContract;
+export declare function isPmExtensionPolicySurfaceContract(value:string):value is PmExtensionPolicySurfaceContract;