@unbrained/pm-cli 2026.9.8 → 2026.9.10

package/dist/sdk/governance/validate.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b1568b48-792c-51f3-898c-f68f8746252f")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import fs from"node:fs/promises";import{realpathSync}from"node:fs";import{execFile}from"node:child_process";import path from"node:path";import{promisify}from"node:util";import{buildRemediationCommands}from"../../core/diagnostics/remediation.js";import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{collectRegisteredItemFieldNames}from"../../core/extensions/item-fields.js";import{isFileMissingError}from"../../core/fs/fs-utils.js";import{normalizeStatusInput}from"../../core/item/status.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,EXIT_CODE,PM_DIRNAME,SETTINGS_DEFAULTS}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{toNonEmptyStringOrUndefined}from"../../core/shared/primitives.js";import{nowIso}from"../../core/shared/time.js";import{CURRENT_ITEM_FORMAT_VERSION,effectiveItemFormatVersion,scanItemFormatVersions}from"../../core/item/item-format-version.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{partitionFixesByGrant,planCloseReasonBackfillFixes,planEstimateBackfillFixes,planResolutionBackfillFixes,planStaleLinkPruneFixes,planTerminalParentFixes,resolveGrantedFixScopes,toFixOutputRow}from"../../core/validate/fix-planning.js";import{findDuplicateIssueCodes}from"../../core/governance/issue-codes.js";import{buildMissingByTypeCounts}from"../../core/validate/missing-by-type.js";import{classifyStaleLinkedPaths,summarizeStaleLinkedPathClassifications}from"../../core/validate/stale-file-classification.js";import{isRemoteLinkedArtifactReference}from"../../core/validate/linked-artifact-reference.js";import{assertProjectionModeChoice}from"../output-projection.js";import{collectDanglingDependencyReferences}from"../graph/assembly.js";import{auditMergeAttributeFence,auditMergeDriverConfiguration,findGitWorkspaceRoot,resolveProjectMergeTypeFolders}from"../merge/install.js";import{inspectMergeReceiptEvidence,partitionMergeReceipts}from"../merge/receipts.js";import{buildLinkedFileRepairReport}from"./linked-file-report.js";import{scanStorageIntegrity}from"./storage-integrity.js";import{scanTrackedRuntimeCache}from"./tracked-runtime-cache.js";import{scanHistoryAuthorAttribution}from"../author-attribution.js";import{createRelationshipKindRegistry}from"../relationships.js";import{runDocs}from"../docs.js";import{runFiles}from"../files.js";import{extractReferencedPmItemIdsFromCommand}from"../test/linked-command-detection.js";import{resolveLinkedTestSourceRef,resolveLinkedTestSourceWorkspaceRoot,resolveLinkedTestTrustBatch}from"../test/trust.js";import{readValidateItems}from"./validate-item-reader.js";import{buildValidateHistoryDriftCheck}from"./validate-history-drift.js";import{buildLifecycleParentGraph,detectLifecycleParentCycles,resolveLifecycleDependencyCycleSamplePath}from"./hierarchy-validation.js";import{buildStatusRoleWarnings,inspectStatusRoleAssignments}from"./status-role-diagnostics.js";import{normalizeRelativeDirectoryPath,normalizeRelativePath,toMeaningfulString}from"./validate-normalization.js";const FILE_SCAN_DIRECTORIES=["src","tests","docs"];const FILE_SCAN_ROOT_FILES=["README.md","PRD.md","CHANGELOG.md","AGENTS.md","CONTRIBUTING.md","SECURITY.md","CODE_OF_CONDUCT.md","LICENSE"];const DIRECTORY_IGNORE_SET=new Set(["node_modules",".git",".cursor",".agents","dist","coverage"]);const RESOLUTION_FIELD_KEYS=["resolution","expected_result","actual_result"];const VALIDATE_FILE_SCAN_MODES=["default","tracked-all","tracked-all-strict"];const VALIDATE_METADATA_PROFILE_VALUES=["core","strict","custom"];const VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES=["off","warn","error"];const CORE_METADATA_REQUIRED_FIELDS=["author","acceptance_criteria","estimated_minutes","close_reason"];const STRICT_METADATA_REQUIRED_FIELDS=[...CORE_METADATA_REQUIRED_FIELDS,"reviewer","risk","confidence","sprint","release"];const SUPPORTED_METADATA_REQUIRED_FIELDS=Array.from(new Set(STRICT_METADATA_REQUIRED_FIELDS));const METADATA_REQUIRED_FIELD_ALIASES={author:"author",acceptance_criteria:"acceptance_criteria","acceptance-criteria":"acceptance_criteria",estimated_minutes:"estimated_minutes","estimated-minutes":"estimated_minutes",estimate:"estimated_minutes",close_reason:"close_reason","close-reason":"close_reason",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release"};const METADATA_WARNING_TOKEN_BY_FIELD={author:"validate_metadata_missing_author",acceptance_criteria:"validate_metadata_missing_acceptance_criteria",estimated_minutes:"validate_metadata_missing_estimate",close_reason:"validate_metadata_missing_close_reason",reviewer:"validate_metadata_missing_reviewer",risk:"validate_metadata_missing_risk",confidence:"validate_metadata_missing_confidence",sprint:"validate_metadata_missing_sprint",release:"validate_metadata_missing_release"};const METADATA_COUNT_KEY_BY_FIELD={author:"missing_author",acceptance_criteria:"missing_acceptance_criteria",estimated_minutes:"missing_estimated_minutes",close_reason:"closed_missing_close_reason",reviewer:"missing_reviewer",risk:"missing_risk",confidence:"missing_confidence",sprint:"missing_sprint",release:"missing_release"};const METADATA_ITEM_IDS_KEY_BY_FIELD={author:"missing_author_item_ids",acceptance_criteria:"missing_acceptance_criteria_item_ids",estimated_minutes:"missing_estimated_minutes_item_ids",close_reason:"closed_missing_close_reason_item_ids",reviewer:"missing_reviewer_item_ids",risk:"missing_risk_item_ids",confidence:"missing_confidence_item_ids",sprint:"missing_sprint_item_ids",release:"missing_release_item_ids"};const METADATA_TRUNCATED_KEY_BY_FIELD={author:"missing_author_truncated",acceptance_criteria:"missing_acceptance_criteria_truncated",estimated_minutes:"missing_estimated_minutes_truncated",close_reason:"closed_missing_close_reason_truncated",reviewer:"missing_reviewer_truncated",risk:"missing_risk_truncated",confidence:"missing_confidence_truncated",sprint:"missing_sprint_truncated",release:"missing_release_truncated"};const GIT_LS_FILES_MAX_BUFFER=32*1024*1024;const GIT_LS_FILES_TIMEOUT_MS=1e4;const FILE_LIST_SUMMARY_LIMIT=40;const DIAGNOSTIC_LIST_SUMMARY_LIMIT=5;const LINKED_ARTIFACT_MAX_PATH_LENGTH=4096;const LINKED_ARTIFACT_MAX_SEGMENT_LENGTH=255;const execFileAsync=promisify(execFile);function projectValidateCountsRecord(record){const projected={};for(const[key,value]of Object.entries(record)){if(Array.isArray(value)||value===false&&key.endsWith("_truncated")){continue}projected[key]=typeof value==="object"&&value!==null?projectValidateCountsRecord(value):value}return projected}function projectValidateCounts(result){return{...result,checks:result.checks.map(check=>({...check,details:projectValidateCountsRecord(check.details)})),...result.fixes?{fixes:{mode:result.fixes.mode,auto_fix:result.fixes.auto_fix,prune_missing:result.fixes.prune_missing,planned_count:result.fixes.planned_count,applied_count:result.fixes.applied_count,gated_count:result.fixes.gated_count,failed_count:result.fixes.failed_count}}:{}}}function normalizeStatusForRegistry(status,statusRegistry){return normalizeStatusInput(status,statusRegistry)??status}function isTerminalStatus(status,statusRegistry){return statusRegistry.terminal_statuses.has(normalizeStatusForRegistry(status,statusRegistry))}function normalizeLifecyclePatternList(values){return[...new Set((values??[]).map(value=>value.trim().toLowerCase()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function areSortedStringListsEqual(left,right){if(left.length!==right.length){return false}return left.every((value,index)=>value===right[index])}function resolveLifecyclePatternPolicy(settings){const defaultStalePatterns=normalizeLifecyclePatternList(DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS);const defaultClosureLikePatterns={blocked_reason:normalizeLifecyclePatternList(DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.blocked_reason),resolution:normalizeLifecyclePatternList(DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution),actual_result:normalizeLifecyclePatternList(DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result)};const staleBlockerReasonPatterns=normalizeLifecyclePatternList(settings.validation.lifecycle_stale_blocker_reason_patterns);const closureLikePatterns={blocked_reason:normalizeLifecyclePatternList(settings.validation.lifecycle_closure_like_blocked_reason_patterns),resolution:normalizeLifecyclePatternList(settings.validation.lifecycle_closure_like_resolution_patterns),actual_result:normalizeLifecyclePatternList(settings.validation.lifecycle_closure_like_actual_result_patterns)};return{stale_blocker_reason_patterns:staleBlockerReasonPatterns,stale_blocker_reason_pattern_source:areSortedStringListsEqual(staleBlockerReasonPatterns,defaultStalePatterns)?"default":"settings",closure_like_metadata_field_patterns:closureLikePatterns,closure_like_metadata_field_pattern_sources:{blocked_reason:areSortedStringListsEqual(closureLikePatterns.blocked_reason,defaultClosureLikePatterns.blocked_reason)?"default":"settings",resolution:areSortedStringListsEqual(closureLikePatterns.resolution,defaultClosureLikePatterns.resolution)?"default":"settings",actual_result:areSortedStringListsEqual(closureLikePatterns.actual_result,defaultClosureLikePatterns.actual_result)?"default":"settings"}}}function resolveValidateMetadataProfile(value){const normalized=value?.trim().toLowerCase();if(!normalized||normalized.length===0){return"core"}if(VALIDATE_METADATA_PROFILE_VALUES.includes(normalized)){return normalized}throw new PmCliError(`Unknown --metadata-profile value "${value}". Supported values: ${VALIDATE_METADATA_PROFILE_VALUES.join(", ")}.`,EXIT_CODE.USAGE)}function resolveDependencyCycleSeverity(value){const normalized=value?.trim().toLowerCase();if(!normalized||normalized.length===0){return"warn"}if(VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.includes(normalized)){return normalized}throw new PmCliError(`Unknown --dependency-cycle-severity value "${value}". Supported values: ${VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.join(", ")}.`,EXIT_CODE.USAGE)}function resolveParentCycleSeverity(value){const normalized=value?.trim().toLowerCase();if(!normalized||normalized.length===0){return"warn"}if(VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.includes(normalized)){return normalized}throw new PmCliError(`Unknown --parent-cycle-severity value "${value}". Supported values: ${VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.join(", ")}.`,EXIT_CODE.USAGE)}function normalizeMetadataRequiredFieldsFromSettings(values){const normalized=[...new Set((values??[]).map(value=>value.trim().toLowerCase().replaceAll("-","_")))];return normalized.map(value=>METADATA_REQUIRED_FIELD_ALIASES[value]).filter(value=>value!==void 0).sort((left,right)=>left.localeCompare(right))}function resolveValidateMetadataPolicy(profile,profileSource,configuredCustomFields){const normalizedCustomFields=normalizeMetadataRequiredFieldsFromSettings(configuredCustomFields);if(profile==="core"){return{profile,profile_source:profileSource,required_fields:[...CORE_METADATA_REQUIRED_FIELDS],configured_custom_fields:normalizedCustomFields,fallback_to_core:false,warnings:[]}}if(profile==="strict"){return{profile,profile_source:profileSource,required_fields:[...STRICT_METADATA_REQUIRED_FIELDS],configured_custom_fields:normalizedCustomFields,fallback_to_core:false,warnings:[]}}if(normalizedCustomFields.length>0){return{profile,profile_source:profileSource,required_fields:normalizedCustomFields,configured_custom_fields:normalizedCustomFields,fallback_to_core:false,warnings:[]}}return{profile,profile_source:profileSource,required_fields:[...CORE_METADATA_REQUIRED_FIELDS],configured_custom_fields:normalizedCustomFields,fallback_to_core:true,warnings:["validate_metadata_custom_profile_missing_required_fields:0"]}}const TERMINAL_EXEMPT_PLANNING_FIELDS=new Set(["acceptance_criteria","estimated_minutes"]);function isMetadataFieldMissing(item,field,statusRegistry,enforcePlanningFieldsOnTerminal){if(!enforcePlanningFieldsOnTerminal&&TERMINAL_EXEMPT_PLANNING_FIELDS.has(field)&&isTerminalStatus(item.status,statusRegistry)){return false}if(field==="author"){return!toNonEmptyStringOrUndefined(item.author)}if(field==="acceptance_criteria"){return!toNonEmptyStringOrUndefined(item.acceptance_criteria)}if(field==="estimated_minutes"){return!Number.isFinite(item.estimated_minutes)}if(field==="close_reason"){return normalizeStatusForRegistry(item.status,statusRegistry)===statusRegistry.close_status&&!toNonEmptyStringOrUndefined(item.close_reason)}if(field==="reviewer"){return!toNonEmptyStringOrUndefined(item.reviewer)}if(field==="risk"){return!toNonEmptyStringOrUndefined(item.risk)}if(field==="confidence"){if(typeof item.confidence==="number"){return!Number.isFinite(item.confidence)}return!toNonEmptyStringOrUndefined(item.confidence)}if(field==="sprint"){return!toNonEmptyStringOrUndefined(item.sprint)}return!toNonEmptyStringOrUndefined(item.release)}function resolveFileScanMode(scanMode){if(scanMode===void 0){return"default"}const normalized=scanMode.trim().toLowerCase();if(normalized.length===0){return"default"}if(normalized==="default"){return"default"}if(normalized==="tracked-all"||normalized==="tracked_all"){return"tracked-all"}if(normalized==="tracked-all-strict"||normalized==="tracked_all_strict"){return"tracked-all-strict"}throw new PmCliError(`Unknown --scan-mode value "${scanMode}". Supported values: ${VALIDATE_FILE_SCAN_MODES.join(", ")}.`,EXIT_CODE.USAGE)}function resolveWorkspaceRoot(pmRoot){const sourceWorkspaceRoot=process.env.PM_SOURCE_WORKSPACE_ROOT?.trim();if(sourceWorkspaceRoot){return path.resolve(sourceWorkspaceRoot)}const resolvedPmRoot=path.resolve(pmRoot);const normalizedPmRoot=resolvedPmRoot.replaceAll("\\","/");if(normalizedPmRoot.endsWith("/.agents/pm")){return path.dirname(path.dirname(resolvedPmRoot))}const resolvedCwd=path.resolve(process.cwd());const canonicalPmRoot=realpathForWorkspaceRoot(resolvedPmRoot);const canonicalCwd=realpathForWorkspaceRoot(resolvedCwd);const relativeFromPmRoot=path.relative(canonicalPmRoot,canonicalCwd);const cwdInsidePmRoot=relativeFromPmRoot.length===0||!relativeFromPmRoot.startsWith("..")&&!path.isAbsolute(relativeFromPmRoot);if(cwdInsidePmRoot){return resolvedPmRoot}return resolvedCwd}function realpathForWorkspaceRoot(inputPath){try{return realpathSync.native(inputPath)}catch{return path.resolve(inputPath)}}function hasFilesystemErrorCode(error,acceptedCodes){return typeof error==="object"&&error!==null&&"code"in error&&typeof error.code==="string"&&acceptedCodes.includes(error.code)}async function listFilesRecursive(basePath,relativePath,output){const targetDirectory=relativePath.length>0?path.join(basePath,relativePath):basePath;let entries;try{entries=await fs.readdir(targetDirectory,{withFileTypes:true})}catch(error){if(isFileMissingError(error)){return}throw error}for(const entry of entries){if(entry.name.startsWith(".")){continue}const childRelative=relativePath.length>0?path.join(relativePath,entry.name):entry.name;if(entry.isDirectory()){if(DIRECTORY_IGNORE_SET.has(entry.name)){continue}await listFilesRecursive(basePath,childRelative,output);continue}if(!entry.isFile()){continue}output.push(normalizeRelativePath(childRelative))}}async function collectDefaultProjectFileCandidates(workspaceRoot){const discovered=[];for(const directory of FILE_SCAN_DIRECTORIES){await listFilesRecursive(workspaceRoot,directory,discovered)}for(const candidate of FILE_SCAN_ROOT_FILES){const absolute=path.join(workspaceRoot,candidate);try{const stats=await fs.stat(absolute);if(stats.isFile()){discovered.push(normalizeRelativePath(candidate))}}catch{}}return[...new Set(discovered)].sort((left,right)=>left.localeCompare(right))}async function collectTrackedGitFileCandidates(workspaceRoot){try{const{stdout}=await execFileAsync("git",["ls-files","-z"],{cwd:workspaceRoot,encoding:"utf8",maxBuffer:GIT_LS_FILES_MAX_BUFFER,windowsHide:true,timeout:GIT_LS_FILES_TIMEOUT_MS});const discovered=stdout.split("\0").map(value=>normalizeRelativePath(value)).filter(value=>value.length>0);return[...new Set(discovered)].sort((left,right)=>left.localeCompare(right))}catch{return null}}function resolvePmInternalCandidatePrefixes(pmRoot,workspaceRoot){const prefixes=new Set;const configuredDefault=normalizeRelativeDirectoryPath(PM_DIRNAME);if(configuredDefault.length>0){prefixes.add(configuredDefault)}const relativePmRoot=normalizeRelativeDirectoryPath(path.relative(workspaceRoot,pmRoot));if(relativePmRoot.length>0&&!relativePmRoot.startsWith("..")){prefixes.add(relativePmRoot)}return[...prefixes].sort((left,right)=>left.localeCompare(right))}function hasPathPrefix(candidate,prefixes){for(const prefix of prefixes){if(candidate===prefix||candidate.startsWith(`${prefix}/`)){return true}}return false}async function collectProjectFileCandidates(workspaceRoot,scanMode){if(scanMode==="tracked-all"||scanMode==="tracked-all-strict"){const trackedCandidates=await collectTrackedGitFileCandidates(workspaceRoot);if(trackedCandidates){return{requestedMode:scanMode,appliedMode:scanMode,source:"tracked-git",candidateFiles:trackedCandidates,candidateTotal:trackedCandidates.length,candidateScanned:trackedCandidates.length}}const fallbackCandidates=await collectDefaultProjectFileCandidates(workspaceRoot);return{requestedMode:scanMode,appliedMode:"default",source:"tracked-all-fallback-default",candidateFiles:fallbackCandidates,candidateTotal:fallbackCandidates.length,candidateScanned:fallbackCandidates.length}}const defaultCandidates=await collectDefaultProjectFileCandidates(workspaceRoot);return{requestedMode:scanMode,appliedMode:"default",source:"default-curated",candidateFiles:defaultCandidates,candidateTotal:defaultCandidates.length,candidateScanned:defaultCandidates.length}}function summarizeList(values,limit=DIAGNOSTIC_LIST_SUMMARY_LIMIT){if(values.length<=limit){return{values,truncated:false}}return{values:values.slice(0,limit),truncated:true}}function summarizeFileList(values,verboseFileLists){if(verboseFileLists){return{values,truncated:false,total:values.length}}const summary=summarizeList(values,FILE_LIST_SUMMARY_LIMIT);return{values:summary.values,truncated:summary.truncated,total:values.length}}const RESOLUTION_REMEDIATION_FLAG_BY_FIELD={resolution:"--resolution",expected_result:"--expected-result",actual_result:"--actual-result"};const RESOLUTION_REMEDIATION_PLACEHOLDER_BY_FIELD={resolution:"Describe how this item was resolved",expected_result:"Describe the expected result",actual_result:"Describe the actual result"};function buildResolutionRemediationCommand(row){const fieldArguments=row.missing_fields.map(field=>`${RESOLUTION_REMEDIATION_FLAG_BY_FIELD[field]} "${RESOLUTION_REMEDIATION_PLACEHOLDER_BY_FIELD[field]}"`).join(" ");return`pm update ${row.id} ${fieldArguments} --message "Backfill resolution metadata"`}function attachValidateFixHints(check,checkWarnings){const existingResolutionHints=check.details?.missing_resolution_remediation_hints;const aliasedResolution=Array.isArray(existingResolutionHints)&&existingResolutionHints.length>0;const fixHints=aliasedResolution?existingResolutionHints.filter(hint=>typeof hint==="string"):buildRemediationCommands(checkWarnings);if(fixHints.length===0){return}const truncated=aliasedResolution&&check.details?.missing_resolution_remediation_hints_truncated===true;check.details={...check.details,fix_hints:fixHints,...truncated?{fix_hints_truncated:true}:{}}}function resolveRequestedChecks(options){const requested=new Set;if(options.checkMetadata){requested.add("metadata")}if(options.checkResolution){requested.add("resolution")}if(options.checkLifecycle||options.checkStaleBlockers){requested.add("lifecycle")}if(options.checkFiles){requested.add("files")}if(options.checkHistoryDrift){requested.add("history_drift")}if(options.checkCommandReferences){requested.add("command_references")}if(options.checkStorageIntegrity){requested.add("storage_integrity")}if(requested.size===0){if(options.autoFix){requested.add("metadata");requested.add("resolution");requested.add("lifecycle")}if(options.pruneMissing){requested.add("files")}if(requested.size===0){requested.add("metadata");requested.add("resolution");requested.add("lifecycle");requested.add("files");requested.add("command_references");requested.add("history_drift");requested.add("format_version");requested.add("storage_integrity")}return requested}if(options.pruneMissing){requested.add("files")}return requested}const DUPLICATE_ISSUE_CODE_WARNING_TOKEN="validate_metadata_duplicate_issue_codes";function summarizeDuplicateIssueCodes(duplicates,verboseDiagnostics){if(duplicates.length===0){return{rows:[],truncated:false,warnings:[]}}const limit=verboseDiagnostics?duplicates.length:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const shown=duplicates.slice(0,limit);const rows=shown.map(duplicate=>({code:duplicate.code,count:duplicate.count,ids:duplicate.ids,titles:duplicate.titles,remediation_hint:`Items ${duplicate.ids.join(", ")} share issue code "${duplicate.code}"; rename or merge so each logical code maps to one item.`}));return{rows,truncated:shown.length<duplicates.length,warnings:[`${DUPLICATE_ISSUE_CODE_WARNING_TOKEN}:${duplicates.length}`]}}function initializeMissingMetadataByField(){return Object.fromEntries(SUPPORTED_METADATA_REQUIRED_FIELDS.map(field=>[field,[]]))}function collectMissingMetadataByField(items,statusRegistry,enforcePlanningFieldsOnTerminal){const missingByField=initializeMissingMetadataByField();for(const item of items){for(const field of SUPPORTED_METADATA_REQUIRED_FIELDS){if(isMetadataFieldMissing(item,field,statusRegistry,enforcePlanningFieldsOnTerminal)){missingByField[field].push(item.id)}}}return missingByField}function buildMetadataWarningTokens(metadataPolicy,missingByField,duplicateWarnings){const warningTokens=[...metadataPolicy.warnings];for(const field of metadataPolicy.required_fields){const missingItems=missingByField[field];if(missingItems.length>0){warningTokens.push(`${METADATA_WARNING_TOKEN_BY_FIELD[field]}:${missingItems.length}`)}}warningTokens.push(...duplicateWarnings);return warningTokens}function buildMetadataCounts(metadataPolicy,missingByField){const counts={};for(const field of metadataPolicy.required_fields){const missing=missingByField[field];const value=missing?missing.length:0;const countKey=METADATA_COUNT_KEY_BY_FIELD[field];counts[countKey]=value}return counts}function buildMissingFieldOccurrences(metadataPolicy,missingByField,itemsById){const occurrences=[];for(const field of metadataPolicy.required_fields){const missing=missingByField[field];if(!missing){continue}for(const itemId of missing){const itemType=itemsById.get(itemId)?.type;const normalizedItemType=typeof itemType==="string"&&itemType.length>0?itemType:"Unknown";occurrences.push({item_type:normalizedItemType,field})}}return occurrences}function attachMissingMetadataItemIds(details,metadataPolicy,missingByField,verboseDiagnostics){for(const field of metadataPolicy.required_fields){const missing=missingByField[field];if(!missing||missing.length===0){continue}const idsKey=METADATA_ITEM_IDS_KEY_BY_FIELD[field];const truncatedKey=METADATA_TRUNCATED_KEY_BY_FIELD[field];if(!idsKey||!truncatedKey){continue}const summarized=summarizeList(missing,verboseDiagnostics?missing.length:DIAGNOSTIC_LIST_SUMMARY_LIMIT);details[idsKey]=summarized.values;details[truncatedKey]=summarized.truncated}}function buildCloseReasonBackfillRows(metadataPolicy,missingByField,itemsById){if(!metadataPolicy.required_fields.includes("close_reason")){return[]}const missing=missingByField.close_reason;if(!missing){return[]}return missing.map(itemId=>({id:itemId,resolution:toNonEmptyStringOrUndefined(itemsById.get(itemId)?.resolution)}))}function buildEstimateBackfillRows(metadataPolicy,missingByField,itemsById){if(!metadataPolicy.required_fields.includes("estimated_minutes")){return[]}const missing=missingByField.estimated_minutes;if(!missing){return[]}return missing.map(itemId=>({id:itemId,type:toNonEmptyStringOrUndefined(itemsById.get(itemId)?.type)}))}function buildMetadataCheck(items,metadataPolicy,statusRegistry,verboseDiagnostics,configuredIssueCodePrefixes){const itemsById=new Map(items.map(item=>[item.id,item]));const enforcePlanningFieldsOnTerminal=metadataPolicy.profile==="strict";const missingByField=collectMissingMetadataByField(items,statusRegistry,enforcePlanningFieldsOnTerminal);const duplicateIssueCodes=findDuplicateIssueCodes(items,{configuredPrefixes:configuredIssueCodePrefixes});const duplicateIssueCodeSummary=summarizeDuplicateIssueCodes(duplicateIssueCodes,verboseDiagnostics);const warningTokens=buildMetadataWarningTokens(metadataPolicy,missingByField,duplicateIssueCodeSummary.warnings);const counts=buildMetadataCounts(metadataPolicy,missingByField);const missingFieldOccurrences=buildMissingFieldOccurrences(metadataPolicy,missingByField,itemsById);const missingByType=buildMissingByTypeCounts(missingFieldOccurrences);const details={checked_items:items.length,metadata_profile:metadataPolicy.profile,metadata_profile_source:metadataPolicy.profile_source,metadata_profile_fallback_to_core:metadataPolicy.fallback_to_core,required_fields:[...metadataPolicy.required_fields],supported_required_fields:[...SUPPORTED_METADATA_REQUIRED_FIELDS],counts,missing_by_type:missingByType,duplicate_issue_codes_count:duplicateIssueCodes.length,duplicate_issue_codes:duplicateIssueCodeSummary.rows,duplicate_issue_codes_truncated:duplicateIssueCodeSummary.truncated};if(metadataPolicy.configured_custom_fields.length>0){details.configured_custom_required_fields=[...metadataPolicy.configured_custom_fields]}attachMissingMetadataItemIds(details,metadataPolicy,missingByField,verboseDiagnostics);const closeReasonBackfillRows=buildCloseReasonBackfillRows(metadataPolicy,missingByField,itemsById);const estimateBackfillRows=buildEstimateBackfillRows(metadataPolicy,missingByField,itemsById);return{check:{name:"metadata",status:warningTokens.length===0?"ok":"warn",ok:warningTokens.length===0,details},warnings:warningTokens,closeReasonBackfillRows,estimateBackfillRows}}function buildResolutionCheck(items,statusRegistry,verboseDiagnostics){const terminalDoneStatuses=new Set(statusRegistry.terminal_done_statuses);terminalDoneStatuses.add(statusRegistry.close_status);const closedItems=items.filter(item=>terminalDoneStatuses.has(normalizeStatusForRegistry(item.status,statusRegistry)));const missingResolutionRows=[];const resolutionBackfillRows=[];for(const item of closedItems){const missingFields=RESOLUTION_FIELD_KEYS.filter(field=>!toNonEmptyStringOrUndefined(item[field]));if(missingFields.length===0){continue}missingResolutionRows.push({id:item.id,missing_fields:missingFields});resolutionBackfillRows.push({id:item.id,missing_fields:missingFields,close_reason:toNonEmptyStringOrUndefined(item.close_reason)})}const warnings=missingResolutionRows.length>0?[`validate_resolution_missing_fields:${missingResolutionRows.length}`]:[];const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedRows=summarizeList(missingResolutionRows.map(row=>`${row.id}:${row.missing_fields.join(",")}`),diagnosticLimit);const remediationHints=missingResolutionRows.map(row=>buildResolutionRemediationCommand(row));const summarizedHints=summarizeList(remediationHints,diagnosticLimit);return{check:{name:"resolution",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{checked_closed_items:closedItems.length,missing_resolution_items:missingResolutionRows.length,missing_resolution_rows:summarizedRows.values,missing_resolution_rows_truncated:summarizedRows.truncated,missing_resolution_remediation_hints:summarizedHints.values,missing_resolution_remediation_hints_truncated:summarizedHints.truncated}},warnings,resolutionBackfillRows}}function escapeRegExp(value){return value.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function buildLifecycleDependencyGraph(activeItems,idPrefix="pm",relationshipRegistry=createRelationshipKindRegistry()){const activeItemIds=new Set(activeItems.map(item=>item.id));const sortedItems=[...activeItems].sort((left,right)=>left.id.localeCompare(right.id));return new Map(sortedItems.map(item=>{const edges=new Set;const blockedBy=toMeaningfulString(item.blocked_by);if(blockedBy&&activeItemIds.has(blockedBy)){edges.add(blockedBy)}(item.dependencies??[]).filter(dependency=>{const dependencyKind=toMeaningfulString(dependency.kind);return dependencyKind!==void 0&&relationshipRegistry.resolve(dependencyKind)?.ordering===true}).map(dependency=>toMeaningfulString(dependency.id)).filter(dependencyId=>dependencyId!==void 0&&activeItemIds.has(dependencyId)).forEach(dependencyId=>edges.add(dependencyId));const definitionOfReady=toMeaningfulString(item.definition_of_ready);extractItemIds(definitionOfReady??"",idPrefix).filter(referencedId=>activeItemIds.has(referencedId)).forEach(referencedId=>edges.add(referencedId));return[item.id,[...edges].sort((left,right)=>left.localeCompare(right))]}))}function buildDependencyReferencesCheck(items,verboseDiagnostics,statusRegistry){const classified=collectDanglingDependencyReferences(items,statusRegistry?status=>isTerminalStatus(status,statusRegistry):void 0);const activeRows=classified.active.map(row=>`${row.holder_id}:${row.target_id}:${row.kind}`);const legacyRows=classified.legacy_terminal.map(row=>`${row.holder_id}:${row.target_id}:${row.kind}:${row.holder_status}`);const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedRows=summarizeList(activeRows,diagnosticLimit);const summarizedLegacyRows=summarizeList(legacyRows,diagnosticLimit);const hints=summarizeList(classified.active.map(row=>{if(row.source==="parent"){return`pm update ${row.holder_id} --unset parent`}return row.source==="blocked_by"?`pm update ${row.holder_id} --unset blocked_by`:`pm update ${row.holder_id} --replace-deps '<correct dependency edges>'`}),diagnosticLimit);return{check:{name:"dependency_references",status:activeRows.length===0?"ok":"warn",ok:activeRows.length===0,details:{checked_items:items.length,dangling_reference_count:activeRows.length+legacyRows.length,active_dangling_reference_count:activeRows.length,dangling_reference_rows:summarizedRows.values,dangling_reference_rows_truncated:summarizedRows.truncated,legacy_terminal_dangling_reference_count:legacyRows.length,legacy_closed_dangling_reference_count:classified.legacy_terminal.filter(row=>row.holder_status==="closed").length,legacy_terminal_dangling_reference_rows:summarizedLegacyRows.values,legacy_terminal_dangling_reference_rows_truncated:summarizedLegacyRows.truncated,no_active_blocker_sentinel_count:classified.no_active_blocker_sentinels.length,remediation_hints:hints.values,remediation_hints_truncated:hints.truncated}},warnings:activeRows.length>0?[`validate_dangling_dependency_references:${activeRows.length}`]:[]}}function extractItemIds(value,idPrefix="pm"){const normalizedPrefix=(idPrefix.trim().toLowerCase()||"pm").replace(/-+$/g,"");const pattern=new RegExp(`(?:^|[^a-z0-9-])(${escapeRegExp(normalizedPrefix)}-[a-z0-9][a-z0-9-]*)`,"gi");return[...new Set([...value.matchAll(pattern)].map(match=>match[1].toLowerCase()))].sort((left,right)=>left.localeCompare(right))}function findLifecycleDependencyCycleComponents(graph){let nextIndex=0;const indexById=new Map;const lowLinkById=new Map;const stack=[];const inStack=new Set;const components=[];const visit=id=>{indexById.set(id,nextIndex);lowLinkById.set(id,nextIndex);nextIndex+=1;stack.push(id);inStack.add(id);for(const dependencyId of graph.get(id)??[]){if(!indexById.has(dependencyId)){visit(dependencyId);lowLinkById.set(id,Math.min(lowLinkById.get(id),lowLinkById.get(dependencyId)))}else if(inStack.has(dependencyId)){lowLinkById.set(id,Math.min(lowLinkById.get(id),indexById.get(dependencyId)))}}if(lowLinkById.get(id)!==indexById.get(id)){return}const component=[];while(stack.length>0){const member=stack.pop();inStack.delete(member);component.push(member);if(member===id){break}}component.sort((left,right)=>left.localeCompare(right));components.push(component)};const sortedNodeIds=[...graph.keys()].sort((left,right)=>left.localeCompare(right));for(const id of sortedNodeIds){if(!indexById.has(id)){visit(id)}}const cycleComponents=components.filter(component=>{if(component.length>1){return true}const selfId=component[0];return(graph.get(selfId)??[]).includes(selfId)});return cycleComponents.sort((left,right)=>left[0].localeCompare(right[0])||left.length-right.length||left.join(",").localeCompare(right.join(",")))}function detectLifecycleDependencyCycles(activeItems,idPrefix="pm"){const graph=buildLifecycleDependencyGraph(activeItems,idPrefix);const cycleComponents=findLifecycleDependencyCycleComponents(graph);const cycleItemIds=[...new Set(cycleComponents.flat())].sort((left,right)=>left.localeCompare(right));const cycleSamplePaths=cycleComponents.map(component=>resolveLifecycleDependencyCycleSamplePath(component,graph).join("->"));return{cycle_count:cycleComponents.length,cycle_item_ids:cycleItemIds,cycle_sample_paths:cycleSamplePaths}}function classifyOrphanedPath(pathValue){if(pathValue.startsWith("docs/")){return"docs_unowned"}if(pathValue.startsWith("tests/")){return"tests_unowned"}if(pathValue.startsWith("src/")){return"source_unowned"}if(pathValue.endsWith(".md")){return"docs_unowned"}return"unlinked_existing"}function directoryOf(relativePath){const slash=relativePath.lastIndexOf("/");return slash===-1?"":relativePath.slice(0,slash)}function sharedDirectoryPrefixLength(left,right){const leftParts=directoryOf(left).split("/").filter(Boolean);const rightParts=directoryOf(right).split("/").filter(Boolean);let count=0;while(count<leftParts.length&&count<rightParts.length&&leftParts[count]===rightParts[count]){count+=1}return count}function scoreOrphanOwnerCandidate(pathValue,linkedPath){const linkedDir=directoryOf(linkedPath);const orphanDir=directoryOf(pathValue);const directoryPrefix=linkedPath.endsWith("/")?linkedPath:`${linkedPath}/`;const isDirectoryPrefix=pathValue.startsWith(directoryPrefix);const sameDirectory=linkedDir.length>0&&linkedDir===orphanDir;const sharedPrefixLength=sharedDirectoryPrefixLength(pathValue,linkedPath);if(!isDirectoryPrefix&&!sameDirectory&&sharedPrefixLength===0){return null}if(isDirectoryPrefix){return{score:linkedPath.length+1e3,confidence:"path_prefix"}}return sameDirectory?{score:sharedPrefixLength+500,confidence:"same_directory"}:{score:sharedPrefixLength,confidence:"shared_directory"}}function shouldReplaceOrphanOwnerCandidate(best,item,score){return best===void 0||score>best.score||score===best.score&&item.id.localeCompare(best.item.id)<0}function findOrphanOwnerCandidate(pathValue,classification,items){const linkKind=classification==="docs_unowned"?"docs":"files";let best;items.flatMap(item=>(linkKind==="docs"?item.docs??[]:item.files??[]).map(link=>({item,link}))).forEach(({item,link})=>{if(link.scope!=="project"){return}const linkedPath=normalizeRelativePath(link.path);if(linkedPath.length===0||linkedPath===pathValue){return}const scored=scoreOrphanOwnerCandidate(pathValue,linkedPath);if(scored===null){return}if(shouldReplaceOrphanOwnerCandidate(best,item,scored.score)){best={item,score:scored.score,confidence:scored.confidence}}});if(!best){return null}return{id:best.item.id,type:best.item.type,title:best.item.title,status:best.item.status,confidence:best.confidence}}function buildOrphanedPathRows(orphanedFiles,items){return orphanedFiles.map(pathValue=>{const classification=classifyOrphanedPath(pathValue);const linkCommand=classification==="docs_unowned"?"docs":"files";const ownerCandidate=findOrphanOwnerCandidate(pathValue,classification,items);const target=ownerCandidate?.id??"<id>";return{path:pathValue,classification,owner_candidate:ownerCandidate,remediation_hint:`pm ${linkCommand} ${target} --add path=${pathValue},scope=project,note="<why this artifact belongs to the item>"`}})}function summarizeOrphanedPathRows(rows){return rows.map(row=>`${row.path}:${row.classification} owner_candidate=${row.owner_candidate?.id??"unowned"} hint=${JSON.stringify(row.remediation_hint)}`)}function closureLikeFieldsForItem(item,lifecyclePatternPolicy){return Object.entries(lifecyclePatternPolicy.closure_like_metadata_field_patterns).filter(([field,patterns])=>{const value=toMeaningfulString(item[field]);return value?patterns.some(pattern=>value.toLowerCase().includes(pattern)):false}).map(([field])=>field).sort((left,right)=>left.localeCompare(right))}function buildTerminalParentFixRow(item,parent,itemsById,canonicalIdByLowercase,statusRegistry){const grandparentId=toMeaningfulString(parent.parent);const grandparent=grandparentId?itemsById.get(canonicalIdByLowercase.get(grandparentId.toLowerCase())??grandparentId):void 0;return{id:item.id,parent_id:parent.id,grandparent_id:grandparent?.id,grandparent_active:grandparent!==void 0&&!isTerminalStatus(grandparent.status,statusRegistry)}}function staleBlockerReasonsForItem(item,blockedStatuses,statusRegistry,lifecyclePatternPolicy){const blockedBy=toMeaningfulString(item.blocked_by);const blockedReason=toMeaningfulString(item.blocked_reason);const blockedReasonNormalized=blockedReason?.toLowerCase();const normalizedStatus=normalizeStatusForRegistry(item.status,statusRegistry);const reasons=[];if(!blockedStatuses.has(normalizedStatus)){if(blockedBy){reasons.push("non_blocked_status_has_blocked_by")}if(blockedReason){reasons.push("non_blocked_status_has_blocked_reason")}return reasons}if(!blockedBy&&!blockedReason){reasons.push("blocked_status_missing_blocker_context")}if(blockedReasonNormalized?.includes("no active blocker")){reasons.push("blocked_status_reason_reports_no_active_blocker")}if(blockedReasonNormalized&&lifecyclePatternPolicy.stale_blocker_reason_patterns.some(pattern=>blockedReasonNormalized.includes(pattern))){reasons.push("blocked_status_reason_matches_stale_pattern")}return reasons}function collectLifecycleScanRows(items,includeStaleBlockers,statusRegistry,lifecyclePatternPolicy){const itemsById=new Map(items.map(item=>[item.id,item]));const canonicalIdByLowercase=new Map(items.map(item=>[item.id.toLowerCase(),item.id]));const blockedStatuses=statusRegistry.blocked_statuses.size>0?statusRegistry.blocked_statuses:new Set(["blocked"]);const rows={activeItems:items.filter(item=>!isTerminalStatus(item.status,statusRegistry)),closureLikeRows:[],terminalParentRows:[],terminalParentFixRows:[],staleBlockerRows:[]};for(const item of rows.activeItems){const closureLikeFields=closureLikeFieldsForItem(item,lifecyclePatternPolicy);if(closureLikeFields.length>0){rows.closureLikeRows.push({id:item.id,fields:closureLikeFields})}const parentId=toMeaningfulString(item.parent);const parent=parentId?itemsById.get(canonicalIdByLowercase.get(parentId.toLowerCase())??parentId):void 0;if(parent&&isTerminalStatus(parent.status,statusRegistry)){rows.terminalParentRows.push({id:item.id,parent_id:parent.id,parent_status:parent.status});rows.terminalParentFixRows.push(buildTerminalParentFixRow(item,parent,itemsById,canonicalIdByLowercase,statusRegistry))}if(includeStaleBlockers){const reasons=staleBlockerReasonsForItem(item,blockedStatuses,statusRegistry,lifecyclePatternPolicy);if(reasons.length>0){rows.staleBlockerRows.push({id:item.id,status:item.status,reasons:[...new Set(reasons)].sort((left,right)=>left.localeCompare(right))})}}}return rows}function sortLifecycleScanRows(rows){rows.closureLikeRows.sort((left,right)=>left.id.localeCompare(right.id));rows.terminalParentRows.sort((left,right)=>left.id.localeCompare(right.id)||left.parent_id.localeCompare(right.parent_id));rows.terminalParentFixRows.sort((left,right)=>left.id.localeCompare(right.id)||left.parent_id.localeCompare(right.parent_id));rows.staleBlockerRows.sort((left,right)=>left.id.localeCompare(right.id))}function lifecycleCycleWarningToken(prefix,severity,count){if(count<=0||severity==="off"){return null}return`${severity==="error"?`${prefix}_error`:prefix}:${count}`}function lifecycleAdvisoryWarningToken(prefix,severity,count){return count>0&&severity!=="off"?`${prefix}:${count}`:null}function buildLifecycleWarnings(rows,includeStaleBlockers,dependencyCycleSeverity,parentCycleSeverity,counts){const warnings=[];if(rows.closureLikeRows.length>0){warnings.push(`validate_lifecycle_active_closure_like_metadata:${rows.closureLikeRows.length}`)}if(rows.terminalParentRows.length>0){warnings.push(`validate_lifecycle_active_terminal_parent:${rows.terminalParentRows.length}`)}if(includeStaleBlockers&&rows.staleBlockerRows.length>0){warnings.push(`validate_lifecycle_stale_blockers:${rows.staleBlockerRows.length}`)}const dependencyWarning=lifecycleCycleWarningToken("validate_lifecycle_dependency_cycles",dependencyCycleSeverity,counts.dependencyCycles);const parentWarning=lifecycleCycleWarningToken("validate_hierarchy_parent_cycle",parentCycleSeverity,counts.activeHierarchyCycles);const cardinalityWarning=lifecycleCycleWarningToken("validate_hierarchy_cardinality_violation",parentCycleSeverity,counts.activeHierarchyCardinality);const divergenceWarning=lifecycleCycleWarningToken("validate_hierarchy_parent_divergence",parentCycleSeverity,counts.activeHierarchyDivergence);const legacyCycleWarning=lifecycleAdvisoryWarningToken("validate_legacy_hierarchy_parent_cycle",parentCycleSeverity,counts.legacyHierarchyCycles);const legacyCardinalityWarning=lifecycleAdvisoryWarningToken("validate_legacy_hierarchy_cardinality_violation",parentCycleSeverity,counts.legacyHierarchyCardinality);const legacyDivergenceWarning=lifecycleAdvisoryWarningToken("validate_legacy_hierarchy_parent_divergence",parentCycleSeverity,counts.legacyHierarchyDivergence);return[...warnings,...dependencyWarning?[dependencyWarning]:[],...parentWarning?[parentWarning]:[],...cardinalityWarning?[cardinalityWarning]:[],...divergenceWarning?[divergenceWarning]:[],...legacyCycleWarning?[legacyCycleWarning]:[],...legacyCardinalityWarning?[legacyCardinalityWarning]:[],...legacyDivergenceWarning?[legacyDivergenceWarning]:[]]}function linkedArtifactPathExceedsFilesystemLimits(artifactPath){const normalized=normalizeRelativePath(artifactPath);return normalized.length>LINKED_ARTIFACT_MAX_PATH_LENGTH||normalized.split(/[\\/]/).some(segment=>segment.length>LINKED_ARTIFACT_MAX_SEGMENT_LENGTH)}async function linkedArtifactIsMissing(workspaceRoot,artifactPath){const absolutePath=path.isAbsolute(artifactPath)?artifactPath:path.resolve(workspaceRoot,artifactPath);if(linkedArtifactPathExceedsFilesystemLimits(absolutePath)){return false}try{const stats=await fs.stat(absolutePath);return!stats.isFile()&&!stats.isDirectory()}catch(error){return hasFilesystemErrorCode(error,["ENOENT","ENOTDIR"])}}async function collectLinkedPathScanState(items,workspaceRoot){const state={linkedProjectPaths:new Set,remoteLinkedPaths:new Set,missingLinkedPaths:[],staleLinkRows:[]};const linkedArtifacts=items.flatMap(item=>[...(item.files??[]).map(artifact=>({item,artifact,link_kind:"files"})),...(item.docs??[]).map(artifact=>({item,artifact,link_kind:"docs"}))]);for(const{item,artifact,link_kind}of linkedArtifacts){if(artifact.scope!=="project"){continue}if(isRemoteLinkedArtifactReference(artifact.path)){state.remoteLinkedPaths.add(artifact.path.trim());continue}const normalizedPath=normalizeRelativePath(artifact.path);if(normalizedPath.length===0){continue}state.linkedProjectPaths.add(normalizedPath);if(await linkedArtifactIsMissing(workspaceRoot,artifact.path)){state.missingLinkedPaths.push(normalizedPath);state.staleLinkRows.push({item_id:item.id,path:normalizedPath,link_kind})}}return state}function partitionFileCandidates(fileCandidates,pmRoot,workspaceRoot,fileScanMode,includePmInternals,verboseFileLists){const strictTrackedAllMode=fileScanMode==="tracked-all-strict";const strictModeForcesPmInternals=strictTrackedAllMode&&!includePmInternals;const includePmInternalsEffective=includePmInternals||strictTrackedAllMode;const pmInternalCandidatePrefixes=includePmInternalsEffective?[]:resolvePmInternalCandidatePrefixes(pmRoot,workspaceRoot);const excludedPmInternalPaths=pmInternalCandidatePrefixes.length===0?[]:fileCandidates.candidateFiles.filter(candidate=>hasPathPrefix(candidate,pmInternalCandidatePrefixes));const candidateFiles=pmInternalCandidatePrefixes.length===0?fileCandidates.candidateFiles:fileCandidates.candidateFiles.filter(candidate=>!hasPathPrefix(candidate,pmInternalCandidatePrefixes));const excludedByReason={};if(excludedPmInternalPaths.length>0){const summarizedPmInternalPaths=summarizeFileList(excludedPmInternalPaths,verboseFileLists);excludedByReason.pm_internals={count:excludedPmInternalPaths.length,paths:summarizedPmInternalPaths.values,paths_truncated:summarizedPmInternalPaths.truncated,paths_total:summarizedPmInternalPaths.total}}return{strictTrackedAllMode,strictModeForcesPmInternals,includePmInternalsEffective,pmInternalCandidatePrefixes,excludedPmInternalPaths,candidateFiles,excludedByReason}}function buildLifecycleCheck(items,includeStaleBlockers,dependencyCycleSeverity,parentCycleSeverity,statusRegistry,lifecyclePatternPolicy,verboseDiagnostics,idPrefix="pm"){const rows=collectLifecycleScanRows(items,includeStaleBlockers,statusRegistry,lifecyclePatternPolicy);sortLifecycleScanRows(rows);const dependencyCycleDiagnostics=detectLifecycleDependencyCycles(rows.activeItems,idPrefix);const parentCycleDiagnostics=detectLifecycleParentCycles(items,statusRegistry);const statusRoleDiagnostics=inspectStatusRoleAssignments(statusRegistry,items,verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT);const warnings=[...buildLifecycleWarnings(rows,includeStaleBlockers,dependencyCycleSeverity,parentCycleSeverity,{dependencyCycles:dependencyCycleDiagnostics.cycle_count,activeHierarchyCycles:parentCycleDiagnostics.active_cycle_count,activeHierarchyCardinality:parentCycleDiagnostics.active_cardinality_violation_count,activeHierarchyDivergence:parentCycleDiagnostics.active_parent_divergence_count,legacyHierarchyCycles:parentCycleDiagnostics.legacy_cycle_count,legacyHierarchyCardinality:parentCycleDiagnostics.legacy_cardinality_violation_count,legacyHierarchyDivergence:parentCycleDiagnostics.legacy_parent_divergence_count}),...buildStatusRoleWarnings(statusRoleDiagnostics)];const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedClosureLikeRows=summarizeList(rows.closureLikeRows.map(row=>`${row.id}:${row.fields.join(",")}`),diagnosticLimit);const summarizedTerminalParentRows=summarizeList(rows.terminalParentRows.map(row=>`${row.id}:${row.parent_id}:${row.parent_status}`),diagnosticLimit);const summarizedStaleBlockerRows=summarizeList(rows.staleBlockerRows.map(row=>`${row.id}:${row.status}:${row.reasons.join(",")}`),diagnosticLimit);const summarizedDependencyCycleItemIds=summarizeList(dependencyCycleDiagnostics.cycle_item_ids,diagnosticLimit);const summarizedDependencyCycleSamplePaths=summarizeList(dependencyCycleDiagnostics.cycle_sample_paths,diagnosticLimit);const summarizedParentCycleItemIds=summarizeList(parentCycleDiagnostics.cycle_item_ids,diagnosticLimit);const summarizedParentCycleSamplePaths=summarizeList(parentCycleDiagnostics.cycle_sample_paths,diagnosticLimit);const summarizedHierarchyCardinalityRows=summarizeList(parentCycleDiagnostics.cardinality_violation_rows,diagnosticLimit);const summarizedHierarchyDivergenceRows=summarizeList(parentCycleDiagnostics.parent_divergence_rows,diagnosticLimit);const hasErrorSeverityCycle=dependencyCycleDiagnostics.cycle_count>0&&dependencyCycleSeverity==="error"||(parentCycleDiagnostics.active_cycle_count>0||parentCycleDiagnostics.active_cardinality_violation_count>0||parentCycleDiagnostics.active_parent_divergence_count>0)&&parentCycleSeverity==="error";return{check:{name:"lifecycle",status:hasErrorSeverityCycle?"error":warnings.length===0?"ok":"warn",ok:!hasErrorSeverityCycle&&warnings.length===0,details:{checked_active_items:rows.activeItems.length,lifecycle_status_roles:statusRoleDiagnostics,active_closure_like_metadata_items:rows.closureLikeRows.length,active_closure_like_metadata_rows:summarizedClosureLikeRows.values,active_closure_like_metadata_rows_truncated:summarizedClosureLikeRows.truncated,active_terminal_parent_items:rows.terminalParentRows.length,active_terminal_parent_rows:summarizedTerminalParentRows.values,active_terminal_parent_rows_truncated:summarizedTerminalParentRows.truncated,stale_blocker_checks_enabled:includeStaleBlockers,stale_blocker_items:rows.staleBlockerRows.length,stale_blocker_rows:summarizedStaleBlockerRows.values,stale_blocker_rows_truncated:summarizedStaleBlockerRows.truncated,dependency_cycle_severity_policy:dependencyCycleSeverity,dependency_cycle_count:dependencyCycleDiagnostics.cycle_count,dependency_cycle_item_count:dependencyCycleDiagnostics.cycle_item_ids.length,dependency_cycle_item_ids:summarizedDependencyCycleItemIds.values,dependency_cycle_item_ids_truncated:summarizedDependencyCycleItemIds.truncated,dependency_cycle_sample_paths:summarizedDependencyCycleSamplePaths.values,dependency_cycle_sample_paths_truncated:summarizedDependencyCycleSamplePaths.truncated,parent_cycle_severity_policy:parentCycleSeverity,parent_cycle_count:parentCycleDiagnostics.cycle_count,active_parent_cycle_count:parentCycleDiagnostics.active_cycle_count,legacy_parent_cycle_count:parentCycleDiagnostics.legacy_cycle_count,parent_cycle_item_count:parentCycleDiagnostics.cycle_item_ids.length,parent_cycle_item_ids:summarizedParentCycleItemIds.values,parent_cycle_item_ids_truncated:summarizedParentCycleItemIds.truncated,parent_cycle_sample_paths:summarizedParentCycleSamplePaths.values,parent_cycle_sample_paths_truncated:summarizedParentCycleSamplePaths.truncated,hierarchy_cardinality_violation_count:parentCycleDiagnostics.cardinality_violation_count,active_hierarchy_cardinality_violation_count:parentCycleDiagnostics.active_cardinality_violation_count,legacy_hierarchy_cardinality_violation_count:parentCycleDiagnostics.legacy_cardinality_violation_count,hierarchy_cardinality_violation_rows:summarizedHierarchyCardinalityRows.values,hierarchy_cardinality_violation_rows_truncated:summarizedHierarchyCardinalityRows.truncated,hierarchy_parent_divergence_count:parentCycleDiagnostics.parent_divergence_count,active_hierarchy_parent_divergence_count:parentCycleDiagnostics.active_parent_divergence_count,legacy_hierarchy_parent_divergence_count:parentCycleDiagnostics.legacy_parent_divergence_count,hierarchy_parent_divergence_rows:summarizedHierarchyDivergenceRows.values,hierarchy_parent_divergence_rows_truncated:summarizedHierarchyDivergenceRows.truncated,stale_blocker_reason_patterns:[...lifecyclePatternPolicy.stale_blocker_reason_patterns],stale_blocker_reason_pattern_source:lifecyclePatternPolicy.stale_blocker_reason_pattern_source,closure_like_blocked_reason_patterns:[...lifecyclePatternPolicy.closure_like_metadata_field_patterns.blocked_reason],closure_like_blocked_reason_pattern_source:lifecyclePatternPolicy.closure_like_metadata_field_pattern_sources.blocked_reason,closure_like_resolution_patterns:[...lifecyclePatternPolicy.closure_like_metadata_field_patterns.resolution],closure_like_resolution_pattern_source:lifecyclePatternPolicy.closure_like_metadata_field_pattern_sources.resolution,closure_like_actual_result_patterns:[...lifecyclePatternPolicy.closure_like_metadata_field_patterns.actual_result],closure_like_actual_result_pattern_source:lifecyclePatternPolicy.closure_like_metadata_field_pattern_sources.actual_result}},warnings,terminalParentFixRows:rows.terminalParentFixRows}}async function buildFilesCheck(items,workspaceRoot,pmRoot,fileScanMode,includePmInternals,verboseFileLists,statusRegistry=resolveRuntimeStatusRegistry(SETTINGS_DEFAULTS.schema)){const linkedPathState=await collectLinkedPathScanState(items,workspaceRoot);const itemsById=new Map(items.map(item=>[item.id,item]));const uniqueMissingLinkedPaths=[...new Set(linkedPathState.missingLinkedPaths)].sort((left,right)=>left.localeCompare(right));const fileCandidates=await collectProjectFileCandidates(workspaceRoot,fileScanMode);const partition=partitionFileCandidates(fileCandidates,pmRoot,workspaceRoot,fileScanMode,includePmInternals,verboseFileLists);const orphanedFiles=partition.candidateFiles.filter(candidate=>!linkedPathState.linkedProjectPaths.has(candidate));const orphanedPathRows=buildOrphanedPathRows(orphanedFiles,items);const classifiedStalePaths=classifyStaleLinkedPaths(uniqueMissingLinkedPaths,partition.candidateFiles);const classificationByPath=new Map(classifiedStalePaths.map(entry=>[entry.path,entry.classification]));const movedStalePathCount=classifiedStalePaths.filter(entry=>entry.classification==="moved").length;const staleLinkPruneRows=linkedPathState.staleLinkRows.map(row=>({...row,classification:classificationByPath.get(row.path)??"deleted"})).sort((left,right)=>left.item_id.localeCompare(right.item_id)||left.path.localeCompare(right.path)||left.link_kind.localeCompare(right.link_kind));const warnings=[];if(partition.strictModeForcesPmInternals){warnings.push("validate_files_tracked_all_strict_forces_pm_internals")}if(orphanedFiles.length>0){warnings.push(`validate_files_orphaned_paths:${orphanedFiles.length}`)}const uniqueRemoteLinkedPaths=[...linkedPathState.remoteLinkedPaths].sort((left,right)=>left.localeCompare(right));const summarizedRemote=summarizeFileList(uniqueRemoteLinkedPaths,verboseFileLists);const summarizedMissing=summarizeFileList(uniqueMissingLinkedPaths,verboseFileLists);const summarizedOrphaned=summarizeFileList(orphanedFiles,verboseFileLists);const summarizedOrphanedClassifications=summarizeFileList(orphanedPathRows.map(row=>`${row.path}:${row.classification}:owner_candidate=${row.owner_candidate?.id??"unowned"}`),verboseFileLists);const orphanedPathRowDetail=verboseFileLists?orphanedPathRows:summarizeFileList(summarizeOrphanedPathRows(orphanedPathRows),false).values;const summarizedClassifications=summarizeFileList(summarizeStaleLinkedPathClassifications(classifiedStalePaths),verboseFileLists);const missingLinkedPathRows=staleLinkPruneRows;const repairReport=buildLinkedFileRepairReport(missingLinkedPathRows,classifiedStalePaths,id=>itemsById.get(id),statusRegistry,verboseFileLists?Infinity:FILE_LIST_SUMMARY_LIMIT);if(repairReport.active_missing_linked_paths_count>0){warnings.push(`validate_files_missing_linked_paths:${repairReport.active_missing_linked_paths_count}`)}return{check:{name:"files",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{workspace_root:workspaceRoot,scan_mode_requested:fileCandidates.requestedMode,scan_mode_applied:fileCandidates.appliedMode,strict_tracked_all_mode:partition.strictTrackedAllMode,strict_mode_forces_pm_internals:partition.strictModeForcesPmInternals,strict_mode_forces_pm_internals_notice:partition.strictModeForcesPmInternals?"tracked-all-strict force-enables PM internals; pass --include-pm-internals to make inclusion explicit.":null,file_list_detail_mode:verboseFileLists?"full":"summary",file_list_summary_limit:FILE_LIST_SUMMARY_LIMIT,candidate_scan_source:fileCandidates.source,include_pm_internals:partition.includePmInternalsEffective,include_pm_internals_requested:includePmInternals,pm_internal_candidate_prefixes:partition.pmInternalCandidatePrefixes,pm_internal_excluded_count:partition.excludedPmInternalPaths.length,excluded_total:partition.excludedPmInternalPaths.length,excluded_by_reason:partition.excludedByReason,linked_project_paths:linkedPathState.linkedProjectPaths.size,remote_linked_paths_count:uniqueRemoteLinkedPaths.length,remote_linked_paths_total:summarizedRemote.total,remote_linked_paths:summarizedRemote.values,remote_linked_paths_truncated:summarizedRemote.truncated,candidate_total_raw:fileCandidates.candidateTotal,candidate_scanned_raw:fileCandidates.candidateScanned,candidate_total:partition.candidateFiles.length,candidate_scanned:partition.candidateFiles.length,scanned_candidate_files:partition.candidateFiles.length,missing_linked_paths_count:uniqueMissingLinkedPaths.length,missing_linked_paths_total:summarizedMissing.total,missing_linked_paths:summarizedMissing.values,missing_linked_paths_truncated:summarizedMissing.truncated,missing_linked_paths_moved_count:movedStalePathCount,missing_linked_paths_deleted_count:classifiedStalePaths.filter(entry=>entry.classification==="deleted").length,missing_linked_paths_malformed_count:classifiedStalePaths.filter(entry=>entry.classification==="malformed").length,missing_linked_path_classifications:summarizedClassifications.values,missing_linked_path_classifications_truncated:summarizedClassifications.truncated,...repairReport,orphaned_paths_count:orphanedFiles.length,orphaned_paths_total:summarizedOrphaned.total,orphaned_paths:summarizedOrphaned.values,orphaned_paths_truncated:summarizedOrphaned.truncated,orphaned_path_classifications:summarizedOrphanedClassifications.values,orphaned_path_classifications_truncated:summarizedOrphanedClassifications.truncated,orphaned_path_rows_count:orphanedPathRows.length,orphaned_path_rows:orphanedPathRowDetail}},warnings,staleLinkPruneRows}}function summarizeCommandPreview(command){const normalizedCommand=command.trim().replaceAll(/\s+/g," ");return normalizedCommand.length>120?`${normalizedCommand.slice(0,117)}...`:normalizedCommand}function summarizeCommandReferenceRow(ownerId,referencedId,command){return`${ownerId}:${referencedId}:${summarizeCommandPreview(command)}`}function buildUntrustedLinkedTestRows(linkedTests,trustDecisions){const rows=[];linkedTests.forEach(({item,linkedTest},index)=>{const trust=trustDecisions[index];if(trust.trusted)return;const command=summarizeCommandPreview(linkedTest.command??"");rows.push(`${item.id}:${trust.source_ref??"unknown"}->${trust.current_source_ref??"unknown"}:${command}`)});return rows}async function buildCommandReferencesCheck(items,idPrefix,verboseDiagnostics,pmRoot){const knownIds=new Set(items.map(item=>item.id.toLowerCase()));let linkedCommandsScanned=0;let referencedPmIdCount=0;const referencedPmIds=new Set;const staleReferenceRows=[];const linkedTests=items.flatMap(item=>(item.tests??[]).map(linkedTest=>({item,linkedTest})));const currentSourceRef=await resolveLinkedTestSourceRef(resolveLinkedTestSourceWorkspaceRoot());const trustDecisions=await resolveLinkedTestTrustBatch(pmRoot,linkedTests.map(({linkedTest})=>linkedTest),currentSourceRef);const untrustedRows=buildUntrustedLinkedTestRows(linkedTests,trustDecisions);for(const{item,linkedTest}of linkedTests){if(typeof linkedTest.command!=="string"||linkedTest.command.trim().length===0){continue}linkedCommandsScanned+=1;const referencedIds=extractReferencedPmItemIdsFromCommand(linkedTest.command,idPrefix);if(referencedIds.length===0){continue}referencedPmIdCount+=referencedIds.length;for(const referencedId of referencedIds){referencedPmIds.add(referencedId);if(!knownIds.has(referencedId.toLowerCase())){staleReferenceRows.push(summarizeCommandReferenceRow(item.id,referencedId,linkedTest.command))}}}const uniqueStaleReferenceRows=[...new Set(staleReferenceRows)].sort((left,right)=>left.localeCompare(right));const stalePmIds=[...new Set(uniqueStaleReferenceRows.map(row=>row.split(":")[1]??""))].filter(value=>value.length>0).sort((left,right)=>left.localeCompare(right));const warnings=[];if(uniqueStaleReferenceRows.length>0){warnings.push(`validate_command_references_stale_pm_ids:${uniqueStaleReferenceRows.length}`)}if(untrustedRows.length>0){warnings.push(`validate_linked_test_trust_unacknowledged:${untrustedRows.length}`)}const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedRows=summarizeList(uniqueStaleReferenceRows,diagnosticLimit);const summarizedStalePmIds=summarizeList(stalePmIds,diagnosticLimit);const summarizedReferencedPmIds=summarizeList([...referencedPmIds].sort((left,right)=>left.localeCompare(right)),diagnosticLimit);const summarizedUntrustedRows=summarizeList(untrustedRows,diagnosticLimit);return{check:{name:"command_references",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{checked_items:items.length,linked_commands_scanned:linkedCommandsScanned,referenced_pm_ids_count:referencedPmIdCount,unique_referenced_pm_ids_count:referencedPmIds.size,unique_referenced_pm_ids:summarizedReferencedPmIds.values,unique_referenced_pm_ids_truncated:summarizedReferencedPmIds.truncated,linked_test_trust_current_source_ref:currentSourceRef??null,untrusted_linked_tests_count:untrustedRows.length,untrusted_linked_tests:summarizedUntrustedRows.values,untrusted_linked_tests_truncated:summarizedUntrustedRows.truncated,stale_pm_id_references_count:uniqueStaleReferenceRows.length,stale_pm_ids_count:stalePmIds.length,stale_pm_ids:summarizedStalePmIds.values,stale_pm_ids_truncated:summarizedStalePmIds.truncated,stale_pm_id_reference_rows:summarizedRows.values,stale_pm_id_reference_rows_truncated:summarizedRows.truncated}},warnings}}function buildFormatVersionCheck(items,verboseDiagnostics){const scan=scanItemFormatVersions(items.map(item=>({ref:item.id,version:effectiveItemFormatVersion(item)})));const warnings=[];if(scan.outdated.length>0){warnings.push(`validate_format_version_outdated_items:${scan.outdated.length}`)}if(scan.ahead.length>0){warnings.push(`validate_format_version_ahead_items:${scan.ahead.length}`)}const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedOutdated=summarizeList(scan.outdated,diagnosticLimit);const summarizedAhead=summarizeList(scan.ahead,diagnosticLimit);const status=scan.ahead.length>0?"error":scan.outdated.length>0?"warn":"ok";return{check:{name:"format_version",status,ok:status==="ok",details:{checked_items:items.length,current_format_version:CURRENT_ITEM_FORMAT_VERSION,outdated_items_count:scan.outdated.length,outdated_items:summarizedOutdated.values,outdated_items_truncated:summarizedOutdated.truncated,ahead_items_count:scan.ahead.length,ahead_items:summarizedAhead.values,ahead_items_truncated:summarizedAhead.truncated}},warnings}}const VALIDATE_AUTO_FIX_MESSAGE="pm validate auto-fix";async function applyValidateFix(fix,global2,services){switch(fix.kind){case"set_resolution":case"set_close_reason":case"set_estimate":case"reparent":case"unset_parent":{const updateOptions={message:VALIDATE_AUTO_FIX_MESSAGE};if(fix.kind==="set_resolution"){updateOptions.resolution=fix.value}else if(fix.kind==="set_close_reason"){updateOptions.closeReason=fix.value}else if(fix.kind==="set_estimate"){updateOptions.estimatedMinutes=fix.value}else if(fix.kind==="reparent"){updateOptions.parent=fix.parent_id}else{updateOptions.unset=["parent"]}if(!services.runUpdate){throw new PmCliError("Applying validate metadata/lifecycle fixes requires a runUpdate mutation service.",EXIT_CODE.USAGE)}await services.runUpdate(fix.item_id,updateOptions,global2);return}case"prune_file_link":{throw new Error(`Unsupported non-batched fix kind: ${fix.kind}`)}case"prune_doc_link":{throw new Error(`Unsupported non-batched fix kind: ${fix.kind}`)}}}function pruneBatchKey(fix){if(fix.kind!=="prune_file_link"&&fix.kind!=="prune_doc_link"){return null}return`${fix.kind}:${fix.item_id}`}async function applyValidateFixes(applicable,global2,services){const applied=[];const failed=[];const pruneBatches=new Map;for(const fix of applicable.filter(candidate=>pruneBatchKey(candidate)===null)){try{await applyValidateFix(fix,global2,services);applied.push(fix)}catch(error){failed.push({fix,error})}}for(const fix of applicable.filter(candidate=>pruneBatchKey(candidate)!==null)){const batchKey=pruneBatchKey(fix);const existing=pruneBatches.get(batchKey);if(existing){existing.push(fix)}else{pruneBatches.set(batchKey,[fix])}}for(const batch of pruneBatches.values()){const first=batch[0];if(!first){continue}const remove=batch.map(fix=>fix.path).filter(value=>typeof value==="string"&&value.length>0);try{if(first.kind==="prune_file_link"){await runFiles(first.item_id,{remove,message:VALIDATE_AUTO_FIX_MESSAGE},global2)}else{await runDocs(first.item_id,{remove,message:VALIDATE_AUTO_FIX_MESSAGE},global2)}applied.push(...batch)}catch(error){failed.push(...batch.map(fix=>({fix,error})))}}return{applied,failed}}const _testOnlyValidateCommand={applyValidateFix,applyValidateFixes,attachValidateFixHints,buildCommandReferencesCheck,buildDependencyReferencesCheck,buildCloseReasonBackfillRows,buildFilesCheck,buildLifecycleCheck,buildLifecycleDependencyGraph,buildLifecycleParentGraph,buildEstimateBackfillRows,buildMetadataCounts,buildMissingFieldOccurrences,buildOrphanedPathRows,classifyOrphanedPath,collectDefaultProjectFileCandidates,collectTrackedGitFileCandidates,detectLifecycleDependencyCycles,detectLifecycleParentCycles,escapeRegExp,extractItemIds,findLifecycleDependencyCycleComponents,isMetadataFieldMissing,linkedArtifactPathExceedsFilesystemLimits,listFilesRecursive,resolveDependencyCycleSeverity,resolveParentCycleSeverity,resolveFileScanMode,resolveLifecycleDependencyCycleSamplePath,resolveRequestedChecks,resolveValidateMetadataProfile,resolveWorkspaceRoot,sharedDirectoryPrefixLength,summarizeOrphanedPathRows,summarizeDuplicateIssueCodes,toMeaningfulString};function appendInvalidMergeReceiptEvidenceWarning(warnings,invalidEvidenceCount){if(invalidEvidenceCount>0){warnings.push(`merge_receipt_evidence_invalid:${invalidEvidenceCount}`)}}async function buildStorageIntegrityCheck(pmRoot,items,typeToFolder,settings){const scan=await scanStorageIntegrity(pmRoot,new Set(items.map(item=>item.id)),typeToFolder,{schema:settings.schema,extensionFieldNames:collectRegisteredItemFieldNames(getActiveExtensionRegistrations())});const warnings=[];if(scan.unreadable_item_files.length>0){warnings.push(`validate_storage_unreadable_items:${scan.unreadable_item_files.length}`)}if(scan.duplicate_item_ids.length>0){warnings.push(`validate_storage_duplicate_item_ids:${scan.duplicate_item_ids.length}`)}if(scan.history_conflict_marker_streams.length>0){warnings.push(`validate_storage_history_conflict_markers:${scan.history_conflict_marker_streams.length}`)}if(scan.history_unparseable_streams.length>0){warnings.push(`validate_storage_unparseable_history:${scan.history_unparseable_streams.length}`)}if(scan.resurrected_items.length>0){warnings.push(`validate_storage_resurrected_items:${scan.resurrected_items.length}`)}if(scan.unparseable_config_files.length>0){warnings.push(`validate_storage_unparseable_config:${scan.unparseable_config_files.length}`)}const errorCount=warnings.length;const trackedRuntimeCache=await scanTrackedRuntimeCache(pmRoot);if(trackedRuntimeCache.tracked_path_count>0){warnings.push(`validate_storage_tracked_runtime_cache_files:${trackedRuntimeCache.tracked_path_count}`)}const fenceAudit=await auditMergeAttributeFence(pmRoot,resolveProjectMergeTypeFolders(settings));if(fenceAudit.status==="drift"){warnings.push(`validate_merge_fence_drift:${fenceAudit.missing_patterns.length+fenceAudit.stale_patterns.length}`)}const gitWorkspaceRoot=await findGitWorkspaceRoot(pmRoot);const mergeDriverAudit=gitWorkspaceRoot===null?null:await auditMergeDriverConfiguration(gitWorkspaceRoot);if(mergeDriverAudit!==null&&mergeDriverAudit.status!=="ok"){warnings.push(`validate_merge_driver_configuration:${mergeDriverAudit.missing_keys.length+mergeDriverAudit.drifted_keys.length}`)}const mergeReceiptEvidence=await inspectMergeReceiptEvidence(gitWorkspaceRoot??pmRoot,{includeLossless:true,pmRoot});const pendingMergeReceipts=mergeReceiptEvidence.receipts;const{pendingDecisions:pendingMergeDecisions,lossless:losslessMergeReceipts}=partitionMergeReceipts(pendingMergeReceipts);if(pendingMergeDecisions.length>0){warnings.push(`validate_merge_decisions_unreviewed:${pendingMergeDecisions.length}`)}appendInvalidMergeReceiptEvidenceWarning(warnings,mergeReceiptEvidence.invalid_evidence_count);const status=errorCount>0?"error":warnings.length>0?"warn":"ok";return{check:{name:"storage_integrity",status,ok:status==="ok",details:{...scan,merge_fence:fenceAudit,merge_driver_configuration:mergeDriverAudit,pending_merge_decision_count:pendingMergeDecisions.length,pending_merge_decision_items:[...new Set(pendingMergeDecisions.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),lossless_merge_receipt_count:losslessMergeReceipts.length,invalid_merge_receipt_evidence_count:mergeReceiptEvidence.invalid_evidence_count,invalid_merge_receipt_evidence_details:mergeReceiptEvidence.invalid_evidence,invalid_merge_receipt_evidence_details_truncated:mergeReceiptEvidence.invalid_evidence_truncated,lossless_merge_receipt_items:[...new Set(losslessMergeReceipts.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),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}}},warnings}}function recordValidateCheck(state,built,fixHintsEnabled){if(fixHintsEnabled){attachValidateFixHints(built.check,built.warnings)}state.checks.push(built.check);state.warnings.push(...built.warnings)}async function executeRequestedValidateChecks(params){const state={checks:[],warnings:[...params.initialWarnings],closeReasonBackfillRows:[],estimateBackfillRows:[],resolutionBackfillRows:[],terminalParentFixRows:[],staleLinkPruneRows:[]};const fixHintsEnabled=params.options.fixHints===true;const fullDiagnostics=params.options.verboseDiagnostics===true||params.options.allAffectedIds===true||params.global.json===true;if(params.requestedChecks.has("metadata")){const built=buildMetadataCheck(params.items,params.metadataPolicy,params.statusRegistry,fullDiagnostics,[params.settings.id_prefix]);state.closeReasonBackfillRows=built.closeReasonBackfillRows;state.estimateBackfillRows=built.estimateBackfillRows;recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("resolution")){const built=buildResolutionCheck(params.items,params.statusRegistry,fullDiagnostics);state.resolutionBackfillRows=built.resolutionBackfillRows;recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("lifecycle")){const built=buildLifecycleCheck(params.items,Boolean(params.options.checkStaleBlockers),params.dependencyCycleSeverity,params.parentCycleSeverity,params.statusRegistry,params.lifecyclePatternPolicy,fullDiagnostics,params.settings.id_prefix);state.terminalParentFixRows=built.terminalParentFixRows;recordValidateCheck(state,built,fixHintsEnabled);recordValidateCheck(state,buildDependencyReferencesCheck(params.items,fullDiagnostics,params.statusRegistry),fixHintsEnabled)}if(params.requestedChecks.has("files")){const built=await buildFilesCheck(params.items,params.workspaceRoot,params.pmRoot,params.fileScanMode,Boolean(params.options.includePmInternals),Boolean(params.options.verboseFileLists),params.statusRegistry);state.staleLinkPruneRows=built.staleLinkPruneRows;recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("command_references")){recordValidateCheck(state,await buildCommandReferencesCheck(params.items,params.settings.id_prefix,fullDiagnostics,params.pmRoot),fixHintsEnabled)}if(params.requestedChecks.has("history_drift")){recordValidateCheck(state,await buildValidateHistoryDriftCheck(params.pmRoot,params.items,fullDiagnostics),fixHintsEnabled)}if(params.requestedChecks.has("format_version")){recordValidateCheck(state,buildFormatVersionCheck(params.items,fullDiagnostics),fixHintsEnabled)}if(params.requestedChecks.has("storage_integrity")){recordValidateCheck(state,await buildStorageIntegrityCheck(params.pmRoot,params.items,resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations()).type_to_folder,params.settings),fixHintsEnabled)}return state}function planValidateFixes(options,state,settings){const planned=[];if(options.autoFix===true){planned.push(...planCloseReasonBackfillFixes(state.closeReasonBackfillRows));planned.push(...planResolutionBackfillFixes(state.resolutionBackfillRows));planned.push(...planEstimateBackfillFixes(state.estimateBackfillRows,settings.validation.estimate_defaults_by_type));planned.push(...planTerminalParentFixes(state.terminalParentFixRows))}if(options.pruneMissing===true){planned.push(...planStaleLinkPruneFixes(state.staleLinkPruneRows))}return planned}async function buildValidateFixesSummary(options,state,settings,grantedFixScopes,global2,services){if(options.autoFix!==true&&options.pruneMissing!==true){return void 0}const planned=planValidateFixes(options,state,settings);const{applicable,gated}=partitionFixesByGrant(planned,grantedFixScopes);const dryRun=options.dryRun===true;const appliedFixRows=[];const failedFixRows=[];if(!dryRun){const applied=await applyValidateFixes(applicable,global2,services);appliedFixRows.push(...applied.applied.map(toFixOutputRow));failedFixRows.push(...applied.failed.map(({fix,error})=>({...toFixOutputRow(fix),error:error instanceof Error?error.message:String(error)})))}return{mode:dryRun?"dry_run":"apply",auto_fix:options.autoFix===true,prune_missing:options.pruneMissing===true,granted_fix_scopes:[...grantedFixScopes].sort((left,right)=>left.localeCompare(right)),planned_count:planned.length,applied_count:appliedFixRows.length,gated_count:gated.length,failed_count:failedFixRows.length,planned_fixes:planned.map(toFixOutputRow),applied_fixes:appliedFixRows,gated_fixes:gated.map(fix=>({...toFixOutputRow(fix),gate_hint:`Withheld: re-run with --fix-scope ${fix.gate} to apply.`})),failed_fixes:failedFixRows}}async function runValidate(options,global2,services={}){assertProjectionModeChoice(options.counts===true,options.full===true,"--counts");const fixesRequested=options.autoFix===true||options.pruneMissing===true;if(options.dryRun===true&&!fixesRequested){throw new PmCliError("--dry-run requires --auto-fix or --prune-missing (there is nothing to preview otherwise).",EXIT_CODE.USAGE)}if(options.fixScope!==void 0&&options.fixScope.length>0&&options.autoFix!==true){throw new PmCliError("--fix-scope requires --auto-fix.",EXIT_CODE.USAGE)}const grantedFixScopes=resolveGrantedFixScopes(options.fixScope);const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const requestedChecks=resolveRequestedChecks(options);const itemReadWarnings=[];const items=await readValidateItems({includeBody:requestedChecks.has("history_drift")||requestedChecks.has("metadata"),pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,warnings:itemReadWarnings});if(requestedChecks.has("history_drift")){const authorAttribution=await scanHistoryAuthorAttribution(pmRoot);if(authorAttribution.actionable_unknown_event_count>0){itemReadWarnings.push(`validate_history_unknown_author_events:${authorAttribution.actionable_unknown_event_count}`)}}const metadataProfileSource=typeof options.metadataProfile==="string"?"option":"settings";const metadataProfile=resolveValidateMetadataProfile(typeof options.metadataProfile==="string"?options.metadataProfile:settings.validation.metadata_profile);const metadataPolicy=resolveValidateMetadataPolicy(metadataProfile,metadataProfileSource,settings.validation.metadata_required_fields);const lifecyclePatternPolicy=resolveLifecyclePatternPolicy(settings);const dependencyCycleSeverity=resolveDependencyCycleSeverity(options.dependencyCycleSeverity);const parentCycleSeverity=resolveParentCycleSeverity(options.parentCycleSeverity);const fileScanMode=resolveFileScanMode(options.scanMode);const workspaceRoot=resolveWorkspaceRoot(pmRoot);const state=await executeRequestedValidateChecks({requestedChecks,options,global:global2,pmRoot,workspaceRoot,settings,items,statusRegistry,metadataPolicy,lifecyclePatternPolicy,dependencyCycleSeverity,parentCycleSeverity,fileScanMode,initialWarnings:[...new Set(itemReadWarnings)]});const fixes=fixesRequested?await buildValidateFixesSummary(options,state,settings,grantedFixScopes,global2,services):void 0;const normalizedWarnings=[...new Set(state.warnings)].sort((left,right)=>left.localeCompare(right));const hasErrors=state.checks.some(check=>check.status==="error");const result={ok:!hasErrors,has_warnings:normalizedWarnings.length>0,checks:state.checks,warnings:normalizedWarnings,...fixes!==void 0?{fixes}:{},generated_at:nowIso(),projection:{mode:"full",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:["diagnostic_rows"]}};if(options.counts!==true)return result;return{...projectValidateCounts(result),projection:{mode:"counts",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:[]}}}export{_testOnlyValidateCommand,projectValidateCounts,runValidate};
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="16aa1db1-b6f2-504b-aa4e-0e384ad1d7a5")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{readWorkflowCompletenessCheck}from"./workflow-completeness.js";import fs from"node:fs/promises";import{realpathSync}from"node:fs";import{execFile}from"node:child_process";import path from"node:path";import{promisify}from"node:util";import{buildRemediationCommands}from"../../core/diagnostics/remediation.js";import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{collectRegisteredItemFieldNames}from"../../core/extensions/item-fields.js";import{isFileMissingError}from"../../core/fs/fs-utils.js";import{normalizeStatusInput}from"../../core/item/status.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,EXIT_CODE,PM_DIRNAME,SETTINGS_DEFAULTS}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{toNonEmptyStringOrUndefined}from"../../core/shared/primitives.js";import{nowIso}from"../../core/shared/time.js";import{CURRENT_ITEM_FORMAT_VERSION,effectiveItemFormatVersion,scanItemFormatVersions}from"../../core/item/item-format-version.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{partitionFixesByGrant,planCloseReasonBackfillFixes,planEstimateBackfillFixes,planResolutionBackfillFixes,planStaleLinkPruneFixes,planTerminalParentFixes,resolveGrantedFixScopes,toFixOutputRow}from"../../core/validate/fix-planning.js";import{findDuplicateIssueCodes}from"../../core/governance/issue-codes.js";import{buildMissingByTypeCounts}from"../../core/validate/missing-by-type.js";import{classifyStaleLinkedPaths,summarizeStaleLinkedPathClassifications}from"../../core/validate/stale-file-classification.js";import{isRemoteLinkedArtifactReference}from"../../core/validate/linked-artifact-reference.js";import{assertProjectionModeChoice}from"../output-projection.js";import{collectDanglingDependencyReferences}from"../graph/assembly.js";import{auditMergeAttributeFence,auditMergeDriverConfiguration,findGitWorkspaceRoot,resolveProjectMergeTypeFolders}from"../merge/install.js";import{inspectMergeReceiptEvidence,partitionMergeReceipts}from"../merge/receipts.js";import{buildLinkedFileRepairReport}from"./linked-file-report.js";import{scanStorageIntegrity}from"./storage-integrity.js";import{scanTrackedRuntimeCache}from"./tracked-runtime-cache.js";import{scanHistoryAuthorAttribution}from"../author-attribution.js";import{createRelationshipKindRegistry}from"../relationships.js";import{runDocs}from"../docs.js";import{runFiles}from"../files.js";import{extractReferencedPmItemIdsFromCommand}from"../test/linked-command-detection.js";import{resolveLinkedTestSourceRef,resolveLinkedTestSourceWorkspaceRoot,resolveLinkedTestTrustBatch}from"../test/trust.js";import{readValidateItems}from"./validate-item-reader.js";import{buildValidateHistoryDriftCheck}from"./validate-history-drift.js";import{buildLifecycleParentGraph,detectLifecycleParentCycles,resolveLifecycleDependencyCycleSamplePath}from"./hierarchy-validation.js";import{buildStatusRoleWarnings,inspectStatusRoleAssignments}from"./status-role-diagnostics.js";import{normalizeRelativeDirectoryPath,normalizeRelativePath,toMeaningfulString}from"./validate-normalization.js";const FILE_SCAN_DIRECTORIES=["src","tests","docs"];const FILE_SCAN_ROOT_FILES=["README.md","PRD.md","CHANGELOG.md","AGENTS.md","CONTRIBUTING.md","SECURITY.md","CODE_OF_CONDUCT.md","LICENSE"];const DIRECTORY_IGNORE_SET=new Set(["node_modules",".git",".cursor",".agents","dist","coverage"]);const RESOLUTION_FIELD_KEYS=["resolution","expected_result","actual_result"];const VALIDATE_FILE_SCAN_MODES=["default","tracked-all","tracked-all-strict"];const VALIDATE_METADATA_PROFILE_VALUES=["core","strict","custom"];const VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES=["off","warn","error"];const CORE_METADATA_REQUIRED_FIELDS=["author","acceptance_criteria","estimated_minutes","close_reason"];const STRICT_METADATA_REQUIRED_FIELDS=[...CORE_METADATA_REQUIRED_FIELDS,"reviewer","risk","confidence","sprint","release"];const SUPPORTED_METADATA_REQUIRED_FIELDS=Array.from(new Set(STRICT_METADATA_REQUIRED_FIELDS));const METADATA_REQUIRED_FIELD_ALIASES={author:"author",acceptance_criteria:"acceptance_criteria","acceptance-criteria":"acceptance_criteria",estimated_minutes:"estimated_minutes","estimated-minutes":"estimated_minutes",estimate:"estimated_minutes",close_reason:"close_reason","close-reason":"close_reason",reviewer:"reviewer",risk:"risk",confidence:"confidence",sprint:"sprint",release:"release"};const METADATA_WARNING_TOKEN_BY_FIELD={author:"validate_metadata_missing_author",acceptance_criteria:"validate_metadata_missing_acceptance_criteria",estimated_minutes:"validate_metadata_missing_estimate",close_reason:"validate_metadata_missing_close_reason",reviewer:"validate_metadata_missing_reviewer",risk:"validate_metadata_missing_risk",confidence:"validate_metadata_missing_confidence",sprint:"validate_metadata_missing_sprint",release:"validate_metadata_missing_release"};const METADATA_COUNT_KEY_BY_FIELD={author:"missing_author",acceptance_criteria:"missing_acceptance_criteria",estimated_minutes:"missing_estimated_minutes",close_reason:"closed_missing_close_reason",reviewer:"missing_reviewer",risk:"missing_risk",confidence:"missing_confidence",sprint:"missing_sprint",release:"missing_release"};const METADATA_ITEM_IDS_KEY_BY_FIELD={author:"missing_author_item_ids",acceptance_criteria:"missing_acceptance_criteria_item_ids",estimated_minutes:"missing_estimated_minutes_item_ids",close_reason:"closed_missing_close_reason_item_ids",reviewer:"missing_reviewer_item_ids",risk:"missing_risk_item_ids",confidence:"missing_confidence_item_ids",sprint:"missing_sprint_item_ids",release:"missing_release_item_ids"};const METADATA_TRUNCATED_KEY_BY_FIELD={author:"missing_author_truncated",acceptance_criteria:"missing_acceptance_criteria_truncated",estimated_minutes:"missing_estimated_minutes_truncated",close_reason:"closed_missing_close_reason_truncated",reviewer:"missing_reviewer_truncated",risk:"missing_risk_truncated",confidence:"missing_confidence_truncated",sprint:"missing_sprint_truncated",release:"missing_release_truncated"};const GIT_LS_FILES_MAX_BUFFER=32*1024*1024;const GIT_LS_FILES_TIMEOUT_MS=1e4;const FILE_LIST_SUMMARY_LIMIT=40;const DIAGNOSTIC_LIST_SUMMARY_LIMIT=5;const LINKED_ARTIFACT_MAX_PATH_LENGTH=4096;const LINKED_ARTIFACT_MAX_SEGMENT_LENGTH=255;const execFileAsync=promisify(execFile);function projectValidateCountsRecord(record){const projected={};for(const[key,value]of Object.entries(record)){if(Array.isArray(value)||value===false&&key.endsWith("_truncated")){continue}projected[key]=typeof value==="object"&&value!==null?projectValidateCountsRecord(value):value}return projected}function projectValidateCounts(result){return{...result,checks:result.checks.map(check=>({...check,details:projectValidateCountsRecord(check.details)})),...result.fixes?{fixes:{mode:result.fixes.mode,auto_fix:result.fixes.auto_fix,prune_missing:result.fixes.prune_missing,planned_count:result.fixes.planned_count,applied_count:result.fixes.applied_count,gated_count:result.fixes.gated_count,failed_count:result.fixes.failed_count}}:{}}}function normalizeStatusForRegistry(status,statusRegistry){return normalizeStatusInput(status,statusRegistry)??status}function isTerminalStatus(status,statusRegistry){return statusRegistry.terminal_statuses.has(normalizeStatusForRegistry(status,statusRegistry))}function normalizeLifecyclePatternList(values){return[...new Set((values??[]).map(value=>value.trim().toLowerCase()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right))}function areSortedStringListsEqual(left,right){if(left.length!==right.length){return false}return left.every((value,index)=>value===right[index])}function resolveLifecyclePatternPolicy(settings){const defaultStalePatterns=normalizeLifecyclePatternList(DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS);const defaultClosureLikePatterns={blocked_reason:normalizeLifecyclePatternList(DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.blocked_reason),resolution:normalizeLifecyclePatternList(DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution),actual_result:normalizeLifecyclePatternList(DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result)};const staleBlockerReasonPatterns=normalizeLifecyclePatternList(settings.validation.lifecycle_stale_blocker_reason_patterns);const closureLikePatterns={blocked_reason:normalizeLifecyclePatternList(settings.validation.lifecycle_closure_like_blocked_reason_patterns),resolution:normalizeLifecyclePatternList(settings.validation.lifecycle_closure_like_resolution_patterns),actual_result:normalizeLifecyclePatternList(settings.validation.lifecycle_closure_like_actual_result_patterns)};return{stale_blocker_reason_patterns:staleBlockerReasonPatterns,stale_blocker_reason_pattern_source:areSortedStringListsEqual(staleBlockerReasonPatterns,defaultStalePatterns)?"default":"settings",closure_like_metadata_field_patterns:closureLikePatterns,closure_like_metadata_field_pattern_sources:{blocked_reason:areSortedStringListsEqual(closureLikePatterns.blocked_reason,defaultClosureLikePatterns.blocked_reason)?"default":"settings",resolution:areSortedStringListsEqual(closureLikePatterns.resolution,defaultClosureLikePatterns.resolution)?"default":"settings",actual_result:areSortedStringListsEqual(closureLikePatterns.actual_result,defaultClosureLikePatterns.actual_result)?"default":"settings"}}}function resolveValidateMetadataProfile(value){const normalized=value?.trim().toLowerCase();if(!normalized||normalized.length===0){return"core"}if(VALIDATE_METADATA_PROFILE_VALUES.includes(normalized)){return normalized}throw new PmCliError(`Unknown --metadata-profile value "${value}". Supported values: ${VALIDATE_METADATA_PROFILE_VALUES.join(", ")}.`,EXIT_CODE.USAGE)}function resolveDependencyCycleSeverity(value){const normalized=value?.trim().toLowerCase();if(!normalized||normalized.length===0){return"warn"}if(VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.includes(normalized)){return normalized}throw new PmCliError(`Unknown --dependency-cycle-severity value "${value}". Supported values: ${VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.join(", ")}.`,EXIT_CODE.USAGE)}function resolveParentCycleSeverity(value){const normalized=value?.trim().toLowerCase();if(!normalized||normalized.length===0){return"warn"}if(VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.includes(normalized)){return normalized}throw new PmCliError(`Unknown --parent-cycle-severity value "${value}". Supported values: ${VALIDATE_DEPENDENCY_CYCLE_SEVERITY_VALUES.join(", ")}.`,EXIT_CODE.USAGE)}function normalizeMetadataRequiredFieldsFromSettings(values){const normalized=[...new Set((values??[]).map(value=>value.trim().toLowerCase().replaceAll("-","_")))];return normalized.map(value=>METADATA_REQUIRED_FIELD_ALIASES[value]).filter(value=>value!==void 0).sort((left,right)=>left.localeCompare(right))}function resolveValidateMetadataPolicy(profile,profileSource,configuredCustomFields){const normalizedCustomFields=normalizeMetadataRequiredFieldsFromSettings(configuredCustomFields);if(profile==="core"){return{profile,profile_source:profileSource,required_fields:[...CORE_METADATA_REQUIRED_FIELDS],configured_custom_fields:normalizedCustomFields,fallback_to_core:false,warnings:[]}}if(profile==="strict"){return{profile,profile_source:profileSource,required_fields:[...STRICT_METADATA_REQUIRED_FIELDS],configured_custom_fields:normalizedCustomFields,fallback_to_core:false,warnings:[]}}if(normalizedCustomFields.length>0){return{profile,profile_source:profileSource,required_fields:normalizedCustomFields,configured_custom_fields:normalizedCustomFields,fallback_to_core:false,warnings:[]}}return{profile,profile_source:profileSource,required_fields:[...CORE_METADATA_REQUIRED_FIELDS],configured_custom_fields:normalizedCustomFields,fallback_to_core:true,warnings:["validate_metadata_custom_profile_missing_required_fields:0"]}}const TERMINAL_EXEMPT_PLANNING_FIELDS=new Set(["acceptance_criteria","estimated_minutes"]);function isMetadataFieldMissing(item,field,statusRegistry,enforcePlanningFieldsOnTerminal){if(!enforcePlanningFieldsOnTerminal&&TERMINAL_EXEMPT_PLANNING_FIELDS.has(field)&&isTerminalStatus(item.status,statusRegistry)){return false}if(field==="author"){return!toNonEmptyStringOrUndefined(item.author)}if(field==="acceptance_criteria"){return!toNonEmptyStringOrUndefined(item.acceptance_criteria)}if(field==="estimated_minutes"){return!Number.isFinite(item.estimated_minutes)}if(field==="close_reason"){return normalizeStatusForRegistry(item.status,statusRegistry)===statusRegistry.close_status&&!toNonEmptyStringOrUndefined(item.close_reason)}if(field==="reviewer"){return!toNonEmptyStringOrUndefined(item.reviewer)}if(field==="risk"){return!toNonEmptyStringOrUndefined(item.risk)}if(field==="confidence"){if(typeof item.confidence==="number"){return!Number.isFinite(item.confidence)}return!toNonEmptyStringOrUndefined(item.confidence)}if(field==="sprint"){return!toNonEmptyStringOrUndefined(item.sprint)}return!toNonEmptyStringOrUndefined(item.release)}function resolveFileScanMode(scanMode){if(scanMode===void 0){return"default"}const normalized=scanMode.trim().toLowerCase();if(normalized.length===0){return"default"}if(normalized==="default"){return"default"}if(normalized==="tracked-all"||normalized==="tracked_all"){return"tracked-all"}if(normalized==="tracked-all-strict"||normalized==="tracked_all_strict"){return"tracked-all-strict"}throw new PmCliError(`Unknown --scan-mode value "${scanMode}". Supported values: ${VALIDATE_FILE_SCAN_MODES.join(", ")}.`,EXIT_CODE.USAGE)}function resolveWorkspaceRoot(pmRoot){const sourceWorkspaceRoot=process.env.PM_SOURCE_WORKSPACE_ROOT?.trim();if(sourceWorkspaceRoot){return path.resolve(sourceWorkspaceRoot)}const resolvedPmRoot=path.resolve(pmRoot);const normalizedPmRoot=resolvedPmRoot.replaceAll("\\","/");if(normalizedPmRoot.endsWith("/.agents/pm")){return path.dirname(path.dirname(resolvedPmRoot))}const resolvedCwd=path.resolve(process.cwd());const canonicalPmRoot=realpathForWorkspaceRoot(resolvedPmRoot);const canonicalCwd=realpathForWorkspaceRoot(resolvedCwd);const relativeFromPmRoot=path.relative(canonicalPmRoot,canonicalCwd);const cwdInsidePmRoot=relativeFromPmRoot.length===0||!relativeFromPmRoot.startsWith("..")&&!path.isAbsolute(relativeFromPmRoot);if(cwdInsidePmRoot){return resolvedPmRoot}return resolvedCwd}function realpathForWorkspaceRoot(inputPath){try{return realpathSync.native(inputPath)}catch{return path.resolve(inputPath)}}function hasFilesystemErrorCode(error,acceptedCodes){return typeof error==="object"&&error!==null&&"code"in error&&typeof error.code==="string"&&acceptedCodes.includes(error.code)}async function listFilesRecursive(basePath,relativePath,output){const targetDirectory=relativePath.length>0?path.join(basePath,relativePath):basePath;let entries;try{entries=await fs.readdir(targetDirectory,{withFileTypes:true})}catch(error){if(isFileMissingError(error)){return}throw error}for(const entry of entries){if(entry.name.startsWith(".")){continue}const childRelative=relativePath.length>0?path.join(relativePath,entry.name):entry.name;if(entry.isDirectory()){if(DIRECTORY_IGNORE_SET.has(entry.name)){continue}await listFilesRecursive(basePath,childRelative,output);continue}if(!entry.isFile()){continue}output.push(normalizeRelativePath(childRelative))}}async function collectDefaultProjectFileCandidates(workspaceRoot){const discovered=[];for(const directory of FILE_SCAN_DIRECTORIES){await listFilesRecursive(workspaceRoot,directory,discovered)}for(const candidate of FILE_SCAN_ROOT_FILES){const absolute=path.join(workspaceRoot,candidate);try{const stats=await fs.stat(absolute);if(stats.isFile()){discovered.push(normalizeRelativePath(candidate))}}catch{}}return[...new Set(discovered)].sort((left,right)=>left.localeCompare(right))}async function collectTrackedGitFileCandidates(workspaceRoot){try{const{stdout}=await execFileAsync("git",["ls-files","-z"],{cwd:workspaceRoot,encoding:"utf8",maxBuffer:GIT_LS_FILES_MAX_BUFFER,windowsHide:true,timeout:GIT_LS_FILES_TIMEOUT_MS});const discovered=stdout.split("\0").map(value=>normalizeRelativePath(value)).filter(value=>value.length>0);return[...new Set(discovered)].sort((left,right)=>left.localeCompare(right))}catch{return null}}function resolvePmInternalCandidatePrefixes(pmRoot,workspaceRoot){const prefixes=new Set;const configuredDefault=normalizeRelativeDirectoryPath(PM_DIRNAME);if(configuredDefault.length>0){prefixes.add(configuredDefault)}const relativePmRoot=normalizeRelativeDirectoryPath(path.relative(workspaceRoot,pmRoot));if(relativePmRoot.length>0&&!relativePmRoot.startsWith("..")){prefixes.add(relativePmRoot)}return[...prefixes].sort((left,right)=>left.localeCompare(right))}function hasPathPrefix(candidate,prefixes){for(const prefix of prefixes){if(candidate===prefix||candidate.startsWith(`${prefix}/`)){return true}}return false}async function collectProjectFileCandidates(workspaceRoot,scanMode){if(scanMode==="tracked-all"||scanMode==="tracked-all-strict"){const trackedCandidates=await collectTrackedGitFileCandidates(workspaceRoot);if(trackedCandidates){return{requestedMode:scanMode,appliedMode:scanMode,source:"tracked-git",candidateFiles:trackedCandidates,candidateTotal:trackedCandidates.length,candidateScanned:trackedCandidates.length}}const fallbackCandidates=await collectDefaultProjectFileCandidates(workspaceRoot);return{requestedMode:scanMode,appliedMode:"default",source:"tracked-all-fallback-default",candidateFiles:fallbackCandidates,candidateTotal:fallbackCandidates.length,candidateScanned:fallbackCandidates.length}}const defaultCandidates=await collectDefaultProjectFileCandidates(workspaceRoot);return{requestedMode:scanMode,appliedMode:"default",source:"default-curated",candidateFiles:defaultCandidates,candidateTotal:defaultCandidates.length,candidateScanned:defaultCandidates.length}}function summarizeList(values,limit=DIAGNOSTIC_LIST_SUMMARY_LIMIT){if(values.length<=limit){return{values,truncated:false}}return{values:values.slice(0,limit),truncated:true}}function summarizeFileList(values,verboseFileLists){if(verboseFileLists){return{values,truncated:false,total:values.length}}const summary=summarizeList(values,FILE_LIST_SUMMARY_LIMIT);return{values:summary.values,truncated:summary.truncated,total:values.length}}const RESOLUTION_REMEDIATION_FLAG_BY_FIELD={resolution:"--resolution",expected_result:"--expected-result",actual_result:"--actual-result"};const RESOLUTION_REMEDIATION_PLACEHOLDER_BY_FIELD={resolution:"Describe how this item was resolved",expected_result:"Describe the expected result",actual_result:"Describe the actual result"};function buildResolutionRemediationCommand(row){const fieldArguments=row.missing_fields.map(field=>`${RESOLUTION_REMEDIATION_FLAG_BY_FIELD[field]} "${RESOLUTION_REMEDIATION_PLACEHOLDER_BY_FIELD[field]}"`).join(" ");return`pm update ${row.id} ${fieldArguments} --message "Backfill resolution metadata"`}function attachValidateFixHints(check,checkWarnings){const existingResolutionHints=check.details?.missing_resolution_remediation_hints;const aliasedResolution=Array.isArray(existingResolutionHints)&&existingResolutionHints.length>0;const fixHints=aliasedResolution?existingResolutionHints.filter(hint=>typeof hint==="string"):buildRemediationCommands(checkWarnings);if(fixHints.length===0){return}const truncated=aliasedResolution&&check.details?.missing_resolution_remediation_hints_truncated===true;check.details={...check.details,fix_hints:fixHints,...truncated?{fix_hints_truncated:true}:{}}}function resolveRequestedChecks(options){const requested=new Set;if(options.checkCompleteness)requested.add("completeness");if(options.checkMetadata){requested.add("metadata")}if(options.checkResolution){requested.add("resolution")}if(options.checkLifecycle||options.checkStaleBlockers){requested.add("lifecycle")}if(options.checkFiles){requested.add("files")}if(options.checkHistoryDrift){requested.add("history_drift")}if(options.checkCommandReferences){requested.add("command_references")}if(options.checkStorageIntegrity){requested.add("storage_integrity")}if(requested.size===0){if(options.autoFix){requested.add("metadata");requested.add("resolution");requested.add("lifecycle")}if(options.pruneMissing){requested.add("files")}if(requested.size===0){requested.add("metadata");requested.add("resolution");requested.add("lifecycle");requested.add("files");requested.add("command_references");requested.add("history_drift");requested.add("format_version");requested.add("completeness");requested.add("storage_integrity")}return requested}if(options.pruneMissing){requested.add("files")}return requested}const DUPLICATE_ISSUE_CODE_WARNING_TOKEN="validate_metadata_duplicate_issue_codes";function summarizeDuplicateIssueCodes(duplicates,verboseDiagnostics){if(duplicates.length===0){return{rows:[],truncated:false,warnings:[]}}const limit=verboseDiagnostics?duplicates.length:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const shown=duplicates.slice(0,limit);const rows=shown.map(duplicate=>({code:duplicate.code,count:duplicate.count,ids:duplicate.ids,titles:duplicate.titles,remediation_hint:`Items ${duplicate.ids.join(", ")} share issue code "${duplicate.code}"; rename or merge so each logical code maps to one item.`}));return{rows,truncated:shown.length<duplicates.length,warnings:[`${DUPLICATE_ISSUE_CODE_WARNING_TOKEN}:${duplicates.length}`]}}function collectMissingMetadataByField(items,statusRegistry,enforcePlanningFieldsOnTerminal){const missingByField=Object.fromEntries(SUPPORTED_METADATA_REQUIRED_FIELDS.map(field=>[field,[]]));for(const item of items){for(const field of SUPPORTED_METADATA_REQUIRED_FIELDS){if(isMetadataFieldMissing(item,field,statusRegistry,enforcePlanningFieldsOnTerminal)){missingByField[field].push(item.id)}}}return missingByField}function buildMetadataWarningTokens(metadataPolicy,missingByField,duplicateWarnings){const warningTokens=[...metadataPolicy.warnings];for(const field of metadataPolicy.required_fields){const missingItems=missingByField[field];if(missingItems.length>0){warningTokens.push(`${METADATA_WARNING_TOKEN_BY_FIELD[field]}:${missingItems.length}`)}}warningTokens.push(...duplicateWarnings);return warningTokens}function buildMetadataCounts(metadataPolicy,missingByField){const counts={};for(const field of metadataPolicy.required_fields){const missing=missingByField[field];const value=missing?missing.length:0;const countKey=METADATA_COUNT_KEY_BY_FIELD[field];counts[countKey]=value}return counts}function buildMissingFieldOccurrences(metadataPolicy,missingByField,itemsById){const occurrences=[];for(const field of metadataPolicy.required_fields){const missing=missingByField[field];if(!missing){continue}for(const itemId of missing){const itemType=itemsById.get(itemId)?.type;const normalizedItemType=typeof itemType==="string"&&itemType.length>0?itemType:"Unknown";occurrences.push({item_type:normalizedItemType,field})}}return occurrences}function attachMissingMetadataItemIds(details,metadataPolicy,missingByField,verboseDiagnostics){for(const field of metadataPolicy.required_fields){const missing=missingByField[field];if(!missing||missing.length===0){continue}const idsKey=METADATA_ITEM_IDS_KEY_BY_FIELD[field];const truncatedKey=METADATA_TRUNCATED_KEY_BY_FIELD[field];if(!idsKey||!truncatedKey){continue}const summarized=summarizeList(missing,verboseDiagnostics?missing.length:DIAGNOSTIC_LIST_SUMMARY_LIMIT);details[idsKey]=summarized.values;details[truncatedKey]=summarized.truncated}}function buildCloseReasonBackfillRows(metadataPolicy,missingByField,itemsById){if(!metadataPolicy.required_fields.includes("close_reason")){return[]}const missing=missingByField.close_reason;if(!missing){return[]}return missing.map(itemId=>({id:itemId,resolution:toNonEmptyStringOrUndefined(itemsById.get(itemId)?.resolution)}))}function buildEstimateBackfillRows(metadataPolicy,missingByField,itemsById){if(!metadataPolicy.required_fields.includes("estimated_minutes")){return[]}const missing=missingByField.estimated_minutes;if(!missing){return[]}return missing.map(itemId=>({id:itemId,type:toNonEmptyStringOrUndefined(itemsById.get(itemId)?.type)}))}function buildMetadataCheck(items,metadataPolicy,statusRegistry,verboseDiagnostics,configuredIssueCodePrefixes){const itemsById=new Map(items.map(item=>[item.id,item]));const enforcePlanningFieldsOnTerminal=metadataPolicy.profile==="strict";const missingByField=collectMissingMetadataByField(items,statusRegistry,enforcePlanningFieldsOnTerminal);const duplicateIssueCodes=findDuplicateIssueCodes(items,{configuredPrefixes:configuredIssueCodePrefixes});const duplicateIssueCodeSummary=summarizeDuplicateIssueCodes(duplicateIssueCodes,verboseDiagnostics);const warningTokens=buildMetadataWarningTokens(metadataPolicy,missingByField,duplicateIssueCodeSummary.warnings);const counts=buildMetadataCounts(metadataPolicy,missingByField);const missingFieldOccurrences=buildMissingFieldOccurrences(metadataPolicy,missingByField,itemsById);const missingByType=buildMissingByTypeCounts(missingFieldOccurrences);const details={checked_items:items.length,metadata_profile:metadataPolicy.profile,metadata_profile_source:metadataPolicy.profile_source,metadata_profile_fallback_to_core:metadataPolicy.fallback_to_core,required_fields:[...metadataPolicy.required_fields],supported_required_fields:[...SUPPORTED_METADATA_REQUIRED_FIELDS],counts,missing_by_type:missingByType,duplicate_issue_codes_count:duplicateIssueCodes.length,duplicate_issue_codes:duplicateIssueCodeSummary.rows,duplicate_issue_codes_truncated:duplicateIssueCodeSummary.truncated};if(metadataPolicy.configured_custom_fields.length>0){details.configured_custom_required_fields=[...metadataPolicy.configured_custom_fields]}attachMissingMetadataItemIds(details,metadataPolicy,missingByField,verboseDiagnostics);const closeReasonBackfillRows=buildCloseReasonBackfillRows(metadataPolicy,missingByField,itemsById);const estimateBackfillRows=buildEstimateBackfillRows(metadataPolicy,missingByField,itemsById);return{check:{name:"metadata",status:warningTokens.length===0?"ok":"warn",ok:warningTokens.length===0,details},warnings:warningTokens,closeReasonBackfillRows,estimateBackfillRows}}function buildResolutionCheck(items,statusRegistry,verboseDiagnostics){const terminalDoneStatuses=new Set(statusRegistry.terminal_done_statuses);terminalDoneStatuses.add(statusRegistry.close_status);const closedItems=items.filter(item=>terminalDoneStatuses.has(normalizeStatusForRegistry(item.status,statusRegistry)));const missingResolutionRows=[];const resolutionBackfillRows=[];for(const item of closedItems){const missingFields=RESOLUTION_FIELD_KEYS.filter(field=>!toNonEmptyStringOrUndefined(item[field]));if(missingFields.length===0){continue}missingResolutionRows.push({id:item.id,missing_fields:missingFields});resolutionBackfillRows.push({id:item.id,missing_fields:missingFields,close_reason:toNonEmptyStringOrUndefined(item.close_reason)})}const warnings=missingResolutionRows.length>0?[`validate_resolution_missing_fields:${missingResolutionRows.length}`]:[];const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedRows=summarizeList(missingResolutionRows.map(row=>`${row.id}:${row.missing_fields.join(",")}`),diagnosticLimit);const remediationHints=missingResolutionRows.map(row=>buildResolutionRemediationCommand(row));const summarizedHints=summarizeList(remediationHints,diagnosticLimit);return{check:{name:"resolution",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{checked_closed_items:closedItems.length,missing_resolution_items:missingResolutionRows.length,missing_resolution_rows:summarizedRows.values,missing_resolution_rows_truncated:summarizedRows.truncated,missing_resolution_remediation_hints:summarizedHints.values,missing_resolution_remediation_hints_truncated:summarizedHints.truncated}},warnings,resolutionBackfillRows}}function escapeRegExp(value){return value.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function buildLifecycleDependencyGraph(activeItems,idPrefix="pm",relationshipRegistry=createRelationshipKindRegistry()){const activeItemIds=new Set(activeItems.map(item=>item.id));const sortedItems=[...activeItems].sort((left,right)=>left.id.localeCompare(right.id));return new Map(sortedItems.map(item=>{const edges=new Set;const blockedBy=toMeaningfulString(item.blocked_by);if(blockedBy&&activeItemIds.has(blockedBy)){edges.add(blockedBy)}(item.dependencies??[]).filter(dependency=>{const dependencyKind=toMeaningfulString(dependency.kind);return dependencyKind!==void 0&&relationshipRegistry.resolve(dependencyKind)?.ordering===true}).map(dependency=>toMeaningfulString(dependency.id)).filter(dependencyId=>dependencyId!==void 0&&activeItemIds.has(dependencyId)).forEach(dependencyId=>edges.add(dependencyId));const definitionOfReady=toMeaningfulString(item.definition_of_ready);extractItemIds(definitionOfReady??"",idPrefix).filter(referencedId=>activeItemIds.has(referencedId)).forEach(referencedId=>edges.add(referencedId));return[item.id,[...edges].sort((left,right)=>left.localeCompare(right))]}))}function buildDependencyReferencesCheck(items,verboseDiagnostics,statusRegistry){const classified=collectDanglingDependencyReferences(items,statusRegistry?status=>isTerminalStatus(status,statusRegistry):void 0);const activeRows=classified.active.map(row=>`${row.holder_id}:${row.target_id}:${row.kind}`);const legacyRows=classified.legacy_terminal.map(row=>`${row.holder_id}:${row.target_id}:${row.kind}:${row.holder_status}`);const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedRows=summarizeList(activeRows,diagnosticLimit);const summarizedLegacyRows=summarizeList(legacyRows,diagnosticLimit);const hints=summarizeList(classified.active.map(row=>{if(row.source==="parent"){return`pm update ${row.holder_id} --unset parent`}return row.source==="blocked_by"?`pm update ${row.holder_id} --unset blocked_by`:`pm update ${row.holder_id} --replace-deps '<correct dependency edges>'`}),diagnosticLimit);return{check:{name:"dependency_references",status:activeRows.length===0?"ok":"warn",ok:activeRows.length===0,details:{checked_items:items.length,dangling_reference_count:activeRows.length+legacyRows.length,active_dangling_reference_count:activeRows.length,dangling_reference_rows:summarizedRows.values,dangling_reference_rows_truncated:summarizedRows.truncated,legacy_terminal_dangling_reference_count:legacyRows.length,legacy_closed_dangling_reference_count:classified.legacy_terminal.filter(row=>row.holder_status==="closed").length,legacy_terminal_dangling_reference_rows:summarizedLegacyRows.values,legacy_terminal_dangling_reference_rows_truncated:summarizedLegacyRows.truncated,no_active_blocker_sentinel_count:classified.no_active_blocker_sentinels.length,remediation_hints:hints.values,remediation_hints_truncated:hints.truncated}},warnings:activeRows.length>0?[`validate_dangling_dependency_references:${activeRows.length}`]:[]}}function extractItemIds(value,idPrefix="pm"){const normalizedPrefix=(idPrefix.trim().toLowerCase()||"pm").replace(/-+$/g,"");const pattern=new RegExp(`(?:^|[^a-z0-9-])(${escapeRegExp(normalizedPrefix)}-[a-z0-9][a-z0-9-]*)`,"gi");return[...new Set([...value.matchAll(pattern)].map(match=>match[1].toLowerCase()))].sort((left,right)=>left.localeCompare(right))}function findLifecycleDependencyCycleComponents(graph){let nextIndex=0;const indexById=new Map;const lowLinkById=new Map;const stack=[];const inStack=new Set;const components=[];const visit=id=>{indexById.set(id,nextIndex);lowLinkById.set(id,nextIndex);nextIndex+=1;stack.push(id);inStack.add(id);for(const dependencyId of graph.get(id)??[]){if(!indexById.has(dependencyId)){visit(dependencyId);lowLinkById.set(id,Math.min(lowLinkById.get(id),lowLinkById.get(dependencyId)))}else if(inStack.has(dependencyId)){lowLinkById.set(id,Math.min(lowLinkById.get(id),indexById.get(dependencyId)))}}if(lowLinkById.get(id)!==indexById.get(id)){return}const component=[];while(stack.length>0){const member=stack.pop();inStack.delete(member);component.push(member);if(member===id){break}}component.sort((left,right)=>left.localeCompare(right));components.push(component)};const sortedNodeIds=[...graph.keys()].sort((left,right)=>left.localeCompare(right));for(const id of sortedNodeIds){if(!indexById.has(id)){visit(id)}}const cycleComponents=components.filter(component=>{if(component.length>1){return true}const selfId=component[0];return(graph.get(selfId)??[]).includes(selfId)});return cycleComponents.sort((left,right)=>left[0].localeCompare(right[0])||left.length-right.length||left.join(",").localeCompare(right.join(",")))}function detectLifecycleDependencyCycles(activeItems,idPrefix="pm"){const graph=buildLifecycleDependencyGraph(activeItems,idPrefix);const cycleComponents=findLifecycleDependencyCycleComponents(graph);const cycleItemIds=[...new Set(cycleComponents.flat())].sort((left,right)=>left.localeCompare(right));const cycleSamplePaths=cycleComponents.map(component=>resolveLifecycleDependencyCycleSamplePath(component,graph).join("->"));return{cycle_count:cycleComponents.length,cycle_item_ids:cycleItemIds,cycle_sample_paths:cycleSamplePaths}}function classifyOrphanedPath(pathValue){if(pathValue.startsWith("docs/")){return"docs_unowned"}if(pathValue.startsWith("tests/")){return"tests_unowned"}if(pathValue.startsWith("src/")){return"source_unowned"}if(pathValue.endsWith(".md")){return"docs_unowned"}return"unlinked_existing"}function directoryOf(relativePath){const slash=relativePath.lastIndexOf("/");return slash===-1?"":relativePath.slice(0,slash)}function sharedDirectoryPrefixLength(left,right){const leftParts=directoryOf(left).split("/").filter(Boolean);const rightParts=directoryOf(right).split("/").filter(Boolean);let count=0;while(count<leftParts.length&&count<rightParts.length&&leftParts[count]===rightParts[count]){count+=1}return count}function scoreOrphanOwnerCandidate(pathValue,linkedPath){const linkedDir=directoryOf(linkedPath);const orphanDir=directoryOf(pathValue);const directoryPrefix=linkedPath.endsWith("/")?linkedPath:`${linkedPath}/`;const isDirectoryPrefix=pathValue.startsWith(directoryPrefix);const sameDirectory=linkedDir.length>0&&linkedDir===orphanDir;const sharedPrefixLength=sharedDirectoryPrefixLength(pathValue,linkedPath);if(!isDirectoryPrefix&&!sameDirectory&&sharedPrefixLength===0){return null}if(isDirectoryPrefix){return{score:linkedPath.length+1e3,confidence:"path_prefix"}}return sameDirectory?{score:sharedPrefixLength+500,confidence:"same_directory"}:{score:sharedPrefixLength,confidence:"shared_directory"}}function shouldReplaceOrphanOwnerCandidate(best,item,score){return best===void 0||score>best.score||score===best.score&&item.id.localeCompare(best.item.id)<0}function findOrphanOwnerCandidate(pathValue,classification,items){const linkKind=classification==="docs_unowned"?"docs":"files";let best;items.flatMap(item=>(linkKind==="docs"?item.docs??[]:item.files??[]).map(link=>({item,link}))).forEach(({item,link})=>{if(link.scope!=="project"){return}const linkedPath=normalizeRelativePath(link.path);if(linkedPath.length===0||linkedPath===pathValue){return}const scored=scoreOrphanOwnerCandidate(pathValue,linkedPath);if(scored===null){return}if(shouldReplaceOrphanOwnerCandidate(best,item,scored.score)){best={item,score:scored.score,confidence:scored.confidence}}});if(!best){return null}return{id:best.item.id,type:best.item.type,title:best.item.title,status:best.item.status,confidence:best.confidence}}function buildOrphanedPathRows(orphanedFiles,items){return orphanedFiles.map(pathValue=>{const classification=classifyOrphanedPath(pathValue);const linkCommand=classification==="docs_unowned"?"docs":"files";const ownerCandidate=findOrphanOwnerCandidate(pathValue,classification,items);const target=ownerCandidate?.id??"<id>";return{path:pathValue,classification,owner_candidate:ownerCandidate,remediation_hint:`pm ${linkCommand} ${target} --add path=${pathValue},scope=project,note="<why this artifact belongs to the item>"`}})}function summarizeOrphanedPathRows(rows){return rows.map(row=>`${row.path}:${row.classification} owner_candidate=${row.owner_candidate?.id??"unowned"} hint=${JSON.stringify(row.remediation_hint)}`)}function closureLikeFieldsForItem(item,lifecyclePatternPolicy){return Object.entries(lifecyclePatternPolicy.closure_like_metadata_field_patterns).filter(([field,patterns])=>{const value=toMeaningfulString(item[field]);return value?patterns.some(pattern=>value.toLowerCase().includes(pattern)):false}).map(([field])=>field).sort((left,right)=>left.localeCompare(right))}function buildTerminalParentFixRow(item,parent,itemsById,canonicalIdByLowercase,statusRegistry){const grandparentId=toMeaningfulString(parent.parent);const grandparent=grandparentId?itemsById.get(canonicalIdByLowercase.get(grandparentId.toLowerCase())??grandparentId):void 0;return{id:item.id,parent_id:parent.id,grandparent_id:grandparent?.id,grandparent_active:grandparent!==void 0&&!isTerminalStatus(grandparent.status,statusRegistry)}}function staleBlockerReasonsForItem(item,blockedStatuses,statusRegistry,lifecyclePatternPolicy){const blockedBy=toMeaningfulString(item.blocked_by);const blockedReason=toMeaningfulString(item.blocked_reason);const blockedReasonNormalized=blockedReason?.toLowerCase();const normalizedStatus=normalizeStatusForRegistry(item.status,statusRegistry);const reasons=[];if(!blockedStatuses.has(normalizedStatus)){if(blockedBy){reasons.push("non_blocked_status_has_blocked_by")}if(blockedReason){reasons.push("non_blocked_status_has_blocked_reason")}return reasons}if(!blockedBy&&!blockedReason){reasons.push("blocked_status_missing_blocker_context")}if(blockedReasonNormalized?.includes("no active blocker")){reasons.push("blocked_status_reason_reports_no_active_blocker")}if(blockedReasonNormalized&&lifecyclePatternPolicy.stale_blocker_reason_patterns.some(pattern=>blockedReasonNormalized.includes(pattern))){reasons.push("blocked_status_reason_matches_stale_pattern")}return reasons}function collectLifecycleScanRows(items,includeStaleBlockers,statusRegistry,lifecyclePatternPolicy){const itemsById=new Map(items.map(item=>[item.id,item]));const canonicalIdByLowercase=new Map(items.map(item=>[item.id.toLowerCase(),item.id]));const blockedStatuses=statusRegistry.blocked_statuses.size>0?statusRegistry.blocked_statuses:new Set(["blocked"]);const rows={activeItems:items.filter(item=>!isTerminalStatus(item.status,statusRegistry)),closureLikeRows:[],terminalParentRows:[],terminalParentFixRows:[],staleBlockerRows:[]};for(const item of rows.activeItems){const closureLikeFields=closureLikeFieldsForItem(item,lifecyclePatternPolicy);if(closureLikeFields.length>0){rows.closureLikeRows.push({id:item.id,fields:closureLikeFields})}const parentId=toMeaningfulString(item.parent);const parent=parentId?itemsById.get(canonicalIdByLowercase.get(parentId.toLowerCase())??parentId):void 0;if(parent&&isTerminalStatus(parent.status,statusRegistry)){rows.terminalParentRows.push({id:item.id,parent_id:parent.id,parent_status:parent.status});rows.terminalParentFixRows.push(buildTerminalParentFixRow(item,parent,itemsById,canonicalIdByLowercase,statusRegistry))}if(includeStaleBlockers){const reasons=staleBlockerReasonsForItem(item,blockedStatuses,statusRegistry,lifecyclePatternPolicy);if(reasons.length>0){rows.staleBlockerRows.push({id:item.id,status:item.status,reasons:[...new Set(reasons)].sort((left,right)=>left.localeCompare(right))})}}}return rows}function sortLifecycleScanRows(rows){rows.closureLikeRows.sort((left,right)=>left.id.localeCompare(right.id));rows.terminalParentRows.sort((left,right)=>left.id.localeCompare(right.id)||left.parent_id.localeCompare(right.parent_id));rows.terminalParentFixRows.sort((left,right)=>left.id.localeCompare(right.id)||left.parent_id.localeCompare(right.parent_id));rows.staleBlockerRows.sort((left,right)=>left.id.localeCompare(right.id))}function lifecycleCycleWarningToken(prefix,severity,count){if(count<=0||severity==="off"){return null}return`${severity==="error"?`${prefix}_error`:prefix}:${count}`}function lifecycleAdvisoryWarningToken(prefix,severity,count){return count>0&&severity!=="off"?`${prefix}:${count}`:null}function buildLifecycleWarnings(rows,includeStaleBlockers,dependencyCycleSeverity,parentCycleSeverity,counts){const warnings=[];if(rows.closureLikeRows.length>0){warnings.push(`validate_lifecycle_active_closure_like_metadata:${rows.closureLikeRows.length}`)}if(rows.terminalParentRows.length>0){warnings.push(`validate_lifecycle_active_terminal_parent:${rows.terminalParentRows.length}`)}if(includeStaleBlockers&&rows.staleBlockerRows.length>0){warnings.push(`validate_lifecycle_stale_blockers:${rows.staleBlockerRows.length}`)}const dependencyWarning=lifecycleCycleWarningToken("validate_lifecycle_dependency_cycles",dependencyCycleSeverity,counts.dependencyCycles);const parentWarning=lifecycleCycleWarningToken("validate_hierarchy_parent_cycle",parentCycleSeverity,counts.activeHierarchyCycles);const cardinalityWarning=lifecycleCycleWarningToken("validate_hierarchy_cardinality_violation",parentCycleSeverity,counts.activeHierarchyCardinality);const divergenceWarning=lifecycleCycleWarningToken("validate_hierarchy_parent_divergence",parentCycleSeverity,counts.activeHierarchyDivergence);const legacyCycleWarning=lifecycleAdvisoryWarningToken("validate_legacy_hierarchy_parent_cycle",parentCycleSeverity,counts.legacyHierarchyCycles);const legacyCardinalityWarning=lifecycleAdvisoryWarningToken("validate_legacy_hierarchy_cardinality_violation",parentCycleSeverity,counts.legacyHierarchyCardinality);const legacyDivergenceWarning=lifecycleAdvisoryWarningToken("validate_legacy_hierarchy_parent_divergence",parentCycleSeverity,counts.legacyHierarchyDivergence);return[...warnings,...dependencyWarning?[dependencyWarning]:[],...parentWarning?[parentWarning]:[],...cardinalityWarning?[cardinalityWarning]:[],...divergenceWarning?[divergenceWarning]:[],...legacyCycleWarning?[legacyCycleWarning]:[],...legacyCardinalityWarning?[legacyCardinalityWarning]:[],...legacyDivergenceWarning?[legacyDivergenceWarning]:[]]}function linkedArtifactPathExceedsFilesystemLimits(artifactPath){const normalized=normalizeRelativePath(artifactPath);return normalized.length>LINKED_ARTIFACT_MAX_PATH_LENGTH||normalized.split(/[\\/]/).some(segment=>segment.length>LINKED_ARTIFACT_MAX_SEGMENT_LENGTH)}async function linkedArtifactIsMissing(workspaceRoot,artifactPath){const absolutePath=path.isAbsolute(artifactPath)?artifactPath:path.resolve(workspaceRoot,artifactPath);if(linkedArtifactPathExceedsFilesystemLimits(absolutePath)){return false}try{const stats=await fs.stat(absolutePath);return!stats.isFile()&&!stats.isDirectory()}catch(error){return hasFilesystemErrorCode(error,["ENOENT","ENOTDIR"])}}async function collectLinkedPathScanState(items,workspaceRoot){const state={linkedProjectPaths:new Set,remoteLinkedPaths:new Set,missingLinkedPaths:[],staleLinkRows:[]};const linkedArtifacts=items.flatMap(item=>[...(item.files??[]).map(artifact=>({item,artifact,link_kind:"files"})),...(item.docs??[]).map(artifact=>({item,artifact,link_kind:"docs"}))]);for(const{item,artifact,link_kind}of linkedArtifacts){if(artifact.scope!=="project"){continue}if(isRemoteLinkedArtifactReference(artifact.path)){state.remoteLinkedPaths.add(artifact.path.trim());continue}const normalizedPath=normalizeRelativePath(artifact.path);if(normalizedPath.length===0){continue}state.linkedProjectPaths.add(normalizedPath);if(await linkedArtifactIsMissing(workspaceRoot,artifact.path)){state.missingLinkedPaths.push(normalizedPath);state.staleLinkRows.push({item_id:item.id,path:normalizedPath,link_kind})}}return state}function partitionFileCandidates(fileCandidates,pmRoot,workspaceRoot,fileScanMode,includePmInternals,verboseFileLists){const strictTrackedAllMode=fileScanMode==="tracked-all-strict";const strictModeForcesPmInternals=strictTrackedAllMode&&!includePmInternals;const includePmInternalsEffective=includePmInternals||strictTrackedAllMode;const pmInternalCandidatePrefixes=includePmInternalsEffective?[]:resolvePmInternalCandidatePrefixes(pmRoot,workspaceRoot);const excludedPmInternalPaths=pmInternalCandidatePrefixes.length===0?[]:fileCandidates.candidateFiles.filter(candidate=>hasPathPrefix(candidate,pmInternalCandidatePrefixes));const candidateFiles=pmInternalCandidatePrefixes.length===0?fileCandidates.candidateFiles:fileCandidates.candidateFiles.filter(candidate=>!hasPathPrefix(candidate,pmInternalCandidatePrefixes));const excludedByReason={};if(excludedPmInternalPaths.length>0){const summarizedPmInternalPaths=summarizeFileList(excludedPmInternalPaths,verboseFileLists);excludedByReason.pm_internals={count:excludedPmInternalPaths.length,paths:summarizedPmInternalPaths.values,paths_truncated:summarizedPmInternalPaths.truncated,paths_total:summarizedPmInternalPaths.total}}return{strictTrackedAllMode,strictModeForcesPmInternals,includePmInternalsEffective,pmInternalCandidatePrefixes,excludedPmInternalPaths,candidateFiles,excludedByReason}}function buildLifecycleCheck(items,includeStaleBlockers,dependencyCycleSeverity,parentCycleSeverity,statusRegistry,lifecyclePatternPolicy,verboseDiagnostics,idPrefix="pm"){const rows=collectLifecycleScanRows(items,includeStaleBlockers,statusRegistry,lifecyclePatternPolicy);sortLifecycleScanRows(rows);const dependencyCycleDiagnostics=detectLifecycleDependencyCycles(rows.activeItems,idPrefix);const parentCycleDiagnostics=detectLifecycleParentCycles(items,statusRegistry);const statusRoleDiagnostics=inspectStatusRoleAssignments(statusRegistry,items,verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT);const warnings=[...buildLifecycleWarnings(rows,includeStaleBlockers,dependencyCycleSeverity,parentCycleSeverity,{dependencyCycles:dependencyCycleDiagnostics.cycle_count,activeHierarchyCycles:parentCycleDiagnostics.active_cycle_count,activeHierarchyCardinality:parentCycleDiagnostics.active_cardinality_violation_count,activeHierarchyDivergence:parentCycleDiagnostics.active_parent_divergence_count,legacyHierarchyCycles:parentCycleDiagnostics.legacy_cycle_count,legacyHierarchyCardinality:parentCycleDiagnostics.legacy_cardinality_violation_count,legacyHierarchyDivergence:parentCycleDiagnostics.legacy_parent_divergence_count}),...buildStatusRoleWarnings(statusRoleDiagnostics)];const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedClosureLikeRows=summarizeList(rows.closureLikeRows.map(row=>`${row.id}:${row.fields.join(",")}`),diagnosticLimit);const summarizedTerminalParentRows=summarizeList(rows.terminalParentRows.map(row=>`${row.id}:${row.parent_id}:${row.parent_status}`),diagnosticLimit);const summarizedStaleBlockerRows=summarizeList(rows.staleBlockerRows.map(row=>`${row.id}:${row.status}:${row.reasons.join(",")}`),diagnosticLimit);const summarizedDependencyCycleItemIds=summarizeList(dependencyCycleDiagnostics.cycle_item_ids,diagnosticLimit);const summarizedDependencyCycleSamplePaths=summarizeList(dependencyCycleDiagnostics.cycle_sample_paths,diagnosticLimit);const summarizedParentCycleItemIds=summarizeList(parentCycleDiagnostics.cycle_item_ids,diagnosticLimit);const summarizedParentCycleSamplePaths=summarizeList(parentCycleDiagnostics.cycle_sample_paths,diagnosticLimit);const summarizedHierarchyCardinalityRows=summarizeList(parentCycleDiagnostics.cardinality_violation_rows,diagnosticLimit);const summarizedHierarchyDivergenceRows=summarizeList(parentCycleDiagnostics.parent_divergence_rows,diagnosticLimit);const hasErrorSeverityCycle=dependencyCycleDiagnostics.cycle_count>0&&dependencyCycleSeverity==="error"||(parentCycleDiagnostics.active_cycle_count>0||parentCycleDiagnostics.active_cardinality_violation_count>0||parentCycleDiagnostics.active_parent_divergence_count>0)&&parentCycleSeverity==="error";return{check:{name:"lifecycle",status:hasErrorSeverityCycle?"error":warnings.length===0?"ok":"warn",ok:!hasErrorSeverityCycle&&warnings.length===0,details:{checked_active_items:rows.activeItems.length,lifecycle_status_roles:statusRoleDiagnostics,active_closure_like_metadata_items:rows.closureLikeRows.length,active_closure_like_metadata_rows:summarizedClosureLikeRows.values,active_closure_like_metadata_rows_truncated:summarizedClosureLikeRows.truncated,active_terminal_parent_items:rows.terminalParentRows.length,active_terminal_parent_rows:summarizedTerminalParentRows.values,active_terminal_parent_rows_truncated:summarizedTerminalParentRows.truncated,stale_blocker_checks_enabled:includeStaleBlockers,stale_blocker_items:rows.staleBlockerRows.length,stale_blocker_rows:summarizedStaleBlockerRows.values,stale_blocker_rows_truncated:summarizedStaleBlockerRows.truncated,dependency_cycle_severity_policy:dependencyCycleSeverity,dependency_cycle_count:dependencyCycleDiagnostics.cycle_count,dependency_cycle_item_count:dependencyCycleDiagnostics.cycle_item_ids.length,dependency_cycle_item_ids:summarizedDependencyCycleItemIds.values,dependency_cycle_item_ids_truncated:summarizedDependencyCycleItemIds.truncated,dependency_cycle_sample_paths:summarizedDependencyCycleSamplePaths.values,dependency_cycle_sample_paths_truncated:summarizedDependencyCycleSamplePaths.truncated,parent_cycle_severity_policy:parentCycleSeverity,parent_cycle_count:parentCycleDiagnostics.cycle_count,active_parent_cycle_count:parentCycleDiagnostics.active_cycle_count,legacy_parent_cycle_count:parentCycleDiagnostics.legacy_cycle_count,parent_cycle_item_count:parentCycleDiagnostics.cycle_item_ids.length,parent_cycle_item_ids:summarizedParentCycleItemIds.values,parent_cycle_item_ids_truncated:summarizedParentCycleItemIds.truncated,parent_cycle_sample_paths:summarizedParentCycleSamplePaths.values,parent_cycle_sample_paths_truncated:summarizedParentCycleSamplePaths.truncated,hierarchy_cardinality_violation_count:parentCycleDiagnostics.cardinality_violation_count,active_hierarchy_cardinality_violation_count:parentCycleDiagnostics.active_cardinality_violation_count,legacy_hierarchy_cardinality_violation_count:parentCycleDiagnostics.legacy_cardinality_violation_count,hierarchy_cardinality_violation_rows:summarizedHierarchyCardinalityRows.values,hierarchy_cardinality_violation_rows_truncated:summarizedHierarchyCardinalityRows.truncated,hierarchy_parent_divergence_count:parentCycleDiagnostics.parent_divergence_count,active_hierarchy_parent_divergence_count:parentCycleDiagnostics.active_parent_divergence_count,legacy_hierarchy_parent_divergence_count:parentCycleDiagnostics.legacy_parent_divergence_count,hierarchy_parent_divergence_rows:summarizedHierarchyDivergenceRows.values,hierarchy_parent_divergence_rows_truncated:summarizedHierarchyDivergenceRows.truncated,stale_blocker_reason_patterns:[...lifecyclePatternPolicy.stale_blocker_reason_patterns],stale_blocker_reason_pattern_source:lifecyclePatternPolicy.stale_blocker_reason_pattern_source,closure_like_blocked_reason_patterns:[...lifecyclePatternPolicy.closure_like_metadata_field_patterns.blocked_reason],closure_like_blocked_reason_pattern_source:lifecyclePatternPolicy.closure_like_metadata_field_pattern_sources.blocked_reason,closure_like_resolution_patterns:[...lifecyclePatternPolicy.closure_like_metadata_field_patterns.resolution],closure_like_resolution_pattern_source:lifecyclePatternPolicy.closure_like_metadata_field_pattern_sources.resolution,closure_like_actual_result_patterns:[...lifecyclePatternPolicy.closure_like_metadata_field_patterns.actual_result],closure_like_actual_result_pattern_source:lifecyclePatternPolicy.closure_like_metadata_field_pattern_sources.actual_result}},warnings,terminalParentFixRows:rows.terminalParentFixRows}}async function buildFilesCheck(items,workspaceRoot,pmRoot,fileScanMode,includePmInternals,verboseFileLists,statusRegistry=resolveRuntimeStatusRegistry(SETTINGS_DEFAULTS.schema)){const linkedPathState=await collectLinkedPathScanState(items,workspaceRoot);const itemsById=new Map(items.map(item=>[item.id,item]));const uniqueMissingLinkedPaths=[...new Set(linkedPathState.missingLinkedPaths)].sort((left,right)=>left.localeCompare(right));const fileCandidates=await collectProjectFileCandidates(workspaceRoot,fileScanMode);const partition=partitionFileCandidates(fileCandidates,pmRoot,workspaceRoot,fileScanMode,includePmInternals,verboseFileLists);const orphanedFiles=partition.candidateFiles.filter(candidate=>!linkedPathState.linkedProjectPaths.has(candidate));const orphanedPathRows=buildOrphanedPathRows(orphanedFiles,items);const classifiedStalePaths=classifyStaleLinkedPaths(uniqueMissingLinkedPaths,partition.candidateFiles);const classificationByPath=new Map(classifiedStalePaths.map(entry=>[entry.path,entry.classification]));const movedStalePathCount=classifiedStalePaths.filter(entry=>entry.classification==="moved").length;const staleLinkPruneRows=linkedPathState.staleLinkRows.map(row=>({...row,classification:classificationByPath.get(row.path)??"deleted"})).sort((left,right)=>left.item_id.localeCompare(right.item_id)||left.path.localeCompare(right.path)||left.link_kind.localeCompare(right.link_kind));const warnings=[];if(partition.strictModeForcesPmInternals){warnings.push("validate_files_tracked_all_strict_forces_pm_internals")}if(orphanedFiles.length>0){warnings.push(`validate_files_orphaned_paths:${orphanedFiles.length}`)}const uniqueRemoteLinkedPaths=[...linkedPathState.remoteLinkedPaths].sort((left,right)=>left.localeCompare(right));const summarizedRemote=summarizeFileList(uniqueRemoteLinkedPaths,verboseFileLists);const summarizedMissing=summarizeFileList(uniqueMissingLinkedPaths,verboseFileLists);const summarizedOrphaned=summarizeFileList(orphanedFiles,verboseFileLists);const summarizedOrphanedClassifications=summarizeFileList(orphanedPathRows.map(row=>`${row.path}:${row.classification}:owner_candidate=${row.owner_candidate?.id??"unowned"}`),verboseFileLists);const orphanedPathRowDetail=verboseFileLists?orphanedPathRows:summarizeFileList(summarizeOrphanedPathRows(orphanedPathRows),false).values;const summarizedClassifications=summarizeFileList(summarizeStaleLinkedPathClassifications(classifiedStalePaths),verboseFileLists);const missingLinkedPathRows=staleLinkPruneRows;const repairReport=buildLinkedFileRepairReport(missingLinkedPathRows,classifiedStalePaths,id=>itemsById.get(id),statusRegistry,verboseFileLists?Infinity:FILE_LIST_SUMMARY_LIMIT);if(repairReport.active_missing_linked_paths_count>0){warnings.push(`validate_files_missing_linked_paths:${repairReport.active_missing_linked_paths_count}`)}return{check:{name:"files",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{workspace_root:workspaceRoot,scan_mode_requested:fileCandidates.requestedMode,scan_mode_applied:fileCandidates.appliedMode,strict_tracked_all_mode:partition.strictTrackedAllMode,strict_mode_forces_pm_internals:partition.strictModeForcesPmInternals,strict_mode_forces_pm_internals_notice:partition.strictModeForcesPmInternals?"tracked-all-strict force-enables PM internals; pass --include-pm-internals to make inclusion explicit.":null,file_list_detail_mode:verboseFileLists?"full":"summary",file_list_summary_limit:FILE_LIST_SUMMARY_LIMIT,candidate_scan_source:fileCandidates.source,include_pm_internals:partition.includePmInternalsEffective,include_pm_internals_requested:includePmInternals,pm_internal_candidate_prefixes:partition.pmInternalCandidatePrefixes,pm_internal_excluded_count:partition.excludedPmInternalPaths.length,excluded_total:partition.excludedPmInternalPaths.length,excluded_by_reason:partition.excludedByReason,linked_project_paths:linkedPathState.linkedProjectPaths.size,remote_linked_paths_count:uniqueRemoteLinkedPaths.length,remote_linked_paths_total:summarizedRemote.total,remote_linked_paths:summarizedRemote.values,remote_linked_paths_truncated:summarizedRemote.truncated,candidate_total_raw:fileCandidates.candidateTotal,candidate_scanned_raw:fileCandidates.candidateScanned,candidate_total:partition.candidateFiles.length,candidate_scanned:partition.candidateFiles.length,scanned_candidate_files:partition.candidateFiles.length,missing_linked_paths_count:uniqueMissingLinkedPaths.length,missing_linked_paths_total:summarizedMissing.total,missing_linked_paths:summarizedMissing.values,missing_linked_paths_truncated:summarizedMissing.truncated,missing_linked_paths_moved_count:movedStalePathCount,missing_linked_paths_deleted_count:classifiedStalePaths.filter(entry=>entry.classification==="deleted").length,missing_linked_paths_malformed_count:classifiedStalePaths.filter(entry=>entry.classification==="malformed").length,missing_linked_path_classifications:summarizedClassifications.values,missing_linked_path_classifications_truncated:summarizedClassifications.truncated,...repairReport,orphaned_paths_count:orphanedFiles.length,orphaned_paths_total:summarizedOrphaned.total,orphaned_paths:summarizedOrphaned.values,orphaned_paths_truncated:summarizedOrphaned.truncated,orphaned_path_classifications:summarizedOrphanedClassifications.values,orphaned_path_classifications_truncated:summarizedOrphanedClassifications.truncated,orphaned_path_rows_count:orphanedPathRows.length,orphaned_path_rows:orphanedPathRowDetail}},warnings,staleLinkPruneRows}}function summarizeCommandPreview(command){const normalizedCommand=command.trim().replaceAll(/\s+/g," ");return normalizedCommand.length>120?`${normalizedCommand.slice(0,117)}...`:normalizedCommand}function summarizeCommandReferenceRow(ownerId,referencedId,command){return`${ownerId}:${referencedId}:${summarizeCommandPreview(command)}`}function buildUntrustedLinkedTestRows(linkedTests,trustDecisions){const rows=[];linkedTests.forEach(({item,linkedTest},index)=>{const trust=trustDecisions[index];if(trust.trusted)return;const command=summarizeCommandPreview(linkedTest.command??"");rows.push(`${item.id}:${trust.source_ref??"unknown"}->${trust.current_source_ref??"unknown"}:${command}`)});return rows}async function buildCommandReferencesCheck(items,idPrefix,verboseDiagnostics,pmRoot){const knownIds=new Set(items.map(item=>item.id.toLowerCase()));let linkedCommandsScanned=0;let referencedPmIdCount=0;const referencedPmIds=new Set;const staleReferenceRows=[];const linkedTests=items.flatMap(item=>(item.tests??[]).map(linkedTest=>({item,linkedTest})));const currentSourceRef=await resolveLinkedTestSourceRef(resolveLinkedTestSourceWorkspaceRoot());const trustDecisions=await resolveLinkedTestTrustBatch(pmRoot,linkedTests.map(({linkedTest})=>linkedTest),currentSourceRef);const untrustedRows=buildUntrustedLinkedTestRows(linkedTests,trustDecisions);for(const{item,linkedTest}of linkedTests){if(typeof linkedTest.command!=="string"||linkedTest.command.trim().length===0){continue}linkedCommandsScanned+=1;const referencedIds=extractReferencedPmItemIdsFromCommand(linkedTest.command,idPrefix);if(referencedIds.length===0){continue}referencedPmIdCount+=referencedIds.length;for(const referencedId of referencedIds){referencedPmIds.add(referencedId);if(!knownIds.has(referencedId.toLowerCase())){staleReferenceRows.push(summarizeCommandReferenceRow(item.id,referencedId,linkedTest.command))}}}const uniqueStaleReferenceRows=[...new Set(staleReferenceRows)].sort((left,right)=>left.localeCompare(right));const stalePmIds=[...new Set(uniqueStaleReferenceRows.map(row=>row.split(":")[1]??""))].filter(value=>value.length>0).sort((left,right)=>left.localeCompare(right));const warnings=[];if(uniqueStaleReferenceRows.length>0){warnings.push(`validate_command_references_stale_pm_ids:${uniqueStaleReferenceRows.length}`)}if(untrustedRows.length>0){warnings.push(`validate_linked_test_trust_unacknowledged:${untrustedRows.length}`)}const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedRows=summarizeList(uniqueStaleReferenceRows,diagnosticLimit);const summarizedStalePmIds=summarizeList(stalePmIds,diagnosticLimit);const summarizedReferencedPmIds=summarizeList([...referencedPmIds].sort((left,right)=>left.localeCompare(right)),diagnosticLimit);const summarizedUntrustedRows=summarizeList(untrustedRows,diagnosticLimit);return{check:{name:"command_references",status:warnings.length===0?"ok":"warn",ok:warnings.length===0,details:{checked_items:items.length,linked_commands_scanned:linkedCommandsScanned,referenced_pm_ids_count:referencedPmIdCount,unique_referenced_pm_ids_count:referencedPmIds.size,unique_referenced_pm_ids:summarizedReferencedPmIds.values,unique_referenced_pm_ids_truncated:summarizedReferencedPmIds.truncated,linked_test_trust_current_source_ref:currentSourceRef??null,untrusted_linked_tests_count:untrustedRows.length,untrusted_linked_tests:summarizedUntrustedRows.values,untrusted_linked_tests_truncated:summarizedUntrustedRows.truncated,stale_pm_id_references_count:uniqueStaleReferenceRows.length,stale_pm_ids_count:stalePmIds.length,stale_pm_ids:summarizedStalePmIds.values,stale_pm_ids_truncated:summarizedStalePmIds.truncated,stale_pm_id_reference_rows:summarizedRows.values,stale_pm_id_reference_rows_truncated:summarizedRows.truncated}},warnings}}function buildFormatVersionCheck(items,verboseDiagnostics){const scan=scanItemFormatVersions(items.map(item=>({ref:item.id,version:effectiveItemFormatVersion(item)})));const warnings=[];if(scan.outdated.length>0){warnings.push(`validate_format_version_outdated_items:${scan.outdated.length}`)}if(scan.ahead.length>0){warnings.push(`validate_format_version_ahead_items:${scan.ahead.length}`)}const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DIAGNOSTIC_LIST_SUMMARY_LIMIT;const summarizedOutdated=summarizeList(scan.outdated,diagnosticLimit);const summarizedAhead=summarizeList(scan.ahead,diagnosticLimit);const status=scan.ahead.length>0?"error":scan.outdated.length>0?"warn":"ok";return{check:{name:"format_version",status,ok:status==="ok",details:{checked_items:items.length,current_format_version:CURRENT_ITEM_FORMAT_VERSION,outdated_items_count:scan.outdated.length,outdated_items:summarizedOutdated.values,outdated_items_truncated:summarizedOutdated.truncated,ahead_items_count:scan.ahead.length,ahead_items:summarizedAhead.values,ahead_items_truncated:summarizedAhead.truncated}},warnings}}const VALIDATE_AUTO_FIX_MESSAGE="pm validate auto-fix";async function applyValidateFix(fix,global2,services){switch(fix.kind){case"set_resolution":case"set_close_reason":case"set_estimate":case"reparent":case"unset_parent":{const updateOptions={message:VALIDATE_AUTO_FIX_MESSAGE};if(fix.kind==="set_resolution"){updateOptions.resolution=fix.value}else if(fix.kind==="set_close_reason"){updateOptions.closeReason=fix.value}else if(fix.kind==="set_estimate"){updateOptions.estimatedMinutes=fix.value}else if(fix.kind==="reparent"){updateOptions.parent=fix.parent_id}else{updateOptions.unset=["parent"]}if(!services.runUpdate){throw new PmCliError("Applying validate metadata/lifecycle fixes requires a runUpdate mutation service.",EXIT_CODE.USAGE)}await services.runUpdate(fix.item_id,updateOptions,global2);return}case"prune_file_link":{throw new Error(`Unsupported non-batched fix kind: ${fix.kind}`)}case"prune_doc_link":{throw new Error(`Unsupported non-batched fix kind: ${fix.kind}`)}}}function pruneBatchKey(fix){if(fix.kind!=="prune_file_link"&&fix.kind!=="prune_doc_link"){return null}return`${fix.kind}:${fix.item_id}`}async function applyValidateFixes(applicable,global2,services){const applied=[];const failed=[];const pruneBatches=new Map;for(const fix of applicable.filter(candidate=>pruneBatchKey(candidate)===null)){try{await applyValidateFix(fix,global2,services);applied.push(fix)}catch(error){failed.push({fix,error})}}for(const fix of applicable.filter(candidate=>pruneBatchKey(candidate)!==null)){const batchKey=pruneBatchKey(fix);const existing=pruneBatches.get(batchKey);if(existing){existing.push(fix)}else{pruneBatches.set(batchKey,[fix])}}for(const batch of pruneBatches.values()){const first=batch[0];if(!first){continue}const remove=batch.map(fix=>fix.path).filter(value=>typeof value==="string"&&value.length>0);try{if(first.kind==="prune_file_link"){await runFiles(first.item_id,{remove,message:VALIDATE_AUTO_FIX_MESSAGE},global2)}else{await runDocs(first.item_id,{remove,message:VALIDATE_AUTO_FIX_MESSAGE},global2)}applied.push(...batch)}catch(error){failed.push(...batch.map(fix=>({fix,error})))}}return{applied,failed}}const _testOnlyValidateCommand={applyValidateFix,applyValidateFixes,attachValidateFixHints,buildCommandReferencesCheck,buildDependencyReferencesCheck,buildCloseReasonBackfillRows,buildFilesCheck,buildLifecycleCheck,buildLifecycleDependencyGraph,buildLifecycleParentGraph,buildEstimateBackfillRows,buildMetadataCounts,buildMissingFieldOccurrences,buildOrphanedPathRows,classifyOrphanedPath,collectDefaultProjectFileCandidates,collectTrackedGitFileCandidates,detectLifecycleDependencyCycles,detectLifecycleParentCycles,escapeRegExp,extractItemIds,findLifecycleDependencyCycleComponents,isMetadataFieldMissing,linkedArtifactPathExceedsFilesystemLimits,listFilesRecursive,resolveDependencyCycleSeverity,resolveParentCycleSeverity,resolveFileScanMode,resolveLifecycleDependencyCycleSamplePath,resolveRequestedChecks,resolveValidateMetadataProfile,resolveWorkspaceRoot,sharedDirectoryPrefixLength,summarizeOrphanedPathRows,summarizeDuplicateIssueCodes,toMeaningfulString};function appendInvalidMergeReceiptEvidenceWarning(warnings,invalidEvidenceCount){if(invalidEvidenceCount>0){warnings.push(`merge_receipt_evidence_invalid:${invalidEvidenceCount}`)}}async function buildStorageIntegrityCheck(pmRoot,items,typeToFolder,settings){const scan=await scanStorageIntegrity(pmRoot,new Set(items.map(item=>item.id)),typeToFolder,{schema:settings.schema,extensionFieldNames:collectRegisteredItemFieldNames(getActiveExtensionRegistrations())});const warnings=[];if(scan.unreadable_item_files.length>0){warnings.push(`validate_storage_unreadable_items:${scan.unreadable_item_files.length}`)}if(scan.duplicate_item_ids.length>0){warnings.push(`validate_storage_duplicate_item_ids:${scan.duplicate_item_ids.length}`)}if(scan.history_conflict_marker_streams.length>0){warnings.push(`validate_storage_history_conflict_markers:${scan.history_conflict_marker_streams.length}`)}if(scan.history_unparseable_streams.length>0){warnings.push(`validate_storage_unparseable_history:${scan.history_unparseable_streams.length}`)}if(scan.resurrected_items.length>0){warnings.push(`validate_storage_resurrected_items:${scan.resurrected_items.length}`)}if(scan.unparseable_config_files.length>0){warnings.push(`validate_storage_unparseable_config:${scan.unparseable_config_files.length}`)}const errorCount=warnings.length;const trackedRuntimeCache=await scanTrackedRuntimeCache(pmRoot);if(trackedRuntimeCache.tracked_path_count>0){warnings.push(`validate_storage_tracked_runtime_cache_files:${trackedRuntimeCache.tracked_path_count}`)}const fenceAudit=await auditMergeAttributeFence(pmRoot,resolveProjectMergeTypeFolders(settings));if(fenceAudit.status==="drift"){warnings.push(`validate_merge_fence_drift:${fenceAudit.missing_patterns.length+fenceAudit.stale_patterns.length}`)}const gitWorkspaceRoot=await findGitWorkspaceRoot(pmRoot);const mergeDriverAudit=gitWorkspaceRoot===null?null:await auditMergeDriverConfiguration(gitWorkspaceRoot);if(mergeDriverAudit!==null&&mergeDriverAudit.status!=="ok"){warnings.push(`validate_merge_driver_configuration:${mergeDriverAudit.missing_keys.length+mergeDriverAudit.drifted_keys.length}`)}const mergeReceiptEvidence=await inspectMergeReceiptEvidence(gitWorkspaceRoot??pmRoot,{includeLossless:true,pmRoot});const pendingMergeReceipts=mergeReceiptEvidence.receipts;const{pendingDecisions:pendingMergeDecisions,lossless:losslessMergeReceipts}=partitionMergeReceipts(pendingMergeReceipts);if(pendingMergeDecisions.length>0){warnings.push(`validate_merge_decisions_unreviewed:${pendingMergeDecisions.length}`)}appendInvalidMergeReceiptEvidenceWarning(warnings,mergeReceiptEvidence.invalid_evidence_count);const status=errorCount>0?"error":warnings.length>0?"warn":"ok";return{check:{name:"storage_integrity",status,ok:status==="ok",details:{...scan,merge_fence:fenceAudit,merge_driver_configuration:mergeDriverAudit,pending_merge_decision_count:pendingMergeDecisions.length,pending_merge_decision_items:[...new Set(pendingMergeDecisions.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),lossless_merge_receipt_count:losslessMergeReceipts.length,invalid_merge_receipt_evidence_count:mergeReceiptEvidence.invalid_evidence_count,invalid_merge_receipt_evidence_details:mergeReceiptEvidence.invalid_evidence,invalid_merge_receipt_evidence_details_truncated:mergeReceiptEvidence.invalid_evidence_truncated,lossless_merge_receipt_items:[...new Set(losslessMergeReceipts.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right)),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}}},warnings}}function recordValidateCheck(state,built,fixHintsEnabled){if(fixHintsEnabled){attachValidateFixHints(built.check,built.warnings)}state.checks.push(built.check);state.warnings.push(...built.warnings)}async function executeRequestedValidateChecks(params){const state={checks:[],warnings:[...params.initialWarnings],closeReasonBackfillRows:[],estimateBackfillRows:[],resolutionBackfillRows:[],terminalParentFixRows:[],staleLinkPruneRows:[]};const fixHintsEnabled=params.options.fixHints===true;const fullDiagnostics=params.options.verboseDiagnostics===true||params.options.allAffectedIds===true||params.global.json===true;if(params.requestedChecks.has("completeness")){const built=await readWorkflowCompletenessCheck(params.pmRoot,params.items,fullDiagnostics?Infinity:DIAGNOSTIC_LIST_SUMMARY_LIMIT,params.sourceIncomplete);recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("metadata")){const built=buildMetadataCheck(params.items,params.metadataPolicy,params.statusRegistry,fullDiagnostics,[params.settings.id_prefix]);state.closeReasonBackfillRows=built.closeReasonBackfillRows;state.estimateBackfillRows=built.estimateBackfillRows;recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("resolution")){const built=buildResolutionCheck(params.items,params.statusRegistry,fullDiagnostics);state.resolutionBackfillRows=built.resolutionBackfillRows;recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("lifecycle")){const built=buildLifecycleCheck(params.items,Boolean(params.options.checkStaleBlockers),params.dependencyCycleSeverity,params.parentCycleSeverity,params.statusRegistry,params.lifecyclePatternPolicy,fullDiagnostics,params.settings.id_prefix);state.terminalParentFixRows=built.terminalParentFixRows;recordValidateCheck(state,built,fixHintsEnabled);recordValidateCheck(state,buildDependencyReferencesCheck(params.items,fullDiagnostics,params.statusRegistry),fixHintsEnabled)}if(params.requestedChecks.has("files")){const built=await buildFilesCheck(params.items,params.workspaceRoot,params.pmRoot,params.fileScanMode,Boolean(params.options.includePmInternals),Boolean(params.options.verboseFileLists),params.statusRegistry);state.staleLinkPruneRows=built.staleLinkPruneRows;recordValidateCheck(state,built,fixHintsEnabled)}if(params.requestedChecks.has("command_references")){recordValidateCheck(state,await buildCommandReferencesCheck(params.items,params.settings.id_prefix,fullDiagnostics,params.pmRoot),fixHintsEnabled)}if(params.requestedChecks.has("history_drift")){recordValidateCheck(state,await buildValidateHistoryDriftCheck(params.pmRoot,params.items,fullDiagnostics),fixHintsEnabled)}if(params.requestedChecks.has("format_version")){recordValidateCheck(state,buildFormatVersionCheck(params.items,fullDiagnostics),fixHintsEnabled)}if(params.requestedChecks.has("storage_integrity")){recordValidateCheck(state,await buildStorageIntegrityCheck(params.pmRoot,params.items,resolveItemTypeRegistry(params.settings,getActiveExtensionRegistrations()).type_to_folder,params.settings),fixHintsEnabled)}return state}function planValidateFixes(options,state,settings){const planned=[];if(options.autoFix===true){planned.push(...planCloseReasonBackfillFixes(state.closeReasonBackfillRows));planned.push(...planResolutionBackfillFixes(state.resolutionBackfillRows));planned.push(...planEstimateBackfillFixes(state.estimateBackfillRows,settings.validation.estimate_defaults_by_type));planned.push(...planTerminalParentFixes(state.terminalParentFixRows))}if(options.pruneMissing===true){planned.push(...planStaleLinkPruneFixes(state.staleLinkPruneRows))}return planned}async function buildValidateFixesSummary(options,state,settings,grantedFixScopes,global2,services){if(options.autoFix!==true&&options.pruneMissing!==true){return void 0}const planned=planValidateFixes(options,state,settings);const{applicable,gated}=partitionFixesByGrant(planned,grantedFixScopes);const dryRun=options.dryRun===true;const appliedFixRows=[];const failedFixRows=[];if(!dryRun){const applied=await applyValidateFixes(applicable,global2,services);appliedFixRows.push(...applied.applied.map(toFixOutputRow));failedFixRows.push(...applied.failed.map(({fix,error})=>({...toFixOutputRow(fix),error:error instanceof Error?error.message:String(error)})))}return{mode:dryRun?"dry_run":"apply",auto_fix:options.autoFix===true,prune_missing:options.pruneMissing===true,granted_fix_scopes:[...grantedFixScopes].sort((left,right)=>left.localeCompare(right)),planned_count:planned.length,applied_count:appliedFixRows.length,gated_count:gated.length,failed_count:failedFixRows.length,planned_fixes:planned.map(toFixOutputRow),applied_fixes:appliedFixRows,gated_fixes:gated.map(fix=>({...toFixOutputRow(fix),gate_hint:`Withheld: re-run with --fix-scope ${fix.gate} to apply.`})),failed_fixes:failedFixRows}}async function runValidate(options,global2,services={}){assertProjectionModeChoice(options.counts===true,options.full===true,"--counts");const fixesRequested=options.autoFix===true||options.pruneMissing===true;if(options.dryRun===true&&!fixesRequested){throw new PmCliError("--dry-run requires --auto-fix or --prune-missing (there is nothing to preview otherwise).",EXIT_CODE.USAGE)}if(options.fixScope!==void 0&&options.fixScope.length>0&&options.autoFix!==true){throw new PmCliError("--fix-scope requires --auto-fix.",EXIT_CODE.USAGE)}const grantedFixScopes=resolveGrantedFixScopes(options.fixScope);const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const requestedChecks=resolveRequestedChecks(options);const itemReadWarnings=[];const items=await readValidateItems({includeBody:["history_drift","metadata","completeness"].some(check=>requestedChecks.has(check)),pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,warnings:itemReadWarnings});const sourceIncomplete=itemReadWarnings.length>0;if(requestedChecks.has("history_drift")){const authorAttribution=await scanHistoryAuthorAttribution(pmRoot);if(authorAttribution.actionable_unknown_event_count>0){itemReadWarnings.push(`validate_history_unknown_author_events:${authorAttribution.actionable_unknown_event_count}`)}}const metadataProfileSource=typeof options.metadataProfile==="string"?"option":"settings";const metadataProfile=resolveValidateMetadataProfile(typeof options.metadataProfile==="string"?options.metadataProfile:settings.validation.metadata_profile);const metadataPolicy=resolveValidateMetadataPolicy(metadataProfile,metadataProfileSource,settings.validation.metadata_required_fields);const lifecyclePatternPolicy=resolveLifecyclePatternPolicy(settings);const dependencyCycleSeverity=resolveDependencyCycleSeverity(options.dependencyCycleSeverity);const parentCycleSeverity=resolveParentCycleSeverity(options.parentCycleSeverity);const fileScanMode=resolveFileScanMode(options.scanMode);const workspaceRoot=resolveWorkspaceRoot(pmRoot);const state=await executeRequestedValidateChecks({requestedChecks,options,global:global2,pmRoot,workspaceRoot,settings,items,statusRegistry,metadataPolicy,lifecyclePatternPolicy,dependencyCycleSeverity,parentCycleSeverity,fileScanMode,initialWarnings:[...new Set(itemReadWarnings)],sourceIncomplete});const fixes=fixesRequested?await buildValidateFixesSummary(options,state,settings,grantedFixScopes,global2,services):void 0;const normalizedWarnings=[...new Set(state.warnings)].sort((left,right)=>left.localeCompare(right));const hasErrors=state.checks.some(check=>check.status==="error");const result={ok:!hasErrors,has_warnings:normalizedWarnings.length>0,checks:state.checks,warnings:normalizedWarnings,...fixes!==void 0?{fixes}:{},generated_at:nowIso(),projection:{mode:"full",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:["diagnostic_rows"]}};if(options.counts!==true)return result;return{...projectValidateCounts(result),projection:{mode:"counts",declared_field_groups:[{name:"diagnostic_rows",restore_with:"--full"}],included_field_groups:[]}}}export{_testOnlyValidateCommand,projectValidateCounts,runValidate};
 //# sourceMappingURL=validate.js.map

package/dist/sdk/governance/workflow-completeness.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @module sdk/governance/workflow-completeness
+ *
+ * Reduces declarative field requirements into bounded, content-free diagnostics.
+ */
+import { type WorkflowPolicyDocument, type WorkflowPolicyDecision } from "../../core/policy/workflow-policy.js";
+import type { ValidateCheck } from "./validate.js";
+/** One item-policy violation, retaining field paths but never field values. */
+export interface WorkflowCompletenessViolation {
+    /** Stable item identifier. */
+    id: string;
+    /** Runtime item type. */
+    type: string;
+    /** Lifecycle status evaluated. */
+    status: string;
+    /** Exact rule and missing-field evidence. */
+    decision: WorkflowPolicyDecision;
+}
+/** Load the policy snapshot while containing storage failures in an error check so other validation can continue. */
+export declare function readWorkflowCompletenessCheck(pmRoot: string, items: Parameters<typeof buildWorkflowCompletenessCheck>[1], rowLimit?: number, sourceIncomplete?: boolean): Promise<{
+    check: ValidateCheck;
+    warnings: string[];
+}>;
+/** Evaluate every supplied item while bounding the diagnostic rows independently. */
+export declare function buildWorkflowCompletenessCheck(document: WorkflowPolicyDocument, items: readonly (Readonly<Record<string, unknown>> & {
+    id: string;
+    type: string;
+    status: string;
+})[], rowLimit?: number, sourceIncomplete?: boolean): {
+    check: ValidateCheck;
+    warnings: string[];
+};

package/dist/sdk/governance/workflow-completeness.js

@@ -0,0 +1,2 @@
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e94b776a-9886-57bc-ba87-06f4a30de578")}catch(e2){}})();import{createWorkflowPolicyEvaluator}from"../../core/policy/workflow-policy.js";import{readWorkflowPolicies}from"../../core/policy/workflow-policy-store.js";async function readWorkflowCompletenessCheck(pmRoot,items,rowLimit,sourceIncomplete){const document=await readWorkflowPolicies(pmRoot).catch(()=>null);if(document===null)return{check:{name:"completeness",status:"error",ok:false,details:{policy_registry_readable:false,policy_registry_path:"schema/policies.json",remediation_hint:"Repair schema/policies.json, then rerun pm validate."}},warnings:["validate_completeness_policy_registry_unreadable"]};return buildWorkflowCompletenessCheck(document,items,rowLimit,sourceIncomplete)}function buildWorkflowCompletenessCheck(document,items,rowLimit=5,sourceIncomplete=false){const violations=[];const byType=new Map;let violationCount=0;let incompleteItems=0;let refused=0;const evaluate=createWorkflowPolicyEvaluator(document);for(const item of items){const evaluation=evaluate({operation:"",author:"",before:item,after:item,completeness_only:true});const missing=evaluation.decisions.filter(decision=>!decision.satisfied);if(missing.length===0)continue;incompleteItems+=1;const bucket=byType.get(item.type)??{items:0,violations:0,missing_fields:0};bucket.items+=1;for(const decision of missing){violationCount+=1;bucket.violations+=1;bucket.missing_fields+=decision.missing_fields.length;if(decision.effect==="refuse")refused+=1;if(violations.length<rowLimit)violations.push({id:item.id,type:item.type,status:item.status,decision})}byType.set(item.type,bucket)}const status=sourceIncomplete||refused>0?"error":violationCount>0?"warn":"ok";return{check:{name:"completeness",status,ok:status==="ok",details:{scope:"operation_independent_require_fields",checked_items:items.length,incomplete_items:incompleteItems,violation_count:violationCount,refused_violations:refused,missing_by_type:Object.fromEntries(byType),violations,violations_truncated:violations.length<violationCount,enforcement:document.enforcement}},warnings:[...violationCount>0?[`validate_completeness_missing_fields:${violationCount}`]:[],...sourceIncomplete?["validate_completeness_source_incomplete"]:[]]}}export{buildWorkflowCompletenessCheck,readWorkflowCompletenessCheck};
+//# sourceMappingURL=workflow-completeness.js.map

package/dist/sdk/governance/workflow-policy.d.ts

@@ -0,0 +1,47 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import { type WorkflowPolicyAction, type WorkflowPolicyDocument, type WorkflowPolicyEvaluation } from "../../core/policy/workflow-policy.js";
+export * from "../../core/policy/workflow-policy.js";
+export * from "../../core/policy/workflow-policy-schema.js";
+export { buildWorkflowCompletenessCheck, type WorkflowCompletenessViolation } from "./workflow-completeness.js";
+export { readWorkflowPolicies } from "../../core/policy/workflow-policy-store.js";
+/** Options shared by SDK, CLI and MCP policy operations. */
+export interface WorkflowPolicyActionOptions {
+    /** One policy definition for put, or proposed field values for check. */
+    definition?: unknown;
+    /** Approval declaration id. */
+    policy?: string;
+    /** Preview without registry, item, or history writes. */
+    dryRun?: boolean;
+    /** Explicit actor override; normally detected automatically. */
+    author?: string;
+    /** Rationale recorded for registry and approval mutations. */
+    message?: string;
+}
+/** Transport-neutral envelope with a discriminant for schema renderers. */
+export interface WorkflowPolicyActionResult {
+    /** Identifies this schema result without conflating type or status operations. */
+    policy_result: true;
+    /** Executed schema verb. */
+    action: WorkflowPolicyAction;
+    /** Whether durable state changed. */
+    changed: boolean;
+    /** Complete bounded result of the selected operation. */
+    result: WorkflowPolicyDocument | WorkflowPolicyEvaluation | WorkflowApprovalReceipt;
+}
+/** Content-bound approval identity returned after its history event is durable. */
+export interface WorkflowApprovalReceipt {
+    /** Reviewed item id. */
+    id: string;
+    /** Approval declaration id. */
+    policy_id: string;
+    /** Exact policy revision. */
+    policy_fingerprint: string;
+    /** Hash of reviewed content. */
+    content_fingerprint: string;
+    /** Advisory mutation diagnostics. */
+    warnings: string[];
+}
+/** Advisory defaults are opt-in data, never implicitly applied to existing projects. */
+export declare function createLifecycleCompletenessPolicies(): WorkflowPolicyDocument;
+/** Execute policy operations on every transport; policy-mode uses name as advise|refuse, validated by the registry parser. */
+export declare function runWorkflowPolicyAction(action: WorkflowPolicyAction, name: string | undefined, options?: WorkflowPolicyActionOptions, global?: Pick<GlobalOptions, "path">): Promise<WorkflowPolicyActionResult>;

package/dist/sdk/governance/workflow-policy.js

@@ -0,0 +1,4 @@
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e60a4620-c210-5d5e-baf4-d96467406cf4")}catch(e2){}})();import path from"node:path";import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{resolveAuthor}from"../../core/shared/author.js";import{PmCliError}from"../../core/shared/errors.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{mutateWorkspaceJsonWithHistory}from"../../core/history/workspace-history.js";import{locateItem,readLocatedItem,mutateItemWithHistoryContextResolver}from"../../core/store/item-store.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{decodeWorkflowPolicyDocument,readWorkflowPolicies,readWorkflowApprovals,evaluateWorkspacePolicies,MAX_WORKFLOW_POLICY_BYTES}from"../../core/policy/workflow-policy-store.js";import{WORKFLOW_POLICY_ACTIONS,parseWorkflowPolicy,parseWorkflowPolicyDocument,workflowPolicyFingerprint,workflowApprovalFingerprint}from"../../core/policy/workflow-policy.js";export*from"../../core/policy/workflow-policy.js";export*from"../../core/policy/workflow-policy-schema.js";import{buildWorkflowCompletenessCheck}from"./workflow-completeness.js";import{readWorkflowPolicies as readWorkflowPolicies2}from"../../core/policy/workflow-policy-store.js";function createLifecycleCompletenessPolicies(){const requiredByType=[["Epic",["goal","objective","body"]],["Story",["description","value","acceptance_criteria"]],["Decision",["body","resolution"]],["Feature",["acceptance_criteria","expected_result"]],["Task",["description"]],["Issue",["repro_steps","expected_result"]],["Chore",["description"]]];return{version:1,enforcement:"advise",policies:[...requiredByType.map(([type,fields])=>({id:`completeness-${type.toLowerCase()}`,effect:"advise",description:`Evidence expected when ${type} work reaches completion.`,subject:{types:[type],statuses:["closed"]},rule:{kind:"require_fields",fields:[...fields]}})),{id:"completeness-resolution",effect:"advise",subject:{statuses:["closed"]},rule:{kind:"require_fields",fields:["resolution","expected_result","actual_result"]}}]}}function policyInputObject(value){let parsed=value;if(typeof value==="string"){try{parsed=JSON.parse(value)}catch{throw new PmCliError("Policy definition must be valid JSON.",EXIT_CODE.USAGE)}}if(typeof parsed!=="object"||parsed===null||Array.isArray(parsed))throw new PmCliError("Policy definition must be an object.",EXIT_CODE.USAGE);return parsed}async function policyContext(global2,author){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);return{pmRoot,settings,author:resolveAuthor(author,settings.author_default)}}function changedPolicyDocument(action,name,before,options){if(action==="policy-mode")return parseWorkflowPolicyDocument({...before,enforcement:name});const remaining=before.policies.filter(policy2=>policy2.id!==name);if(action==="policy-remove")return{...before,policies:remaining};const policy=parseWorkflowPolicy(policyInputObject(options.definition));if(policy.id!==name)throw new PmCliError("Policy definition id must match its operand.",EXIT_CODE.USAGE);const next=parseWorkflowPolicyDocument({...before,policies:[...remaining,policy].sort((left,right)=>left.id.localeCompare(right.id))});if(Buffer.byteLength(`${JSON.stringify(next,null,2)}
+`)>MAX_WORKFLOW_POLICY_BYTES)throw new PmCliError("Policy registry exceeds its byte ceiling.",EXIT_CODE.USAGE);return next}async function mutatePolicyRegistry(action,name,options,context){if(options.dryRun)return{policy_result:true,action,changed:false,result:changedPolicyDocument(action,name,await readWorkflowPolicies(context.pmRoot),options)};const mutation=await mutateWorkspaceJsonWithHistory({pmRoot:context.pmRoot,filePath:path.join(context.pmRoot,"schema","policies.json"),op:`schema:${action}`,author:context.author,message:options.message,lockTtlSeconds:context.settings.locks.ttl_seconds,lockWaitMs:context.settings.locks.wait_ms,mutate(beforeRaw){const next=changedPolicyDocument(action,name,decodeWorkflowPolicyDocument(beforeRaw),options);const raw=`${JSON.stringify(next,null,2)}
+`;return{raw,result:next}}});return{policy_result:true,action,changed:mutation.changed,result:mutation.result}}async function approvePolicy(name,options,context){let evidence;const mutation=await mutateItemWithHistoryContextResolver({...context,id:name,op:"policy_approve",message:options.message,resolveHistoryContext:()=>({workflow_approval:evidence}),async mutate(document){const registry=await readWorkflowPolicies(context.pmRoot);const policy=registry.policies.find(candidate=>candidate.id===options.policy);if(!policy||policy.rule.kind!=="approval")throw new PmCliError("--policy must name an approval rule.",EXIT_CODE.USAGE);if(!policy.rule.authors.includes(context.author))throw new PmCliError("This actor is not a declared approver.",EXIT_CODE.CONFLICT);await readWorkflowApprovals(context.pmRoot,document.metadata.id);evidence={policy_id:policy.id,policy_fingerprint:workflowPolicyFingerprint(policy),content_fingerprint:workflowApprovalFingerprint(policy,{...document.metadata,body:document.body})};return{changedFields:[]}}});return{policy_result:true,action:"policy-approve",changed:true,result:{id:mutation.item.id,...evidence,warnings:mutation.warnings}}}async function runWorkflowPolicyAction(action,name,options={},global2={}){if(!WORKFLOW_POLICY_ACTIONS.includes(action))throw new PmCliError("Unknown workflow policy action.",EXIT_CODE.USAGE);if(action==="policy-presets")return{policy_result:true,action,changed:false,result:createLifecycleCompletenessPolicies()};const context=await policyContext(global2,options.author);if(action==="policies")return{policy_result:true,action,changed:false,result:await readWorkflowPolicies(context.pmRoot)};if(!name?.trim())throw new PmCliError(`schema ${action} requires an operand.`,EXIT_CODE.USAGE);if(["policy-put","policy-remove","policy-mode"].includes(action))return mutatePolicyRegistry(action,name,options,context);if(action==="policy-approve"){if(options.dryRun)throw new PmCliError("Use policy-check to preview; policy-approve records an approval.",EXIT_CODE.USAGE);return approvePolicy(name,options,context)}const types=resolveItemTypeRegistry(context.settings,getActiveExtensionRegistrations());const located=await locateItem(context.pmRoot,name,context.settings.id_prefix,context.settings.item_format,types.type_to_folder);if(!located)throw new PmCliError(`Item ${name} not found.`,EXIT_CODE.NOT_FOUND);const{document}=await readLocatedItem(located,{schema:context.settings.schema});const before={...document.metadata,body:document.body};const after=options.definition===void 0?before:{...before,...policyInputObject(options.definition)};if(after.id!==before.id)throw new PmCliError("Policy preview cannot change the item id.",EXIT_CODE.USAGE);return{policy_result:true,action,changed:false,result:await evaluateWorkspacePolicies(context.pmRoot,await readWorkflowPolicies(context.pmRoot),{operation:"update",author:context.author,before,after,completeness_only:options.definition===void 0})}}export{buildWorkflowCompletenessCheck,createLifecycleCompletenessPolicies,readWorkflowPolicies2 as readWorkflowPolicies,runWorkflowPolicyAction};
+//# sourceMappingURL=workflow-policy.js.map

package/dist/sdk/governance.d.ts

@@ -19,6 +19,7 @@ export * from "./governance/stale-work.js";
 export * from "./governance/storage-integrity.js";
 export * from "./governance/status-role-diagnostics.js";
 export * from "./governance/workspace-position.js";
+export * from "./governance/workflow-policy.js";
 export { runUpgrade, type UpgradeCliResult, type UpgradeCommandOptions, type UpgradeCommandRunner, type UpgradeCommandRunnerResult, type UpgradePackageResult, type UpgradeResult, } from "./governance/upgrade.js";
 export * from "./governance/validate.js";
 export * from "./governance/linked-file-report.js";

package/dist/sdk/governance.js

@@ -1,2 +1,2 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="067c057c-811b-5708-bbad-bb5c06fe06b1")}catch(e2){}})();export*from"./governance/gc.js";export*from"./governance/health.js";export*from"./governance/extension-host-version.js";export*from"./governance/assurance.js";export*from"./governance/assurance-action.js";export*from"./governance/assurance-mutation-error.js";export*from"./governance/assurance-presets.js";export*from"./governance/assurance-runtime.js";export*from"./governance/boundary-fixtures.js";export*from"./governance/defect-recurrence.js";export*from"./governance/defect-recurrence-coverage.js";import{runReindex}from"./governance/reindex.js";export*from"./governance/stale-work.js";export*from"./governance/storage-integrity.js";export*from"./governance/status-role-diagnostics.js";export*from"./governance/workspace-position.js";import{runUpgrade}from"./governance/upgrade.js";export*from"./governance/validate.js";export*from"./governance/linked-file-report.js";export*from"./author-attribution.js";export*from"./mutation-guard.js";export*from"./governance/provenance-health.js";export*from"./similarity.js";export*from"./history/maintenance.js";export{runReindex,runUpgrade};
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="db5452b6-8d36-5425-a033-1d36757ce96e")}catch(e2){}})();export*from"./governance/gc.js";export*from"./governance/health.js";export*from"./governance/extension-host-version.js";export*from"./governance/assurance.js";export*from"./governance/assurance-action.js";export*from"./governance/assurance-mutation-error.js";export*from"./governance/assurance-presets.js";export*from"./governance/assurance-runtime.js";export*from"./governance/boundary-fixtures.js";export*from"./governance/defect-recurrence.js";export*from"./governance/defect-recurrence-coverage.js";import{runReindex}from"./governance/reindex.js";export*from"./governance/stale-work.js";export*from"./governance/storage-integrity.js";export*from"./governance/status-role-diagnostics.js";export*from"./governance/workspace-position.js";export*from"./governance/workflow-policy.js";import{runUpgrade}from"./governance/upgrade.js";export*from"./governance/validate.js";export*from"./governance/linked-file-report.js";export*from"./author-attribution.js";export*from"./mutation-guard.js";export*from"./governance/provenance-health.js";export*from"./similarity.js";export*from"./history/maintenance.js";export{runReindex,runUpgrade};
 //# sourceMappingURL=governance.js.map

package/dist/sdk/index.d.ts

@@ -26,7 +26,7 @@ export { PM_REPRODUCIBLE_PROCESS_ENV, createReproducibleProcessRunner, resolveRe
 export { PM_WORKSPACE_RECIPE_SCHEMA, defineWorkspaceRecipe, executeWorkspaceRecipe, runWithWorkspaceRecipe, type WorkspaceRecipe, type WorkspaceRecipeJsonValue, type WorkspaceRecipeOperation, } from "./workspace-recipe.js";
 export { SNAPSHOT_SCHEMA, WORKSPACE_SNAPSHOT_ACTIONS, createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshot, restoreWorkspaceSnapshotWithRecovery, type CreateWorkspaceSnapshotResult, type RestoreWorkspaceSnapshotOptions, type RestoreWorkspaceSnapshotResult, type WorkspaceSnapshotHistoryImpact, type WorkspaceSnapshotManifest, type WorkspaceSnapshotReference, type WorkspaceSnapshotRestorePlan, } from "./workspace-snapshot.js";
 export { flushTelemetryQueue } from "./telemetry-flush.js";
-export { PM_HISTORY_COMMAND_ALIASES, resolvePmHistoryOperation } from "./cli-contracts.js";
+export { PM_HISTORY_COMMAND_ALIASES, PM_CONTEXT_OPS_COMMAND_ALIASES, PM_BULK_LIFECYCLE_COMMAND_ALIASES, PM_RELOCATED_COMMAND_ALIASES, PM_NAMESPACED_COMMAND_ALIASES, resolvePmCommandOperation, resolvePmHistoryOperation } from "./cli-contracts.js";
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration, applyBootstrapPagerPolicy, coalesceRepeatedListFlags, listAliasPluralKeys, mergeLinkedTestTwoTokenEntries, normalizeBootstrapInvocation, normalizeLegacyExtensionActionSyntax, parseBootstrapCommandName, parseBootstrapGlobalOptions, parseBootstrapHelpRequest, parseBootstrapTypeValue, stripGlobalBootstrapTokens, type BootstrapGlobalOptions, type BootstrapHelpRequest, type BootstrapInvocationNormalizationResult, type BootstrapNormalizationEvent, } from "./cli-bootstrap.js";
 export { quoteCommandArg, quoteWindowsCommandArg, renderPmCommand, } from "./command-line.js";
 export * from "./agent/command-recovery.js";
@@ -109,7 +109,6 @@ export * from "./history/maintenance.js";
 export { readHistorySnapshot, type HistoryStreamSnapshot } from "../core/history/read.js";
 export * from "./history-provenance.js";
 export * from "./mutation-events.js";
-export { appendWorkspaceAuditEvent, appendWorkspaceHistoryChange, getWorkspaceHistoryPath, inspectWorkspaceHistoryState, mutateWorkspaceJsonWithHistory, reconcileWorkspaceJsonHistory, restoreWorkspaceJsonFromHistory, WORKSPACE_HISTORY_ID, writeWorkspaceJsonWithHistory, type WorkspaceAuditEventOptions, type WorkspaceHistoryChange, type WorkspaceHistoryStateAgreement, type WorkspaceJsonMutation, type WorkspaceJsonMutationOptions, type WorkspaceJsonReconciliationOptions, type WorkspaceJsonRestoreOptions, type WorkspaceJsonRestoreResult, type WorkspaceJsonWriteOptions, } from "../core/history/workspace-history.js";
 export * from "./history-redact.js";
 export { _testOnly } from "./history-redact.js";
 export * from "./history-repair.js";
@@ -162,6 +161,7 @@ export { runCreate } from "./lifecycle/create.js";
 export { runPlan } from "./lifecycle/plan.js";
 export { runAppend } from "./lifecycle/append.js";
 export { isAlreadyClaimedError, runClaim, runClaimNext, runRelease, } from "./lifecycle/claim.js";
+export { runStartTask, runPauseTask, runCloseTask, type TaskCompositionOptions } from "./lifecycle/task-composition.js";
 export { runCloseMany } from "./lifecycle/close-many.js";
 export { runUpdateMany } from "./lifecycle/update-many.js";
 export { runComments } from "./comments.js";