@unbrained/pm-cli 2026.10.3 → 2026.10.5

package/dist/sdk/similarity.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]="8d07624c-8663-5aba-8018-1b2c47997bef")}catch(e2){}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{isTerminalStatus,normalizeStatusInput}from"../core/item/status.js";import{resolveRuntimeStatusRegistry}from"../core/schema/runtime-schema.js";import{listAllItemMetadataLight}from"../core/store/item-store.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{readItemMetadataDerivedIndexState}from"../core/store/item-metadata-cache.js";import{querySimilarItemMetadataIndex}from"../core/store/item-metadata-query-index.js";import{collectDuplicateCandidatePairs,MAX_DUPLICATE_CANDIDATE_PAIRS}from"./query/duplicate-candidates.js";import{prepareSimilarityText,scoreItemSimilarity,scorePreparedItemSimilarity,tokenizeSimilarityText}from"./similarity-scoring.js";import{jaccardSimilarity,normalizeSimilarityText,prepareSimilarityText as prepareSimilarityText2,scoreItemSimilarity as scoreItemSimilarity2,scorePreparedItemSimilarity as scorePreparedItemSimilarity2,tokenizeSimilarityText as tokenizeSimilarityText2}from"./similarity-scoring.js";const DEFAULT_SIMILARITY_LIMIT=3;const MAX_SIMILARITY_LIMIT=20;const DEFAULT_SIMILARITY_THRESHOLD=.8;const DEFAULT_DUPLICATE_CLUSTER_LIMIT=100;const MAX_DUPLICATE_CLUSTER_LIMIT=1e3;function similarityAdvisoryWarnings(advisory){return advisory===void 0?[]:[`likely_duplicates:${advisory.result.items.map(item=>item.id).join(",")}`,`likely_duplicate_recovery:${advisory.recovery.action}:${advisory.recovery.item_id}`]}async function resolveSimilarityRecovery(result,options){const strongest=result.items[0];const pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot);const statusRegistry=resolveRuntimeStatusRegistry((await readSettings(pmRoot)).schema);if(isTerminalStatus(strongest.status,statusRegistry)){return{action:"reopen",item_id:strongest.id,command:`pm item reopen ${strongest.id} "<recurrence reason>"`,args:["item","reopen",strongest.id,"<recurrence reason>"]}}return{action:"reuse",item_id:strongest.id,command:`pm get ${strongest.id} --full`,args:["get",strongest.id,"--full"]}}function validateSimilarityOptions(options){const limit=options.limit??DEFAULT_SIMILARITY_LIMIT;const threshold=options.threshold??DEFAULT_SIMILARITY_THRESHOLD;if(!Number.isSafeInteger(limit)||limit<0||limit>MAX_SIMILARITY_LIMIT){throw new PmCliError(`Similarity limit must be an integer from 0 to ${MAX_SIMILARITY_LIMIT}.`,EXIT_CODE.USAGE)}if(!Number.isFinite(threshold)||threshold<0||threshold>1){throw new PmCliError("Similarity threshold must be a number from 0 to 1.",EXIT_CODE.USAGE)}return{limit,threshold}}function validateDuplicateClusterOptions(options){const limit=options.limit??DEFAULT_DUPLICATE_CLUSTER_LIMIT;if(!Number.isSafeInteger(limit)||limit<0||limit>MAX_DUPLICATE_CLUSTER_LIMIT){throw new PmCliError(`Duplicate cluster limit must be an integer from 0 to ${MAX_DUPLICATE_CLUSTER_LIMIT}.`,EXIT_CODE.USAGE)}const since=options.since===void 0?void 0:new Date(options.since);if(since&&Number.isNaN(since.getTime())){throw new PmCliError("Duplicate cluster --since must be a valid ISO timestamp.",EXIT_CODE.USAGE)}return{limit,since}}async function loadDuplicateItems(options,since){const pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings);const requestedStatuses=options.statuses?.map(status=>status.trim().toLowerCase()).filter(Boolean);if(options.statuses!==void 0&&requestedStatuses?.length===0){throw new PmCliError("Duplicate cluster statuses must include at least one lifecycle status or all.",EXIT_CODE.USAGE)}const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const normalizedStatuses=requestedStatuses?.map(status=>{if(status==="all")return status;const normalized=normalizeStatusInput(status,statusRegistry);if(!normalized){throw new PmCliError(`Unknown duplicate-cluster status "${status}". Allowed: all, ${statusRegistry.definitions.map(entry=>entry.id).join(", ")}.`,EXIT_CODE.USAGE)}return normalized});const hasAll=normalizedStatuses?.includes("all")===true;if(hasAll&&normalizedStatuses?.some(status=>status!=="all")){throw new PmCliError('The "all" status cannot be combined with other statuses.',EXIT_CODE.USAGE)}const effectiveStatuses=hasAll?void 0:normalizedStatuses;const allowedStatuses=effectiveStatuses?new Set(effectiveStatuses):void 0;return{items:(await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema)).filter(item=>(!allowedStatuses||allowedStatuses.has(item.status))&&(!since||new Date(item.created_at).getTime()>=since.getTime())),statuses:effectiveStatuses}}const _testOnlySimilarity={buildDuplicateClusters,collectDuplicateCandidatePairs,createDuplicateUnionFind};function createDuplicateUnionFind(size){const parent=Array.from({length:size},(_entry,index)=>index);const findRoot=index=>{let root=index;while(parent[root]!==root)root=parent[root];while(parent[index]!==index){const next=parent[index];parent[index]=root;index=next}return root};return{parent,findRoot}}function scoreDuplicateCandidates(items,candidates,threshold,union){const matches=[];for(const candidate of candidates){const[leftIndex,rightIndex]=candidate.split(":").map(value=>Number.parseInt(value,10));const scored=scorePreparedItemSimilarity(items[leftIndex].prepared,items[rightIndex].prepared);if(scored.score<threshold)continue;const leftRoot=union.findRoot(leftIndex);const rightRoot=union.findRoot(rightIndex);if(leftRoot!==rightRoot)union.parent[rightRoot]=leftRoot;matches.push({left_id:items[leftIndex].item.id,right_id:items[rightIndex].item.id,...scored})}return matches}function buildDuplicateClusters(items,matches,union,limit){const components=new Map;for(const index of items.keys()){const root=union.findRoot(index);const component=components.get(root)??[];component.push(index);components.set(root,component)}const rootsById=new Map(items.map(({item},index)=>[item.id,union.findRoot(index)]));const matchesByRoot=new Map;for(const match of matches){const root=rootsById.get(match.left_id);const rows=matchesByRoot.get(root)??[];rows.push(match);matchesByRoot.set(root,rows)}return[...components.values()].filter(component=>component.length>1).map(component=>{const clusterMatches=(matchesByRoot.get(union.findRoot(component[0]))??[]).sort((left,right)=>right.score-left.score||left.left_id.localeCompare(right.left_id)||left.right_id.localeCompare(right.right_id));return{id:items[component[0]].item.id,items:component.map(itemIndex=>{const item=items[itemIndex].item;return{id:item.id,title:item.title,status:item.status,type:item.type}}),matches:clusterMatches,max_score:clusterMatches[0]?.score??0}}).sort((left,right)=>right.max_score-left.max_score||left.id.localeCompare(right.id)).slice(0,limit)}function rankSimilarItems(title,candidates,excludedIds,threshold,limit){return candidates.filter(item=>!excludedIds.has(item.id)).map(item=>({id:item.id,title:item.title,status:item.status,type:item.type,...scoreItemSimilarity(title,item.title)})).filter(item=>item.score>=threshold).sort((left,right)=>right.score-left.score||left.id.localeCompare(right.id)).slice(0,limit)}async function findSimilarItems(candidate,options={}){const title=candidate.title.trim();if(title.length===0){throw new PmCliError("Similarity candidate title must not be empty.",EXIT_CODE.USAGE)}const{limit,threshold}=validateSimilarityOptions(options);const pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings);const indexState=await readItemMetadataDerivedIndexState(pmRoot,Object.values(typeRegistry.type_to_folder));const tokens=tokenizeSimilarityText(title);const indexed=indexState&&tokens.length>0?await querySimilarItemMetadataIndex({pmRoot,expectedSourceCursor:indexState.source_cursor,query:tokens.map(token=>`"${token.replaceAll('"','""')}"`).join(" OR "),limit:Math.max(limit*10,50)}):null;const candidates=indexed===null?await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema):indexed.items;const items=rankSimilarItems(title,candidates,new Set(candidate.excludeIds??[]),threshold,limit);return{items,count:items.length,threshold,source:indexed?"persistent_index":"metadata_fallback"}}function analyzeDuplicateItems(input,options={}){const{threshold}=validateSimilarityOptions({...options,limit:void 0});const{limit}=validateDuplicateClusterOptions(options);const ids=new Set;for(const item of input){if(!item.id.trim()||ids.has(item.id)){throw new PmCliError("Duplicate analysis requires unique non-empty item ids.",EXIT_CODE.USAGE)}ids.add(item.id)}const items=[...input].sort((left,right)=>left.id.localeCompare(right.id)).map(item=>({item,prepared:prepareSimilarityText(item.title)}));const candidates=collectDuplicateCandidatePairs(items,MAX_DUPLICATE_CANDIDATE_PAIRS,threshold,options.exhaustive===true);const union=createDuplicateUnionFind(items.length);const matches=scoreDuplicateCandidates(items,candidates,threshold,union);const clusters=buildDuplicateClusters(items,matches,union,limit);return{clusters,count:clusters.length,threshold,cost:{item_count:items.length,algorithm:options.exhaustive===true||threshold===0?"exhaustive":"prefix_exact",possible_pairs:items.length*(items.length-1)/2,pair_limit:MAX_DUPLICATE_CANDIDATE_PAIRS,recall_guarantee:"exact",candidate_pairs:candidates.size,scored_pairs:candidates.size}}}async function findDuplicateClusters(options={}){validateSimilarityOptions({...options,limit:void 0});const{since}=validateDuplicateClusterOptions(options);const{items,statuses}=await loadDuplicateItems(options,since);return{...analyzeDuplicateItems(items,options),source:"metadata_scan",filters:{statuses:statuses??null,since:options.since??null}}}async function evaluateSimilarityGovernance(candidate,options){if(options.mode==="off")return void 0;const result=await findSimilarItems(candidate,options);if(result.count===0)return void 0;const recovery=await resolveSimilarityRecovery(result,options);const bypassed=options.mode==="strict"&&options.allowDuplicate===true;if(options.mode==="strict"&&!bypassed){const candidates=result.items.map(item=>`${item.id} (${item.status}): ${item.title}`).join("; ");const recoveryInstruction=recovery.action==="reopen"?"Reopen the canonical item":"Reuse the canonical item";throw new PmCliError(`Likely duplicate item(s) found: ${candidates}. ${recoveryInstruction} or pass --allow-duplicate with explicit intent.`,EXIT_CODE.CONFLICT,{code:"likely_duplicate",required:`${recoveryInstruction}, or explicitly acknowledge the duplicate with --allow-duplicate.`,recovery:{suggested_flags:["--allow-duplicate"],suggested_retry:recovery.command,suggested_retry_args:recovery.args}})}return{mode:options.mode,bypassed,result,recovery}}export{_testOnlySimilarity,analyzeDuplicateItems,evaluateSimilarityGovernance,findDuplicateClusters,findSimilarItems,jaccardSimilarity,normalizeSimilarityText,prepareSimilarityText2 as prepareSimilarityText,scoreItemSimilarity2 as scoreItemSimilarity,scorePreparedItemSimilarity2 as scorePreparedItemSimilarity,similarityAdvisoryWarnings,tokenizeSimilarityText2 as tokenizeSimilarityText};
+(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]="a5f450bd-8970-5b1b-8250-b76b7818e6e1")}catch{}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{isTerminalStatus,normalizeStatusInput}from"../core/item/status.js";import{resolveRuntimeStatusRegistry}from"../core/schema/runtime-schema.js";import{listAllItemMetadataLight}from"../core/store/item-store.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{readItemMetadataDerivedIndexState}from"../core/store/item-metadata-cache.js";import{querySimilarItemMetadataIndex}from"../core/store/item-metadata-query-index.js";import{collectDuplicateCandidatePairs,MAX_DUPLICATE_CANDIDATE_PAIRS}from"./query/duplicate-candidates.js";import{prepareSimilarityText,scoreItemSimilarity,scorePreparedItemSimilarity,tokenizeSimilarityText}from"./similarity-scoring.js";import{jaccardSimilarity,normalizeSimilarityText,prepareSimilarityText as prepareSimilarityText2,scoreItemSimilarity as scoreItemSimilarity2,scorePreparedItemSimilarity as scorePreparedItemSimilarity2,tokenizeSimilarityText as tokenizeSimilarityText2}from"./similarity-scoring.js";const DEFAULT_SIMILARITY_LIMIT=3,MAX_SIMILARITY_LIMIT=20,DEFAULT_SIMILARITY_THRESHOLD=.8,DEFAULT_DUPLICATE_CLUSTER_LIMIT=100,MAX_DUPLICATE_CLUSTER_LIMIT=1e3;function similarityAdvisoryWarnings(advisory){return advisory===void 0?[]:[`likely_duplicates:${advisory.result.items.map(item=>item.id).join(",")}`,`likely_duplicate_recovery:${advisory.recovery.action}:${advisory.recovery.item_id}`]}async function resolveSimilarityRecovery(result,options){const strongest=result.items[0],pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot),statusRegistry=resolveRuntimeStatusRegistry((await readSettings(pmRoot)).schema);return isTerminalStatus(strongest.status,statusRegistry)?{action:"reopen",item_id:strongest.id,command:`pm item reopen ${strongest.id} "<recurrence reason>"`,args:["item","reopen",strongest.id,"<recurrence reason>"]}:{action:"reuse",item_id:strongest.id,command:`pm get ${strongest.id} --full`,args:["get",strongest.id,"--full"]}}function validateSimilarityOptions(options){const limit=options.limit??DEFAULT_SIMILARITY_LIMIT,threshold=options.threshold??DEFAULT_SIMILARITY_THRESHOLD;if(!Number.isSafeInteger(limit)||limit<0||limit>MAX_SIMILARITY_LIMIT)throw new PmCliError(`Similarity limit must be an integer from 0 to ${MAX_SIMILARITY_LIMIT}.`,EXIT_CODE.USAGE);if(!Number.isFinite(threshold)||threshold<0||threshold>1)throw new PmCliError("Similarity threshold must be a number from 0 to 1.",EXIT_CODE.USAGE);return{limit,threshold}}function validateDuplicateClusterOptions(options){const limit=options.limit??DEFAULT_DUPLICATE_CLUSTER_LIMIT;if(!Number.isSafeInteger(limit)||limit<0||limit>MAX_DUPLICATE_CLUSTER_LIMIT)throw new PmCliError(`Duplicate cluster limit must be an integer from 0 to ${MAX_DUPLICATE_CLUSTER_LIMIT}.`,EXIT_CODE.USAGE);const since=options.since===void 0?void 0:new Date(options.since);if(since&&Number.isNaN(since.getTime()))throw new PmCliError("Duplicate cluster --since must be a valid ISO timestamp.",EXIT_CODE.USAGE);return{limit,since}}async function loadDuplicateItems(options,since){const pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot),settings=await readSettings(pmRoot),typeRegistry=resolveItemTypeRegistry(settings),requestedStatuses=options.statuses?.map(status=>status.trim().toLowerCase()).filter(Boolean);if(options.statuses!==void 0&&requestedStatuses?.length===0)throw new PmCliError("Duplicate cluster statuses must include at least one lifecycle status or all.",EXIT_CODE.USAGE);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema),normalizedStatuses=requestedStatuses?.map(status=>{if(status==="all")return status;const normalized=normalizeStatusInput(status,statusRegistry);if(!normalized)throw new PmCliError(`Unknown duplicate-cluster status "${status}". Allowed: all, ${statusRegistry.definitions.map(entry=>entry.id).join(", ")}.`,EXIT_CODE.USAGE);return normalized}),hasAll=normalizedStatuses?.includes("all")===!0;if(hasAll&&normalizedStatuses?.some(status=>status!=="all"))throw new PmCliError('The "all" status cannot be combined with other statuses.',EXIT_CODE.USAGE);const effectiveStatuses=hasAll?void 0:normalizedStatuses,allowedStatuses=effectiveStatuses?new Set(effectiveStatuses):void 0;return{items:(await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema)).filter(item=>(!allowedStatuses||allowedStatuses.has(item.status))&&(!since||new Date(item.created_at).getTime()>=since.getTime())),statuses:effectiveStatuses}}const _testOnlySimilarity={buildDuplicateClusters,collectDuplicateCandidatePairs,createDuplicateUnionFind};function createDuplicateUnionFind(size){const parent=Array.from({length:size},(_entry,index)=>index);return{parent,findRoot:index=>{let root=index;for(;parent[root]!==root;)root=parent[root];for(;parent[index]!==index;){const next=parent[index];parent[index]=root,index=next}return root}}}function scoreDuplicateCandidates(items,candidates,threshold,union){const matches=[];for(const candidate of candidates){const[leftIndex,rightIndex]=candidate.split(":").map(value=>Number.parseInt(value,10)),scored=scorePreparedItemSimilarity(items[leftIndex].prepared,items[rightIndex].prepared);if(scored.score<threshold)continue;const leftRoot=union.findRoot(leftIndex),rightRoot=union.findRoot(rightIndex);leftRoot!==rightRoot&&(union.parent[rightRoot]=leftRoot),matches.push({left_id:items[leftIndex].item.id,right_id:items[rightIndex].item.id,...scored})}return matches}function buildDuplicateClusters(items,matches,union,limit){const components=new Map;for(const index of items.keys()){const root=union.findRoot(index),component=components.get(root)??[];component.push(index),components.set(root,component)}const rootsById=new Map(items.map(({item},index)=>[item.id,union.findRoot(index)])),matchesByRoot=new Map;for(const match of matches){const root=rootsById.get(match.left_id),rows=matchesByRoot.get(root)??[];rows.push(match),matchesByRoot.set(root,rows)}return[...components.values()].filter(component=>component.length>1).map(component=>{const clusterMatches=(matchesByRoot.get(union.findRoot(component[0]))??[]).sort((left,right)=>right.score-left.score||left.left_id.localeCompare(right.left_id)||left.right_id.localeCompare(right.right_id));return{id:items[component[0]].item.id,items:component.map(itemIndex=>{const item=items[itemIndex].item;return{id:item.id,title:item.title,status:item.status,type:item.type}}),matches:clusterMatches,max_score:clusterMatches[0]?.score??0}}).sort((left,right)=>right.max_score-left.max_score||left.id.localeCompare(right.id)).slice(0,limit)}function rankSimilarItems(title,candidates,excludedIds,threshold,limit){return candidates.filter(item=>!excludedIds.has(item.id)).map(item=>({id:item.id,title:item.title,status:item.status,type:item.type,...scoreItemSimilarity(title,item.title)})).filter(item=>item.score>=threshold).sort((left,right)=>right.score-left.score||left.id.localeCompare(right.id)).slice(0,limit)}async function findSimilarItems(candidate,options={}){const title=candidate.title.trim();if(title.length===0)throw new PmCliError("Similarity candidate title must not be empty.",EXIT_CODE.USAGE);const{limit,threshold}=validateSimilarityOptions(options),pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot),settings=await readSettings(pmRoot),typeRegistry=resolveItemTypeRegistry(settings),indexState=await readItemMetadataDerivedIndexState(pmRoot,Object.values(typeRegistry.type_to_folder)),tokens=tokenizeSimilarityText(title),indexed=indexState&&tokens.length>0?await querySimilarItemMetadataIndex({pmRoot,expectedSourceCursor:indexState.source_cursor,query:tokens.map(token=>`"${token.replaceAll('"','""')}"`).join(" OR "),limit:Math.max(limit*10,50)}):null,candidates=indexed===null?await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema):indexed.items,items=rankSimilarItems(title,candidates,new Set(candidate.excludeIds??[]),threshold,limit);return{items,count:items.length,threshold,source:indexed?"persistent_index":"metadata_fallback"}}function analyzeDuplicateItems(input,options={}){const{threshold}=validateSimilarityOptions({...options,limit:void 0}),{limit}=validateDuplicateClusterOptions(options),ids=new Set;for(const item of input){if(!item.id.trim()||ids.has(item.id))throw new PmCliError("Duplicate analysis requires unique non-empty item ids.",EXIT_CODE.USAGE);ids.add(item.id)}const items=[...input].sort((left,right)=>left.id.localeCompare(right.id)).map(item=>({item,prepared:prepareSimilarityText(item.title)})),candidates=collectDuplicateCandidatePairs(items,MAX_DUPLICATE_CANDIDATE_PAIRS,threshold,options.exhaustive===!0),union=createDuplicateUnionFind(items.length),matches=scoreDuplicateCandidates(items,candidates,threshold,union),clusters=buildDuplicateClusters(items,matches,union,limit);return{clusters,count:clusters.length,threshold,cost:{item_count:items.length,algorithm:options.exhaustive===!0||threshold===0?"exhaustive":"prefix_exact",possible_pairs:items.length*(items.length-1)/2,pair_limit:MAX_DUPLICATE_CANDIDATE_PAIRS,recall_guarantee:"exact",candidate_pairs:candidates.size,scored_pairs:candidates.size}}}async function findDuplicateClusters(options={}){validateSimilarityOptions({...options,limit:void 0});const{since}=validateDuplicateClusterOptions(options),{items,statuses}=await loadDuplicateItems(options,since);return{...analyzeDuplicateItems(items,options),source:"metadata_scan",filters:{statuses:statuses??null,since:options.since??null}}}async function evaluateSimilarityGovernance(candidate,options){if(options.mode==="off")return;const result=await findSimilarItems(candidate,options);if(result.count===0)return;const recovery=await resolveSimilarityRecovery(result,options),bypassed=options.mode==="strict"&&options.allowDuplicate===!0;if(options.mode==="strict"&&!bypassed){const candidates=result.items.map(item=>`${item.id} (${item.status}): ${item.title}`).join("; "),recoveryInstruction=recovery.action==="reopen"?"Reopen the canonical item":"Reuse the canonical item";throw new PmCliError(`Likely duplicate item(s) found: ${candidates}. ${recoveryInstruction} or pass --allow-duplicate with explicit intent.`,EXIT_CODE.CONFLICT,{code:"likely_duplicate",required:`${recoveryInstruction}, or explicitly acknowledge the duplicate with --allow-duplicate.`,recovery:{suggested_flags:["--allow-duplicate"],suggested_retry:recovery.command,suggested_retry_args:recovery.args}})}return{mode:options.mode,bypassed,result,recovery}}export{_testOnlySimilarity,analyzeDuplicateItems,evaluateSimilarityGovernance,findDuplicateClusters,findSimilarItems,jaccardSimilarity,normalizeSimilarityText,prepareSimilarityText2 as prepareSimilarityText,scoreItemSimilarity2 as scoreItemSimilarity,scorePreparedItemSimilarity2 as scorePreparedItemSimilarity,similarityAdvisoryWarnings,tokenizeSimilarityText2 as tokenizeSimilarityText};
 //# sourceMappingURL=similarity.js.map

