qfai 1.8.0 → 1.8.2

package/dist/index.d.cts

@@ -312,304 +312,46 @@ 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 = "full-harness";
-type ModeSelectionSource = "explicit-request" | "discussion-recommendation" | "system-default";
+declare const PROTOTYPING_MODES: readonly ["low-cost", "standard", "full-harness"];
+declare const DEFAULT_PROTOTYPING_MODE: "standard";
+declare const PROTOTYPING_MAX_ITERATIONS: {
+    readonly "low-cost": 1;
+    readonly standard: 3;
+    readonly "full-harness": 20;
+};
+declare const PROTOTYPING_SUPPORTED_SURFACES: readonly ["web", "mobile", "desktop", "mixed"];
+type PrototypingMode = (typeof PROTOTYPING_MODES)[number];
+type ModeSelectionSource = "explicit-request" | "system-default";
 type PrototypingSurface = CanonicalPrototypingSurface;
-type DiscussionRecommendationSourceSchema = "canonical-namespaced";
-/**
- * Canonical validated recommendation — all 4 fields required.
- * Parser output uses this same type; fields are always populated
- * because extractRecommendation returns null when any field is missing.
- */
-type DiscussionModeRecommendation = {
-    recommendedMode: PrototypingMode;
-    rationale: string;
-    allowedModes: PrototypingMode[];
-    surface: PrototypingSurface;
-    updatedAt?: string | undefined;
-    sourceSchema?: DiscussionRecommendationSourceSchema | undefined;
-};
-type ModeResolutionInput = {
-    explicitMode?: PrototypingMode | undefined;
-    discussionRecommendation?: DiscussionModeRecommendation | null | undefined;
-    defaultMode?: PrototypingMode | undefined;
-};
 type ModeResolutionResult = {
-    requested?: PrototypingMode | undefined;
+    requested?: PrototypingMode;
     effective: PrototypingMode;
     source: ModeSelectionSource;
     rationale: string;
 };
