@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/governance/validate.d.ts

@@ -1,13 +1,13 @@
 import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
 import type { GlobalOptions } from "../../core/shared/command-types.js";
-import { type CloseReasonBackfillRow, type EstimateBackfillRow, type StaleLinkPruneRow, type TerminalParentFixRow, type ValidateFixRecord } from "../../core/validate/fix-planning.js";
+import { type CloseReasonBackfillRow,type EstimateBackfillRow,type StaleLinkPruneRow,type TerminalParentFixRow,type ValidateFixRecord } from "../../core/validate/fix-planning.js";
 import { type DuplicateIssueCode } from "../../core/governance/issue-codes.js";
 import { type MissingFieldOccurrence } from "../../core/validate/missing-by-type.js";
-import type { ValidateMetadataProfile, ValidateMetadataRequiredField } from "../../types/index.js";
+import type { ValidateMetadataProfile,ValidateMetadataRequiredField } from "../../types/index.js";
 import { type OutputProjectionDeclaration } from "../output-projection.js";
 import { type RelationshipKindRegistry } from "../relationships.js";
 import { type ValidateItem } from "./validate-item-reader.js";
-import { buildLifecycleParentGraph, detectLifecycleParentCycles, resolveLifecycleDependencyCycleSamplePath } from "./hierarchy-validation.js";
+import { buildLifecycleParentGraph,detectLifecycleParentCycles,resolveLifecycleDependencyCycleSamplePath } from "./hierarchy-validation.js";
 import { toMeaningfulString } from "./validate-normalization.js";
 type ValidateCheckName = "completeness" | "metadata" | "resolution" | "lifecycle" | "dependency_references" | "files" | "command_references" | "history_drift" | "format_version" | "storage_integrity";
 type ValidateStatus = "ok" | "warn" | "error";