package/dist/sdk/start-task-status.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]="961c1918-75f9-5e5d-bbae-b333ca29534f")}catch(e2){}})();import{normalizeStatusInputWithRegistry}from"../core/schema/runtime-schema.js";function resolveStartTaskInProgressStatus(statusRegistry){return normalizeStatusInputWithRegistry("in_progress",statusRegistry)??statusRegistry.open_status}export{resolveStartTaskInProgressStatus};
+(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]="961c1918-75f9-5e5d-bbae-b333ca29534f")}catch{}})();import{normalizeStatusInputWithRegistry}from"../core/schema/runtime-schema.js";function resolveStartTaskInProgressStatus(statusRegistry){return normalizeStatusInputWithRegistry("in_progress",statusRegistry)??statusRegistry.open_status}export{resolveStartTaskInProgressStatus};
 //# sourceMappingURL=start-task-status.js.map

package/dist/sdk/stats.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]="a567e72a-faff-580d-b9ae-e2ebfa492b89")}catch(e2){}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{getActiveExtensionRegistrations,runActiveOnReadHooks}from"../core/extensions/index.js";import{computeContentFieldUtilization}from"../core/governance/content-fields.js";import{computeMetadataCoverage,groupItemsByDimension,lifecycleClassifierFromStatusRegistry}from"../core/governance/metadata-coverage.js";import{pathExists,readFileIfExists}from"../core/fs/fs-utils.js";import{enforceHistoryStreamPolicyForItems}from"../core/history/history-stream-policy.js";import{computeHistoryStorageStats}from"../core/history/history-storage-stats.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{resolveRuntimeStatusRegistry}from"../core/schema/runtime-schema.js";import{nowIso}from"../core/shared/time.js";import{listAllItemMetadataLight,listAllItemMetadataWithBody}from"../core/store/item-store.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{recordImprovementObservation,readImprovementLedger}from"./improvement-ledger.js";import{projectFleetAttributionAnalytics,projectProvenanceCoverageAnalytics,readHistoryAnalyticsWindow}from"./history-analytics.js";import{parseTestRunMeasurements}from"./test/measurements.js";function zeroByType(itemTypes){return itemTypes.reduce((acc,value)=>{acc[value]=0;return acc},{})}function zeroByStatus(statuses){return statuses.reduce((acc,value)=>{acc[value]=0;return acc},{})}function projectStatsDistributions(items,itemTypes,statuses,classifier,includeEmpty){const grouped=groupItemsByDimension(items,"type",classifier);const presentTypes=new Set(grouped.rows.map(row=>row.key));const missingTypes=itemTypes.filter(type=>!presentTypes.has(type));const groupedRows=includeEmpty?[...grouped.rows,...missingTypes.map(type=>({label:type,key:type,total:0,buckets:{open:0,in_progress:0,blocked:0,draft:0,closed:0,canceled:0,other:0}}))]:grouped.rows;const byType=groupedRows.map(row=>({type:row.key??row.label,total:row.total,open:row.buckets.open,in_progress:row.buckets.in_progress,blocked:row.buckets.blocked,draft:row.buckets.draft,closed:row.buckets.closed,canceled:row.buckets.canceled,other:row.buckets.other}));const counts=zeroByStatus([...statuses]);for(const item of items)counts[item.status]+=1;const byStatus=Object.fromEntries(Object.entries(counts).filter(([,count])=>includeEmpty||count>0));return{byType,byStatus,omitted:includeEmpty?0:missingTypes.length+Object.values(counts).filter(count=>count===0).length}}function countNonEmptyLines(raw){if(raw.trim().length===0){return 0}return raw.split(/\r?\n/u).filter(line=>line.trim().length>0).length}async function readHistoryStreamContents(pmRoot){const historyDir=path.join(pmRoot,"history");if(!await pathExists(historyDir)){return[]}await runActiveOnReadHooks({path:historyDir,scope:"project"});const historyFiles=(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((a,b)=>a.localeCompare(b));const streams=[];for(const file of historyFiles){const historyPath=path.join(historyDir,file);const raw=await readFileIfExists(historyPath);if(raw===null){continue}await runActiveOnReadHooks({path:historyPath,scope:"project"});streams.push({id:file.slice(0,-".jsonl".length),raw})}return streams}const _testOnly={zeroByType,zeroByStatus,countNonEmptyLines,readHistoryStreamContents,projectStatsDistributions};async function recordStatsObservations(global2,options){const recorded=[];const observedAt=nowIso();for(const measurement of parseTestRunMeasurements(options.observe,observedAt)){recorded.push(await recordImprovementObservation({metric:measurement.name,value:measurement.value,direction:options.direction,unit:measurement.unit,threshold:measurement.threshold,source:options.measurementSource,itemId:options.measurementItem,revision:options.measurementRevision,observedAt,author:options.author,message:options.message},global2))}return recorded}function requestedBreakdowns(items,options,classifier){const breakdowns={};if(options.byAssignee){breakdowns.assignee=groupItemsByDimension(items,"assignee",classifier)}if(options.byTag){breakdowns.tag=groupItemsByDimension(items,"tag",classifier,{tagPrefix:options.tagPrefix})}if(options.byPriority){breakdowns.priority=groupItemsByDimension(items,"priority",classifier)}return breakdowns}async function requestedHistoryAnalytics(pmRoot,items,settings,terminalStatuses,options){const historyOptions={since:options.since,eventLimit:options.eventLimit,minimumSample:options.minimumSample};const sharedWindow=options.provenanceCoverage||options.fleetAttribution?await readHistoryAnalyticsWindow(pmRoot,historyOptions):void 0;return{provenanceCoverage:options.provenanceCoverage&&sharedWindow?projectProvenanceCoverageAnalytics(sharedWindow,settings.agent_identity?.harness_signals,historyOptions):void 0,fleetAttribution:options.fleetAttribution&&sharedWindow?projectFleetAttributionAnalytics(sharedWindow,items,terminalStatuses,historyOptions):void 0}}function assembleStatsResult(totals,byType,byStatus,omittedZeroBuckets,optional){const hasBreakdowns=Object.keys(optional.breakdowns).length>0;return{totals,by_type:byType,by_status:byStatus,omitted_zero_buckets:omittedZeroBuckets,...optional.metadataCoverage?{metadata_coverage:optional.metadataCoverage}:{},...hasBreakdowns?{breakdowns:optional.breakdowns}:{},...optional.storage?{storage:optional.storage}:{},...optional.fieldUtilization?{field_utilization:optional.fieldUtilization}:{},...optional.improvementLedger?{improvement_ledger:optional.improvementLedger}:{},...optional.recordedObservations.length>0?{recorded_observations:optional.recordedObservations}:{},...optional.provenanceCoverage?{provenance_coverage:optional.provenanceCoverage}:{},...optional.fleetAttribution?{fleet_attribution:optional.fleetAttribution}:{},generated_at:nowIso()}}async function runStats(global2,options={}){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const recordedObservations=await recordStatsObservations(global2,options);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const items=options.fieldUtilization?await listAllItemMetadataWithBody(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema):await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema);await enforceHistoryStreamPolicyForItems({pmRoot,settings,itemIds:items.map(item=>item.id),commandLabel:"stats"});const classifier=lifecycleClassifierFromStatusRegistry(statusRegistry);const distributions=projectStatsDistributions(items,typeRegistry.types,statusRegistry.definitions.map(definition=>definition.id),classifier,options.includeEmpty===true);const streams=await readHistoryStreamContents(pmRoot);let historyEntries=0;for(const stream of streams){historyEntries+=countNonEmptyLines(stream.raw)}const storage=options.storage?computeHistoryStorageStats(streams):void 0;const metadataCoverage=options.metadataCoverage?computeMetadataCoverage(items,classifier):void 0;const breakdowns=requestedBreakdowns(items,options,classifier);const fieldUtilization=options.fieldUtilization?computeContentFieldUtilization(items):void 0;const improvementLedger=options.measurements===true||recordedObservations.length>0?await readImprovementLedger({pmRoot,metric:options.metric,itemId:options.measurementItem,limit:options.measurementLimit}):void 0;const{provenanceCoverage,fleetAttribution}=await requestedHistoryAnalytics(pmRoot,items,settings,statusRegistry.terminal_statuses,options);return assembleStatsResult({items:items.length,history_streams:streams.length,history_entries:historyEntries},distributions.byType,distributions.byStatus,distributions.omitted,{metadataCoverage,breakdowns,storage,fieldUtilization,improvementLedger,recordedObservations,provenanceCoverage,fleetAttribution})}export{_testOnly,runStats};
+(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]="b9d089ef-bca9-547f-a860-4002ec181cd0")}catch{}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{getActiveExtensionRegistrations,runActiveOnReadHooks}from"../core/extensions/index.js";import{computeContentFieldUtilization}from"../core/governance/content-fields.js";import{computeMetadataCoverage,groupItemsByDimension,lifecycleClassifierFromStatusRegistry}from"../core/governance/metadata-coverage.js";import{pathExists,readFileIfExists}from"../core/fs/fs-utils.js";import{enforceHistoryStreamPolicyForItems}from"../core/history/history-stream-policy.js";import{computeHistoryStorageStats}from"../core/history/history-storage-stats.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{resolveRuntimeStatusRegistry}from"../core/schema/runtime-schema.js";import{nowIso}from"../core/shared/time.js";import{listAllItemMetadataLight,listAllItemMetadataWithBody}from"../core/store/item-store.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{recordImprovementObservation,readImprovementLedger}from"./improvement-ledger.js";import{projectFleetAttributionAnalytics,projectProvenanceCoverageAnalytics,readHistoryAnalyticsWindow}from"./history-analytics.js";import{parseTestRunMeasurements}from"./test/measurements.js";function zeroByType(itemTypes){return itemTypes.reduce((acc,value)=>(acc[value]=0,acc),{})}function zeroByStatus(statuses){return statuses.reduce((acc,value)=>(acc[value]=0,acc),{})}function projectStatsDistributions(items,itemTypes,statuses,classifier,includeEmpty){const grouped=groupItemsByDimension(items,"type",classifier),presentTypes=new Set(grouped.rows.map(row=>row.key)),missingTypes=itemTypes.filter(type=>!presentTypes.has(type)),byType=(includeEmpty?[...grouped.rows,...missingTypes.map(type=>({label:type,key:type,total:0,buckets:{open:0,in_progress:0,blocked:0,draft:0,closed:0,canceled:0,other:0}}))]:grouped.rows).map(row=>({type:row.key??row.label,total:row.total,open:row.buckets.open,in_progress:row.buckets.in_progress,blocked:row.buckets.blocked,draft:row.buckets.draft,closed:row.buckets.closed,canceled:row.buckets.canceled,other:row.buckets.other})),counts=zeroByStatus([...statuses]);for(const item of items)counts[item.status]+=1;const byStatus=Object.fromEntries(Object.entries(counts).filter(([,count])=>includeEmpty||count>0));return{byType,byStatus,omitted:includeEmpty?0:missingTypes.length+Object.values(counts).filter(count=>count===0).length}}function countNonEmptyLines(raw){return raw.trim().length===0?0:raw.split(/\r?\n/u).filter(line=>line.trim().length>0).length}async function readHistoryStreamContents(pmRoot){const historyDir=path.join(pmRoot,"history");if(!await pathExists(historyDir))return[];await runActiveOnReadHooks({path:historyDir,scope:"project"});const historyFiles=(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((a,b)=>a.localeCompare(b)),streams=[];for(const file of historyFiles){const historyPath=path.join(historyDir,file),raw=await readFileIfExists(historyPath);raw!==null&&(await runActiveOnReadHooks({path:historyPath,scope:"project"}),streams.push({id:file.slice(0,-6),raw}))}return streams}const _testOnly={zeroByType,zeroByStatus,countNonEmptyLines,readHistoryStreamContents,projectStatsDistributions};async function recordStatsObservations(global2,options){const recorded=[],observedAt=nowIso();for(const measurement of parseTestRunMeasurements(options.observe,observedAt))recorded.push(await recordImprovementObservation({metric:measurement.name,value:measurement.value,direction:options.direction,unit:measurement.unit,threshold:measurement.threshold,source:options.measurementSource,itemId:options.measurementItem,revision:options.measurementRevision,observedAt,author:options.author,message:options.message},global2));return recorded}function requestedBreakdowns(items,options,classifier){const breakdowns={};return options.byAssignee&&(breakdowns.assignee=groupItemsByDimension(items,"assignee",classifier)),options.byTag&&(breakdowns.tag=groupItemsByDimension(items,"tag",classifier,{tagPrefix:options.tagPrefix})),options.byPriority&&(breakdowns.priority=groupItemsByDimension(items,"priority",classifier)),breakdowns}async function requestedHistoryAnalytics(pmRoot,items,settings,terminalStatuses,options){const historyOptions={since:options.since,eventLimit:options.eventLimit,minimumSample:options.minimumSample},sharedWindow=options.provenanceCoverage||options.fleetAttribution?await readHistoryAnalyticsWindow(pmRoot,historyOptions):void 0;return{provenanceCoverage:options.provenanceCoverage&&sharedWindow?projectProvenanceCoverageAnalytics(sharedWindow,settings.agent_identity?.harness_signals,historyOptions):void 0,fleetAttribution:options.fleetAttribution&&sharedWindow?projectFleetAttributionAnalytics(sharedWindow,items,terminalStatuses,historyOptions):void 0}}function assembleStatsResult(totals,byType,byStatus,omittedZeroBuckets,optional){const hasBreakdowns=Object.keys(optional.breakdowns).length>0;return{totals,by_type:byType,by_status:byStatus,omitted_zero_buckets:omittedZeroBuckets,...optional.metadataCoverage?{metadata_coverage:optional.metadataCoverage}:{},...hasBreakdowns?{breakdowns:optional.breakdowns}:{},...optional.storage?{storage:optional.storage}:{},...optional.fieldUtilization?{field_utilization:optional.fieldUtilization}:{},...optional.improvementLedger?{improvement_ledger:optional.improvementLedger}:{},...optional.recordedObservations.length>0?{recorded_observations:optional.recordedObservations}:{},...optional.provenanceCoverage?{provenance_coverage:optional.provenanceCoverage}:{},...optional.fleetAttribution?{fleet_attribution:optional.fleetAttribution}:{},generated_at:nowIso()}}async function runStats(global2,options={}){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot),recordedObservations=await recordStatsObservations(global2,options),typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()),statusRegistry=resolveRuntimeStatusRegistry(settings.schema),items=options.fieldUtilization?await listAllItemMetadataWithBody(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema):await listAllItemMetadataLight(pmRoot,settings.item_format,typeRegistry.type_to_folder,void 0,settings.schema);await enforceHistoryStreamPolicyForItems({pmRoot,settings,itemIds:items.map(item=>item.id),commandLabel:"stats"});const classifier=lifecycleClassifierFromStatusRegistry(statusRegistry),distributions=projectStatsDistributions(items,typeRegistry.types,statusRegistry.definitions.map(definition=>definition.id),classifier,options.includeEmpty===!0),streams=await readHistoryStreamContents(pmRoot);let historyEntries=0;for(const stream of streams)historyEntries+=countNonEmptyLines(stream.raw);const storage=options.storage?computeHistoryStorageStats(streams):void 0,metadataCoverage=options.metadataCoverage?computeMetadataCoverage(items,classifier):void 0,breakdowns=requestedBreakdowns(items,options,classifier),fieldUtilization=options.fieldUtilization?computeContentFieldUtilization(items):void 0,improvementLedger=options.measurements===!0||recordedObservations.length>0?await readImprovementLedger({pmRoot,metric:options.metric,itemId:options.measurementItem,limit:options.measurementLimit}):void 0,{provenanceCoverage,fleetAttribution}=await requestedHistoryAnalytics(pmRoot,items,settings,statusRegistry.terminal_statuses,options);return assembleStatsResult({items:items.length,history_streams:streams.length,history_entries:historyEntries},distributions.byType,distributions.byStatus,distributions.omitted,{metadataCoverage,breakdowns,storage,fieldUtilization,improvementLedger,recordedObservations,provenanceCoverage,fleetAttribution})}export{_testOnly,runStats};
 //# sourceMappingURL=stats.js.map

