@unbrained/pm-cli 2026.10.20 → 2026.10.21

package/dist/sdk/governance/assurance.js

@@ -1,4 +1,4 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="416aaf09-e4f6-5d10-aee0-eba374f1cd83")}catch{}})();import{createHash}from"node:crypto";import path from"node:path";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{appendWorkspaceAuditEvent,mutateWorkspaceJsonWithHistory,readFileIfExists,readHistoryEntries,readSettings,resolveAuthor,stableStringify,WORKSPACE_HISTORY_ID,getWorkspaceHistoryPath}from"../runtime-primitives.js";import{resolveCanonicalRelationshipKind}from"../relationships.js";import{MAX_ASSURANCE_VERDICT_LIMIT}from"./assurance-limits.js";import{AssuranceEvaluationRefusalError,AssuranceMutationRefusalError,AssuranceSourceResolutionError}from"./assurance-mutation-error.js";const ASSURANCE_DOCUMENT_VERSION=1,ASSURANCE_GATE_TRIGGERS=["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"],ASSURANCE_MEASUREMENT_SOURCE_KINDS=["items","dependency_kind","prose_edge_gap","graph","validate","health","history","links","provider","derived"],POLARITY_KEYS=["ceiling","floor","equals","zero","monotone_nondecreasing","monotone_nonincreasing","subset_of"],ID_PATTERN=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/,LOCK_TTL_SECONDS=30,LOCK_WAIT_MS=5e3,EVALUATION_CONCURRENCY=4,DEFAULT_VERDICT_LIMIT=50;function requireStableId(value,field){if(!ID_PATTERN.test(value))throw new AssuranceMutationRefusalError(`${field} must be a stable lowercase id`)}function requireFiniteNonNegative(value,field){if(!Number.isFinite(value)||value<0)throw new AssuranceMutationRefusalError(`${field} must be a finite non-negative number`)}function boundFor(assertion){const present=POLARITY_KEYS.filter(key=>assertion[key]!==void 0);if(present.length!==1)throw new AssuranceMutationRefusalError(`assertion ${assertion.id} must declare exactly one polarity`);const polarity=present[0],raw=assertion[polarity];return{polarity,value:polarity==="zero"?0:raw}}function valuesEqual(left,right){return stableStringify(left)===stableStringify(right)}function compareBound(observed,bound){if(bound.polarity==="equals")return valuesEqual(observed,bound.value);if(bound.polarity==="subset_of"){if(!Array.isArray(observed)||!Array.isArray(bound.value))return!1;const allowed=bound.value;return observed.every(entry=>allowed.includes(entry))}if(typeof observed!="number")return!1;const numericBound=bound.value;return bound.polarity==="ceiling"||bound.polarity==="monotone_nonincreasing"?observed<=numericBound:bound.polarity==="floor"||bound.polarity==="monotone_nondecreasing"?observed>=numericBound:observed===0}function proveNegativeControl(assertion){const bound=boundFor(assertion),cases=assertion.negative_control.cases;return cases.some(entry=>entry.expected==="pass")&&cases.some(entry=>entry.expected==="fail")&&cases.every(entry=>compareBound(entry.observed,bound)===(entry.expected==="pass"))}function boundUpdateIsLoosening(beforeBound,afterBound){if(beforeBound.polarity!==afterBound.polarity)return!0;if(typeof beforeBound.value=="number"&&typeof afterBound.value=="number")return beforeBound.polarity==="ceiling"||beforeBound.polarity==="monotone_nonincreasing"?afterBound.value>beforeBound.value:beforeBound.polarity==="floor"||beforeBound.polarity==="monotone_nondecreasing"?afterBound.value<beforeBound.value:afterBound.value!==beforeBound.value;if(beforeBound.polarity==="subset_of"){const beforeValues=beforeBound.value,afterValues=afterBound.value;return!Array.isArray(beforeValues)||!Array.isArray(afterValues)||afterValues.some(entry=>!beforeValues.includes(entry))}return!valuesEqual(beforeBound.value,afterBound.value)}function assuranceAssertionUpdateIsLoosening(before,after){if(before.measurement_id!==after.measurement_id||before.owner_item_id!==after.owner_item_id||stableStringify(before.scope)!==stableStringify(after.scope))return!0;const enforcementRank={observe:0,warn:1,block:2},lifetimeLoosened=(before.lifetime??"hold")==="hold"&&(after.lifetime??"hold")==="retire";return boundUpdateIsLoosening(boundFor(before),boundFor(after))||enforcementRank[after.enforcement]<enforcementRank[before.enforcement]||lifetimeLoosened}function validateItemsMeasurementSource(source){if(source.state!==void 0&&!(source.state==="present"||source.state==="missing"))throw new AssuranceMutationRefusalError("items source state must be present or missing");const hasEquals=Object.hasOwn(source,"equals"),hasState=source.state!==void 0,predicateCount=Number(hasEquals)+Number(hasState);if(source.field!==void 0&&predicateCount!==1)throw new AssuranceMutationRefusalError("items source with field requires exactly one of equals or state");if(source.field===void 0&&predicateCount!==0)throw new AssuranceMutationRefusalError("items source equals/state requires field")}function validateDependencyKindMeasurementSource(source){if(typeof source.dependency_kind!="string"||source.dependency_kind.trim().length===0)throw new AssuranceMutationRefusalError("dependency_kind source requires dependency_kind");if([source.source_kind,source.source_kind_prefix,source.source_kind_state].filter(value=>value!==void 0).length>1)throw new AssuranceMutationRefusalError("dependency_kind source accepts at most one source_kind predicate");if(source.source_kind!==void 0&&source.source_kind.trim().length===0||source.source_kind_prefix!==void 0&&source.source_kind_prefix.trim().length===0)throw new AssuranceMutationRefusalError("dependency_kind source provenance values must not be empty");if(source.source_kind_state!==void 0&&source.source_kind_state!=="present"&&source.source_kind_state!=="missing")throw new AssuranceMutationRefusalError("dependency_kind source source_kind_state must be present or missing")}function validateProseEdgeGapSource(source){if(source.sample_limit!==void 0&&(!Number.isInteger(source.sample_limit)||source.sample_limit<1))throw new AssuranceMutationRefusalError("prose_edge_gap sample_limit must be a positive integer");for(const exemption of source.exemptions??[]){if(typeof exemption.holder_id!="string"||exemption.holder_id.trim().length===0||typeof exemption.reason!="string"||exemption.reason.trim().length===0)throw new AssuranceMutationRefusalError("prose_edge_gap exemptions require holder_id and reason");if(exemption.target_id!==void 0&&exemption.target_id.trim().length===0||exemption.text_contains!==void 0&&exemption.text_contains.trim().length===0)throw new AssuranceMutationRefusalError("prose_edge_gap exemption selectors must not be empty")}}function validateMeasurementDefinition(definition){requireStableId(definition.id,"measurement.id"),definition.max_cost!==void 0&&requireFiniteNonNegative(definition.max_cost,"measurement.max_cost");const candidateSource=definition.source;if(Object.prototype.toString.call(candidateSource)!=="[object Object]")throw new AssuranceMutationRefusalError(`measurement.source.kind must be one of ${ASSURANCE_MEASUREMENT_SOURCE_KINDS.join(", ")}`);const sourceKind=Reflect.get(candidateSource,"kind");if(!ASSURANCE_MEASUREMENT_SOURCE_KINDS.includes(sourceKind))throw new AssuranceMutationRefusalError(`measurement.source.kind must be one of ${ASSURANCE_MEASUREMENT_SOURCE_KINDS.join(", ")}`);const source=candidateSource;if(source.kind==="items"&&validateItemsMeasurementSource(source),source.kind==="dependency_kind"&&validateDependencyKindMeasurementSource(source),source.kind==="prose_edge_gap"&&validateProseEdgeGapSource(source),(source.kind==="graph"||source.kind==="validate"||source.kind==="health")&&(typeof source.field!="string"||source.field.trim().length===0))throw new AssuranceMutationRefusalError(`${source.kind} source requires field`);return source.kind==="provider"&&(requireStableId(source.provider,"provider source provider"),requireStableId(source.key,"provider source key")),definition}function validateAssertionDefinition(definition){if(requireStableId(definition.id,"assertion.id"),requireStableId(definition.measurement_id,"assertion.measurement_id"),typeof definition.owner_item_id!="string"||definition.owner_item_id.trim().length===0)throw new AssuranceMutationRefusalError("assertion.owner_item_id is required");const bound=boundFor(definition);if(typeof bound.value=="number"&&!Number.isFinite(bound.value))throw new AssuranceMutationRefusalError(`assertion.${bound.polarity} must be a finite number`);if(definition.lifetime==="retire"&&(typeof definition.retire_reason!="string"||definition.retire_reason.trim().length===0))throw new AssuranceMutationRefusalError("retired assertion requires retire_reason");definition.scope.kind==="filter"&&requireStableId(definition.scope.measurement_id,"assertion.scope.measurement_id");const cases=definition.negative_control?.cases;if(!Array.isArray(cases)||!cases.some(entry=>entry.expected==="pass")||!cases.some(entry=>entry.expected==="fail"))throw new AssuranceMutationRefusalError("assertion negative control requires pass and fail cases");if(!proveNegativeControl(definition))throw new AssuranceMutationRefusalError(`assertion ${definition.id} negative control does not prove its bound`);return definition}function validateGateProviderPolicy(policy){if(!Array.isArray(policy.allowed_providers))throw new AssuranceMutationRefusalError("gate provider_policy.allowed_providers must be an array");for(const provider of policy.allowed_providers)requireStableId(provider,"gate.provider_policy.allowed_provider");if(typeof policy.triggers!="object"||policy.triggers===null||Array.isArray(policy.triggers))throw new AssuranceMutationRefusalError("gate provider_policy.triggers must be an object");for(const[trigger,rule]of Object.entries(policy.triggers)){if(!ASSURANCE_GATE_TRIGGERS.includes(trigger))throw new AssuranceMutationRefusalError(`gate provider policy has unknown trigger ${trigger}`);if(typeof rule!="object"||rule===null||!["low","medium","high"].includes(rule.max_cost_class)||typeof rule.allow_network!="boolean")throw new AssuranceMutationRefusalError(`gate provider policy trigger ${trigger} is invalid`)}}function validateGateDefinition(definition){if(requireStableId(definition.id,"gate.id"),!Array.isArray(definition.assertion_ids))throw new AssuranceMutationRefusalError("gate.assertion_ids is required and must be an array");if(definition.assertion_ids.length===0)throw new AssuranceMutationRefusalError("gate requires at least one assertion");for(const id of definition.assertion_ids)requireStableId(id,"gate.assertion_id");if(!Array.isArray(definition.triggers))throw new AssuranceMutationRefusalError(`gate.triggers is required and must be an array of ${ASSURANCE_GATE_TRIGGERS.join(", ")}`);if(definition.triggers.length===0)throw new AssuranceMutationRefusalError("gate requires at least one trigger");for(const trigger of definition.triggers)if(!ASSURANCE_GATE_TRIGGERS.includes(trigger))throw new AssuranceMutationRefusalError(`gate trigger must be one of ${ASSURANCE_GATE_TRIGGERS.join(", ")}`);return definition.provider_policy&&validateGateProviderPolicy(definition.provider_policy),definition}function validateAssuranceDocument(document){if(document.version!==ASSURANCE_DOCUMENT_VERSION)throw new AssuranceMutationRefusalError(`unsupported assurance document version ${String(document.version)}`);const ids=new Set;for(const definition of document.measurements){if(validateMeasurementDefinition(definition),ids.has(`measurement:${definition.id}`))throw new AssuranceMutationRefusalError(`duplicate measurement ${definition.id}`);ids.add(`measurement:${definition.id}`)}for(const definition of document.assertions){if(validateAssertionDefinition(definition),ids.has(`assertion:${definition.id}`))throw new AssuranceMutationRefusalError(`duplicate assertion ${definition.id}`);ids.add(`assertion:${definition.id}`)}for(const definition of document.gates){validateGateDefinition(definition);const missing=definition.assertion_ids.filter(id=>!document.assertions.some(assertionDefinition=>assertionDefinition.id===id));if(missing.length>0)throw new AssuranceMutationRefusalError(`gate ${definition.id} references missing assertions: ${missing.join(", ")}`);if(ids.has(`gate:${definition.id}`))throw new AssuranceMutationRefusalError(`duplicate gate ${definition.id}`);ids.add(`gate:${definition.id}`)}const measurementIds=new Set(document.measurements.map(entry=>entry.id));for(const[measurementId,consumers]of collectMeasurementReferences(document))if(!measurementIds.has(measurementId))throw new AssuranceMutationRefusalError(`${consumers.join(", ")} references missing measurement ${measurementId}`);return document}function collectExpressionMeasurementReferences(expression,references){if("measurement"in expression){references.push(expression.measurement);return}if("operator"in expression)for(const operand of expression.operands)collectExpressionMeasurementReferences(operand,references)}function collectMeasurementReferences(document){const references=new Map,add=(measurementId,consumer)=>{const consumers=references.get(measurementId)??[];consumers.push(consumer),references.set(measurementId,consumers)};for(const assertionDefinition of document.assertions)add(assertionDefinition.measurement_id,`assertion ${assertionDefinition.id}`),assertionDefinition.scope.kind==="filter"&&add(assertionDefinition.scope.measurement_id,`assertion ${assertionDefinition.id} scope`);for(const measurementDefinition of document.measurements){if(measurementDefinition.source.kind!=="derived")continue;const derivedReferences=[];collectExpressionMeasurementReferences(measurementDefinition.source.expression,derivedReferences);for(const measurementId of derivedReferences)add(measurementId,`derived measurement ${measurementDefinition.id}`)}return references}function collectGateProviderIds(gate,document){const pending=gate.assertion_ids.flatMap(assertionId=>{const assertion=document.assertions.find(entry=>entry.id===assertionId);return[assertion.measurement_id,...assertion.scope.kind==="filter"?[assertion.scope.measurement_id]:[]]}),visited=new Set,providers=new Set;for(;pending.length>0;){const measurementId=pending.pop();if(visited.has(measurementId))continue;visited.add(measurementId);const measurement=document.measurements.find(entry=>entry.id===measurementId);measurement.source.kind==="provider"?providers.add(measurement.source.provider):measurement.source.kind==="derived"&&collectExpressionMeasurementReferences(measurement.source.expression,pending)}return providers}function createEmptyAssuranceDocument(){return{version:ASSURANCE_DOCUMENT_VERSION,measurements:[],assertions:[],gates:[]}}function itemsSourceResult(source,context){const matches=context.items.filter(item=>(source.statuses===void 0||source.statuses.includes(item.status))&&(source.types===void 0||source.types.includes(item.type))&&(source.tags===void 0||source.tags.every(tag=>item.tags?.includes(tag)))&&(source.field===void 0||(()=>{const value=item[source.field];if(source.state!==void 0){const missing=value==null||value===""||Array.isArray(value)&&value.length===0;return source.state==="missing"?missing:!missing}return valuesEqual(value,source.equals)})()));return{value:matches.length,population_size:context.items.length,cost:context.items.length,contributors:matches.map(item=>item.id)}}function dependencyProvenanceMatches(source,sourceKind){return source.source_kind!==void 0?sourceKind?.toLowerCase()===source.source_kind.trim().toLowerCase():source.source_kind_prefix!==void 0?sourceKind?.toLowerCase().startsWith(source.source_kind_prefix.trim().toLowerCase())===!0:source.source_kind_state==="present"?sourceKind!==void 0&&sourceKind.length>0:source.source_kind_state==="missing"?sourceKind===void 0||sourceKind.length===0:!0}function dependencyKindSourceResult(source,context){const contributors=[],requestedKind=resolveCanonicalRelationshipKind(source.dependency_kind)??source.dependency_kind.trim().toLowerCase();for(const item of context.items)for(const dependency of item.dependencies??[]){const dependencyKind=resolveCanonicalRelationshipKind(dependency.kind)??dependency.kind.trim().toLowerCase(),sourceKind=dependency.source_kind?.trim();dependencyKind===requestedKind&&dependencyProvenanceMatches(source,sourceKind)&&contributors.push(`${item.id}->${dependency.id}${sourceKind?`@${sourceKind}`:""}`)}return{value:contributors.length,population_size:context.items.length,cost:context.items.length,contributors}}function assuranceItemProseSegments(item){const segments=[item.description,item.body].filter(value=>typeof value=="string").map(value=>value.trim()).filter(Boolean);for(const key of["comments","notes","learnings"]){const entries=item[key];if(Array.isArray(entries)){for(const entry of entries)if(typeof entry=="string")segments.push(entry);else if(typeof entry=="object"&&entry!==null){const text=Reflect.get(entry,"text");typeof text=="string"&&segments.push(text)}}}return segments}function proseReferenceIsExempt(exemptions,holderId,targetId,segment){return exemptions.some(exemption=>exemption.holder_id.trim().toLowerCase()===holderId.toLowerCase()&&(exemption.target_id===void 0||exemption.target_id.trim().toLowerCase()===targetId.toLowerCase())&&(exemption.text_contains===void 0||segment.toLowerCase().includes(exemption.text_contains.trim().toLowerCase())))}function prosePairKey(left,right){return[left.toLowerCase(),right.toLowerCase()].sort().join("\0")}function collectProseEdgeCensusInputs(items){const canonicalIds=new Map,linkedPairs=new Set,proseMentions=[],mentionPattern=/(?<![\w-])[a-z0-9]+(?:-+[a-z0-9]+)+(?![\w-])/giu;let mentionCount=0;for(const item of items){canonicalIds.set(item.id.toLowerCase(),item.id);for(const dependency of item.dependencies??[])linkedPairs.add(prosePairKey(item.id,dependency.id));for(const scalar of[item.parent,item.blocked_by])typeof scalar=="string"&&linkedPairs.add(prosePairKey(item.id,scalar));for(const segment of assuranceItemProseSegments(item)){const mentionedIds=[...segment.matchAll(mentionPattern)].map(match=>match[0]);mentionCount+=mentionedIds.length,proseMentions.push({holder_id:item.id,segment,mentioned_ids:mentionedIds})}}return{canonical_ids:canonicalIds,linked_pairs:linkedPairs,prose_mentions:proseMentions,mention_count:mentionCount}}function proseEdgeGapSourceResult(source,context){const census=collectProseEdgeCensusInputs(context.items),gaps=new Map;for(const proseMention of census.prose_mentions){const mentions=proseMention.mentioned_ids.map(id=>census.canonical_ids.get(id.toLowerCase())).filter(id=>id!==void 0&&id!==proseMention.holder_id),distinctMentions=[...new Set(mentions)];for(const targetId of distinctMentions){const key=prosePairKey(proseMention.holder_id,targetId);if(census.linked_pairs.has(key)||proseReferenceIsExempt(source.exemptions??[],proseMention.holder_id,targetId,proseMention.segment))continue;const explicit=distinctMentions.some(candidate=>candidate!==targetId);gaps.get(key)?.explicit===!0&&!explicit||gaps.set(key,{contributor:`${proseMention.holder_id}->${targetId}|subject=${explicit?"explicit":"implicit"}`,explicit})}}const gapRows=[...gaps.values()],contributors=gapRows.map(entry=>entry.contributor).sort();return{value:contributors.length,population_size:census.canonical_ids.size,cost:context.items.length+census.linked_pairs.size+census.mention_count,contributors:contributors.slice(0,source.sample_limit??25),partitions:{explicit_subject:gapRows.filter(entry=>entry.explicit).length,implicit_subject:gapRows.filter(entry=>!entry.explicit).length}}}function historySourceResult(source,context){return{value:context.history.filter(entry=>(source.op===void 0||entry.op===source.op)&&(source.author===void 0||entry.author===source.author)&&(source.harness===void 0||entry.agent_harness===source.harness)&&(source.model===void 0||entry.agent_model===source.model)).length,population_size:context.history.length,cost:context.history.length}}function linksSourceResult(source,context){const matches=context.items.filter(item=>{const links=item[source.link],present=Array.isArray(links)&&links.length>0;return source.state==="present"?present:!present});return{value:matches.length,population_size:context.items.length,cost:context.items.length,contributors:matches.map(item=>item.id)}}function sourceResult(definition,context){const source=definition.source;return source.kind==="items"?itemsSourceResult(source,context):source.kind==="dependency_kind"?dependencyKindSourceResult(source,context):source.kind==="prose_edge_gap"?proseEdgeGapSourceResult(source,context):source.kind==="history"?historySourceResult(source,context):source.kind==="links"?linksSourceResult(source,context):null}function sumCosts(costs,durationMs){return costs.reduce((total,cost)=>({units:total.units+cost.units,items_scanned:total.items_scanned+cost.items_scanned,history_entries:total.history_entries+cost.history_entries,provider_calls:total.provider_calls+cost.provider_calls,duration_ms:durationMs}),{units:0,items_scanned:0,history_entries:0,provider_calls:0,duration_ms:durationMs})}function arithmeticValue(operator,values){if(values.length===0)throw new TypeError(`derived ${operator} requires operands`);if(operator==="add")return values.reduce((sum,value)=>sum+value,0);if(operator==="subtract")return values.slice(1).reduce((result,value)=>result-value,values[0]);if(operator==="multiply")return values.reduce((result,value)=>result*value,1);if(operator==="divide"){if(values.slice(1).includes(0))throw new TypeError("derived divide cannot divide by zero");return values.slice(1).reduce((result,value)=>result/value,values[0])}return operator==="min"?Math.min(...values):Math.max(...values)}async function mapWithConcurrency(values,limit,transform){const results=new Array(values.length);let nextIndex=0;const workers=Array.from({length:Math.min(limit,values.length)},async()=>{for(;nextIndex<values.length;){const index=nextIndex;nextIndex+=1,results[index]=await transform(values[index],index)}});return await Promise.all(workers),results}async function evaluateExpression(expression,context,definitions,stack,state){if("literal"in expression)return{value:expression.literal,costs:[],population_size:0,contributors:[]};if("measurement"in expression){const definition=definitions.find(entry=>entry.id===expression.measurement);if(!definition)throw new TypeError(`derived measurement references missing ${expression.measurement}`);const result=await evaluateMeasurementCached(definition,context,definitions,stack,state);if(typeof result.value!="number")throw new TypeError(`derived measurement ${definition.id} is not numeric`);const costs=state.charged.has(definition.id)?[]:[result.cost];return state.charged.add(definition.id),{value:result.value,costs,population_size:result.population_size,contributors:result.contributors}}const operands=await mapWithConcurrency(expression.operands,EVALUATION_CONCURRENCY,operand=>evaluateExpression(operand,context,definitions,stack,state));return{value:arithmeticValue(expression.operator,operands.map(entry=>entry.value)),costs:operands.flatMap(entry=>entry.costs),population_size:Math.max(0,...operands.map(entry=>entry.population_size)),contributors:[...new Set(operands.flatMap(entry=>entry.contributors))]}}async function evaluateMeasurementInternal(definition,context,definitions,stack,state){validateMeasurementDefinition(definition);const startedAt=Date.now();let result,nestedCosts=[],providerCalls=0;if(definition.source.kind==="derived"){const derived=await evaluateExpression(definition.source.expression,context,definitions,[...stack,definition.id],state);result={value:derived.value,population_size:derived.population_size,cost:0,contributors:derived.contributors},nestedCosts=derived.costs}else{const builtin=sourceResult(definition,context);builtin!==null?result=builtin:(result=await context.external(definition.source),providerCalls=1)}const ownCost={units:result.cost,items_scanned:definition.source.kind==="items"||definition.source.kind==="dependency_kind"||definition.source.kind==="prose_edge_gap"||definition.source.kind==="links"?context.items.length:0,history_entries:definition.source.kind==="history"?context.history.length:0,provider_calls:providerCalls,duration_ms:Date.now()-startedAt},cost=sumCosts([...nestedCosts,ownCost],Date.now()-startedAt);if(definition.max_cost!==void 0&&cost.units>definition.max_cost)throw new AssuranceEvaluationRefusalError(`measurement ${definition.id} exceeded cost ceiling ${definition.max_cost} with ${cost.units}`);return{id:definition.id,definition_fingerprint:`sha256:${createHash("sha256").update(stableStringify(definition)).digest("hex")}`,value:result.value,population_size:result.population_size,cost,contributors:result.contributors??[],...result.partitions?{partitions:result.partitions}:{}}}function evaluateMeasurementCached(definition,context,definitions,stack,state){if(stack.includes(definition.id))throw new TypeError(`derived measurement cycle: ${[...stack,definition.id].join(" -> ")}`);const cached=state.cache.get(definition.id);if(cached)return cached;const evaluation=evaluateMeasurementInternal(definition,context,definitions,stack,state).catch(error=>{if(error instanceof AssuranceSourceResolutionError&&error.measurement_id===void 0){const sourceContext={measurement_id:definition.id,source_kind:error.source_kind,field:error.field,...error.check?{check:error.check}:{}},sourceError=new AssuranceSourceResolutionError(error.message,sourceContext);throw sourceError.cause=error,sourceError}throw error});return state.cache.set(definition.id,evaluation),evaluation}async function evaluateMeasurement(definition,context,definitions=[definition]){return evaluateMeasurementCached(definition,context,definitions,[],{cache:new Map,charged:new Set})}function assertionDistance(observed,bound){return typeof observed!="number"||typeof bound.value!="number"?null:bound.polarity==="ceiling"||bound.polarity==="monotone_nonincreasing"?bound.value-observed:(bound.polarity==="floor"||bound.polarity,observed-bound.value)}function evaluateAssuranceAssertion(definition,measurement,options={}){validateAssertionDefinition(definition);const bound=boundFor(definition),retired=definition.lifetime==="retire"&&options.owner_terminal===!0;return{assertion_id:definition.id,measurement_id:definition.measurement_id,measurement_definition_fingerprint:measurement.definition_fingerprint,scope:definition.scope,population_size:measurement.population_size,observed:measurement.value,bound,distance:assertionDistance(measurement.value,bound),verdict:retired?"retired":compareBound(measurement.value,bound)?"pass":"fail",enforcement:definition.enforcement,negative_control_proven:proveNegativeControl(definition),cost:measurement.cost,contributors:measurement.contributors,...measurement.partitions?{partitions:measurement.partitions}:{}}}function enforceGateProviderPolicy(gate,document,context,trigger){const providerIds=collectGateProviderIds(gate,document);if(providerIds.size===0)return;const policy=gate.provider_policy,triggerPolicy=policy?.triggers[trigger];if(!policy||!triggerPolicy)throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses provider execution at trigger ${trigger} without an explicit provider policy`);const allowedProviders=new Set(policy.allowed_providers),costRank={low:0,medium:1,high:2};for(const providerId of providerIds){if(!allowedProviders.has(providerId))throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses provider ${providerId}`);const capability=context.provider_capabilities?.[providerId];if(!capability)throw new AssuranceEvaluationRefusalError(`assurance provider ${providerId} has no declared capabilities`);if(costRank[capability.cost_class]>costRank[triggerPolicy.max_cost_class])throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses ${capability.cost_class}-cost provider ${providerId} at trigger ${trigger}`);if(capability.network&&!triggerPolicy.allow_network)throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses network provider ${providerId} at trigger ${trigger}`)}}async function evaluateGateMeasurement(gateId,assertionId,definition,context,definitions){try{return await evaluateMeasurement(definition,context,definitions)}catch(error){if(error instanceof AssuranceSourceResolutionError){const checkLocation=error.check?` check ${error.check}`:"",measurementId=error.measurement_id??definition.id,refusal=new AssuranceEvaluationRefusalError(`assurance gate ${gateId} assertion ${assertionId} measurement ${measurementId} source ${error.source_kind}${checkLocation} field ${error.field} could not resolve: ${error.message}`,{gate_id:gateId,assertion_id:assertionId,measurement_id:measurementId,source_kind:error.source_kind,field:error.field,...error.check?{check:error.check}:{}});throw refusal.cause=error,refusal}throw error}}async function evaluateAssuranceGate(gateId,document,context,options){validateAssuranceDocument(document);const gateDefinition=document.gates.find(entry=>entry.id===gateId);if(!gateDefinition)throw new AssuranceEvaluationRefusalError(`assurance gate ${gateId} not found`);if(!gateDefinition.triggers.includes(options.trigger))throw new AssuranceEvaluationRefusalError(`assurance gate ${gateId} does not declare trigger ${options.trigger}`);enforceGateProviderPolicy(gateDefinition,document,context,options.trigger);const assertions=await mapWithConcurrency(gateDefinition.assertion_ids,EVALUATION_CONCURRENCY,async id=>{const assertionDefinition=document.assertions.find(entry=>entry.id===id),measurementDefinition=document.measurements.find(entry=>entry.id===assertionDefinition.measurement_id);let scopedContext=context;if(assertionDefinition.scope.kind==="active"){const terminalStatuses=new Set(context.terminal_statuses??["closed","canceled"]);scopedContext={...context,items:context.items.filter(item=>!terminalStatuses.has(item.status))}}else if(assertionDefinition.scope.kind==="filter"){const scopeMeasurementId=assertionDefinition.scope.measurement_id,scopeDefinition=document.measurements.find(entry=>entry.id===scopeMeasurementId),scope=await evaluateGateMeasurement(gateDefinition.id,assertionDefinition.id,scopeDefinition,context,document.measurements),contributorIds=new Set(scope.contributors);scopedContext={...context,items:context.items.filter(item=>contributorIds.has(item.id))}}const owner=context.items.find(item=>item.id===assertionDefinition.owner_item_id),ownerTerminal=owner!==void 0&&new Set(context.terminal_statuses??["closed","canceled"]).has(owner.status);return evaluateAssuranceAssertion(assertionDefinition,await evaluateGateMeasurement(gateDefinition.id,assertionDefinition.id,measurementDefinition,scopedContext,document.measurements),{owner_terminal:ownerTerminal})}),blocking=assertions.some(entry=>entry.verdict==="fail"&&entry.enforcement==="block"),warning=assertions.some(entry=>entry.verdict==="fail"&&entry.enforcement==="warn");return{gate_id:gateDefinition.id,tree_id:context.tree_id,trigger:options.trigger,dry_run:options.dry_run===!0,evaluated_at:new Date().toISOString(),verdict:blocking?"block":warning?"warn":"pass",exit_code:blocking?1:0,assertions,assertions_total:assertions.length,row_contract:{row_keys:["assertions"],jq_selector:".assertions[]"},cost:sumCosts(assertions.map(entry=>entry.cost),Math.max(0,...assertions.map(entry=>entry.cost.duration_ms)))}}function assurancePath(pmRoot){return path.join(pmRoot,"assurance.json")}async function readDocument(pmRoot){const raw=await readFileIfExists(assurancePath(pmRoot));return raw===null?createEmptyAssuranceDocument():parseAssuranceDocument(raw)}function parseAssuranceDocument(raw){try{return validateAssuranceDocument(JSON.parse(raw))}catch(error){throw new PmCliError("The assurance registry is invalid. Repair or restore .agents/pm/assurance.json and retry.",EXIT_CODE.GENERIC_FAILURE,{code:"assurance_registry_invalid",reason:String(error),nextSteps:["Restore a valid assurance.json from version control or repair its declaration references.","Run pm assurance list measurement after the repair."]})}}function collectionFor(document,kind){return kind==="measurement"?document.measurements:kind==="assertion"?document.assertions:document.gates}function validateForKind(kind,definition){kind==="measurement"?validateMeasurementDefinition(definition):kind==="assertion"?validateAssertionDefinition(definition):validateGateDefinition(definition)}async function listAssuranceDeclarations(pmRoot,kind){const items=structuredClone(collectionFor(await readDocument(pmRoot),kind));return{items,count:items.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function getAssuranceDeclaration(pmRoot,kind,id){const found=collectionFor(await readDocument(pmRoot),kind).find(entry=>entry.id===id);if(!found)throw new TypeError(`assurance ${kind} ${id} not found`);return structuredClone(found)}async function putAssuranceDeclaration(pmRoot,kind,definition,options={}){validateForKind(kind,definition);const settings=await readSettings(pmRoot),author=resolveAuthor(options.author,settings.author_default),mutation=await mutateWorkspaceJsonWithHistory({pmRoot,filePath:assurancePath(pmRoot),op:`assurance:${kind}:put`,author,message:options.message,lockTtlSeconds:LOCK_TTL_SECONDS,lockWaitMs:LOCK_WAIT_MS,mutate:beforeRaw=>{const document=beforeRaw===null?createEmptyAssuranceDocument():parseAssuranceDocument(beforeRaw),collection=collectionFor(document,kind),index=collection.findIndex(entry=>entry.id===definition.id),action=index<0?"created":"updated";if(kind==="assertion"&&index>=0&&assuranceAssertionUpdateIsLoosening(collection[index],definition)){const decision=definition.authorization_decision;if(!decision||!options.authorized_decision_ids?.includes(decision))throw new AssuranceMutationRefusalError(`loosening assertion ${definition.id} requires a verified authorization_decision`)}return index<0?collection.push(structuredClone(definition)):collection[index]=structuredClone(definition),validateAssuranceDocument(document),{raw:`${JSON.stringify(document,null,2)}
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="eaede7d4-43ae-5551-915e-19befefc29d0")}catch{}})();import{createHash}from"node:crypto";import path from"node:path";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{appendWorkspaceAuditEvent,mutateWorkspaceJsonWithHistory,readFileIfExists,readHistoryEntries,readSettings,resolveAuthor,stableStringify,WORKSPACE_HISTORY_ID,getWorkspaceHistoryPath}from"../runtime-primitives.js";import{resolveCanonicalRelationshipKind}from"../relationships.js";import{MAX_ASSURANCE_VERDICT_LIMIT}from"./assurance-limits.js";import{AssuranceEvaluationRefusalError,AssuranceMutationRefusalError,AssuranceSourceResolutionError}from"./assurance-mutation-error.js";const ASSURANCE_DOCUMENT_VERSION=1,ASSURANCE_GATE_TRIGGERS=["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"],ASSURANCE_MEASUREMENT_SOURCE_KINDS=["items","dependency_kind","prose_edge_gap","graph","validate","health","history","links","provider","derived"],POLARITY_KEYS=["ceiling","floor","equals","zero","monotone_nondecreasing","monotone_nonincreasing","subset_of"],ID_PATTERN=/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/,LOCK_TTL_SECONDS=30,LOCK_WAIT_MS=5e3,EVALUATION_CONCURRENCY=4,DEFAULT_VERDICT_LIMIT=50;function requireStableId(value,field){if(!ID_PATTERN.test(value))throw new AssuranceMutationRefusalError(`${field} must be a stable lowercase id`)}function requireFiniteNonNegative(value,field){if(!Number.isFinite(value)||value<0)throw new AssuranceMutationRefusalError(`${field} must be a finite non-negative number`)}function boundFor(assertion){const present=POLARITY_KEYS.filter(key=>assertion[key]!==void 0);if(present.length!==1)throw new AssuranceMutationRefusalError(`assertion ${assertion.id} must declare exactly one polarity`);const polarity=present[0],raw=assertion[polarity];return{polarity,value:polarity==="zero"?0:raw}}function valuesEqual(left,right){return stableStringify(left)===stableStringify(right)}function compareBound(observed,bound){if(bound.polarity==="equals")return valuesEqual(observed,bound.value);if(bound.polarity==="subset_of"){if(!Array.isArray(observed)||!Array.isArray(bound.value))return!1;const allowed=bound.value;return observed.every(entry=>allowed.includes(entry))}if(typeof observed!="number")return!1;const numericBound=bound.value;return bound.polarity==="ceiling"||bound.polarity==="monotone_nonincreasing"?observed<=numericBound:bound.polarity==="floor"||bound.polarity==="monotone_nondecreasing"?observed>=numericBound:observed===0}function proveNegativeControl(assertion){const bound=boundFor(assertion),cases=assertion.negative_control.cases;return cases.some(entry=>entry.expected==="pass")&&cases.some(entry=>entry.expected==="fail")&&cases.every(entry=>compareBound(entry.observed,bound)===(entry.expected==="pass"))}function boundUpdateIsLoosening(beforeBound,afterBound){if(beforeBound.polarity!==afterBound.polarity)return!0;if(typeof beforeBound.value=="number"&&typeof afterBound.value=="number")return beforeBound.polarity==="ceiling"||beforeBound.polarity==="monotone_nonincreasing"?afterBound.value>beforeBound.value:beforeBound.polarity==="floor"||beforeBound.polarity==="monotone_nondecreasing"?afterBound.value<beforeBound.value:afterBound.value!==beforeBound.value;if(beforeBound.polarity==="subset_of"){const beforeValues=beforeBound.value,afterValues=afterBound.value;return!Array.isArray(beforeValues)||!Array.isArray(afterValues)||afterValues.some(entry=>!beforeValues.includes(entry))}return!valuesEqual(beforeBound.value,afterBound.value)}function assuranceAssertionUpdateIsLoosening(before,after){if(before.measurement_id!==after.measurement_id||before.owner_item_id!==after.owner_item_id||stableStringify(before.scope)!==stableStringify(after.scope))return!0;const enforcementRank={observe:0,warn:1,block:2},lifetimeLoosened=(before.lifetime??"hold")==="hold"&&(after.lifetime??"hold")==="retire";return boundUpdateIsLoosening(boundFor(before),boundFor(after))||enforcementRank[after.enforcement]<enforcementRank[before.enforcement]||lifetimeLoosened}function validateItemsMeasurementSource(source){if(source.state!==void 0&&!(source.state==="present"||source.state==="missing"))throw new AssuranceMutationRefusalError("items source state must be present or missing");const hasEquals=Object.hasOwn(source,"equals"),hasState=source.state!==void 0,predicateCount=Number(hasEquals)+Number(hasState);if(source.field!==void 0&&predicateCount!==1)throw new AssuranceMutationRefusalError("items source with field requires exactly one of equals or state");if(source.field===void 0&&predicateCount!==0)throw new AssuranceMutationRefusalError("items source equals/state requires field")}function validateDependencyKindMeasurementSource(source){if(typeof source.dependency_kind!="string"||source.dependency_kind.trim().length===0)throw new AssuranceMutationRefusalError("dependency_kind source requires dependency_kind");if([source.source_kind,source.source_kind_prefix,source.source_kind_state].filter(value=>value!==void 0).length>1)throw new AssuranceMutationRefusalError("dependency_kind source accepts at most one source_kind predicate");if(source.source_kind!==void 0&&source.source_kind.trim().length===0||source.source_kind_prefix!==void 0&&source.source_kind_prefix.trim().length===0)throw new AssuranceMutationRefusalError("dependency_kind source provenance values must not be empty");if(source.source_kind_state!==void 0&&source.source_kind_state!=="present"&&source.source_kind_state!=="missing")throw new AssuranceMutationRefusalError("dependency_kind source source_kind_state must be present or missing")}function validateProseEdgeGapSource(source){if(source.sample_limit!==void 0&&(!Number.isInteger(source.sample_limit)||source.sample_limit<1))throw new AssuranceMutationRefusalError("prose_edge_gap sample_limit must be a positive integer");for(const exemption of source.exemptions??[]){if(typeof exemption.holder_id!="string"||exemption.holder_id.trim().length===0||typeof exemption.reason!="string"||exemption.reason.trim().length===0)throw new AssuranceMutationRefusalError("prose_edge_gap exemptions require holder_id and reason");if(exemption.target_id!==void 0&&exemption.target_id.trim().length===0||exemption.text_contains!==void 0&&exemption.text_contains.trim().length===0)throw new AssuranceMutationRefusalError("prose_edge_gap exemption selectors must not be empty")}}function validateMeasurementDefinition(definition){requireStableId(definition.id,"measurement.id"),definition.max_cost!==void 0&&requireFiniteNonNegative(definition.max_cost,"measurement.max_cost");const candidateSource=definition.source;if(Object.prototype.toString.call(candidateSource)!=="[object Object]")throw new AssuranceMutationRefusalError(`measurement.source.kind must be one of ${ASSURANCE_MEASUREMENT_SOURCE_KINDS.join(", ")}`);const sourceKind=Reflect.get(candidateSource,"kind");if(!ASSURANCE_MEASUREMENT_SOURCE_KINDS.includes(sourceKind))throw new AssuranceMutationRefusalError(`measurement.source.kind must be one of ${ASSURANCE_MEASUREMENT_SOURCE_KINDS.join(", ")}`);const source=candidateSource;if(source.kind==="items"&&validateItemsMeasurementSource(source),source.kind==="dependency_kind"&&validateDependencyKindMeasurementSource(source),source.kind==="prose_edge_gap"&&validateProseEdgeGapSource(source),(source.kind==="graph"||source.kind==="validate"||source.kind==="health")&&(typeof source.field!="string"||source.field.trim().length===0))throw new AssuranceMutationRefusalError(`${source.kind} source requires field`);return source.kind==="provider"&&(requireStableId(source.provider,"provider source provider"),requireStableId(source.key,"provider source key")),definition}function validateAssertionDefinition(definition){if(requireStableId(definition.id,"assertion.id"),requireStableId(definition.measurement_id,"assertion.measurement_id"),typeof definition.owner_item_id!="string"||definition.owner_item_id.trim().length===0)throw new AssuranceMutationRefusalError("assertion.owner_item_id is required");const bound=boundFor(definition);if(typeof bound.value=="number"&&!Number.isFinite(bound.value))throw new AssuranceMutationRefusalError(`assertion.${bound.polarity} must be a finite number`);if(definition.lifetime==="retire"&&(typeof definition.retire_reason!="string"||definition.retire_reason.trim().length===0))throw new AssuranceMutationRefusalError("retired assertion requires retire_reason");definition.scope.kind==="filter"&&requireStableId(definition.scope.measurement_id,"assertion.scope.measurement_id");const cases=definition.negative_control?.cases;if(!Array.isArray(cases)||!cases.some(entry=>entry.expected==="pass")||!cases.some(entry=>entry.expected==="fail"))throw new AssuranceMutationRefusalError("assertion negative control requires pass and fail cases");if(!proveNegativeControl(definition))throw new AssuranceMutationRefusalError(`assertion ${definition.id} negative control does not prove its bound`);return definition}function validateGateProviderPolicy(policy){if(!Array.isArray(policy.allowed_providers))throw new AssuranceMutationRefusalError("gate provider_policy.allowed_providers must be an array");for(const provider of policy.allowed_providers)requireStableId(provider,"gate.provider_policy.allowed_provider");if(typeof policy.triggers!="object"||policy.triggers===null||Array.isArray(policy.triggers))throw new AssuranceMutationRefusalError("gate provider_policy.triggers must be an object");for(const[trigger,rule]of Object.entries(policy.triggers)){if(!ASSURANCE_GATE_TRIGGERS.includes(trigger))throw new AssuranceMutationRefusalError(`gate provider policy has unknown trigger ${trigger}`);if(typeof rule!="object"||rule===null||!["low","medium","high"].includes(rule.max_cost_class)||typeof rule.allow_network!="boolean")throw new AssuranceMutationRefusalError(`gate provider policy trigger ${trigger} is invalid`)}}function validateGateDefinition(definition){if(requireStableId(definition.id,"gate.id"),!Array.isArray(definition.assertion_ids))throw new AssuranceMutationRefusalError("gate.assertion_ids is required and must be an array");if(definition.assertion_ids.length===0)throw new AssuranceMutationRefusalError("gate requires at least one assertion");for(const id of definition.assertion_ids)requireStableId(id,"gate.assertion_id");if(!Array.isArray(definition.triggers))throw new AssuranceMutationRefusalError(`gate.triggers is required and must be an array of ${ASSURANCE_GATE_TRIGGERS.join(", ")}`);if(definition.triggers.length===0)throw new AssuranceMutationRefusalError("gate requires at least one trigger");for(const trigger of definition.triggers)if(!ASSURANCE_GATE_TRIGGERS.includes(trigger))throw new AssuranceMutationRefusalError(`gate trigger must be one of ${ASSURANCE_GATE_TRIGGERS.join(", ")}`);return definition.provider_policy&&validateGateProviderPolicy(definition.provider_policy),definition}function validateAssuranceDocument(document){if(document.version!==ASSURANCE_DOCUMENT_VERSION)throw new AssuranceMutationRefusalError(`unsupported assurance document version ${String(document.version)}`);const ids=new Set;for(const definition of document.measurements){if(validateMeasurementDefinition(definition),ids.has(`measurement:${definition.id}`))throw new AssuranceMutationRefusalError(`duplicate measurement ${definition.id}`);ids.add(`measurement:${definition.id}`)}for(const definition of document.assertions){if(validateAssertionDefinition(definition),ids.has(`assertion:${definition.id}`))throw new AssuranceMutationRefusalError(`duplicate assertion ${definition.id}`);ids.add(`assertion:${definition.id}`)}for(const definition of document.gates){validateGateDefinition(definition);const missing=definition.assertion_ids.filter(id=>!document.assertions.some(assertionDefinition=>assertionDefinition.id===id));if(missing.length>0)throw new AssuranceMutationRefusalError(`gate ${definition.id} references missing assertions: ${missing.join(", ")}`);if(ids.has(`gate:${definition.id}`))throw new AssuranceMutationRefusalError(`duplicate gate ${definition.id}`);ids.add(`gate:${definition.id}`)}const measurementIds=new Set(document.measurements.map(entry=>entry.id));for(const[measurementId,consumers]of collectMeasurementReferences(document))if(!measurementIds.has(measurementId))throw new AssuranceMutationRefusalError(`${consumers.join(", ")} references missing measurement ${measurementId}`);return document}function collectExpressionMeasurementReferences(expression,references){if("measurement"in expression){references.push(expression.measurement);return}if("operator"in expression)for(const operand of expression.operands)collectExpressionMeasurementReferences(operand,references)}function collectMeasurementReferences(document){const references=new Map,add=(measurementId,consumer)=>{const consumers=references.get(measurementId)??[];consumers.push(consumer),references.set(measurementId,consumers)};for(const assertionDefinition of document.assertions)add(assertionDefinition.measurement_id,`assertion ${assertionDefinition.id}`),assertionDefinition.scope.kind==="filter"&&add(assertionDefinition.scope.measurement_id,`assertion ${assertionDefinition.id} scope`);for(const measurementDefinition of document.measurements){if(measurementDefinition.source.kind!=="derived")continue;const derivedReferences=[];collectExpressionMeasurementReferences(measurementDefinition.source.expression,derivedReferences);for(const measurementId of derivedReferences)add(measurementId,`derived measurement ${measurementDefinition.id}`)}return references}function collectGateProviderIds(gate,document){const pending=gate.assertion_ids.flatMap(assertionId=>{const assertion=document.assertions.find(entry=>entry.id===assertionId);return[assertion.measurement_id,...assertion.scope.kind==="filter"?[assertion.scope.measurement_id]:[]]}),visited=new Set,providers=new Set;for(;pending.length>0;){const measurementId=pending.pop();if(visited.has(measurementId))continue;visited.add(measurementId);const measurement=document.measurements.find(entry=>entry.id===measurementId);measurement.source.kind==="provider"?providers.add(measurement.source.provider):measurement.source.kind==="derived"&&collectExpressionMeasurementReferences(measurement.source.expression,pending)}return providers}function createEmptyAssuranceDocument(){return{version:ASSURANCE_DOCUMENT_VERSION,measurements:[],assertions:[],gates:[]}}function itemsSourceResult(source,context){const matches=context.items.filter(item=>(source.statuses===void 0||source.statuses.includes(item.status))&&(source.types===void 0||source.types.includes(item.type))&&(source.tags===void 0||source.tags.every(tag=>item.tags?.includes(tag)))&&(source.field===void 0||(()=>{const value=item[source.field];if(source.state!==void 0){const missing=value==null||value===""||Array.isArray(value)&&value.length===0;return source.state==="missing"?missing:!missing}return valuesEqual(value,source.equals)})()));return{value:matches.length,population_size:context.items.length,cost:context.items.length,contributors:matches.map(item=>item.id)}}function dependencyProvenanceMatches(source,sourceKind){return source.source_kind!==void 0?sourceKind?.toLowerCase()===source.source_kind.trim().toLowerCase():source.source_kind_prefix!==void 0?sourceKind?.toLowerCase().startsWith(source.source_kind_prefix.trim().toLowerCase())===!0:source.source_kind_state==="present"?sourceKind!==void 0&&sourceKind.length>0:source.source_kind_state==="missing"?sourceKind===void 0||sourceKind.length===0:!0}function dependencyKindSourceResult(source,context){const contributors=[],requestedKind=resolveCanonicalRelationshipKind(source.dependency_kind)??source.dependency_kind.trim().toLowerCase();for(const item of context.items)for(const dependency of item.dependencies??[]){const dependencyKind=resolveCanonicalRelationshipKind(dependency.kind)??dependency.kind.trim().toLowerCase(),sourceKind=dependency.source_kind?.trim();dependencyKind===requestedKind&&dependencyProvenanceMatches(source,sourceKind)&&contributors.push(`${item.id}->${dependency.id}${sourceKind?`@${sourceKind}`:""}`)}return{value:contributors.length,population_size:context.items.length,cost:context.items.length,contributors}}function assuranceItemProseSegments(item){const segments=[item.description,item.body].filter(value=>typeof value=="string").map(value=>value.trim()).filter(Boolean);for(const key of["comments","notes","learnings"]){const entries=item[key];if(Array.isArray(entries)){for(const entry of entries)if(typeof entry=="string")segments.push(entry);else if(typeof entry=="object"&&entry!==null){const text=Reflect.get(entry,"text");typeof text=="string"&&segments.push(text)}}}return segments}function proseReferenceIsExempt(exemptions,holderId,targetId,segment){return exemptions.some(exemption=>exemption.holder_id.trim().toLowerCase()===holderId.toLowerCase()&&(exemption.target_id===void 0||exemption.target_id.trim().toLowerCase()===targetId.toLowerCase())&&(exemption.text_contains===void 0||segment.toLowerCase().includes(exemption.text_contains.trim().toLowerCase())))}function prosePairKey(left,right){return[left.toLowerCase(),right.toLowerCase()].sort().join("\0")}function collectProseEdgeCensusInputs(items){const canonicalIds=new Map,linkedPairs=new Set,proseMentions=[],mentionPattern=/(?<![\w-])[a-z0-9]+(?:-+[a-z0-9]+)+(?![\w-])/giu;let mentionCount=0;for(const item of items){canonicalIds.set(item.id.toLowerCase(),item.id);for(const dependency of item.dependencies??[])linkedPairs.add(prosePairKey(item.id,dependency.id));for(const scalar of[item.parent,item.blocked_by])typeof scalar=="string"&&linkedPairs.add(prosePairKey(item.id,scalar));for(const segment of assuranceItemProseSegments(item)){const mentionedIds=[...segment.matchAll(mentionPattern)].map(match=>match[0]);mentionCount+=mentionedIds.length,proseMentions.push({holder_id:item.id,segment,mentioned_ids:mentionedIds})}}return{canonical_ids:canonicalIds,linked_pairs:linkedPairs,prose_mentions:proseMentions,mention_count:mentionCount}}function proseEdgeGapSourceResult(source,context){const census=collectProseEdgeCensusInputs(context.items),gaps=new Map;for(const proseMention of census.prose_mentions){const mentions=proseMention.mentioned_ids.map(id=>census.canonical_ids.get(id.toLowerCase())).filter(id=>id!==void 0&&id!==proseMention.holder_id),distinctMentions=[...new Set(mentions)];for(const targetId of distinctMentions){const key=prosePairKey(proseMention.holder_id,targetId);if(census.linked_pairs.has(key)||proseReferenceIsExempt(source.exemptions??[],proseMention.holder_id,targetId,proseMention.segment))continue;const explicit=distinctMentions.some(candidate=>candidate!==targetId);gaps.get(key)?.explicit===!0&&!explicit||gaps.set(key,{contributor:`${proseMention.holder_id}->${targetId}|subject=${explicit?"explicit":"implicit"}`,explicit})}}const gapRows=[...gaps.values()],contributors=gapRows.map(entry=>entry.contributor).sort();return{value:contributors.length,population_size:census.canonical_ids.size,cost:context.items.length+census.linked_pairs.size+census.mention_count,contributors:contributors.slice(0,source.sample_limit??25),partitions:{explicit_subject:gapRows.filter(entry=>entry.explicit).length,implicit_subject:gapRows.filter(entry=>!entry.explicit).length}}}function historySourceResult(source,context){return{value:context.history.filter(entry=>(source.op===void 0||entry.op===source.op)&&(source.author===void 0||entry.author===source.author)&&(source.harness===void 0||entry.agent_harness===source.harness)&&(source.model===void 0||entry.agent_model===source.model)).length,population_size:context.history.length,cost:context.history.length}}function linksSourceResult(source,context){const matches=context.items.filter(item=>{const links=item[source.link],present=Array.isArray(links)&&links.length>0;return source.state==="present"?present:!present});return{value:matches.length,population_size:context.items.length,cost:context.items.length,contributors:matches.map(item=>item.id)}}function sourceResult(definition,context){const source=definition.source;return source.kind==="items"?itemsSourceResult(source,context):source.kind==="dependency_kind"?dependencyKindSourceResult(source,context):source.kind==="prose_edge_gap"?proseEdgeGapSourceResult(source,context):source.kind==="history"?historySourceResult(source,context):source.kind==="links"?linksSourceResult(source,context):null}function sumCosts(costs,durationMs){return costs.reduce((total,cost)=>({units:total.units+cost.units,items_scanned:total.items_scanned+cost.items_scanned,history_entries:total.history_entries+cost.history_entries,provider_calls:total.provider_calls+cost.provider_calls,duration_ms:durationMs}),{units:0,items_scanned:0,history_entries:0,provider_calls:0,duration_ms:durationMs})}function arithmeticValue(operator,values){if(values.length===0)throw new TypeError(`derived ${operator} requires operands`);if(operator==="add")return values.reduce((sum,value)=>sum+value,0);if(operator==="subtract")return values.slice(1).reduce((result,value)=>result-value,values[0]);if(operator==="multiply")return values.reduce((result,value)=>result*value,1);if(operator==="divide"){if(values.slice(1).includes(0))throw new TypeError("derived divide cannot divide by zero");return values.slice(1).reduce((result,value)=>result/value,values[0])}return operator==="min"?Math.min(...values):Math.max(...values)}async function mapWithConcurrency(values,limit,transform){const results=new Array(values.length);let nextIndex=0;const workers=Array.from({length:Math.min(limit,values.length)},async()=>{for(;nextIndex<values.length;){const index=nextIndex;nextIndex+=1,results[index]=await transform(values[index],index)}});return await Promise.all(workers),results}async function evaluateExpression(expression,context,definitions,stack,state){if("literal"in expression)return{value:expression.literal,costs:[],population_size:0,contributors:[]};if("measurement"in expression){const definition=definitions.find(entry=>entry.id===expression.measurement);if(!definition)throw new TypeError(`derived measurement references missing ${expression.measurement}`);const result=await evaluateMeasurementCached(definition,context,definitions,stack,state);if(typeof result.value!="number")throw new TypeError(`derived measurement ${definition.id} is not numeric`);const costs=state.charged.has(definition.id)?[]:[result.cost];return state.charged.add(definition.id),{value:result.value,costs,population_size:result.population_size,contributors:result.contributors}}const operands=await mapWithConcurrency(expression.operands,EVALUATION_CONCURRENCY,operand=>evaluateExpression(operand,context,definitions,stack,state));return{value:arithmeticValue(expression.operator,operands.map(entry=>entry.value)),costs:operands.flatMap(entry=>entry.costs),population_size:Math.max(0,...operands.map(entry=>entry.population_size)),contributors:[...new Set(operands.flatMap(entry=>entry.contributors))]}}async function evaluateMeasurementInternal(definition,context,definitions,stack,state){validateMeasurementDefinition(definition);const startedAt=Date.now();let result,nestedCosts=[],providerCalls=0;if(definition.source.kind==="derived"){const derived=await evaluateExpression(definition.source.expression,context,definitions,[...stack,definition.id],state);result={value:derived.value,population_size:derived.population_size,cost:0,contributors:derived.contributors},nestedCosts=derived.costs}else{const builtin=sourceResult(definition,context);builtin!==null?result=builtin:(result=await context.external(definition.source),providerCalls=1)}const ownCost={units:result.cost,items_scanned:definition.source.kind==="items"||definition.source.kind==="dependency_kind"||definition.source.kind==="prose_edge_gap"||definition.source.kind==="links"?context.items.length:0,history_entries:definition.source.kind==="history"?context.history.length:0,provider_calls:providerCalls,duration_ms:Date.now()-startedAt},cost=sumCosts([...nestedCosts,ownCost],Date.now()-startedAt);if(definition.max_cost!==void 0&&cost.units>definition.max_cost)throw new AssuranceEvaluationRefusalError(`measurement ${definition.id} exceeded cost ceiling ${definition.max_cost} with ${cost.units}`);return{id:definition.id,definition_fingerprint:`sha256:${createHash("sha256").update(stableStringify(definition)).digest("hex")}`,value:result.value,population_size:result.population_size,cost,contributors:result.contributors??[],...result.partitions?{partitions:result.partitions}:{}}}function evaluateMeasurementCached(definition,context,definitions,stack,state){if(stack.includes(definition.id))throw new TypeError(`derived measurement cycle: ${[...stack,definition.id].join(" -> ")}`);const cached=state.cache.get(definition.id);if(cached)return cached;const evaluation=evaluateMeasurementInternal(definition,context,definitions,stack,state).catch(error=>{if(error instanceof AssuranceSourceResolutionError&&error.measurement_id===void 0){const sourceContext={measurement_id:definition.id,source_kind:error.source_kind,field:error.field,...error.check?{check:error.check}:{}},sourceError=new AssuranceSourceResolutionError(error.message,sourceContext);throw sourceError.cause=error,sourceError}throw error});return state.cache.set(definition.id,evaluation),evaluation}async function evaluateMeasurement(definition,context,definitions=[definition]){return evaluateMeasurementCached(definition,context,definitions,[],{cache:new Map,charged:new Set})}function assertionDistance(observed,bound){return typeof observed!="number"||typeof bound.value!="number"?null:bound.polarity==="ceiling"||bound.polarity==="monotone_nonincreasing"?bound.value-observed:(bound.polarity==="floor"||bound.polarity,observed-bound.value)}function evaluateAssuranceAssertion(definition,measurement,options={}){validateAssertionDefinition(definition);const bound=boundFor(definition),retired=definition.lifetime==="retire"&&options.owner_terminal===!0;return{assertion_id:definition.id,measurement_id:definition.measurement_id,measurement_definition_fingerprint:measurement.definition_fingerprint,scope:definition.scope,population_size:measurement.population_size,observed:measurement.value,bound,distance:assertionDistance(measurement.value,bound),verdict:retired?"retired":compareBound(measurement.value,bound)?"pass":"fail",enforcement:definition.enforcement,negative_control_proven:proveNegativeControl(definition),cost:measurement.cost,contributors:measurement.contributors,...measurement.partitions?{partitions:measurement.partitions}:{}}}function enforceGateProviderPolicy(gate,document,context,trigger){const providerIds=collectGateProviderIds(gate,document);if(providerIds.size===0)return;const policy=gate.provider_policy,triggerPolicy=policy?.triggers[trigger];if(!policy||!triggerPolicy)throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses provider execution at trigger ${trigger} without an explicit provider policy`);const allowedProviders=new Set(policy.allowed_providers),costRank={low:0,medium:1,high:2};for(const providerId of providerIds){if(!allowedProviders.has(providerId))throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses provider ${providerId}`);const capability=context.provider_capabilities?.[providerId];if(!capability)throw new AssuranceEvaluationRefusalError(`assurance provider ${providerId} has no declared capabilities`);if(costRank[capability.cost_class]>costRank[triggerPolicy.max_cost_class])throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses ${capability.cost_class}-cost provider ${providerId} at trigger ${trigger}`);if(capability.network&&!triggerPolicy.allow_network)throw new AssuranceEvaluationRefusalError(`assurance gate ${gate.id} refuses network provider ${providerId} at trigger ${trigger}`)}}async function evaluateGateMeasurement(gateId,assertionId,definition,context,definitions){try{return await evaluateMeasurement(definition,context,definitions)}catch(error){if(error instanceof AssuranceSourceResolutionError){const checkLocation=error.check?` check ${error.check}`:"",measurementId=error.measurement_id??definition.id,refusal=new AssuranceEvaluationRefusalError(`assurance gate ${gateId} assertion ${assertionId} measurement ${measurementId} source ${error.source_kind}${checkLocation} field ${error.field} could not resolve: ${error.message}`,{gate_id:gateId,assertion_id:assertionId,measurement_id:measurementId,source_kind:error.source_kind,field:error.field,...error.check?{check:error.check}:{}});throw refusal.cause=error,refusal}throw error}}async function evaluateAssuranceGate(gateId,document,context,options){validateAssuranceDocument(document);const gateDefinition=document.gates.find(entry=>entry.id===gateId);if(!gateDefinition)throw new AssuranceEvaluationRefusalError(`assurance gate ${gateId} not found`);if(!gateDefinition.triggers.includes(options.trigger))throw new AssuranceEvaluationRefusalError(`assurance gate ${gateId} does not declare trigger ${options.trigger}`);enforceGateProviderPolicy(gateDefinition,document,context,options.trigger);const assertions=await mapWithConcurrency(gateDefinition.assertion_ids,EVALUATION_CONCURRENCY,async id=>{const assertionDefinition=document.assertions.find(entry=>entry.id===id),measurementDefinition=document.measurements.find(entry=>entry.id===assertionDefinition.measurement_id);let scopedContext=context;if(assertionDefinition.scope.kind==="active"){const terminalStatuses=new Set(context.terminal_statuses??["closed","canceled"]);scopedContext={...context,items:context.items.filter(item=>!terminalStatuses.has(item.status))}}else if(assertionDefinition.scope.kind==="filter"){const scopeMeasurementId=assertionDefinition.scope.measurement_id,scopeDefinition=document.measurements.find(entry=>entry.id===scopeMeasurementId),scope=await evaluateGateMeasurement(gateDefinition.id,assertionDefinition.id,scopeDefinition,context,document.measurements),contributorIds=new Set(scope.contributors);scopedContext={...context,items:context.items.filter(item=>contributorIds.has(item.id))}}const owner=context.items.find(item=>item.id===assertionDefinition.owner_item_id),ownerTerminal=owner!==void 0&&new Set(context.terminal_statuses??["closed","canceled"]).has(owner.status);return evaluateAssuranceAssertion(assertionDefinition,await evaluateGateMeasurement(gateDefinition.id,assertionDefinition.id,measurementDefinition,scopedContext,document.measurements),{owner_terminal:ownerTerminal})}),blocking=assertions.some(entry=>entry.verdict==="fail"&&entry.enforcement==="block"),warning=assertions.some(entry=>entry.verdict==="fail"&&entry.enforcement==="warn");return{gate_id:gateDefinition.id,tree_id:context.tree_id,trigger:options.trigger,dry_run:options.dry_run===!0,evaluated_at:new Date().toISOString(),verdict:blocking?"block":warning?"warn":"pass",exit_code:blocking?1:0,assertions,assertions_total:assertions.length,row_contract:{row_keys:["assertions"],jq_selector:".assertions[]"},cost:sumCosts(assertions.map(entry=>entry.cost),Math.max(0,...assertions.map(entry=>entry.cost.duration_ms)))}}function assurancePath(pmRoot){return path.join(pmRoot,"assurance.json")}async function readDocument(pmRoot){const raw=await readFileIfExists(assurancePath(pmRoot));return raw===null?createEmptyAssuranceDocument():parseAssuranceDocument(raw)}function parseAssuranceDocument(raw){try{return validateAssuranceDocument(JSON.parse(raw))}catch(error){throw new PmCliError("The assurance registry is invalid. Repair or restore .agents/pm/assurance.json and retry.",EXIT_CODE.GENERIC_FAILURE,{code:"assurance_registry_invalid",reason:String(error),nextSteps:["Restore a valid assurance.json from version control or repair its declaration references.","Run pm assurance list measurement after the repair."]})}}function collectionFor(document,kind){return kind==="measurement"?document.measurements:kind==="assertion"?document.assertions:document.gates}function validateForKind(kind,definition){kind==="measurement"?validateMeasurementDefinition(definition):kind==="assertion"?validateAssertionDefinition(definition):validateGateDefinition(definition)}async function listAssuranceDeclarations(pmRoot,kind){const items=structuredClone(collectionFor(await readDocument(pmRoot),kind));return{items,count:items.length,row_contract:{row_keys:["items"],jq_selector:".items[]"}}}async function getAssuranceDeclaration(pmRoot,kind,id){const found=collectionFor(await readDocument(pmRoot),kind).find(entry=>entry.id===id);if(!found)throw new AssuranceEvaluationRefusalError(`assurance ${kind} ${id} not found`);return structuredClone(found)}async function putAssuranceDeclaration(pmRoot,kind,definition,options={}){validateForKind(kind,definition);const settings=await readSettings(pmRoot),author=resolveAuthor(options.author,settings.author_default),mutation=await mutateWorkspaceJsonWithHistory({pmRoot,filePath:assurancePath(pmRoot),op:`assurance:${kind}:put`,author,message:options.message,lockTtlSeconds:LOCK_TTL_SECONDS,lockWaitMs:LOCK_WAIT_MS,mutate:beforeRaw=>{const document=beforeRaw===null?createEmptyAssuranceDocument():parseAssuranceDocument(beforeRaw),collection=collectionFor(document,kind),index=collection.findIndex(entry=>entry.id===definition.id),action=index<0?"created":"updated";if(kind==="assertion"&&index>=0&&assuranceAssertionUpdateIsLoosening(collection[index],definition)){const decision=definition.authorization_decision;if(!decision||!options.authorized_decision_ids?.includes(decision))throw new AssuranceMutationRefusalError(`loosening assertion ${definition.id} requires a verified authorization_decision`)}return index<0?collection.push(structuredClone(definition)):collection[index]=structuredClone(definition),validateAssuranceDocument(document),{raw:`${JSON.stringify(document,null,2)}
 `,result:{changed:!0,action,kind,id:definition.id}}}});return{...mutation.result,changed:mutation.changed}}async function putAssuranceDeclarationBundle(pmRoot,bundle,options={}){const candidate=createEmptyAssuranceDocument();candidate.measurements=structuredClone(bundle.measurements),candidate.assertions=structuredClone(bundle.assertions),candidate.gates=structuredClone(bundle.gates),validateAssuranceDocument(candidate);const settings=await readSettings(pmRoot),author=resolveAuthor(options.author,settings.author_default),mutation=await mutateWorkspaceJsonWithHistory({pmRoot,filePath:assurancePath(pmRoot),op:"assurance:bundle:apply",author,message:options.message,lockTtlSeconds:LOCK_TTL_SECONDS,lockWaitMs:LOCK_WAIT_MS,mutate:beforeRaw=>{const document=beforeRaw===null?createEmptyAssuranceDocument():parseAssuranceDocument(beforeRaw),createdIds=[],unchangedIds=[],apply=(target,additions,kind)=>{for(const definition of additions){const existing=target.find(entry=>entry.id===definition.id);if(!existing){target.push(structuredClone(definition)),createdIds.push(`${kind}:${definition.id}`);continue}if(stableStringify(existing)!==stableStringify(definition))throw new AssuranceMutationRefusalError(`assurance bundle refuses to replace divergent ${kind} ${definition.id}`);unchangedIds.push(`${kind}:${definition.id}`)}};return apply(document.measurements,candidate.measurements,"measurement"),apply(document.assertions,candidate.assertions,"assertion"),apply(document.gates,candidate.gates,"gate"),validateAssuranceDocument(document),{raw:`${JSON.stringify(document,null,2)}
 `,result:{changed:createdIds.length>0,created_ids:createdIds,unchanged_ids:unchangedIds}}}});return{...mutation.result,changed:mutation.changed}}async function removeAssuranceDeclaration(pmRoot,kind,id,options={}){const settings=await readSettings(pmRoot),author=resolveAuthor(options.author,settings.author_default),mutation=await mutateWorkspaceJsonWithHistory({pmRoot,filePath:assurancePath(pmRoot),op:`assurance:${kind}:remove`,author,message:options.message,lockTtlSeconds:LOCK_TTL_SECONDS,lockWaitMs:LOCK_WAIT_MS,mutate:beforeRaw=>{const document=beforeRaw===null?createEmptyAssuranceDocument():parseAssuranceDocument(beforeRaw);if(kind==="measurement"){const consumers=collectMeasurementReferences(document).get(id);if(consumers&&consumers.length>0)throw new AssuranceMutationRefusalError(`assurance measurement ${id} is referenced by ${consumers.join(", ")}`)}if(kind==="assertion"&&document.gates.some(entry=>entry.assertion_ids.includes(id)))throw new AssuranceMutationRefusalError(`assurance assertion ${id} is referenced by gate`);const collection=collectionFor(document,kind),index=collection.findIndex(entry=>entry.id===id);if(index<0)throw new AssuranceMutationRefusalError(`assurance ${kind} ${id} not found`);return collection.splice(index,1),validateAssuranceDocument(document),{raw:`${JSON.stringify(document,null,2)}
 `,result:{changed:!0,action:"removed",kind,id}}}});return{...mutation.result,changed:mutation.changed}}async function recordAssuranceVerdict(pmRoot,verdict,options={}){if(verdict.dry_run)throw new TypeError("dry-run assurance verdicts are not persisted");const settings=await readSettings(pmRoot);await appendWorkspaceAuditEvent({pmRoot,op:"assurance:gate:verdict",author:resolveAuthor(options.author,settings.author_default),context:{assurance_verdict:verdict},message:options.message??`Assurance gate ${verdict.gate_id} returned ${verdict.verdict}`,lockTtlSeconds:LOCK_TTL_SECONDS,lockWaitMs:LOCK_WAIT_MS})}async function listAssuranceVerdicts(pmRoot,options={}){const limit=options.limit??DEFAULT_VERDICT_LIMIT;if(!Number.isInteger(limit)||limit<1||limit>MAX_ASSURANCE_VERDICT_LIMIT)throw new TypeError(`assurance verdict limit must be an integer from 1 through ${MAX_ASSURANCE_VERDICT_LIMIT}`);return(await readHistoryEntries(getWorkspaceHistoryPath(pmRoot),WORKSPACE_HISTORY_ID)).reverse().filter(entry=>entry.op==="assurance:gate:verdict").map(entry=>entry.context?.assurance_verdict).filter(value=>typeof value=="object"&&value!==null&&"gate_id"in value).filter(verdict=>options.gate_id===void 0||verdict.gate_id===options.gate_id).slice(0,limit)}export{ASSURANCE_DOCUMENT_VERSION,ASSURANCE_GATE_TRIGGERS,ASSURANCE_MEASUREMENT_SOURCE_KINDS,assuranceAssertionUpdateIsLoosening,createEmptyAssuranceDocument,evaluateAssuranceAssertion,evaluateAssuranceGate,evaluateMeasurement,getAssuranceDeclaration,listAssuranceDeclarations,listAssuranceVerdicts,putAssuranceDeclaration,putAssuranceDeclarationBundle,recordAssuranceVerdict,removeAssuranceDeclaration,validateAssertionDefinition,validateAssuranceDocument,validateGateDefinition,validateMeasurementDefinition};

package/dist/sdk/governance/health.js

@@ -1,3 +1,3 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="688b552b-3d10-521e-b695-b3edfbfed36e")}catch{}})();import{BRIEF_HEALTH_DETAIL_LIMIT,HEALTH_WARNING_LIMIT,projectHealthResult,summarizeExtensionList,summarizeHealthCheckDetails,summarizeList,summarizeRecordList,summarizeStringList}from"./health/projection.js";import{runInitAgentGuidance}from"../init-agent-guidance.js";import fs from"node:fs/promises";import path from"node:path";import{resolveTelemetryEnvironmentPolicy}from"../../core/telemetry/policy.js";import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{isTerminalStatus}from"../../core/item/status.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{isFileMissingError,readFileIfExists}from"../../core/fs/fs-utils.js";import{activateExtensions,getActiveExtensionRegistrations,loadExtensions,runActiveOnReadHooks}from"../../core/extensions/index.js";import{collectRegisteredItemFieldNames}from"../../core/extensions/item-fields.js";import{KNOWN_EXTENSION_CAPABILITIES}from"../../core/extensions/loader.js";import{enforceHistoryStreamPolicyForItems}from"../../core/history/history-stream-policy.js";import{scanHistoryDrift}from"../../core/history/drift-scan.js";import{scanLockHealth}from"../../core/lock/lock-gc.js";import{readVectorizationStatusLedger,refreshSemanticEmbeddingsForMutatedItems}from"../../core/search/cache.js";import{resolveEmbeddingProviders,resolveProviderConfigSource}from"../../core/search/providers.js";import{resolveSettingsWithSemanticRuntimeDefaults}from"../../core/search/semantic-defaults.js";import{collectStaleVectorizationIds}from"../../core/search/staleness.js";import{buildVectorizationEmbeddingIdentity,hasVectorizationEmbeddingIdentityChanged}from"../../core/search/vectorization-metadata.js";import{resolveVectorStores}from"../../core/search/vector-stores.js";import{EXIT_CODE,PM_CORE_REQUIRED_SUBDIRS,TYPE_TO_FOLDER}from"../../core/shared/constants.js";import{findFirstMergeConflictMarker}from"../../core/shared/conflict-markers.js";import{PmCliError}from"../../core/shared/errors.js";import{toNonEmptyStringOrUndefined}from"../../core/shared/primitives.js";import{nowIso}from"../../core/shared/time.js";import{parseItemDocument}from"../../core/item/item-format.js";import{BASELINE_ITEM_FORMAT_VERSION,CURRENT_ITEM_FORMAT_VERSION,effectiveItemFormatVersion,scanItemFormatVersions}from"../../core/item/item-format-version.js";import{listAllItemMetadataLight,listAllItemMetadataWithBody}from"../../core/store/item-store.js";import{PM_TELEMETRY_SOURCE_CONTEXT_VALUES,TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,TELEMETRY_SCHEMA_VERSION}from"../../core/telemetry/runtime.js";import{getItemFormatFromPath,getSettingsPath,ITEM_FILE_EXTENSIONS,resolveGlobalPmRoot,resolvePmRoot,resolveWorkspaceRoot}from"../../core/store/paths.js";import{readSettingsWithMetadata}from"../../core/store/settings.js";import{buildRemediationMap,resolveRemediation}from"../../core/diagnostics/remediation.js";import{scanExtensionHostVersions}from"./extension-host-version.js";import{scanHistoryAuthorAttribution}from"../author-attribution.js";import{readManagedExtensionState}from"../extension.js";import{scanProvenanceResolverHealth}from"./provenance-health.js";import{applyStoredExtensionMigrationState}from"../extension/migrations.js";import{inspectExtensionAuthorManifest}from"../extension/author-manifest.js";import{buildCapabilityContractMetadata,buildRegistrationCollisionRemediation,collectUnknownCapabilityGuidance}from"../extension/doctor.js";import{scanStaleInProgressItems}from"./stale-work.js";import{scanTrackedRuntimeCache}from"./tracked-runtime-cache.js";import{buildMergeReceiptEvidenceWarnings,resolveMergeFenceHealthEvidence}from"./health-merge-evidence.js";import{auditMergeDriverConfiguration,findGitWorkspaceRoot}from"../merge/install.js";import{inspectMergeReceiptEvidence,partitionMergeReceipts}from"../merge/receipts.js";import{classifyHistoryMergeReceiptReferences,extractHistoryMergeReceiptDispositions,extractHistoryMergeReceiptReferences}from"./merge-receipt-history.js";import{runHistoryRepair}from"../history-repair.js";import{resolveWorkspaceRelationshipKindRegistry}from"../graph/assembly.js";import{analyzeHierarchyIntegrity}from"../graph/hierarchy-integrity.js";import{buildStatusRoleWarnings,inspectStatusRoleAssignments}from"./status-role-diagnostics.js";const PM_TELEMETRY_SOURCE_CONTEXT_SET=new Set(PM_TELEMETRY_SOURCE_CONTEXT_VALUES),STALE_VECTORIZATION_SUMMARY_LIMIT=25,TELEMETRY_QUEUE_RELATIVE_PATH=path.join("runtime","telemetry","events.jsonl"),TELEMETRY_STATE_RELATIVE_PATH=path.join("runtime","telemetry","state.json"),TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS=2500,TELEMETRY_QUEUE_HIGH_WATER_MARK=500,TELEMETRY_QUEUE_HIGH_RETRY_THRESHOLD=TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS-3,TELEMETRY_SERVER_MAX_SCHEMA_VERSION_HEADERS=["x-pm-telemetry-max-schema-version","x-pm-telemetry-max-version"];function isAdvisoryHealthWarning(warning,requireMergeDrivers=!1){return warning.startsWith("agent_guidance_")||warning.startsWith("telemetry_")||warning.startsWith("history_stream_over_compact_threshold:")||warning.startsWith("integrity_legacy_hierarchy_")||warning.startsWith("stale_in_progress_items:")||warning.startsWith("provenance_resolver_zero_success:")||warning.startsWith("provenance_value_domain_invalid:")||!requireMergeDrivers&&warning.startsWith("merge_driver_configuration_missing:")}function warningCode(value){const normalized=value.trim(),separator=normalized.indexOf(":");return separator===-1?normalized:normalized.slice(0,separator)}function normalizeExtensionNameForMatch(value){return value.trim().toLowerCase()}function isExpectedUnmanagedExtension(name,directory){const normalizedName=normalizeExtensionNameForMatch(name),normalizedDirectory=normalizeExtensionNameForMatch(directory);return normalizedName.startsWith("builtin-")?!0:normalizedDirectory==="beads"||normalizedDirectory==="todos"}async function isDirectory(targetPath){try{return(await fs.stat(targetPath)).isDirectory()}catch{return!1}}async function listStoredItemDocumentIds(pmRoot){const directories=(await fs.readdir(pmRoot,{withFileTypes:!0})).filter(entry=>entry.isDirectory()),filesByDirectory=await Promise.all(directories.map(entry=>fs.readdir(path.join(pmRoot,entry.name),{withFileTypes:!0})));return new Set(filesByDirectory.flatMap(entries=>entries.filter(entry=>entry.isFile()).filter(entry=>ITEM_FILE_EXTENSIONS.some(extension=>entry.name.endsWith(extension))).map(entry=>path.parse(entry.name).name)))}async function inspectHistoryStream(streamPath,itemId,compactPolicy,liveItemIds){const warnings=await runActiveOnReadHooks({path:streamPath,scope:"project"}),needsClassification=itemId!=="_workspace"&&!liveItemIds.has(itemId);if(!compactPolicy.enabled&&!needsClassification)return{warnings,overThreshold:!1,classification:"live"};let raw;try{raw=await fs.readFile(streamPath,"utf8")}catch{return{warnings,overThreshold:!1,classification:"unreadable"}}let classification="live";if(needsClassification){const lastLine=raw.split(/\r?\n/).map(line=>line.trim()).filter(Boolean).at(-1);try{classification=JSON.parse(lastLine??"{}").op==="delete"?"tombstone":"orphaned"}catch{classification="orphaned"}}const entryCount=compactPolicy.enabled?raw.split(/\r?\n/).filter(line=>line.trim().length>0).length:0;return{warnings,overThreshold:compactPolicy.enabled&&entryCount>compactPolicy.max_entries,classification}}async function countHistoryStreams(pmRoot,compactPolicy,liveItemIds){const historyDir=path.join(pmRoot,"history");if(!await isDirectory(historyDir))return{count:0,warnings:[],over_threshold:[],max_entries:null,tombstones:[],orphaned:[]};const historyFiles=(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((left,right)=>left.localeCompare(right)),maxEntries=compactPolicy.enabled?compactPolicy.max_entries:null,warnings=[],overThreshold=[],tombstones=[],orphaned=[];for(const fileName of historyFiles){const streamPath=path.join(historyDir,fileName),itemId=fileName.slice(0,-6),inspection=await inspectHistoryStream(streamPath,itemId,compactPolicy,liveItemIds);warnings.push(...inspection.warnings),inspection.classification==="tombstone"&&tombstones.push(itemId),inspection.classification==="orphaned"&&orphaned.push(itemId),inspection.overThreshold&&overThreshold.push(itemId)}return{count:historyFiles.length,warnings:[...warnings,...overThreshold.map(id=>`history_stream_over_compact_threshold:${id}`),...orphaned.map(id=>`history_orphaned_stream:${id}`)],over_threshold:overThreshold,max_entries:maxEntries,tombstones,orphaned}}function normalizeRelativePath(pmRoot,targetPath){return path.relative(pmRoot,targetPath).replaceAll("\\","/")}async function listItemDocumentPaths(pmRoot,typeToFolder){const folders=[...new Set(Object.values(typeToFolder))].sort((left,right)=>left.localeCompare(right)),itemPaths=[];for(const folder of folders){const directoryPath=path.join(pmRoot,folder);let entries=[];try{entries=await fs.readdir(directoryPath)}catch(error){if(typeof error=="object"&&error!==null&&"code"in error&&isFileMissingError(error))continue;continue}for(const entry of entries)ITEM_FILE_EXTENSIONS.some(extension=>entry.toLowerCase().endsWith(extension))&&itemPaths.push(path.join(directoryPath,entry))}return itemPaths.sort((left,right)=>normalizeRelativePath(pmRoot,left).localeCompare(normalizeRelativePath(pmRoot,right))),itemPaths}function shouldReportHistoryDirectoryUnreadable(error){return!(typeof error=="object"&&error!==null&&"code"in error&&isFileMissingError(error))}async function scanItemIntegrity(pmRoot,typeToFolder,schema){const paths=await listItemDocumentPaths(pmRoot,typeToFolder),unreadable=[],conflictMarkers=[],parseFailures=[],formatVersions=[],extensionFieldNames=collectRegisteredItemFieldNames(getActiveExtensionRegistrations());for(const itemPath of paths){const relativePath=normalizeRelativePath(pmRoot,itemPath);let raw;try{raw=await fs.readFile(itemPath,"utf8")}catch{unreadable.push(relativePath);continue}const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){conflictMarkers.push({path:relativePath,...conflictMarker});continue}try{const parsed=parseItemDocument(raw,{format:getItemFormatFromPath(itemPath),schema,extensionFieldNames});formatVersions.push({ref:relativePath,version:effectiveItemFormatVersion(parsed.metadata)})}catch{parseFailures.push(relativePath)}}return{paths,unreadable,conflictMarkers,parseFailures,formatVersions}}async function scanHistoryIntegrity(pmRoot){const historyDir=path.join(pmRoot,"history"),unreadable=[],conflictMarkers=[],invalidJson=[],mergeReceiptReferences=[],mergeReceiptDispositions=[];let files=[];try{files=(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((left,right)=>left.localeCompare(right))}catch(error){shouldReportHistoryDirectoryUnreadable(error)&&unreadable.push("history")}for(const fileName of files){const itemId=fileName.slice(0,-6);let raw;try{raw=await fs.readFile(path.join(historyDir,fileName),"utf8")}catch{unreadable.push(itemId);continue}const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){conflictMarkers.push({id:itemId,...conflictMarker});continue}raw.split(/\r?\n/).forEach((line,index)=>{if(line.trim())try{const parsed=JSON.parse(line);mergeReceiptReferences.push(...extractHistoryMergeReceiptReferences(parsed,itemId).map(reference=>({itemId,line:index+1,...reference}))),mergeReceiptDispositions.push(...extractHistoryMergeReceiptDispositions(parsed,itemId,index+1))}catch{invalidJson.push({id:itemId,line:index+1})}})}return{files,unreadable,conflictMarkers,invalidJson,mergeReceiptReferences,mergeReceiptDispositions}}function buildHierarchyIntegrityWarnings(analysis){return[...analysis.cycles.map(cycle=>cycle.legacy_terminal?`integrity_legacy_hierarchy_cycle:${cycle.item_ids.join(",")}`:`integrity_hierarchy_cycle:${cycle.item_ids.join(",")}`),...analysis.cardinality_violations.map(finding=>finding.legacy_terminal?`integrity_legacy_hierarchy_cardinality:${finding.child_id}`:`integrity_hierarchy_cardinality:${finding.child_id}`),...analysis.divergences.map(finding=>finding.legacy_terminal?`integrity_legacy_hierarchy_divergence:${finding.child_id}`:`integrity_hierarchy_divergence:${finding.child_id}`)]}async function buildIntegrityCheck(pmRoot,typeToFolder,schema,settings,requireMergeDrivers,items){const itemScan=await scanItemIntegrity(pmRoot,typeToFolder,schema),historyScan=await scanHistoryIntegrity(pmRoot),formatVersionScan=scanItemFormatVersions(itemScan.formatVersions,CURRENT_ITEM_FORMAT_VERSION,BASELINE_ITEM_FORMAT_VERSION),statusRegistry=resolveRuntimeStatusRegistry(schema),hierarchyIntegrity=analyzeHierarchyIntegrity(items,status=>isTerminalStatus(status,statusRegistry),resolveWorkspaceRelationshipKindRegistry()),trackedRuntimeCache=await scanTrackedRuntimeCache(pmRoot),gitWorkspaceRoot=await findGitWorkspaceRoot(pmRoot),mergeFence=await resolveMergeFenceHealthEvidence(pmRoot,gitWorkspaceRoot,settings,requireMergeDrivers),mergeDriverAudit=gitWorkspaceRoot===null?null:await auditMergeDriverConfiguration(gitWorkspaceRoot),mergeReceiptEvidence=await inspectMergeReceiptEvidence(gitWorkspaceRoot??pmRoot,{includeReconciled:!0,includeLossless:!0,pmRoot}),availableMergeReceiptIds=new Set(mergeReceiptEvidence.durable_receipt_ids),historyReceiptClassification=classifyHistoryMergeReceiptReferences(historyScan.mergeReceiptReferences,availableMergeReceiptIds,historyScan.mergeReceiptDispositions),missingMergeReceiptReferences=historyReceiptClassification.missing,pendingMergeReceipts=mergeReceiptEvidence.receipts.filter(receipt=>receipt.state==="pending"),{pendingDecisions:pendingMergeDecisions,lossless:losslessMergeReceipts}=partitionMergeReceipts(pendingMergeReceipts),mergeDriverInstallationMissing=mergeDriverAudit?.status==="missing"&&mergeDriverAudit.missing_keys.length===5&&mergeDriverAudit.drifted_keys.length===0,warnings=[...itemScan.unreadable.map(entry=>`integrity_item_unreadable:${entry}`),...itemScan.conflictMarkers.map(entry=>`integrity_item_conflict_marker:${entry.path}:L${entry.line}`),...itemScan.parseFailures.map(entry=>`integrity_item_parse_failed:${entry}`),...historyScan.unreadable.map(entry=>`integrity_history_unreadable:${entry}`),...historyScan.conflictMarkers.map(entry=>`integrity_history_conflict_marker:${entry.id}:L${entry.line}`),...historyScan.invalidJson.map(entry=>`integrity_history_invalid_json:${entry.id}:L${entry.line}`),...formatVersionScan.outdated.map(entry=>`integrity_item_outdated_format_version:${entry}`),...formatVersionScan.ahead.map(entry=>`integrity_item_ahead_format_version:${entry}`),...buildHierarchyIntegrityWarnings(hierarchyIntegrity),...trackedRuntimeCache.tracked_path_count>0?[`tracked_runtime_cache_files:${trackedRuntimeCache.tracked_path_count}`]:[],...mergeDriverAudit!==null&&mergeDriverAudit.status!=="ok"?[`merge_driver_configuration_${mergeDriverInstallationMissing?"missing":"drift"}:${mergeDriverAudit.missing_keys.length+mergeDriverAudit.drifted_keys.length}`]:[],...mergeFence.warnings,...pendingMergeDecisions.length>0?[`merge_decisions_unreviewed:${pendingMergeDecisions.length}`]:[],...losslessMergeReceipts.length>0?[`merge_receipts_pending:${losslessMergeReceipts.length}`]:[],...buildMergeReceiptEvidenceWarnings({invalidEvidenceCount:mergeReceiptEvidence.invalid_evidence_count,missingHistoryReferenceCount:missingMergeReceiptReferences.length})],normalizedWarnings=[...new Set(warnings)].sort((left,right)=>left.localeCompare(right)),actionableWarnings=normalizedWarnings.filter(warning=>!warning.startsWith("integrity_legacy_hierarchy_"));return{check:{name:"integrity",status:actionableWarnings.length===0?"ok":"warn",ok:actionableWarnings.length===0,details:{checked_item_files:itemScan.paths.length,checked_history_streams:historyScan.files.length,counts:{item_unreadable:itemScan.unreadable.length,item_conflict_markers:itemScan.conflictMarkers.length,item_parse_failures:itemScan.parseFailures.length,history_unreadable:historyScan.unreadable.length,history_conflict_markers:historyScan.conflictMarkers.length,history_invalid_json:historyScan.invalidJson.length,item_outdated_format_version:formatVersionScan.outdated.length,item_ahead_format_version:formatVersionScan.ahead.length,hierarchy_cycles:hierarchyIntegrity.cycles.length,hierarchy_cardinality_violations:hierarchyIntegrity.cardinality_violations.length,hierarchy_parent_divergences:hierarchyIntegrity.divergences.length,tracked_runtime_cache_files:trackedRuntimeCache.tracked_path_count,merge_driver_configuration:mergeDriverAudit===null||mergeDriverAudit.status==="ok"?0:mergeDriverAudit.missing_keys.length+mergeDriverAudit.drifted_keys.length,merge_fence:mergeFence.count,pending_merge_decisions:pendingMergeDecisions.length,lossless_merge_receipts:losslessMergeReceipts.length,invalid_merge_receipt_evidence:mergeReceiptEvidence.invalid_evidence_count,missing_merge_receipt_history_references:missingMergeReceiptReferences.length,accepted_legacy_merge_receipt_references:historyReceiptClassification.acceptedLegacyCount,accepted_missing_merge_receipt_dispositions:historyReceiptClassification.acceptedDispositionCount},item_unreadable:itemScan.unreadable,item_conflict_markers:itemScan.conflictMarkers,item_parse_failures:itemScan.parseFailures,item_outdated_format_version:formatVersionScan.outdated,item_ahead_format_version:formatVersionScan.ahead,hierarchy_integrity:{...hierarchyIntegrity,relations:summarizeRecordList(hierarchyIntegrity.relations,BRIEF_HEALTH_DETAIL_LIMIT)},history_unreadable:historyScan.unreadable,history_conflict_markers:historyScan.conflictMarkers,history_invalid_json:historyScan.invalidJson,tracked_runtime_cache:{tracker_relative_root:trackedRuntimeCache.tracker_relative_root,tracked_paths:trackedRuntimeCache.tracked_paths,tracked_path_count:trackedRuntimeCache.tracked_path_count,remediation_command:trackedRuntimeCache.remediation_command},merge_driver_configuration:mergeDriverAudit===null?null:{...mergeDriverAudit,required:requireMergeDrivers},merge_fence:mergeFence.audit,pending_merge_decision_items:[...new Set(pendingMergeDecisions.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),lossless_merge_receipt_items:[...new Set(losslessMergeReceipts.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),invalid_merge_receipt_evidence_details:mergeReceiptEvidence.invalid_evidence,invalid_merge_receipt_evidence_details_truncated:mergeReceiptEvidence.invalid_evidence_truncated,missing_merge_receipt_history_reference_details:missingMergeReceiptReferences.slice(0,HEALTH_WARNING_LIMIT),missing_merge_receipt_history_reference_details_truncated:missingMergeReceiptReferences.length>HEALTH_WARNING_LIMIT}},warnings:normalizedWarnings,gitWorkspaceRoot,pendingMergeReceipts}}function hasActivateExport(moduleRecord){if(typeof moduleRecord.activate=="function")return!0;const defaultExport=moduleRecord.default;return typeof defaultExport!="object"||defaultExport===null?!1:typeof defaultExport.activate=="function"}function summarizeLoadedExtension(extension){const summary={layer:extension.layer,directory:extension.directory,manifest_path:extension.manifest_path,name:extension.name,version:extension.version,entry:extension.entry,priority:extension.priority,entry_path:extension.entry_path,has_activate:hasActivateExport(extension.module)};return Array.isArray(extension.capabilities)&&(summary.capabilities=[...extension.capabilities]),summary}function resolveMigrationId(definition,fallbackIndex){return toNonEmptyStringOrUndefined(definition.id)||`migration-${String(fallbackIndex+1).padStart(3,"0")}`}function resolveMigrationStatus(definition){const normalized=toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();return normalized==="failed"?"failed":normalized==="applied"?"applied":"pending"}function resolveMigrationFailureReason(definition){return toNonEmptyStringOrUndefined(definition.reason)??toNonEmptyStringOrUndefined(definition.error)??toNonEmptyStringOrUndefined(definition.message)}function compareMigrationEntries(left,right){const byLayer=(left.layer??"").localeCompare(right.layer??"");if(byLayer!==0)return byLayer;const byName=(left.name??"").localeCompare(right.name??"");return byName!==0?byName:(left.id??"").localeCompare(right.id??"")}function summarizeMigrationStatuses(migrations){const applied=[],pending=[],failed=[];migrations.forEach((migration,index)=>{const id=resolveMigrationId(migration.definition,index),status=resolveMigrationStatus(migration.definition);if(status==="applied"){applied.push({layer:migration.layer,name:migration.name,id,status});return}if(status==="failed"){failed.push({layer:migration.layer,name:migration.name,id,status,reason:resolveMigrationFailureReason(migration.definition)});return}pending.push({layer:migration.layer,name:migration.name,id,status})}),applied.sort(compareMigrationEntries),pending.sort(compareMigrationEntries),failed.sort(compareMigrationEntries);const warnings=[...failed.map(entry=>`extension_migration_failed:${entry.layer}:${entry.name}:${entry.id}`),...pending.map(entry=>`extension_migration_pending:${entry.layer}:${entry.name}:${entry.id}`)];return{summary:{applied,pending,failed,applied_count:applied.length,pending_count:pending.length,failed_count:failed.length},warnings}}function buildExtensionHealthTriageSummary(warnings,loadFailureCount,activationFailureCount,migrationStatus,managedStateWarningCount,managedExtensionEntriesCount,unmanagedLoadedExtensions,unmanagedExpectedExtensions,unmanagedActionRequiredExtensions){const normalizedWarnings=[...new Set(warnings)].sort((left,right)=>left.localeCompare(right)),warningCodes=[...new Set(normalizedWarnings.map(value=>warningCode(value)))].sort((left,right)=>left.localeCompare(right)),unknownCapabilityCount=normalizedWarnings.filter(warning=>warning.startsWith("extension_capability_unknown:")).length,updateHealthPartial=unmanagedActionRequiredExtensions.length>0,updateHealthCoverage=updateHealthPartial?"partial":"full",remediation=[],registrationCollisionRemediation=buildRegistrationCollisionRemediation(normalizedWarnings,{deactivate:"pm extension --deactivate <name> --project/--global",doctor:"pm extension --doctor --project/--global --detail deep --trace"});return registrationCollisionRemediation&&remediation.push(registrationCollisionRemediation),loadFailureCount>0&&remediation.push("Run pm extension --explore --project and pm extension --explore --global to inspect load failures."),activationFailureCount>0&&remediation.push("Review checks[name=extensions].details.activation.failed in pm health --json for activation error details."),(migrationStatus.failed_count>0||migrationStatus.pending_count>0)&&remediation.push("Resolve pending/failed extension migrations before write commands; use --force only when policy allows."),managedStateWarningCount>0&&remediation.push("Run pm extension --manage --project and pm extension --manage --global to refresh managed-state diagnostics."),unknownCapabilityCount>0&&remediation.push(`Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`),normalizedWarnings.some(warning=>warning.startsWith("extension_capability_legacy_alias:"))&&remediation.push("Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."),normalizedWarnings.some(warning=>warning.startsWith("extension_command_definition_legacy_handler_alias:"))&&remediation.push("Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."),updateHealthPartial?remediation.push("Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via pm extension --manage --project/--global --fix-managed-state, pm extension --adopt-all --project/--global, or pm extension --adopt <name>."):unmanagedLoadedExtensions.length>0&&remediation.push("Loaded unmanaged extensions are currently treated as informational. Use pm extension --manage --project/--global --fix-managed-state to adopt them for update checks."),remediation.length===0&&remediation.push("No immediate action required. Re-run pm health after extension configuration changes."),{status:normalizedWarnings.length===0?"ok":"warn",warning_count:normalizedWarnings.length,warning_codes:warningCodes,load_failure_count:loadFailureCount,activation_failure_count:activationFailureCount,migration_failed_count:migrationStatus.failed_count,migration_pending_count:migrationStatus.pending_count,managed_state_warning_count:managedStateWarningCount,managed_extension_entries_count:managedExtensionEntriesCount,unmanaged_loaded_extension_count:unmanagedLoadedExtensions.length,unmanaged_loaded_extensions:unmanagedLoadedExtensions,unmanaged_expected_extension_count:unmanagedExpectedExtensions.length,unmanaged_expected_extensions:unmanagedExpectedExtensions,unmanaged_action_required_extension_count:unmanagedActionRequiredExtensions.length,unmanaged_action_required_extensions:unmanagedActionRequiredExtensions,update_health_coverage:updateHealthCoverage,update_health_partial:updateHealthPartial,unknown_capability_count:unknownCapabilityCount,top_warnings:normalizedWarnings.slice(0,8),remediation}}async function buildExtensionCheck(pmRoot,settings,noExtensionsFlag){const authorManifest=await inspectExtensionAuthorManifest(resolveWorkspaceRoot(pmRoot)),loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:noExtensionsFlag}),loadedSummaries=loadResult.loaded.map(extension=>summarizeLoadedExtension(extension)),hostVersionCensus=await scanExtensionHostVersions(loadResult.loaded,resolveWorkspaceRoot(pmRoot)),activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded}),[projectManagedState,globalManagedState]=await Promise.all([readManagedExtensionState(loadResult.roots.project),readManagedExtensionState(loadResult.roots.global)]);await applyStoredExtensionMigrationState(pmRoot,activationResult.registrations.migrations);const migrationStatus=summarizeMigrationStatuses(activationResult.registrations.migrations),activationDetails={failed:activationResult.failed,warnings:activationResult.warnings,hook_counts:activationResult.hook_counts,command_override_count:activationResult.command_override_count,command_handler_count:activationResult.command_handler_count,parser_override_count:activationResult.parser_override_count,preflight_override_count:activationResult.preflight_override_count,service_override_count:activationResult.service_override_count,renderer_override_count:activationResult.renderer_override_count,registration_counts:activationResult.registration_counts,registrations:activationResult.registrations,migration_status:migrationStatus.summary,managed_extensions:{project:{path:projectManagedState.path,count:projectManagedState.state.entries.length,entries:projectManagedState.state.entries},global:{path:globalManagedState.path,count:globalManagedState.state.entries.length,entries:globalManagedState.state.entries}}},managedProjectNames=new Set(projectManagedState.state.entries.map(entry=>normalizeExtensionNameForMatch(entry.name))),managedGlobalNames=new Set(globalManagedState.state.entries.map(entry=>normalizeExtensionNameForMatch(entry.name))),unmanagedLoadedEntries=[...new Map(loadResult.loaded.filter(entry=>!(entry.layer==="project"?managedProjectNames:managedGlobalNames).has(normalizeExtensionNameForMatch(entry.name))).map(entry=>[`${entry.layer}:${entry.name}`,{layer:entry.layer,name:entry.name,directory:entry.directory}])).values()].sort((left,right)=>{const leftKey=`${left.layer}:${left.name}`,rightKey=`${right.layer}:${right.name}`;return leftKey.localeCompare(rightKey)}),unmanagedLoadedExtensions=unmanagedLoadedEntries.map(entry=>`${entry.layer}:${entry.name}`).sort((left,right)=>left.localeCompare(right)),unmanagedExpectedExtensions=unmanagedLoadedEntries.filter(entry=>isExpectedUnmanagedExtension(entry.name,entry.directory)).map(entry=>`${entry.layer}:${entry.name}`).sort((left,right)=>left.localeCompare(right)),unmanagedActionRequiredExtensions=unmanagedLoadedEntries.filter(entry=>!isExpectedUnmanagedExtension(entry.name,entry.directory)).map(entry=>`${entry.layer}:${entry.name}`).sort((left,right)=>left.localeCompare(right)),updateCoverageWarnings=unmanagedActionRequiredExtensions.length>0?[`extension_update_health_partial_coverage:skipped_unmanaged:${unmanagedActionRequiredExtensions.length}`]:[],extensionWarnings=[...authorManifest.warnings,...loadResult.warnings,...activationDetails.warnings,...migrationStatus.warnings,...projectManagedState.warnings,...globalManagedState.warnings,...updateCoverageWarnings,...hostVersionCensus.warnings],capabilityGuidance=collectUnknownCapabilityGuidance(extensionWarnings),capabilityContract=buildCapabilityContractMetadata(),extensionTriage=buildExtensionHealthTriageSummary(extensionWarnings,loadResult.failed.length,activationResult.failed.length,migrationStatus.summary,projectManagedState.warnings.length+globalManagedState.warnings.length,projectManagedState.state.entries.length+globalManagedState.state.entries.length,unmanagedLoadedExtensions,unmanagedExpectedExtensions,unmanagedActionRequiredExtensions);return{check:{name:"extensions",status:extensionWarnings.length===0?"ok":"warn",ok:extensionWarnings.length===0,details:{...loadResult,loaded:loadedSummaries,warnings:extensionWarnings,activation:activationDetails,author_manifest:authorManifest,triage:extensionTriage,...migrationStatus.summary.pending_count>0?{remediation_map:{extension_migration_pending:"pm extension migrate --project"}}:{},capability_contract:capabilityContract,capability_guidance:capabilityGuidance,host_version_census:hostVersionCensus}},warnings:extensionWarnings}}function selectStaleItemDetail(values,verboseStaleItems){if(verboseStaleItems)return{values,truncated:!1,total:values.length};const summary=summarizeList(values,STALE_VECTORIZATION_SUMMARY_LIMIT);return{values:summary.values,truncated:summary.truncated,total:values.length}}function telemetryEnvFlagEnabled(envKey){const value=(process.env[envKey]??"").trim().toLowerCase();return value==="1"||value==="true"||value==="yes"||value==="on"}function telemetrySourceContextOverride(){const value=(process.env.PM_TELEMETRY_SOURCE_CONTEXT??"").trim().toLowerCase();return PM_TELEMETRY_SOURCE_CONTEXT_SET.has(value)?value:null}function normalizeEndpointForDisplay(rawEndpoint){const trimmed=rawEndpoint.trim();if(trimmed.length===0)return"";try{const parsed=new URL(trimmed);return parsed.username="",parsed.password="",parsed.search="",parsed.hash="",parsed.toString()}catch{return trimmed}}function parseTelemetryQueue(raw){let validEntries=0,invalidRows=0,totalRows=0,highRetryEntries=0,maxAttempts=0;for(const line of raw.split(`
-`)){const trimmed=line.trim();if(trimmed.length!==0){totalRows+=1;try{const parsed=JSON.parse(trimmed);if(typeof parsed=="object"&&parsed!==null&&typeof parsed.attempts=="number"&&Number.isFinite(parsed.attempts)){const attempts=Math.max(0,Math.trunc(parsed.attempts));validEntries+=1,maxAttempts=Math.max(maxAttempts,attempts),attempts>=TELEMETRY_QUEUE_HIGH_RETRY_THRESHOLD&&(highRetryEntries+=1)}else invalidRows+=1}catch{invalidRows+=1}}}return{validEntries,invalidRows,totalRows,highRetryEntries,maxAttempts}}function emptyTelemetryQueueSummary(){return{validEntries:0,invalidRows:0,totalRows:0,highRetryEntries:0,maxAttempts:0}}function parseTelemetryRuntimeState(stateRaw){if(!stateRaw||stateRaw.trim().length===0)return{runtimeState:{},stateParseFailed:!1};try{const parsed=JSON.parse(stateRaw);return typeof parsed=="object"&&parsed!==null&&!Array.isArray(parsed)?{runtimeState:parsed,stateParseFailed:!1}:{runtimeState:{},stateParseFailed:!0}}catch{return{runtimeState:{},stateParseFailed:!0}}}async function maybeProbeTelemetryEndpoint(settings,checkTelemetry){const endpoint=settings.telemetry.endpoint.trim();return!checkTelemetry||!settings.telemetry.enabled||endpoint.length===0||resolveTelemetryEnvironmentPolicy().telemetry_disabled?void 0:{attempted:!0,...await probeTelemetryEndpointHealth(endpoint)}}function collectTelemetryQueueWarnings(settings,queueSummary,runtimeState){const warnings=[];if(queueSummary.invalidRows>0&&warnings.push(`telemetry_queue_invalid_rows:${queueSummary.invalidRows}`),!settings.telemetry.enabled||queueSummary.validEntries===0)return warnings;const lastSuccess=runtimeState.last_successful_flush_at,lastFailure=runtimeState.last_failed_flush_at,activeFailure=lastFailure&&(!lastSuccess||lastFailure>lastSuccess),neverFlushed=!lastSuccess,highWater=queueSummary.validEntries>=TELEMETRY_QUEUE_HIGH_WATER_MARK;return(activeFailure||neverFlushed||highWater)&&warnings.push(`telemetry_queue_pending:${queueSummary.validEntries}`),queueSummary.highRetryEntries>0&&warnings.push(`telemetry_queue_high_retries:${queueSummary.highRetryEntries}`),warnings}function collectTelemetryEndpointWarnings(endpointProbe){return!endpointProbe||endpointProbe.ok!==!1?[]:typeof endpointProbe.status=="number"?[`telemetry_endpoint_probe_http_status:${endpointProbe.status}`]:["telemetry_endpoint_probe_failed"]}function collectTelemetrySchemaWarnings(endpointProbe){const parsedMaxSchemaVersion=Number.parseInt(endpointProbe?.max_schema_version??"",10);return endpointProbe?.ok===!0&&Number.isInteger(parsedMaxSchemaVersion)&&parsedMaxSchemaVersion>TELEMETRY_SCHEMA_VERSION?[`telemetry_schema_version_behind:${parsedMaxSchemaVersion}`]:[]}function collectTelemetryOtelWarnings(settings,runtimeState){const pendingOtelSpans=typeof runtimeState.pending_otel_spans=="number"?runtimeState.pending_otel_spans:0,lastOtelSuccess=runtimeState.last_otel_success_at,lastOtelFailure=runtimeState.last_otel_failure_at;return settings.telemetry.enabled&&pendingOtelSpans>0&&lastOtelFailure&&(!lastOtelSuccess||lastOtelFailure>=lastOtelSuccess)?[`telemetry_otel_export_failing:${pendingOtelSpans}`]:[]}function buildTelemetryEnvOverrideDetails(){return{...resolveTelemetryEnvironmentPolicy(),pm_no_telemetry:telemetryEnvFlagEnabled("PM_NO_TELEMETRY"),telemetry_otel_disabled:telemetryEnvFlagEnabled("PM_TELEMETRY_OTEL_DISABLED"),telemetry_inline_flush:telemetryEnvFlagEnabled("PM_TELEMETRY_INLINE_FLUSH"),telemetry_source_context:telemetrySourceContextOverride()}}function telemetryQueueHasEntries(settings,queueSummary){return settings.telemetry.enabled&&queueSummary.validEntries>0}function isTelemetryQueueDraining(queueHasEntries,warnings){return queueHasEntries&&warnings.every(warning=>!warning.startsWith("telemetry_queue_pending:")&&!warning.startsWith("telemetry_queue_high_retries:"))}async function probeTelemetryEndpointHealth(endpoint){let probeUrl=endpoint;try{const parsed=new URL(endpoint);parsed.pathname="/healthz",parsed.search="",parsed.hash="",probeUrl=parsed.toString()}catch{}try{const response=await fetch(probeUrl,{method:"GET",signal:AbortSignal.timeout(TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS)});return{probe_url:normalizeEndpointForDisplay(probeUrl),ok:response.ok,status:response.status,max_schema_version:(()=>{for(const headerName of TELEMETRY_SERVER_MAX_SCHEMA_VERSION_HEADERS){const value=response.headers.get(headerName)?.trim();if(value&&value.length>0)return value}})()}}catch(error){return{probe_url:normalizeEndpointForDisplay(probeUrl),ok:!1,error:error instanceof Error?error.message:"probe_failed"}}}async function buildTelemetryCheck(settings,options){const globalPmRoot=resolveGlobalPmRoot(process.cwd()),queuePath=path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH),statePath=path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH),queueRaw=await readFileIfExists(queuePath),queueExists=queueRaw!==null,queueSizeBytes=queueRaw?Buffer.byteLength(queueRaw,"utf8"):0,queueSummary=queueRaw?parseTelemetryQueue(queueRaw):emptyTelemetryQueueSummary(),stateRaw=await readFileIfExists(statePath),{runtimeState,stateParseFailed}=parseTelemetryRuntimeState(stateRaw),endpoint=settings.telemetry.endpoint.trim(),endpointDisplay=normalizeEndpointForDisplay(endpoint),endpointProbe=await maybeProbeTelemetryEndpoint(settings,options.checkTelemetry),warnings=[];stateParseFailed&&warnings.push("telemetry_state_invalid_json"),warnings.push(...collectTelemetryQueueWarnings(settings,queueSummary,runtimeState),...collectTelemetryEndpointWarnings(endpointProbe),...collectTelemetrySchemaWarnings(endpointProbe),...collectTelemetryOtelWarnings(settings,runtimeState));const queueHasEntries=telemetryQueueHasEntries(settings,queueSummary),pendingOtelSpans=typeof runtimeState.pending_otel_spans=="number"?runtimeState.pending_otel_spans:0;return{check:{name:"telemetry",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{enabled:settings.telemetry.enabled,capture_level:settings.telemetry.capture_level,endpoint:endpointDisplay,global_pm_root:globalPmRoot,queue_path:queuePath,queue_exists:queueExists,queue_entries:queueSummary.validEntries,queue_draining:isTelemetryQueueDraining(queueHasEntries,warnings),queue_invalid_rows:queueSummary.invalidRows,queue_rows_total:queueSummary.totalRows,queue_size_bytes:queueSizeBytes,queue_high_retry_entries:queueSummary.highRetryEntries,queue_high_retry_threshold:TELEMETRY_QUEUE_HIGH_RETRY_THRESHOLD,queue_max_attempts:queueSummary.maxAttempts,runtime_state_path:statePath,last_attempted_flush_at:runtimeState.last_attempted_flush_at??null,last_successful_flush_at:runtimeState.last_successful_flush_at??null,last_failed_flush_at:runtimeState.last_failed_flush_at??null,last_failed_flush_error:runtimeState.last_failed_flush_error??null,pending_otel_spans:pendingOtelSpans,last_otel_attempt_at:runtimeState.last_otel_attempt_at??null,last_otel_success_at:runtimeState.last_otel_success_at??null,last_otel_failure_at:runtimeState.last_otel_failure_at??null,last_otel_failure_error:runtimeState.last_otel_failure_error??null,endpoint_probe:endpointProbe??{attempted:!1},env_overrides:buildTelemetryEnvOverrideDetails()}},warnings}}async function buildLocksCheck(pmRoot){let scan;try{scan=await scanLockHealth(pmRoot)}catch(error){const message=error instanceof Error?error.message:String(error);return{check:{name:"locks",status:"warn",ok:!1,details:{active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0,scan_failed:!0,error:message,pm_root:pmRoot}},warnings:[`locks_scan_failed:${message}`]}}const warnings=[];return scan.stale_lock_count>0&&warnings.push(`locks_stale_count:${scan.stale_lock_count}`),scan.unreadable_lock_count>0&&warnings.push(`locks_unreadable:${scan.unreadable_lock_count}`),{check:{name:"locks",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{active_lock_count:scan.active_lock_count,stale_lock_count:scan.stale_lock_count,unreadable_lock_count:scan.unreadable_lock_count,unparseable_lock_count:scan.unparseable_lock_count}},warnings}}async function buildHistoryDriftCheck(params){const cacheHitVerification="metadata";let items=params.items,drift=await scanHistoryDrift(params.pmRoot,items,{cacheHitVerification});const cacheConfirmationCandidates=[...new Set([...drift.hashMismatches,...drift.chainMismatches,...drift.versionSkews])].sort((left,right)=>left.localeCompare(right));let confirmedItems=[],resolvedFalsePositiveItems=[];if(cacheConfirmationCandidates.length>0){items=await listAllItemMetadataWithBody(params.pmRoot,params.settings.item_format,params.typeRegistry.type_to_folder,params.itemReadWarnings,params.settings.schema,{forceSourceScan:!0}),drift=await scanHistoryDrift(params.pmRoot,items),confirmedItems=[...new Set([...drift.hashMismatches,...drift.chainMismatches,...drift.versionSkews])].sort((left,right)=>left.localeCompare(right));const confirmedSet=new Set(confirmedItems);resolvedFalsePositiveItems=cacheConfirmationCandidates.filter(id=>!confirmedSet.has(id))}const{missingStreams,unreadableStreams,hashMismatches,chainMismatches,versionSkews,driftedItems,workspaceStateMismatches,workspaceStateMissing,workspaceStateUnreadable}=drift,warnings=[...missingStreams.map(id=>`history_drift_missing_stream:${id}`),...unreadableStreams.map(id=>`history_drift_unreadable_stream:${id}`),...hashMismatches.map(id=>`history_drift_hash_mismatch:${id}`),...chainMismatches.map(id=>`history_drift_chain_mismatch:${id}`),...versionSkews.map(id=>`history_drift_version_skew:${id}`),...workspaceStateMismatches.map(documentPath=>`history_drift_workspace_state_mismatch:${documentPath}`),...workspaceStateMissing.map(documentPath=>`history_drift_workspace_state_missing:${documentPath}`),...workspaceStateUnreadable.map(documentPath=>`history_drift_workspace_state_unreadable:${documentPath}`)];return{check:{name:"history_drift",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{checked_items:items.length,cache_hit_verification:cacheConfirmationCandidates.length>0?"metadata_then_content_hash":cacheHitVerification,cache_confirmation:{triggered:cacheConfirmationCandidates.length>0,reason:cacheConfirmationCandidates.length>0?"cached_corruption_candidate":null,candidate_items:cacheConfirmationCandidates,confirmed_items:confirmedItems,resolved_false_positive_items:resolvedFalsePositiveItems,authoritative_item_source:cacheConfirmationCandidates.length>0},drifted_items:driftedItems,counts:{drifted:driftedItems.length,missing_streams:missingStreams.length,unreadable_streams:unreadableStreams.length,hash_mismatches:hashMismatches.length,chain_mismatches:chainMismatches.length,version_skews:versionSkews.length,workspace_state_mismatches:workspaceStateMismatches.length,workspace_state_missing:workspaceStateMissing.length,workspace_state_unreadable:workspaceStateUnreadable.length},missing_streams:missingStreams,unreadable_streams:unreadableStreams,hash_mismatches:hashMismatches,chain_mismatches:chainMismatches,version_skews:versionSkews,workspace_state_mismatches:workspaceStateMismatches,workspace_state_missing:workspaceStateMissing,workspace_state_unreadable:workspaceStateUnreadable}},warnings}}function buildVectorizationRuntimeSnapshot(settings,pmRoot){const runtimeDefaults=resolveSettingsWithSemanticRuntimeDefaults(settings),providerResolution=resolveEmbeddingProviders(runtimeDefaults.settings),vectorStoreResolution=resolveVectorStores(runtimeDefaults.settings,pmRoot),runtimeEmbeddingIdentity=providerResolution.active?buildVectorizationEmbeddingIdentity(providerResolution.active.name,providerResolution.active.model):null;return{runtimeDefaults,providerResolution,vectorStoreResolution,runtimeEmbeddingIdentity,semanticRuntimeAvailable:!!(providerResolution.active&&vectorStoreResolution.active)}}function emptyVectorizationRefreshResult(){return{refreshed:[],skipped:[],warnings:[]}}async function refreshStaleVectorizationItems(params){return!params.refreshPolicy.enabled||!params.snapshot.semanticRuntimeAvailable||params.staleBefore.length===0?emptyVectorizationRefreshResult():refreshSemanticEmbeddingsForMutatedItems(params.pmRoot,params.staleBefore,{settings:params.snapshot.runtimeDefaults.settings,apply_runtime_defaults:!1})}function vectorizationEmbeddingIdentityChanged(params){return params.strictVectorizationWarnings&&params.semanticRuntimeAvailable&&!!(params.ledgerBefore.embedding&&params.runtimeEmbeddingIdentity&&hasVectorizationEmbeddingIdentityChanged(params.ledgerBefore.embedding,params.runtimeEmbeddingIdentity))}function collectVectorizationWarnings(params){const warningSet=new Set([...params.ledgerBefore.warnings,...params.ledgerAfter.warnings]);if(params.strictVectorizationWarnings)for(const warning of params.refreshResult.warnings)warningSet.add(warning);return params.embeddingIdentityChanged&&warningSet.add("vectorization_embedding_identity_changed"),params.strictVectorizationWarnings&&params.semanticRuntimeAvailable&&params.staleAfter.length>0&&warningSet.add(`vectorization_stale_items_remaining:${params.staleAfter.length}`),[...warningSet].sort((left,right)=>left.localeCompare(right))}function resolveVectorizationRefreshSkippedReason(refreshPolicy,semanticRuntimeAvailable,staleBefore){return refreshPolicy.enabled&&semanticRuntimeAvailable&&staleBefore.length>0?null:refreshPolicy.enabled?semanticRuntimeAvailable?"no_stale_items":"semantic_runtime_unavailable":"refresh_disabled"}function buildVectorizationProviderDetails(settings,snapshot){const activeProvider=snapshot.providerResolution.active?.name??null,activeVectorStore=snapshot.vectorStoreResolution.active?.name??null;return{provider_active:activeProvider,provider_configured:typeof settings.search?.provider=="string"?settings.search.provider:null,provider_source:resolveProviderConfigSource(activeProvider,settings.search?.provider??null),vector_store_active:activeVectorStore,vector_store_configured:typeof settings.vector_store?.adapter=="string"?settings.vector_store.adapter:null,vector_store_source:resolveProviderConfigSource(activeVectorStore,settings.vector_store?.adapter??null)}}function buildVectorizationRefreshPolicyDetails(refreshPolicy){return{enabled:refreshPolicy.enabled,check_only:refreshPolicy.checkOnly,no_refresh:refreshPolicy.noRefresh,refresh_vectors:refreshPolicy.refreshVectors}}function vectorizationRefreshAttempted(refreshPolicy,semanticRuntimeAvailable,staleBefore){return refreshPolicy.enabled&&staleBefore.length>0&&semanticRuntimeAvailable}async function buildVectorizationCheck(pmRoot,settings,items,refreshPolicy,verboseStaleItems){const snapshot=buildVectorizationRuntimeSnapshot(settings,pmRoot),ledgerBefore=await readVectorizationStatusLedger(pmRoot),staleBefore=snapshot.semanticRuntimeAvailable?collectStaleVectorizationIds(items,ledgerBefore.entries):[],refreshResult=await refreshStaleVectorizationItems({pmRoot,snapshot,refreshPolicy,staleBefore}),ledgerAfter=await readVectorizationStatusLedger(pmRoot),staleAfter=snapshot.semanticRuntimeAvailable?collectStaleVectorizationIds(items,ledgerAfter.entries):[],strictVectorizationWarnings=!snapshot.runtimeDefaults.auto_ollama_defaults_applied,embeddingIdentityChanged=vectorizationEmbeddingIdentityChanged({strictVectorizationWarnings,semanticRuntimeAvailable:snapshot.semanticRuntimeAvailable,ledgerBefore,runtimeEmbeddingIdentity:snapshot.runtimeEmbeddingIdentity}),warnings=collectVectorizationWarnings({ledgerBefore,ledgerAfter,refreshResult,strictVectorizationWarnings,semanticRuntimeAvailable:snapshot.semanticRuntimeAvailable,embeddingIdentityChanged,staleAfter}),staleBeforeDetail=selectStaleItemDetail(staleBefore,verboseStaleItems),staleAfterDetail=selectStaleItemDetail(staleAfter,verboseStaleItems),refreshAttempted=vectorizationRefreshAttempted(refreshPolicy,snapshot.semanticRuntimeAvailable,staleBefore);return{check:{name:"vectorization",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{semantic_runtime_available:snapshot.semanticRuntimeAvailable,compatibility_mode_auto_defaults:snapshot.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_applied:snapshot.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_skipped_reason:snapshot.runtimeDefaults.auto_ollama_defaults_skipped_reason??null,auto_ollama_defaults_remediation:snapshot.runtimeDefaults.auto_ollama_defaults_remediation??null,refresh_policy:buildVectorizationRefreshPolicyDetails(refreshPolicy),...buildVectorizationProviderDetails(settings,snapshot),embedding_identity_changed:embeddingIdentityChanged,embedding_identity_before:ledgerBefore.embedding??null,embedding_identity_runtime:snapshot.runtimeEmbeddingIdentity??null,items:items.length,ledger_entries_before:Object.keys(ledgerBefore.entries).length,stale_items_detail_mode:verboseStaleItems?"full":"summary",stale_items_summary_limit:STALE_VECTORIZATION_SUMMARY_LIMIT,stale_items_before_total:staleBeforeDetail.total,stale_items_before:staleBeforeDetail.values,stale_items_before_truncated:staleBeforeDetail.truncated,refresh_attempted:refreshAttempted,refresh_skipped_reason:resolveVectorizationRefreshSkippedReason(refreshPolicy,snapshot.semanticRuntimeAvailable,staleBefore),refresh_result:refreshResult,ledger_entries_after:Object.keys(ledgerAfter.entries).length,stale_items_after_total:staleAfterDetail.total,stale_items_after:staleAfterDetail.values,stale_items_after_truncated:staleAfterDetail.truncated}},warnings}}function validateSettingsValues(settings){const warnings=[];return settings.id_prefix.trim().length===0&&warnings.push("settings:id_prefix_empty"),settings.locks.ttl_seconds<=0&&warnings.push("settings:locks_ttl_non_positive"),warnings}function resolveVectorRefreshPolicy(options){const checkOnly=options.checkOnly===!0,refreshVectors=options.refreshVectors===!0;if(refreshVectors&&checkOnly)throw new PmCliError("--check-only cannot be combined with --refresh-vectors",EXIT_CODE.USAGE);if(refreshVectors&&options.noRefresh===!0)throw new PmCliError("--no-refresh cannot be combined with --refresh-vectors",EXIT_CODE.USAGE);return{enabled:refreshVectors,checkOnly,noRefresh:!refreshVectors,refreshVectors}}const HEALTH_CLONE_OPTIONAL_DIRECTORIES=new Set(["extensions","locks","search"]);function resolveHealthDirectoryLists(typeRegistry){const requiredDirSet=new Set(PM_CORE_REQUIRED_SUBDIRS.filter(entry=>entry.length>0)),optionalDirSet=new Set,builtinItemFolderSet=new Set(Object.values(TYPE_TO_FOLDER));for(const folder of typeRegistry.folders)requiredDirSet.has(folder)&&!builtinItemFolderSet.has(folder)||(requiredDirSet.delete(folder),optionalDirSet.add(folder));for(const folder of HEALTH_CLONE_OPTIONAL_DIRECTORIES)requiredDirSet.delete(folder),optionalDirSet.add(folder);return{requiredDirs:[...requiredDirSet].sort((left,right)=>left.localeCompare(right)),optionalDirs:[...optionalDirSet].sort((left,right)=>left.localeCompare(right)),optionalDirSet}}async function scanHealthDirectories(pmRoot,typeRegistry,strictDirectories){const{requiredDirs,optionalDirs,optionalDirSet}=resolveHealthDirectoryLists(typeRegistry),missingRequiredDirs=[],missingOptionalDirs=[],hookWarnings=[];for(const relativeDir of[...requiredDirs,...optionalDirs]){const directoryPath=path.join(pmRoot,relativeDir);hookWarnings.push(...await runActiveOnReadHooks({path:directoryPath,scope:"project"})),!await isDirectory(directoryPath)&&(optionalDirSet.has(relativeDir)?missingOptionalDirs.push(relativeDir):missingRequiredDirs.push(relativeDir))}return{requiredDirs,optionalDirs,missingRequiredDirs,missingOptionalDirs,missingDirs:strictDirectories?[...missingRequiredDirs,...missingOptionalDirs]:[...missingRequiredDirs],hookWarnings}}function resolveHealthSkipPolicy(options){const checkOnlyDefaultSummary=options.checkOnly===!0&&options.brief!==!0&&options.summary!==!0&&options.full!==!0,summaryMode=(options.summary===!0||checkOnlyDefaultSummary)&&options.full!==!0,fastProjectionCheckOnly=options.checkOnly===!0&&(options.brief===!0||options.summary===!0)&&options.full!==!0;return{summaryMode,skipIntegrity:(options.skipIntegrity===!0||fastProjectionCheckOnly)&&options.full!==!0,skipDrift:(options.skipDrift===!0||fastProjectionCheckOnly)&&options.full!==!0,skipVectors:(options.skipVectors===!0||fastProjectionCheckOnly)&&options.full!==!0}}async function readHealthItems(params){return params.skipPolicy.skipDrift&&params.skipPolicy.skipVectors?listAllItemMetadataLight(params.pmRoot,params.settings.item_format,params.typeRegistry.type_to_folder,params.itemReadWarnings,params.settings.schema):listAllItemMetadataWithBody(params.pmRoot,params.settings.item_format,params.typeRegistry.type_to_folder,params.itemReadWarnings,params.settings.schema)}function buildSkippedHealthCheck(name){return{check:{name,status:"ok",ok:!0,details:{skipped:!0}},warnings:[]}}function buildSettingsHealthCheck(settingsPath,settings,normalizedSettingsReadWarnings){return{name:"settings",status:normalizedSettingsReadWarnings.length===0?"ok":"warn",ok:normalizedSettingsReadWarnings.length===0,details:{path:settingsPath,version:settings.version,id_prefix:settings.id_prefix,locks_ttl_seconds:settings.locks.ttl_seconds,warnings:normalizedSettingsReadWarnings}}}function buildDirectoriesHealthCheck(directoryState,strictDirectories){return{name:"directories",status:directoryState.missingDirs.length===0?"ok":"warn",ok:directoryState.missingDirs.length===0,details:{required:directoryState.requiredDirs,optional:directoryState.optionalDirs,missing_required:directoryState.missingRequiredDirs,missing_optional:directoryState.missingOptionalDirs,missing:directoryState.missingDirs,strict_directories:strictDirectories}}}function buildSettingsValuesHealthCheck(settingWarnings,statusRoleDiagnostics){return{name:"settings_values",status:settingWarnings.length===0?"ok":"warn",ok:settingWarnings.length===0,details:{warnings:settingWarnings,...statusRoleDiagnostics.roleless_status_count>0?{lifecycle_status_roles:statusRoleDiagnostics}:{}}}}const resolveUnknownAuthorEventCount=authorAttribution=>authorAttribution.unknown_event_count??0,resolveActionableUnknownAuthorEventCount=authorAttribution=>authorAttribution.actionable_unknown_event_count??resolveUnknownAuthorEventCount(authorAttribution);function buildStorageHealthCheck(items,settings,historySummary,authorAttribution,staleInProgress,provenance){const unknownAuthorEventCount=resolveUnknownAuthorEventCount(authorAttribution),actionableUnknownAuthorEventCount=resolveActionableUnknownAuthorEventCount(authorAttribution),hasAuthorEvents=unknownAuthorEventCount>0,hasActionableAuthorWarnings=actionableUnknownAuthorEventCount>0,hasStaleInProgressItems=staleInProgress.count>0;return{name:"storage",status:historySummary.over_threshold.length===0&&historySummary.orphaned.length===0&&!hasActionableAuthorWarnings&&!hasStaleInProgressItems?"ok":"warn",ok:historySummary.over_threshold.length===0&&historySummary.orphaned.length===0&&!hasActionableAuthorWarnings&&!hasStaleInProgressItems,details:{items:items.length,history_streams:historySummary.count,tombstones:{retention_policy:"retain_append_only",gc_enabled:!1,count:historySummary.tombstones.length,ids:historySummary.tombstones.slice(0,25),truncated:historySummary.tombstones.length>25},orphaned_history_streams:{count:historySummary.orphaned.length,ids:historySummary.orphaned.slice(0,25),truncated:historySummary.orphaned.length>25},...hasAuthorEvents?{author_attribution:authorAttribution}:{},...hasStaleInProgressItems?{stale_in_progress:staleInProgress}:{},...provenance.outcomes.length>0?{provenance_resolver_outcomes:provenance.outcomes}:{},...provenance.invalid_values.length>0?{provenance_invalid_values:provenance.invalid_values}:{},provenance_sample:provenance.sample,...historySummary.max_entries!==null?{compact_policy:{enabled:settings.history.compact_policy.enabled,max_entries:historySummary.max_entries,trigger:settings.history.compact_policy.trigger,over_threshold_count:historySummary.over_threshold.length,over_threshold:historySummary.over_threshold}}:{}}}}function buildStaleInProgressHealthSummary(scan){const warnings=scan.count===0?[]:[`stale_in_progress_items:${scan.count}`];return{scan,warnings}}function collectHealthWarnings(params){const warnings=[...params.directoryState.missingDirs.map(dir=>`missing_directory:${dir}`),...params.normalizedSettingsReadWarnings,...params.settingWarnings,...params.normalizedItemReadWarnings,...params.telemetryCheck.warnings,...params.extensionCheck.warnings,...params.historyPolicyWarnings,...params.historySummary.warnings,...params.authorAttributionWarnings,...params.staleInProgressWarnings,...params.provenanceWarnings,...params.locksCheck.warnings,...params.integrityCheck.warnings,...params.historyDriftCheck.warnings,...params.vectorizationCheck.warnings,...params.directoryState.hookWarnings];return[...new Set(warnings)]}function extractHistoryDriftedCount(historyDriftCheck){const counts=historyDriftCheck.check.details.counts;return typeof counts?.drifted=="number"?counts.drifted:0}function buildHealthRemediationSources(params){return{settings:params.normalizedSettingsReadWarnings,directories:params.directoryState.missingDirs.map(dir=>`missing_directory:${dir}`).concat(params.directoryState.hookWarnings),settings_values:params.settingWarnings,telemetry:params.telemetryCheck.warnings,extensions:params.extensionCheck.warnings,storage:[...params.historyPolicyWarnings,...params.historySummary.warnings,...params.authorAttributionWarnings,...params.staleInProgressWarnings,...params.provenanceWarnings],locks:params.locksCheck.warnings,integrity:[...params.normalizedItemReadWarnings,...params.integrityCheck.warnings],history_drift:params.historyDriftCheck.warnings,vectorization:params.vectorizationCheck.warnings}}function buildHealthFindings(params){const owners=new Map;for(const[check,warnings]of Object.entries(params.remediationSources))for(const warning of warnings)owners.has(warning)||owners.set(warning,check);const checksByName=new Map(params.checks.map(check=>[check.name,check]));return params.warnings.map(warning=>{const check=owners.get(warning)??"integrity",code=resolveRemediation(warning)?.code??warningCode(warning),details=checksByName.get(check)?.details,remediationMap=typeof details?.remediation_map=="object"&&details.remediation_map!==null?details.remediation_map:{},remediation=code==="agent_guidance_outdated"?"pm init --agent-guidance add":code==="agent_guidance_unreadable"?"Check AGENTS.md and CLAUDE.md read permissions and file types, then retry pm health.":remediationMap[code],severity=isAdvisoryHealthWarning(warning,params.requireMergeDrivers)?"advisory":"gate_failing";return{warning,code,check,severity,...typeof remediation=="string"?{remediation}:severity==="gate_failing"?{disposition:"no_safe_automatic_remediation"}:{}}})}function rewriteBulkHealthRemediation(params){if(params.check.name==="history_drift"&&params.historyDriftedCount>1)for(const code of Object.keys(params.remediationMap))code!=="history_drift_merge_receipt"&&code!=="history_drift_version_skew"&&(params.remediationMap[code]="pm history-repair --all");if(params.check.name==="storage"&&params.overThresholdCount>1)for(const code of Object.keys(params.remediationMap))params.remediationMap[code]="pm history-compact --all-streams"}function attachHealthRemediationMaps(params){for(const check of params.checks){const remediationMap=buildRemediationMap(params.remediationSources[check.name]);rewriteBulkHealthRemediation({check,remediationMap,historyDriftedCount:params.historyDriftedCount,overThresholdCount:params.overThresholdCount}),Object.keys(remediationMap).length>0&&(check.details={...check.details,remediation_map:remediationMap})}}async function correlateMergeReceiptHistoryDriftItems(params){if(params.gitWorkspaceRoot===null||params.pendingMergeReceipts.length===0)return[];const details=params.historyDriftCheck.check.details,hashMismatches=Array.isArray(details.hash_mismatches)?details.hash_mismatches.filter(entry=>typeof entry=="string"):[],unsafeStreamIds=new Set([details.missing_streams,details.unreadable_streams,details.chain_mismatches].flatMap(value=>Array.isArray(value)?value:[])),receiptsByItem=new Map;for(const receipt of params.pendingMergeReceipts){const receipts=receiptsByItem.get(receipt.item_id)??[];receipts.push(receipt),receiptsByItem.set(receipt.item_id,receipts)}const attributed=[];for(const id of hashMismatches){if(unsafeStreamIds.has(id))continue;const receipts=receiptsByItem.get(id);if(!(!receipts||receipts.length===0))try{await runHistoryRepair(id,{dryRun:!0,mergeReceiptProof:{gitWorkspaceRoot:params.gitWorkspaceRoot,receipts}},params.global),attributed.push(id)}catch{}}return[...new Set(attributed)].sort((left,right)=>left.localeCompare(right))}function applyMergeReceiptHistoryDriftAttribution(historyDriftCheck,attributedItems){const attributed=new Set(attributedItems);historyDriftCheck.warnings=[...historyDriftCheck.warnings.filter(warning=>warning.startsWith("history_drift_hash_mismatch:")?!attributed.has(warning.slice(warning.indexOf(":")+1)):!0),...attributedItems.map(id=>`history_drift_merge_receipt:${id}`)].sort((left,right)=>left.localeCompare(right)),historyDriftCheck.check.details={...historyDriftCheck.check.details,merge_receipt_attributed_items:attributedItems}}async function runHealth(global2,options={}){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settingsPath=getSettingsPath(pmRoot),{settings,warnings:settingsReadWarnings}=await readSettingsWithMetadata(pmRoot),normalizedSettingsReadWarnings=[...new Set(settingsReadWarnings)],typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()),strictDirectories=options.strictDirectories===!0,strictExit=options.strictExit===!0||options.failOnWarn===!0,requireMergeDrivers=options.requireMergeDrivers===!0||strictExit,refreshPolicy=resolveVectorRefreshPolicy(options),directoryState=await scanHealthDirectories(pmRoot,typeRegistry,strictDirectories),settingsValueWarnings=validateSettingsValues(settings),telemetryCheck=await buildTelemetryCheck(settings,{checkTelemetry:options.checkTelemetry===!0}),extensionCheck=await buildExtensionCheck(pmRoot,settings,!!global2.noExtensions),skipPolicy=resolveHealthSkipPolicy(options),itemReadWarnings=[],items=await readHealthItems({pmRoot,settings,typeRegistry,skipPolicy,itemReadWarnings}),itemsWithBody=items,statusRoleDiagnostics=inspectStatusRoleAssignments(resolveRuntimeStatusRegistry(settings.schema),items),settingWarnings=[...(await runInitAgentGuidance({pm_root:pmRoot,cwd:process.cwd(),mode:"status",interactive:!1,settings}).catch(()=>({warnings:["agent_guidance_unreadable:AGENTS.md,CLAUDE.md"]}))).warnings.filter(warning=>warning.startsWith("agent_guidance_")),...settingsValueWarnings,...buildStatusRoleWarnings(statusRoleDiagnostics)],historyPolicy=skipPolicy.skipDrift?{warnings:[]}:await enforceHistoryStreamPolicyForItems({pmRoot,settings,itemIds:items.map(item=>item.id),commandLabel:"health"}),historySummary=await countHistoryStreams(pmRoot,settings.history.compact_policy,await listStoredItemDocumentIds(pmRoot)),authorAttribution=await scanHistoryAuthorAttribution(pmRoot,20,options.verboseAuthorEvents===!0),actionableUnknownAuthorEventCount=resolveActionableUnknownAuthorEventCount(authorAttribution),authorAttributionWarnings=actionableUnknownAuthorEventCount>0?[`history_unknown_author_events:${actionableUnknownAuthorEventCount}`]:[],staleInProgress=buildStaleInProgressHealthSummary(await scanStaleInProgressItems(pmRoot,items,{in_progress_status:settings.schema.workflow.in_progress_status,threshold_hours:settings.mutation_guard.stale_in_progress_hours})),provenanceResolverHealth=await scanProvenanceResolverHealth(pmRoot),provenanceWarnings=provenanceResolverHealth.warnings,locksCheck=await buildLocksCheck(pmRoot),integrityCheck=skipPolicy.skipIntegrity&&!requireMergeDrivers?{...buildSkippedHealthCheck("integrity"),gitWorkspaceRoot:null,pendingMergeReceipts:[]}:await buildIntegrityCheck(pmRoot,typeRegistry.type_to_folder,settings.schema,settings,requireMergeDrivers,items),historyDriftCheck=skipPolicy.skipDrift?buildSkippedHealthCheck("history_drift"):await buildHistoryDriftCheck({pmRoot,items:itemsWithBody,settings,typeRegistry,itemReadWarnings}),normalizedItemReadWarnings=[...new Set(itemReadWarnings)],mergeReceiptAttributedHistoryDriftItems=await correlateMergeReceiptHistoryDriftItems({gitWorkspaceRoot:integrityCheck.gitWorkspaceRoot,pendingMergeReceipts:integrityCheck.pendingMergeReceipts,historyDriftCheck,global:global2});applyMergeReceiptHistoryDriftAttribution(historyDriftCheck,mergeReceiptAttributedHistoryDriftItems);const vectorizationCheck=skipPolicy.skipVectors?buildSkippedHealthCheck("vectorization"):await buildVectorizationCheck(pmRoot,settings,itemsWithBody,refreshPolicy,options.verboseStaleItems===!0),checks=[buildSettingsHealthCheck(settingsPath,settings,normalizedSettingsReadWarnings),buildDirectoriesHealthCheck(directoryState,strictDirectories),buildSettingsValuesHealthCheck(settingWarnings,statusRoleDiagnostics),telemetryCheck.check,extensionCheck.check,buildStorageHealthCheck(items,settings,historySummary,authorAttribution,staleInProgress.scan,provenanceResolverHealth),locksCheck.check,integrityCheck.check,historyDriftCheck.check,vectorizationCheck.check],normalizedWarnings=collectHealthWarnings({directoryState,normalizedSettingsReadWarnings,settingWarnings,normalizedItemReadWarnings,telemetryCheck,extensionCheck,historyPolicyWarnings:historyPolicy.warnings,historySummary,authorAttributionWarnings,staleInProgressWarnings:staleInProgress.warnings,provenanceWarnings,locksCheck,integrityCheck,historyDriftCheck,vectorizationCheck}),remediationSources=buildHealthRemediationSources({directoryState,normalizedSettingsReadWarnings,settingWarnings,normalizedItemReadWarnings,telemetryCheck,extensionCheck,historyPolicyWarnings:historyPolicy.warnings,historySummary,authorAttributionWarnings,staleInProgressWarnings:staleInProgress.warnings,provenanceWarnings,locksCheck,integrityCheck,historyDriftCheck,vectorizationCheck});attachHealthRemediationMaps({checks,remediationSources,historyDriftedCount:extractHistoryDriftedCount(historyDriftCheck),overThresholdCount:historySummary.over_threshold.length});const blockingWarnings=normalizedWarnings.filter(warning=>!isAdvisoryHealthWarning(warning,requireMergeDrivers)),findings=buildHealthFindings({warnings:normalizedWarnings,checks,remediationSources,requireMergeDrivers}),failingChecks=new Set(findings.filter(finding=>finding.severity==="gate_failing").map(finding=>finding.check)),warningChecks=new Set(findings.map(finding=>finding.check));for(const check of checks)check.ok=!failingChecks.has(check.name),warningChecks.has(check.name)&&(check.status="warn");const result={ok:blockingWarnings.length===0,verdict:{authority:"ok",...strictExit?{strict_exit:!0}:{},...requireMergeDrivers?{require_merge_drivers:!0}:{},exit_code:strictExit&&blockingWarnings.length>0?EXIT_CODE.GENERIC_FAILURE:0},checks,warnings:normalizedWarnings,findings,failed_because:blockingWarnings,generated_at:nowIso()};return projectHealthResult(result,options,skipPolicy.summaryMode)}const _testOnlyHealthCommand={buildHierarchyIntegrityWarnings,buildExtensionHealthTriageSummary,buildHealthFindings,buildCapabilityContractMetadata,buildStaleInProgressHealthSummary,buildVectorizationProviderDetails,collectUnknownCapabilityGuidance,isAdvisoryHealthWarning,isDirectory,isExpectedUnmanagedExtension,listItemDocumentPaths,normalizeEndpointForDisplay,normalizeExtensionNameForMatch,parseTelemetryQueue,probeTelemetryEndpointHealth,projectHealthResult,resolveActionableUnknownAuthorEventCount,resolveHealthSkipPolicy,resolveUnknownAuthorEventCount,resolveVectorRefreshPolicy,selectStaleItemDetail,summarizeHealthCheckDetails,summarizeExtensionList,summarizeRecordList,summarizeStringList,telemetryEnvFlagEnabled,warningCode};export{_testOnlyHealthCommand,runHealth};
+(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]="29e94aff-b6c9-588b-afcb-b571bdb5804e")}catch{}})();import{BRIEF_HEALTH_DETAIL_LIMIT,HEALTH_WARNING_LIMIT,projectHealthResult,summarizeExtensionList,summarizeHealthCheckDetails,summarizeList,summarizeRecordList,summarizeStringList}from"./health/projection.js";import{runInitAgentGuidance}from"../init-agent-guidance.js";import fs from"node:fs/promises";import path from"node:path";import{resolveTelemetryEnvironmentPolicy}from"../../core/telemetry/policy.js";import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{isTerminalStatus}from"../../core/item/status.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{isFileMissingError,readFileIfExists}from"../../core/fs/fs-utils.js";import{activateExtensions,getActiveExtensionRegistrations,loadExtensions,runActiveOnReadHooks}from"../../core/extensions/index.js";import{collectRegisteredItemFieldNames}from"../../core/extensions/item-fields.js";import{KNOWN_EXTENSION_CAPABILITIES}from"../../core/extensions/loader.js";import{enforceHistoryStreamPolicyForItems}from"../../core/history/history-stream-policy.js";import{scanHistoryDrift}from"../../core/history/drift-scan.js";import{scanLockHealth}from"../../core/lock/lock-gc.js";import{readVectorizationStatusLedger,refreshSemanticEmbeddingsForMutatedItems}from"../../core/search/cache.js";import{resolveEmbeddingProviders,resolveProviderConfigSource}from"../../core/search/providers.js";import{resolveSettingsWithSemanticRuntimeDefaults}from"../../core/search/semantic-defaults.js";import{collectStaleVectorizationIds}from"../../core/search/staleness.js";import{buildVectorizationEmbeddingIdentity,hasVectorizationEmbeddingIdentityChanged}from"../../core/search/vectorization-metadata.js";import{resolveVectorStores}from"../../core/search/vector-stores.js";import{EXIT_CODE,PM_CORE_REQUIRED_SUBDIRS,TYPE_TO_FOLDER}from"../../core/shared/constants.js";import{findFirstMergeConflictMarker}from"../../core/shared/conflict-markers.js";import{PmCliError}from"../../core/shared/errors.js";import{toNonEmptyStringOrUndefined}from"../../core/shared/primitives.js";import{nowIso}from"../../core/shared/time.js";import{parseItemDocument}from"../../core/item/item-format.js";import{BASELINE_ITEM_FORMAT_VERSION,CURRENT_ITEM_FORMAT_VERSION,effectiveItemFormatVersion,scanItemFormatVersions}from"../../core/item/item-format-version.js";import{listAllItemMetadataLight,listAllItemMetadataWithBody}from"../../core/store/item-store.js";import{PM_TELEMETRY_SOURCE_CONTEXT_VALUES,TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS,TELEMETRY_SCHEMA_VERSION}from"../../core/telemetry/runtime.js";import{getItemFormatFromPath,getSettingsPath,ITEM_FILE_EXTENSIONS,resolveGlobalPmRoot,resolvePmRoot,resolveWorkspaceRoot}from"../../core/store/paths.js";import{readSettingsWithMetadata}from"../../core/store/settings.js";import{buildRemediationMap,resolveRemediation}from"../../core/diagnostics/remediation.js";import{scanExtensionHostVersions}from"./extension-host-version.js";import{scanHistoryAuthorAttribution}from"../author-attribution.js";import{readManagedExtensionState}from"../extension.js";import{scanProvenanceResolverHealth}from"./provenance-health.js";import{applyStoredExtensionMigrationState}from"../extension/migrations.js";import{inspectExtensionAuthorManifest}from"../extension/author-manifest.js";import{buildCapabilityContractMetadata,buildRegistrationCollisionRemediation,collectUnknownCapabilityGuidance}from"../extension/doctor.js";import{scanStaleInProgressItems}from"./stale-work.js";import{scanTrackedRuntimeCache}from"./tracked-runtime-cache.js";import{buildMergeReceiptEvidenceWarnings,resolveMergeFenceHealthEvidence}from"./health-merge-evidence.js";import{auditMergeDriverConfiguration,findGitWorkspaceRoot}from"../merge/install.js";import{inspectMergeReceiptEvidence,partitionMergeReceipts}from"../merge/receipts.js";import{classifyHistoryMergeReceiptReferences,extractHistoryMergeReceiptDispositions,extractHistoryMergeReceiptReferences}from"./merge-receipt-history.js";import{runHistoryRepair}from"../history-repair.js";import{resolveWorkspaceRelationshipKindRegistry}from"../graph/assembly.js";import{analyzeHierarchyIntegrity}from"../graph/hierarchy-integrity.js";import{buildStatusRoleWarnings,inspectStatusRoleAssignments}from"./status-role-diagnostics.js";const PM_TELEMETRY_SOURCE_CONTEXT_SET=new Set(PM_TELEMETRY_SOURCE_CONTEXT_VALUES),STALE_VECTORIZATION_SUMMARY_LIMIT=25,TELEMETRY_QUEUE_RELATIVE_PATH=path.join("runtime","telemetry","events.jsonl"),TELEMETRY_STATE_RELATIVE_PATH=path.join("runtime","telemetry","state.json"),TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS=2500,TELEMETRY_QUEUE_HIGH_WATER_MARK=500,TELEMETRY_QUEUE_HIGH_RETRY_THRESHOLD=TELEMETRY_MAX_QUEUE_ENTRY_ATTEMPTS-3,TELEMETRY_SERVER_MAX_SCHEMA_VERSION_HEADERS=["x-pm-telemetry-max-schema-version","x-pm-telemetry-max-version"];function isAdvisoryHealthWarning(warning,requireMergeDrivers=!1){return warning.startsWith("agent_guidance_")||warning.startsWith("telemetry_")||warning.startsWith("history_stream_over_compact_threshold:")||warning.startsWith("integrity_legacy_hierarchy_")||warning.startsWith("stale_in_progress_items:")||warning.startsWith("provenance_resolver_zero_success:")||warning.startsWith("provenance_value_domain_invalid:")||!requireMergeDrivers&&warning.startsWith("merge_driver_configuration_missing:")}function warningCode(value){const normalized=value.trim(),separator=normalized.indexOf(":");return separator===-1?normalized:normalized.slice(0,separator)}function normalizeExtensionNameForMatch(value){return value.trim().toLowerCase()}function isExpectedUnmanagedExtension(name,directory){const normalizedName=normalizeExtensionNameForMatch(name),normalizedDirectory=normalizeExtensionNameForMatch(directory);return normalizedName.startsWith("builtin-")?!0:normalizedDirectory==="beads"||normalizedDirectory==="todos"}async function isDirectory(targetPath){try{return(await fs.stat(targetPath)).isDirectory()}catch{return!1}}async function listStoredItemDocumentIds(pmRoot){const directories=(await fs.readdir(pmRoot,{withFileTypes:!0})).filter(entry=>entry.isDirectory()),filesByDirectory=await Promise.all(directories.map(entry=>fs.readdir(path.join(pmRoot,entry.name),{withFileTypes:!0})));return new Set(filesByDirectory.flatMap(entries=>entries.filter(entry=>entry.isFile()).filter(entry=>ITEM_FILE_EXTENSIONS.some(extension=>entry.name.endsWith(extension))).map(entry=>path.parse(entry.name).name)))}async function inspectHistoryStream(streamPath,itemId,compactPolicy,liveItemIds){const warnings=await runActiveOnReadHooks({path:streamPath,scope:"project"}),needsClassification=itemId!=="_workspace"&&!liveItemIds.has(itemId);if(!compactPolicy.enabled&&!needsClassification)return{warnings,overThreshold:!1,classification:"live"};let raw;try{raw=await fs.readFile(streamPath,"utf8")}catch{return{warnings,overThreshold:!1,classification:"unreadable"}}let classification="live";if(needsClassification){const lastLine=raw.split(/\r?\n/).map(line=>line.trim()).filter(Boolean).at(-1);try{classification=JSON.parse(lastLine??"{}").op==="delete"?"tombstone":"orphaned"}catch{classification="orphaned"}}const entryCount=compactPolicy.enabled?raw.split(/\r?\n/).filter(line=>line.trim().length>0).length:0;return{warnings,overThreshold:compactPolicy.enabled&&entryCount>compactPolicy.max_entries,classification}}async function countHistoryStreams(pmRoot,compactPolicy,liveItemIds){const historyDir=path.join(pmRoot,"history");if(!await isDirectory(historyDir))return{count:0,warnings:[],over_threshold:[],max_entries:null,tombstones:[],orphaned:[]};const historyFiles=(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((left,right)=>left.localeCompare(right)),maxEntries=compactPolicy.enabled?compactPolicy.max_entries:null,warnings=[],overThreshold=[],tombstones=[],orphaned=[];for(const fileName of historyFiles){const streamPath=path.join(historyDir,fileName),itemId=fileName.slice(0,-6),inspection=await inspectHistoryStream(streamPath,itemId,compactPolicy,liveItemIds);warnings.push(...inspection.warnings),inspection.classification==="tombstone"&&tombstones.push(itemId),inspection.classification==="orphaned"&&orphaned.push(itemId),inspection.overThreshold&&overThreshold.push(itemId)}return{count:historyFiles.length,warnings:[...warnings,...overThreshold.map(id=>`history_stream_over_compact_threshold:${id}`),...orphaned.map(id=>`history_orphaned_stream:${id}`)],over_threshold:overThreshold,max_entries:maxEntries,tombstones,orphaned}}function normalizeRelativePath(pmRoot,targetPath){return path.relative(pmRoot,targetPath).replaceAll("\\","/")}async function listItemDocumentPaths(pmRoot,typeToFolder){const folders=[...new Set(Object.values(typeToFolder))].sort((left,right)=>left.localeCompare(right)),itemPaths=[];for(const folder of folders){const directoryPath=path.join(pmRoot,folder);let entries=[];try{entries=await fs.readdir(directoryPath)}catch(error){if(typeof error=="object"&&error!==null&&"code"in error&&isFileMissingError(error))continue;continue}for(const entry of entries)ITEM_FILE_EXTENSIONS.some(extension=>entry.toLowerCase().endsWith(extension))&&itemPaths.push(path.join(directoryPath,entry))}return itemPaths.sort((left,right)=>normalizeRelativePath(pmRoot,left).localeCompare(normalizeRelativePath(pmRoot,right))),itemPaths}function shouldReportHistoryDirectoryUnreadable(error){return!(typeof error=="object"&&error!==null&&"code"in error&&isFileMissingError(error))}async function scanItemIntegrity(pmRoot,typeToFolder,schema){const paths=await listItemDocumentPaths(pmRoot,typeToFolder),unreadable=[],conflictMarkers=[],parseFailures=[],formatVersions=[],extensionFieldNames=collectRegisteredItemFieldNames(getActiveExtensionRegistrations());for(const itemPath of paths){const relativePath=normalizeRelativePath(pmRoot,itemPath);let raw;try{raw=await fs.readFile(itemPath,"utf8")}catch{unreadable.push(relativePath);continue}const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){conflictMarkers.push({path:relativePath,...conflictMarker});continue}try{const parsed=parseItemDocument(raw,{format:getItemFormatFromPath(itemPath),schema,extensionFieldNames});formatVersions.push({ref:relativePath,version:effectiveItemFormatVersion(parsed.metadata)})}catch{parseFailures.push(relativePath)}}return{paths,unreadable,conflictMarkers,parseFailures,formatVersions}}async function scanHistoryIntegrity(pmRoot){const historyDir=path.join(pmRoot,"history"),unreadable=[],conflictMarkers=[],invalidJson=[],mergeReceiptReferences=[],mergeReceiptDispositions=[];let files=[];try{files=(await fs.readdir(historyDir)).filter(entry=>entry.endsWith(".jsonl")).sort((left,right)=>left.localeCompare(right))}catch(error){shouldReportHistoryDirectoryUnreadable(error)&&unreadable.push("history")}for(const fileName of files){const itemId=fileName.slice(0,-6);let raw;try{raw=await fs.readFile(path.join(historyDir,fileName),"utf8")}catch{unreadable.push(itemId);continue}const conflictMarker=findFirstMergeConflictMarker(raw);if(conflictMarker){conflictMarkers.push({id:itemId,...conflictMarker});continue}raw.split(/\r?\n/).forEach((line,index)=>{if(line.trim())try{const parsed=JSON.parse(line);mergeReceiptReferences.push(...extractHistoryMergeReceiptReferences(parsed,itemId).map(reference=>({itemId,line:index+1,...reference}))),mergeReceiptDispositions.push(...extractHistoryMergeReceiptDispositions(parsed,itemId,index+1))}catch{invalidJson.push({id:itemId,line:index+1})}})}return{files,unreadable,conflictMarkers,invalidJson,mergeReceiptReferences,mergeReceiptDispositions}}function buildHierarchyIntegrityWarnings(analysis){return[...analysis.cycles.map(cycle=>cycle.legacy_terminal?`integrity_legacy_hierarchy_cycle:${cycle.item_ids.join(",")}`:`integrity_hierarchy_cycle:${cycle.item_ids.join(",")}`),...analysis.cardinality_violations.map(finding=>finding.legacy_terminal?`integrity_legacy_hierarchy_cardinality:${finding.child_id}`:`integrity_hierarchy_cardinality:${finding.child_id}`),...analysis.divergences.map(finding=>finding.legacy_terminal?`integrity_legacy_hierarchy_divergence:${finding.child_id}`:`integrity_hierarchy_divergence:${finding.child_id}`)]}async function buildIntegrityCheck(pmRoot,typeToFolder,schema,settings,requireMergeDrivers,items){const itemScan=await scanItemIntegrity(pmRoot,typeToFolder,schema),historyScan=await scanHistoryIntegrity(pmRoot),formatVersionScan=scanItemFormatVersions(itemScan.formatVersions,CURRENT_ITEM_FORMAT_VERSION,BASELINE_ITEM_FORMAT_VERSION),statusRegistry=resolveRuntimeStatusRegistry(schema),hierarchyIntegrity=analyzeHierarchyIntegrity(items,status=>isTerminalStatus(status,statusRegistry),resolveWorkspaceRelationshipKindRegistry()),trackedRuntimeCache=await scanTrackedRuntimeCache(pmRoot),gitWorkspaceRoot=await findGitWorkspaceRoot(pmRoot),mergeFence=await resolveMergeFenceHealthEvidence(pmRoot,gitWorkspaceRoot,settings,requireMergeDrivers),mergeDriverAudit=gitWorkspaceRoot===null?null:await auditMergeDriverConfiguration(gitWorkspaceRoot),mergeReceiptEvidence=await inspectMergeReceiptEvidence(gitWorkspaceRoot??pmRoot,{includeReconciled:!0,includeLossless:!0,pmRoot}),availableMergeReceiptIds=new Set(mergeReceiptEvidence.durable_receipt_ids),historyReceiptClassification=classifyHistoryMergeReceiptReferences(historyScan.mergeReceiptReferences,availableMergeReceiptIds,historyScan.mergeReceiptDispositions),missingMergeReceiptReferences=historyReceiptClassification.missing,pendingMergeReceipts=mergeReceiptEvidence.receipts.filter(receipt=>receipt.state==="pending"),{pendingDecisions:pendingMergeDecisions,lossless:losslessMergeReceipts}=partitionMergeReceipts(pendingMergeReceipts),mergeDriverInstallationMissing=mergeDriverAudit?.status==="missing"&&mergeDriverAudit.missing_keys.length===5&&mergeDriverAudit.drifted_keys.length===0,warnings=[...itemScan.unreadable.map(entry=>`integrity_item_unreadable:${entry}`),...itemScan.conflictMarkers.map(entry=>`integrity_item_conflict_marker:${entry.path}:L${entry.line}`),...itemScan.parseFailures.map(entry=>`integrity_item_parse_failed:${entry}`),...historyScan.unreadable.map(entry=>`integrity_history_unreadable:${entry}`),...historyScan.conflictMarkers.map(entry=>`integrity_history_conflict_marker:${entry.id}:L${entry.line}`),...historyScan.invalidJson.map(entry=>`integrity_history_invalid_json:${entry.id}:L${entry.line}`),...formatVersionScan.outdated.map(entry=>`integrity_item_outdated_format_version:${entry}`),...formatVersionScan.ahead.map(entry=>`integrity_item_ahead_format_version:${entry}`),...buildHierarchyIntegrityWarnings(hierarchyIntegrity),...trackedRuntimeCache.tracked_path_count>0?[`tracked_runtime_cache_files:${trackedRuntimeCache.tracked_path_count}`]:[],...mergeDriverAudit!==null&&mergeDriverAudit.status!=="ok"?[`merge_driver_configuration_${mergeDriverInstallationMissing?"missing":"drift"}:${mergeDriverAudit.missing_keys.length+mergeDriverAudit.drifted_keys.length}`]:[],...mergeFence.warnings,...pendingMergeDecisions.length>0?[`merge_decisions_unreviewed:${pendingMergeDecisions.length}`]:[],...losslessMergeReceipts.length>0?[`merge_receipts_pending:${losslessMergeReceipts.length}`]:[],...buildMergeReceiptEvidenceWarnings({invalidEvidenceCount:mergeReceiptEvidence.invalid_evidence_count,missingHistoryReferenceCount:missingMergeReceiptReferences.length})],normalizedWarnings=[...new Set(warnings)].sort((left,right)=>left.localeCompare(right)),actionableWarnings=normalizedWarnings.filter(warning=>!warning.startsWith("integrity_legacy_hierarchy_"));return{check:{name:"integrity",status:actionableWarnings.length===0?"ok":"warn",ok:actionableWarnings.length===0,details:{checked_item_files:itemScan.paths.length,checked_history_streams:historyScan.files.length,counts:{item_unreadable:itemScan.unreadable.length,item_conflict_markers:itemScan.conflictMarkers.length,item_parse_failures:itemScan.parseFailures.length,history_unreadable:historyScan.unreadable.length,history_conflict_markers:historyScan.conflictMarkers.length,history_invalid_json:historyScan.invalidJson.length,item_outdated_format_version:formatVersionScan.outdated.length,item_ahead_format_version:formatVersionScan.ahead.length,hierarchy_cycles:hierarchyIntegrity.cycles.length,hierarchy_cardinality_violations:hierarchyIntegrity.cardinality_violations.length,hierarchy_parent_divergences:hierarchyIntegrity.divergences.length,tracked_runtime_cache_files:trackedRuntimeCache.tracked_path_count,merge_driver_configuration:mergeDriverAudit===null||mergeDriverAudit.status==="ok"?0:mergeDriverAudit.missing_keys.length+mergeDriverAudit.drifted_keys.length,merge_fence:mergeFence.count,pending_merge_decisions:pendingMergeDecisions.length,lossless_merge_receipts:losslessMergeReceipts.length,invalid_merge_receipt_evidence:mergeReceiptEvidence.invalid_evidence_count,missing_merge_receipt_history_references:missingMergeReceiptReferences.length,accepted_legacy_merge_receipt_references:historyReceiptClassification.acceptedLegacyCount,accepted_missing_merge_receipt_dispositions:historyReceiptClassification.acceptedDispositionCount},item_unreadable:itemScan.unreadable,item_conflict_markers:itemScan.conflictMarkers,item_parse_failures:itemScan.parseFailures,item_outdated_format_version:formatVersionScan.outdated,item_ahead_format_version:formatVersionScan.ahead,hierarchy_integrity:{...hierarchyIntegrity,relations:summarizeRecordList(hierarchyIntegrity.relations,BRIEF_HEALTH_DETAIL_LIMIT)},history_unreadable:historyScan.unreadable,history_conflict_markers:historyScan.conflictMarkers,history_invalid_json:historyScan.invalidJson,tracked_runtime_cache:{tracker_relative_root:trackedRuntimeCache.tracker_relative_root,tracked_paths:trackedRuntimeCache.tracked_paths,tracked_path_count:trackedRuntimeCache.tracked_path_count,remediation_command:trackedRuntimeCache.remediation_command},merge_driver_configuration:mergeDriverAudit===null?null:{...mergeDriverAudit,required:requireMergeDrivers},merge_fence:mergeFence.audit,pending_merge_decision_items:[...new Set(pendingMergeDecisions.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),lossless_merge_receipt_items:[...new Set(losslessMergeReceipts.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),invalid_merge_receipt_evidence_details:mergeReceiptEvidence.invalid_evidence,invalid_merge_receipt_evidence_details_truncated:mergeReceiptEvidence.invalid_evidence_truncated,missing_merge_receipt_history_reference_details:missingMergeReceiptReferences.slice(0,HEALTH_WARNING_LIMIT),missing_merge_receipt_history_reference_details_truncated:missingMergeReceiptReferences.length>HEALTH_WARNING_LIMIT}},warnings:normalizedWarnings,gitWorkspaceRoot,pendingMergeReceipts}}function hasActivateExport(moduleRecord){if(typeof moduleRecord.activate=="function")return!0;const defaultExport=moduleRecord.default;return typeof defaultExport!="object"||defaultExport===null?!1:typeof defaultExport.activate=="function"}function summarizeLoadedExtension(extension){const summary={layer:extension.layer,directory:extension.directory,manifest_path:extension.manifest_path,name:extension.name,version:extension.version,entry:extension.entry,priority:extension.priority,entry_path:extension.entry_path,has_activate:hasActivateExport(extension.module)};return Array.isArray(extension.capabilities)&&(summary.capabilities=[...extension.capabilities]),summary}function resolveMigrationId(definition,fallbackIndex){return toNonEmptyStringOrUndefined(definition.id)||`migration-${String(fallbackIndex+1).padStart(3,"0")}`}function resolveMigrationStatus(definition){const normalized=toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();return normalized==="failed"?"failed":normalized==="applied"?"applied":"pending"}function resolveMigrationFailureReason(definition){return toNonEmptyStringOrUndefined(definition.reason)??toNonEmptyStringOrUndefined(definition.error)??toNonEmptyStringOrUndefined(definition.message)}function compareMigrationEntries(left,right){const byLayer=(left.layer??"").localeCompare(right.layer??"");if(byLayer!==0)return byLayer;const byName=(left.name??"").localeCompare(right.name??"");return byName!==0?byName:(left.id??"").localeCompare(right.id??"")}function summarizeMigrationStatuses(migrations){const applied=[],pending=[],failed=[];migrations.forEach((migration,index)=>{const id=resolveMigrationId(migration.definition,index),status=resolveMigrationStatus(migration.definition);if(status==="applied"){applied.push({layer:migration.layer,name:migration.name,id,status});return}if(status==="failed"){failed.push({layer:migration.layer,name:migration.name,id,status,reason:resolveMigrationFailureReason(migration.definition)});return}pending.push({layer:migration.layer,name:migration.name,id,status})}),applied.sort(compareMigrationEntries),pending.sort(compareMigrationEntries),failed.sort(compareMigrationEntries);const warnings=[...failed.map(entry=>`extension_migration_failed:${entry.layer}:${entry.name}:${entry.id}`),...pending.map(entry=>`extension_migration_pending:${entry.layer}:${entry.name}:${entry.id}`)];return{summary:{applied,pending,failed,applied_count:applied.length,pending_count:pending.length,failed_count:failed.length},warnings}}function buildExtensionHealthTriageSummary(warnings,loadFailureCount,activationFailureCount,migrationStatus,managedStateWarningCount,managedExtensionEntriesCount,unmanagedLoadedExtensions,unmanagedExpectedExtensions,unmanagedActionRequiredExtensions){const normalizedWarnings=[...new Set(warnings)].sort((left,right)=>left.localeCompare(right)),warningCodes=[...new Set(normalizedWarnings.map(value=>warningCode(value)))].sort((left,right)=>left.localeCompare(right)),unknownCapabilityCount=normalizedWarnings.filter(warning=>warning.startsWith("extension_capability_unknown:")).length,updateHealthPartial=unmanagedActionRequiredExtensions.length>0,updateHealthCoverage=updateHealthPartial?"partial":"full",remediation=[],registrationCollisionRemediation=buildRegistrationCollisionRemediation(normalizedWarnings,{deactivate:"pm extension --deactivate <name> --project/--global",doctor:"pm extension --doctor --project/--global --detail deep --trace"});return registrationCollisionRemediation&&remediation.push(registrationCollisionRemediation),loadFailureCount>0&&remediation.push("Run pm extension --explore --project and pm extension --explore --global to inspect load failures."),activationFailureCount>0&&remediation.push("Review checks[name=extensions].details.activation.failed in pm health --json for activation error details."),(migrationStatus.failed_count>0||migrationStatus.pending_count>0)&&remediation.push("Resolve pending/failed extension migrations before write commands; use --force only when policy allows."),managedStateWarningCount>0&&remediation.push("Run pm extension --manage --project and pm extension --manage --global to refresh managed-state diagnostics."),unknownCapabilityCount>0&&remediation.push(`Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`),normalizedWarnings.some(warning=>warning.startsWith("extension_capability_legacy_alias:"))&&remediation.push("Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."),normalizedWarnings.some(warning=>warning.startsWith("extension_command_definition_legacy_handler_alias:"))&&remediation.push("Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."),updateHealthPartial?remediation.push("Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via pm extension --manage --project/--global --fix-managed-state, pm extension --adopt-all --project/--global, or pm extension --adopt <name>."):unmanagedLoadedExtensions.length>0&&remediation.push("Loaded unmanaged extensions are currently treated as informational. Use pm extension --manage --project/--global --fix-managed-state to adopt them for update checks."),remediation.length===0&&remediation.push("No immediate action required. Re-run pm health after extension configuration changes."),{status:normalizedWarnings.length===0?"ok":"warn",warning_count:normalizedWarnings.length,warning_codes:warningCodes,load_failure_count:loadFailureCount,activation_failure_count:activationFailureCount,migration_failed_count:migrationStatus.failed_count,migration_pending_count:migrationStatus.pending_count,managed_state_warning_count:managedStateWarningCount,managed_extension_entries_count:managedExtensionEntriesCount,unmanaged_loaded_extension_count:unmanagedLoadedExtensions.length,unmanaged_loaded_extensions:unmanagedLoadedExtensions,unmanaged_expected_extension_count:unmanagedExpectedExtensions.length,unmanaged_expected_extensions:unmanagedExpectedExtensions,unmanaged_action_required_extension_count:unmanagedActionRequiredExtensions.length,unmanaged_action_required_extensions:unmanagedActionRequiredExtensions,update_health_coverage:updateHealthCoverage,update_health_partial:updateHealthPartial,unknown_capability_count:unknownCapabilityCount,top_warnings:normalizedWarnings.slice(0,8),remediation}}async function buildExtensionCheck(pmRoot,settings,noExtensionsFlag){const authorManifest=await inspectExtensionAuthorManifest(resolveWorkspaceRoot(pmRoot)),loadResult=await loadExtensions({pmRoot,settings,cwd:process.cwd(),noExtensions:noExtensionsFlag}),loadedSummaries=loadResult.loaded.map(extension=>summarizeLoadedExtension(extension)),hostVersionCensus=await scanExtensionHostVersions(loadResult.loaded,resolveWorkspaceRoot(pmRoot)),activationResult=await activateExtensions({...loadResult,loaded:loadResult.loaded}),[projectManagedState,globalManagedState]=await Promise.all([readManagedExtensionState(loadResult.roots.project),readManagedExtensionState(loadResult.roots.global)]);await applyStoredExtensionMigrationState(pmRoot,activationResult.registrations.migrations);const migrationStatus=summarizeMigrationStatuses(activationResult.registrations.migrations),activationDetails={failed:activationResult.failed,warnings:activationResult.warnings,hook_counts:activationResult.hook_counts,command_override_count:activationResult.command_override_count,command_handler_count:activationResult.command_handler_count,parser_override_count:activationResult.parser_override_count,preflight_override_count:activationResult.preflight_override_count,service_override_count:activationResult.service_override_count,renderer_override_count:activationResult.renderer_override_count,registration_counts:activationResult.registration_counts,registrations:activationResult.registrations,migration_status:migrationStatus.summary,managed_extensions:{project:{path:projectManagedState.path,count:projectManagedState.state.entries.length,entries:projectManagedState.state.entries},global:{path:globalManagedState.path,count:globalManagedState.state.entries.length,entries:globalManagedState.state.entries}}},managedProjectNames=new Set(projectManagedState.state.entries.map(entry=>normalizeExtensionNameForMatch(entry.name))),managedGlobalNames=new Set(globalManagedState.state.entries.map(entry=>normalizeExtensionNameForMatch(entry.name))),unmanagedLoadedEntries=[...new Map(loadResult.loaded.filter(entry=>!(entry.layer==="project"?managedProjectNames:managedGlobalNames).has(normalizeExtensionNameForMatch(entry.name))).map(entry=>[`${entry.layer}:${entry.name}`,{layer:entry.layer,name:entry.name,directory:entry.directory}])).values()].sort((left,right)=>{const leftKey=`${left.layer}:${left.name}`,rightKey=`${right.layer}:${right.name}`;return leftKey.localeCompare(rightKey)}),unmanagedLoadedExtensions=unmanagedLoadedEntries.map(entry=>`${entry.layer}:${entry.name}`).sort((left,right)=>left.localeCompare(right)),unmanagedExpectedExtensions=unmanagedLoadedEntries.filter(entry=>isExpectedUnmanagedExtension(entry.name,entry.directory)).map(entry=>`${entry.layer}:${entry.name}`).sort((left,right)=>left.localeCompare(right)),unmanagedActionRequiredExtensions=unmanagedLoadedEntries.filter(entry=>!isExpectedUnmanagedExtension(entry.name,entry.directory)).map(entry=>`${entry.layer}:${entry.name}`).sort((left,right)=>left.localeCompare(right)),updateCoverageWarnings=unmanagedActionRequiredExtensions.length>0?[`extension_update_health_partial_coverage:skipped_unmanaged:${unmanagedActionRequiredExtensions.length}`]:[],extensionWarnings=[...authorManifest.warnings,...loadResult.warnings,...activationDetails.warnings,...migrationStatus.warnings,...projectManagedState.warnings,...globalManagedState.warnings,...updateCoverageWarnings,...hostVersionCensus.warnings],capabilityGuidance=collectUnknownCapabilityGuidance(extensionWarnings),capabilityContract=buildCapabilityContractMetadata(),extensionTriage=buildExtensionHealthTriageSummary(extensionWarnings,loadResult.failed.length,activationResult.failed.length,migrationStatus.summary,projectManagedState.warnings.length+globalManagedState.warnings.length,projectManagedState.state.entries.length+globalManagedState.state.entries.length,unmanagedLoadedExtensions,unmanagedExpectedExtensions,unmanagedActionRequiredExtensions);return{check:{name:"extensions",status:extensionWarnings.length===0?"ok":"warn",ok:extensionWarnings.length===0,details:{...loadResult,loaded:loadedSummaries,warnings:extensionWarnings,activation:activationDetails,author_manifest:authorManifest,triage:extensionTriage,...migrationStatus.summary.pending_count>0?{remediation_map:{extension_migration_pending:"pm extension migrate --project"}}:{},capability_contract:capabilityContract,capability_guidance:capabilityGuidance,host_version_census:hostVersionCensus}},warnings:extensionWarnings}}function selectStaleItemDetail(values,verboseStaleItems){if(verboseStaleItems)return{values,truncated:!1,total:values.length};const summary=summarizeList(values,STALE_VECTORIZATION_SUMMARY_LIMIT);return{values:summary.values,truncated:summary.truncated,total:values.length}}function telemetryEnvFlagEnabled(envKey){const value=(process.env[envKey]??"").trim().toLowerCase();return value==="1"||value==="true"||value==="yes"||value==="on"}function telemetrySourceContextOverride(){const value=(process.env.PM_TELEMETRY_SOURCE_CONTEXT??"").trim().toLowerCase();return PM_TELEMETRY_SOURCE_CONTEXT_SET.has(value)?value:null}function normalizeEndpointForDisplay(rawEndpoint){const trimmed=rawEndpoint.trim();if(trimmed.length===0)return"";try{const parsed=new URL(trimmed);return parsed.username="",parsed.password="",parsed.search="",parsed.hash="",parsed.toString()}catch{return trimmed}}function parseTelemetryQueue(raw){let validEntries=0,invalidRows=0,totalRows=0,highRetryEntries=0,maxAttempts=0;for(const line of raw.split(`
+`)){const trimmed=line.trim();if(trimmed.length!==0){totalRows+=1;try{const parsed=JSON.parse(trimmed);if(typeof parsed=="object"&&parsed!==null&&typeof parsed.attempts=="number"&&Number.isFinite(parsed.attempts)){const attempts=Math.max(0,Math.trunc(parsed.attempts));validEntries+=1,maxAttempts=Math.max(maxAttempts,attempts),attempts>=TELEMETRY_QUEUE_HIGH_RETRY_THRESHOLD&&(highRetryEntries+=1)}else invalidRows+=1}catch{invalidRows+=1}}}return{validEntries,invalidRows,totalRows,highRetryEntries,maxAttempts}}function emptyTelemetryQueueSummary(){return{validEntries:0,invalidRows:0,totalRows:0,highRetryEntries:0,maxAttempts:0}}function parseTelemetryRuntimeState(stateRaw){if(!stateRaw||stateRaw.trim().length===0)return{runtimeState:{},stateParseFailed:!1};try{const parsed=JSON.parse(stateRaw);return typeof parsed=="object"&&parsed!==null&&!Array.isArray(parsed)?{runtimeState:parsed,stateParseFailed:!1}:{runtimeState:{},stateParseFailed:!0}}catch{return{runtimeState:{},stateParseFailed:!0}}}async function maybeProbeTelemetryEndpoint(settings,checkTelemetry){const endpoint=settings.telemetry.endpoint.trim();return!checkTelemetry||!settings.telemetry.enabled||endpoint.length===0||resolveTelemetryEnvironmentPolicy().telemetry_disabled?void 0:{attempted:!0,...await probeTelemetryEndpointHealth(endpoint)}}function collectTelemetryQueueWarnings(settings,queueSummary,runtimeState){const warnings=[];if(queueSummary.invalidRows>0&&warnings.push(`telemetry_queue_invalid_rows:${queueSummary.invalidRows}`),!settings.telemetry.enabled||queueSummary.validEntries===0)return warnings;const lastSuccess=runtimeState.last_successful_flush_at,lastFailure=runtimeState.last_failed_flush_at,activeFailure=lastFailure&&(!lastSuccess||lastFailure>lastSuccess),neverFlushed=!lastSuccess,highWater=queueSummary.validEntries>=TELEMETRY_QUEUE_HIGH_WATER_MARK;return(activeFailure||neverFlushed||highWater)&&warnings.push(`telemetry_queue_pending:${queueSummary.validEntries}`),queueSummary.highRetryEntries>0&&warnings.push(`telemetry_queue_high_retries:${queueSummary.highRetryEntries}`),warnings}function collectTelemetryEndpointWarnings(endpointProbe){return!endpointProbe||endpointProbe.ok!==!1?[]:typeof endpointProbe.status=="number"?[`telemetry_endpoint_probe_http_status:${endpointProbe.status}`]:["telemetry_endpoint_probe_failed"]}function collectTelemetrySchemaWarnings(endpointProbe){const parsedMaxSchemaVersion=Number.parseInt(endpointProbe?.max_schema_version??"",10);return endpointProbe?.ok===!0&&Number.isInteger(parsedMaxSchemaVersion)&&parsedMaxSchemaVersion>TELEMETRY_SCHEMA_VERSION?[`telemetry_schema_version_behind:${parsedMaxSchemaVersion}`]:[]}function collectTelemetryOtelWarnings(settings,runtimeState){const pendingOtelSpans=typeof runtimeState.pending_otel_spans=="number"?runtimeState.pending_otel_spans:0,lastOtelSuccess=runtimeState.last_otel_success_at,lastOtelFailure=runtimeState.last_otel_failure_at;return settings.telemetry.enabled&&pendingOtelSpans>0&&lastOtelFailure&&(!lastOtelSuccess||lastOtelFailure>=lastOtelSuccess)?[`telemetry_otel_export_failing:${pendingOtelSpans}`]:[]}function buildTelemetryEnvOverrideDetails(){return{...resolveTelemetryEnvironmentPolicy(),pm_no_telemetry:telemetryEnvFlagEnabled("PM_NO_TELEMETRY"),telemetry_otel_disabled:telemetryEnvFlagEnabled("PM_TELEMETRY_OTEL_DISABLED"),telemetry_inline_flush:telemetryEnvFlagEnabled("PM_TELEMETRY_INLINE_FLUSH"),telemetry_source_context:telemetrySourceContextOverride()}}function telemetryQueueHasEntries(settings,queueSummary){return settings.telemetry.enabled&&queueSummary.validEntries>0}function isTelemetryQueueDraining(queueHasEntries,warnings){return queueHasEntries&&warnings.every(warning=>!warning.startsWith("telemetry_queue_pending:")&&!warning.startsWith("telemetry_queue_high_retries:"))}async function probeTelemetryEndpointHealth(endpoint){let probeUrl=endpoint;try{const parsed=new URL(endpoint);parsed.pathname="/healthz",parsed.search="",parsed.hash="",probeUrl=parsed.toString()}catch{}try{const response=await fetch(probeUrl,{method:"GET",signal:AbortSignal.timeout(TELEMETRY_ENDPOINT_PROBE_TIMEOUT_MS)});return{probe_url:normalizeEndpointForDisplay(probeUrl),ok:response.ok,status:response.status,max_schema_version:(()=>{for(const headerName of TELEMETRY_SERVER_MAX_SCHEMA_VERSION_HEADERS){const value=response.headers.get(headerName)?.trim();if(value&&value.length>0)return value}})()}}catch(error){return{probe_url:normalizeEndpointForDisplay(probeUrl),ok:!1,error:error instanceof Error?error.message:"probe_failed"}}}async function buildTelemetryCheck(settings,options){const globalPmRoot=resolveGlobalPmRoot(process.cwd()),queuePath=path.join(globalPmRoot,TELEMETRY_QUEUE_RELATIVE_PATH),statePath=path.join(globalPmRoot,TELEMETRY_STATE_RELATIVE_PATH),queueRaw=await readFileIfExists(queuePath),queueExists=queueRaw!==null,queueSizeBytes=queueRaw?Buffer.byteLength(queueRaw,"utf8"):0,queueSummary=queueRaw?parseTelemetryQueue(queueRaw):emptyTelemetryQueueSummary(),stateRaw=await readFileIfExists(statePath),{runtimeState,stateParseFailed}=parseTelemetryRuntimeState(stateRaw),endpoint=settings.telemetry.endpoint.trim(),endpointDisplay=normalizeEndpointForDisplay(endpoint),endpointProbe=await maybeProbeTelemetryEndpoint(settings,options.checkTelemetry),warnings=[];stateParseFailed&&warnings.push("telemetry_state_invalid_json"),warnings.push(...collectTelemetryQueueWarnings(settings,queueSummary,runtimeState),...collectTelemetryEndpointWarnings(endpointProbe),...collectTelemetrySchemaWarnings(endpointProbe),...collectTelemetryOtelWarnings(settings,runtimeState));const queueHasEntries=telemetryQueueHasEntries(settings,queueSummary),pendingOtelSpans=typeof runtimeState.pending_otel_spans=="number"?runtimeState.pending_otel_spans:0;return{check:{name:"telemetry",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{enabled:settings.telemetry.enabled,capture_level:settings.telemetry.capture_level,endpoint:endpointDisplay,global_pm_root:globalPmRoot,queue_path:queuePath,queue_exists:queueExists,queue_entries:queueSummary.validEntries,queue_draining:isTelemetryQueueDraining(queueHasEntries,warnings),queue_invalid_rows:queueSummary.invalidRows,queue_rows_total:queueSummary.totalRows,queue_size_bytes:queueSizeBytes,queue_high_retry_entries:queueSummary.highRetryEntries,queue_high_retry_threshold:TELEMETRY_QUEUE_HIGH_RETRY_THRESHOLD,queue_max_attempts:queueSummary.maxAttempts,runtime_state_path:statePath,last_attempted_flush_at:runtimeState.last_attempted_flush_at??null,last_successful_flush_at:runtimeState.last_successful_flush_at??null,last_failed_flush_at:runtimeState.last_failed_flush_at??null,last_failed_flush_error:runtimeState.last_failed_flush_error??null,pending_otel_spans:pendingOtelSpans,last_otel_attempt_at:runtimeState.last_otel_attempt_at??null,last_otel_success_at:runtimeState.last_otel_success_at??null,last_otel_failure_at:runtimeState.last_otel_failure_at??null,last_otel_failure_error:runtimeState.last_otel_failure_error??null,endpoint_probe:endpointProbe??{attempted:!1},env_overrides:buildTelemetryEnvOverrideDetails()}},warnings}}async function buildLocksCheck(pmRoot){let scan;try{scan=await scanLockHealth(pmRoot)}catch(error){const message=error instanceof Error?error.message:String(error);return{check:{name:"locks",status:"warn",ok:!1,details:{active_lock_count:0,stale_lock_count:0,unreadable_lock_count:0,unparseable_lock_count:0,scan_failed:!0,error:message,pm_root:pmRoot}},warnings:[`locks_scan_failed:${message}`]}}const warnings=[];return scan.stale_lock_count>0&&warnings.push(`locks_stale_count:${scan.stale_lock_count}`),scan.unreadable_lock_count>0&&warnings.push(`locks_unreadable:${scan.unreadable_lock_count}`),{check:{name:"locks",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{active_lock_count:scan.active_lock_count,stale_lock_count:scan.stale_lock_count,...scan.owner_dead_lock_samples?{owner_dead_lock_samples:scan.owner_dead_lock_samples,recovery_command:"pm gc --scope locks"}:{},unreadable_lock_count:scan.unreadable_lock_count,unparseable_lock_count:scan.unparseable_lock_count}},warnings}}async function buildHistoryDriftCheck(params){const cacheHitVerification="metadata";let items=params.items,drift=await scanHistoryDrift(params.pmRoot,items,{cacheHitVerification});const cacheConfirmationCandidates=[...new Set([...drift.hashMismatches,...drift.chainMismatches,...drift.versionSkews])].sort((left,right)=>left.localeCompare(right));let confirmedItems=[],resolvedFalsePositiveItems=[];if(cacheConfirmationCandidates.length>0){items=await listAllItemMetadataWithBody(params.pmRoot,params.settings.item_format,params.typeRegistry.type_to_folder,params.itemReadWarnings,params.settings.schema,{forceSourceScan:!0}),drift=await scanHistoryDrift(params.pmRoot,items),confirmedItems=[...new Set([...drift.hashMismatches,...drift.chainMismatches,...drift.versionSkews])].sort((left,right)=>left.localeCompare(right));const confirmedSet=new Set(confirmedItems);resolvedFalsePositiveItems=cacheConfirmationCandidates.filter(id=>!confirmedSet.has(id))}const{missingStreams,unreadableStreams,hashMismatches,chainMismatches,versionSkews,driftedItems,workspaceStateMismatches,workspaceStateMissing,workspaceStateUnreadable}=drift,warnings=[...missingStreams.map(id=>`history_drift_missing_stream:${id}`),...unreadableStreams.map(id=>`history_drift_unreadable_stream:${id}`),...hashMismatches.map(id=>`history_drift_hash_mismatch:${id}`),...chainMismatches.map(id=>`history_drift_chain_mismatch:${id}`),...versionSkews.map(id=>`history_drift_version_skew:${id}`),...workspaceStateMismatches.map(documentPath=>`history_drift_workspace_state_mismatch:${documentPath}`),...workspaceStateMissing.map(documentPath=>`history_drift_workspace_state_missing:${documentPath}`),...workspaceStateUnreadable.map(documentPath=>`history_drift_workspace_state_unreadable:${documentPath}`)];return{check:{name:"history_drift",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{checked_items:items.length,cache_hit_verification:cacheConfirmationCandidates.length>0?"metadata_then_content_hash":cacheHitVerification,cache_confirmation:{triggered:cacheConfirmationCandidates.length>0,reason:cacheConfirmationCandidates.length>0?"cached_corruption_candidate":null,candidate_items:cacheConfirmationCandidates,confirmed_items:confirmedItems,resolved_false_positive_items:resolvedFalsePositiveItems,authoritative_item_source:cacheConfirmationCandidates.length>0},drifted_items:driftedItems,counts:{drifted:driftedItems.length,missing_streams:missingStreams.length,unreadable_streams:unreadableStreams.length,hash_mismatches:hashMismatches.length,chain_mismatches:chainMismatches.length,version_skews:versionSkews.length,workspace_state_mismatches:workspaceStateMismatches.length,workspace_state_missing:workspaceStateMissing.length,workspace_state_unreadable:workspaceStateUnreadable.length},missing_streams:missingStreams,unreadable_streams:unreadableStreams,hash_mismatches:hashMismatches,chain_mismatches:chainMismatches,version_skews:versionSkews,workspace_state_mismatches:workspaceStateMismatches,workspace_state_missing:workspaceStateMissing,workspace_state_unreadable:workspaceStateUnreadable}},warnings}}function buildVectorizationRuntimeSnapshot(settings,pmRoot){const runtimeDefaults=resolveSettingsWithSemanticRuntimeDefaults(settings),providerResolution=resolveEmbeddingProviders(runtimeDefaults.settings),vectorStoreResolution=resolveVectorStores(runtimeDefaults.settings,pmRoot),runtimeEmbeddingIdentity=providerResolution.active?buildVectorizationEmbeddingIdentity(providerResolution.active.name,providerResolution.active.model):null;return{runtimeDefaults,providerResolution,vectorStoreResolution,runtimeEmbeddingIdentity,semanticRuntimeAvailable:!!(providerResolution.active&&vectorStoreResolution.active)}}function emptyVectorizationRefreshResult(){return{refreshed:[],skipped:[],warnings:[]}}async function refreshStaleVectorizationItems(params){return!params.refreshPolicy.enabled||!params.snapshot.semanticRuntimeAvailable||params.staleBefore.length===0?emptyVectorizationRefreshResult():refreshSemanticEmbeddingsForMutatedItems(params.pmRoot,params.staleBefore,{settings:params.snapshot.runtimeDefaults.settings,apply_runtime_defaults:!1})}function vectorizationEmbeddingIdentityChanged(params){return params.strictVectorizationWarnings&&params.semanticRuntimeAvailable&&!!(params.ledgerBefore.embedding&&params.runtimeEmbeddingIdentity&&hasVectorizationEmbeddingIdentityChanged(params.ledgerBefore.embedding,params.runtimeEmbeddingIdentity))}function collectVectorizationWarnings(params){const warningSet=new Set([...params.ledgerBefore.warnings,...params.ledgerAfter.warnings]);if(params.strictVectorizationWarnings)for(const warning of params.refreshResult.warnings)warningSet.add(warning);return params.embeddingIdentityChanged&&warningSet.add("vectorization_embedding_identity_changed"),params.strictVectorizationWarnings&&params.semanticRuntimeAvailable&&params.staleAfter.length>0&&warningSet.add(`vectorization_stale_items_remaining:${params.staleAfter.length}`),[...warningSet].sort((left,right)=>left.localeCompare(right))}function resolveVectorizationRefreshSkippedReason(refreshPolicy,semanticRuntimeAvailable,staleBefore){return refreshPolicy.enabled&&semanticRuntimeAvailable&&staleBefore.length>0?null:refreshPolicy.enabled?semanticRuntimeAvailable?"no_stale_items":"semantic_runtime_unavailable":"refresh_disabled"}function buildVectorizationProviderDetails(settings,snapshot){const activeProvider=snapshot.providerResolution.active?.name??null,activeVectorStore=snapshot.vectorStoreResolution.active?.name??null;return{provider_active:activeProvider,provider_configured:typeof settings.search?.provider=="string"?settings.search.provider:null,provider_source:resolveProviderConfigSource(activeProvider,settings.search?.provider??null),vector_store_active:activeVectorStore,vector_store_configured:typeof settings.vector_store?.adapter=="string"?settings.vector_store.adapter:null,vector_store_source:resolveProviderConfigSource(activeVectorStore,settings.vector_store?.adapter??null)}}function buildVectorizationRefreshPolicyDetails(refreshPolicy){return{enabled:refreshPolicy.enabled,check_only:refreshPolicy.checkOnly,no_refresh:refreshPolicy.noRefresh,refresh_vectors:refreshPolicy.refreshVectors}}function vectorizationRefreshAttempted(refreshPolicy,semanticRuntimeAvailable,staleBefore){return refreshPolicy.enabled&&staleBefore.length>0&&semanticRuntimeAvailable}async function buildVectorizationCheck(pmRoot,settings,items,refreshPolicy,verboseStaleItems){const snapshot=buildVectorizationRuntimeSnapshot(settings,pmRoot),ledgerBefore=await readVectorizationStatusLedger(pmRoot),staleBefore=snapshot.semanticRuntimeAvailable?collectStaleVectorizationIds(items,ledgerBefore.entries):[],refreshResult=await refreshStaleVectorizationItems({pmRoot,snapshot,refreshPolicy,staleBefore}),ledgerAfter=await readVectorizationStatusLedger(pmRoot),staleAfter=snapshot.semanticRuntimeAvailable?collectStaleVectorizationIds(items,ledgerAfter.entries):[],strictVectorizationWarnings=!snapshot.runtimeDefaults.auto_ollama_defaults_applied,embeddingIdentityChanged=vectorizationEmbeddingIdentityChanged({strictVectorizationWarnings,semanticRuntimeAvailable:snapshot.semanticRuntimeAvailable,ledgerBefore,runtimeEmbeddingIdentity:snapshot.runtimeEmbeddingIdentity}),warnings=collectVectorizationWarnings({ledgerBefore,ledgerAfter,refreshResult,strictVectorizationWarnings,semanticRuntimeAvailable:snapshot.semanticRuntimeAvailable,embeddingIdentityChanged,staleAfter}),staleBeforeDetail=selectStaleItemDetail(staleBefore,verboseStaleItems),staleAfterDetail=selectStaleItemDetail(staleAfter,verboseStaleItems),refreshAttempted=vectorizationRefreshAttempted(refreshPolicy,snapshot.semanticRuntimeAvailable,staleBefore);return{check:{name:"vectorization",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{semantic_runtime_available:snapshot.semanticRuntimeAvailable,compatibility_mode_auto_defaults:snapshot.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_applied:snapshot.runtimeDefaults.auto_ollama_defaults_applied,auto_ollama_defaults_skipped_reason:snapshot.runtimeDefaults.auto_ollama_defaults_skipped_reason??null,auto_ollama_defaults_remediation:snapshot.runtimeDefaults.auto_ollama_defaults_remediation??null,refresh_policy:buildVectorizationRefreshPolicyDetails(refreshPolicy),...buildVectorizationProviderDetails(settings,snapshot),embedding_identity_changed:embeddingIdentityChanged,embedding_identity_before:ledgerBefore.embedding??null,embedding_identity_runtime:snapshot.runtimeEmbeddingIdentity??null,items:items.length,ledger_entries_before:Object.keys(ledgerBefore.entries).length,stale_items_detail_mode:verboseStaleItems?"full":"summary",stale_items_summary_limit:STALE_VECTORIZATION_SUMMARY_LIMIT,stale_items_before_total:staleBeforeDetail.total,stale_items_before:staleBeforeDetail.values,stale_items_before_truncated:staleBeforeDetail.truncated,refresh_attempted:refreshAttempted,refresh_skipped_reason:resolveVectorizationRefreshSkippedReason(refreshPolicy,snapshot.semanticRuntimeAvailable,staleBefore),refresh_result:refreshResult,ledger_entries_after:Object.keys(ledgerAfter.entries).length,stale_items_after_total:staleAfterDetail.total,stale_items_after:staleAfterDetail.values,stale_items_after_truncated:staleAfterDetail.truncated}},warnings}}function validateSettingsValues(settings){const warnings=[];return settings.id_prefix.trim().length===0&&warnings.push("settings:id_prefix_empty"),settings.locks.ttl_seconds<=0&&warnings.push("settings:locks_ttl_non_positive"),warnings}function resolveVectorRefreshPolicy(options){const checkOnly=options.checkOnly===!0,refreshVectors=options.refreshVectors===!0;if(refreshVectors&&checkOnly)throw new PmCliError("--check-only cannot be combined with --refresh-vectors",EXIT_CODE.USAGE);if(refreshVectors&&options.noRefresh===!0)throw new PmCliError("--no-refresh cannot be combined with --refresh-vectors",EXIT_CODE.USAGE);return{enabled:refreshVectors,checkOnly,noRefresh:!refreshVectors,refreshVectors}}const HEALTH_CLONE_OPTIONAL_DIRECTORIES=new Set(["extensions","locks","search"]);function resolveHealthDirectoryLists(typeRegistry){const requiredDirSet=new Set(PM_CORE_REQUIRED_SUBDIRS.filter(entry=>entry.length>0)),optionalDirSet=new Set,builtinItemFolderSet=new Set(Object.values(TYPE_TO_FOLDER));for(const folder of typeRegistry.folders)requiredDirSet.has(folder)&&!builtinItemFolderSet.has(folder)||(requiredDirSet.delete(folder),optionalDirSet.add(folder));for(const folder of HEALTH_CLONE_OPTIONAL_DIRECTORIES)requiredDirSet.delete(folder),optionalDirSet.add(folder);return{requiredDirs:[...requiredDirSet].sort((left,right)=>left.localeCompare(right)),optionalDirs:[...optionalDirSet].sort((left,right)=>left.localeCompare(right)),optionalDirSet}}async function scanHealthDirectories(pmRoot,typeRegistry,strictDirectories){const{requiredDirs,optionalDirs,optionalDirSet}=resolveHealthDirectoryLists(typeRegistry),missingRequiredDirs=[],missingOptionalDirs=[],hookWarnings=[];for(const relativeDir of[...requiredDirs,...optionalDirs]){const directoryPath=path.join(pmRoot,relativeDir);hookWarnings.push(...await runActiveOnReadHooks({path:directoryPath,scope:"project"})),!await isDirectory(directoryPath)&&(optionalDirSet.has(relativeDir)?missingOptionalDirs.push(relativeDir):missingRequiredDirs.push(relativeDir))}return{requiredDirs,optionalDirs,missingRequiredDirs,missingOptionalDirs,missingDirs:strictDirectories?[...missingRequiredDirs,...missingOptionalDirs]:[...missingRequiredDirs],hookWarnings}}function resolveHealthSkipPolicy(options){const checkOnlyDefaultSummary=options.checkOnly===!0&&options.brief!==!0&&options.summary!==!0&&options.full!==!0,summaryMode=(options.summary===!0||checkOnlyDefaultSummary)&&options.full!==!0,fastProjectionCheckOnly=options.checkOnly===!0&&(options.brief===!0||options.summary===!0)&&options.full!==!0;return{summaryMode,skipIntegrity:(options.skipIntegrity===!0||fastProjectionCheckOnly)&&options.full!==!0,skipDrift:(options.skipDrift===!0||fastProjectionCheckOnly)&&options.full!==!0,skipVectors:(options.skipVectors===!0||fastProjectionCheckOnly)&&options.full!==!0}}async function readHealthItems(params){return params.skipPolicy.skipDrift&&params.skipPolicy.skipVectors?listAllItemMetadataLight(params.pmRoot,params.settings.item_format,params.typeRegistry.type_to_folder,params.itemReadWarnings,params.settings.schema):listAllItemMetadataWithBody(params.pmRoot,params.settings.item_format,params.typeRegistry.type_to_folder,params.itemReadWarnings,params.settings.schema)}function buildSkippedHealthCheck(name){return{check:{name,status:"ok",ok:!0,details:{skipped:!0}},warnings:[]}}function buildSettingsHealthCheck(settingsPath,settings,normalizedSettingsReadWarnings){return{name:"settings",status:normalizedSettingsReadWarnings.length===0?"ok":"warn",ok:normalizedSettingsReadWarnings.length===0,details:{path:settingsPath,version:settings.version,id_prefix:settings.id_prefix,locks_ttl_seconds:settings.locks.ttl_seconds,warnings:normalizedSettingsReadWarnings}}}function buildDirectoriesHealthCheck(directoryState,strictDirectories){return{name:"directories",status:directoryState.missingDirs.length===0?"ok":"warn",ok:directoryState.missingDirs.length===0,details:{required:directoryState.requiredDirs,optional:directoryState.optionalDirs,missing_required:directoryState.missingRequiredDirs,missing_optional:directoryState.missingOptionalDirs,missing:directoryState.missingDirs,strict_directories:strictDirectories}}}function buildSettingsValuesHealthCheck(settingWarnings,statusRoleDiagnostics){return{name:"settings_values",status:settingWarnings.length===0?"ok":"warn",ok:settingWarnings.length===0,details:{warnings:settingWarnings,...statusRoleDiagnostics.roleless_status_count>0?{lifecycle_status_roles:statusRoleDiagnostics}:{}}}}const resolveUnknownAuthorEventCount=authorAttribution=>authorAttribution.unknown_event_count??0,resolveActionableUnknownAuthorEventCount=authorAttribution=>authorAttribution.actionable_unknown_event_count??resolveUnknownAuthorEventCount(authorAttribution);function buildStorageHealthCheck(items,settings,historySummary,authorAttribution,staleInProgress,provenance){const unknownAuthorEventCount=resolveUnknownAuthorEventCount(authorAttribution),actionableUnknownAuthorEventCount=resolveActionableUnknownAuthorEventCount(authorAttribution),hasAuthorEvents=unknownAuthorEventCount>0,hasActionableAuthorWarnings=actionableUnknownAuthorEventCount>0,hasStaleInProgressItems=staleInProgress.count>0;return{name:"storage",status:historySummary.over_threshold.length===0&&historySummary.orphaned.length===0&&!hasActionableAuthorWarnings&&!hasStaleInProgressItems?"ok":"warn",ok:historySummary.over_threshold.length===0&&historySummary.orphaned.length===0&&!hasActionableAuthorWarnings&&!hasStaleInProgressItems,details:{items:items.length,history_streams:historySummary.count,tombstones:{retention_policy:"retain_append_only",gc_enabled:!1,count:historySummary.tombstones.length,ids:historySummary.tombstones.slice(0,25),truncated:historySummary.tombstones.length>25},orphaned_history_streams:{count:historySummary.orphaned.length,ids:historySummary.orphaned.slice(0,25),truncated:historySummary.orphaned.length>25},...hasAuthorEvents?{author_attribution:authorAttribution}:{},...hasStaleInProgressItems?{stale_in_progress:staleInProgress}:{},...provenance.outcomes.length>0?{provenance_resolver_outcomes:provenance.outcomes}:{},...provenance.invalid_values.length>0?{provenance_invalid_values:provenance.invalid_values}:{},provenance_sample:provenance.sample,...historySummary.max_entries!==null?{compact_policy:{enabled:settings.history.compact_policy.enabled,max_entries:historySummary.max_entries,trigger:settings.history.compact_policy.trigger,over_threshold_count:historySummary.over_threshold.length,over_threshold:historySummary.over_threshold}}:{}}}}function buildStaleInProgressHealthSummary(scan){const warnings=scan.count===0?[]:[`stale_in_progress_items:${scan.count}`];return{scan,warnings}}function collectHealthWarnings(params){const warnings=[...params.directoryState.missingDirs.map(dir=>`missing_directory:${dir}`),...params.normalizedSettingsReadWarnings,...params.settingWarnings,...params.normalizedItemReadWarnings,...params.telemetryCheck.warnings,...params.extensionCheck.warnings,...params.historyPolicyWarnings,...params.historySummary.warnings,...params.authorAttributionWarnings,...params.staleInProgressWarnings,...params.provenanceWarnings,...params.locksCheck.warnings,...params.integrityCheck.warnings,...params.historyDriftCheck.warnings,...params.vectorizationCheck.warnings,...params.directoryState.hookWarnings];return[...new Set(warnings)]}function extractHistoryDriftedCount(historyDriftCheck){const counts=historyDriftCheck.check.details.counts;return typeof counts?.drifted=="number"?counts.drifted:0}function buildHealthRemediationSources(params){return{settings:params.normalizedSettingsReadWarnings,directories:params.directoryState.missingDirs.map(dir=>`missing_directory:${dir}`).concat(params.directoryState.hookWarnings),settings_values:params.settingWarnings,telemetry:params.telemetryCheck.warnings,extensions:params.extensionCheck.warnings,storage:[...params.historyPolicyWarnings,...params.historySummary.warnings,...params.authorAttributionWarnings,...params.staleInProgressWarnings,...params.provenanceWarnings],locks:params.locksCheck.warnings,integrity:[...params.normalizedItemReadWarnings,...params.integrityCheck.warnings],history_drift:params.historyDriftCheck.warnings,vectorization:params.vectorizationCheck.warnings}}function buildHealthFindings(params){const owners=new Map;for(const[check,warnings]of Object.entries(params.remediationSources))for(const warning of warnings)owners.has(warning)||owners.set(warning,check);const checksByName=new Map(params.checks.map(check=>[check.name,check]));return params.warnings.map(warning=>{const check=owners.get(warning)??"integrity",code=resolveRemediation(warning)?.code??warningCode(warning),details=checksByName.get(check)?.details,remediationMap=typeof details?.remediation_map=="object"&&details.remediation_map!==null?details.remediation_map:{},remediation=code==="agent_guidance_outdated"?"pm init --agent-guidance add":code==="agent_guidance_unreadable"?"Check AGENTS.md and CLAUDE.md read permissions and file types, then retry pm health.":remediationMap[code],severity=isAdvisoryHealthWarning(warning,params.requireMergeDrivers)?"advisory":"gate_failing";return{warning,code,check,severity,...typeof remediation=="string"?{remediation}:severity==="gate_failing"?{disposition:"no_safe_automatic_remediation"}:{}}})}function rewriteBulkHealthRemediation(params){if(params.check.name==="history_drift"&&params.historyDriftedCount>1)for(const code of Object.keys(params.remediationMap))code!=="history_drift_merge_receipt"&&code!=="history_drift_version_skew"&&(params.remediationMap[code]="pm history-repair --all");if(params.check.name==="storage"&&params.overThresholdCount>1)for(const code of Object.keys(params.remediationMap))params.remediationMap[code]="pm history-compact --all-streams"}function attachHealthRemediationMaps(params){for(const check of params.checks){const remediationMap=buildRemediationMap(params.remediationSources[check.name]);rewriteBulkHealthRemediation({check,remediationMap,historyDriftedCount:params.historyDriftedCount,overThresholdCount:params.overThresholdCount}),Object.keys(remediationMap).length>0&&(check.details={...check.details,remediation_map:remediationMap})}}async function correlateMergeReceiptHistoryDriftItems(params){if(params.gitWorkspaceRoot===null||params.pendingMergeReceipts.length===0)return[];const details=params.historyDriftCheck.check.details,hashMismatches=Array.isArray(details.hash_mismatches)?details.hash_mismatches.filter(entry=>typeof entry=="string"):[],unsafeStreamIds=new Set([details.missing_streams,details.unreadable_streams,details.chain_mismatches].flatMap(value=>Array.isArray(value)?value:[])),receiptsByItem=new Map;for(const receipt of params.pendingMergeReceipts){const receipts=receiptsByItem.get(receipt.item_id)??[];receipts.push(receipt),receiptsByItem.set(receipt.item_id,receipts)}const attributed=[];for(const id of hashMismatches){if(unsafeStreamIds.has(id))continue;const receipts=receiptsByItem.get(id);if(!(!receipts||receipts.length===0))try{await runHistoryRepair(id,{dryRun:!0,mergeReceiptProof:{gitWorkspaceRoot:params.gitWorkspaceRoot,receipts}},params.global),attributed.push(id)}catch{}}return[...new Set(attributed)].sort((left,right)=>left.localeCompare(right))}function applyMergeReceiptHistoryDriftAttribution(historyDriftCheck,attributedItems){const attributed=new Set(attributedItems);historyDriftCheck.warnings=[...historyDriftCheck.warnings.filter(warning=>warning.startsWith("history_drift_hash_mismatch:")?!attributed.has(warning.slice(warning.indexOf(":")+1)):!0),...attributedItems.map(id=>`history_drift_merge_receipt:${id}`)].sort((left,right)=>left.localeCompare(right)),historyDriftCheck.check.details={...historyDriftCheck.check.details,merge_receipt_attributed_items:attributedItems}}async function runHealth(global2,options={}){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settingsPath=getSettingsPath(pmRoot),{settings,warnings:settingsReadWarnings}=await readSettingsWithMetadata(pmRoot),normalizedSettingsReadWarnings=[...new Set(settingsReadWarnings)],typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations()),strictDirectories=options.strictDirectories===!0,strictExit=options.strictExit===!0||options.failOnWarn===!0,requireMergeDrivers=options.requireMergeDrivers===!0||strictExit,refreshPolicy=resolveVectorRefreshPolicy(options),directoryState=await scanHealthDirectories(pmRoot,typeRegistry,strictDirectories),settingsValueWarnings=validateSettingsValues(settings),telemetryCheck=await buildTelemetryCheck(settings,{checkTelemetry:options.checkTelemetry===!0}),extensionCheck=await buildExtensionCheck(pmRoot,settings,!!global2.noExtensions),skipPolicy=resolveHealthSkipPolicy(options),itemReadWarnings=[],items=await readHealthItems({pmRoot,settings,typeRegistry,skipPolicy,itemReadWarnings}),itemsWithBody=items,statusRoleDiagnostics=inspectStatusRoleAssignments(resolveRuntimeStatusRegistry(settings.schema),items),settingWarnings=[...(await runInitAgentGuidance({pm_root:pmRoot,cwd:process.cwd(),mode:"status",interactive:!1,settings}).catch(()=>({warnings:["agent_guidance_unreadable:AGENTS.md,CLAUDE.md"]}))).warnings.filter(warning=>warning.startsWith("agent_guidance_")),...settingsValueWarnings,...buildStatusRoleWarnings(statusRoleDiagnostics)],historyPolicy=skipPolicy.skipDrift?{warnings:[]}:await enforceHistoryStreamPolicyForItems({pmRoot,settings,itemIds:items.map(item=>item.id),commandLabel:"health"}),historySummary=await countHistoryStreams(pmRoot,settings.history.compact_policy,await listStoredItemDocumentIds(pmRoot)),authorAttribution=await scanHistoryAuthorAttribution(pmRoot,20,options.verboseAuthorEvents===!0),actionableUnknownAuthorEventCount=resolveActionableUnknownAuthorEventCount(authorAttribution),authorAttributionWarnings=actionableUnknownAuthorEventCount>0?[`history_unknown_author_events:${actionableUnknownAuthorEventCount}`]:[],staleInProgress=buildStaleInProgressHealthSummary(await scanStaleInProgressItems(pmRoot,items,{in_progress_status:settings.schema.workflow.in_progress_status,threshold_hours:settings.mutation_guard.stale_in_progress_hours})),provenanceResolverHealth=await scanProvenanceResolverHealth(pmRoot),provenanceWarnings=provenanceResolverHealth.warnings,locksCheck=await buildLocksCheck(pmRoot),integrityCheck=skipPolicy.skipIntegrity&&!requireMergeDrivers?{...buildSkippedHealthCheck("integrity"),gitWorkspaceRoot:null,pendingMergeReceipts:[]}:await buildIntegrityCheck(pmRoot,typeRegistry.type_to_folder,settings.schema,settings,requireMergeDrivers,items),historyDriftCheck=skipPolicy.skipDrift?buildSkippedHealthCheck("history_drift"):await buildHistoryDriftCheck({pmRoot,items:itemsWithBody,settings,typeRegistry,itemReadWarnings}),normalizedItemReadWarnings=[...new Set(itemReadWarnings)],mergeReceiptAttributedHistoryDriftItems=await correlateMergeReceiptHistoryDriftItems({gitWorkspaceRoot:integrityCheck.gitWorkspaceRoot,pendingMergeReceipts:integrityCheck.pendingMergeReceipts,historyDriftCheck,global:global2});applyMergeReceiptHistoryDriftAttribution(historyDriftCheck,mergeReceiptAttributedHistoryDriftItems);const vectorizationCheck=skipPolicy.skipVectors?buildSkippedHealthCheck("vectorization"):await buildVectorizationCheck(pmRoot,settings,itemsWithBody,refreshPolicy,options.verboseStaleItems===!0),checks=[buildSettingsHealthCheck(settingsPath,settings,normalizedSettingsReadWarnings),buildDirectoriesHealthCheck(directoryState,strictDirectories),buildSettingsValuesHealthCheck(settingWarnings,statusRoleDiagnostics),telemetryCheck.check,extensionCheck.check,buildStorageHealthCheck(items,settings,historySummary,authorAttribution,staleInProgress.scan,provenanceResolverHealth),locksCheck.check,integrityCheck.check,historyDriftCheck.check,vectorizationCheck.check],normalizedWarnings=collectHealthWarnings({directoryState,normalizedSettingsReadWarnings,settingWarnings,normalizedItemReadWarnings,telemetryCheck,extensionCheck,historyPolicyWarnings:historyPolicy.warnings,historySummary,authorAttributionWarnings,staleInProgressWarnings:staleInProgress.warnings,provenanceWarnings,locksCheck,integrityCheck,historyDriftCheck,vectorizationCheck}),remediationSources=buildHealthRemediationSources({directoryState,normalizedSettingsReadWarnings,settingWarnings,normalizedItemReadWarnings,telemetryCheck,extensionCheck,historyPolicyWarnings:historyPolicy.warnings,historySummary,authorAttributionWarnings,staleInProgressWarnings:staleInProgress.warnings,provenanceWarnings,locksCheck,integrityCheck,historyDriftCheck,vectorizationCheck});attachHealthRemediationMaps({checks,remediationSources,historyDriftedCount:extractHistoryDriftedCount(historyDriftCheck),overThresholdCount:historySummary.over_threshold.length});const blockingWarnings=normalizedWarnings.filter(warning=>!isAdvisoryHealthWarning(warning,requireMergeDrivers)),findings=buildHealthFindings({warnings:normalizedWarnings,checks,remediationSources,requireMergeDrivers}),failingChecks=new Set(findings.filter(finding=>finding.severity==="gate_failing").map(finding=>finding.check)),warningChecks=new Set(findings.map(finding=>finding.check));for(const check of checks)check.ok=!failingChecks.has(check.name),warningChecks.has(check.name)&&(check.status="warn");const result={ok:blockingWarnings.length===0,verdict:{authority:"ok",...strictExit?{strict_exit:!0}:{},...requireMergeDrivers?{require_merge_drivers:!0}:{},exit_code:strictExit&&blockingWarnings.length>0?EXIT_CODE.GENERIC_FAILURE:0},checks,warnings:normalizedWarnings,findings,failed_because:blockingWarnings,generated_at:nowIso()};return projectHealthResult(result,options,skipPolicy.summaryMode)}const _testOnlyHealthCommand={buildHierarchyIntegrityWarnings,buildExtensionHealthTriageSummary,buildHealthFindings,buildCapabilityContractMetadata,buildStaleInProgressHealthSummary,buildVectorizationProviderDetails,collectUnknownCapabilityGuidance,isAdvisoryHealthWarning,isDirectory,isExpectedUnmanagedExtension,listItemDocumentPaths,normalizeEndpointForDisplay,normalizeExtensionNameForMatch,parseTelemetryQueue,probeTelemetryEndpointHealth,projectHealthResult,resolveActionableUnknownAuthorEventCount,resolveHealthSkipPolicy,resolveUnknownAuthorEventCount,resolveVectorRefreshPolicy,selectStaleItemDetail,summarizeHealthCheckDetails,summarizeExtensionList,summarizeRecordList,summarizeStringList,telemetryEnvFlagEnabled,warningCode};export{_testOnlyHealthCommand,runHealth};
 //# sourceMappingURL=health.js.map

package/dist/sdk/output/list-envelope.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="20b84c6a-ac5f-515e-aba1-32be7a69981c")}catch{}})();import{BRIEF_LIST_FIELDS}from"../query/projection-contracts.js";function isRecord(value){return value!==null&&typeof value=="object"&&!Array.isArray(value)}function hasStandardBriefProjection(value){if(!isRecord(value))return!1;const fields=value.fields;return value.mode==="brief"&&Object.keys(value).length===2&&Array.isArray(fields)&&fields.length===BRIEF_LIST_FIELDS.length&&BRIEF_LIST_FIELDS.every((field,index)=>fields[index]===field)}function hasStandardPagination(value,count){return typeof value.has_more=="boolean"&&value.truncated===value.has_more&&value.count===count&&typeof value.total=="number"&&Number.isSafeInteger(value.total)&&(value.has_more?value.total>count&&typeof value.next_cursor=="string"&&value.next_cursor.length>0:value.total===count&&value.next_cursor==null)}function hasCompactibleSource(value){return isRecord(value)&&(value.status==="complete"||value.status==="unchecked")&&value.unreadable_item_count===0&&value.unreadable_directory_count===0}function hasDefaultOmissions(value){if(!isRecord(value)||!Array.isArray(value.omitted_field_groups))return!1;const groups=value.omitted_field_groups,group=groups[0];return value.has_omissions===!0&&value.omitted_field_group_count===1&&Object.keys(value).length===3&&groups.length===1&&isRecord(group)&&Object.keys(group).length===2&&group.name==="full_item_fields"&&group.restore_with==="--full"}function projectPmBriefListEnvelope(value){if(!isRecord(value)||!Array.isArray(value.items)||Object.hasOwn(value,"details")||!hasStandardBriefProjection(value.projection)||!hasCompactibleSource(value.completeness)||!hasStandardPagination(value,value.items.length)||!hasDefaultOmissions(value.omission_receipt))return value;const{total,has_more:hasMore,truncated:_truncated,next_cursor:nextCursor,completeness,projection:_projection,now:_now,omission_receipt:_omissions,sorting,...rest}=value,completed=completeness.status==="complete"&&!hasMore&&Object.keys(completeness).length===3,{unreadable_item_count:_items,unreadable_directory_count:_directories,...source}=completeness;return{...rest,...completed?{}:{total,has_more:hasMore,completeness:source},...hasMore?{next_cursor:nextCursor}:{},...isRecord(sorting)&&sorting.sort==="default"&&sorting.order==="asc"&&Object.keys(sorting).length===2?{}:{sorting},details:"--full"}}export{projectPmBriefListEnvelope};
+(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]="95103919-d686-5c3b-bd51-928f5b2314ef")}catch{}})();import{BRIEF_LIST_FIELDS}from"../query/projection-contracts.js";function isRecord(value){return value!==null&&typeof value=="object"&&!Array.isArray(value)}function hasStandardBriefProjection(value){if(!isRecord(value))return!1;const fields=value.fields;return value.mode==="brief"&&Object.keys(value).length===2&&Array.isArray(fields)&&(fields.length===BRIEF_LIST_FIELDS.length||fields.length===BRIEF_LIST_FIELDS.length+1&&fields.at(-1)==="priority")&&BRIEF_LIST_FIELDS.every((field,index)=>fields[index]===field)}function hasStandardPagination(value,count){return typeof value.has_more=="boolean"&&value.truncated===value.has_more&&value.count===count&&typeof value.total=="number"&&Number.isSafeInteger(value.total)&&(value.has_more?value.total>count&&typeof value.next_cursor=="string"&&value.next_cursor.length>0:value.total===count&&value.next_cursor==null)}function hasCompactibleSource(value){return isRecord(value)&&(value.status==="complete"||value.status==="unchecked")&&value.unreadable_item_count===0&&value.unreadable_directory_count===0}function hasDefaultOmissions(value){if(!isRecord(value)||!Array.isArray(value.omitted_field_groups))return!1;const groups=value.omitted_field_groups,group=groups[0];return value.has_omissions===!0&&value.omitted_field_group_count===1&&Object.keys(value).length===3&&groups.length===1&&isRecord(group)&&Object.keys(group).length===2&&group.name==="full_item_fields"&&group.restore_with==="--full"}function projectPmBriefListEnvelope(value){if(!isRecord(value)||!Array.isArray(value.items)||Object.hasOwn(value,"details")||!hasStandardBriefProjection(value.projection)||!hasCompactibleSource(value.completeness)||!hasStandardPagination(value,value.items.length)||!hasDefaultOmissions(value.omission_receipt))return value;const{total,has_more:hasMore,truncated:_truncated,next_cursor:nextCursor,completeness,projection:_projection,now:_now,omission_receipt:_omissions,sorting,...rest}=value,completed=completeness.status==="complete"&&!hasMore&&Object.keys(completeness).length===3,{unreadable_item_count:_items,unreadable_directory_count:_directories,...source}=completeness;return{...rest,...completed?{}:{total,has_more:hasMore,completeness:source},...hasMore?{next_cursor:nextCursor}:{},...isRecord(sorting)&&sorting.sort==="default"&&sorting.order==="asc"&&Object.keys(sorting).length===2?{}:{sorting},details:"--full"}}export{projectPmBriefListEnvelope};
 //# sourceMappingURL=list-envelope.js.map

package/dist/sdk/pagination.d.ts

@@ -41,13 +41,13 @@ export declare function createQueryFingerprint(command:string,contract:unknown):
 /** Encode the last emitted item id into a versioned opaque base64url cursor. */
 export declare function encodeQueryCursor(fingerprint:string,afterId:string,afterIndex?:number,snapshot?:string):string;
 /** Decode and validate an opaque cursor without imposing caller query identity. */
-export declare function decodeQueryCursorEnvelope(cursor:unknown):QueryCursorEnvelope;
+export declare function decodeQueryCursorEnvelope(cursor:unknown,cursorFlag?:"--after" | "--cursor"):QueryCursorEnvelope;
 /** Decode and validate complete cursor state against a query fingerprint. */
-export declare function decodeQueryCursorState(cursor:unknown,expectedFingerprint:string):QueryCursorState;
+export declare function decodeQueryCursorState(cursor:unknown,expectedFingerprint:string,cursorFlag?:"--after" | "--cursor"):QueryCursorState;
 /** Decode and validate a cursor against the normalized query fingerprint. */
 export declare function decodeQueryCursor(cursor:unknown,expectedFingerprint:string):string;
 /** Resolve the first row after a validated cursor's stable id tiebreaker. */
-export declare function resolveQueryCursorStart<T>(rows:readonly T[],cursor:string | undefined,fingerprint:string,readId:(row:T) => string):number;
+export declare function resolveQueryCursorStart<T>(rows:readonly T[],cursor:string | undefined,fingerprint:string,readId:(row:T) => string,cursorFlag?:"--after" | "--cursor"):number;
 /** Page an ordered result through the shared stable cursor contract. */
 export declare function paginateQueryRows<T>(rows:readonly T[],options:{
 cursor?:string;

package/dist/sdk/pagination.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="400de68f-104b-5a25-9e79-f69da940832f")}catch{}})();import{READ_OUTPUT_DIMENSION_FLAGS,READ_OUTPUT_COMPOSITION_FLAGS}from"./read-output/options.js";import{createHash}from"node:crypto";import{PmCliError}from"../core/shared/errors.js";import{EXIT_CODE}from"../core/shared/constants.js";import{stableStringify}from"../core/shared/serialization.js";import{decodeReadOutputContinuationCursor}from"./read-output/continuation.js";const QUERY_CURSOR_VERSION=1,MAX_CURSOR_LENGTH=4096,BASE64URL_PATTERN=/^[A-Za-z0-9_-]+$/;function optionKeyForFlag(flag){return flag.replace(/^--/u,"").replace(/[-_]([a-z0-9])/gu,(_,character)=>character.toUpperCase())}function selectCursorSemanticOptions(options,contracts){const universalFlags=[...Object.values(READ_OUTPUT_DIMENSION_FLAGS),...READ_OUTPUT_COMPOSITION_FLAGS],presentationKeys=new Set(universalFlags.flatMap(flag=>[optionKeyForFlag(flag),flag.slice(2).replaceAll("-","_")]));for(const contract of contracts)if(contract.cursor_semantics==="presentation"){presentationKeys.add(optionKeyForFlag(contract.flag));for(const alias of contract.aliases??[])presentationKeys.add(optionKeyForFlag(alias))}return Object.fromEntries(Object.entries(options).filter(([key])=>!presentationKeys.has(key)))}function createQueryFingerprint(command,contract){return createHash("sha256").update(command).update("\0").update(stableStringify(contract)).digest("hex").slice(0,24)}function encodeQueryCursor(fingerprint,afterId,afterIndex,snapshot){return Buffer.from(JSON.stringify({version:QUERY_CURSOR_VERSION,fingerprint,after_id:afterId,...afterIndex===void 0?{}:{after_index:afterIndex},...snapshot===void 0?{}:{snapshot}})).toString("base64url")}function invalidCursor(message){return new PmCliError(message,EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:["Repeat the original query without --after to obtain a fresh cursor."]})}function isQueryCursorEnvelope(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const envelope=value;return envelope.version===QUERY_CURSOR_VERSION&&typeof envelope.fingerprint=="string"&&typeof envelope.after_id=="string"&&envelope.after_id.length>0&&(envelope.after_index===void 0||Number.isSafeInteger(envelope.after_index)&&envelope.after_index>=0)&&(envelope.snapshot===void 0||typeof envelope.snapshot=="string"&&envelope.snapshot.length>0)}function decodeQueryCursorEnvelope(cursor){if(typeof cursor!="string")throw invalidCursor("Query cursor is malformed.");const normalized=cursor.trim();if(normalized.length===0||normalized.length>MAX_CURSOR_LENGTH||!BASE64URL_PATTERN.test(normalized))throw invalidCursor("Query cursor is malformed.");let parsed;try{parsed=JSON.parse(Buffer.from(normalized,"base64url").toString("utf8"))}catch{throw invalidCursor("Query cursor is malformed.")}if(!isQueryCursorEnvelope(parsed)){let outputCursor=!1;try{decodeReadOutputContinuationCursor(normalized),outputCursor=!0}catch{}throw outputCursor?new PmCliError("An output cursor must be continued with --output-cursor, not --after.",EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:[`Repeat the same query, replacing --after with --output-cursor ${normalized}; retain any producer --after cursor from the original page.`]}):invalidCursor("Query cursor version or payload is unsupported.")}return parsed}function decodeQueryCursorState(cursor,expectedFingerprint){const envelope=decodeQueryCursorEnvelope(cursor);if(envelope.fingerprint!==expectedFingerprint)throw invalidCursor(`Query cursor does not match the current filters, sort, or query (${envelope.fingerprint} != ${expectedFingerprint}).`);return{after_id:envelope.after_id,...envelope.after_index===void 0?{}:{after_index:envelope.after_index},...envelope.snapshot===void 0?{}:{snapshot:envelope.snapshot}}}function decodeQueryCursor(cursor,expectedFingerprint){return decodeQueryCursorState(cursor,expectedFingerprint).after_id}function resolveQueryCursorStart(rows,cursor,fingerprint,readId){if(cursor===void 0)return 0;const state=decodeQueryCursorState(cursor,fingerprint),index=rows.findIndex(row=>readId(row)===state.after_id);if(index<0){if(state.after_index!==void 0)return Math.min(state.after_index,rows.length);throw invalidCursor(`Query cursor item ${state.after_id} is no longer present in this result set.`)}return index+1}function paginateQueryRows(rows,options){if(options.cursor!==void 0&&decodeQueryCursorState(options.cursor,options.fingerprint).snapshot!==options.snapshot)throw invalidCursor("Query cursor does not match the requested snapshot.");const pageStart=resolveQueryCursorStart(rows,options.cursor,options.fingerprint,options.readId),pageRows=rows.slice(pageStart,pageStart+options.limit),hasMore=pageRows.length>0&&pageStart+pageRows.length<rows.length,lastRow=pageRows.at(-1);return{rows:pageRows,has_more:hasMore,...hasMore&&lastRow!==void 0?{next_cursor:encodeQueryCursor(options.fingerprint,options.readId(lastRow),pageStart+pageRows.length-1,options.snapshot)}:{}}}const QUERY_CURSOR_CONTRACT=Object.freeze({version:QUERY_CURSOR_VERSION,max_length:MAX_CURSOR_LENGTH});export{QUERY_CURSOR_CONTRACT,createQueryFingerprint,decodeQueryCursor,decodeQueryCursorEnvelope,decodeQueryCursorState,encodeQueryCursor,paginateQueryRows,resolveQueryCursorStart,selectCursorSemanticOptions};
+(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]="b6a81cf4-3095-5197-8e73-f017d98b1ccf")}catch{}})();import{READ_OUTPUT_DIMENSION_FLAGS,READ_OUTPUT_COMPOSITION_FLAGS}from"./read-output/options.js";import{createHash}from"node:crypto";import{PmCliError}from"../core/shared/errors.js";import{EXIT_CODE}from"../core/shared/constants.js";import{stableStringify}from"../core/shared/serialization.js";import{decodeReadOutputContinuationCursor}from"./read-output/continuation.js";const QUERY_CURSOR_VERSION=1,MAX_CURSOR_LENGTH=4096,BASE64URL_PATTERN=/^[A-Za-z0-9_-]+$/;function optionKeyForFlag(flag){return flag.replace(/^--/u,"").replace(/[-_]([a-z0-9])/gu,(_,character)=>character.toUpperCase())}function selectCursorSemanticOptions(options,contracts){const universalFlags=[...Object.values(READ_OUTPUT_DIMENSION_FLAGS),...READ_OUTPUT_COMPOSITION_FLAGS],presentationKeys=new Set(universalFlags.flatMap(flag=>[optionKeyForFlag(flag),flag.slice(2).replaceAll("-","_")]));for(const contract of contracts)if(contract.cursor_semantics==="presentation"){presentationKeys.add(optionKeyForFlag(contract.flag));for(const alias of contract.aliases??[])presentationKeys.add(optionKeyForFlag(alias))}return Object.fromEntries(Object.entries(options).filter(([key])=>!presentationKeys.has(key)))}function createQueryFingerprint(command,contract){return createHash("sha256").update(command).update("\0").update(stableStringify(contract)).digest("hex").slice(0,24)}function encodeQueryCursor(fingerprint,afterId,afterIndex,snapshot){return Buffer.from(JSON.stringify({version:QUERY_CURSOR_VERSION,fingerprint,after_id:afterId,...afterIndex===void 0?{}:{after_index:afterIndex},...snapshot===void 0?{}:{snapshot}})).toString("base64url")}function invalidCursor(message,cursorFlag){return new PmCliError(message,EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:[`Repeat the original query without ${cursorFlag} to obtain a fresh cursor.`]})}function isQueryCursorEnvelope(value){if(typeof value!="object"||value===null||Array.isArray(value))return!1;const envelope=value;return envelope.version===QUERY_CURSOR_VERSION&&typeof envelope.fingerprint=="string"&&typeof envelope.after_id=="string"&&envelope.after_id.length>0&&(envelope.after_index===void 0||Number.isSafeInteger(envelope.after_index)&&envelope.after_index>=0)&&(envelope.snapshot===void 0||typeof envelope.snapshot=="string"&&envelope.snapshot.length>0)}function decodeQueryCursorEnvelope(cursor,cursorFlag="--after"){if(typeof cursor!="string")throw invalidCursor("Query cursor is malformed.",cursorFlag);const normalized=cursor.trim();if(normalized.length===0||normalized.length>MAX_CURSOR_LENGTH||!BASE64URL_PATTERN.test(normalized))throw invalidCursor("Query cursor is malformed.",cursorFlag);let parsed;try{parsed=JSON.parse(Buffer.from(normalized,"base64url").toString("utf8"))}catch{throw invalidCursor("Query cursor is malformed.",cursorFlag)}if(!isQueryCursorEnvelope(parsed)){let outputCursor=!1;try{decodeReadOutputContinuationCursor(normalized),outputCursor=!0}catch{}throw outputCursor?new PmCliError(`An output cursor must be continued with --output-cursor, not ${cursorFlag}.`,EXIT_CODE.USAGE,{code:"invalid_query_cursor",nextSteps:[`Repeat the same query, replacing ${cursorFlag} with --output-cursor ${normalized}; retain any producer ${cursorFlag} cursor from the original page.`]}):invalidCursor("Query cursor version or payload is unsupported.",cursorFlag)}return parsed}function decodeQueryCursorState(cursor,expectedFingerprint,cursorFlag="--after"){const envelope=decodeQueryCursorEnvelope(cursor,cursorFlag);if(envelope.fingerprint!==expectedFingerprint)throw invalidCursor(`Query cursor does not match the current filters, sort, or query (${envelope.fingerprint} != ${expectedFingerprint}).`,cursorFlag);return{after_id:envelope.after_id,...envelope.after_index===void 0?{}:{after_index:envelope.after_index},...envelope.snapshot===void 0?{}:{snapshot:envelope.snapshot}}}function decodeQueryCursor(cursor,expectedFingerprint){return decodeQueryCursorState(cursor,expectedFingerprint).after_id}function resolveQueryCursorStart(rows,cursor,fingerprint,readId,cursorFlag="--after"){if(cursor===void 0)return 0;const state=decodeQueryCursorState(cursor,fingerprint,cursorFlag),index=rows.findIndex(row=>readId(row)===state.after_id);if(index<0){if(state.after_index!==void 0)return Math.min(state.after_index,rows.length);throw invalidCursor(`Query cursor item ${state.after_id} is no longer present in this result set.`,cursorFlag)}return index+1}function paginateQueryRows(rows,options){if(options.cursor!==void 0&&decodeQueryCursorState(options.cursor,options.fingerprint).snapshot!==options.snapshot)throw invalidCursor("Query cursor does not match the requested snapshot.","--after");const pageStart=resolveQueryCursorStart(rows,options.cursor,options.fingerprint,options.readId),pageRows=rows.slice(pageStart,pageStart+options.limit),hasMore=pageRows.length>0&&pageStart+pageRows.length<rows.length,lastRow=pageRows.at(-1);return{rows:pageRows,has_more:hasMore,...hasMore&&lastRow!==void 0?{next_cursor:encodeQueryCursor(options.fingerprint,options.readId(lastRow),pageStart+pageRows.length-1,options.snapshot)}:{}}}const QUERY_CURSOR_CONTRACT=Object.freeze({version:QUERY_CURSOR_VERSION,max_length:MAX_CURSOR_LENGTH});export{QUERY_CURSOR_CONTRACT,createQueryFingerprint,decodeQueryCursor,decodeQueryCursorEnvelope,decodeQueryCursorState,encodeQueryCursor,paginateQueryRows,resolveQueryCursorStart,selectCursorSemanticOptions};
 //# sourceMappingURL=pagination.js.map