-type ResolvedModeSummary = ModeResolutionResult & {
-    discussionRecommendation?: DiscussionModeRecommendation | undefined;
-    surface?: PrototypingSurface | undefined;
-    warnings: string[];
-};
 type PrototypingObligations = {
     requireRuntimeGate: boolean;
     requireUiFidelity: boolean;
     requireRenderBundle: boolean;
     requireBrowserQaBundle: boolean;
-    requireFullHarness: boolean;
+    requireIterations: boolean;
+    maxIterations: number;
     validCombination: boolean;
-    invalidReasonCode?: string | undefined;
-    invalidReason?: string | undefined;
-};
-type ResolveModeInput = {
-    requested?: PrototypingMode | undefined;
-    discussionArtifact?: unknown;
-    defaultMode?: PrototypingMode | undefined;
-};
-type PrototypingExecutionConfig = {
-    targetUrl?: string | null;
-    browserProvider?: string;
-    renderProvider?: string;
+    invalidReason?: string;
 };
 type UiFidelityStatus = {
     required: boolean;
     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 only the canonical namespaced (`prototyping.*`) schema.
- */
-declare function parseDiscussionModeRecommendation(filePath: string): Promise<DiscussionModeRecommendation | null>;
-declare function parseDiscussionModeRecommendationWithWarnings(filePath: string): Promise<ParseDiscussionResult>;
-declare function parseDiscussionFromObject(parsed: Record<string, unknown>): ParseDiscussionResult;
-declare function resolvePrototypingMode(input: ModeResolutionInput): ModeResolutionResult;
-/**
- * Full resolved mode summary with discussion recommendation context and warnings.
- */
-declare function summarizeResolvedMode(input: ModeResolutionInput): ResolvedModeSummary;
-/**
- * Resolve mode from raw input (ResolveModeInput) — includes discussion artifact parsing.
- */
-declare function resolvePrototypingModeFromInput(input: ResolveModeInput): ResolvedModeSummary;
-declare function normalizeSurface(input: unknown): PrototypingSurface | null;
-declare function inferSurfaceFromRecommendationAndEvidence(input: {
-    recommendationSurface?: PrototypingSurface | undefined;
-    evidenceSurface?: PrototypingSurface | undefined;
-    hasUiFidelity?: boolean | undefined;
-    hasRenderBundle?: boolean | undefined;
-    hasBrowserQaBundle?: boolean | undefined;
-    hasUiRoutes?: boolean | undefined;
-    hasRuntimeGateUi?: boolean | undefined;
-}): PrototypingSurface | null;
-declare function derivePrototypingObligations(input: {
-    surface: PrototypingSurface;
-    effectiveMode: string;
-}): PrototypingObligations;
 declare function isValidPrototypingMode(value: unknown): value is PrototypingMode;
 declare function isValidPrototypingSurface(value: unknown): value is PrototypingSurface;
-declare function normalizeAllowedModes(modes?: string[]): PrototypingMode[];
-
-/**
- * Render evidence types — WS-C
- *
- * Canonical types for the render evidence capture pipeline.
- */
-type RenderCaptureTarget = {
-    targetId: string;
-    route?: string;
-    descriptor?: string;
-    viewport: string;
-    width?: number;
-    height?: number;
-};
-type RenderCaptureAdapter = {
-    captureScreenshot(target: RenderCaptureTarget, outputDir: string): Promise<string>;
-    captureHtml?(target: RenderCaptureTarget, outputDir: string): Promise<string>;
-};
-type RenderEvidenceEntryResult = {
-    capture_id: string;
-    target: string;
-    status: "captured" | "skipped" | "failed";
-    screenshot_path?: string;
-    html_path?: string;
-    viewport: string;
-    reason?: string;
-};
-type RenderRunnerResult = {
-    entries: RenderEvidenceEntryResult[];
-    filesWritten: string[];
-    surface?: string;
-    mode?: string;
-    generatedAt?: string;
-    coverageSummary?: {
-        total: number;
-        captured: number;
-        failed: number;
-        skipped: number;
-    };
-};
-
-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 = "passed" | "executed" | "failed" | "skipped";
-type BrowserQaFindingSeverity = "info" | "warn" | "warning" | "error";
-interface BrowserQaFinding {
-    phase: BrowserQaPhase;
-    severity: BrowserQaFindingSeverity;
-    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;
-    targetUrl?: string;
-    routes?: string[];
-    surface: SurfaceType;
-    required?: boolean;
-    executionSource?: "html" | "url" | "none";
-    screenContracts?: BrowserQaScreenContractRef[];
-};
-type BrowserQaRunResult = {
-    phases: BrowserQaPhaseResult[];
-    provider: string;
-    timestamp: string;
-};
-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 {
-    providerId: string;
-    canRun(surface: SurfaceType): boolean;
-    runSmoke(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
-    runInteraction(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
-    runVisual(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
-    runAccessibility(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
-}
-
-/**
- * Browser provider types.
- *
- * Provider interface is minimal (DEC-0003). Registration is optional;
- * absence is a valid state with fail-open semantics.
- *
- * WS-B: BrowserQaProvider is the canonical interface for 4-phase Browser QA.
- * BrowserProvider defines the browser QA and capture provider interface.
- */
-
-type ProviderCapability = "screenshot" | "viewport" | "dom" | "interaction" | "visual" | "accessibility";
-/** Browser QA and capture provider. */
-type BrowserProvider = {
-    name: string;
-    capabilities: ProviderCapability[];
-    captureScreenshot?: () => Promise<string>;
-    captureViewport?: () => Promise<{
-        width: number;
-        height: number;
-    }>;
-    captureDom?: () => Promise<string>;
-    runInteraction?: () => Promise<void>;
-    runVisual?: () => Promise<void>;
-    runAccessibility?: () => Promise<void>;
-};
-
-type ProviderLookupResult = {
-    status: "available";
-    provider: BrowserProvider;
-} | {
-    status: "skipped";
-    provider: undefined;
-};
-
-/**
- * Provider registry with optional registration and fail-open semantics.
- *
- * Registration is synchronous. Lookup returns a discriminated union
- * so callers can handle absence without try/catch.
- */
-
-declare class ProviderRegistry {
-    private providers;
-    register(provider: BrowserProvider): void;
-    /** Atomically replace an existing provider registration. */
-    replace(provider: BrowserProvider): void;
-    get(name: string): BrowserProvider | undefined;
-    has(name: string): boolean;
-    getOrSkip(name: string): ProviderLookupResult;
-    private qaProviders;
-    registerQaProvider(provider: BrowserQaProvider): void;
-    getQaProvider(name: string): BrowserQaProvider | undefined;
-    getFirstQaProvider(): BrowserQaProvider | undefined;
-}
-
-type PrototypingExecutionRequest = {
-    root: string;
-    requestedMode?: PrototypingMode;
-    providerRegistry?: ProviderRegistry;
-    renderAdapter?: RenderCaptureAdapter;
-    browserQaProviderId?: string;
-    renderProviderId?: string;
-    targetUrl?: string;
-    reviewer?: string;
-    changeSummary?: string[];
-    limitations?: string[];
-};
-type PrototypingExecutionResult = {
-    mode: PrototypingMode;
+declare function isSupportedPrototypingSurface(surface: string): surface is PrototypingSurface;
+declare function resolvePrototypingMode(requested?: PrototypingMode): ModeResolutionResult;
+declare function derivePrototypingObligations(input: {
     surface: PrototypingSurface;
-    evidencePaths: {
-        prototyping: string;
-        render: string;
-        browserQa: string;
-    };
-    generatedAt: string;
-};
-declare function runPrototypingExecution(request: PrototypingExecutionRequest): Promise<PrototypingExecutionResult>;
+    effectiveMode: PrototypingMode;
+}): PrototypingObligations;
 
 type SddPreflightSource = "discussion-pack";
 type SddPreflightStatus = "ready" | "blocked";
@@ -805,19 +547,12 @@ type ReportFullHarnessExecution = {
 type ReportPrototypingSummary = {
     surfaceClassification?: ReportSurfaceClassification;
     fullHarnessExecution?: ReportFullHarnessExecution;
-    recommendationArtifact?: {
-        status: "valid" | "missing" | "invalid" | "no-pack";
-        path?: string;
-    };
     mode: {
         requested?: string;
         effective: string;
         source: string;
         rationale: string;
-        discussionRecommendation?: string;
-        allowedModes?: string[];
         surface: string;
-        sourceSchema?: string;
     };
     evidence: {
         specsCoverageStatus: "complete" | "incomplete";
@@ -860,9 +595,7 @@ type ReportPrototypingSummary = {
         reviewerId?: string;
         reviewerSignoffStatus?: string;
         scoringTraceCount?: number;
-        latestWeightedTotal?: number;
-        latestL1Total?: number;
-        latestL2Total?: number;
+        latestScoredIteration?: number;
         limitations?: string[];
         reviewerLogsCount?: number;
     };
@@ -951,8 +684,126 @@ declare function validateSpecSplitByCapability(root: string, config: QfaiConfig)
 
 declare function validateTraceability(root: string, config: QfaiConfig, phase: ValidationPhase): Promise<Issue[]>;
 
+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 = "passed" | "executed" | "failed" | "skipped";
+type BrowserQaFindingSeverity = "info" | "warn" | "warning" | "error";
+interface BrowserQaFinding {
+    phase: BrowserQaPhase;
+    severity: BrowserQaFindingSeverity;
+    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;
+    targetUrl?: string;
+    routes?: string[];
+    surface: SurfaceType;
+    required?: boolean;
+    executionSource?: "html" | "url" | "none";
+    screenContracts?: BrowserQaScreenContractRef[];
+};
+type BrowserQaRunResult = {
+    phases: BrowserQaPhaseResult[];
+    provider: string;
+    timestamp: string;
+};
+type BrowserQaSummary = {
+    providerId: string;
+    phases: Record<BrowserQaPhase, {
+        status: BrowserQaPhaseStatus;
+        findingsCount: number;
+        checksCount: number;
+        passed?: number;
+        failed?: number;
+    }>;
+    totalFindings: number;
+    totalRepairs: number;
+    skippedReasons: string[];
+};
+interface BrowserQaProvider {
+    providerId: string;
+    canRun(surface: SurfaceType): boolean;
+    runSmoke(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
+    runInteraction(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
+    runVisual(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
+    runAccessibility(input: BrowserQaInput): Promise<BrowserQaPhaseResult>;
+}
+
 declare function runBrowserQaOrchestrated(input: BrowserQaInput, provider?: BrowserQaProvider): Promise<BrowserQaRunResult>;
-declare function summarizeBrowserQaResult(result: BrowserQaRunResult): BrowserQaSummary$1;
+declare function summarizeBrowserQaResult(result: BrowserQaRunResult): BrowserQaSummary;
+
+/**
+ * Render evidence types — WS-C
+ *
+ * Canonical types for the render evidence capture pipeline.
+ */
+type RenderCaptureTarget = {
+    targetId: string;
+    route?: string;
+    descriptor?: string;
+    viewport: string;
+    width?: number;
+    height?: number;
+};
+type RenderCaptureAdapter = {
+    captureScreenshot(target: RenderCaptureTarget, outputDir: string): Promise<string>;
+    captureHtml?(target: RenderCaptureTarget, outputDir: string): Promise<string>;
+};
+type RenderEvidenceEntryResult = {
+    capture_id: string;
+    target: string;
+    status: "captured" | "skipped" | "failed";
+    screenshot_path?: string;
+    html_path?: string;
+    viewport: string;
+    reason?: string;
+};
+type RenderRunnerResult = {
+    entries: RenderEvidenceEntryResult[];
+    filesWritten: string[];
+    surface?: string;
+    mode?: string;
+    generatedAt?: string;
+    coverageSummary?: {
+        total: number;
+        captured: number;
+        failed: number;
+        skipped: number;
+    };
+};
 
 /**
  * Render runner — WS-C
@@ -992,109 +843,70 @@ type FullHarnessHandoff = {
 };
 
 /**
- * Calibration pack types for harness scoring alignment.
+ * Full-harness mode types.
  *
- * Calibration packs are file-based YAML assets (SD-0030-003)
- * containing scoring alignment examples and threshold configuration.
+ * Full-harness now follows the reviewerScores/allItemsPass95 evidence schema
+ * used by prototyping.json. Legacy weighted totals are intentionally excluded.
  */
-type AlignmentExample = {
-    input: string;
-    expectedScore: number;
+type FullHarnessAxisScore = {
+    axisId: string;
+    score: number;
     rationale: string;
+    evidenceRefs: 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 FullHarnessReviewerScore = {
+    reviewerId: string;
+    role?: string;
+    scores: FullHarnessAxisScore[];
+};
+type FullHarnessEvidenceRefs = {
+    render: string[];
+    browserQa: string[];
+    runtimeGate: string[];
+    uiObservation: string[];
+    specCoverage: string[];
+    discussion: string[];
+    screenContract: string[];
+    trend: 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;
+    evidenceRefs: FullHarnessEvidenceRefs;
+    reviewerScores: FullHarnessReviewerScore[];
+    allItemsPass95: boolean;
+    stopReason?: string;
 };
 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 FullHarnessScoreSnapshot = {
+    iteration: number;
+    reviewerCount: number;
+    axisCount: number;
+    minScore: number | null;
+    averageScore: number | null;
+    allItemsPass95: boolean;
+    commitSha: string;
+};
 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;
-    }>;
+    scoringTrace: FullHarnessScoreSnapshot[];
 };
 type MeasurementInput = {
     root: string;
     reviewer: string;
     changeSummary: string[];
     limitations: string[];
-    calibration: {
-        packPath: string;
-        thresholds: {
-            accept: number;
-            refine: number;
-        };
+    iterationPolicy: {
         maxIterations: number;
-        plateauDelta: number;
-        plateauLookback: number;
     };
     renderRefs: string[];
     browserQaRefs: string[];
@@ -1105,8 +917,9 @@ type MeasurementInput = {
     screenContractRefs: string[];
     discussionDirRelative?: string;
     trendRefs: string[];
-    l1: FullHarnessPanelScore;
-    l2: FullHarnessPanelScore;
+    reviewerScores: FullHarnessReviewerScore[];
+    allItemsPass95: boolean;
+    stopReason?: string;
 };
 type MeasurementResult = {
     iteration: FullHarnessIteration;
@@ -1207,17 +1020,21 @@ type PrototypingSummaryBundle = {
             evidenceRefs: string[];
         }>;
         iterations: FullHarnessIteration[];
-        scoringTrace: Array<{
-            iteration: number;
-            l1Total: number;
-            l2Total: number;
-            weightedTotal: number;
-            deltaFromPrevious: number | null;
-            decision: "accept" | "refine" | "reject";
-            commitSha: string;
-        }>;
+        scoringTrace: FullHarnessScoreSnapshot[];
         limitations: string[];
     };
+    breakthrough: {
+        latestIteration: number;
+        triggerResult: boolean;
+        triggerReasons: string[];
+        scoreDeltaWindow: number;
+        avgScoreDeltas: number[];
+        minScoreDeltas: number[];
+        diffLines: number;
+        branchCount: number;
+        incumbentRef?: string;
+        branchRefs?: string[];
+    };
 };
 declare function writeEvidenceBundles(input: {
     root: string;
@@ -1244,227 +1061,17 @@ declare function writeEvidenceBundles(input: {
 }>;
 
 /**
- * Harness adapters — WS-D
- *
- * Adapter interfaces for connecting the full-harness runtime to
- * render evidence, Browser QA, critique, and observability subsystems.
- */
-
-type HarnessRenderAdapter = {
-    captureEvidence(iteration: number): Promise<RenderRunnerResult>;
-};
-type HarnessBrowserQaAdapter = {
-    runQa(iteration: number): Promise<BrowserQaRunResult>;
-};
-type HarnessObservabilityAdapter = {
-    recordIteration(data: {
-        iteration: number;
-        score: number;
-        decision: string;
-        terminationReason?: string;
-    }): void;
-    flush(): Promise<void>;
-};
-type FullHarnessAdapters = {
-    surface: SurfaceType;
-    render: HarnessRenderAdapter;
-    browserQa: HarnessBrowserQaAdapter;
-    observability?: HarnessObservabilityAdapter;
-};
-
-/**
- * Panel scoring input DTO — v1.7.15
- *
- * 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 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;
-    };
-    checked: {
-        uiOk: number;
-    };
-    missing: {
-        uiRoutes: 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;
-};
-
-/**
- * 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.
- *
- * 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 = {
-    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 = {
-    iteration: FullHarnessIteration;
-    history: FullHarnessHistory;
-    calibrationRef: FullHarnessCalibrationRef;
-    fakeUiDetection: FakeUiDetectionResult;
-    exitReason: FullHarnessExitReason;
-    handoff: FullHarnessHandoff;
-    terminationReason: TerminationReason | undefined;
-    isTerminal: boolean;
-    finalDecision: FinalDecision;
-    signoffStatus: ReviewerSignoffStatus;
-    logVerdict: ReviewerLogVerdict;
-};
-/**
- * Run a single full-harness measurement iteration.
- *
- * 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
+ * Iteration history management.
  *
  * Reads previous iterations from prototyping.json,
- * appends new iteration, recomputes bestIteration/scoringTrace/terminationReason.
+ * appends new iteration, and recomputes bestIteration/scoringTrace from
+ * reviewerScores/allItemsPass95 evidence.
  */
 
 declare function loadHistory(root: string): Promise<FullHarnessHistory | null>;
 declare function appendIteration(history: FullHarnessHistory | null, iteration: FullHarnessIteration): FullHarnessHistory;
-declare function computeTerminationReason(history: FullHarnessHistory, calibration: {
+declare function computeTerminationReason(history: FullHarnessHistory, iterationPolicy: {
     maxIterations: number;
-    plateauDelta: number;
-    plateauLookback: number;
-    thresholds: {
-        accept: number;
-    };
 }): TerminationReason | undefined;
 
 /**
@@ -1496,4 +1103,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, 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 };
+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, DEFAULT_PROTOTYPING_MODE, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type FailOn, type FinalDecision, type FullHarnessAxisScore, type FullHarnessCalibrationRef, type FullHarnessEvidenceRefs, type FullHarnessHistory, type FullHarnessIteration, type FullHarnessReviewerScore, type FullHarnessScoreSnapshot, 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 ModeResolutionResult, type ModeSelectionSource, type OrphanContractsPolicy, type OutputFormat, PROTOTYPING_MAX_ITERATIONS, PROTOTYPING_MODES, PROTOTYPING_SUPPORTED_SURFACES, 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 ReviewerLogVerdict, type ReviewerSignoffStatus, type RunSddPreflightOptions, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type TerminationReason, 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, appendIteration, checkDecisionGuardrails, computeTerminationReason, createPlaywrightBrowserQaProvider, createPlaywrightRenderAdapter, createReportData, defaultConfig, derivePrototypingObligations, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isSupportedPrototypingSurface, isValidPrototypingMode, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, loadHistory, normalizeDecisionGuardrails, requiresVisualBrowserEvidence, resolveCommitSha, resolvePath, resolvePrototypingMode, resolveToolVersion, runBrowserQaOrchestrated, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateReviewer, validateSpecSplitByCapability, validateTraceability, writeEvidenceBundles };