package/dist/sdk/structured-mutations.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]="2b75ffc0-8175-58fc-8d63-98081a68dcb8")}catch(e2){}})();import crypto from"node:crypto";import{normalizeItemId,normalizePrefix}from"../core/item/id.js";import{preserveMutationStdinTokenLiterals}from"../core/item/parse.js";import{EXIT_CODE,ITEM_PROJECT_CONTEXT_KEYS}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{levenshteinDistanceWithinLimit}from"../core/shared/levenshtein.js";import{CLOSE_FLAG_CONTRACTS,RELEASE_FLAG_CONTRACTS}from"./cli-contracts/flag-contracts.js";import{CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS}from"./cli-contracts/commander-mutation-options.js";const MUTATION_ROW_KEYS=["op","id","reason","options"];const REFERENCED_MUTATION_ROW_KEYS=[...MUTATION_ROW_KEYS,"ref"];const MUTATION_DOCUMENT_KEYS=["schema_version","mutations"];const MUTATION_REFERENCE_SOURCE="[a-z][a-z0-9._-]{0,63}";const MUTATION_REFERENCE_PATTERN=new RegExp(`^${MUTATION_REFERENCE_SOURCE}$`,"u");const MUTATION_DEPENDENCY_REFERENCE_PATTERN=new RegExp(`(^|,)id=@(${MUTATION_REFERENCE_SOURCE})(?=,|$)`,"gu");const flagToOptionKey=flag=>flag.slice(2).replaceAll(/-([a-z])/gu,(_match,letter)=>letter.toUpperCase());const ITEM_ENVELOPE_KEYS=["item","linked","schedule","claim_state","children","omission_receipt","row_contract","context_intent"];const READ_ONLY_ITEM_KEYS=new Set(["created_at","updated_at","closed_at","version","format_version","path","author","collection_counts","notes_count","tests_count"]);const UPDATE_READ_ONLY_ITEM_KEYS=new Set([...READ_ONLY_ITEM_KEYS,"completed_at","id"]);const ITEM_FIELD_KEYS=new Set(["id","title","description","type","status","priority","tags","body","deadline","estimated_minutes","acceptance_criteria","definition_of_ready","order","rank","assignee",...ITEM_PROJECT_CONTEXT_KEYS,"affected_version","fixed_version","component","regression","customer_impact","close_reason","completed_at","dependencies","comments","notes","learnings","files","tests","docs","reminders","events","type_options"]);const MUTATION_OPTION_KEYS={create:CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.map(contract=>contract.target),update:UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.map(contract=>contract.target),close:CLOSE_FLAG_CONTRACTS.map(contract=>flagToOptionKey(contract.flag)).filter(key=>key!=="reason"),release:RELEASE_FLAG_CONTRACTS.map(contract=>flagToOptionKey(contract.flag))};function parseAtomicMutationControls(value){const controls={};const compensation=value.createCompensation;if(compensation!==void 0){if(compensation!=="close"&&compensation!=="delete"){throw new PmCliError("createCompensation must be close or delete.",EXIT_CODE.USAGE)}controls.createCompensation=compensation}for(const key of["lockTtlSeconds","lockWaitMs"]){const raw=value[key];if(raw===void 0)continue;const parsed=typeof raw==="number"||typeof raw==="string"&&raw.trim().length>0?Number(raw):Number.NaN;if(!Number.isSafeInteger(parsed)||parsed<=0){throw new PmCliError(`${key} must be a positive safe integer.`,EXIT_CODE.USAGE)}controls[key]=parsed}return controls}function isPlainObject(value){if(typeof value!=="object"||value===null||Array.isArray(value)){return false}const prototype=Object.getPrototypeOf(value);return prototype===Object.prototype||prototype===null}function nearestKey(key,candidates){const limit=Math.max(1,Math.min(3,Math.floor(key.length/4)+1));let best;for(const candidate of candidates){const distance=levenshteinDistanceWithinLimit(key,candidate,limit);if(distance!==null&&(best===void 0||distance<best.distance)){best={key:candidate,distance}}}return best?.key}function unknownKeyError(scope,key,candidates){const suggestion=nearestKey(key,candidates);return new PmCliError(suggestion===void 0?`${scope} does not recognize key "${key}". Allowed keys: ${candidates.join(", ")}.`:`${scope} does not recognize key "${key}". Did you mean "${suggestion}"?`,EXIT_CODE.USAGE,{code:"stdin_json_unknown_key",required:`Use documented ${scope} keys only.`,why:"Strict structured input prevents silent typos from creating incomplete or unintended mutations.",nextSteps:[suggestion===void 0?`Remove or correct "${key}".`:`Replace "${key}" with "${suggestion}".`]})}function parseJsonValue(input,label){try{return JSON.parse(input)}catch(error){const detail=error instanceof Error?error.message:String(error);throw new PmCliError(`${label} must be valid JSON: ${detail}`,EXIT_CODE.USAGE,{code:"stdin_json_invalid",required:`Pipe one valid JSON ${label.toLowerCase()} into stdin.`,why:"Structured mutation input must parse deterministically before any tracker write begins."})}}function validateMutationObject(value,index){if(!isPlainObject(value)){throw new PmCliError(`Mutation ${index+1} must be an object.`,EXIT_CODE.USAGE)}for(const key of Object.keys(value)){if(!MUTATION_ROW_KEYS.includes(key)){throw unknownKeyError(`mutation ${index+1}`,key,MUTATION_ROW_KEYS)}}return value}function validateMutationOptions(options,op,index){if(options===void 0)return void 0;if(!isPlainObject(options)){throw new PmCliError(`Mutation ${index+1} options must be an object.`,EXIT_CODE.USAGE)}for(const key of Object.keys(options)){if(!MUTATION_OPTION_KEYS[op].includes(key)){throw unknownKeyError(`mutation ${index+1} ${op} options`,key,MUTATION_OPTION_KEYS[op])}}return options}function validateMutationRow(value,index){const mutation=validateMutationObject(value,index);const{op,id,reason}=mutation;if(op!=="create"&&op!=="update"&&op!=="close"&&op!=="release"){throw new PmCliError(`Mutation ${index+1} op must be create, update, close, or release.`,EXIT_CODE.USAGE)}const options=validateMutationOptions(mutation.options,op,index);if(typeof id!=="string"||id.trim().length===0){throw new PmCliError(`Mutation ${index+1} requires a non-empty id.`,EXIT_CODE.USAGE)}const normalizedId=id.trim();if(op==="close"){if(typeof reason!=="string"||reason.trim().length===0){throw new PmCliError(`Mutation ${index+1} close requires a non-empty reason.`,EXIT_CODE.USAGE)}return{op,id:normalizedId,reason:reason.trim(),...options===void 0?{}:{options}}}if(op==="release"){return{op,id:normalizedId,...options===void 0?{}:{options}}}if(!isPlainObject(options)){throw new PmCliError(`Mutation ${index+1} ${op} requires an options object.`,EXIT_CODE.USAGE)}return{op,id:normalizedId,options}}function parseItemMutationBatch(input){const parsed=parseJsonValue(input,"Mutation batch");const rows=Array.isArray(parsed)?parsed:isPlainObject(parsed)&&Array.isArray(parsed.mutations)?parsed.mutations:void 0;if(rows===void 0||rows.length===0){throw new PmCliError("Mutation batch must be a non-empty JSON array or an object with a non-empty mutations array.",EXIT_CODE.USAGE)}return rows.map((row,index)=>{const mutation=validateMutationRow(row,index);if(mutation.options!==void 0){preserveMutationStdinTokenLiterals(mutation.options)}return mutation})}function deriveReferencedItemId(transactionId,reference,idPrefix){const digest=crypto.createHash("sha256").update(transactionId).update("\0").update(reference).digest("hex");const token=BigInt(`0x${digest.slice(0,16)}`).toString(36).padStart(13,"0").slice(-12);return`${normalizePrefix(idPrefix)}${token}`}function replaceExactMutationReference(value,references){if(typeof value!=="string"||!value.startsWith("@")){return value}const reference=value.slice(1);const resolved=references[reference];if(resolved===void 0){throw new PmCliError(`Unknown mutation reference "${value}".`,EXIT_CODE.USAGE)}return resolved}function replaceDependencyReference(value,references){if(typeof value!=="string")return value;const resolvedValue=value.replace(MUTATION_DEPENDENCY_REFERENCE_PATTERN,(_match,prefix,reference)=>{const resolved=references[reference];if(resolved===void 0){throw new PmCliError(`Unknown mutation reference "@${reference}".`,EXIT_CODE.USAGE)}return`${prefix}id=${resolved}`});if(/(^|,)id=@/u.test(resolvedValue)){throw new PmCliError(`Malformed mutation reference in dependency "${value}".`,EXIT_CODE.USAGE)}return resolvedValue}function referencedAliases(value){if(typeof value!=="string")return[];if(value.startsWith("@"))return[value.slice(1)];return[...value.matchAll(MUTATION_DEPENDENCY_REFERENCE_PATTERN)].map(match=>match[1]).filter(reference=>reference!==void 0)}function assertAcyclicCreateReferences(rows){const graph=new Map;for(const row of rows){if(row.op!=="create"||typeof row.ref!=="string")continue;const mutationOptions=isPlainObject(row.options)?row.options:{};const dependencies=Array.isArray(mutationOptions.dep)?mutationOptions.dep:mutationOptions.dep===void 0?[]:[mutationOptions.dep];graph.set(row.ref,[mutationOptions.parent,mutationOptions.blockedBy,...dependencies].flatMap(referencedAliases))}const visiting=new Set;const visited=new Set;const visit=reference=>{if(visiting.has(reference)){throw new PmCliError(`Mutation reference cycle includes "@${reference}".`,EXIT_CODE.USAGE)}if(visited.has(reference))return;visiting.add(reference);for(const dependency of graph.get(reference)){if(graph.has(dependency))visit(dependency)}visiting.delete(reference);visited.add(reference)};for(const reference of graph.keys())visit(reference)}function parseMutationDocumentRows(input){const parsed=parseJsonValue(input,"Mutation document");const envelope=Array.isArray(parsed)?{schema_version:1,mutations:parsed}:parsed;if(!isPlainObject(envelope)){throw new PmCliError("Mutation document must be a JSON array or object.",EXIT_CODE.USAGE)}for(const key of Object.keys(envelope)){if(!MUTATION_DOCUMENT_KEYS.includes(key)){throw unknownKeyError("mutation document",key,MUTATION_DOCUMENT_KEYS)}}if(envelope.schema_version!==void 0&&envelope.schema_version!==1){throw new PmCliError("Mutation document schema_version must be 1.",EXIT_CODE.USAGE)}if(!Array.isArray(envelope.mutations)||envelope.mutations.length===0){throw new PmCliError("Mutation document requires a non-empty mutations array.",EXIT_CODE.USAGE)}return envelope.mutations.map((row,index)=>{if(!isPlainObject(row)){throw new PmCliError(`Mutation ${index+1} must be an object.`,EXIT_CODE.USAGE)}for(const key of Object.keys(row)){if(!REFERENCED_MUTATION_ROW_KEYS.includes(key)){throw unknownKeyError(`mutation ${index+1}`,key,REFERENCED_MUTATION_ROW_KEYS)}}return{...row}})}function collectMutationReferences(rows,options){const references=Object.create(null);for(const[index,row]of rows.entries()){if(row.ref===void 0)continue;if(row.op!=="create"){throw new PmCliError(`Mutation ${index+1} ref is only valid for create operations.`,EXIT_CODE.USAGE)}if(typeof row.ref!=="string"||!MUTATION_REFERENCE_PATTERN.test(row.ref)){throw new PmCliError(`Mutation ${index+1} ref must match ${MUTATION_REFERENCE_PATTERN.source}.`,EXIT_CODE.USAGE)}if(references[row.ref]!==void 0){throw new PmCliError(`Duplicate mutation ref "${row.ref}".`,EXIT_CODE.USAGE)}references[row.ref]=typeof row.id==="string"&&row.id.trim().length>0?normalizeItemId(row.id,options.idPrefix):deriveReferencedItemId(options.transactionId,row.ref,options.idPrefix)}return references}function resolveItemMutationDocument(input,options){const rows=parseMutationDocumentRows(input);const references=collectMutationReferences(rows,options);assertAcyclicCreateReferences(rows);const resolvedRows=rows.map(row=>{const resolved={...row};const reference=typeof resolved.ref==="string"?resolved.ref:void 0;delete resolved.ref;if(reference!==void 0){resolved.id=references[reference]}else{resolved.id=replaceExactMutationReference(resolved.id,references)}if(isPlainObject(resolved.options)){const mutationOptions={...resolved.options};for(const key of["parent","blockedBy"]){if(mutationOptions[key]!==void 0){mutationOptions[key]=replaceExactMutationReference(mutationOptions[key],references)}}if(Array.isArray(mutationOptions.dep)){mutationOptions.dep=mutationOptions.dep.map(entry=>replaceDependencyReference(entry,references))}else if(mutationOptions.dep!==void 0){mutationOptions.dep=replaceDependencyReference(mutationOptions.dep,references)}resolved.options=mutationOptions}return resolved});const mutations=parseItemMutationBatch(JSON.stringify(resolvedRows));const createIds=mutations.filter(mutation=>mutation.op==="create").map(mutation=>mutation.id);if(new Set(createIds).size!==createIds.length){throw new PmCliError("Duplicate resolved create id in mutation document.",EXIT_CODE.USAGE)}return{schema_version:1,mutations,references}}function serializePairs(value,keys){return keys.filter(key=>value[key]!==void 0&&value[key]!==null).map(key=>{const rendered=String(value[key]);return`${key}=${/[",\n\r\\]/u.test(rendered)?JSON.stringify(rendered):rendered}`}).join(",")}function serializeObjectArray(value,keys,label){if(value===void 0)return void 0;if(!Array.isArray(value)||!value.every(isPlainObject)){throw new PmCliError(`${label} must be an array of objects.`,EXIT_CODE.USAGE)}return value.map(entry=>serializePairs(entry,keys))}function scalarItemOption(key,value){if(key==="tags"&&Array.isArray(value)&&value.every(entry=>typeof entry==="string")){return JSON.stringify(value)}if(typeof value==="number"||typeof value==="boolean"){return String(value)}return value}function appendFacetOptions(target,source,skipPersistedAnnotations=false){const mappings=[["dependencies","dep",["id","kind","created_at","author","source_kind"]],["comments","comment",["text","created_at","author"]],["notes","note",["text","created_at","author"]],["learnings","learning",["text","created_at","author"]],["files","file",["path","scope","note"]],["tests","test",["command","scope","timeout_seconds"]],["docs","doc",["path","scope","note"]],["reminders","reminder",["at","text","created_at"]],["events","event",["start_at","end_at","title","location"]],["type_options","typeOption",["key","value"]]];for(const[sourceKey,targetKey,keys]of mappings){const sourceValue=source[sourceKey];const serialized=serializeObjectArray(skipPersistedAnnotations&&["comments","notes","learnings"].includes(sourceKey)&&Array.isArray(sourceValue)?sourceValue.filter(entry=>!isPlainObject(entry)||entry.created_at===void 0):sourceValue,keys,sourceKey);if(serialized!==void 0&&serialized.length>0)target[targetKey]=serialized}}function validateItemDocumentKeys(parsed,envelope){for(const key of Object.keys(parsed)){if(envelope){if(!ITEM_ENVELOPE_KEYS.includes(key))throw unknownKeyError("item envelope",key,ITEM_ENVELOPE_KEYS);continue}if(!ITEM_FIELD_KEYS.has(key)&&nearestKey(key,[...ITEM_FIELD_KEYS])===void 0&&nearestKey(key,ITEM_ENVELOPE_KEYS)==="item")throw unknownKeyError("item envelope",key,ITEM_ENVELOPE_KEYS)}}function resolveItemDocument(parsed){const envelope=Object.hasOwn(parsed,"item");validateItemDocumentKeys(parsed,envelope);const item=envelope?parsed.item:parsed;if(!isPlainObject(item)){throw new PmCliError("Item document item must be an object.",EXIT_CODE.USAGE)}return{item,...envelope&&isPlainObject(parsed.linked)?{linked:parsed.linked}:{}}}function appendItemDocumentEntry(documentOptions,key,value,mode){const readOnlyKeys=mode==="update"?UPDATE_READ_ONLY_ITEM_KEYS:READ_ONLY_ITEM_KEYS;if(readOnlyKeys.has(key))return;if(!ITEM_FIELD_KEYS.has(key)){const suggestion=nearestKey(key,[...ITEM_FIELD_KEYS]);if(suggestion!==void 0)throw unknownKeyError("item document",key,[...ITEM_FIELD_KEYS]);const fields=Array.isArray(documentOptions.field)?documentOptions.field:[];fields.push(serializePairs({key,value:typeof value==="string"?value:JSON.stringify(value)},["key","value"]));documentOptions.field=fields;return}if(["dependencies","comments","notes","learnings","files","tests","docs","reminders","events","type_options"].includes(key))return;documentOptions[key.replaceAll(/_([a-z])/gu,(_match,letter)=>letter.toUpperCase())]=scalarItemOption(key,value)}function itemDocumentToMutationOptions(input,mode,explicitOptions={}){const parsed=parseJsonValue(input,"Item document");if(!isPlainObject(parsed)){throw new PmCliError("Item document must be a JSON object.",EXIT_CODE.USAGE)}const{item,linked}=resolveItemDocument(parsed);const documentOptions={};for(const[key,value]of Object.entries(item)){appendItemDocumentEntry(documentOptions,key,value,mode)}appendFacetOptions(documentOptions,item,mode==="update");if(linked!==void 0)appendFacetOptions(documentOptions,linked);if(mode==="update"){const annotations=Object.fromEntries(["comments","notes","learnings"].filter(key=>Object.hasOwn(item,key)).map(key=>[key,item[key].filter(entry=>isPlainObject(entry)&&entry.created_at!==void 0)]));if(Object.keys(annotations).length>0){documentOptions.documentAnnotationSnapshot=annotations}}return{...documentOptions,...Object.fromEntries(Object.entries(explicitOptions).filter(([,value])=>value!==void 0)),stdinJson:void 0}}function validateItemMutationRows(value){return parseItemMutationBatch(JSON.stringify(value))}export{itemDocumentToMutationOptions,parseAtomicMutationControls,parseItemMutationBatch,resolveItemMutationDocument,validateItemMutationRows};
+(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]="62e0ef49-30c8-56e0-985e-49c83d14695e")}catch{}})();import crypto from"node:crypto";import{normalizeItemId,normalizePrefix}from"../core/item/id.js";import{preserveMutationStdinTokenLiterals}from"../core/item/parse.js";import{EXIT_CODE,ITEM_PROJECT_CONTEXT_KEYS}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{levenshteinDistanceWithinLimit}from"../core/shared/levenshtein.js";import{CLOSE_FLAG_CONTRACTS,RELEASE_FLAG_CONTRACTS}from"./cli-contracts/flag-contracts.js";import{CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS}from"./cli-contracts/commander-mutation-options.js";const MUTATION_ROW_KEYS=["op","id","reason","options"],REFERENCED_MUTATION_ROW_KEYS=[...MUTATION_ROW_KEYS,"ref"],MUTATION_DOCUMENT_KEYS=["schema_version","mutations"],MUTATION_REFERENCE_SOURCE="[a-z][a-z0-9._-]{0,63}",MUTATION_REFERENCE_PATTERN=new RegExp(`^${MUTATION_REFERENCE_SOURCE}$`,"u"),MUTATION_DEPENDENCY_REFERENCE_PATTERN=new RegExp(`(^|,)id=@(${MUTATION_REFERENCE_SOURCE})(?=,|$)`,"gu"),flagToOptionKey=flag=>flag.slice(2).replaceAll(/-([a-z])/gu,(_match,letter)=>letter.toUpperCase()),ITEM_ENVELOPE_KEYS=["item","linked","schedule","claim_state","children","omission_receipt","row_contract","context_intent"],READ_ONLY_ITEM_KEYS=new Set(["created_at","updated_at","closed_at","version","format_version","path","author","collection_counts","notes_count","tests_count"]),UPDATE_READ_ONLY_ITEM_KEYS=new Set([...READ_ONLY_ITEM_KEYS,"completed_at","id"]),ITEM_FIELD_KEYS=new Set(["id","title","description","type","status","priority","tags","body","deadline","estimated_minutes","acceptance_criteria","definition_of_ready","order","rank","assignee",...ITEM_PROJECT_CONTEXT_KEYS,"affected_version","fixed_version","component","regression","customer_impact","close_reason","completed_at","dependencies","comments","notes","learnings","files","tests","docs","reminders","events","type_options"]),MUTATION_OPTION_KEYS={create:CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.map(contract=>contract.target),update:UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS.map(contract=>contract.target),close:CLOSE_FLAG_CONTRACTS.map(contract=>flagToOptionKey(contract.flag)).filter(key=>key!=="reason"),release:RELEASE_FLAG_CONTRACTS.map(contract=>flagToOptionKey(contract.flag))};function parseAtomicMutationControls(value){const controls={},compensation=value.createCompensation;if(compensation!==void 0){if(compensation!=="close"&&compensation!=="delete")throw new PmCliError("createCompensation must be close or delete.",EXIT_CODE.USAGE);controls.createCompensation=compensation}for(const key of["lockTtlSeconds","lockWaitMs"]){const raw=value[key];if(raw===void 0)continue;const parsed=typeof raw=="number"||typeof raw=="string"&&raw.trim().length>0?Number(raw):Number.NaN;if(!Number.isSafeInteger(parsed)||parsed<=0)throw new PmCliError(`${key} must be a positive safe integer.`,EXIT_CODE.USAGE);controls[key]=parsed}return controls}function isPlainObject(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const prototype=Object.getPrototypeOf(value);return prototype===Object.prototype||prototype===null}function nearestKey(key,candidates){const limit=Math.max(1,Math.min(3,Math.floor(key.length/4)+1));let best;for(const candidate of candidates){const distance=levenshteinDistanceWithinLimit(key,candidate,limit);distance!==null&&(best===void 0||distance<best.distance)&&(best={key:candidate,distance})}return best?.key}function unknownKeyError(scope,key,candidates){const suggestion=nearestKey(key,candidates);return new PmCliError(suggestion===void 0?`${scope} does not recognize key "${key}". Allowed keys: ${candidates.join(", ")}.`:`${scope} does not recognize key "${key}". Did you mean "${suggestion}"?`,EXIT_CODE.USAGE,{code:"stdin_json_unknown_key",required:`Use documented ${scope} keys only.`,why:"Strict structured input prevents silent typos from creating incomplete or unintended mutations.",nextSteps:[suggestion===void 0?`Remove or correct "${key}".`:`Replace "${key}" with "${suggestion}".`]})}function parseJsonValue(input,label){try{return JSON.parse(input)}catch(error){const detail=error instanceof Error?error.message:String(error);throw new PmCliError(`${label} must be valid JSON: ${detail}`,EXIT_CODE.USAGE,{code:"stdin_json_invalid",required:`Pipe one valid JSON ${label.toLowerCase()} into stdin.`,why:"Structured mutation input must parse deterministically before any tracker write begins."})}}function validateMutationObject(value,index){if(!isPlainObject(value))throw new PmCliError(`Mutation ${index+1} must be an object.`,EXIT_CODE.USAGE);for(const key of Object.keys(value))if(!MUTATION_ROW_KEYS.includes(key))throw unknownKeyError(`mutation ${index+1}`,key,MUTATION_ROW_KEYS);return value}function validateMutationOptions(options,op,index){if(options!==void 0){if(!isPlainObject(options))throw new PmCliError(`Mutation ${index+1} options must be an object.`,EXIT_CODE.USAGE);for(const key of Object.keys(options))if(!MUTATION_OPTION_KEYS[op].includes(key))throw unknownKeyError(`mutation ${index+1} ${op} options`,key,MUTATION_OPTION_KEYS[op]);return options}}function validateMutationRow(value,index){const mutation=validateMutationObject(value,index),{op,id,reason}=mutation;if(op!=="create"&&op!=="update"&&op!=="close"&&op!=="release")throw new PmCliError(`Mutation ${index+1} op must be create, update, close, or release.`,EXIT_CODE.USAGE);const options=validateMutationOptions(mutation.options,op,index);if(typeof id!="string"||id.trim().length===0)throw new PmCliError(`Mutation ${index+1} requires a non-empty id.`,EXIT_CODE.USAGE);const normalizedId=id.trim();if(op==="close"){if(typeof reason!="string"||reason.trim().length===0)throw new PmCliError(`Mutation ${index+1} close requires a non-empty reason.`,EXIT_CODE.USAGE);return{op,id:normalizedId,reason:reason.trim(),...options===void 0?{}:{options}}}if(op==="release")return{op,id:normalizedId,...options===void 0?{}:{options}};if(!isPlainObject(options))throw new PmCliError(`Mutation ${index+1} ${op} requires an options object.`,EXIT_CODE.USAGE);return{op,id:normalizedId,options}}function parseItemMutationBatch(input){const parsed=parseJsonValue(input,"Mutation batch"),rows=Array.isArray(parsed)?parsed:isPlainObject(parsed)&&Array.isArray(parsed.mutations)?parsed.mutations:void 0;if(rows===void 0||rows.length===0)throw new PmCliError("Mutation batch must be a non-empty JSON array or an object with a non-empty mutations array.",EXIT_CODE.USAGE);return rows.map((row,index)=>{const mutation=validateMutationRow(row,index);return mutation.options!==void 0&&preserveMutationStdinTokenLiterals(mutation.options),mutation})}function deriveReferencedItemId(transactionId,reference,idPrefix){const digest=crypto.createHash("sha256").update(transactionId).update("\0").update(reference).digest("hex"),token=BigInt(`0x${digest.slice(0,16)}`).toString(36).padStart(13,"0").slice(-12);return`${normalizePrefix(idPrefix)}${token}`}function replaceExactMutationReference(value,references){if(typeof value!="string"||!value.startsWith("@"))return value;const reference=value.slice(1),resolved=references[reference];if(resolved===void 0)throw new PmCliError(`Unknown mutation reference "${value}".`,EXIT_CODE.USAGE);return resolved}function replaceDependencyReference(value,references){if(typeof value!="string")return value;const resolvedValue=value.replace(MUTATION_DEPENDENCY_REFERENCE_PATTERN,(_match,prefix,reference)=>{const resolved=references[reference];if(resolved===void 0)throw new PmCliError(`Unknown mutation reference "@${reference}".`,EXIT_CODE.USAGE);return`${prefix}id=${resolved}`});if(/(^|,)id=@/u.test(resolvedValue))throw new PmCliError(`Malformed mutation reference in dependency "${value}".`,EXIT_CODE.USAGE);return resolvedValue}function referencedAliases(value){return typeof value!="string"?[]:value.startsWith("@")?[value.slice(1)]:[...value.matchAll(MUTATION_DEPENDENCY_REFERENCE_PATTERN)].map(match=>match[1]).filter(reference=>reference!==void 0)}function assertAcyclicCreateReferences(rows){const graph=new Map;for(const row of rows){if(row.op!=="create"||typeof row.ref!="string")continue;const mutationOptions=isPlainObject(row.options)?row.options:{},dependencies=Array.isArray(mutationOptions.dep)?mutationOptions.dep:mutationOptions.dep===void 0?[]:[mutationOptions.dep];graph.set(row.ref,[mutationOptions.parent,mutationOptions.blockedBy,...dependencies].flatMap(referencedAliases))}const visiting=new Set,visited=new Set,visit=reference=>{if(visiting.has(reference))throw new PmCliError(`Mutation reference cycle includes "@${reference}".`,EXIT_CODE.USAGE);if(!visited.has(reference)){visiting.add(reference);for(const dependency of graph.get(reference))graph.has(dependency)&&visit(dependency);visiting.delete(reference),visited.add(reference)}};for(const reference of graph.keys())visit(reference)}function parseMutationDocumentRows(input){const parsed=parseJsonValue(input,"Mutation document"),envelope=Array.isArray(parsed)?{schema_version:1,mutations:parsed}:parsed;if(!isPlainObject(envelope))throw new PmCliError("Mutation document must be a JSON array or object.",EXIT_CODE.USAGE);for(const key of Object.keys(envelope))if(!MUTATION_DOCUMENT_KEYS.includes(key))throw unknownKeyError("mutation document",key,MUTATION_DOCUMENT_KEYS);if(envelope.schema_version!==void 0&&envelope.schema_version!==1)throw new PmCliError("Mutation document schema_version must be 1.",EXIT_CODE.USAGE);if(!Array.isArray(envelope.mutations)||envelope.mutations.length===0)throw new PmCliError("Mutation document requires a non-empty mutations array.",EXIT_CODE.USAGE);return envelope.mutations.map((row,index)=>{if(!isPlainObject(row))throw new PmCliError(`Mutation ${index+1} must be an object.`,EXIT_CODE.USAGE);for(const key of Object.keys(row))if(!REFERENCED_MUTATION_ROW_KEYS.includes(key))throw unknownKeyError(`mutation ${index+1}`,key,REFERENCED_MUTATION_ROW_KEYS);return{...row}})}function collectMutationReferences(rows,options){const references=Object.create(null);for(const[index,row]of rows.entries())if(row.ref!==void 0){if(row.op!=="create")throw new PmCliError(`Mutation ${index+1} ref is only valid for create operations.`,EXIT_CODE.USAGE);if(typeof row.ref!="string"||!MUTATION_REFERENCE_PATTERN.test(row.ref))throw new PmCliError(`Mutation ${index+1} ref must match ${MUTATION_REFERENCE_PATTERN.source}.`,EXIT_CODE.USAGE);if(references[row.ref]!==void 0)throw new PmCliError(`Duplicate mutation ref "${row.ref}".`,EXIT_CODE.USAGE);references[row.ref]=typeof row.id=="string"&&row.id.trim().length>0?normalizeItemId(row.id,options.idPrefix):deriveReferencedItemId(options.transactionId,row.ref,options.idPrefix)}return references}function resolveItemMutationDocument(input,options){const rows=parseMutationDocumentRows(input),references=collectMutationReferences(rows,options);assertAcyclicCreateReferences(rows);const resolvedRows=rows.map(row=>{const resolved={...row},reference=typeof resolved.ref=="string"?resolved.ref:void 0;if(delete resolved.ref,reference!==void 0?resolved.id=references[reference]:resolved.id=replaceExactMutationReference(resolved.id,references),isPlainObject(resolved.options)){const mutationOptions={...resolved.options};for(const key of["parent","blockedBy"])mutationOptions[key]!==void 0&&(mutationOptions[key]=replaceExactMutationReference(mutationOptions[key],references));Array.isArray(mutationOptions.dep)?mutationOptions.dep=mutationOptions.dep.map(entry=>replaceDependencyReference(entry,references)):mutationOptions.dep!==void 0&&(mutationOptions.dep=replaceDependencyReference(mutationOptions.dep,references)),resolved.options=mutationOptions}return resolved}),mutations=parseItemMutationBatch(JSON.stringify(resolvedRows)),createIds=mutations.filter(mutation=>mutation.op==="create").map(mutation=>mutation.id);if(new Set(createIds).size!==createIds.length)throw new PmCliError("Duplicate resolved create id in mutation document.",EXIT_CODE.USAGE);return{schema_version:1,mutations,references}}function serializePairs(value,keys){return keys.filter(key=>value[key]!==void 0&&value[key]!==null).map(key=>{const rendered=String(value[key]);return`${key}=${/[",\n\r\\]/u.test(rendered)?JSON.stringify(rendered):rendered}`}).join(",")}function serializeObjectArray(value,keys,label){if(value!==void 0){if(!Array.isArray(value)||!value.every(isPlainObject))throw new PmCliError(`${label} must be an array of objects.`,EXIT_CODE.USAGE);return value.map(entry=>serializePairs(entry,keys))}}function scalarItemOption(key,value){return key==="tags"&&Array.isArray(value)&&value.every(entry=>typeof entry=="string")?JSON.stringify(value):typeof value=="number"||typeof value=="boolean"?String(value):value}function appendFacetOptions(target,source,skipPersistedAnnotations=!1){const mappings=[["dependencies","dep",["id","kind","created_at","author","source_kind"]],["comments","comment",["text","created_at","author"]],["notes","note",["text","created_at","author"]],["learnings","learning",["text","created_at","author"]],["files","file",["path","scope","note"]],["tests","test",["command","scope","timeout_seconds"]],["docs","doc",["path","scope","note"]],["reminders","reminder",["at","text","created_at"]],["events","event",["start_at","end_at","title","location"]],["type_options","typeOption",["key","value"]]];for(const[sourceKey,targetKey,keys]of mappings){const sourceValue=source[sourceKey],serialized=serializeObjectArray(skipPersistedAnnotations&&["comments","notes","learnings"].includes(sourceKey)&&Array.isArray(sourceValue)?sourceValue.filter(entry=>!isPlainObject(entry)||entry.created_at===void 0):sourceValue,keys,sourceKey);serialized!==void 0&&serialized.length>0&&(target[targetKey]=serialized)}}function validateItemDocumentKeys(parsed,envelope){for(const key of Object.keys(parsed)){if(envelope){if(!ITEM_ENVELOPE_KEYS.includes(key))throw unknownKeyError("item envelope",key,ITEM_ENVELOPE_KEYS);continue}if(!ITEM_FIELD_KEYS.has(key)&&nearestKey(key,[...ITEM_FIELD_KEYS])===void 0&&nearestKey(key,ITEM_ENVELOPE_KEYS)==="item")throw unknownKeyError("item envelope",key,ITEM_ENVELOPE_KEYS)}}function resolveItemDocument(parsed){const envelope=Object.hasOwn(parsed,"item");validateItemDocumentKeys(parsed,envelope);const item=envelope?parsed.item:parsed;if(!isPlainObject(item))throw new PmCliError("Item document item must be an object.",EXIT_CODE.USAGE);return{item,...envelope&&isPlainObject(parsed.linked)?{linked:parsed.linked}:{}}}function appendItemDocumentEntry(documentOptions,key,value,mode){if(!(mode==="update"?UPDATE_READ_ONLY_ITEM_KEYS:READ_ONLY_ITEM_KEYS).has(key)){if(!ITEM_FIELD_KEYS.has(key)){if(nearestKey(key,[...ITEM_FIELD_KEYS])!==void 0)throw unknownKeyError("item document",key,[...ITEM_FIELD_KEYS]);const fields=Array.isArray(documentOptions.field)?documentOptions.field:[];fields.push(serializePairs({key,value:typeof value=="string"?value:JSON.stringify(value)},["key","value"])),documentOptions.field=fields;return}["dependencies","comments","notes","learnings","files","tests","docs","reminders","events","type_options"].includes(key)||(documentOptions[key.replaceAll(/_([a-z])/gu,(_match,letter)=>letter.toUpperCase())]=scalarItemOption(key,value))}}function itemDocumentToMutationOptions(input,mode,explicitOptions={}){const parsed=parseJsonValue(input,"Item document");if(!isPlainObject(parsed))throw new PmCliError("Item document must be a JSON object.",EXIT_CODE.USAGE);const{item,linked}=resolveItemDocument(parsed),documentOptions={};for(const[key,value]of Object.entries(item))appendItemDocumentEntry(documentOptions,key,value,mode);if(appendFacetOptions(documentOptions,item,mode==="update"),linked!==void 0&&appendFacetOptions(documentOptions,linked),mode==="update"){const annotations=Object.fromEntries(["comments","notes","learnings"].filter(key=>Object.hasOwn(item,key)).map(key=>[key,item[key].filter(entry=>isPlainObject(entry)&&entry.created_at!==void 0)]));Object.keys(annotations).length>0&&(documentOptions.documentAnnotationSnapshot=annotations)}return{...documentOptions,...Object.fromEntries(Object.entries(explicitOptions).filter(([,value])=>value!==void 0)),stdinJson:void 0}}function validateItemMutationRows(value){return parseItemMutationBatch(JSON.stringify(value))}export{itemDocumentToMutationOptions,parseAtomicMutationControls,parseItemMutationBatch,resolveItemMutationDocument,validateItemMutationRows};
 //# sourceMappingURL=structured-mutations.js.map

