qfai 1.7.6 → 1.7.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -142,6 +142,9 @@ type QfaiUiuxAuditConfig = {
142
142
  maxRawTokenLiteralWarnings?: number;
143
143
  maxDuplicateFindingsPerRule?: number;
144
144
  };
145
+ type QfaiUiuxMigrationConfig = {
146
+ strict?: boolean;
147
+ };
145
148
  type QfaiUiuxConfig = {
146
149
  platform?: string;
147
150
  designTokensDir?: string;
@@ -150,8 +153,10 @@ type QfaiUiuxConfig = {
150
153
  requireResearchSummary?: boolean;
151
154
  competitive_refs_min?: number;
152
155
  warning_as_error_override?: string[];
156
+ phase1ReleaseDate?: string;
153
157
  renderEvidence?: RenderEvidenceConfig;
154
158
  audit?: QfaiUiuxAuditConfig;
159
+ migration?: QfaiUiuxMigrationConfig;
155
160
  };
156
161
  type QfaiConfig = {
157
162
  paths: QfaiPaths;
@@ -431,6 +436,107 @@ declare function resolveObligations(mode: PrototypingMode): string[];
431
436
  */
432
437
  declare function resolveObligationsWithOptIn(mode: PrototypingMode, optIn: string[]): string[];
433
438
 
439
+ type DiscussionRecommendation = {
440
+ recommended_mode: string | null;
441
+ rationale: string | null;
442
+ };
443
+ /**
444
+ * Read prototyping recommendation from a discussion pack directory.
445
+ *
446
+ * Looks for `prototyping.yaml` in the given directory and extracts
447
+ * `prototyping.recommended_mode` and `prototyping.rationale`.
448
+ *
449
+ * @param discussionPackDir - Path to the discussion pack directory
450
+ * @returns Recommendation with nullable fields; never throws
451
+ */
452
+ declare function readDiscussionRecommendation(discussionPackDir: string): Promise<DiscussionRecommendation>;
453
+
454
+ /**
455
+ * Precedence resolver for prototyping mode.
456
+ *
457
+ * Resolves effective mode from three sources in strict order:
458
+ * 1. CLI `--mode` flag (cli-override)
459
+ * 2. Discussion artifact `recommended_mode` (discussion-recommendation)
460
+ * 3. System default `standard` (default) — per DR-0084
461
+ *
462
+ * Phase M2 of v1.7.7 Mode Switch UX (spec-0006).
463
+ */
464
+
465
+ type ModeSource = "cli-override" | "discussion-recommendation" | "default";
466
+ type ModeResolution = {
467
+ effective_mode: PrototypingMode;
468
+ mode_source: ModeSource;
469
+ recommended_mode: PrototypingMode | null;
470
+ rationale: string;
471
+ };
472
+ type PrecedenceInput = {
473
+ cliMode: PrototypingMode | null;
474
+ discussion: DiscussionRecommendation | null;
475
+ };
476
+ /**
477
+ * Resolve the effective prototyping mode from available sources.
478
+ *
479
+ * @param input.cliMode - Mode from CLI `--mode` flag, or null if not provided
480
+ * @param input.discussion - Discussion recommendation, or null if unavailable
481
+ * @returns Mode resolution result with source attribution
482
+ */
483
+ declare function resolvePrecedence(input: PrecedenceInput): ModeResolution;
484
+
485
+ /**
486
+ * Mode resolution logger for prototyping.
487
+ *
488
+ * Formats mode resolution results into structured log entries containing:
489
+ * mode_source, recommended_mode, effective_mode, rationale, evidence_expectations.
490
+ *
491
+ * Phase M3 of v1.7.7 Mode Switch UX (spec-0006).
492
+ */
493
+
494
+ type ModeLogEntry = {
495
+ mode_source: ModeSource;
496
+ recommended_mode: PrototypingMode | null;
497
+ effective_mode: PrototypingMode;
498
+ rationale: string;
499
+ evidence_expectations: string;
500
+ };
501
+ declare const VALID_MODE_SOURCES: ReadonlySet<ModeSource>;
502
+ /**
503
+ * Format a mode resolution into a structured log entry.
504
+ *
505
+ * @param resolution - The mode resolution result from precedenceResolver
506
+ * @returns Structured log entry with evidence expectations mapped by effective mode
507
+ */
508
+ declare function formatModeLog(resolution: ModeResolution): ModeLogEntry;
509
+
510
+ /**
511
+ * Surface adapter for prototyping evidence.
512
+ *
513
+ * Detects surface type and adapts evidence fields:
514
+ * - Non-visual surfaces (CLI, API, library): visual-review = n/a
515
+ * - Visual surfaces (web, mobile, desktop): visual-review = collected (when mode allows runtime)
516
+ * - Low-cost mode: runtime and visual-review are always n/a (static-only)
517
+ *
518
+ * Phase M4 of v1.7.7 Mode Switch UX (spec-0006).
519
+ */
520
+ type SurfaceType = "web" | "mobile" | "desktop" | "cli" | "api" | "library";
521
+ type EvidenceStatus = "collected" | "n/a";
522
+ type SurfaceEvidenceResult = {
523
+ visual_review: EvidenceStatus;
524
+ static_evidence: EvidenceStatus;
525
+ runtime_evidence: EvidenceStatus;
526
+ };
527
+ type SurfaceAdapterInput = {
528
+ surfaceType: SurfaceType;
529
+ effectiveMode: string;
530
+ };
531
+ /**
532
+ * Adapt evidence fields based on surface type and effective mode.
533
+ *
534
+ * @param input.surfaceType - The project's surface type
535
+ * @param input.effectiveMode - The resolved effective prototyping mode
536
+ * @returns Evidence field statuses adapted for the surface
537
+ */
538
+ declare function adaptSurfaceEvidence(input: SurfaceAdapterInput): SurfaceEvidenceResult;
539
+
434
540
  type ReportSummary = {
435
541
  specs: number;
436
542
  scenarios: number;
@@ -632,4 +738,4 @@ declare function validateSpecSplitByCapability(root: string, config: QfaiConfig)
632
738
 
633
739
  declare function validateTraceability(root: string, config: QfaiConfig, phase: ValidationPhase): Promise<Issue[]>;
634
740
 
635
- export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, type DecisionGuardrail, type DecisionGuardrailEntry, type FailOn, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OrphanContractsPolicy, type OutputFormat, type PrototypingMode, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RUNTIME_HEAVY_CHECKS, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, STATIC_OBLIGATIONS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TraceabilitySeverity, type UiFidelityAutogenCrawlResult, type UiFidelityAutogenExpected, type UiFidelityAutogenMockPathResult, type UiFidelityAutogenResult, type UiFidelityGeneratedScreen, type UiFidelityLabelCoverage, type ValidationCounts, type ValidationOptions, type ValidationPhase, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, autogenerateUiFidelity, buildUiFidelityScreens, checkDecisionGuardrails, collectExpectedFromContracts, computeLabelCoverage, crawlRoutesAndCollectFoundLabels, createReportData, defaultConfig, emitUiFidelity, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractDomMarkers, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, resolveObligations, resolveObligationsWithOptIn, resolvePath, resolveToolVersion, runMockPaths, runSddPreflight, sortDecisionGuardrails, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };
741
+ export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, type DecisionGuardrail, type DecisionGuardrailEntry, type DiscussionRecommendation, type FailOn, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type ModeLogEntry, type ModeResolution, type ModeSource, type OrphanContractsPolicy, type OutputFormat, type PrecedenceInput, type PrototypingMode, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiUiuxMigrationConfig, type QfaiValidationConfig, RUNTIME_HEAVY_CHECKS, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, STATIC_OBLIGATIONS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type SurfaceAdapterInput, type SurfaceEvidenceResult, type SurfaceType, type TraceabilitySeverity, type UiFidelityAutogenCrawlResult, type UiFidelityAutogenExpected, type UiFidelityAutogenMockPathResult, type UiFidelityAutogenResult, type UiFidelityGeneratedScreen, type UiFidelityLabelCoverage, VALID_MODE_SOURCES, type ValidationCounts, type ValidationOptions, type ValidationPhase, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, adaptSurfaceEvidence, autogenerateUiFidelity, buildUiFidelityScreens, checkDecisionGuardrails, collectExpectedFromContracts, computeLabelCoverage, crawlRoutesAndCollectFoundLabels, createReportData, defaultConfig, emitUiFidelity, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractDomMarkers, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatModeLog, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, readDiscussionRecommendation, resolveObligations, resolveObligationsWithOptIn, resolvePath, resolvePrecedence, resolveToolVersion, runMockPaths, runSddPreflight, sortDecisionGuardrails, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };
package/dist/index.d.ts CHANGED
@@ -142,6 +142,9 @@ type QfaiUiuxAuditConfig = {
142
142
  maxRawTokenLiteralWarnings?: number;
143
143
  maxDuplicateFindingsPerRule?: number;
144
144
  };
145
+ type QfaiUiuxMigrationConfig = {
146
+ strict?: boolean;
147
+ };
145
148
  type QfaiUiuxConfig = {
146
149
  platform?: string;
147
150
  designTokensDir?: string;
@@ -150,8 +153,10 @@ type QfaiUiuxConfig = {
150
153
  requireResearchSummary?: boolean;
151
154
  competitive_refs_min?: number;
152
155
  warning_as_error_override?: string[];
156
+ phase1ReleaseDate?: string;
153
157
  renderEvidence?: RenderEvidenceConfig;
154
158
  audit?: QfaiUiuxAuditConfig;
159
+ migration?: QfaiUiuxMigrationConfig;
155
160
  };
156
161
  type QfaiConfig = {
157
162
  paths: QfaiPaths;
@@ -431,6 +436,107 @@ declare function resolveObligations(mode: PrototypingMode): string[];
431
436
  */
432
437
  declare function resolveObligationsWithOptIn(mode: PrototypingMode, optIn: string[]): string[];
433
438
 
439
+ type DiscussionRecommendation = {
440
+ recommended_mode: string | null;
441
+ rationale: string | null;
442
+ };
443
+ /**
444
+ * Read prototyping recommendation from a discussion pack directory.
445
+ *
446
+ * Looks for `prototyping.yaml` in the given directory and extracts
447
+ * `prototyping.recommended_mode` and `prototyping.rationale`.
448
+ *
449
+ * @param discussionPackDir - Path to the discussion pack directory
450
+ * @returns Recommendation with nullable fields; never throws
451
+ */
452
+ declare function readDiscussionRecommendation(discussionPackDir: string): Promise<DiscussionRecommendation>;
453
+
454
+ /**
455
+ * Precedence resolver for prototyping mode.
456
+ *
457
+ * Resolves effective mode from three sources in strict order:
458
+ * 1. CLI `--mode` flag (cli-override)
459
+ * 2. Discussion artifact `recommended_mode` (discussion-recommendation)
460
+ * 3. System default `standard` (default) — per DR-0084
461
+ *
462
+ * Phase M2 of v1.7.7 Mode Switch UX (spec-0006).
463
+ */
464
+
465
+ type ModeSource = "cli-override" | "discussion-recommendation" | "default";
466
+ type ModeResolution = {
467
+ effective_mode: PrototypingMode;
468
+ mode_source: ModeSource;
469
+ recommended_mode: PrototypingMode | null;
470
+ rationale: string;
471
+ };
472
+ type PrecedenceInput = {
473
+ cliMode: PrototypingMode | null;
474
+ discussion: DiscussionRecommendation | null;
475
+ };
476
+ /**
477
+ * Resolve the effective prototyping mode from available sources.
478
+ *
479
+ * @param input.cliMode - Mode from CLI `--mode` flag, or null if not provided
480
+ * @param input.discussion - Discussion recommendation, or null if unavailable
481
+ * @returns Mode resolution result with source attribution
482
+ */
483
+ declare function resolvePrecedence(input: PrecedenceInput): ModeResolution;
484
+
485
+ /**
486
+ * Mode resolution logger for prototyping.
487
+ *
488
+ * Formats mode resolution results into structured log entries containing:
489
+ * mode_source, recommended_mode, effective_mode, rationale, evidence_expectations.
490
+ *
491
+ * Phase M3 of v1.7.7 Mode Switch UX (spec-0006).
492
+ */
493
+
494
+ type ModeLogEntry = {
495
+ mode_source: ModeSource;
496
+ recommended_mode: PrototypingMode | null;
497
+ effective_mode: PrototypingMode;
498
+ rationale: string;
499
+ evidence_expectations: string;
500
+ };
501
+ declare const VALID_MODE_SOURCES: ReadonlySet<ModeSource>;
502
+ /**
503
+ * Format a mode resolution into a structured log entry.
504
+ *
505
+ * @param resolution - The mode resolution result from precedenceResolver
506
+ * @returns Structured log entry with evidence expectations mapped by effective mode
507
+ */
508
+ declare function formatModeLog(resolution: ModeResolution): ModeLogEntry;
509
+
510
+ /**
511
+ * Surface adapter for prototyping evidence.
512
+ *
513
+ * Detects surface type and adapts evidence fields:
514
+ * - Non-visual surfaces (CLI, API, library): visual-review = n/a
515
+ * - Visual surfaces (web, mobile, desktop): visual-review = collected (when mode allows runtime)
516
+ * - Low-cost mode: runtime and visual-review are always n/a (static-only)
517
+ *
518
+ * Phase M4 of v1.7.7 Mode Switch UX (spec-0006).
519
+ */
520
+ type SurfaceType = "web" | "mobile" | "desktop" | "cli" | "api" | "library";
521
+ type EvidenceStatus = "collected" | "n/a";
522
+ type SurfaceEvidenceResult = {
523
+ visual_review: EvidenceStatus;
524
+ static_evidence: EvidenceStatus;
525
+ runtime_evidence: EvidenceStatus;
526
+ };
527
+ type SurfaceAdapterInput = {
528
+ surfaceType: SurfaceType;
529
+ effectiveMode: string;
530
+ };
531
+ /**
532
+ * Adapt evidence fields based on surface type and effective mode.
533
+ *
534
+ * @param input.surfaceType - The project's surface type
535
+ * @param input.effectiveMode - The resolved effective prototyping mode
536
+ * @returns Evidence field statuses adapted for the surface
537
+ */
538
+ declare function adaptSurfaceEvidence(input: SurfaceAdapterInput): SurfaceEvidenceResult;
539
+
434
540
  type ReportSummary = {
435
541
  specs: number;
436
542
  scenarios: number;
@@ -632,4 +738,4 @@ declare function validateSpecSplitByCapability(root: string, config: QfaiConfig)
632
738
 
633
739
  declare function validateTraceability(root: string, config: QfaiConfig, phase: ValidationPhase): Promise<Issue[]>;
634
740
 
635
- export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, type DecisionGuardrail, type DecisionGuardrailEntry, type FailOn, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OrphanContractsPolicy, type OutputFormat, type PrototypingMode, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RUNTIME_HEAVY_CHECKS, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, STATIC_OBLIGATIONS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TraceabilitySeverity, type UiFidelityAutogenCrawlResult, type UiFidelityAutogenExpected, type UiFidelityAutogenMockPathResult, type UiFidelityAutogenResult, type UiFidelityGeneratedScreen, type UiFidelityLabelCoverage, type ValidationCounts, type ValidationOptions, type ValidationPhase, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, autogenerateUiFidelity, buildUiFidelityScreens, checkDecisionGuardrails, collectExpectedFromContracts, computeLabelCoverage, crawlRoutesAndCollectFoundLabels, createReportData, defaultConfig, emitUiFidelity, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractDomMarkers, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, resolveObligations, resolveObligationsWithOptIn, resolvePath, resolveToolVersion, runMockPaths, runSddPreflight, sortDecisionGuardrails, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };
741
+ export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, type DecisionGuardrail, type DecisionGuardrailEntry, type DiscussionRecommendation, type FailOn, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type ModeLogEntry, type ModeResolution, type ModeSource, type OrphanContractsPolicy, type OutputFormat, type PrecedenceInput, type PrototypingMode, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiUiuxMigrationConfig, type QfaiValidationConfig, RUNTIME_HEAVY_CHECKS, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, STATIC_OBLIGATIONS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type SurfaceAdapterInput, type SurfaceEvidenceResult, type SurfaceType, type TraceabilitySeverity, type UiFidelityAutogenCrawlResult, type UiFidelityAutogenExpected, type UiFidelityAutogenMockPathResult, type UiFidelityAutogenResult, type UiFidelityGeneratedScreen, type UiFidelityLabelCoverage, VALID_MODE_SOURCES, type ValidationCounts, type ValidationOptions, type ValidationPhase, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, adaptSurfaceEvidence, autogenerateUiFidelity, buildUiFidelityScreens, checkDecisionGuardrails, collectExpectedFromContracts, computeLabelCoverage, crawlRoutesAndCollectFoundLabels, createReportData, defaultConfig, emitUiFidelity, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractDomMarkers, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatModeLog, formatReportJson, formatReportMarkdown, getConfigPath, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, readDiscussionRecommendation, resolveObligations, resolveObligationsWithOptIn, resolvePath, resolvePrecedence, resolveToolVersion, runMockPaths, runSddPreflight, sortDecisionGuardrails, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };