@tiangong-ai/cli 0.0.57 → 0.0.59

package/dist/research/workspace/scientific-review-execution.js

@@ -0,0 +1,445 @@
+import { createHash, randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { copyFile, lstat, mkdtemp, open, readFile, rm } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { CliError } from "../../errors.js";
+import { verifyCapabilities } from "./capabilities.js";
+import { appendJournalEvent, readVerifiedJournal } from "./journal.js";
+import { calculateAgentCallTokenReservation, RESEARCH_ESTIMATED_BYTES_PER_TOKEN, researchStructuredOutputMaxTurns, reservedAgentPackageCost, } from "./preflight.js";
+import { loadProject, saveProject } from "./projects.js";
+import { assertResearchPolicyBinding } from "./research-policy.js";
+import { createReviewExecutor } from "./review-executor.js";
+import { loadPreparedScientificReview, readScientificReviewOutput, scientificReviewSchema, submitScientificReview, } from "./scientific-review.js";
+import { configuredResearchSecrets, sanitizeResearchText, sanitizeResearchValue, } from "./sanitization.js";
+import { canonicalJson, ensureDirectory, isObject, resolveContained, sha256File, sha256Text, workspacePaths, writeJsonAtomic, } from "./storage.js";
+import { loadWorkspaceConfig, verifyDoctorAttestation, withWorkspaceLock } from "./workspace.js";
+const MAX_EXECUTION_RECEIPT_BYTES = 1024 * 1024;
+export async function executeScientificReview(input, executor) {
+    if (!input.confirmCost) {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_COST_CONFIRMATION_REQUIRED", "Explicit --confirm-review-cost is required before running the independent reviewer.");
+    }
+    const prepared = await withWorkspaceLock(input.root, "scientific-review.execute", async () => {
+        const paths = workspacePaths(input.root);
+        const journal = await readVerifiedJournal(paths.journal);
+        const existingProject = await loadProject(input.root, input.projectId);
+        const existingGate = existingProject.scientificDesign?.gates[input.role];
+        const packetHash = existingGate?.packetSha256;
+        const events = journal.filter((event) => event.scope === input.projectId &&
+            event.payload.packetSha256 === packetHash &&
+            event.payload.role === input.role);
+        const completed = events.findLast((event) => event.type === "scientific-review.execution.completed");
+        if (completed) {
+            const receipt = await readReceipt(input.root, completed.payload.receiptLocator, completed.payload.receiptSha256, {
+                projectId: input.projectId,
+                role: input.role,
+                packetSha256: packetHash,
+                reviewerSessionSha256: existingGate?.reviewerSessionSha256,
+            });
+            return {
+                packetSha256: String(packetHash),
+                receipt,
+                receiptSha256: String(completed.payload.receiptSha256),
+                replayed: true,
+            };
+        }
+        const { project, packet } = await loadPreparedScientificReview(input.root, input.projectId, input.role);
+        const config = await loadWorkspaceConfig(input.root);
+        if (project.lineage.supersededBy ||
+            ["archived", "abandoned"].includes(project.status) ||
+            project.handoff.state !== "agent-actionable") {
+            throw executionError("RESEARCH_PROJECT_NOT_AUTHORITATIVE", "Only an active authoritative project may execute a scientific review.");
+        }
+        if (config.reviewer.agent !== packet.reviewer.agent ||
+            config.reviewer.agent === project.scientificDesign?.producer.agent) {
+            throw executionError("RESEARCH_SCIENTIFIC_REVIEWER_MISMATCH", "The prepared packet must use the configured independent reviewer family.");
+        }
+        const capabilities = await verifyCapabilities(input.root);
+        if (capabilities.status !== "verified") {
+            throw executionError("RESEARCH_CAPABILITY_DRIFT", "Verify the locked capabilities before reviewer execution.");
+        }
+        let expectedRuntime;
+        if (config.mode === "production-research") {
+            const doctor = await verifyDoctorAttestation(input.root);
+            if (doctor.status !== "verified" || !doctor.attestation) {
+                throw executionError("RESEARCH_DOCTOR_ATTESTATION_REQUIRED", "Refresh the independent reviewer doctor attestation before production review.");
+            }
+            expectedRuntime = doctor.attestation.runtimes.find((runtime) => runtime.agent === config.reviewer.agent && runtime.model === config.reviewer.model);
+            if (!expectedRuntime) {
+                throw executionError("RESEARCH_EXECUTOR_DRIFT", "The doctor attestation does not bind the configured reviewer route.");
+            }
+            await assertResearchPolicyBinding(input.root, project.publicationPolicy);
+        }
+        const attempts = events.filter((event) => event.type === "scientific-review.execution.started").length;
+        if (attempts > 0 && !input.retry) {
+            throw executionError("RESEARCH_SCIENTIFIC_REVIEW_RETRY_REQUIRED", "The previous execution did not complete. Inspect its receipt, correct the cause, then explicitly use --retry.");
+        }
+        if (attempts >= config.budget.maxAttemptsPerPackage) {
+            throw executionError("RESEARCH_SCIENTIFIC_REVIEW_ATTEMPTS_EXHAUSTED", "The bounded scientific reviewer attempts are exhausted; do not retry automatically.");
+        }
+        const runId = randomUUID();
+        const capsuleParent = join(paths.runtime, "scientific-capsules");
+        await ensureDirectory(capsuleParent);
+        const capsuleRoot = await mkdtemp(join(capsuleParent, "review-"));
+        const capsuleProject = join(capsuleRoot, "project");
+        await ensureDirectory(capsuleProject);
+        let started = false;
+        let completedCall = false;
+        let usageBeforeReservation = null;
+        let callStartedAt = null;
+        let usageSettled = false;
+        try {
+            await copyPacketInputs(input.root, capsuleProject, packet, project.publicationPolicy);
+            const prompt = await scientificReviewPrompt(capsuleProject, packet, config, project.publicationPolicy);
+            const schema = scientificReviewSchema(input.role);
+            const maxTurns = researchStructuredOutputMaxTurns(config.reviewer);
+            const reservation = calculateAgentCallTokenReservation({
+                route: config.reviewer,
+                primaryPayloadTokens: Math.ceil(Buffer.byteLength(prompt + JSON.stringify(schema)) / RESEARCH_ESTIMATED_BYTES_PER_TOKEN),
+                repairPayloadTokens: 0,
+                maxTurns,
+                maxOutputTokens: config.budget.maxOutputTokens,
+                maxToolContextTokens: 0,
+                maxRepairTokens: 0,
+                reserveRepair: false,
+            }).totalTokens;
+            const reservedCostUsd = reservedAgentPackageCost(config.reviewer, reservation, config);
+            const timeoutSeconds = Math.min(config.budget.earlyScientificReviewMaxWallSeconds, config.budget.maxWallSeconds - project.usage.wallSeconds);
+            if (reservation > config.budget.earlyScientificReviewMaxTokens ||
+                reservation > config.budget.maxTokens - project.usage.tokens ||
+                reservedCostUsd > config.budget.maxCostUsd - project.usage.costUsd ||
+                timeoutSeconds <= 0) {
+                throw executionError("RESEARCH_BUDGET_EXCEEDED", "The independent review reservation does not fit the reviewed token, cost, or time limits.");
+            }
+            // Reserve before spawning. An interrupted call remains conservatively charged;
+            // a returned result replaces that reservation with measured usage.
+            const priorUsage = { ...project.usage };
+            project.usage.tokens += reservation;
+            project.usage.inputTokens += reservation;
+            project.usage.costUsd += reservedCostUsd;
+            project.usage.wallSeconds += timeoutSeconds;
+            await saveProject(input.root, project);
+            usageBeforeReservation = priorUsage;
+            await appendJournalEvent(paths.journal, "scientific-review.execution.started", project.id, {
+                role: input.role,
+                packetSha256: packet.packetSha256,
+                runId,
+                attempt: attempts + 1,
+                reservedTokens: reservation,
+                reservedCostUsd,
+                reservedWallSeconds: timeoutSeconds,
+                transport: config.reviewerExecution.transport,
+            });
+            started = true;
+            const execute = executor ??
+                createReviewExecutor({ root: input.root, execution: config.reviewerExecution }).execute;
+            callStartedAt = process.hrtime.bigint();
+            const result = await execute({
+                route: config.reviewer,
+                prompt,
+                outputSchema: schema,
+                requestId: runId,
+                purpose: "primary",
+                capsuleRoot,
+                projectRoot: capsuleProject,
+                workspaceRoot: input.root,
+                timeoutSeconds,
+                maxTurns,
+                maxOutputTokens: config.budget.maxOutputTokens,
+                maxToolContextTokens: 0,
+                maxCostUsd: reservedCostUsd,
+                expectedRuntime,
+                toolPolicy: "none",
+                brokerUrl: null,
+                environment: input.environment,
+            });
+            const reportedUsage = checkedUsage(result);
+            const usageKnown = reportedUsage.tokens > 0;
+            const usage = usageKnown
+                ? reportedUsage
+                : {
+                    ...reportedUsage,
+                    tokens: reservation,
+                    inputTokens: reservation,
+                    costUsd: Math.max(reportedUsage.costUsd, reservedCostUsd),
+                };
+            project.usage.tokens = priorUsage.tokens + usage.tokens;
+            project.usage.inputTokens = priorUsage.inputTokens + usage.inputTokens;
+            project.usage.cachedInputTokens = priorUsage.cachedInputTokens + usage.cachedInputTokens;
+            project.usage.outputTokens = priorUsage.outputTokens + usage.outputTokens;
+            project.usage.costUsd = priorUsage.costUsd + usage.costUsd;
+            project.usage.wallSeconds = priorUsage.wallSeconds + usage.wallSeconds;
+            await saveProject(input.root, project);
+            usageSettled = true;
+            if (result.exitCode !== 0) {
+                throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_FAILED", "The isolated reviewer failed. No scientific review was submitted.");
+            }
+            if (usage.tokens > reservation ||
+                usage.outputTokens > config.budget.maxOutputTokens ||
+                (config.reviewer.pricing && usage.costUsd > reservedCostUsd) ||
+                usage.wallSeconds > timeoutSeconds) {
+                throw executionError("RESEARCH_BUDGET_EXCEEDED", "The reviewer exceeded its reserved execution limit. No review was submitted.");
+            }
+            if (!result.runtime ||
+                result.runtime.agent !== config.reviewer.agent ||
+                (config.reviewer.model !== null && result.model !== config.reviewer.model) ||
+                result.isolation?.toolPolicy !== "none" ||
+                result.isolation.networkPolicy !== "reviewer-provider-only" ||
+                (config.reviewerExecution.transport === "sandbox-bridge" && !result.reviewAttestation)) {
+                throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The reviewer result does not contain the expected model, runtime, and isolation proof.");
+            }
+            const secrets = configuredResearchSecrets(input.environment);
+            if (sanitizeResearchText(result.stdout, secrets) !== result.stdout ||
+                Buffer.byteLength(result.stdout) > config.budget.maxOutputTokens * 16) {
+                throw executionError("RESEARCH_SCIENTIFIC_REVIEW_OUTPUT_UNSAFE", "The reviewer output is unsafe or exceeds the bounded capture size.");
+            }
+            let output;
+            try {
+                output = JSON.parse(result.stdout);
+            }
+            catch {
+                throw executionError("RESEARCH_SCIENTIFIC_REVIEW_INVALID", "The reviewer did not return schema-valid JSON. No review was submitted.");
+            }
+            if (canonicalJson(sanitizeResearchValue(output, secrets)) !== canonicalJson(output)) {
+                throw executionError("RESEARCH_SCIENTIFIC_REVIEW_OUTPUT_UNSAFE", "The reviewer output contains sensitive material.");
+            }
+            const reviewPath = join(capsuleRoot, "review.json");
+            await writeJsonAtomic(reviewPath, output);
+            const review = await readScientificReviewOutput(reviewPath, input.role);
+            if (review.packetSha256 !== packet.packetSha256 ||
+                review.reviewerSessionSha256 !== packet.reviewer.sessionSha256) {
+                throw executionError("RESEARCH_SCIENTIFIC_REVIEW_BINDING_INVALID", "The reviewer output does not bind the prepared packet and independent session.");
+            }
+            const reviewBytes = JSON.stringify(review, null, 2) + "\n";
+            const reviewSha256 = sha256Text(reviewBytes);
+            const reviewLocator = "projects/" + project.id + "/scientific/execution-outputs/" + reviewSha256 + ".json";
+            await writeJsonAtomic(resolveContained(paths.control, reviewLocator), review, 0o444);
+            const core = sanitizeResearchValue({
+                schemaVersion: 1,
+                projectId: project.id,
+                role: input.role,
+                packetSha256: packet.packetSha256,
+                reviewerSessionSha256: packet.reviewer.sessionSha256,
+                runId,
+                attempt: attempts + 1,
+                transport: config.reviewerExecution.transport,
+                reviewerAgent: config.reviewer.agent,
+                model: result.model,
+                reviewLocator,
+                reviewSha256,
+                usage,
+                accountingMode: usageKnown ? "measured" : "reserved-unknown-usage",
+                runtime: result.runtime,
+                isolation: result.isolation,
+                reviewAttestation: result.reviewAttestation ?? null,
+                stdoutSha256: sha256Text(result.stdout),
+                stderrSha256: sha256Text(result.stderr),
+            }, secrets);
+            const receiptSha256 = sha256Text(JSON.stringify(core, null, 2) + "\n");
+            const receiptLocator = "projects/" + project.id + "/scientific/execution-receipts/" + receiptSha256 + ".json";
+            await writeJsonAtomic(resolveContained(paths.control, receiptLocator), core, 0o444);
+            await appendJournalEvent(paths.journal, "scientific-review.execution.completed", project.id, {
+                role: input.role,
+                packetSha256: packet.packetSha256,
+                runId,
+                receiptLocator,
+                receiptSha256,
+                reviewSha256,
+            });
+            completedCall = true;
+            return { packetSha256: packet.packetSha256, receipt: core, receiptSha256, replayed: false };
+        }
+        catch (error) {
+            if (usageBeforeReservation && !usageSettled) {
+                // A live process can measure elapsed time even if the executor throws.
+                // SIGKILL cannot reach this settlement, so the durable timeout stays reserved.
+                const elapsed = callStartedAt === null
+                    ? 0
+                    : Number(process.hrtime.bigint() - callStartedAt) / 1_000_000_000;
+                project.usage.wallSeconds = usageBeforeReservation.wallSeconds + elapsed;
+                if (callStartedAt === null) {
+                    project.usage = { ...usageBeforeReservation };
+                }
+                await saveProject(input.root, project);
+            }
+            if (started) {
+                await appendJournalEvent(paths.journal, "scientific-review.execution.failed", project.id, {
+                    role: input.role,
+                    packetSha256: packet.packetSha256,
+                    runId,
+                    attempt: attempts + 1,
+                    code: error instanceof CliError ? error.code : "RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_FAILED",
+                    capsuleDisposition: "retained-failed-execution",
+                });
+            }
+            if (error instanceof CliError)
+                throw error;
+            throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_FAILED", "The isolated reviewer failed. Its packet and failed execution remain available for explicit recovery.");
+        }
+        finally {
+            if ((completedCall || !started) &&
+                !["workbuddy", "codebuddy"].includes(project.scientificDesign.producer.agent)) {
+                await rm(capsuleRoot, { recursive: true, force: true });
+            }
+        }
+    });
+    const reviewLocator = prepared.receipt.reviewLocator;
+    const reviewSha256 = prepared.receipt.reviewSha256;
+    if (typeof reviewLocator !== "string" || typeof reviewSha256 !== "string") {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The execution receipt is missing its review binding.");
+    }
+    const reviewPath = resolveContained(workspacePaths(input.root).control, reviewLocator);
+    if ((await sha256File(reviewPath)) !== reviewSha256) {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The saved reviewer output drifted after execution.");
+    }
+    const submission = await submitScientificReview({
+        ...input,
+        reviewPath,
+        executionBinding: { packetSha256: prepared.packetSha256, reviewSha256 },
+    });
+    return {
+        ...submission,
+        packetSha256: prepared.packetSha256,
+        receiptSha256: prepared.receiptSha256,
+        replayed: prepared.replayed,
+    };
+}
+async function readReceipt(root, locator, digest, expected) {
+    if (typeof digest !== "string" ||
+        !/^[a-f0-9]{64}$/.test(digest) ||
+        locator !== `projects/${expected.projectId}/scientific/execution-receipts/${digest}.json`) {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The completed execution has invalid receipt metadata.");
+    }
+    const path = resolveContained(workspacePaths(root).control, String(locator));
+    const info = await lstat(path).catch(() => null);
+    if (!info?.isFile() || info.isSymbolicLink() || info.size > MAX_EXECUTION_RECEIPT_BYTES) {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The completed execution receipt failed its hash check.");
+    }
+    let value;
+    try {
+        const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+        try {
+            const opened = await handle.stat();
+            if (!opened.isFile() || opened.size < 2 || opened.size > MAX_EXECUTION_RECEIPT_BYTES)
+                throw new Error("invalid receipt size");
+            const buffer = Buffer.alloc(opened.size + 1);
+            let length = 0;
+            while (length < buffer.length) {
+                const result = await handle.read(buffer, length, buffer.length - length, length);
+                if (result.bytesRead === 0)
+                    break;
+                length += result.bytesRead;
+            }
+            const bytes = buffer.subarray(0, length);
+            if (length !== opened.size || createHash("sha256").update(bytes).digest("hex") !== digest)
+                throw new Error("receipt hash mismatch");
+            value = JSON.parse(bytes.toString("utf8"));
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The completed execution receipt failed its bounded snapshot check.");
+    }
+    if (!isObject(value) ||
+        value.schemaVersion !== 1 ||
+        value.projectId !== expected.projectId ||
+        value.role !== expected.role ||
+        value.packetSha256 !== expected.packetSha256 ||
+        value.reviewerSessionSha256 !== expected.reviewerSessionSha256 ||
+        typeof value.reviewSha256 !== "string" ||
+        !/^[a-f0-9]{64}$/.test(value.reviewSha256) ||
+        value.reviewLocator !==
+            `projects/${expected.projectId}/scientific/execution-outputs/${value.reviewSha256}.json`) {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "The execution receipt does not match its project, packet, or review binding.");
+    }
+    return value;
+}
+function checkedUsage(result) {
+    const usage = {
+        tokens: result.tokens,
+        inputTokens: result.inputTokens,
+        cachedInputTokens: result.cachedInputTokens,
+        outputTokens: result.outputTokens,
+        costUsd: result.costUsd,
+        wallSeconds: result.wallSeconds,
+    };
+    if (Object.values(usage).some((value) => !Number.isFinite(value) || value < 0) ||
+        usage.tokens !== usage.inputTokens + usage.cachedInputTokens + usage.outputTokens) {
+        throw executionError("RESEARCH_SCIENTIFIC_REVIEW_EXECUTION_BINDING_INVALID", "Reviewer usage metadata is invalid.");
+    }
+    return usage;
+}
+async function scientificReviewPrompt(controlRoot, packet, config, policy) {
+    const mandatory = [
+        "Review the exact prepared scientific packet independently. Tools are disabled. Read only embedded content; complete files are bound for audit but are not evidence that you read omitted bytes.",
+        "Return the supplied JSON schema with the exact packetSha256 and reviewerSessionSha256. A mechanical canPass=false cannot be upgraded by prose; return stop, handoff, or revise as appropriate.",
+        JSON.stringify(packet),
+    ];
+    for (const locator of [
+        packet.design.objectLocator,
+        packet.assessment.objectLocator,
+        packet.policy.objectLocator,
+        ...new Set(policy.documents.map((document) => document.objectLocator)),
+    ]) {
+        const path = resolveContained(controlRoot, locator);
+        mandatory.push("### " + locator + "\n" + (await readFile(path, "utf8")));
+    }
+    const maxBytes = config.budget.maxInputContextTokens * RESEARCH_ESTIMATED_BYTES_PER_TOKEN;
+    const required = mandatory.join("\n\n");
+    if (Buffer.byteLength(required) > maxBytes) {
+        throw executionError("RESEARCH_INPUT_CONTEXT_BUDGET_EXCEEDED", "Required scientific review design, policy, and assessment exceed the input context limit; revise the bounded assessment before execution.");
+    }
+    let remaining = maxBytes - Buffer.byteLength(required);
+    const context = [required];
+    for (const [index, record] of packet.stageInputs.entries()) {
+        const allowance = Math.max(0, Math.floor(remaining / (packet.stageInputs.length - index)) - 256);
+        if (!allowance)
+            continue;
+        const path = resolveContained(controlRoot, record.path);
+        const handle = await open(path, "r");
+        let text;
+        try {
+            const buffer = Buffer.alloc(Math.min(record.bytes, allowance));
+            const read = await handle.read(buffer, 0, buffer.length, 0);
+            text = buffer.subarray(0, read.bytesRead).toString("utf8");
+        }
+        finally {
+            await handle.close();
+        }
+        const section = "### " + record.path + " (bounded excerpt; " + record.bytes + " total file bytes)\n" + text;
+        const size = Buffer.byteLength(section);
+        if (size <= remaining) {
+            context.push(section);
+            remaining -= size;
+        }
+    }
+    return context.join("\n\n");
+}
+async function copyPacketInputs(root, capsuleProject, packet, policy) {
+    const paths = workspacePaths(root);
+    const records = new Map(packet.stageInputs.map((record) => [record.path, record.sha256]));
+    records.set(packet.design.objectLocator, packet.design.sha256);
+    records.set(packet.assessment.objectLocator, packet.assessment.sha256);
+    records.set(packet.policy.objectLocator, packet.policy.bindingSha256);
+    for (const document of policy.documents)
+        records.set(document.objectLocator, document.sha256);
+    for (const [locator, digest] of records) {
+        const source = resolveContained(paths.control, locator);
+        const info = await lstat(source).catch(() => null);
+        if (!info?.isFile() || info.isSymbolicLink()) {
+            throw executionError("RESEARCH_SCIENTIFIC_REVIEW_BINDING_INVALID", "A scientific input is missing or unsafe.");
+        }
+        const target = resolveContained(capsuleProject, locator);
+        await ensureDirectory(dirname(target));
+        await copyFile(source, target, constants.COPYFILE_EXCL);
+        if ((await sha256File(target)) !== digest) {
+            throw executionError("RESEARCH_SCIENTIFIC_REVIEW_BINDING_INVALID", "A scientific input changed while staging the reviewer capsule.");
+        }
+    }
+    await writeJsonAtomic(join(capsuleProject, "packet.json"), packet);
+}
+function executionError(code, message) {
+    return new CliError(message, { code, exitCode: 3 });
+}
+//# sourceMappingURL=scientific-review-execution.js.map

package/dist/research/workspace/scientific-review-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scientific-review-execution.js","sourceRoot":"","sources":["../../../src/research/workspace/scientific-review-execution.ts"],"names":[],"mappings":"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"}

package/dist/research/workspace/scientific-review.d.ts

@@ -1,14 +1,109 @@
 import { nextScientificGate } from "./projects.js";
 import { type ScientificObjectKind } from "./scientific-objects.js";
 import type { AgentKind, ProjectState, ScientificReviewRole, ScientificGateStatus } from "./types.js";
+type ReviewDisposition = "pass" | "revise" | "stop" | "handoff";
+interface ScientificFinding {
+    code: string;
+    severity: "blocking" | "warning" | "note";
+    message: string;
+    evidenceIds: string[];
+}
+interface ResearchDesignAssessment {
+    schemaVersion: 1;
+    role: "research-design";
+    designSha256: string;
+    recommendation: ReviewDisposition;
+    checks: {
+        identityCoherent: boolean;
+        estimandObservable: boolean;
+        claimGraphComplete: boolean;
+        endpointTruthRolesCorrect: boolean;
+        quantityOntologyComplete: boolean;
+        validationSemanticsCorrect: boolean;
+        knownGapDispositionComplete: boolean;
+        lifecycleFeasible: boolean;
+    };
+    findings: ScientificFinding[];
+}
+interface EvidenceConstructAssessment {
+    schemaVersion: 1;
+    role: "evidence-construct";
+    designSha256: string;
+    recommendation: ReviewDisposition;
+    constructCanary: {
+        usesRealRecords: boolean;
+        outcomeBlind: boolean;
+        resultValuesInspected: boolean;
+        rowCount: number;
+        constructedEdgeIds: string[];
+        failedEdgeIds: string[];
+        artifactSha256s: string[];
+    };
+    evidenceRoleCoverage: Array<{
+        roleId: string;
+        fullTextSourceIds: string[];
+        independentSourceIds: string[];
+        datedSourceIds: string[];
+        peerReviewedSourceIds: string[];
+        dimensionIds: string[];
+        sourceTypes: string[];
+    }>;
+    closestWorkDispositionComplete: boolean;
+    centralEvidenceFitsContext: boolean;
+    findings: ScientificFinding[];
+}
+interface PilotMethodsAssessment {
+    schemaVersion: 1;
+    role: "pilot-methods";
+    designSha256: string;
+    recommendation: ReviewDisposition;
+    checks: {
+        noDataLeakage: boolean;
+        noCircularValidation: boolean;
+        endpointComparisonsCompatible: boolean;
+        baselineFair: boolean;
+        unitsAndDenominatorsVerified: boolean;
+        thresholdsTyped: boolean;
+        decisionLossMetricsComputed: boolean;
+    };
+    validationAudits: Array<{
+        validationPlanId: string;
+        outcomeBlind: boolean;
+        originalUnitCount: number;
+        independentClusterCount: number;
+        effectiveIndependentUnits: number;
+        clusterKeyIds: string[];
+        independenceJustification: string;
+        resamplingUnit: string;
+        resamplingIterations: number;
+        resamplingMethod: "exact-enumeration" | "cluster-bootstrap" | "none";
+        resamplingStateSpaceSize: number;
+        reportingPrecision: string;
+        minimumDetectableDifference: string | null;
+        independentValidationStatus: "available" | "planned" | "unavailable-scope-bounded" | "not-required";
+        independentValidationGapId: string | null;
+    }>;
+    decisionLossMetricIds: string[];
+    findings: ScientificFinding[];
+}
+type ScientificGateAssessment = ResearchDesignAssessment | EvidenceConstructAssessment | PilotMethodsAssessment;
+interface ScientificReview {
+    schemaVersion: 1;
+    role: ScientificReviewRole;
+    packetSha256: string;
+    reviewerSessionSha256: string;
+    decision: ReviewDisposition;
+    findings: ScientificFinding[];
+    boundedRecommendation: string;
+}
 interface ScientificMechanicalIssue {
     code: string;
     message: string;
     objectIds: string[];
 }
 interface ScientificFutureGateObligation {
-    code: "UNCERTAINTY_STATE_VALUES_NOT_FROZEN" | "MODEL_IMPLEMENTATION_NOT_FROZEN" | "MODEL_ENVIRONMENT_LOCK_NOT_FROZEN";
-    dueGate: "evidence-construct" | "pilot-methods";
+    code: "UNCERTAINTY_STATE_VALUES_NOT_FROZEN" | "MODEL_IMPLEMENTATION_NOT_FROZEN" | "MODEL_ENVIRONMENT_LOCK_NOT_FROZEN" | "POLICY_RULE_DUE_UNRESOLVED";
+    dueGate: "evidence-construct" | "pilot-methods" | "publication-freeze";
     objectIds: string[];
     policyRuleIds: string[];
 }
@@ -96,11 +191,23 @@ export declare function submitScientificReview(input: {
     projectId: string;
     role: ScientificReviewRole;
     reviewPath: string;
+    /** Internal execution recovery: exact matching terminal submissions are read-only replays. */
+    executionBinding?: {
+        packetSha256: string;
+        reviewSha256: string;
+    };
 }): Promise<{
     status: ScientificGateStatus;
     reviewSha256: string;
     issueCodes: string[];
 }>;
+/** Revalidate the immutable prepared packet before an explicit isolated execution. */
+export declare function loadPreparedScientificReview(root: string, projectId: string, role: ScientificReviewRole): Promise<{
+    project: ProjectState;
+    packet: ScientificReviewPacket;
+    assessment: ScientificGateAssessment;
+}>;
+export { readReview as readScientificReviewOutput };
 export declare function assertScientificGateForStage(root: string, project: ProjectState, stage: "discover" | "acquire" | "analyze" | "synthesize" | "review" | "close"): Promise<void>;
 export declare function inspectScientificReviewStatus(root: string, projectId: string): Promise<ScientificReviewStatus>;
-export {};
+declare function readReview(path: string, role: ScientificReviewRole): Promise<ScientificReview>;