package/dist/sdk/telemetry-flush.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]="4534b1c9-de27-5745-88f2-641b00b94714")}catch(e2){}})();import{flushTelemetryQueueNow}from"../core/telemetry/runtime.js";async function flushTelemetryQueue(){await flushTelemetryQueueNow()}export{flushTelemetryQueue};
+(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]="4534b1c9-de27-5745-88f2-641b00b94714")}catch{}})();import{flushTelemetryQueueNow}from"../core/telemetry/runtime.js";async function flushTelemetryQueue(){await flushTelemetryQueueNow()}export{flushTelemetryQueue};
 //# sourceMappingURL=telemetry-flush.js.map

package/dist/sdk/telemetry.js

@@ -1,4 +1,5 @@
-!(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]="3bc2412e-9aa0-55ea-bc51-97a6bb9b4763")}catch(e2){}})();import fs from"node:fs/promises";import path from"node:path";import{pathExists,readFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{nowIso}from"../core/shared/time.js";import{resolveGlobalPmRoot}from"../core/store/paths.js";import{readSettings,writeSettings}from"../core/store/settings.js";import{resolveTelemetryEnvironmentPolicy}from"../core/telemetry/policy.js";import{flushTelemetryQueueNow,withTelemetryQueueMutation}from"../core/telemetry/runtime.js";import{createUnknownSubcommandError}from"./agent/subcommand-recovery.js";import{PM_COMMAND_ALIAS_CONTRACTS}from"./cli-contracts/command-aliases.js";const TELEMETRY_QUEUE_RELATIVE_PATH=path.join("runtime","telemetry","events.jsonl");const TELEMETRY_STATE_RELATIVE_PATH=path.join("runtime","telemetry","state.json");const TELEMETRY_RUNTIME_RELATIVE_PATH=path.join("runtime","telemetry");const DEFAULT_STATS_LIMIT=20;const DEPRECATED_ALIASES=PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.lifecycle==="deprecated");const TELEMETRY_SUBCOMMANDS=["status","flush","stats","clear"];const nearestRankPercentile=(sortedAscending,fraction)=>{const rank=Math.ceil(fraction*sortedAscending.length);const index=Math.min(sortedAscending.length-1,Math.max(0,rank-1));return sortedAscending[index]};const normalizeTelemetryText=(value,fallback)=>{if(typeof value!=="string"){return fallback}return value.trim().length>0?value:fallback};const normalizeFiniteInteger=value=>{if(typeof value!=="number"||!Number.isFinite(value)){return void 0}return Math.trunc(value)};const normalizeTelemetryQueueEntry=entry=>{return{command:normalizeTelemetryText(entry.event.command,"<unknown>"),eventType:normalizeTelemetryText(entry.event.event_type,"unknown"),eventSchemaVersion:normalizeFiniteInteger(entry.event.schema_version),clientSchemaVersion:normalizeFiniteInteger(entry.client_schema_version)}};const createTelemetryStatsAccumulator=()=>{return{count:0,max_attempts:0,event_type_counts:{},event_schema_versions:new Set,client_schema_versions:new Set,finish_durations_ms:[],ok_count:0,error_count:0,resolution_counts:{}}};const readTelemetryDuration=payload=>{const value=payload?.duration_ms;return typeof value==="number"&&Number.isFinite(value)?value:void 0};const readTelemetryResolution=payload=>{const value=payload?.command_resolution;return normalizeTelemetryText(value,"")||void 0};const incrementTelemetryCount=(counts,key)=>{counts[key]=(counts[key]??0)+1};const recordTelemetryFinishPayload=(current,payload)=>{const durationMs=readTelemetryDuration(payload);if(durationMs!==void 0){current.finish_durations_ms.push(durationMs)}if(payload?.ok===true){current.ok_count+=1}else{current.error_count+=1}const resolution=readTelemetryResolution(payload);if(resolution!==void 0){incrementTelemetryCount(current.resolution_counts,resolution)}};const normalizeTelemetryAttempts=attempts=>Number.isFinite(attempts)?Math.max(0,Math.trunc(attempts)):0;const addTelemetryDimension=(values,value)=>{if(value!==void 0){values.add(value)}};const recordTelemetryQueueEntry=(grouped,entry)=>{const normalized=normalizeTelemetryQueueEntry(entry);const current=grouped.get(normalized.command)??createTelemetryStatsAccumulator();current.count+=1;current.max_attempts=Math.max(current.max_attempts,normalizeTelemetryAttempts(entry.attempts));incrementTelemetryCount(current.event_type_counts,normalized.eventType);addTelemetryDimension(current.event_schema_versions,normalized.eventSchemaVersion);addTelemetryDimension(current.client_schema_versions,normalized.clientSchemaVersion);if(normalized.eventType==="command_finish"){recordTelemetryFinishPayload(current,entry.event.payload)}grouped.set(normalized.command,current)};const buildTelemetryStatsBucket=(command,value)=>{const finishCount=value.ok_count+value.error_count;const sortedDurations=[...value.finish_durations_ms].sort((left,right)=>left-right);const resolutionEntries=Object.entries(value.resolution_counts).sort((left,right)=>left[0].localeCompare(right[0]));return{command,count:value.count,event_type_counts:Object.fromEntries(Object.entries(value.event_type_counts).sort((left,right)=>left[0].localeCompare(right[0]))),max_attempts:value.max_attempts,event_schema_versions:[...value.event_schema_versions].sort((left,right)=>left-right),client_schema_versions:[...value.client_schema_versions].sort((left,right)=>left-right),...sortedDurations.length>0?{duration_p50_ms:nearestRankPercentile(sortedDurations,.5),duration_p95_ms:nearestRankPercentile(sortedDurations,.95),duration_max_ms:sortedDurations[sortedDurations.length-1]}:{},...finishCount>0?{ok_count:value.ok_count,error_count:value.error_count,error_rate:value.error_count/finishCount}:{},...resolutionEntries.length>0?{command_resolution_counts:Object.fromEntries(resolutionEntries)}:{}}};const normalizeTelemetrySubcommand=value=>{const normalized=(value??"status").trim().toLowerCase();if(TELEMETRY_SUBCOMMANDS.includes(normalized)){return normalized}throw createUnknownSubcommandError({command_path:"telemetry",token:value?.trim()||"<empty>",allowed:TELEMETRY_SUBCOMMANDS,examples:["pm telemetry status","pm telemetry flush","pm telemetry stats --limit 10","pm telemetry clear"]})};const throwInvalidTelemetryLimit=()=>{throw new PmCliError("--limit must be a positive integer",EXIT_CODE.USAGE)};const requirePositiveTelemetryLimit=value=>{if([!Number.isFinite(value),!Number.isInteger(value),value<=0].includes(true)){return throwInvalidTelemetryLimit()}return value};const parseTelemetryStringLimit=raw=>{const trimmed=raw.trim();if([trimmed.length===0,!/^\d+$/.test(trimmed)].includes(true)){return throwInvalidTelemetryLimit()}return requirePositiveTelemetryLimit(Number.parseInt(trimmed,10))};const parseTelemetryStatsLimit=raw=>{if(raw===void 0){return DEFAULT_STATS_LIMIT}if(typeof raw==="number"){return requirePositiveTelemetryLimit(raw)}if(typeof raw==="string"){return parseTelemetryStringLimit(raw)}return throwInvalidTelemetryLimit()};const isTelemetryQueueEntry=value=>{if(typeof value!=="object"||value===null){return false}const candidate=value;return typeof candidate.attempts==="number"&&typeof candidate.event==="object"&&candidate.event!==null};const parseTelemetryQueueRow=row=>{try{const parsed=JSON.parse(row);return isTelemetryQueueEntry(parsed)?parsed:void 0}catch{return void 0}};const splitTelemetryQueueRows=raw=>{if(raw===null){return[]}return raw.split("\n").map(line=>line.trim()).filter(line=>line.length>0)};const parseTelemetryQueue=raw=>{const rows=splitTelemetryQueueRows(raw);const entries=[];let invalidRows=0;for(const row of rows){const parsed=parseTelemetryQueueRow(row);if(parsed===void 0){invalidRows+=1}else{entries.push(parsed)}}return{rows_total:rows.length,valid_entries:entries.length,invalid_rows:invalidRows,entries}};const isTelemetryRuntimeState=value=>typeof value==="object"&&value!==null&&!Array.isArray(value);const parseTelemetryRuntimeState=raw=>{try{const parsed=JSON.parse(raw);return isTelemetryRuntimeState(parsed)?parsed:{}}catch{return{}}};const readTelemetryRuntimeState=async statePath=>{const stateRaw=await readFileIfExists(statePath);if(stateRaw===null||stateRaw.trim().length===0){return{}}return parseTelemetryRuntimeState(stateRaw)};function aliasUsageCutoff(retentionDays){const now=new Date;return new Date(Date.UTC(now.getUTCFullYear(),now.getUTCMonth(),now.getUTCDate()-Math.max(1,Math.trunc(retentionDays))+1)).toISOString().slice(0,10)}function normalizeAliasUsageDays(value,cutoff,today){const days=Object.create(null);for(const[day,entry]of Object.entries(value)){if(!/^\d{4}-\d{2}-\d{2}$/u.test(day)||day<cutoff||day>today||typeof entry!=="object"||entry===null||Array.isArray(entry))continue;const observation=entry;if(!Number.isSafeInteger(observation.count)||observation.count<1||typeof observation.last_seen!=="string"||!observation.last_seen.startsWith(day))continue;days[day]={count:observation.count,last_seen:observation.last_seen}}return days}function normalizeAliasUsage(value,cutoff){const result=Object.create(null);if(typeof value!=="object"||value===null||Array.isArray(value))return result;const stored=value;const today=new Date().toISOString().slice(0,10);for(const contract of DEPRECATED_ALIASES){const candidate=stored[contract.alias];if(typeof candidate!=="object"||candidate===null||Array.isArray(candidate))continue;const row=candidate;if(row.canonical!==contract.canonical||typeof row.days!=="object"||row.days===null||Array.isArray(row.days))continue;const days=normalizeAliasUsageDays(row.days,cutoff,today);if(Object.keys(days).length>0)result[contract.alias]={canonical:contract.canonical,days}}return result}async function readRetainedAliasUsage(globalPmRoot,statePath,retentionDays){const cutoff=aliasUsageCutoff(retentionDays);const state=await readTelemetryRuntimeState(statePath);const usage=normalizeAliasUsage(state.alias_usage,cutoff);if(JSON.stringify(state.alias_usage??{})===JSON.stringify(usage))return usage;try{await withTelemetryQueueMutation(async()=>{const current=await readTelemetryRuntimeState(statePath);if(current.alias_usage===void 0)return;const retained=normalizeAliasUsage(current.alias_usage,cutoff);if(JSON.stringify(current.alias_usage)===JSON.stringify(retained))return;await writeFileAtomic(statePath,`${JSON.stringify({...current,alias_usage:retained},null,2)}
-`)},globalPmRoot,250)}catch{}return usage}async function recordDeprecatedAliasUsage(alias){const contract=DEPRECATED_ALIASES.find(entry=>entry.alias===alias);if(!contract||resolveTelemetryEnvironmentPolicy().telemetry_disabled)return false;const globalPmRoot=resolveGlobalPmRoot(process.cwd());try{return await withTelemetryQueueMutation(async()=>{const settings=await readSettings(globalPmRoot);if(!settings.telemetry.enabled||resolveTelemetryEnvironmentPolicy().telemetry_disabled)return false;const statePath=path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH);const state=await readTelemetryRuntimeState(statePath);const usage=normalizeAliasUsage(state.alias_usage,aliasUsageCutoff(settings.telemetry.retention_days));const day=new Date().toISOString().slice(0,10);const previous=usage[alias]?.days[day];usage[alias]={canonical:contract.canonical,days:{...usage[alias]?.days,[day]:{count:Math.min(Number.MAX_SAFE_INTEGER,(previous?.count??0)+1),last_seen:nowIso()}}};await writeFileAtomic(statePath,`${JSON.stringify({...state,alias_usage:usage},null,2)}
-`);return true},globalPmRoot,250)}catch{return false}}const nullableTelemetryStateValue=value=>value??null;const buildTelemetryStatusSummary=async globalPmRoot=>{const settings=await readSettings(globalPmRoot);const queuePath=path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH);const statePath=path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH);const queueRaw=await readFileIfExists(queuePath);const queue=parseTelemetryQueue(queueRaw);const runtimeState=await readTelemetryRuntimeState(statePath);const environmentPolicy=resolveTelemetryEnvironmentPolicy();return{enabled:settings.telemetry.enabled&&!environmentPolicy.telemetry_disabled,configured_enabled:settings.telemetry.enabled,env_overrides:environmentPolicy,endpoint:settings.telemetry.endpoint,queue_path:queuePath,state_path:statePath,queue_rows_total:queue.rows_total,queue_entries:queue.valid_entries,queue_invalid_rows:queue.invalid_rows,queue_size_bytes:Buffer.byteLength(queueRaw??"","utf8"),last_attempted_flush_at:nullableTelemetryStateValue(runtimeState.last_attempted_flush_at),last_successful_flush_at:nullableTelemetryStateValue(runtimeState.last_successful_flush_at),last_failed_flush_at:nullableTelemetryStateValue(runtimeState.last_failed_flush_at),last_failed_flush_error:nullableTelemetryStateValue(runtimeState.last_failed_flush_error)}};const buildTelemetryStatsBuckets=entries=>{const grouped=new Map;for(const entry of entries){recordTelemetryQueueEntry(grouped,entry)}return[...grouped.entries()].map(([command,value])=>buildTelemetryStatsBucket(command,value)).sort((left,right)=>right.count-left.count||left.command.localeCompare(right.command))};const runTelemetryStatus=async(_options,context)=>({action:"telemetry",subcommand:"status",status:await buildTelemetryStatusSummary(context.globalPmRoot),generated_at:nowIso()});const runTelemetryFlush=async(_options,context)=>{const before=await buildTelemetryStatusSummary(context.globalPmRoot);await flushTelemetryQueueNow(context.globalPmRoot);const after=await buildTelemetryStatusSummary(context.globalPmRoot);const queueEntriesDrained=Math.max(0,before.queue_entries-after.queue_entries);const queueEmpty=after.queue_entries===0;return{action:"telemetry",subcommand:"flush",queue_entries_before:before.queue_entries,queue_entries_after:after.queue_entries,queue_entries_drained:queueEntriesDrained,queue_progressed:queueEntriesDrained>0,queue_empty:queueEmpty,queue_drained:queueEmpty,status:after,generated_at:nowIso()}};const runTelemetryStats=async(options,context)=>{const limit=parseTelemetryStatsLimit(options.limit);const queueRaw=await readFileIfExists(context.queuePath);const queue=parseTelemetryQueue(queueRaw);const buckets=buildTelemetryStatsBuckets(queue.entries);const selected=buckets.slice(0,limit);const settings=await readSettings(context.globalPmRoot);const usage=await readRetainedAliasUsage(context.globalPmRoot,context.statePath,settings.telemetry.retention_days);const aliasUsage=Object.entries(usage).map(([alias,entry])=>{const days=Object.values(entry.days);return{alias,canonical:entry.canonical,count:days.reduce((total,day)=>Math.min(Number.MAX_SAFE_INTEGER,total+day.count),0),last_seen:days.map(day=>day.last_seen).sort().at(-1)}}).sort((left,right)=>right.count-left.count||left.alias.localeCompare(right.alias));return{action:"telemetry",subcommand:"stats",limit,total_commands:buckets.length,queue_entries:queue.valid_entries,queue_invalid_rows:queue.invalid_rows,queue_rows_total:queue.rows_total,truncated:buckets.length>selected.length,stats:selected,alias_usage:aliasUsage,zero_use_aliases:DEPRECATED_ALIASES.map(entry=>entry.alias).filter(alias=>usage[alias]===void 0),alias_usage_retention_days:settings.telemetry.retention_days,generated_at:nowIso()}};const runTelemetryClear=async(_options,context)=>{return withTelemetryQueueMutation(async()=>{const settings=await readSettings(context.globalPmRoot);const settingsChanged=[settings.telemetry.enabled!==false,settings.telemetry.installation_id!=="",settings.telemetry.first_run_prompt_completed!==true].includes(true);settings.telemetry.enabled=false;settings.telemetry.first_run_prompt_completed=true;settings.telemetry.installation_id="";if(settingsChanged){await writeSettings(context.globalPmRoot,settings,"telemetry:clear")}const telemetryRuntimePath=path.join(context.globalPmRoot,TELEMETRY_RUNTIME_RELATIVE_PATH);const existed=await pathExists(telemetryRuntimePath);await fs.rm(telemetryRuntimePath,{recursive:true,force:true});return{action:"telemetry",subcommand:"clear",settings_changed:settingsChanged,runtime_dir_removed:existed&&!await pathExists(telemetryRuntimePath),queue_exists_after:await pathExists(context.queuePath),state_exists_after:await pathExists(context.statePath),status:await buildTelemetryStatusSummary(context.globalPmRoot),generated_at:nowIso()}},context.globalPmRoot)};const TELEMETRY_COMMAND_HANDLERS={status:runTelemetryStatus,flush:runTelemetryFlush,stats:runTelemetryStats,clear:runTelemetryClear};async function runTelemetry(options,_global){void _global;const subcommand=normalizeTelemetrySubcommand(options.subcommand);const globalPmRoot=resolveGlobalPmRoot(process.cwd());return TELEMETRY_COMMAND_HANDLERS[subcommand](options,{globalPmRoot,queuePath:path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH),statePath:path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH)})}export{TELEMETRY_SUBCOMMANDS,recordDeprecatedAliasUsage,runTelemetry};
+(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]="a41eaff2-6a15-5e82-b3aa-03ca48fc3eb5")}catch{}})();import fs from"node:fs/promises";import path from"node:path";import{pathExists,readFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{nowIso}from"../core/shared/time.js";import{resolveGlobalPmRoot}from"../core/store/paths.js";import{readSettings,writeSettings}from"../core/store/settings.js";import{resolveTelemetryEnvironmentPolicy}from"../core/telemetry/policy.js";import{flushTelemetryQueueNow,withTelemetryQueueMutation}from"../core/telemetry/runtime.js";import{createUnknownSubcommandError}from"./agent/subcommand-recovery.js";import{PM_COMMAND_ALIAS_CONTRACTS}from"./cli-contracts/command-aliases.js";const TELEMETRY_QUEUE_RELATIVE_PATH=path.join("runtime","telemetry","events.jsonl"),TELEMETRY_STATE_RELATIVE_PATH=path.join("runtime","telemetry","state.json"),TELEMETRY_RUNTIME_RELATIVE_PATH=path.join("runtime","telemetry"),DEFAULT_STATS_LIMIT=20,DEPRECATED_ALIASES=PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.lifecycle==="deprecated"),TELEMETRY_SUBCOMMANDS=["status","flush","stats","clear"],nearestRankPercentile=(sortedAscending,fraction)=>{const rank=Math.ceil(fraction*sortedAscending.length),index=Math.min(sortedAscending.length-1,Math.max(0,rank-1));return sortedAscending[index]},normalizeTelemetryText=(value,fallback)=>typeof value!="string"?fallback:value.trim().length>0?value:fallback,normalizeFiniteInteger=value=>{if(!(typeof value!="number"||!Number.isFinite(value)))return Math.trunc(value)},normalizeTelemetryQueueEntry=entry=>({command:normalizeTelemetryText(entry.event.command,"<unknown>"),eventType:normalizeTelemetryText(entry.event.event_type,"unknown"),eventSchemaVersion:normalizeFiniteInteger(entry.event.schema_version),clientSchemaVersion:normalizeFiniteInteger(entry.client_schema_version)}),createTelemetryStatsAccumulator=()=>({count:0,max_attempts:0,event_type_counts:{},event_schema_versions:new Set,client_schema_versions:new Set,finish_durations_ms:[],ok_count:0,error_count:0,resolution_counts:{}}),readTelemetryDuration=payload=>{const value=payload?.duration_ms;return typeof value=="number"&&Number.isFinite(value)?value:void 0},readTelemetryResolution=payload=>{const value=payload?.command_resolution;return normalizeTelemetryText(value,"")||void 0},incrementTelemetryCount=(counts,key)=>{counts[key]=(counts[key]??0)+1},recordTelemetryFinishPayload=(current,payload)=>{const durationMs=readTelemetryDuration(payload);durationMs!==void 0&&current.finish_durations_ms.push(durationMs),payload?.ok===!0?current.ok_count+=1:current.error_count+=1;const resolution=readTelemetryResolution(payload);resolution!==void 0&&incrementTelemetryCount(current.resolution_counts,resolution)},normalizeTelemetryAttempts=attempts=>Number.isFinite(attempts)?Math.max(0,Math.trunc(attempts)):0,addTelemetryDimension=(values,value)=>{value!==void 0&&values.add(value)},recordTelemetryQueueEntry=(grouped,entry)=>{const normalized=normalizeTelemetryQueueEntry(entry),current=grouped.get(normalized.command)??createTelemetryStatsAccumulator();current.count+=1,current.max_attempts=Math.max(current.max_attempts,normalizeTelemetryAttempts(entry.attempts)),incrementTelemetryCount(current.event_type_counts,normalized.eventType),addTelemetryDimension(current.event_schema_versions,normalized.eventSchemaVersion),addTelemetryDimension(current.client_schema_versions,normalized.clientSchemaVersion),normalized.eventType==="command_finish"&&recordTelemetryFinishPayload(current,entry.event.payload),grouped.set(normalized.command,current)},buildTelemetryStatsBucket=(command,value)=>{const finishCount=value.ok_count+value.error_count,sortedDurations=[...value.finish_durations_ms].sort((left,right)=>left-right),resolutionEntries=Object.entries(value.resolution_counts).sort((left,right)=>left[0].localeCompare(right[0]));return{command,count:value.count,event_type_counts:Object.fromEntries(Object.entries(value.event_type_counts).sort((left,right)=>left[0].localeCompare(right[0]))),max_attempts:value.max_attempts,event_schema_versions:[...value.event_schema_versions].sort((left,right)=>left-right),client_schema_versions:[...value.client_schema_versions].sort((left,right)=>left-right),...sortedDurations.length>0?{duration_p50_ms:nearestRankPercentile(sortedDurations,.5),duration_p95_ms:nearestRankPercentile(sortedDurations,.95),duration_max_ms:sortedDurations[sortedDurations.length-1]}:{},...finishCount>0?{ok_count:value.ok_count,error_count:value.error_count,error_rate:value.error_count/finishCount}:{},...resolutionEntries.length>0?{command_resolution_counts:Object.fromEntries(resolutionEntries)}:{}}},normalizeTelemetrySubcommand=value=>{const normalized=(value??"status").trim().toLowerCase();if(TELEMETRY_SUBCOMMANDS.includes(normalized))return normalized;throw createUnknownSubcommandError({command_path:"telemetry",token:value?.trim()||"<empty>",allowed:TELEMETRY_SUBCOMMANDS,examples:["pm telemetry status","pm telemetry flush","pm telemetry stats --limit 10","pm telemetry clear"]})},throwInvalidTelemetryLimit=()=>{throw new PmCliError("--limit must be a positive integer",EXIT_CODE.USAGE)},requirePositiveTelemetryLimit=value=>[!Number.isFinite(value),!Number.isInteger(value),value<=0].includes(!0)?throwInvalidTelemetryLimit():value,parseTelemetryStringLimit=raw=>{const trimmed=raw.trim();return[trimmed.length===0,!/^\d+$/.test(trimmed)].includes(!0)?throwInvalidTelemetryLimit():requirePositiveTelemetryLimit(Number.parseInt(trimmed,10))},parseTelemetryStatsLimit=raw=>raw===void 0?DEFAULT_STATS_LIMIT:typeof raw=="number"?requirePositiveTelemetryLimit(raw):typeof raw=="string"?parseTelemetryStringLimit(raw):throwInvalidTelemetryLimit(),isTelemetryQueueEntry=value=>{if(typeof value!="object"||value===null)return!1;const candidate=value;return typeof candidate.attempts=="number"&&typeof candidate.event=="object"&&candidate.event!==null},parseTelemetryQueueRow=row=>{try{const parsed=JSON.parse(row);return isTelemetryQueueEntry(parsed)?parsed:void 0}catch{return}},splitTelemetryQueueRows=raw=>raw===null?[]:raw.split(`
+`).map(line=>line.trim()).filter(line=>line.length>0),parseTelemetryQueue=raw=>{const rows=splitTelemetryQueueRows(raw),entries=[];let invalidRows=0;for(const row of rows){const parsed=parseTelemetryQueueRow(row);parsed===void 0?invalidRows+=1:entries.push(parsed)}return{rows_total:rows.length,valid_entries:entries.length,invalid_rows:invalidRows,entries}},isTelemetryRuntimeState=value=>typeof value=="object"&&value!==null&&!Array.isArray(value),parseTelemetryRuntimeState=raw=>{try{const parsed=JSON.parse(raw);return isTelemetryRuntimeState(parsed)?parsed:{}}catch{return{}}},readTelemetryRuntimeState=async statePath=>{const stateRaw=await readFileIfExists(statePath);return stateRaw===null||stateRaw.trim().length===0?{}:parseTelemetryRuntimeState(stateRaw)};function aliasUsageCutoff(retentionDays){const now=new Date;return new Date(Date.UTC(now.getUTCFullYear(),now.getUTCMonth(),now.getUTCDate()-Math.max(1,Math.trunc(retentionDays))+1)).toISOString().slice(0,10)}function normalizeAliasUsageDays(value,cutoff,today){const days=Object.create(null);for(const[day,entry]of Object.entries(value)){if(!/^\d{4}-\d{2}-\d{2}$/u.test(day)||day<cutoff||day>today||typeof entry!="object"||entry===null||Array.isArray(entry))continue;const observation=entry;!Number.isSafeInteger(observation.count)||observation.count<1||typeof observation.last_seen!="string"||!observation.last_seen.startsWith(day)||(days[day]={count:observation.count,last_seen:observation.last_seen})}return days}function normalizeAliasUsage(value,cutoff){const result=Object.create(null);if(typeof value!="object"||value===null||Array.isArray(value))return result;const stored=value,today=new Date().toISOString().slice(0,10);for(const contract of DEPRECATED_ALIASES){const candidate=stored[contract.alias];if(typeof candidate!="object"||candidate===null||Array.isArray(candidate))continue;const row=candidate;if(row.canonical!==contract.canonical||typeof row.days!="object"||row.days===null||Array.isArray(row.days))continue;const days=normalizeAliasUsageDays(row.days,cutoff,today);Object.keys(days).length>0&&(result[contract.alias]={canonical:contract.canonical,days})}return result}async function readRetainedAliasUsage(globalPmRoot,statePath,retentionDays){const cutoff=aliasUsageCutoff(retentionDays),state=await readTelemetryRuntimeState(statePath),usage=normalizeAliasUsage(state.alias_usage,cutoff);if(JSON.stringify(state.alias_usage??{})===JSON.stringify(usage))return usage;try{await withTelemetryQueueMutation(async()=>{const current=await readTelemetryRuntimeState(statePath);if(current.alias_usage===void 0)return;const retained=normalizeAliasUsage(current.alias_usage,cutoff);JSON.stringify(current.alias_usage)!==JSON.stringify(retained)&&await writeFileAtomic(statePath,`${JSON.stringify({...current,alias_usage:retained},null,2)}
+`)},globalPmRoot,250)}catch{}return usage}async function recordDeprecatedAliasUsage(alias){const contract=DEPRECATED_ALIASES.find(entry=>entry.alias===alias);if(!contract||resolveTelemetryEnvironmentPolicy().telemetry_disabled)return!1;const globalPmRoot=resolveGlobalPmRoot(process.cwd());try{return await withTelemetryQueueMutation(async()=>{const settings=await readSettings(globalPmRoot);if(!settings.telemetry.enabled||resolveTelemetryEnvironmentPolicy().telemetry_disabled)return!1;const statePath=path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH),state=await readTelemetryRuntimeState(statePath),usage=normalizeAliasUsage(state.alias_usage,aliasUsageCutoff(settings.telemetry.retention_days)),day=new Date().toISOString().slice(0,10),previous=usage[alias]?.days[day];return usage[alias]={canonical:contract.canonical,days:{...usage[alias]?.days,[day]:{count:Math.min(Number.MAX_SAFE_INTEGER,(previous?.count??0)+1),last_seen:nowIso()}}},await writeFileAtomic(statePath,`${JSON.stringify({...state,alias_usage:usage},null,2)}
+`),!0},globalPmRoot,250)}catch{return!1}}const nullableTelemetryStateValue=value=>value??null,buildTelemetryStatusSummary=async globalPmRoot=>{const settings=await readSettings(globalPmRoot),queuePath=path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH),statePath=path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH),queueRaw=await readFileIfExists(queuePath),queue=parseTelemetryQueue(queueRaw),runtimeState=await readTelemetryRuntimeState(statePath),environmentPolicy=resolveTelemetryEnvironmentPolicy();return{enabled:settings.telemetry.enabled&&!environmentPolicy.telemetry_disabled,configured_enabled:settings.telemetry.enabled,env_overrides:environmentPolicy,endpoint:settings.telemetry.endpoint,queue_path:queuePath,state_path:statePath,queue_rows_total:queue.rows_total,queue_entries:queue.valid_entries,queue_invalid_rows:queue.invalid_rows,queue_size_bytes:Buffer.byteLength(queueRaw??"","utf8"),last_attempted_flush_at:nullableTelemetryStateValue(runtimeState.last_attempted_flush_at),last_successful_flush_at:nullableTelemetryStateValue(runtimeState.last_successful_flush_at),last_failed_flush_at:nullableTelemetryStateValue(runtimeState.last_failed_flush_at),last_failed_flush_error:nullableTelemetryStateValue(runtimeState.last_failed_flush_error)}},buildTelemetryStatsBuckets=entries=>{const grouped=new Map;for(const entry of entries)recordTelemetryQueueEntry(grouped,entry);return[...grouped.entries()].map(([command,value])=>buildTelemetryStatsBucket(command,value)).sort((left,right)=>right.count-left.count||left.command.localeCompare(right.command))},runTelemetryStatus=async(_options,context)=>({action:"telemetry",subcommand:"status",status:await buildTelemetryStatusSummary(context.globalPmRoot),generated_at:nowIso()}),runTelemetryFlush=async(_options,context)=>{const before=await buildTelemetryStatusSummary(context.globalPmRoot);await flushTelemetryQueueNow(context.globalPmRoot);const after=await buildTelemetryStatusSummary(context.globalPmRoot),queueEntriesDrained=Math.max(0,before.queue_entries-after.queue_entries),queueEmpty=after.queue_entries===0;return{action:"telemetry",subcommand:"flush",queue_entries_before:before.queue_entries,queue_entries_after:after.queue_entries,queue_entries_drained:queueEntriesDrained,queue_progressed:queueEntriesDrained>0,queue_empty:queueEmpty,queue_drained:queueEmpty,status:after,generated_at:nowIso()}},runTelemetryStats=async(options,context)=>{const limit=parseTelemetryStatsLimit(options.limit),queueRaw=await readFileIfExists(context.queuePath),queue=parseTelemetryQueue(queueRaw),buckets=buildTelemetryStatsBuckets(queue.entries),selected=buckets.slice(0,limit),settings=await readSettings(context.globalPmRoot),usage=await readRetainedAliasUsage(context.globalPmRoot,context.statePath,settings.telemetry.retention_days),aliasUsage=Object.entries(usage).map(([alias,entry])=>{const days=Object.values(entry.days);return{alias,canonical:entry.canonical,count:days.reduce((total,day)=>Math.min(Number.MAX_SAFE_INTEGER,total+day.count),0),last_seen:days.map(day=>day.last_seen).sort().at(-1)}}).sort((left,right)=>right.count-left.count||left.alias.localeCompare(right.alias));return{action:"telemetry",subcommand:"stats",limit,total_commands:buckets.length,queue_entries:queue.valid_entries,queue_invalid_rows:queue.invalid_rows,queue_rows_total:queue.rows_total,truncated:buckets.length>selected.length,stats:selected,alias_usage:aliasUsage,zero_use_aliases:DEPRECATED_ALIASES.map(entry=>entry.alias).filter(alias=>usage[alias]===void 0),alias_usage_retention_days:settings.telemetry.retention_days,generated_at:nowIso()}},runTelemetryClear=async(_options,context)=>withTelemetryQueueMutation(async()=>{const settings=await readSettings(context.globalPmRoot),settingsChanged=[settings.telemetry.enabled!==!1,settings.telemetry.installation_id!=="",settings.telemetry.first_run_prompt_completed!==!0].includes(!0);settings.telemetry.enabled=!1,settings.telemetry.first_run_prompt_completed=!0,settings.telemetry.installation_id="",settingsChanged&&await writeSettings(context.globalPmRoot,settings,"telemetry:clear");const telemetryRuntimePath=path.join(context.globalPmRoot,TELEMETRY_RUNTIME_RELATIVE_PATH),existed=await pathExists(telemetryRuntimePath);return await fs.rm(telemetryRuntimePath,{recursive:!0,force:!0}),{action:"telemetry",subcommand:"clear",settings_changed:settingsChanged,runtime_dir_removed:existed&&!await pathExists(telemetryRuntimePath),queue_exists_after:await pathExists(context.queuePath),state_exists_after:await pathExists(context.statePath),status:await buildTelemetryStatusSummary(context.globalPmRoot),generated_at:nowIso()}},context.globalPmRoot),TELEMETRY_COMMAND_HANDLERS={status:runTelemetryStatus,flush:runTelemetryFlush,stats:runTelemetryStats,clear:runTelemetryClear};async function runTelemetry(options,_global){const subcommand=normalizeTelemetrySubcommand(options.subcommand),globalPmRoot=resolveGlobalPmRoot(process.cwd());return TELEMETRY_COMMAND_HANDLERS[subcommand](options,{globalPmRoot,queuePath:path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH),statePath:path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH)})}export{TELEMETRY_SUBCOMMANDS,recordDeprecatedAliasUsage,runTelemetry};
 //# sourceMappingURL=telemetry.js.map

