qfai 1.7.13 → 1.7.14

package/dist/index.d.cts

@@ -14,7 +14,7 @@ type TestFileScan = {
 };
 
 type IssueSeverity = "info" | "warning" | "error";
-type IssueCategory = "canonical" | "compatibility" | "change";
+type IssueCategory = "canonical" | "change";
 type IssueLocation = {
     line: number;
     column?: number;
@@ -142,9 +142,6 @@ type QfaiUiuxAuditConfig = {
     maxRawTokenLiteralWarnings?: number;
     maxDuplicateFindingsPerRule?: number;
 };
-type QfaiUiuxMigrationConfig = {
-    strict?: boolean;
-};
 type QfaiUiuxConfig = {
     platform?: string;
     designTokensDir?: string;
@@ -153,10 +150,8 @@ type QfaiUiuxConfig = {
     requireResearchSummary?: boolean;
     competitive_refs_min?: number;
     warning_as_error_override?: string[];
-    phase1ReleaseDate?: string;
     renderEvidence?: RenderEvidenceConfig;
     audit?: QfaiUiuxAuditConfig;
-    migration?: QfaiUiuxMigrationConfig;
 };
 type QfaiPrototypingCalibrationConfig = {
     packPath?: string;
@@ -322,12 +317,13 @@ declare function extractAcSpecNumber(acId: string): string | null;
 declare function extractCaseSpecNumber(caseId: string): string | null;
 declare function extractScSpecNumber(scId: string): string | null;
 
+declare const CANONICAL_PROTOTYPING_SURFACES: readonly ["web", "mobile", "desktop", "cli", "mixed"];
+type CanonicalPrototypingSurface = (typeof CANONICAL_PROTOTYPING_SURFACES)[number];
+
 type PrototypingMode = "low-cost" | "standard" | "full-harness";
 type ModeSelectionSource = "explicit-request" | "discussion-recommendation" | "system-default";
-type PrototypingSurface = "web" | "mobile" | "desktop" | "cli" | "mixed" | "non-ui";
-/** @deprecated Legacy surface values — use canonical PrototypingSurface instead */
-type LegacyPrototypingSurface = "web-ui" | "mobile-ui" | "desktop-ui";
-type DiscussionRecommendationSourceSchema = "canonical-namespaced" | "legacy-top-level";
+type PrototypingSurface = CanonicalPrototypingSurface;
+type DiscussionRecommendationSourceSchema = "canonical-namespaced";
 /**
  * Canonical validated recommendation — all 4 fields required.
  * Parser output uses this same type; fields are always populated
@@ -386,7 +382,7 @@ type ParseDiscussionResult = {
 };
 /**
  * Parse a prototyping.yaml file from a discussion pack.
- * Supports both canonical namespaced (`prototyping.*`) and legacy top-level schema.
+ * Supports only the canonical namespaced (`prototyping.*`) schema.
  */
 declare function parseDiscussionModeRecommendation(filePath: string): Promise<DiscussionModeRecommendation | null>;
 declare function parseDiscussionModeRecommendationWithWarnings(filePath: string): Promise<ParseDiscussionResult>;
@@ -409,18 +405,13 @@ declare function inferSurfaceFromRecommendationAndEvidence(input: {
     hasBrowserQaBundle?: boolean | undefined;
     hasUiRoutes?: boolean | undefined;
     hasRuntimeGateUi?: boolean | undefined;
-}): PrototypingSurface;
+}): PrototypingSurface | null;
 declare function derivePrototypingObligations(input: {
     surface: PrototypingSurface;
     effectiveMode: PrototypingMode;
 }): PrototypingObligations;
 declare function isValidPrototypingMode(value: unknown): value is PrototypingMode;
 declare function isValidPrototypingSurface(value: unknown): value is PrototypingSurface;
-/**
- * Normalize a surface value: map legacy values to canonical equivalents.
- */
-declare function normalizePrototypingSurface(value: string): PrototypingSurface;
-declare function isUiBearingSurface(surface: PrototypingSurface): boolean;
 declare function normalizeAllowedModes(modes?: string[]): PrototypingMode[];
 
 /**
@@ -509,40 +500,44 @@ declare class CritiqueAdapter {
     requestCritique(input: CritiqueInput): Promise<CritiqueResult>;
 }
 
-type SurfaceType = "web" | "mobile" | "desktop" | "cli" | "mixed" | "non-ui";
-/** Surfaces that bear a user interface — canonical truth for UI-bearing detection. */
-declare const UI_BEARING_SURFACES: Set<SurfaceType>;
-/** Surfaces that do NOT bear a user interface. */
-declare const NON_UI_SURFACES: Set<SurfaceType>;
-/**
- * Synchronous check: given a SurfaceType value, returns true if UI-bearing.
- * Canonical shared helper for classification validator and prototyping mode.
- */
-declare function isUiBearingSurfaceType(surface: SurfaceType): boolean;
-
-/**
- * Browser QA canonical types — WS-B
- *
- * Defines the 4-phase execution model with truthful status reporting.
- */
+type SurfaceType = CanonicalPrototypingSurface | "non-ui";
+declare const DISCUSSION_UI_BEARING_SURFACES: Set<SurfaceType>;
+declare const DISCUSSION_NON_UI_SURFACES: Set<SurfaceType>;
+declare const VISUAL_BROWSER_SURFACES: Set<SurfaceType>;
+declare function isDiscussionUiBearingSurfaceType(surface: SurfaceType): boolean;
+declare function isNonUiDiscussionSurface(surface: SurfaceType): boolean;
+declare function requiresVisualBrowserEvidence(surface: SurfaceType): boolean;
 
 type BrowserQaPhase = "smoke" | "interaction" | "visual" | "accessibility";
 declare const BROWSER_QA_PHASES: readonly BrowserQaPhase[];
-type BrowserQaPhaseStatus = "executed" | "skipped" | "failed";
-type BrowserQaFindingSeverity = "info" | "warning" | "error";
-type BrowserQaFinding = {
+type BrowserQaPhaseStatus = "passed" | "executed" | "failed" | "skipped";
+type BrowserQaFindingSeverity = "info" | "warn" | "warning" | "error";
+interface BrowserQaFinding {
     phase: BrowserQaPhase;
-    route?: string;
-    selector?: string;
-    target?: string;
     severity: BrowserQaFindingSeverity;
-    message: string;
+    summary: string;
+    detail: string;
+    screen_id?: string;
+    selector?: string;
+    evidence_refs: string[];
+    repair_suggestions: string[];
+    category?: BrowserQaPhase;
+    message?: string;
+    route?: string;
     repair_hint?: string;
+}
+type BrowserQaScreenContractRef = {
+    screen_id: string;
+    route?: string;
+    primary_tasks?: string[];
 };
 type BrowserQaPhaseResult = {
     phase: BrowserQaPhase;
     status: BrowserQaPhaseStatus;
     findings: BrowserQaFinding[];
+    repair_suggestions: string[];
+    evidence_refs: string[];
+    checks_performed: string[];
     skippedReason?: string;
 };
 type BrowserQaInput = {
@@ -552,6 +547,7 @@ type BrowserQaInput = {
     surface: SurfaceType;
     required?: boolean;
     executionSource?: "html" | "url" | "none";
+    screenContracts?: BrowserQaScreenContractRef[];
 };
 type BrowserQaRunResult = {
     phases: BrowserQaPhaseResult[];
@@ -563,8 +559,12 @@ type BrowserQaSummary = {
     phases: Record<BrowserQaPhase, {
         status: BrowserQaPhaseStatus;
         findingsCount: number;
+        checksCount: number;
+        passed?: number;
+        failed?: number;
     }>;
     totalFindings: number;
+    totalRepairs: number;
     skippedReasons: string[];
 };
 interface BrowserQaProvider {
@@ -583,11 +583,11 @@ interface BrowserQaProvider {
  * absence is a valid state with fail-open semantics.
  *
  * WS-B: BrowserQaProvider is the canonical interface for 4-phase Browser QA.
- * BrowserProvider is the legacy render-capture provider interface.
+ * BrowserProvider defines the browser QA and capture provider interface.
  */
 
 type ProviderCapability = "screenshot" | "viewport" | "dom" | "interaction" | "visual" | "accessibility";
-/** Legacy render-capture provider. */
+/** Browser QA and capture provider. */
 type BrowserProvider = {
     name: string;
     capabilities: ProviderCapability[];
@@ -917,8 +917,11 @@ type ReportPrototypingSummary = {
             totalFailed: number;
         };
         phaseSummary?: Record<string, {
-            passed: number;
-            failed: number;
+            status: string;
+            findingsCount: number;
+            checksCount: number;
+            passed?: number;
+            failed?: number;
         }>;
         modeMismatch?: boolean;
     };
@@ -980,24 +983,7 @@ declare function validateSpecSplitByCapability(root: string, config: QfaiConfig)
 
 declare function validateTraceability(root: string, config: QfaiConfig, phase: ValidationPhase): Promise<Issue[]>;
 
-/**
- * Browser QA runner — WS-B
- *
- * Orchestrates the canonical 4-phase Browser QA execution model.
- * Provider resolution → phase execution → truthful skip/fail handling.
- */
-
-/**
- * Run the canonical 4-phase Browser QA.
- *
- * - provider resolved → delegate to provider methods
- * - no provider → use built-in static analysis phases
- * - non-ui surface → all phases skipped
- */
 declare function runBrowserQaOrchestrated(input: BrowserQaInput, provider?: BrowserQaProvider): Promise<BrowserQaRunResult>;
-/**
- * Summarize a BrowserQaRunResult for report output.
- */
 declare function summarizeBrowserQaResult(result: BrowserQaRunResult): BrowserQaSummary;
 
 /**
@@ -1018,6 +1004,25 @@ declare function runRenderCapture(targets: RenderCaptureTarget[], outputDir: str
     required?: boolean;
 }): Promise<RenderRunnerResult>;
 
+interface FakeUiDetectionResult {
+    detected: boolean;
+    reasons: string[];
+    evidence_refs: string[];
+    confidence: "low" | "medium" | "high";
+}
+
+declare const FULL_HARNESS_EXIT_REASONS: readonly ["quality-threshold-met", "plateau", "budget-exhausted", "fake-ui-detected", "runtime-failure", "human-review-required"];
+type FullHarnessExitReason = (typeof FULL_HARNESS_EXIT_REASONS)[number];
+
+type FullHarnessHandoff = {
+    selected_build: string;
+    artifact_refs: string[];
+    outstanding_issues: string[];
+    required_human_review_points: string[];
+    exit_reason: FullHarnessExitReason;
+    next_recommended_action: string;
+};
+
 type PrototypingSummaryBundle = {
     surface: PrototypingSurface;
     specs: Array<{
@@ -1105,6 +1110,11 @@ declare function writeEvidenceBundles(input: {
         mode: PrototypingMode;
     };
     prototyping: PrototypingSummaryBundle;
+    fullHarnessArtifacts?: {
+        fakeUiDetection: FakeUiDetectionResult;
+        handoff: FullHarnessHandoff;
+        exitReason: FullHarnessExitReason;
+    };
 }): Promise<{
     prototypingPath: string;
     renderPath: string;
@@ -1288,6 +1298,9 @@ type FullHarnessResult = {
     output: FullHarnessOutput;
     evidence: ReturnType<typeof generateEvidence>;
     reviewSummary: ReturnType<typeof generateReviewSummary>;
+    fakeUiDetection: FakeUiDetectionResult;
+    exitReason: FullHarnessExitReason;
+    handoff: FullHarnessHandoff;
 };
 /**
  * Run the full-harness mode.
@@ -1306,4 +1319,4 @@ declare function createPlaywrightRenderAdapter(input: {
 
 declare function createPlaywrightBrowserQaProvider(): BrowserQaProvider;
 
-export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, type DecisionGuardrail, type DecisionGuardrailEntry, type DiscussionModeRecommendation, type DiscussionRecommendationSourceSchema, type FailOn, type FullHarnessRequest, type FullHarnessResult, 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 LegacyPrototypingSurface, type ModeResolutionInput, type ModeResolutionResult, type ModeSelectionSource, NON_UI_SURFACES, type OrphanContractsPolicy, type OutputFormat, type ParseDiscussionResult, type PrototypingExecutionConfig, type PrototypingExecutionRequest, type PrototypingExecutionResult, type PrototypingMode, type PrototypingObligations, type PrototypingSurface, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiUiuxMigrationConfig, type QfaiValidationConfig, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type ResolveModeInput, type ResolvedModeSummary, type RunSddPreflightOptions, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TraceabilitySeverity, UI_BEARING_SURFACES, type UiFidelityStatus, 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, checkDecisionGuardrails, createPlaywrightBrowserQaProvider, createPlaywrightRenderAdapter, createReportData, defaultConfig, derivePrototypingObligations, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, inferSurfaceFromRecommendationAndEvidence, isUiBearingSurface, isUiBearingSurfaceType, isValidPrototypingMode, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeAllowedModes, normalizeDecisionGuardrails, normalizePrototypingSurface, normalizeSurface, parseDiscussionFromObject, parseDiscussionModeRecommendation, parseDiscussionModeRecommendationWithWarnings, resolvePath, resolvePrototypingMode, resolvePrototypingModeFromInput, resolveToolVersion, runBrowserQaOrchestrated, runFullHarness, runPrototypingExecution, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, summarizeResolvedMode, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability, writeEvidenceBundles };
+export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type DiscussionModeRecommendation, type DiscussionRecommendationSourceSchema, type FailOn, type FullHarnessRequest, type FullHarnessResult, 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 ModeResolutionInput, type ModeResolutionResult, type ModeSelectionSource, type OrphanContractsPolicy, type OutputFormat, type ParseDiscussionResult, type PrototypingExecutionConfig, type PrototypingExecutionRequest, type PrototypingExecutionResult, type PrototypingMode, type PrototypingObligations, type PrototypingSurface, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type ResolveModeInput, type ResolvedModeSummary, type RunSddPreflightOptions, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TraceabilitySeverity, type UiFidelityStatus, VISUAL_BROWSER_SURFACES, 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, checkDecisionGuardrails, createPlaywrightBrowserQaProvider, createPlaywrightRenderAdapter, createReportData, defaultConfig, derivePrototypingObligations, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, inferSurfaceFromRecommendationAndEvidence, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isValidPrototypingMode, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeAllowedModes, normalizeDecisionGuardrails, normalizeSurface, parseDiscussionFromObject, parseDiscussionModeRecommendation, parseDiscussionModeRecommendationWithWarnings, requiresVisualBrowserEvidence, resolvePath, resolvePrototypingMode, resolvePrototypingModeFromInput, resolveToolVersion, runBrowserQaOrchestrated, runFullHarness, runPrototypingExecution, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, summarizeResolvedMode, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability, writeEvidenceBundles };

package/dist/index.d.ts

@@ -14,7 +14,7 @@ type TestFileScan = {
 };
 
 type IssueSeverity = "info" | "warning" | "error";
-type IssueCategory = "canonical" | "compatibility" | "change";
+type IssueCategory = "canonical" | "change";
 type IssueLocation = {
     line: number;
     column?: number;
@@ -142,9 +142,6 @@ type QfaiUiuxAuditConfig = {
     maxRawTokenLiteralWarnings?: number;
     maxDuplicateFindingsPerRule?: number;
 };
-type QfaiUiuxMigrationConfig = {
-    strict?: boolean;
-};
 type QfaiUiuxConfig = {
     platform?: string;
     designTokensDir?: string;
@@ -153,10 +150,8 @@ type QfaiUiuxConfig = {
     requireResearchSummary?: boolean;
     competitive_refs_min?: number;
     warning_as_error_override?: string[];
-    phase1ReleaseDate?: string;
     renderEvidence?: RenderEvidenceConfig;
     audit?: QfaiUiuxAuditConfig;
-    migration?: QfaiUiuxMigrationConfig;
 };
 type QfaiPrototypingCalibrationConfig = {
     packPath?: string;
@@ -322,12 +317,13 @@ declare function extractAcSpecNumber(acId: string): string | null;
 declare function extractCaseSpecNumber(caseId: string): string | null;
 declare function extractScSpecNumber(scId: string): string | null;
 
+declare const CANONICAL_PROTOTYPING_SURFACES: readonly ["web", "mobile", "desktop", "cli", "mixed"];
+type CanonicalPrototypingSurface = (typeof CANONICAL_PROTOTYPING_SURFACES)[number];
+
 type PrototypingMode = "low-cost" | "standard" | "full-harness";
 type ModeSelectionSource = "explicit-request" | "discussion-recommendation" | "system-default";
-type PrototypingSurface = "web" | "mobile" | "desktop" | "cli" | "mixed" | "non-ui";
-/** @deprecated Legacy surface values — use canonical PrototypingSurface instead */
-type LegacyPrototypingSurface = "web-ui" | "mobile-ui" | "desktop-ui";
-type DiscussionRecommendationSourceSchema = "canonical-namespaced" | "legacy-top-level";
+type PrototypingSurface = CanonicalPrototypingSurface;
+type DiscussionRecommendationSourceSchema = "canonical-namespaced";
 /**
  * Canonical validated recommendation — all 4 fields required.
  * Parser output uses this same type; fields are always populated
@@ -386,7 +382,7 @@ type ParseDiscussionResult = {
 };
 /**
  * Parse a prototyping.yaml file from a discussion pack.
- * Supports both canonical namespaced (`prototyping.*`) and legacy top-level schema.
+ * Supports only the canonical namespaced (`prototyping.*`) schema.
  */
 declare function parseDiscussionModeRecommendation(filePath: string): Promise<DiscussionModeRecommendation | null>;
 declare function parseDiscussionModeRecommendationWithWarnings(filePath: string): Promise<ParseDiscussionResult>;
@@ -409,18 +405,13 @@ declare function inferSurfaceFromRecommendationAndEvidence(input: {
     hasBrowserQaBundle?: boolean | undefined;
     hasUiRoutes?: boolean | undefined;
     hasRuntimeGateUi?: boolean | undefined;
-}): PrototypingSurface;
+}): PrototypingSurface | null;
 declare function derivePrototypingObligations(input: {
     surface: PrototypingSurface;
     effectiveMode: PrototypingMode;
 }): PrototypingObligations;
 declare function isValidPrototypingMode(value: unknown): value is PrototypingMode;
 declare function isValidPrototypingSurface(value: unknown): value is PrototypingSurface;
-/**
- * Normalize a surface value: map legacy values to canonical equivalents.
- */
-declare function normalizePrototypingSurface(value: string): PrototypingSurface;
-declare function isUiBearingSurface(surface: PrototypingSurface): boolean;
 declare function normalizeAllowedModes(modes?: string[]): PrototypingMode[];
 
 /**
@@ -509,40 +500,44 @@ declare class CritiqueAdapter {
     requestCritique(input: CritiqueInput): Promise<CritiqueResult>;
 }
 
-type SurfaceType = "web" | "mobile" | "desktop" | "cli" | "mixed" | "non-ui";
-/** Surfaces that bear a user interface — canonical truth for UI-bearing detection. */
-declare const UI_BEARING_SURFACES: Set<SurfaceType>;
-/** Surfaces that do NOT bear a user interface. */
-declare const NON_UI_SURFACES: Set<SurfaceType>;
-/**
- * Synchronous check: given a SurfaceType value, returns true if UI-bearing.
- * Canonical shared helper for classification validator and prototyping mode.
- */
-declare function isUiBearingSurfaceType(surface: SurfaceType): boolean;
-
-/**
- * Browser QA canonical types — WS-B
- *
- * Defines the 4-phase execution model with truthful status reporting.
- */
+type SurfaceType = CanonicalPrototypingSurface | "non-ui";
+declare const DISCUSSION_UI_BEARING_SURFACES: Set<SurfaceType>;
+declare const DISCUSSION_NON_UI_SURFACES: Set<SurfaceType>;
+declare const VISUAL_BROWSER_SURFACES: Set<SurfaceType>;
+declare function isDiscussionUiBearingSurfaceType(surface: SurfaceType): boolean;
+declare function isNonUiDiscussionSurface(surface: SurfaceType): boolean;
+declare function requiresVisualBrowserEvidence(surface: SurfaceType): boolean;
 
 type BrowserQaPhase = "smoke" | "interaction" | "visual" | "accessibility";
 declare const BROWSER_QA_PHASES: readonly BrowserQaPhase[];
-type BrowserQaPhaseStatus = "executed" | "skipped" | "failed";
-type BrowserQaFindingSeverity = "info" | "warning" | "error";
-type BrowserQaFinding = {
+type BrowserQaPhaseStatus = "passed" | "executed" | "failed" | "skipped";
+type BrowserQaFindingSeverity = "info" | "warn" | "warning" | "error";
+interface BrowserQaFinding {
     phase: BrowserQaPhase;
-    route?: string;
-    selector?: string;
-    target?: string;
     severity: BrowserQaFindingSeverity;
-    message: string;
+    summary: string;
+    detail: string;
+    screen_id?: string;
+    selector?: string;
+    evidence_refs: string[];
+    repair_suggestions: string[];
+    category?: BrowserQaPhase;
+    message?: string;
+    route?: string;
     repair_hint?: string;
+}
+type BrowserQaScreenContractRef = {
+    screen_id: string;
+    route?: string;
+    primary_tasks?: string[];
 };
 type BrowserQaPhaseResult = {
     phase: BrowserQaPhase;
     status: BrowserQaPhaseStatus;
     findings: BrowserQaFinding[];
+    repair_suggestions: string[];
+    evidence_refs: string[];
+    checks_performed: string[];
     skippedReason?: string;
 };
 type BrowserQaInput = {
@@ -552,6 +547,7 @@ type BrowserQaInput = {
     surface: SurfaceType;
     required?: boolean;
     executionSource?: "html" | "url" | "none";
+    screenContracts?: BrowserQaScreenContractRef[];
 };
 type BrowserQaRunResult = {
     phases: BrowserQaPhaseResult[];
@@ -563,8 +559,12 @@ type BrowserQaSummary = {
     phases: Record<BrowserQaPhase, {
         status: BrowserQaPhaseStatus;
         findingsCount: number;
+        checksCount: number;
+        passed?: number;
+        failed?: number;
     }>;
     totalFindings: number;
+    totalRepairs: number;
     skippedReasons: string[];
 };
 interface BrowserQaProvider {
@@ -583,11 +583,11 @@ interface BrowserQaProvider {
  * absence is a valid state with fail-open semantics.
  *
  * WS-B: BrowserQaProvider is the canonical interface for 4-phase Browser QA.
- * BrowserProvider is the legacy render-capture provider interface.
+ * BrowserProvider defines the browser QA and capture provider interface.
  */
 
 type ProviderCapability = "screenshot" | "viewport" | "dom" | "interaction" | "visual" | "accessibility";
-/** Legacy render-capture provider. */
+/** Browser QA and capture provider. */
 type BrowserProvider = {
     name: string;
     capabilities: ProviderCapability[];
@@ -917,8 +917,11 @@ type ReportPrototypingSummary = {
             totalFailed: number;
         };
         phaseSummary?: Record<string, {
-            passed: number;
-            failed: number;
+            status: string;
+            findingsCount: number;
+            checksCount: number;
+            passed?: number;
+            failed?: number;
         }>;
         modeMismatch?: boolean;
     };
@@ -980,24 +983,7 @@ declare function validateSpecSplitByCapability(root: string, config: QfaiConfig)
 
 declare function validateTraceability(root: string, config: QfaiConfig, phase: ValidationPhase): Promise<Issue[]>;
 
-/**
- * Browser QA runner — WS-B
- *
- * Orchestrates the canonical 4-phase Browser QA execution model.
- * Provider resolution → phase execution → truthful skip/fail handling.
- */
-
-/**
- * Run the canonical 4-phase Browser QA.
- *
- * - provider resolved → delegate to provider methods
- * - no provider → use built-in static analysis phases
- * - non-ui surface → all phases skipped
- */
 declare function runBrowserQaOrchestrated(input: BrowserQaInput, provider?: BrowserQaProvider): Promise<BrowserQaRunResult>;
-/**
- * Summarize a BrowserQaRunResult for report output.
- */
 declare function summarizeBrowserQaResult(result: BrowserQaRunResult): BrowserQaSummary;
 
 /**
@@ -1018,6 +1004,25 @@ declare function runRenderCapture(targets: RenderCaptureTarget[], outputDir: str
     required?: boolean;
 }): Promise<RenderRunnerResult>;
 
+interface FakeUiDetectionResult {
+    detected: boolean;
+    reasons: string[];
+    evidence_refs: string[];
+    confidence: "low" | "medium" | "high";
+}
+
+declare const FULL_HARNESS_EXIT_REASONS: readonly ["quality-threshold-met", "plateau", "budget-exhausted", "fake-ui-detected", "runtime-failure", "human-review-required"];
+type FullHarnessExitReason = (typeof FULL_HARNESS_EXIT_REASONS)[number];
+
+type FullHarnessHandoff = {
+    selected_build: string;
+    artifact_refs: string[];
+    outstanding_issues: string[];
+    required_human_review_points: string[];
+    exit_reason: FullHarnessExitReason;
+    next_recommended_action: string;
+};
+
 type PrototypingSummaryBundle = {
     surface: PrototypingSurface;
     specs: Array<{
@@ -1105,6 +1110,11 @@ declare function writeEvidenceBundles(input: {
         mode: PrototypingMode;
     };
     prototyping: PrototypingSummaryBundle;
+    fullHarnessArtifacts?: {
+        fakeUiDetection: FakeUiDetectionResult;
+        handoff: FullHarnessHandoff;
+        exitReason: FullHarnessExitReason;
+    };
 }): Promise<{
     prototypingPath: string;
     renderPath: string;
@@ -1288,6 +1298,9 @@ type FullHarnessResult = {
     output: FullHarnessOutput;
     evidence: ReturnType<typeof generateEvidence>;
     reviewSummary: ReturnType<typeof generateReviewSummary>;
+    fakeUiDetection: FakeUiDetectionResult;
+    exitReason: FullHarnessExitReason;
+    handoff: FullHarnessHandoff;
 };
 /**
  * Run the full-harness mode.
@@ -1306,4 +1319,4 @@ declare function createPlaywrightRenderAdapter(input: {
 
 declare function createPlaywrightBrowserQaProvider(): BrowserQaProvider;
 
-export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, type DecisionGuardrail, type DecisionGuardrailEntry, type DiscussionModeRecommendation, type DiscussionRecommendationSourceSchema, type FailOn, type FullHarnessRequest, type FullHarnessResult, 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 LegacyPrototypingSurface, type ModeResolutionInput, type ModeResolutionResult, type ModeSelectionSource, NON_UI_SURFACES, type OrphanContractsPolicy, type OutputFormat, type ParseDiscussionResult, type PrototypingExecutionConfig, type PrototypingExecutionRequest, type PrototypingExecutionResult, type PrototypingMode, type PrototypingObligations, type PrototypingSurface, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiUiuxMigrationConfig, type QfaiValidationConfig, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type ResolveModeInput, type ResolvedModeSummary, type RunSddPreflightOptions, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TraceabilitySeverity, UI_BEARING_SURFACES, type UiFidelityStatus, 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, checkDecisionGuardrails, createPlaywrightBrowserQaProvider, createPlaywrightRenderAdapter, createReportData, defaultConfig, derivePrototypingObligations, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, inferSurfaceFromRecommendationAndEvidence, isUiBearingSurface, isUiBearingSurfaceType, isValidPrototypingMode, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeAllowedModes, normalizeDecisionGuardrails, normalizePrototypingSurface, normalizeSurface, parseDiscussionFromObject, parseDiscussionModeRecommendation, parseDiscussionModeRecommendationWithWarnings, resolvePath, resolvePrototypingMode, resolvePrototypingModeFromInput, resolveToolVersion, runBrowserQaOrchestrated, runFullHarness, runPrototypingExecution, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, summarizeResolvedMode, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability, writeEvidenceBundles };
+export { type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type DiscussionModeRecommendation, type DiscussionRecommendationSourceSchema, type FailOn, type FullHarnessRequest, type FullHarnessResult, 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 ModeResolutionInput, type ModeResolutionResult, type ModeSelectionSource, type OrphanContractsPolicy, type OutputFormat, type ParseDiscussionResult, type PrototypingExecutionConfig, type PrototypingExecutionRequest, type PrototypingExecutionResult, type PrototypingMode, type PrototypingObligations, type PrototypingSurface, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type ResolveModeInput, type ResolvedModeSummary, type RunSddPreflightOptions, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TraceabilitySeverity, type UiFidelityStatus, VISUAL_BROWSER_SURFACES, 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, checkDecisionGuardrails, createPlaywrightBrowserQaProvider, createPlaywrightRenderAdapter, createReportData, defaultConfig, derivePrototypingObligations, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, inferSurfaceFromRecommendationAndEvidence, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isValidPrototypingMode, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeAllowedModes, normalizeDecisionGuardrails, normalizeSurface, parseDiscussionFromObject, parseDiscussionModeRecommendation, parseDiscussionModeRecommendationWithWarnings, requiresVisualBrowserEvidence, resolvePath, resolvePrototypingMode, resolvePrototypingModeFromInput, resolveToolVersion, runBrowserQaOrchestrated, runFullHarness, runPrototypingExecution, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, summarizeResolvedMode, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability, writeEvidenceBundles };