qfai 1.7.13 → 1.7.15

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,20 +150,11 @@ 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;
-    thresholds?: {
-        accept?: number;
-        refine?: number;
-    };
-    maxIterations?: number;
-    plateauDelta?: number;
-    plateauLookback?: number;
 };
 type QfaiPrototypingConfig = {
     calibration?: QfaiPrototypingCalibrationConfig;
@@ -174,7 +162,6 @@ type QfaiPrototypingConfig = {
         targetUrl?: string | null;
         browserProvider?: string;
         renderProvider?: string;
-        reviewer?: string;
     };
 };
 type QfaiConfig = {
@@ -322,12 +309,13 @@ declare function extractAcSpecNumber(acId: string): string | null;
 declare function extractCaseSpecNumber(caseId: string): string | null;
 declare function extractScSpecNumber(scId: string): string | null;
 
-type PrototypingMode = "low-cost" | "standard" | "full-harness";
+declare const CANONICAL_PROTOTYPING_SURFACES: readonly ["web", "mobile", "desktop", "cli", "mixed"];
+type CanonicalPrototypingSurface = (typeof CANONICAL_PROTOTYPING_SURFACES)[number];
+
+type PrototypingMode = "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
@@ -363,6 +351,9 @@ type PrototypingObligations = {
     requireRenderBundle: boolean;
     requireBrowserQaBundle: boolean;
     requireFullHarness: boolean;
+    validCombination: boolean;
+    invalidReasonCode?: string | undefined;
+    invalidReason?: string | undefined;
 };
 type ResolveModeInput = {
     requested?: PrototypingMode | undefined;
@@ -376,17 +367,22 @@ type PrototypingExecutionConfig = {
 };
 type UiFidelityStatus = {
     required: boolean;
-    status: "completed" | "failed" | "n/a";
+    status: "completed" | "failed" | "insufficient-evidence" | "n/a";
     reason?: string;
 };
 
+declare const FULL_HARNESS_INVALID_COMBINATION_MESSAGE = "packages/qfai v1.7.15 \u3067\u306F prototyping \u306F full-harness / UI-only \u3067\u3059\u3002";
+declare const UNSUPPORTED_PROTOTYPING_MODE_REASON_CODE = "unsupported_prototyping_mode";
+declare const UNSUPPORTED_PROTOTYPING_MODE_MESSAGE = "packages/qfai v1.7.15 \u3067\u306F prototyping \u306F full-harness \u306E\u307F\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002";
+declare const NON_UI_PROTOTYPING_SURFACE_REASON_CODE = "unsupported_non_ui_prototyping_surface";
+declare const NON_UI_PROTOTYPING_SURFACE_MESSAGE = "packages/qfai v1.7.15 \u3067\u306F prototyping \u306F UI-bearing surface \u306E\u307F\u30B5\u30DD\u30FC\u30C8\u3057\u307E\u3059\u3002";
 type ParseDiscussionResult = {
     recommendation: DiscussionModeRecommendation | null;
     warnings: string[];
 };
 /**
  * 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;
+    effectiveMode: string;
 }): 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[];
 
 /**
@@ -463,87 +454,47 @@ type RenderRunnerResult = {
     };
 };
 
-/**
- * Critique adapter types for external critique providers.
- *
- * Provider interface is minimal (BR-0029-0001). Each provider implements
- * `request()` and the adapter wraps it with fail-open semantics (NFR-0002).
- */
-type CritiqueInput = {
-    output: string;
-    context: string;
-    iteration: number;
-};
-type CritiqueResponse = {
-    scores: Record<string, number>;
-    dimensions: string[];
-    suggestions: string[];
-};
-type CritiqueProvider = {
-    name: string;
-    request: (input: CritiqueInput, signal?: AbortSignal) => Promise<CritiqueResponse>;
-};
-type CritiqueResult = {
-    failOpen: false;
-    response: CritiqueResponse;
-} | {
-    failOpen: true;
-    response: undefined;
-    reason: string;
-};
-
-/**
- * Critique adapter with fail-open semantics (NFR-0002).
- *
- * Wraps external critique providers with schema validation,
- * timeout enforcement, and fail-open on any error.
- */
-
-declare class CritiqueAdapter {
-    private provider;
-    private timeoutMs;
-    constructor(options?: {
-        timeoutMs?: number;
-    });
-    register(provider: CritiqueProvider): void;
-    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;
+    screen_id?: string;
+    route?: string;
 };
 type BrowserQaInput = {
     htmlContent?: string;
@@ -552,19 +503,24 @@ type BrowserQaInput = {
     surface: SurfaceType;
     required?: boolean;
     executionSource?: "html" | "url" | "none";
+    screenContracts?: BrowserQaScreenContractRef[];
 };
 type BrowserQaRunResult = {
     phases: BrowserQaPhaseResult[];
     provider: string;
     timestamp: string;
 };
-type BrowserQaSummary = {
+type BrowserQaSummary$1 = {
     providerId: string;
     phases: Record<BrowserQaPhase, {
         status: BrowserQaPhaseStatus;
         findingsCount: number;
+        checksCount: number;
+        passed?: number;
+        failed?: number;
     }>;
     totalFindings: number;
+    totalRepairs: number;
     skippedReasons: string[];
 };
 interface BrowserQaProvider {
@@ -583,11 +539,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[];
@@ -637,10 +593,11 @@ type PrototypingExecutionRequest = {
     providerRegistry?: ProviderRegistry;
     renderAdapter?: RenderCaptureAdapter;
     browserQaProviderId?: string;
-    critiqueAdapter?: CritiqueAdapter;
     renderProviderId?: string;
     targetUrl?: string;
     reviewer?: string;
+    changeSummary?: string[];
+    limitations?: string[];
 };
 type PrototypingExecutionResult = {
     mode: PrototypingMode;
@@ -890,13 +847,24 @@ type ReportPrototypingSummary = {
     };
     fullHarness?: {
         enabled: boolean;
-        available?: boolean;
         runId?: string;
+        calibrationRef?: {
+            configPath: string;
+            packPath: string;
+            packVersion: string;
+        };
         iterationCount?: number;
         bestIteration?: number;
+        status?: string;
         terminationReason?: string;
+        reviewerId?: string;
         reviewerSignoffStatus?: string;
         scoringTraceCount?: number;
+        latestWeightedTotal?: number;
+        latestL1Total?: number;
+        latestL2Total?: number;
+        limitations?: string[];
+        reviewerLogsCount?: number;
     };
     render?: {
         status?: string;
@@ -917,8 +885,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,25 +951,8 @@ 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;
+declare function summarizeBrowserQaResult(result: BrowserQaRunResult): BrowserQaSummary$1;
 
 /**
  * Render runner — WS-C
@@ -1018,6 +972,155 @@ 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;
+};
+
+/**
+ * Calibration pack types for harness scoring alignment.
+ *
+ * Calibration packs are file-based YAML assets (SD-0030-003)
+ * containing scoring alignment examples and threshold configuration.
+ */
+type AlignmentExample = {
+    input: string;
+    expectedScore: number;
+    rationale: string;
+};
+type CalibrationOverrides = {
+    perAxisMinimum?: number;
+    maxIterationsByMode?: Record<string, number>;
+};
+type CalibrationPack = {
+    version: string;
+    examples: AlignmentExample[];
+    thresholds: ThresholdConfig;
+    maxIterations: number;
+    plateauDelta: number;
+    plateauLookback: number;
+    overrides?: CalibrationOverrides;
+};
+type ThresholdConfig = {
+    accept: number;
+    refine: number;
+};
+type Decision = "accept" | "refine" | "reject";
+
+/**
+ * Full-harness mode types — v1.7.15 measurement-driven model.
+ *
+ * Each iteration is a real observation of code state.
+ * No planner/generator/evaluator loop.
+ */
+
+type FullHarnessPanelScore = {
+    panel: "L1" | "L2";
+    total: number;
+    degradedScoring?: boolean;
+    axes: Array<{
+        axisId: string;
+        score: number;
+        rationale: string;
+        evidenceRefs: string[];
+    }>;
+};
+type FullHarnessIteration = {
+    iteration: number;
+    commitSha: string;
+    reviewerId: string;
+    timestamp: string;
+    changeSummary: string[];
+    limitations: string[];
+    evidenceRefs: {
+        render: string[];
+        browserQa: string[];
+        runtimeGate: string[];
+        uiObservation: string[];
+        specCoverage: string[];
+        discussion: string[];
+        screenContract: string[];
+        trend: string[];
+    };
+    l1: FullHarnessPanelScore;
+    l2: FullHarnessPanelScore;
+    weightedTotal: number;
+    deltaFromPrevious: number | null;
+    decision: Decision;
+};
+type TerminationReason = "converged" | "max-iterations" | "plateau" | "manual-stop";
+type FinalDecision = "pending" | "accepted" | "rejected" | "abandoned";
+type ReviewerSignoffStatus = "pending" | "approved" | "rejected" | "abandoned";
+type ReviewerLogVerdict = "approve" | "revise" | "reject" | "abandon";
+type FullHarnessHistory = {
+    runId: string;
+    iterations: FullHarnessIteration[];
+    bestIteration: number;
+    terminationReason?: TerminationReason;
+    scoringTrace: Array<{
+        iteration: number;
+        l1Total: number;
+        l2Total: number;
+        weightedTotal: number;
+        deltaFromPrevious: number | null;
+        decision: Decision;
+        commitSha: string;
+    }>;
+};
+type MeasurementInput = {
+    root: string;
+    reviewer: string;
+    changeSummary: string[];
+    limitations: string[];
+    calibration: {
+        packPath: string;
+        thresholds: {
+            accept: number;
+            refine: number;
+        };
+        maxIterations: number;
+        plateauDelta: number;
+        plateauLookback: number;
+    };
+    renderRefs: string[];
+    browserQaRefs: string[];
+    runtimeGateRefs: string[];
+    uiObservationRefs: string[];
+    specCoverageRefs: string[];
+    discussionRefs: string[];
+    screenContractRefs: string[];
+    discussionDirRelative?: string;
+    trendRefs: string[];
+    l1: FullHarnessPanelScore;
+    l2: FullHarnessPanelScore;
+};
+type MeasurementResult = {
+    iteration: FullHarnessIteration;
+    history: FullHarnessHistory;
+    terminationReason: TerminationReason | undefined;
+    isTerminal: boolean;
+};
+type FullHarnessCalibrationRef = {
+    configPath: string;
+    packPath: string;
+    packVersion: string;
+};
+declare const REVIEWER_PLACEHOLDERS: string[];
+
 type PrototypingSummaryBundle = {
     surface: PrototypingSurface;
     specs: Array<{
@@ -1037,6 +1140,11 @@ type PrototypingSummaryBundle = {
             apiEndpoints: string[];
             dbObjects: string[];
         };
+        coverageRefs?: Array<{
+            route: string;
+            declaredRef: string;
+            observedRefs: string[];
+        }>;
     }>;
     mode: {
         requested?: PrototypingMode;
@@ -1054,20 +1162,23 @@ type PrototypingSummaryBundle = {
     };
     uiFidelityStatus?: {
         required: boolean;
-        status: "completed" | "failed" | "n/a";
+        status: "completed" | "failed" | "insufficient-evidence" | "n/a";
         reason?: string;
     };
     missingRequiredEvidence?: string[];
     runtimeGate?: {
         ui: Array<{
+            screenId: string;
             route: string;
-            status: number;
-        }>;
-        api: Array<{
-            method: string;
-            path: string;
-            status: number;
+            declaredRef: string;
+            url?: string;
+            rendered: boolean;
+            browserVisited: boolean;
+            httpStatus?: number;
+            renderEvidenceRefs: string[];
+            browserQaEvidenceRefs: string[];
         }>;
+        evidenceRefs: string[];
     };
     uiFidelity?: {
         mode: "interactive" | "skeleton";
@@ -1075,21 +1186,37 @@ type PrototypingSummaryBundle = {
     };
     fullHarness?: {
         enabled: true;
-        available: boolean;
         runId: string;
+        calibrationRef: FullHarnessCalibrationRef;
         iterationCount: number;
         bestIteration: number;
-        terminationReason: string;
+        status: "in-progress" | "completed";
+        terminationReason?: TerminationReason;
+        finalDecision: FinalDecision;
         reviewerSignoff: {
-            status: string;
-            reviewer: string;
-            timestamp: string;
+            reviewerId: string;
+            status: ReviewerSignoffStatus;
+            timestamp?: string;
+            source: "cli";
         };
+        reviewerLogs: Array<{
+            iteration: number;
+            reviewerId: string;
+            verdict: ReviewerLogVerdict;
+            summary: string;
+            evidenceRefs: string[];
+        }>;
+        iterations: FullHarnessIteration[];
         scoringTrace: Array<{
             iteration: number;
+            l1Total: number;
+            l2Total: number;
             weightedTotal: number;
-            decision: string;
+            deltaFromPrevious: number | null;
+            decision: "accept" | "refine" | "reject";
+            commitSha: string;
         }>;
+        limitations: string[];
     };
 };
 declare function writeEvidenceBundles(input: {
@@ -1105,98 +1232,17 @@ declare function writeEvidenceBundles(input: {
         mode: PrototypingMode;
     };
     prototyping: PrototypingSummaryBundle;
+    fullHarnessArtifacts?: {
+        fakeUiDetection: FakeUiDetectionResult;
+        handoff: FullHarnessHandoff;
+        exitReason: FullHarnessExitReason;
+    };
 }): Promise<{
     prototypingPath: string;
     renderPath: string;
     browserQaPath: string;
 }>;
 
-type ThresholdConfig = {
-    accept: number;
-    refine: number;
-};
-type Decision = "accept" | "refine" | "pivot";
-
-/**
- * Full-harness mode types.
- *
- * Defines the planner/generator/evaluator loop interfaces
- * and evidence structures for /qfai-prototyping full-harness mode.
- */
-
-type HarnessConfig = {
-    maxIterations: number;
-    thresholds: ThresholdConfig;
-    dimensionWeights?: Record<string, number> | undefined;
-    dimensionFloors?: Record<string, number> | undefined;
-    plateauDelta?: number | undefined;
-    plateauLookback?: number | undefined;
-};
-type PlannerStrategy = {
-    approach: string;
-    constraints: string[];
-    budgetGuidance: string;
-};
-type GeneratorOutput = {
-    content: string;
-    metadata?: Record<string, unknown> | undefined;
-};
-type DimensionScore = {
-    dimension: string;
-    score: number;
-    weight: number;
-    floor?: number | undefined;
-};
-type EvaluatorResult = {
-    decision: Decision;
-    weightedTotal: number;
-    dimensionScores: DimensionScore[];
-    feedback?: string | undefined;
-    pivotContext?: string | undefined;
-};
-type IterationRecord = {
-    iteration: number;
-    plannerStrategy?: PlannerStrategy | undefined;
-    generatorOutput: GeneratorOutput;
-    evaluatorResult: EvaluatorResult;
-    critiqueResult?: CritiqueResult | undefined;
-};
-type LoopStatus = "converged" | "max-iterations" | "plateau";
-type LoopResult = {
-    status: LoopStatus;
-    finalOutput: GeneratorOutput;
-    finalScore: number;
-    terminationReason: LoopStatus;
-    iterationCount: number;
-    iterations: IterationRecord[];
-    bestIteration: number;
-};
-type HarnessEvidence = {
-    runId: string;
-    timestamp: string;
-    status: LoopStatus;
-    iterationCount: number;
-    finalScore: number;
-    terminationReason: LoopStatus;
-    iterations: IterationRecord[];
-    bestIteration: number;
-};
-type ReviewSummary = {
-    finalScore: number;
-    recommendation: string;
-    iterationSummary: Array<{
-        iteration: number;
-        score: number;
-        decision: Decision;
-    }>;
-};
-type SpecInputs = {
-    specId: string;
-    requirements: string[];
-    constraints?: string[] | undefined;
-    calibrationPackPath?: string | undefined;
-};
-
 /**
  * Harness adapters — WS-D
  *
@@ -1221,89 +1267,233 @@ type HarnessObservabilityAdapter = {
 };
 type FullHarnessAdapters = {
     surface: SurfaceType;
-    render?: HarnessRenderAdapter;
-    browserQa?: HarnessBrowserQaAdapter;
+    render: HarnessRenderAdapter;
+    browserQa: HarnessBrowserQaAdapter;
     observability?: HarnessObservabilityAdapter;
 };
 
 /**
- * Harness result writer — WS-D
+ * Panel scoring input DTO — v1.7.15
  *
- * Writes full-harness execution results to a structured output.
+ * Separates evidence collection from scoring logic.
+ * Every field is required; missing evidence is a MeasurementError.
+ * v1.7.15: screen-level observation, L2 evidence refs required, fail-closed.
  */
-
-type FullHarnessOutput = {
-    mode: "full-harness";
-    iterations: number;
-    terminationReason: string;
-    evaluationSummary: {
-        finalScore: number;
-        bestIteration: number;
-        decision: string;
-    };
-    evidenceSummary: {
-        renderCaptured: number;
-        renderSkipped: number;
-        renderFailed: number;
+type RuntimeGateEvidence = {
+    uiRoutes: Array<{
+        screenId: string;
+        route: string;
+        url?: string;
+        rendered: boolean;
+        browserVisited: boolean;
+        httpStatus?: number;
+        renderEvidenceRefs: string[];
+        browserQaEvidenceRefs: string[];
+    }>;
+    evidenceRefs: string[];
+};
+type RenderEvidenceSummary = {
+    totalScreens: number;
+    capturedScreens: number;
+    failedScreens: number;
+    viewports: string[];
+    evidenceRefs: string[];
+};
+type BrowserQaSummary = {
+    executed: boolean;
+    blockingFindings: number;
+    experienceFindings: number;
+    visualFindings: number;
+    totalFindings: number;
+    phasesExecuted: string[];
+    evidenceRefs: string[];
+};
+type ScreenObservation = {
+    screenId: string;
+    route: string;
+    htmlCaptureRef: string;
+    domLabelsFound: string[];
+    elementsPlaced: number;
+    actionsDeclared?: number;
+    actionsObserved?: number;
+    actionsWired: number;
+    missingActions?: string[];
+    mockPathFindings: Array<{
+        id: string;
+        status: "fail" | "finding";
+    }>;
+    browserQaEvidenceRefs: string[];
+    browserQaObserved: boolean;
+    evidenceMissing?: boolean;
+};
+type UiObservationSummary = {
+    screens: ScreenObservation[];
+    evidenceRefs: string[];
+};
+type SpecCoverageSummary = {
+    declared: {
+        uiRoutes: number;
     };
-    browserQaSummary: {
-        phasesExecuted: number;
-        phasesFailed: number;
-        phasesSkipped: number;
-        totalFindings: number;
+    checked: {
+        uiOk: number;
     };
-    calibrationSummary: {
-        thresholds: {
-            accept: number;
-            refine: number;
-        };
+    missing: {
+        uiRoutes: string[];
     };
-    observabilityRefs: string[];
+    evidenceRefs: string[];
+};
+type DiscussionAxisInputs = {
+    invariantAxes: number;
+    trendDerivedAxes: number;
+    productSpecificAxes: number;
+    aggregateScore: number;
+    evidenceRefs: string[];
+    degradedScoring?: boolean;
+};
+type ScreenContractInputs = {
+    totalContracts: number;
+    coveredContracts: number;
+    fidelityScore: number;
+    evidenceRefs: string[];
+    degradedScoring?: boolean;
+};
+type TrendAlignmentInputs = {
+    trendSourcesChecked: number;
+    translationConsistency: number;
+    competitiveGapsCovered: number;
+    evidenceRefs: string[];
+    degradedScoring?: boolean;
+};
+type FullHarnessPanelInputs = {
+    runtimeGate: RuntimeGateEvidence;
+    renderEvidence: RenderEvidenceSummary;
+    browserQa: BrowserQaSummary;
+    uiObservation: UiObservationSummary;
+    specCoverage: SpecCoverageSummary;
+    discussionAxes: DiscussionAxisInputs;
+    screenContract: ScreenContractInputs;
+    trendAlignment: TrendAlignmentInputs;
 };
 
 /**
- * Harness evidence generator — creates structured evidence and review
- * summaries from loop results.
- */
-
-declare function generateEvidence(result: LoopResult, runId?: string): HarnessEvidence;
-declare function generateReviewSummary(result: LoopResult): ReviewSummary;
-
-/**
- * Full-harness runtime — WS-D
+ * Full-harness runtime — v1.7.15
+ *
+ * Measurement-driven orchestration.
+ * Does NOT contain a self-modifying loop.
+ * Each CLI invocation records exactly one iteration of real observation.
  *
- * Production-path entry point for `mode=full-harness`.
- * Orchestrates the planner → generator → evaluator loop with
- * render evidence, Browser QA, critique, and observability.
+ * v1.7.15 breaking changes:
+ * - Panel scores computed from real evidence (no dummy l1/l2=0)
+ * - calibration pack required (no silent fallback)
+ * - reviewer required (no placeholder)
+ * - commitSha required (no silent failure)
  */
 
 type FullHarnessRequest = {
-    inputs: SpecInputs;
-    config?: Partial<HarnessConfig>;
-    adapters?: FullHarnessAdapters;
-    critiqueAdapter?: CritiqueAdapter;
+    root: string;
+    reviewer: string;
+    changeSummary: string[];
+    limitations: string[];
+    discussionDirRelative?: string;
+    calibrationPack: CalibrationPack;
+    calibrationRef: {
+        packPath: string;
+        packVersion: string;
+        configPath?: string;
+    };
+    adapters: FullHarnessAdapters;
+    screenContracts: Array<{
+        screenId: string;
+        route: string;
+    }>;
+    panelInputs: FullHarnessPanelInputs;
 };
 type FullHarnessResult = {
-    loopResult: LoopResult;
-    output: FullHarnessOutput;
-    evidence: ReturnType<typeof generateEvidence>;
-    reviewSummary: ReturnType<typeof generateReviewSummary>;
+    iteration: FullHarnessIteration;
+    history: FullHarnessHistory;
+    calibrationRef: FullHarnessCalibrationRef;
+    fakeUiDetection: FakeUiDetectionResult;
+    exitReason: FullHarnessExitReason;
+    handoff: FullHarnessHandoff;
+    terminationReason: TerminationReason | undefined;
+    isTerminal: boolean;
+    finalDecision: FinalDecision;
+    signoffStatus: ReviewerSignoffStatus;
+    logVerdict: ReviewerLogVerdict;
 };
 /**
- * Run the full-harness mode.
+ * Run a single full-harness measurement iteration.
  *
- * Termination policy:
- * - `accept` reached → exit
- * - `max_iterations` reached → exit
- * - plateau detected → exit
- * - hard execution failure → throw
+ * This does NOT loop. Each invocation:
+ * 1. Captures render/browserQa evidence
+ * 2. Scores panels from real evidence inputs
+ * 3. Appends iteration to history
+ * 4. Computes termination
  */
 declare function runFullHarness(request: FullHarnessRequest): Promise<FullHarnessResult>;
 
+/**
+ * Panel scoring — v1.7.15
+ *
+ * L1 = implementation fidelity panel (runtime gate, render, browser QA blocking, screen contract, spec coverage)
+ * L2 = product experience panel (discussion axes, screen contract fidelity, trend, visual, browser QA experience)
+ * weightedTotal = min(L1.total, L2.total)
+ *
+ * Scores are computed from real evidence inputs only.
+ * Pre-scored metadata.dimensionScores flow-through is prohibited.
+ */
+
+declare function computeWeightedTotal(l1: FullHarnessPanelScore, l2: FullHarnessPanelScore): number;
+declare function determineDecision(weightedTotal: number, thresholds: {
+    accept: number;
+    refine: number;
+}): Decision;
+
+/**
+ * Iteration history management — v1.7.15
+ *
+ * Reads previous iterations from prototyping.json,
+ * appends new iteration, recomputes bestIteration/scoringTrace/terminationReason.
+ */
+
+declare function loadHistory(root: string): Promise<FullHarnessHistory | null>;
+declare function appendIteration(history: FullHarnessHistory | null, iteration: FullHarnessIteration): FullHarnessHistory;
+declare function computeTerminationReason(history: FullHarnessHistory, calibration: {
+    maxIterations: number;
+    plateauDelta: number;
+    plateauLookback: number;
+    thresholds: {
+        accept: number;
+    };
+}): TerminationReason | undefined;
+
+/**
+ * Reviewer identity validation — v1.7.15
+ *
+ * CLI --reviewer is mandatory for full-harness.
+ * Placeholders are rejected.
+ */
+declare function validateReviewer(reviewer: string | undefined): string;
+
+/**
+ * Git revision resolution — v1.7.15
+ *
+ * Resolves current commit SHA from `.git/HEAD`, with support for:
+ *   - Standard `.git/` directory layouts
+ *   - Linked worktrees (where `.git` is a file containing `gitdir: <path>`
+ *     and the worktree gitdir has a `commondir` file pointing at the main
+ *     repository's `.git` directory; `refs/heads/*` and `packed-refs` live
+ *     in that common gitdir, not the worktree-local gitdir)
+ *   - `packed-refs` fallback when the loose ref file is absent
+ *
+ * Full-harness requires commitSha on every iteration.
+ */
+declare function resolveCommitSha(root: string): Promise<string>;
+
 declare function createPlaywrightRenderAdapter(input: {
     targetUrl?: string;
 }): RenderCaptureAdapter;
 
 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, FULL_HARNESS_INVALID_COMBINATION_MESSAGE, type FailOn, type FullHarnessCalibrationRef, type FullHarnessHistory, type FullHarnessIteration, type FullHarnessPanelScore, 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 MeasurementInput, type MeasurementResult, type ModeResolutionInput, type ModeResolutionResult, type ModeSelectionSource, NON_UI_PROTOTYPING_SURFACE_MESSAGE, NON_UI_PROTOTYPING_SURFACE_REASON_CODE, 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, REVIEWER_PLACEHOLDERS, 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 TerminationReason, type TraceabilitySeverity, UNSUPPORTED_PROTOTYPING_MODE_MESSAGE, UNSUPPORTED_PROTOTYPING_MODE_REASON_CODE, 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, appendIteration, checkDecisionGuardrails, computeTerminationReason, computeWeightedTotal, createPlaywrightBrowserQaProvider, createPlaywrightRenderAdapter, createReportData, defaultConfig, derivePrototypingObligations, determineDecision, 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, loadHistory, normalizeAllowedModes, normalizeDecisionGuardrails, normalizeSurface, parseDiscussionFromObject, parseDiscussionModeRecommendation, parseDiscussionModeRecommendationWithWarnings, requiresVisualBrowserEvidence, resolveCommitSha, resolvePath, resolvePrototypingMode, resolvePrototypingModeFromInput, resolveToolVersion, runBrowserQaOrchestrated, runFullHarness, runPrototypingExecution, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, summarizeResolvedMode, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateReviewer, validateSpecSplitByCapability, validateTraceability, writeEvidenceBundles };