package/dist/sdk/templates.js

@@ -1,3 +1,27 @@
-!(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]="ff76c0f3-d8cf-51de-a7e6-acb0a4942268")}catch(e2){}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{pathExists,readFileIfExists}from"../core/fs/fs-utils.js";import{writeWorkspaceJsonWithHistory}from"../core/history/workspace-history.js";import{resolveAuthor}from"../core/shared/author.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{nowIso}from"../core/shared/time.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS}from"./cli-contracts.js";const TEMPLATE_DIRECTORY_NAME="templates";const TEMPLATE_FILE_EXTENSION=".json";const TEMPLATE_NAME_PATTERN=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/;const TEMPLATE_OPTION_REPEATABLE_KEYS=CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS.map(entry=>entry.target).filter(target=>target!=="acceptanceCriteria");const TEMPLATE_OPTION_REPEATABLE_KEY_SET=new Set(TEMPLATE_OPTION_REPEATABLE_KEYS);const BUILTIN_TEMPLATE_TIMESTAMP="1970-01-01T00:00:00.000Z";const BUILTIN_TEMPLATES={bug:{type:"Issue",priority:"1",tags:"bug",acceptanceCriteria:"Bug no longer reproduces with the steps below and a regression test guards it.",expectedResult:"Describe the correct behavior.",actualResult:"Describe the observed (buggy) behavior.",body:"## Repro steps\n1. \n2. \n3. \n\n## Expected\n\n## Actual\n"},feature:{type:"Feature",priority:"2",tags:"feature",acceptanceCriteria:"Feature is shipped behind agreed scope with tests and docs updated.",whyNow:"Explain why this is worth doing now (impact / urgency).",body:"## Goal\n\n## Why now\n\n## Out of scope\n"},spike:{type:"Task",priority:"2",tags:"spike",estimatedMinutes:"120",acceptanceCriteria:"Timeboxed investigation complete; findings and a recommendation are recorded.",body:"## Question to answer\n\n## Timebox\n2h\n\n## Findings\n\n## Recommendation\n"},chore:{type:"Chore",priority:"3",tags:"chore",acceptanceCriteria:"Maintenance task done with no behavior change and green checks.",body:"## What\n\n## Why\n"}};const _testOnly={normalizeTemplateName,extractTemplateOptions,parseStoredTemplateDocument,builtinTemplateDocument,readStoredTemplateDocument};function normalizeTemplateName(rawName){const name=rawName.trim();if(!TEMPLATE_NAME_PATTERN.test(name)){throw new PmCliError(`Invalid template name "${rawName}". Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._-]*.`,EXIT_CODE.USAGE)}return name}function templatesDirectory(pmRoot){return path.join(pmRoot,TEMPLATE_DIRECTORY_NAME)}function templatePath(pmRoot,normalizedName){return path.join(templatesDirectory(pmRoot),`${normalizedName}${TEMPLATE_FILE_EXTENSION}`)}async function ensureTrackerInitialized(pmRoot){await assertInitializedTracker(pmRoot)}function sortTemplateOptions(options){return Object.fromEntries(Object.entries(options).sort(([left],[right])=>left.localeCompare(right)))}function extractTemplateOptions(rawOptions){const next={};for(const[key,value]of Object.entries(rawOptions)){if(value===void 0){continue}if(TEMPLATE_OPTION_REPEATABLE_KEY_SET.has(key)){if(typeof value==="string"){next[key]=[value];continue}if(!Array.isArray(value)){continue}const values=value.filter(entry=>typeof entry==="string");if(values.length>0){next[key]=values}continue}if(typeof value==="string"){next[key]=value;continue}if(Array.isArray(value)&&value.every(entry=>typeof entry==="string")){next[key]=[...value]}}return sortTemplateOptions(next)}function parseStoredTemplateOptions(rawOptions,templateName){if(typeof rawOptions!=="object"||rawOptions===null||Array.isArray(rawOptions)){throw new PmCliError(`Template "${templateName}" has invalid options payload.`,EXIT_CODE.GENERIC_FAILURE)}const optionsRecord=rawOptions;const normalized={};for(const[key,value]of Object.entries(optionsRecord)){const normalizedKey=key.trim();if(normalizedKey.length===0){throw new PmCliError(`Template "${templateName}" contains an empty option key.`,EXIT_CODE.GENERIC_FAILURE)}if(typeof value==="string"){normalized[normalizedKey]=value;continue}if(Array.isArray(value)&&value.every(entry=>typeof entry==="string")){normalized[normalizedKey]=[...value];continue}throw new PmCliError(`Template "${templateName}" contains invalid value for option "${normalizedKey}".`,EXIT_CODE.GENERIC_FAILURE)}return sortTemplateOptions(normalized)}function parseStoredTemplateDocument(raw,normalizedName){let parsed;try{parsed=JSON.parse(raw)}catch{throw new PmCliError(`Template "${normalizedName}" contains invalid JSON.`,EXIT_CODE.GENERIC_FAILURE)}if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed)){throw new PmCliError(`Template "${normalizedName}" has invalid document shape.`,EXIT_CODE.GENERIC_FAILURE)}const record=parsed;const options=parseStoredTemplateOptions(record.options,normalizedName);const now=nowIso();return{name:typeof record.name==="string"&&record.name.trim().length>0?record.name.trim():normalizedName,created_at:typeof record.created_at==="string"?record.created_at:now,updated_at:typeof record.updated_at==="string"?record.updated_at:now,options}}function builtinTemplateDocument(normalizedName){const options=BUILTIN_TEMPLATES[normalizedName];if(!options){return null}return{name:normalizedName,created_at:BUILTIN_TEMPLATE_TIMESTAMP,updated_at:BUILTIN_TEMPLATE_TIMESTAMP,options:sortTemplateOptions({...options})}}async function resolveTemplateDocument(pmRoot,normalizedName){const raw=await readFileIfExists(templatePath(pmRoot,normalizedName));if(raw!==null){return{document:parseStoredTemplateDocument(raw,normalizedName),source:"user"}}const builtin=builtinTemplateDocument(normalizedName);if(builtin){return{document:builtin,source:"builtin"}}throw new PmCliError(`Template "${normalizedName}" not found`,EXIT_CODE.NOT_FOUND)}async function readStoredTemplateDocument(pmRoot,normalizedName){const raw=await readFileIfExists(templatePath(pmRoot,normalizedName));if(raw===null){throw new PmCliError(`Template "${normalizedName}" not found`,EXIT_CODE.NOT_FOUND)}return parseStoredTemplateDocument(raw,normalizedName)}async function loadCreateTemplateOptions(pmRoot,rawTemplateName){const normalizedName=normalizeTemplateName(rawTemplateName);const{document}=await resolveTemplateDocument(pmRoot,normalizedName);return document.options}async function runTemplatesSave(rawTemplateName,options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await ensureTrackerInitialized(pmRoot);const normalizedName=normalizeTemplateName(rawTemplateName);const nextOptions=extractTemplateOptions(options);if(Object.keys(nextOptions).length===0){throw new PmCliError("templates save requires at least one create option flag",EXIT_CODE.USAGE)}const now=nowIso();const storedPath=templatePath(pmRoot,normalizedName);let createdAt=now;if(await pathExists(storedPath)){const existing=await readStoredTemplateDocument(pmRoot,normalizedName);createdAt=existing.created_at}const document={name:normalizedName,created_at:createdAt,updated_at:now,options:nextOptions};const settings=await readSettings(pmRoot);await fs.mkdir(templatesDirectory(pmRoot),{recursive:true});await writeWorkspaceJsonWithHistory({pmRoot,filePath:storedPath,raw:`${JSON.stringify(document,null,2)}
-`,op:"templates:save",author:resolveAuthor(void 0,settings.author_default),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms});return{name:document.name,created_at:document.created_at,updated_at:document.updated_at,path:storedPath,options:document.options}}async function readUserTemplateNames(pmRoot){const dirPath=templatesDirectory(pmRoot);if(!await pathExists(dirPath)){return[]}const entries=await fs.readdir(dirPath);return entries.filter(entry=>entry.toLowerCase().endsWith(TEMPLATE_FILE_EXTENSION)).map(entry=>entry.slice(0,-TEMPLATE_FILE_EXTENSION.length)).filter(entry=>TEMPLATE_NAME_PATTERN.test(entry))}async function runTemplatesList(global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await ensureTrackerInitialized(pmRoot);const userTemplates=await readUserTemplateNames(pmRoot);const userTemplateSet=new Set(userTemplates);const builtinTemplates=Object.keys(BUILTIN_TEMPLATES).filter(name=>!userTemplateSet.has(name));const sortedUser=[...userTemplates].sort((left,right)=>left.localeCompare(right));const sortedBuiltin=[...builtinTemplates].sort((left,right)=>left.localeCompare(right));const templates=[...new Set([...sortedUser,...sortedBuiltin])].sort((left,right)=>left.localeCompare(right));return{templates,count:templates.length,builtin_templates:sortedBuiltin,user_templates:sortedUser}}async function runTemplatesShow(rawTemplateName,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await ensureTrackerInitialized(pmRoot);const normalizedName=normalizeTemplateName(rawTemplateName);const{document,source}=await resolveTemplateDocument(pmRoot,normalizedName);return{name:document.name,source,created_at:document.created_at,updated_at:document.updated_at,path:source==="builtin"?`builtin:${normalizedName}`:templatePath(pmRoot,normalizedName),options:document.options}}export{_testOnly,loadCreateTemplateOptions,runTemplatesList,runTemplatesSave,runTemplatesShow};
+(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]="ac2020a4-78bf-5aa3-a5c4-88d3196dfb1f")}catch{}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{pathExists,readFileIfExists}from"../core/fs/fs-utils.js";import{writeWorkspaceJsonWithHistory}from"../core/history/workspace-history.js";import{resolveAuthor}from"../core/shared/author.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{nowIso}from"../core/shared/time.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS}from"./cli-contracts.js";const TEMPLATE_DIRECTORY_NAME="templates",TEMPLATE_FILE_EXTENSION=".json",TEMPLATE_NAME_PATTERN=/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/,TEMPLATE_OPTION_REPEATABLE_KEYS=CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS.map(entry=>entry.target).filter(target=>target!=="acceptanceCriteria"),TEMPLATE_OPTION_REPEATABLE_KEY_SET=new Set(TEMPLATE_OPTION_REPEATABLE_KEYS),BUILTIN_TEMPLATE_TIMESTAMP="1970-01-01T00:00:00.000Z",BUILTIN_TEMPLATES={bug:{type:"Issue",priority:"1",tags:"bug",acceptanceCriteria:"Bug no longer reproduces with the steps below and a regression test guards it.",expectedResult:"Describe the correct behavior.",actualResult:"Describe the observed (buggy) behavior.",body:`## Repro steps
+1. 
+2. 
+3. 
+
+## Expected
+
+## Actual
+`},feature:{type:"Feature",priority:"2",tags:"feature",acceptanceCriteria:"Feature is shipped behind agreed scope with tests and docs updated.",whyNow:"Explain why this is worth doing now (impact / urgency).",body:`## Goal
+
+## Why now
+
+## Out of scope
+`},spike:{type:"Task",priority:"2",tags:"spike",estimatedMinutes:"120",acceptanceCriteria:"Timeboxed investigation complete; findings and a recommendation are recorded.",body:`## Question to answer
+
+## Timebox
+2h
+
+## Findings
+
+## Recommendation
+`},chore:{type:"Chore",priority:"3",tags:"chore",acceptanceCriteria:"Maintenance task done with no behavior change and green checks.",body:`## What
+
+## Why
+`}},_testOnly={normalizeTemplateName,extractTemplateOptions,parseStoredTemplateDocument,builtinTemplateDocument,readStoredTemplateDocument};function normalizeTemplateName(rawName){const name=rawName.trim();if(!TEMPLATE_NAME_PATTERN.test(name))throw new PmCliError(`Invalid template name "${rawName}". Expected 1-64 characters matching [A-Za-z0-9][A-Za-z0-9._-]*.`,EXIT_CODE.USAGE);return name}function templatesDirectory(pmRoot){return path.join(pmRoot,TEMPLATE_DIRECTORY_NAME)}function templatePath(pmRoot,normalizedName){return path.join(templatesDirectory(pmRoot),`${normalizedName}${TEMPLATE_FILE_EXTENSION}`)}async function ensureTrackerInitialized(pmRoot){await assertInitializedTracker(pmRoot)}function sortTemplateOptions(options){return Object.fromEntries(Object.entries(options).sort(([left],[right])=>left.localeCompare(right)))}function extractTemplateOptions(rawOptions){const next={};for(const[key,value]of Object.entries(rawOptions))if(value!==void 0){if(TEMPLATE_OPTION_REPEATABLE_KEY_SET.has(key)){if(typeof value=="string"){next[key]=[value];continue}if(!Array.isArray(value))continue;const values=value.filter(entry=>typeof entry=="string");values.length>0&&(next[key]=values);continue}if(typeof value=="string"){next[key]=value;continue}Array.isArray(value)&&value.every(entry=>typeof entry=="string")&&(next[key]=[...value])}return sortTemplateOptions(next)}function parseStoredTemplateOptions(rawOptions,templateName){if(typeof rawOptions!="object"||rawOptions===null||Array.isArray(rawOptions))throw new PmCliError(`Template "${templateName}" has invalid options payload.`,EXIT_CODE.GENERIC_FAILURE);const optionsRecord=rawOptions,normalized={};for(const[key,value]of Object.entries(optionsRecord)){const normalizedKey=key.trim();if(normalizedKey.length===0)throw new PmCliError(`Template "${templateName}" contains an empty option key.`,EXIT_CODE.GENERIC_FAILURE);if(typeof value=="string"){normalized[normalizedKey]=value;continue}if(Array.isArray(value)&&value.every(entry=>typeof entry=="string")){normalized[normalizedKey]=[...value];continue}throw new PmCliError(`Template "${templateName}" contains invalid value for option "${normalizedKey}".`,EXIT_CODE.GENERIC_FAILURE)}return sortTemplateOptions(normalized)}function parseStoredTemplateDocument(raw,normalizedName){let parsed;try{parsed=JSON.parse(raw)}catch{throw new PmCliError(`Template "${normalizedName}" contains invalid JSON.`,EXIT_CODE.GENERIC_FAILURE)}if(typeof parsed!="object"||parsed===null||Array.isArray(parsed))throw new PmCliError(`Template "${normalizedName}" has invalid document shape.`,EXIT_CODE.GENERIC_FAILURE);const record=parsed,options=parseStoredTemplateOptions(record.options,normalizedName),now=nowIso();return{name:typeof record.name=="string"&&record.name.trim().length>0?record.name.trim():normalizedName,created_at:typeof record.created_at=="string"?record.created_at:now,updated_at:typeof record.updated_at=="string"?record.updated_at:now,options}}function builtinTemplateDocument(normalizedName){const options=BUILTIN_TEMPLATES[normalizedName];return options?{name:normalizedName,created_at:BUILTIN_TEMPLATE_TIMESTAMP,updated_at:BUILTIN_TEMPLATE_TIMESTAMP,options:sortTemplateOptions({...options})}:null}async function resolveTemplateDocument(pmRoot,normalizedName){const raw=await readFileIfExists(templatePath(pmRoot,normalizedName));if(raw!==null)return{document:parseStoredTemplateDocument(raw,normalizedName),source:"user"};const builtin=builtinTemplateDocument(normalizedName);if(builtin)return{document:builtin,source:"builtin"};throw new PmCliError(`Template "${normalizedName}" not found`,EXIT_CODE.NOT_FOUND)}async function readStoredTemplateDocument(pmRoot,normalizedName){const raw=await readFileIfExists(templatePath(pmRoot,normalizedName));if(raw===null)throw new PmCliError(`Template "${normalizedName}" not found`,EXIT_CODE.NOT_FOUND);return parseStoredTemplateDocument(raw,normalizedName)}async function loadCreateTemplateOptions(pmRoot,rawTemplateName){const normalizedName=normalizeTemplateName(rawTemplateName),{document}=await resolveTemplateDocument(pmRoot,normalizedName);return document.options}async function runTemplatesSave(rawTemplateName,options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await ensureTrackerInitialized(pmRoot);const normalizedName=normalizeTemplateName(rawTemplateName),nextOptions=extractTemplateOptions(options);if(Object.keys(nextOptions).length===0)throw new PmCliError("templates save requires at least one create option flag",EXIT_CODE.USAGE);const now=nowIso(),storedPath=templatePath(pmRoot,normalizedName);let createdAt=now;await pathExists(storedPath)&&(createdAt=(await readStoredTemplateDocument(pmRoot,normalizedName)).created_at);const document={name:normalizedName,created_at:createdAt,updated_at:now,options:nextOptions},settings=await readSettings(pmRoot);return await fs.mkdir(templatesDirectory(pmRoot),{recursive:!0}),await writeWorkspaceJsonWithHistory({pmRoot,filePath:storedPath,raw:`${JSON.stringify(document,null,2)}
+`,op:"templates:save",author:resolveAuthor(void 0,settings.author_default),lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms}),{name:document.name,created_at:document.created_at,updated_at:document.updated_at,path:storedPath,options:document.options}}async function readUserTemplateNames(pmRoot){const dirPath=templatesDirectory(pmRoot);return await pathExists(dirPath)?(await fs.readdir(dirPath)).filter(entry=>entry.toLowerCase().endsWith(TEMPLATE_FILE_EXTENSION)).map(entry=>entry.slice(0,-TEMPLATE_FILE_EXTENSION.length)).filter(entry=>TEMPLATE_NAME_PATTERN.test(entry)):[]}async function runTemplatesList(global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await ensureTrackerInitialized(pmRoot);const userTemplates=await readUserTemplateNames(pmRoot),userTemplateSet=new Set(userTemplates),builtinTemplates=Object.keys(BUILTIN_TEMPLATES).filter(name=>!userTemplateSet.has(name)),sortedUser=[...userTemplates].sort((left,right)=>left.localeCompare(right)),sortedBuiltin=[...builtinTemplates].sort((left,right)=>left.localeCompare(right)),templates=[...new Set([...sortedUser,...sortedBuiltin])].sort((left,right)=>left.localeCompare(right));return{templates,count:templates.length,builtin_templates:sortedBuiltin,user_templates:sortedUser}}async function runTemplatesShow(rawTemplateName,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await ensureTrackerInitialized(pmRoot);const normalizedName=normalizeTemplateName(rawTemplateName),{document,source}=await resolveTemplateDocument(pmRoot,normalizedName);return{name:document.name,source,created_at:document.created_at,updated_at:document.updated_at,path:source==="builtin"?`builtin:${normalizedName}`:templatePath(pmRoot,normalizedName),options:document.options}}export{_testOnly,loadCreateTemplateOptions,runTemplatesList,runTemplatesSave,runTemplatesShow};
 //# sourceMappingURL=templates.js.map

