@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/governance/validate-item-reader.d.ts

@@ -1,13 +1,13 @@
 import type { ItemMetadata, PmSettings } from "../../types/index.js";
 /** Item projection accepted by validate checks; body is read only for strict drift verification. */
 export type ValidateItem = ItemMetadata & {
-    body: string;
+body: string;
 };
 /** Load collections for normal checks and add bodies only when history hashes must be verified. */
 export declare function readValidateItems(params: {
-    includeBody: boolean;
-    pmRoot: string;
-    settings: PmSettings;
-    typeToFolder: Record<string, string>;
-    warnings: string[];
+includeBody: boolean;
+pmRoot: string;
+settings: PmSettings;
+typeToFolder: Record<string, string>;
+warnings: string[];
 }): Promise<ValidateItem[]>;

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

@@ -18,136 +18,136 @@ type OrphanedPathClassification = "docs_unowned" | "tests_unowned" | "source_uno
 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;
-    /** Value that configures or reports check metadata for this contract. */
-    checkMetadata?: boolean;
-    /** Value that configures or reports check resolution for this contract. */
-    checkResolution?: boolean;
-    /** Value that configures or reports check lifecycle for this contract. */
-    checkLifecycle?: boolean;
-    /** Value that configures or reports check stale blockers for this contract. */
-    checkStaleBlockers?: boolean;
-    /** Value that configures or reports dependency cycle severity for this contract. */
-    dependencyCycleSeverity?: string;
-    /** Value that configures or reports parent cycle severity for this contract. */
-    parentCycleSeverity?: string;
-    /** Value that configures or reports check files for this contract. */
-    checkFiles?: boolean;
-    /** Value that configures or reports include pm internals for this contract. */
-    includePmInternals?: boolean;
-    /** Value that configures or reports verbose file lists for this contract. */
-    verboseFileLists?: boolean;
-    /** Value that configures or reports verbose diagnostics for this contract. */
-    verboseDiagnostics?: boolean;
-    /** Emit complete *_item_ids diagnostic lists (no 5-item cap); implied by --json. */
-    allAffectedIds?: boolean;
-    /** Value that configures or reports check history drift for this contract. */
-    checkHistoryDrift?: boolean;
-    /** Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected items, unparseable config). */
-    checkStorageIntegrity?: boolean;
-    /** Value that configures or reports check command references for this contract. */
-    checkCommandReferences?: boolean;
-    /** Strategy used to control scan behavior. */
-    scanMode?: string;
-    /** Value that configures or reports metadata profile for this contract. */
-    metadataProfile?: string;
-    /** Value that configures or reports fix hints for this contract. */
-    fixHints?: boolean;
-    /** Value that configures or reports auto fix for this contract. */
-    autoFix?: boolean;
-    /** Value that configures or reports dry run for this contract. */
-    dryRun?: boolean;
-    /** Value that configures or reports fix scope for this contract. */
-    fixScope?: string[];
-    /** Value that configures or reports prune missing for this contract. */
-    pruneMissing?: boolean;
-    /** Keep validation counts and scalar totals while omitting diagnostic row arrays. */
-    counts?: boolean;
-    /** Explicitly restore complete diagnostic rows after a counts-only read. */
-    full?: boolean;
+/** Evaluate workspace field requirements for each item's current lifecycle status. */
+checkCompleteness?: boolean;
+/** Value that configures or reports check metadata for this contract. */
+checkMetadata?: boolean;
+/** Value that configures or reports check resolution for this contract. */
+checkResolution?: boolean;
+/** Value that configures or reports check lifecycle for this contract. */
+checkLifecycle?: boolean;
+/** Value that configures or reports check stale blockers for this contract. */
+checkStaleBlockers?: boolean;
+/** Value that configures or reports dependency cycle severity for this contract. */
+dependencyCycleSeverity?: string;
+/** Value that configures or reports parent cycle severity for this contract. */
+parentCycleSeverity?: string;
+/** Value that configures or reports check files for this contract. */
+checkFiles?: boolean;
+/** Value that configures or reports include pm internals for this contract. */
+includePmInternals?: boolean;
+/** Value that configures or reports verbose file lists for this contract. */
+verboseFileLists?: boolean;
+/** Value that configures or reports verbose diagnostics for this contract. */
+verboseDiagnostics?: boolean;
+/** Emit complete *_item_ids diagnostic lists (no 5-item cap); implied by --json. */
+allAffectedIds?: boolean;
+/** Value that configures or reports check history drift for this contract. */
+checkHistoryDrift?: boolean;
+/** Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected items, unparseable config). */
+checkStorageIntegrity?: boolean;
+/** Value that configures or reports check command references for this contract. */
+checkCommandReferences?: boolean;
+/** Strategy used to control scan behavior. */
+scanMode?: string;
+/** Value that configures or reports metadata profile for this contract. */
+metadataProfile?: string;
+/** Value that configures or reports fix hints for this contract. */
+fixHints?: boolean;
+/** Value that configures or reports auto fix for this contract. */
+autoFix?: boolean;
+/** Value that configures or reports dry run for this contract. */
+dryRun?: boolean;
+/** Value that configures or reports fix scope for this contract. */
+fixScope?: string[];
+/** Value that configures or reports prune missing for this contract. */
+pruneMissing?: boolean;
+/** Keep validation counts and scalar totals while omitting diagnostic row arrays. */
+counts?: boolean;
+/** Explicitly restore complete diagnostic rows after a counts-only read. */
+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>;
+/** Apply one update through the host's canonical audited mutation path. */
+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;
-    /** Lifecycle state reported for status. */
-    status: ValidateStatus;
-    /** Direct machine predicate derived from whether status is ok. */
-    ok: boolean;
-    /** Value that configures or reports details for this contract. */
-    details: Record<string, unknown>;
+/** Value that configures or reports name for this contract. */
+name: ValidateCheckName;
+/** Lifecycle state reported for status. */
+status: ValidateStatus;
+/** Direct machine predicate derived from whether status is ok. */
+ok: boolean;
+/** Value that configures or reports details for this contract. */
+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";
-    /** Value that configures or reports auto fix for this contract. */
-    auto_fix: boolean;
-    /** Value that configures or reports prune missing for this contract. */
-    prune_missing: boolean;
-    /** Value that configures or reports granted fix scopes for this contract. */
-    granted_fix_scopes: string[];
-    /** Number of planned entries represented by this result. */
-    planned_count: number;
-    /** Number of applied entries represented by this result. */
-    applied_count: number;
-    /** Number of gated entries represented by this result. */
-    gated_count: number;
-    /** Number of failed entries represented by this result. */
-    failed_count: number;
-    /** Value that configures or reports planned fixes for this contract. */
-    planned_fixes: Array<Record<string, unknown>>;
-    /** Value that configures or reports applied fixes for this contract. */
-    applied_fixes: Array<Record<string, unknown>>;
-    /** Value that configures or reports gated fixes for this contract. */
-    gated_fixes: Array<Record<string, unknown>>;
-    /** Value that configures or reports failed fixes for this contract. */
-    failed_fixes: Array<Record<string, unknown>>;
+/** Value that configures or reports mode for this contract. */
+mode: "apply" | "dry_run";
+/** Value that configures or reports auto fix for this contract. */
+auto_fix: boolean;
+/** Value that configures or reports prune missing for this contract. */
+prune_missing: boolean;
+/** Value that configures or reports granted fix scopes for this contract. */
+granted_fix_scopes: string[];
+/** Number of planned entries represented by this result. */
+planned_count: number;
+/** Number of applied entries represented by this result. */
+applied_count: number;
+/** Number of gated entries represented by this result. */
+gated_count: number;
+/** Number of failed entries represented by this result. */
+failed_count: number;
+/** Value that configures or reports planned fixes for this contract. */
+planned_fixes: Array<Record<string, unknown>>;
+/** Value that configures or reports applied fixes for this contract. */
+applied_fixes: Array<Record<string, unknown>>;
+/** Value that configures or reports gated fixes for this contract. */
+gated_fixes: Array<Record<string, unknown>>;
+/** Value that configures or reports failed fixes for this contract. */
+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";
-    /** Whether safe automatic fixes were requested. */
-    auto_fix: boolean;
-    /** Whether missing linked paths were eligible for pruning. */
-    prune_missing: boolean;
-    /** Number of planned entries represented by this result. */
-    planned_count: number;
-    /** Number of applied entries represented by this result. */
-    applied_count: number;
-    /** Number of gated entries represented by this result. */
-    gated_count: number;
-    /** Number of failed entries represented by this result. */
-    failed_count: number;
+/** Whether fixes were applied or only previewed. */
+mode: "apply" | "dry_run";
+/** Whether safe automatic fixes were requested. */
+auto_fix: boolean;
+/** Whether missing linked paths were eligible for pruning. */
+prune_missing: boolean;
+/** Number of planned entries represented by this result. */
+planned_count: number;
+/** Number of applied entries represented by this result. */
+applied_count: number;
+/** Number of gated entries represented by this result. */
+gated_count: number;
+/** Number of failed entries represented by this result. */
+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;
-    /** Whether warnings applies to this operation. */
-    has_warnings: boolean;
-    /** Value that configures or reports checks for this contract. */
-    checks: ValidateCheck[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Present when --auto-fix or --prune-missing was requested; checks always reflect the PRE-fix state. */
-    fixes?: ValidateFixesSummary;
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
-    /** Self-describing diagnostic projection used to derive a bounded omission receipt. */
-    projection: OutputProjectionDeclaration;
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Whether warnings applies to this operation. */
+has_warnings: boolean;
+/** Value that configures or reports checks for this contract. */
+checks: ValidateCheck[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Present when --auto-fix or --prune-missing was requested; checks always reflect the PRE-fix state. */
+fixes?: ValidateFixesSummary;
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
+/** Self-describing diagnostic projection used to derive a bounded omission receipt. */
+projection: OutputProjectionDeclaration;
 }
 /** Validate result returned when `counts: true` omits diagnostic row arrays. */
 export interface ValidateCountsResult extends Omit<ValidateResult, "fixes"> {
-    /** Scalar-only remediation totals, present when remediation was requested. */
-    fixes?: ValidateCountsFixesSummary;
+/** Scalar-only remediation totals, present when remediation was requested. */
+fixes?: ValidateCountsFixesSummary;
 }
 /**
  * Build the counts-only validate projection without mutating the full result.
@@ -159,19 +159,19 @@ export interface ValidateCountsResult extends Omit<ValidateResult, "fixes"> {
  */
 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;
@@ -187,9 +187,9 @@ declare function attachValidateFixHints(check: ValidateCheck, checkWarnings: str
 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[];
+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[];
@@ -198,27 +198,27 @@ declare function buildEstimateBackfillRows(metadataPolicy: ValidateMetadataPolic
 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[];
+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[];
+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";
-    } | null;
-    remediation_hint: string;
+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;
 }
 declare function classifyOrphanedPath(pathValue: string): OrphanedPathClassification;
 declare function sharedDirectoryPrefixLength(left: string, right: string): number;
@@ -226,75 +226,75 @@ declare function buildOrphanedPathRows(orphanedFiles: readonly string[], items:
 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[];
+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[];
+check: ValidateCheck;
+warnings: string[];
+staleLinkPruneRows: StaleLinkPruneRow[];
 }>;
 declare function buildCommandReferencesCheck(items: ItemWithBody[], idPrefix: string, verboseDiagnostics: boolean, pmRoot: string): Promise<{
-    check: ValidateCheck;
-    warnings: string[];
+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;
-    }>;
+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;
+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;
+counts: true;
 }, global: GlobalOptions, services?: ValidateMutationServices): Promise<ValidateCountsResult>;
 /** Run validation with complete diagnostic and remediation arrays. */
 export declare function runValidate(options: ValidateCommandOptions & {
-    counts?: false;
+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>;

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

@@ -7,26 +7,26 @@ import { type WorkflowPolicyDocument, type WorkflowPolicyDecision } from "../../
 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;
+/** 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[];
+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;
+id: string;
+type: string;
+status: string;
 })[], rowLimit?: number, sourceIncomplete?: boolean): {
-    check: ValidateCheck;
-    warnings: string[];
+check: ValidateCheck;
+warnings: string[];
 };

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

@@ -6,40 +6,40 @@ export { buildWorkflowCompletenessCheck, type WorkflowCompletenessViolation } fr
 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;
+/** 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;
+/** 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[];
+/** 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;