@@ -19,135 +19,135 @@ type LifecyclePatternFieldKey = "blocked_reason" | "resolution" | "actual_result
 /** Documents the validate command options payload exchanged by command, SDK, and package integrations. */
 export interface ValidateCommandOptions {
 /** Evaluate workspace field requirements for each item's current lifecycle status. */
-checkCompleteness?: boolean;
+checkCompleteness?:boolean;
 /** Value that configures or reports check metadata for this contract. */
-checkMetadata?: boolean;
+checkMetadata?:boolean;
 /** Value that configures or reports check resolution for this contract. */
-checkResolution?: boolean;
+checkResolution?:boolean;
 /** Value that configures or reports check lifecycle for this contract. */
-checkLifecycle?: boolean;
+checkLifecycle?:boolean;
 /** Value that configures or reports check stale blockers for this contract. */
-checkStaleBlockers?: boolean;
+checkStaleBlockers?:boolean;
 /** Value that configures or reports dependency cycle severity for this contract. */
-dependencyCycleSeverity?: string;
+dependencyCycleSeverity?:string;
 /** Value that configures or reports parent cycle severity for this contract. */
-parentCycleSeverity?: string;
+parentCycleSeverity?:string;
 /** Value that configures or reports check files for this contract. */
-checkFiles?: boolean;
+checkFiles?:boolean;
 /** Value that configures or reports include pm internals for this contract. */
-includePmInternals?: boolean;
+includePmInternals?:boolean;
 /** Value that configures or reports verbose file lists for this contract. */
-verboseFileLists?: boolean;
+verboseFileLists?:boolean;
 /** Value that configures or reports verbose diagnostics for this contract. */
-verboseDiagnostics?: boolean;
+verboseDiagnostics?:boolean;
 /** Emit complete *_item_ids diagnostic lists (no 5-item cap); implied by --json. */
-allAffectedIds?: boolean;
+allAffectedIds?:boolean;
 /** Value that configures or reports check history drift for this contract. */
-checkHistoryDrift?: boolean;
+checkHistoryDrift?:boolean;
 /** Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected items, unparseable config). */
-checkStorageIntegrity?: boolean;
+checkStorageIntegrity?:boolean;
 /** Value that configures or reports check command references for this contract. */
-checkCommandReferences?: boolean;
+checkCommandReferences?:boolean;
 /** Strategy used to control scan behavior. */
-scanMode?: string;
+scanMode?:string;
 /** Value that configures or reports metadata profile for this contract. */
-metadataProfile?: string;
+metadataProfile?:string;
 /** Value that configures or reports fix hints for this contract. */
-fixHints?: boolean;
+fixHints?:boolean;
 /** Value that configures or reports auto fix for this contract. */
-autoFix?: boolean;
+autoFix?:boolean;
 /** Value that configures or reports dry run for this contract. */
-dryRun?: boolean;
+dryRun?:boolean;
 /** Value that configures or reports fix scope for this contract. */
-fixScope?: string[];
+fixScope?:string[];
 /** Value that configures or reports prune missing for this contract. */
-pruneMissing?: boolean;
+pruneMissing?:boolean;
 /** Keep validation counts and scalar totals while omitting diagnostic row arrays. */
-counts?: boolean;
+counts?:boolean;
 /** Explicitly restore complete diagnostic rows after a counts-only read. */
-full?: boolean;
+full?:boolean;
 }
 /** Mutation operations injected when validation is allowed to apply audited fixes. */
 export interface ValidateMutationServices {
 /** Apply one update through the host's canonical audited mutation path. */
-runUpdate?: (id: string, options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
+runUpdate?:(id:string,options:Record<string,unknown>,global:GlobalOptions) => Promise<unknown>;
 }
 /** Documents the validate check payload exchanged by command, SDK, and package integrations. */
 export interface ValidateCheck {
 /** Value that configures or reports name for this contract. */
-name: ValidateCheckName;
+name:ValidateCheckName;
 /** Lifecycle state reported for status. */
-status: ValidateStatus;
+status:ValidateStatus;
 /** Direct machine predicate derived from whether status is ok. */
-ok: boolean;
+ok:boolean;
 /** Value that configures or reports details for this contract. */
-details: Record<string, unknown>;
+details:Record<string,unknown>;
 }
 /** Documents the validate fixes summary payload exchanged by command, SDK, and package integrations. */
 export interface ValidateFixesSummary {
 /** Value that configures or reports mode for this contract. */
-mode: "apply" | "dry_run";
+mode:"apply" | "dry_run";
 /** Value that configures or reports auto fix for this contract. */
-auto_fix: boolean;
+auto_fix:boolean;
 /** Value that configures or reports prune missing for this contract. */
-prune_missing: boolean;
+prune_missing:boolean;
 /** Value that configures or reports granted fix scopes for this contract. */
-granted_fix_scopes: string[];
+granted_fix_scopes:string[];
 /** Number of planned entries represented by this result. */
-planned_count: number;
+planned_count:number;
 /** Number of applied entries represented by this result. */
-applied_count: number;
+applied_count:number;
 /** Number of gated entries represented by this result. */
-gated_count: number;
+gated_count:number;
 /** Number of failed entries represented by this result. */
-failed_count: number;
+failed_count:number;
 /** Value that configures or reports planned fixes for this contract. */
-planned_fixes: Array<Record<string, unknown>>;
+planned_fixes:Array<Record<string,unknown>>;
 /** Value that configures or reports applied fixes for this contract. */
-applied_fixes: Array<Record<string, unknown>>;
+applied_fixes:Array<Record<string,unknown>>;
 /** Value that configures or reports gated fixes for this contract. */
-gated_fixes: Array<Record<string, unknown>>;
+gated_fixes:Array<Record<string,unknown>>;
 /** Value that configures or reports failed fixes for this contract. */
-failed_fixes: Array<Record<string, unknown>>;
+failed_fixes:Array<Record<string,unknown>>;
 }
 /** Counts-only fix summary emitted when validate diagnostics omit row arrays. */
 export interface ValidateCountsFixesSummary {
 /** Whether fixes were applied or only previewed. */
-mode: "apply" | "dry_run";
+mode:"apply" | "dry_run";
 /** Whether safe automatic fixes were requested. */
-auto_fix: boolean;
+auto_fix:boolean;
 /** Whether missing linked paths were eligible for pruning. */
-prune_missing: boolean;
+prune_missing:boolean;
 /** Number of planned entries represented by this result. */
-planned_count: number;
+planned_count:number;
 /** Number of applied entries represented by this result. */
-applied_count: number;
+applied_count:number;
 /** Number of gated entries represented by this result. */
-gated_count: number;
+gated_count:number;
 /** Number of failed entries represented by this result. */
-failed_count: number;
+failed_count:number;
 }
 /** Documents the validate result payload exchanged by command, SDK, and package integrations. */
 export interface ValidateResult {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Whether warnings applies to this operation. */
-has_warnings: boolean;
+has_warnings:boolean;
 /** Value that configures or reports checks for this contract. */
-checks: ValidateCheck[];
+checks:ValidateCheck[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Present when --auto-fix or --prune-missing was requested; checks always reflect the PRE-fix state. */
-fixes?: ValidateFixesSummary;
+fixes?:ValidateFixesSummary;
 /** ISO 8601 timestamp recording when generated occurred. */
-generated_at: string;
+generated_at:string;
 /** Self-describing diagnostic projection used to derive a bounded omission receipt. */
-projection: OutputProjectionDeclaration;
+projection:OutputProjectionDeclaration;
 }
 /** Validate result returned when `counts: true` omits diagnostic row arrays. */
-export interface ValidateCountsResult extends Omit<ValidateResult, "fixes"> {
+export interface ValidateCountsResult extends Omit<ValidateResult,"fixes"> {
 /** Scalar-only remediation totals, present when remediation was requested. */
-fixes?: ValidateCountsFixesSummary;
+fixes?:ValidateCountsFixesSummary;
 }
 /**
  * Build the counts-only validate projection without mutating the full result.
@@ -157,145 +157,145 @@ fixes?: ValidateCountsFixesSummary;
  * markers are omitted; this sparse convention does not suppress other false or
  * zero values, and the projection receipt still declares omitted diagnostic rows.
  */
-export declare function projectValidateCounts(result: ValidateResult): ValidateCountsResult;
+export declare function projectValidateCounts(result:ValidateResult):ValidateCountsResult;
 interface ValidateMetadataPolicy {
-profile: ValidateMetadataProfile;
-profile_source: "default" | "settings" | "option";
-required_fields: ValidateMetadataRequiredField[];
-configured_custom_fields: ValidateMetadataRequiredField[];
-fallback_to_core: boolean;
-warnings: string[];
+profile:ValidateMetadataProfile;
+profile_source:"default" | "settings" | "option";
+required_fields:ValidateMetadataRequiredField[];
+configured_custom_fields:ValidateMetadataRequiredField[];
+fallback_to_core:boolean;
+warnings:string[];
 }
 type LifecyclePatternSource = "default" | "settings";
 interface LifecyclePatternPolicy {
-stale_blocker_reason_patterns: string[];
-stale_blocker_reason_pattern_source: LifecyclePatternSource;
-closure_like_metadata_field_patterns: Record<LifecyclePatternFieldKey, string[]>;
-closure_like_metadata_field_pattern_sources: Record<LifecyclePatternFieldKey, LifecyclePatternSource>;
+stale_blocker_reason_patterns:string[];
+stale_blocker_reason_pattern_source:LifecyclePatternSource;
+closure_like_metadata_field_patterns:Record<LifecyclePatternFieldKey,string[]>;
+closure_like_metadata_field_pattern_sources:Record<LifecyclePatternFieldKey,LifecyclePatternSource>;
 }
-declare function resolveValidateMetadataProfile(value: string | undefined): ValidateMetadataProfile;
-declare function resolveDependencyCycleSeverity(value: string | undefined): ValidateDependencyCycleSeverity;
-declare function resolveParentCycleSeverity(value: string | undefined): ValidateDependencyCycleSeverity;
-declare function isMetadataFieldMissing(item: ItemWithBody, field: ValidateMetadataRequiredField, statusRegistry: RuntimeStatusRegistry, enforcePlanningFieldsOnTerminal: boolean): boolean;
-declare function resolveFileScanMode(scanMode: string | undefined): ValidateFileScanMode;
-declare function resolveWorkspaceRoot(pmRoot: string): string;
-declare function listFilesRecursive(basePath: string, relativePath: string, output: string[]): Promise<void>;
-declare function collectDefaultProjectFileCandidates(workspaceRoot: string): Promise<string[]>;
-declare function collectTrackedGitFileCandidates(workspaceRoot: string): Promise<string[] | null>;
+declare function resolveValidateMetadataProfile(value:string | undefined):ValidateMetadataProfile;
+declare function resolveDependencyCycleSeverity(value:string | undefined):ValidateDependencyCycleSeverity;
+declare function resolveParentCycleSeverity(value:string | undefined):ValidateDependencyCycleSeverity;
+declare function isMetadataFieldMissing(item:ItemWithBody,field:ValidateMetadataRequiredField,statusRegistry:RuntimeStatusRegistry,enforcePlanningFieldsOnTerminal:boolean):boolean;
+declare function resolveFileScanMode(scanMode:string | undefined):ValidateFileScanMode;
+declare function resolveWorkspaceRoot(pmRoot:string):string;
+declare function listFilesRecursive(basePath:string,relativePath:string,output:string[]):Promise<void>;
+declare function collectDefaultProjectFileCandidates(workspaceRoot:string):Promise<string[]>;
+declare function collectTrackedGitFileCandidates(workspaceRoot:string):Promise<string[] | null>;
 /** Attach a uniform, machine-executable `fix_hints` array to a validate check's details when `--fix-hints` is requested. The resolution check's existing per-row remediation commands (which already carry concrete item ids) are aliased in so agents read one uniform field across every check; all other checks derive one generic command per distinct warning code from the shared remediation registry. Generic hints may contain `<id>`/`<field>`/`<path>` placeholders the caller substitutes before running — they are templates, not always directly executable as-is. Read-only: this only enriches the diagnostic output, never mutates any item. */
-declare function attachValidateFixHints(check: ValidateCheck, checkWarnings: string[]): void;
-declare function resolveRequestedChecks(options: ValidateCommandOptions): Set<ValidateCheckName>;
+declare function attachValidateFixHints(check:ValidateCheck,checkWarnings:string[]):void;
+declare function resolveRequestedChecks(options:ValidateCommandOptions):Set<ValidateCheckName>;
 /** Project the duplicate logical issue-code findings (GH-235) into the metadata-check `details` shape plus an advisory warning token. Duplicate codes are advisory (warn), never an error — matching every other metadata finding — so an otherwise clean tracker that simply reuses a title prefix is not failed by `pm validate`. Kept outside the c8-ignored builder block so the projection/remediation logic is fully covered by unit tests. */
-declare function summarizeDuplicateIssueCodes(duplicates: DuplicateIssueCode[], verboseDiagnostics: boolean): {
-rows: Array<Record<string, unknown>>;
-truncated: boolean;
-warnings: string[];
+declare function summarizeDuplicateIssueCodes(duplicates:DuplicateIssueCode[],verboseDiagnostics:boolean):{
+rows:Array<Record<string,unknown>>;
+truncated:boolean;
+warnings:string[];
 };
-declare function buildMetadataCounts(metadataPolicy: ValidateMetadataPolicy, missingByField: Record<ValidateMetadataRequiredField, string[]>): Record<string, number>;
-declare function buildMissingFieldOccurrences(metadataPolicy: ValidateMetadataPolicy, missingByField: Record<ValidateMetadataRequiredField, string[]>, itemsById: Map<string, ItemWithBody>): MissingFieldOccurrence[];
-declare function buildCloseReasonBackfillRows(metadataPolicy: ValidateMetadataPolicy, missingByField: Record<ValidateMetadataRequiredField, string[]>, itemsById: Map<string, ItemWithBody>): CloseReasonBackfillRow[];
-declare function buildEstimateBackfillRows(metadataPolicy: ValidateMetadataPolicy, missingByField: Record<ValidateMetadataRequiredField, string[]>, itemsById: Map<string, ItemWithBody>): EstimateBackfillRow[];
-declare function escapeRegExp(value: string): string;
-declare function buildLifecycleDependencyGraph(activeItems: ItemWithBody[], idPrefix?: string, relationshipRegistry?: RelationshipKindRegistry): Map<string, string[]>;
-declare function buildDependencyReferencesCheck(items: ItemWithBody[], verboseDiagnostics: boolean, statusRegistry?: RuntimeStatusRegistry): {
-check: ValidateCheck;
-warnings: string[];
+declare function buildMetadataCounts(metadataPolicy:ValidateMetadataPolicy,missingByField:Record<ValidateMetadataRequiredField,string[]>):Record<string,number>;
+declare function buildMissingFieldOccurrences(metadataPolicy:ValidateMetadataPolicy,missingByField:Record<ValidateMetadataRequiredField,string[]>,itemsById:Map<string,ItemWithBody>):MissingFieldOccurrence[];
+declare function buildCloseReasonBackfillRows(metadataPolicy:ValidateMetadataPolicy,missingByField:Record<ValidateMetadataRequiredField,string[]>,itemsById:Map<string,ItemWithBody>):CloseReasonBackfillRow[];
+declare function buildEstimateBackfillRows(metadataPolicy:ValidateMetadataPolicy,missingByField:Record<ValidateMetadataRequiredField,string[]>,itemsById:Map<string,ItemWithBody>):EstimateBackfillRow[];
+declare function escapeRegExp(value:string):string;
+declare function buildLifecycleDependencyGraph(activeItems:ItemWithBody[],idPrefix?:string,relationshipRegistry?:RelationshipKindRegistry):Map<string,string[]>;
+declare function buildDependencyReferencesCheck(items:ItemWithBody[],verboseDiagnostics:boolean,statusRegistry?:RuntimeStatusRegistry):{
+check:ValidateCheck;
+warnings:string[];
 };
-declare function extractItemIds(value: string, idPrefix?: string): string[];
-declare function findLifecycleDependencyCycleComponents(graph: Map<string, string[]>): string[][];
-declare function detectLifecycleDependencyCycles(activeItems: ItemWithBody[], idPrefix?: string): {
-cycle_count: number;
-cycle_item_ids: string[];
-cycle_sample_paths: string[];
+declare function extractItemIds(value:string,idPrefix?:string):string[];
+declare function findLifecycleDependencyCycleComponents(graph:Map<string,string[]>):string[][];
+declare function detectLifecycleDependencyCycles(activeItems:ItemWithBody[],idPrefix?:string):{
+cycle_count:number;
+cycle_item_ids:string[];
+cycle_sample_paths:string[];
 };
 interface OrphanedPathRow {
-path: string;
-classification: OrphanedPathClassification;
-owner_candidate: {
-id: string;
-type: string;
-title: string;
-status: string;
-confidence: "path_prefix" | "same_directory" | "shared_directory";
+path:string;
+classification:OrphanedPathClassification;
+owner_candidate:{
+id:string;
+type:string;
+title:string;
+status:string;
+confidence:"path_prefix" | "same_directory" | "shared_directory";
 } | null;
-remediation_hint: string;
+remediation_hint:string;
 }
-declare function classifyOrphanedPath(pathValue: string): OrphanedPathClassification;
-declare function sharedDirectoryPrefixLength(left: string, right: string): number;
-declare function buildOrphanedPathRows(orphanedFiles: readonly string[], items: readonly ItemWithBody[]): OrphanedPathRow[];
-declare function summarizeOrphanedPathRows(rows: readonly OrphanedPathRow[]): string[];
-declare function linkedArtifactPathExceedsFilesystemLimits(artifactPath: string): boolean;
-declare function buildLifecycleCheck(items: ItemWithBody[], includeStaleBlockers: boolean, dependencyCycleSeverity: ValidateDependencyCycleSeverity, parentCycleSeverity: ValidateDependencyCycleSeverity, statusRegistry: RuntimeStatusRegistry, lifecyclePatternPolicy: LifecyclePatternPolicy, verboseDiagnostics: boolean, idPrefix?: string): {
-check: ValidateCheck;
-warnings: string[];
-terminalParentFixRows: TerminalParentFixRow[];
+declare function classifyOrphanedPath(pathValue:string):OrphanedPathClassification;
+declare function sharedDirectoryPrefixLength(left:string,right:string):number;
+declare function buildOrphanedPathRows(orphanedFiles:readonly string[],items:readonly ItemWithBody[]):OrphanedPathRow[];
+declare function summarizeOrphanedPathRows(rows:readonly OrphanedPathRow[]):string[];
+declare function linkedArtifactPathExceedsFilesystemLimits(artifactPath:string):boolean;
+declare function buildLifecycleCheck(items:ItemWithBody[],includeStaleBlockers:boolean,dependencyCycleSeverity:ValidateDependencyCycleSeverity,parentCycleSeverity:ValidateDependencyCycleSeverity,statusRegistry:RuntimeStatusRegistry,lifecyclePatternPolicy:LifecyclePatternPolicy,verboseDiagnostics:boolean,idPrefix?:string):{
+check:ValidateCheck;
+warnings:string[];
+terminalParentFixRows:TerminalParentFixRow[];
 };
 /** Join live filesystem evidence with holder lifecycle, retaining historical rows while warning only on active missing links. */
-declare function buildFilesCheck(items: ItemWithBody[], workspaceRoot: string, pmRoot: string, fileScanMode: ValidateFileScanMode, includePmInternals: boolean, verboseFileLists: boolean, statusRegistry?: RuntimeStatusRegistry): Promise<{
-check: ValidateCheck;
-warnings: string[];
-staleLinkPruneRows: StaleLinkPruneRow[];
+declare function buildFilesCheck(items:ItemWithBody[],workspaceRoot:string,pmRoot:string,fileScanMode:ValidateFileScanMode,includePmInternals:boolean,verboseFileLists:boolean,statusRegistry?:RuntimeStatusRegistry):Promise<{
+check:ValidateCheck;
+warnings:string[];
+staleLinkPruneRows:StaleLinkPruneRow[];
 }>;
-declare function buildCommandReferencesCheck(items: ItemWithBody[], idPrefix: string, verboseDiagnostics: boolean, pmRoot: string): Promise<{
-check: ValidateCheck;
-warnings: string[];
+declare function buildCommandReferencesCheck(items:ItemWithBody[],idPrefix:string,verboseDiagnostics:boolean,pmRoot:string):Promise<{
+check:ValidateCheck;
+warnings:string[];
 }>;
 /** Apply one planned fix through the SAME audited command paths an operator would use by hand (`pm update` / `pm files --remove` / `pm docs --remove`), so every applied fix carries normal history, locking, and hook behavior. Command modules are imported lazily: plain validate runs stay read-only and never pay the mutation-stack import cost. */
-declare function applyValidateFix(fix: ValidateFixRecord, global: GlobalOptions, services: ValidateMutationServices): Promise<void>;
-declare function applyValidateFixes(applicable: ValidateFixRecord[], global: GlobalOptions, services: ValidateMutationServices): Promise<{
-applied: ValidateFixRecord[];
-failed: Array<{
-fix: ValidateFixRecord;
-error: unknown;
+declare function applyValidateFix(fix:ValidateFixRecord,global:GlobalOptions,services:ValidateMutationServices):Promise<void>;
+declare function applyValidateFixes(applicable:ValidateFixRecord[],global:GlobalOptions,services:ValidateMutationServices):Promise<{
+applied:ValidateFixRecord[];
+failed:Array<{
+fix:ValidateFixRecord;
+error:unknown;
 }>;
 }>;
 /** Public contract for test only validate command, shared by SDK and presentation-layer consumers. */
-export declare const _testOnlyValidateCommand: {
-applyValidateFix: typeof applyValidateFix;
-applyValidateFixes: typeof applyValidateFixes;
-attachValidateFixHints: typeof attachValidateFixHints;
-buildCommandReferencesCheck: typeof buildCommandReferencesCheck;
-buildDependencyReferencesCheck: typeof buildDependencyReferencesCheck;
-buildCloseReasonBackfillRows: typeof buildCloseReasonBackfillRows;
-buildFilesCheck: typeof buildFilesCheck;
-buildLifecycleCheck: typeof buildLifecycleCheck;
-buildLifecycleDependencyGraph: typeof buildLifecycleDependencyGraph;
-buildLifecycleParentGraph: typeof buildLifecycleParentGraph;
-buildEstimateBackfillRows: typeof buildEstimateBackfillRows;
-buildMetadataCounts: typeof buildMetadataCounts;
-buildMissingFieldOccurrences: typeof buildMissingFieldOccurrences;
-buildOrphanedPathRows: typeof buildOrphanedPathRows;
-classifyOrphanedPath: typeof classifyOrphanedPath;
-collectDefaultProjectFileCandidates: typeof collectDefaultProjectFileCandidates;
-collectTrackedGitFileCandidates: typeof collectTrackedGitFileCandidates;
-detectLifecycleDependencyCycles: typeof detectLifecycleDependencyCycles;
-detectLifecycleParentCycles: typeof detectLifecycleParentCycles;
-escapeRegExp: typeof escapeRegExp;
-extractItemIds: typeof extractItemIds;
-findLifecycleDependencyCycleComponents: typeof findLifecycleDependencyCycleComponents;
-isMetadataFieldMissing: typeof isMetadataFieldMissing;
-linkedArtifactPathExceedsFilesystemLimits: typeof linkedArtifactPathExceedsFilesystemLimits;
-listFilesRecursive: typeof listFilesRecursive;
-resolveDependencyCycleSeverity: typeof resolveDependencyCycleSeverity;
-resolveParentCycleSeverity: typeof resolveParentCycleSeverity;
-resolveFileScanMode: typeof resolveFileScanMode;
-resolveLifecycleDependencyCycleSamplePath: typeof resolveLifecycleDependencyCycleSamplePath;
-resolveRequestedChecks: typeof resolveRequestedChecks;
-resolveValidateMetadataProfile: typeof resolveValidateMetadataProfile;
-resolveWorkspaceRoot: typeof resolveWorkspaceRoot;
-sharedDirectoryPrefixLength: typeof sharedDirectoryPrefixLength;
-summarizeOrphanedPathRows: typeof summarizeOrphanedPathRows;
-summarizeDuplicateIssueCodes: typeof summarizeDuplicateIssueCodes;
-toMeaningfulString: typeof toMeaningfulString;
+export declare const _testOnlyValidateCommand:{
+applyValidateFix:typeof applyValidateFix;
+applyValidateFixes:typeof applyValidateFixes;
+attachValidateFixHints:typeof attachValidateFixHints;
+buildCommandReferencesCheck:typeof buildCommandReferencesCheck;
+buildDependencyReferencesCheck:typeof buildDependencyReferencesCheck;
+buildCloseReasonBackfillRows:typeof buildCloseReasonBackfillRows;
+buildFilesCheck:typeof buildFilesCheck;
+buildLifecycleCheck:typeof buildLifecycleCheck;
+buildLifecycleDependencyGraph:typeof buildLifecycleDependencyGraph;
+buildLifecycleParentGraph:typeof buildLifecycleParentGraph;
+buildEstimateBackfillRows:typeof buildEstimateBackfillRows;
+buildMetadataCounts:typeof buildMetadataCounts;
+buildMissingFieldOccurrences:typeof buildMissingFieldOccurrences;
+buildOrphanedPathRows:typeof buildOrphanedPathRows;
+classifyOrphanedPath:typeof classifyOrphanedPath;
+collectDefaultProjectFileCandidates:typeof collectDefaultProjectFileCandidates;
+collectTrackedGitFileCandidates:typeof collectTrackedGitFileCandidates;
+detectLifecycleDependencyCycles:typeof detectLifecycleDependencyCycles;
+detectLifecycleParentCycles:typeof detectLifecycleParentCycles;
+escapeRegExp:typeof escapeRegExp;
+extractItemIds:typeof extractItemIds;
+findLifecycleDependencyCycleComponents:typeof findLifecycleDependencyCycleComponents;
+isMetadataFieldMissing:typeof isMetadataFieldMissing;
+linkedArtifactPathExceedsFilesystemLimits:typeof linkedArtifactPathExceedsFilesystemLimits;
+listFilesRecursive:typeof listFilesRecursive;
+resolveDependencyCycleSeverity:typeof resolveDependencyCycleSeverity;
+resolveParentCycleSeverity:typeof resolveParentCycleSeverity;
+resolveFileScanMode:typeof resolveFileScanMode;
+resolveLifecycleDependencyCycleSamplePath:typeof resolveLifecycleDependencyCycleSamplePath;
+resolveRequestedChecks:typeof resolveRequestedChecks;
+resolveValidateMetadataProfile:typeof resolveValidateMetadataProfile;
+resolveWorkspaceRoot:typeof resolveWorkspaceRoot;
+sharedDirectoryPrefixLength:typeof sharedDirectoryPrefixLength;
+summarizeOrphanedPathRows:typeof summarizeOrphanedPathRows;
+summarizeDuplicateIssueCodes:typeof summarizeDuplicateIssueCodes;
+toMeaningfulString:typeof toMeaningfulString;
 };
 /** Run validation with an accurately typed counts-only projection. */
-export declare function runValidate(options: ValidateCommandOptions & {
-counts: true;
-}, global: GlobalOptions, services?: ValidateMutationServices): Promise<ValidateCountsResult>;
+export declare function runValidate(options:ValidateCommandOptions & {
+counts:true;
+},global:GlobalOptions,services?:ValidateMutationServices):Promise<ValidateCountsResult>;
 /** Run validation with complete diagnostic and remediation arrays. */
-export declare function runValidate(options: ValidateCommandOptions & {
-counts?: false;
-}, global: GlobalOptions, services?: ValidateMutationServices): Promise<ValidateResult>;
+export declare function runValidate(options:ValidateCommandOptions & {
+counts?:false;
+},global:GlobalOptions,services?:ValidateMutationServices):Promise<ValidateResult>;
 /** Run validation when the caller determines the projection dynamically. */
-export declare function runValidate(options: ValidateCommandOptions, global: GlobalOptions, services?: ValidateMutationServices): Promise<ValidateResult | ValidateCountsResult>;
+export declare function runValidate(options:ValidateCommandOptions,global:GlobalOptions,services?:ValidateMutationServices):Promise<ValidateResult | ValidateCountsResult>;
 export {};