package/dist/sdk/test/batch.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]="e3e3a1d4-4552-5f3c-9b02-c33ae72ea32b")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{parseOptionalNumber}from"../../core/item/parse.js";import{normalizeStatusInput}from"../../core/item/status.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{nowIso}from"../../core/shared/time.js";import{listAllItemMetadataLight}from"../../core/store/item-store.js";import{resolveGlobalPmRoot,resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{appendTrackedTestRunSummary}from"../../core/test/item-test-run-tracking.js";import{resolveAuthor}from"../../core/shared/author.js";import{countFailureCategories,runLinkedTests,runTest,summarizeContextPreflight}from"./execution.js";const parseStatus=(raw,statusRegistry)=>{if(raw===void 0){return void 0}const normalized=normalizeStatusInput(raw,statusRegistry);if(!normalized){const allowedStatuses=statusRegistry.definitions.map(definition=>definition.id);throw new PmCliError(`Invalid --status value "${raw}". Allowed: ${allowedStatuses.join(", ")}`,EXIT_CODE.USAGE)}return normalized};const parseTimeout=raw=>{if(raw===void 0){return void 0}const parsed=parseOptionalNumber(raw,"timeout");if(parsed<=0){throw new PmCliError("timeout must be a positive number",EXIT_CODE.USAGE)}return parsed};const parseNonNegativeInteger=(raw,flag)=>{if(raw===void 0){return void 0}const parsed=Number(raw);if(!Number.isInteger(parsed)||parsed<0){throw new PmCliError(`${flag} must be a non-negative integer`,EXIT_CODE.USAGE)}return parsed};const formatTrackingError=error=>{return error instanceof Error?error.message:String(error)};const resolveTrackedRunId=()=>{const fromEnv=process.env.PM_BACKGROUND_TEST_RUN_ID?.trim();if(fromEnv&&fromEnv.length>0){return fromEnv}return`test-all-local-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`};const normalizeCommand=command=>{return command.trim().replaceAll(/\s+/g," ")};const normalizeEnvSetSignature=value=>{if(!value||Object.keys(value).length===0){return"{}"}return JSON.stringify(Object.fromEntries(Object.entries(value).sort(([left],[right])=>left.localeCompare(right))))};const normalizeEnvClearSignature=value=>{if(!value||value.length===0){return"[]"}return JSON.stringify([...value].sort((left,right)=>left.localeCompare(right)))};const normalizePmContextModeSignature=value=>{const normalized=value?.trim().toLowerCase();return normalized&&normalized.length>0?normalized:"none"};const normalizeWorkspaceContextModeSignature=value=>{const normalized=value?.trim().toLowerCase();return normalized&&normalized.length>0?normalized:"source"};const normalizeAssertionStrings=values=>[...new Set(values??[])].sort((left,right)=>left.localeCompare(right));const normalizeAssertionMap=value=>Object.fromEntries(Object.entries(value??{}).sort(([left],[right])=>left.localeCompare(right)));const normalizeAssertionLineCount=value=>typeof value==="number"?value:void 0;const normalizeAssertionSignature=test=>{const normalized={assert_stdout_contains:normalizeAssertionStrings(test.assert_stdout_contains),assert_stdout_regex:normalizeAssertionStrings(test.assert_stdout_regex),assert_stderr_contains:normalizeAssertionStrings(test.assert_stderr_contains),assert_stderr_regex:normalizeAssertionStrings(test.assert_stderr_regex),assert_stdout_min_lines:normalizeAssertionLineCount(test.assert_stdout_min_lines),assert_json_field_equals:normalizeAssertionMap(test.assert_json_field_equals),assert_json_field_gte:normalizeAssertionMap(test.assert_json_field_gte)};return JSON.stringify(normalized)};const resolveLinkedTestTargetSignature=test=>{const command=resolveOptionalEnvironmentValue(test.command);if(command!==void 0){return`command:${test.scope}:${normalizeCommand(command)}`}return`path:${test.scope}:${resolveOptionalEnvironmentValue(test.path)??""}`};const buildLinkedTestKey=test=>{const envSet=normalizeEnvSetSignature(test.env_set);const envClear=normalizeEnvClearSignature(test.env_clear);const pmContextMode=normalizePmContextModeSignature(test.pm_context_mode);const workspaceContextMode=normalizeWorkspaceContextModeSignature(test.workspace_context_mode);const sharedHostSafe=test.shared_host_safe===true?"true":"false";const assertions=normalizeAssertionSignature(test);return`${resolveLinkedTestTargetSignature(test)}:${envSet}:${envClear}:${pmContextMode}:${workspaceContextMode}:${sharedHostSafe}:${assertions}`};const maxTimeoutSeconds=(current,candidate)=>{if(candidate===void 0){return current}if(current===void 0||candidate>current){return candidate}return current};const countStatuses=runResults=>{let passed=0;let failed=0;let skipped=0;for(const result of runResults){if(result.status==="passed"){passed+=1;continue}if(result.status==="failed"){failed+=1;continue}skipped+=1}return{passed,failed,skipped}};const mergeFailureCategoryCounts=(target,source)=>{for(const[key,value]of Object.entries(source)){target[key]+=value}};const emitTestAllProgress=(options,message)=>{if(options.progress!==true){return}try{process.stderr.write(`[pm test-all] ${message}
-`)}catch{}};const collectTestAllItemTests=async(filteredItems,global2,pmRoot)=>{const itemTests=[];let linkedTests=0;for(const item of filteredItems){const readResult=await runTest(item.id,{run:false},{...global2,path:pmRoot});linkedTests+=readResult.tests.length;itemTests.push({item,tests:readResult.tests})}return{itemTests,linkedTests}};const selectTestAllItems=async params=>{const statusRegistry=resolveRuntimeStatusRegistry(params.settings.schema);const typeRegistry=resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations());const statusFilter=parseStatus(params.options.status,statusRegistry);const limitFilter=parseNonNegativeInteger(params.options.limit,"--limit");const offsetFilter=parseNonNegativeInteger(params.options.offset,"--offset")??0;const allItems=await listAllItemMetadataLight(params.pmRoot,params.settings.item_format,typeRegistry.type_to_folder,void 0,params.settings.schema);const statusFilteredItems=allItems.filter(item=>statusFilter?item.status===statusFilter:true).sort((a,b)=>a.id.localeCompare(b.id));const filteredItems=limitFilter===void 0?statusFilteredItems.slice(offsetFilter):statusFilteredItems.slice(offsetFilter,offsetFilter+limitFilter);return{filteredItems,statusFilter,limitFilter,offsetFilter}};const buildEffectiveTimeoutByKey=itemTests=>{const effectiveTimeoutByKey=new Map;for(const{tests}of itemTests){for(const test of tests){const key=buildLinkedTestKey(test);if(!effectiveTimeoutByKey.has(key)){effectiveTimeoutByKey.set(key,test.timeout_seconds);continue}effectiveTimeoutByKey.set(key,maxTimeoutSeconds(effectiveTimeoutByKey.get(key),test.timeout_seconds))}}return effectiveTimeoutByKey};const runTestAllItem=async(entry,context)=>{const testsToRun=[];const keyedTests=entry.tests.map(test=>{const key=buildLinkedTestKey(test);const duplicate=context.seenTestKeys.has(key);if(!duplicate){context.seenTestKeys.add(key);const effectiveTimeoutSeconds=context.effectiveTimeoutByKey.get(key);testsToRun.push(effectiveTimeoutSeconds===void 0?test:{...test,timeout_seconds:effectiveTimeoutSeconds})}return{test,key,duplicate}});const executedResults=testsToRun.length>0?await runLinkedTests(testsToRun,context.defaultTimeoutSeconds,{progress:context.options.progress,sourceRoots:context.sourceRoots,envSet:context.options.envSet,envClear:context.options.envClear,sharedHostSafe:context.options.sharedHostSafe,pmContext:context.options.pmContext,overrideLinkedPmContext:context.options.overrideLinkedPmContext,failOnContextMismatch:context.options.failOnContextMismatch,failOnEmptyTestRun:context.options.failOnEmptyTestRun,requireAssertionsForPm:context.options.requireAssertionsForPm,checkContext:context.options.checkContext,autoPmContext:context.options.autoPmContext,workspaceContext:context.options.workspaceContext,overrideLinkedWorkspaceContext:context.options.overrideLinkedWorkspaceContext,pmRoot:context.pmRoot,allowUntrustedLinkedTests:context.options.allowUntrustedLinkedTests,untrustedLinkedTestsPolicyEnabled:context.settings.testing.allow_untrusted_linked_tests}):[];let executedIndex=0;const runResults=keyedTests.map(({test,key,duplicate})=>{if(!duplicate){const executed=executedResults[executedIndex];executedIndex+=1;return executed}return{command:test.command,path:test.path,status:"skipped",error:`Duplicate linked test skipped (key=${key}).`}});const summary=countStatuses(runResults);const failureCategories=countFailureCategories(runResults);const trackingWarnings=await appendTestAllItemTracking(entry,summary,runResults,context);return{passed:summary.passed,failed:summary.failed,skipped:summary.skipped,trackingWarnings,failureCategories,result:{ok:summary.failed===0&&!(context.options.failOnSkipped===true&&summary.skipped>0),id:entry.item.id,status:entry.item.status,test_count:entry.tests.length,passed:summary.passed,failed:summary.failed,skipped:summary.skipped,run_results:runResults,failure_categories:failureCategories}}};const trackedRunFailed=(summary,options)=>[summary.failed>0,options.failOnSkipped===true&&summary.skipped>0].includes(true);const optionalTrue=value=>value?true:void 0;const appendTestAllItemTracking=async(entry,summary,runResults,context)=>{if(!context.trackingEnabled){return[]}try{const failed=trackedRunFailed(summary,context.options);await appendTrackedTestRunSummary({pmRoot:context.pmRoot,settings:context.settings,itemId:entry.item.id,author:context.trackingAuthor,message:`Track test-all run summary (${context.trackingRunId})`,entry:{run_id:context.trackingRunId,kind:"test-all",status:failed?"failed":"passed",started_at:context.runStartedAt,finished_at:nowIso(),recorded_at:nowIso(),attempt:context.trackingAttempt,resumed_from:context.trackingResumedFrom,passed:summary.passed,failed:summary.failed,skipped:summary.skipped,items:1,linked_tests:entry.tests.length,fail_on_skipped_triggered:optionalTrue(context.options.failOnSkipped===true&&summary.skipped>0),executions:runResults.filter(result=>result.command?.trim()).slice(0,32).map(result=>({command:result.command.trim(),requested_pm_context_mode:result.execution_context?.requested_pm_context_mode,pm_context_mode:result.execution_context?.pm_context_mode,workspace_context_mode:result.execution_context?.workspace_context_mode,trust_reason:result.execution_context?.trust.reason}))}})}catch(error){return[`test_result_tracking_failed:${entry.item.id}:${formatTrackingError(error)}`]}return[]};const resolveTrackingAttempt=()=>{const raw=process.env.PM_BACKGROUND_TEST_RUN_ATTEMPT?.trim();const parsed=raw?Number.parseInt(raw,10):Number.NaN;return Number.isFinite(parsed)&&parsed>=1?parsed:void 0};const resolveOptionalEnvironmentValue=value=>{const trimmed=value?.trim();return trimmed&&trimmed.length>0?trimmed:void 0};const buildTestAllItemRunContext=params=>{return{pmRoot:params.pmRoot,settings:params.settings,options:params.options,defaultTimeoutSeconds:params.defaultTimeoutSeconds,sourceRoots:{projectPmRoot:params.pmRoot,globalPmRoot:resolveGlobalPmRoot(process.cwd())},seenTestKeys:new Set,effectiveTimeoutByKey:buildEffectiveTimeoutByKey(params.itemTests),trackingEnabled:params.settings.testing.record_results_to_items===true,trackingAuthor:resolveAuthor(params.options.author,params.settings.author_default),trackingRunId:resolveTrackedRunId(),trackingAttempt:resolveTrackingAttempt(),trackingResumedFrom:resolveOptionalEnvironmentValue(process.env.PM_BACKGROUND_TEST_RUN_RESUMED_FROM),runStartedAt:params.runStartedAt}};const initializeTestAllAccumulation=(options,linkedTests,filteredItems)=>{const accumulation={results:[],passed:0,failed:0,skipped:0,failureCategories:countFailureCategories([]),trackingWarnings:[]};const failOnEmptyTestRunTriggered=options.failOnEmptyTestRun===true&&linkedTests===0;if(failOnEmptyTestRunTriggered){accumulation.failed+=1;accumulation.failureCategories.empty_run+=1;accumulation.trackingWarnings.push(`empty_linked_test_selection:items=${filteredItems.length};linked_tests=0;fail_on_empty_test_run=true`)}return{accumulation,failOnEmptyTestRunTriggered}};const runTestAllItems=async(itemTests,context,accumulation)=>{for(const[itemIndex,entry]of itemTests.entries()){emitTestAllProgress(context.options,`item ${itemIndex+1}/${itemTests.length} start id=${entry.item.id} linked_tests=${entry.tests.length}`);const execution=await runTestAllItem(entry,context);mergeFailureCategoryCounts(accumulation.failureCategories,execution.failureCategories);accumulation.passed+=execution.passed;accumulation.failed+=execution.failed;accumulation.skipped+=execution.skipped;accumulation.trackingWarnings.push(...execution.trackingWarnings);accumulation.results.push(execution.result);emitTestAllProgress(context.options,`item ${itemIndex+1}/${itemTests.length} end id=${entry.item.id} status=${execution.failed===0?"passed":"failed"} passed=${execution.passed} failed=${execution.failed} skipped=${execution.skipped}`)}};const appendContextPreflightWarning=(options,accumulation)=>{if(options.checkContext!==true){return}const allRunResults=accumulation.results.flatMap(entry=>entry.run_results);const preflight=summarizeContextPreflight(allRunResults);accumulation.trackingWarnings.push(`context_preflight:checked_pm_commands=${preflight.checked_pm_commands};tracker_read_commands=${preflight.tracker_read_commands};mismatches=${preflight.mismatches};auto_remediated=${preflight.auto_remediated}`)};const buildTestAllResult=params=>{return{ok:params.ok,totals:{items:params.filteredItems.length,linked_tests:params.linkedTests,passed:params.accumulation.passed,failed:params.accumulation.failed,skipped:params.accumulation.skipped,failure_categories:params.accumulation.failureCategories},failed:params.accumulation.failed,passed:params.accumulation.passed,skipped:params.accumulation.skipped,fail_on_skipped_triggered:params.failOnSkippedTriggered?true:void 0,fail_on_empty_test_run_triggered:params.failOnEmptyTestRunTriggered?true:void 0,warnings:params.accumulation.trackingWarnings.length>0?params.accumulation.trackingWarnings:void 0,results:params.accumulation.results}};const buildTestAllSelectionProgress=params=>[`selection items=${params.filteredItems.length}`,`linked_tests=${params.linkedTests}`,params.statusFilter===void 0?"":`status=${params.statusFilter}`,params.limitFilter===void 0?"":`limit=${params.limitFilter}`,params.offsetFilter>0?`offset=${params.offsetFilter}`:""].filter(entry=>entry.length>0).join(" ");const prepareTestAllRun=async(options,global2)=>{const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const selection=await selectTestAllItems({pmRoot,settings,options});const defaultTimeoutSeconds=parseTimeout(options.timeout);const runStartedAt=nowIso();const collected=await collectTestAllItemTests(selection.filteredItems,global2,pmRoot);emitTestAllProgress(options,buildTestAllSelectionProgress({...selection,linkedTests:collected.linkedTests}));return{pmRoot,settings,filteredItems:selection.filteredItems,itemTests:collected.itemTests,linkedTests:collected.linkedTests,defaultTimeoutSeconds,runStartedAt}};const resolveTestAllOutcome=params=>{const failOnSkippedTriggered=params.options.failOnSkipped===true&&params.accumulation.skipped>0;const ok=![params.accumulation.failed>0,failOnSkippedTriggered,params.failOnEmptyTestRunTriggered].includes(true);return{failOnSkippedTriggered,ok}};const runTestAll=async(options,global2)=>{const prepared=await prepareTestAllRun(options,global2);const{accumulation,failOnEmptyTestRunTriggered}=initializeTestAllAccumulation(options,prepared.linkedTests,prepared.filteredItems);const itemRunContext=buildTestAllItemRunContext({pmRoot:prepared.pmRoot,settings:prepared.settings,options,itemTests:prepared.itemTests,defaultTimeoutSeconds:prepared.defaultTimeoutSeconds,runStartedAt:prepared.runStartedAt});await runTestAllItems(prepared.itemTests,itemRunContext,accumulation);appendContextPreflightWarning(options,accumulation);const outcome=resolveTestAllOutcome({options,accumulation,failOnEmptyTestRunTriggered});emitTestAllProgress(options,`end status=${outcome.ok?"passed":"failed"} items=${prepared.filteredItems.length} linked_tests=${prepared.linkedTests} passed=${accumulation.passed} failed=${accumulation.failed} skipped=${accumulation.skipped}`);return buildTestAllResult({ok:outcome.ok,filteredItems:prepared.filteredItems,linkedTests:prepared.linkedTests,accumulation,failOnSkippedTriggered:outcome.failOnSkippedTriggered,failOnEmptyTestRunTriggered})};const _testOnlyTestAll={buildLinkedTestKey,formatTrackingError};export{_testOnlyTestAll,runTestAll};
+(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]="8371273e-fb3c-5615-bd0e-f7aeb2a0b303")}catch{}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{parseOptionalNumber}from"../../core/item/parse.js";import{normalizeStatusInput}from"../../core/item/status.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{nowIso}from"../../core/shared/time.js";import{listAllItemMetadataLight}from"../../core/store/item-store.js";import{resolveGlobalPmRoot,resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{appendTrackedTestRunSummary}from"../../core/test/item-test-run-tracking.js";import{resolveAuthor}from"../../core/shared/author.js";import{countFailureCategories,runLinkedTests,runTest,summarizeContextPreflight}from"./execution.js";const parseStatus=(raw,statusRegistry)=>{if(raw===void 0)return;const normalized=normalizeStatusInput(raw,statusRegistry);if(!normalized){const allowedStatuses=statusRegistry.definitions.map(definition=>definition.id);throw new PmCliError(`Invalid --status value "${raw}". Allowed: ${allowedStatuses.join(", ")}`,EXIT_CODE.USAGE)}return normalized},parseTimeout=raw=>{if(raw===void 0)return;const parsed=parseOptionalNumber(raw,"timeout");if(parsed<=0)throw new PmCliError("timeout must be a positive number",EXIT_CODE.USAGE);return parsed},parseNonNegativeInteger=(raw,flag)=>{if(raw===void 0)return;const parsed=Number(raw);if(!Number.isInteger(parsed)||parsed<0)throw new PmCliError(`${flag} must be a non-negative integer`,EXIT_CODE.USAGE);return parsed},formatTrackingError=error=>error instanceof Error?error.message:String(error),resolveTrackedRunId=()=>{const fromEnv=process.env.PM_BACKGROUND_TEST_RUN_ID?.trim();return fromEnv&&fromEnv.length>0?fromEnv:`test-all-local-${Date.now().toString(36)}-${Math.random().toString(36).slice(2,8)}`},normalizeCommand=command=>command.trim().replaceAll(/\s+/g," "),normalizeEnvSetSignature=value=>!value||Object.keys(value).length===0?"{}":JSON.stringify(Object.fromEntries(Object.entries(value).sort(([left],[right])=>left.localeCompare(right)))),normalizeEnvClearSignature=value=>!value||value.length===0?"[]":JSON.stringify([...value].sort((left,right)=>left.localeCompare(right))),normalizePmContextModeSignature=value=>{const normalized=value?.trim().toLowerCase();return normalized&&normalized.length>0?normalized:"none"},normalizeWorkspaceContextModeSignature=value=>{const normalized=value?.trim().toLowerCase();return normalized&&normalized.length>0?normalized:"source"},normalizeAssertionStrings=values=>[...new Set(values??[])].sort((left,right)=>left.localeCompare(right)),normalizeAssertionMap=value=>Object.fromEntries(Object.entries(value??{}).sort(([left],[right])=>left.localeCompare(right))),normalizeAssertionLineCount=value=>typeof value=="number"?value:void 0,normalizeAssertionSignature=test=>{const normalized={assert_stdout_contains:normalizeAssertionStrings(test.assert_stdout_contains),assert_stdout_regex:normalizeAssertionStrings(test.assert_stdout_regex),assert_stderr_contains:normalizeAssertionStrings(test.assert_stderr_contains),assert_stderr_regex:normalizeAssertionStrings(test.assert_stderr_regex),assert_stdout_min_lines:normalizeAssertionLineCount(test.assert_stdout_min_lines),assert_json_field_equals:normalizeAssertionMap(test.assert_json_field_equals),assert_json_field_gte:normalizeAssertionMap(test.assert_json_field_gte)};return JSON.stringify(normalized)},resolveLinkedTestTargetSignature=test=>{const command=resolveOptionalEnvironmentValue(test.command);return command!==void 0?`command:${test.scope}:${normalizeCommand(command)}`:`path:${test.scope}:${resolveOptionalEnvironmentValue(test.path)??""}`},buildLinkedTestKey=test=>{const envSet=normalizeEnvSetSignature(test.env_set),envClear=normalizeEnvClearSignature(test.env_clear),pmContextMode=normalizePmContextModeSignature(test.pm_context_mode),workspaceContextMode=normalizeWorkspaceContextModeSignature(test.workspace_context_mode),sharedHostSafe=test.shared_host_safe===!0?"true":"false",assertions=normalizeAssertionSignature(test);return`${resolveLinkedTestTargetSignature(test)}:${envSet}:${envClear}:${pmContextMode}:${workspaceContextMode}:${sharedHostSafe}:${assertions}`},maxTimeoutSeconds=(current,candidate)=>candidate===void 0?current:current===void 0||candidate>current?candidate:current,countStatuses=runResults=>{let passed=0,failed=0,skipped=0;for(const result of runResults){if(result.status==="passed"){passed+=1;continue}if(result.status==="failed"){failed+=1;continue}skipped+=1}return{passed,failed,skipped}},mergeFailureCategoryCounts=(target,source)=>{for(const[key,value]of Object.entries(source))target[key]+=value},emitTestAllProgress=(options,message)=>{if(options.progress===!0)try{process.stderr.write(`[pm test-all] ${message}
+`)}catch{}},collectTestAllItemTests=async(filteredItems,global2,pmRoot)=>{const itemTests=[];let linkedTests=0;for(const item of filteredItems){const readResult=await runTest(item.id,{run:!1},{...global2,path:pmRoot});linkedTests+=readResult.tests.length,itemTests.push({item,tests:readResult.tests})}return{itemTests,linkedTests}},selectTestAllItems=async params=>{const statusRegistry=resolveRuntimeStatusRegistry(params.settings.schema),typeRegistry=resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations()),statusFilter=parseStatus(params.options.status,statusRegistry),limitFilter=parseNonNegativeInteger(params.options.limit,"--limit"),offsetFilter=parseNonNegativeInteger(params.options.offset,"--offset")??0,statusFilteredItems=(await listAllItemMetadataLight(params.pmRoot,params.settings.item_format,typeRegistry.type_to_folder,void 0,params.settings.schema)).filter(item=>statusFilter?item.status===statusFilter:!0).sort((a,b)=>a.id.localeCompare(b.id));return{filteredItems:limitFilter===void 0?statusFilteredItems.slice(offsetFilter):statusFilteredItems.slice(offsetFilter,offsetFilter+limitFilter),statusFilter,limitFilter,offsetFilter}},buildEffectiveTimeoutByKey=itemTests=>{const effectiveTimeoutByKey=new Map;for(const{tests}of itemTests)for(const test of tests){const key=buildLinkedTestKey(test);if(!effectiveTimeoutByKey.has(key)){effectiveTimeoutByKey.set(key,test.timeout_seconds);continue}effectiveTimeoutByKey.set(key,maxTimeoutSeconds(effectiveTimeoutByKey.get(key),test.timeout_seconds))}return effectiveTimeoutByKey},runTestAllItem=async(entry,context)=>{const testsToRun=[],keyedTests=entry.tests.map(test=>{const key=buildLinkedTestKey(test),duplicate=context.seenTestKeys.has(key);if(!duplicate){context.seenTestKeys.add(key);const effectiveTimeoutSeconds=context.effectiveTimeoutByKey.get(key);testsToRun.push(effectiveTimeoutSeconds===void 0?test:{...test,timeout_seconds:effectiveTimeoutSeconds})}return{test,key,duplicate}}),executedResults=testsToRun.length>0?await runLinkedTests(testsToRun,context.defaultTimeoutSeconds,{progress:context.options.progress,sourceRoots:context.sourceRoots,envSet:context.options.envSet,envClear:context.options.envClear,sharedHostSafe:context.options.sharedHostSafe,pmContext:context.options.pmContext,overrideLinkedPmContext:context.options.overrideLinkedPmContext,failOnContextMismatch:context.options.failOnContextMismatch,failOnEmptyTestRun:context.options.failOnEmptyTestRun,requireAssertionsForPm:context.options.requireAssertionsForPm,checkContext:context.options.checkContext,autoPmContext:context.options.autoPmContext,workspaceContext:context.options.workspaceContext,overrideLinkedWorkspaceContext:context.options.overrideLinkedWorkspaceContext,pmRoot:context.pmRoot,allowUntrustedLinkedTests:context.options.allowUntrustedLinkedTests,untrustedLinkedTestsPolicyEnabled:context.settings.testing.allow_untrusted_linked_tests}):[];let executedIndex=0;const runResults=keyedTests.map(({test,key,duplicate})=>{if(!duplicate){const executed=executedResults[executedIndex];return executedIndex+=1,executed}return{command:test.command,path:test.path,status:"skipped",error:`Duplicate linked test skipped (key=${key}).`}}),summary=countStatuses(runResults),failureCategories=countFailureCategories(runResults),trackingWarnings=await appendTestAllItemTracking(entry,summary,runResults,context);return{passed:summary.passed,failed:summary.failed,skipped:summary.skipped,trackingWarnings,failureCategories,result:{ok:summary.failed===0&&!(context.options.failOnSkipped===!0&&summary.skipped>0),id:entry.item.id,status:entry.item.status,test_count:entry.tests.length,passed:summary.passed,failed:summary.failed,skipped:summary.skipped,run_results:runResults,failure_categories:failureCategories}}},trackedRunFailed=(summary,options)=>[summary.failed>0,options.failOnSkipped===!0&&summary.skipped>0].includes(!0),optionalTrue=value=>value?!0:void 0,appendTestAllItemTracking=async(entry,summary,runResults,context)=>{if(!context.trackingEnabled)return[];try{const failed=trackedRunFailed(summary,context.options);await appendTrackedTestRunSummary({pmRoot:context.pmRoot,settings:context.settings,itemId:entry.item.id,author:context.trackingAuthor,message:`Track test-all run summary (${context.trackingRunId})`,entry:{run_id:context.trackingRunId,kind:"test-all",status:failed?"failed":"passed",started_at:context.runStartedAt,finished_at:nowIso(),recorded_at:nowIso(),attempt:context.trackingAttempt,resumed_from:context.trackingResumedFrom,passed:summary.passed,failed:summary.failed,skipped:summary.skipped,items:1,linked_tests:entry.tests.length,fail_on_skipped_triggered:optionalTrue(context.options.failOnSkipped===!0&&summary.skipped>0),executions:runResults.filter(result=>result.command?.trim()).slice(0,32).map(result=>({command:result.command.trim(),requested_pm_context_mode:result.execution_context?.requested_pm_context_mode,pm_context_mode:result.execution_context?.pm_context_mode,workspace_context_mode:result.execution_context?.workspace_context_mode,trust_reason:result.execution_context?.trust.reason}))}})}catch(error){return[`test_result_tracking_failed:${entry.item.id}:${formatTrackingError(error)}`]}return[]},resolveTrackingAttempt=()=>{const raw=process.env.PM_BACKGROUND_TEST_RUN_ATTEMPT?.trim(),parsed=raw?Number.parseInt(raw,10):Number.NaN;return Number.isFinite(parsed)&&parsed>=1?parsed:void 0},resolveOptionalEnvironmentValue=value=>{const trimmed=value?.trim();return trimmed&&trimmed.length>0?trimmed:void 0},buildTestAllItemRunContext=params=>({pmRoot:params.pmRoot,settings:params.settings,options:params.options,defaultTimeoutSeconds:params.defaultTimeoutSeconds,sourceRoots:{projectPmRoot:params.pmRoot,globalPmRoot:resolveGlobalPmRoot(process.cwd())},seenTestKeys:new Set,effectiveTimeoutByKey:buildEffectiveTimeoutByKey(params.itemTests),trackingEnabled:params.settings.testing.record_results_to_items===!0,trackingAuthor:resolveAuthor(params.options.author,params.settings.author_default),trackingRunId:resolveTrackedRunId(),trackingAttempt:resolveTrackingAttempt(),trackingResumedFrom:resolveOptionalEnvironmentValue(process.env.PM_BACKGROUND_TEST_RUN_RESUMED_FROM),runStartedAt:params.runStartedAt}),initializeTestAllAccumulation=(options,linkedTests,filteredItems)=>{const accumulation={results:[],passed:0,failed:0,skipped:0,failureCategories:countFailureCategories([]),trackingWarnings:[]},failOnEmptyTestRunTriggered=options.failOnEmptyTestRun===!0&&linkedTests===0;return failOnEmptyTestRunTriggered&&(accumulation.failed+=1,accumulation.failureCategories.empty_run+=1,accumulation.trackingWarnings.push(`empty_linked_test_selection:items=${filteredItems.length};linked_tests=0;fail_on_empty_test_run=true`)),{accumulation,failOnEmptyTestRunTriggered}},runTestAllItems=async(itemTests,context,accumulation)=>{for(const[itemIndex,entry]of itemTests.entries()){emitTestAllProgress(context.options,`item ${itemIndex+1}/${itemTests.length} start id=${entry.item.id} linked_tests=${entry.tests.length}`);const execution=await runTestAllItem(entry,context);mergeFailureCategoryCounts(accumulation.failureCategories,execution.failureCategories),accumulation.passed+=execution.passed,accumulation.failed+=execution.failed,accumulation.skipped+=execution.skipped,accumulation.trackingWarnings.push(...execution.trackingWarnings),accumulation.results.push(execution.result),emitTestAllProgress(context.options,`item ${itemIndex+1}/${itemTests.length} end id=${entry.item.id} status=${execution.failed===0?"passed":"failed"} passed=${execution.passed} failed=${execution.failed} skipped=${execution.skipped}`)}},appendContextPreflightWarning=(options,accumulation)=>{if(options.checkContext!==!0)return;const allRunResults=accumulation.results.flatMap(entry=>entry.run_results),preflight=summarizeContextPreflight(allRunResults);accumulation.trackingWarnings.push(`context_preflight:checked_pm_commands=${preflight.checked_pm_commands};tracker_read_commands=${preflight.tracker_read_commands};mismatches=${preflight.mismatches};auto_remediated=${preflight.auto_remediated}`)},buildTestAllResult=params=>({ok:params.ok,totals:{items:params.filteredItems.length,linked_tests:params.linkedTests,passed:params.accumulation.passed,failed:params.accumulation.failed,skipped:params.accumulation.skipped,failure_categories:params.accumulation.failureCategories},failed:params.accumulation.failed,passed:params.accumulation.passed,skipped:params.accumulation.skipped,fail_on_skipped_triggered:params.failOnSkippedTriggered?!0:void 0,fail_on_empty_test_run_triggered:params.failOnEmptyTestRunTriggered?!0:void 0,warnings:params.accumulation.trackingWarnings.length>0?params.accumulation.trackingWarnings:void 0,results:params.accumulation.results}),buildTestAllSelectionProgress=params=>[`selection items=${params.filteredItems.length}`,`linked_tests=${params.linkedTests}`,params.statusFilter===void 0?"":`status=${params.statusFilter}`,params.limitFilter===void 0?"":`limit=${params.limitFilter}`,params.offsetFilter>0?`offset=${params.offsetFilter}`:""].filter(entry=>entry.length>0).join(" "),prepareTestAllRun=async(options,global2)=>{const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot),selection=await selectTestAllItems({pmRoot,settings,options}),defaultTimeoutSeconds=parseTimeout(options.timeout),runStartedAt=nowIso(),collected=await collectTestAllItemTests(selection.filteredItems,global2,pmRoot);return emitTestAllProgress(options,buildTestAllSelectionProgress({...selection,linkedTests:collected.linkedTests})),{pmRoot,settings,filteredItems:selection.filteredItems,itemTests:collected.itemTests,linkedTests:collected.linkedTests,defaultTimeoutSeconds,runStartedAt}},resolveTestAllOutcome=params=>{const failOnSkippedTriggered=params.options.failOnSkipped===!0&&params.accumulation.skipped>0,ok=![params.accumulation.failed>0,failOnSkippedTriggered,params.failOnEmptyTestRunTriggered].includes(!0);return{failOnSkippedTriggered,ok}},runTestAll=async(options,global2)=>{const prepared=await prepareTestAllRun(options,global2),{accumulation,failOnEmptyTestRunTriggered}=initializeTestAllAccumulation(options,prepared.linkedTests,prepared.filteredItems),itemRunContext=buildTestAllItemRunContext({pmRoot:prepared.pmRoot,settings:prepared.settings,options,itemTests:prepared.itemTests,defaultTimeoutSeconds:prepared.defaultTimeoutSeconds,runStartedAt:prepared.runStartedAt});await runTestAllItems(prepared.itemTests,itemRunContext,accumulation),appendContextPreflightWarning(options,accumulation);const outcome=resolveTestAllOutcome({options,accumulation,failOnEmptyTestRunTriggered});return emitTestAllProgress(options,`end status=${outcome.ok?"passed":"failed"} items=${prepared.filteredItems.length} linked_tests=${prepared.linkedTests} passed=${accumulation.passed} failed=${accumulation.failed} skipped=${accumulation.skipped}`),buildTestAllResult({ok:outcome.ok,filteredItems:prepared.filteredItems,linkedTests:prepared.linkedTests,accumulation,failOnSkippedTriggered:outcome.failOnSkippedTriggered,failOnEmptyTestRunTriggered})},_testOnlyTestAll={buildLinkedTestKey,formatTrackingError};export{_testOnlyTestAll,runTestAll};
 //# sourceMappingURL=batch.js.map

package/dist/sdk/test/entry.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]="70971b2a-c025-50a8-918f-871fc8adfd2a")}catch(e2){}})();import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{looksLikeStructuredKeyValueEntry}from"../../core/item/parse.js";const STRUCTURED_LINKED_TEST_KEYS=["command","cmd","path","scope","timeout","timeout_seconds","pm_context_mode","workspace_context_mode","env_set","env_clear","shared_host_safe","assert_stdout_contains","assert_stdout_regex","assert_stderr_contains","assert_stderr_regex","assert_stdout_min_lines","assert_json_field_equals","assert_json_field_gte","note"];const STRUCTURED_LINKED_TEST_KEY_SET=new Set(STRUCTURED_LINKED_TEST_KEYS);function looksLikeStructuredLinkedTestEntry(raw){return looksLikeStructuredKeyValueEntry(raw,STRUCTURED_LINKED_TEST_KEYS)}function normalizeStructuredLinkedTestEntry(kv,optionName){const normalizedKv={};const unknownKeys=[];for(const[key,value]of Object.entries(kv)){const normalizedKey=key.toLowerCase();if(!STRUCTURED_LINKED_TEST_KEY_SET.has(normalizedKey)){unknownKeys.push(key);continue}if(Object.hasOwn(normalizedKv,normalizedKey)){throw new PmCliError(`${optionName} provides key "${key}" more than once after case normalization`,EXIT_CODE.USAGE)}normalizedKv[normalizedKey]=value}if(unknownKeys.length>0){throw new PmCliError(`${optionName} does not recognize key${unknownKeys.length>1?"s":""} ${unknownKeys.map(key=>`"${key}"`).join(", ")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(", ")}.`,EXIT_CODE.USAGE)}if(normalizedKv.cmd!==void 0){if(normalizedKv.command!==void 0&&normalizedKv.command.trim()!==normalizedKv.cmd.trim()){throw new PmCliError(`${optionName} command and cmd must match when both are provided`,EXIT_CODE.USAGE)}const{cmd,...rest}=normalizedKv;return{...rest,command:rest.command??cmd}}return normalizedKv}export{STRUCTURED_LINKED_TEST_KEYS,looksLikeStructuredLinkedTestEntry,normalizeStructuredLinkedTestEntry};
+(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]="b968be78-8489-5735-8f95-8e38a36e160a")}catch{}})();import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{looksLikeStructuredKeyValueEntry}from"../../core/item/parse.js";const STRUCTURED_LINKED_TEST_KEYS=["command","cmd","path","scope","timeout","timeout_seconds","pm_context_mode","workspace_context_mode","env_set","env_clear","shared_host_safe","assert_stdout_contains","assert_stdout_regex","assert_stderr_contains","assert_stderr_regex","assert_stdout_min_lines","assert_json_field_equals","assert_json_field_gte","note"],STRUCTURED_LINKED_TEST_KEY_SET=new Set(STRUCTURED_LINKED_TEST_KEYS);function looksLikeStructuredLinkedTestEntry(raw){return looksLikeStructuredKeyValueEntry(raw,STRUCTURED_LINKED_TEST_KEYS)}function normalizeStructuredLinkedTestEntry(kv,optionName){const normalizedKv={},unknownKeys=[];for(const[key,value]of Object.entries(kv)){const normalizedKey=key.toLowerCase();if(!STRUCTURED_LINKED_TEST_KEY_SET.has(normalizedKey)){unknownKeys.push(key);continue}if(Object.hasOwn(normalizedKv,normalizedKey))throw new PmCliError(`${optionName} provides key "${key}" more than once after case normalization`,EXIT_CODE.USAGE);normalizedKv[normalizedKey]=value}if(unknownKeys.length>0)throw new PmCliError(`${optionName} does not recognize key${unknownKeys.length>1?"s":""} ${unknownKeys.map(key=>`"${key}"`).join(", ")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(", ")}.`,EXIT_CODE.USAGE);if(normalizedKv.cmd!==void 0){if(normalizedKv.command!==void 0&&normalizedKv.command.trim()!==normalizedKv.cmd.trim())throw new PmCliError(`${optionName} command and cmd must match when both are provided`,EXIT_CODE.USAGE);const{cmd,...rest}=normalizedKv;return{...rest,command:rest.command??cmd}}return normalizedKv}export{STRUCTURED_LINKED_TEST_KEYS,looksLikeStructuredLinkedTestEntry,normalizeStructuredLinkedTestEntry};
 //# sourceMappingURL=entry.js.map