@tiangong-ai/cli 0.0.20 → 0.0.21

package/dist/research/workspace/preflight.js

@@ -0,0 +1,261 @@
+import { loadCapabilityDeclarations, verifyCapabilities } from "./capabilities.js";
+import { canonicalJson, sha256Text } from "./storage.js";
+import { loadWorkspaceConfig, verifyDoctorAttestation } from "./workspace.js";
+export const RESEARCH_AGENT_PROTOCOL_OVERHEAD_TOKENS = {
+    codex: 5_000,
+    claude: 12_000,
+};
+export const RESEARCH_ESTIMATED_BYTES_PER_TOKEN = 3;
+export const RESEARCH_MAX_REPAIR_SOURCE_BYTES = 32_000;
+export const RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS = 2;
+export const RESEARCH_BROKER_MAX_TURNS = 6;
+export const RESEARCH_REPAIR_MAX_TURNS = 1;
+export async function evaluateProjectPreflight(root, question, requirements, inputPlan) {
+    const config = await loadWorkspaceConfig(root);
+    const capabilities = await loadCapabilityDeclarations(root);
+    const capabilityVerification = await verifyCapabilities(root);
+    const doctorAttestation = config.mode === "production-research" ? await verifyDoctorAttestation(root) : null;
+    const networkCapabilities = capabilities.capabilities
+        .filter((capability) => capability.permissions.includes("brokered-network"))
+        .map((capability) => ({
+        id: capability.id,
+        allowedHosts: capability.allowedHosts,
+        accept: capability.http?.accept ?? null,
+        maxResponseBytes: capability.http?.maxResponseBytes ?? null,
+        maxItems: capability.http?.maxItems ?? null,
+        coverage: capability.coverage,
+    }));
+    const packageTokens = config.budget.packageMaxTokens;
+    const tokenReservation = Object.values(packageTokens).reduce((sum, value) => sum + value, 0);
+    const wallReservation = Object.values(config.budget.packageMaxWallSeconds).reduce((sum, value) => sum + value, 0);
+    const estimatedMaxCostUsd = config.producer.pricing && config.reviewer.pricing
+        ? roundMoney(reservedAgentPackageCost(config.producer, packageTokens.discover, config) +
+            reservedAgentPackageCost(config.producer, packageTokens.analyze, config) +
+            reservedAgentPackageCost(config.producer, packageTokens.synthesize, config) +
+            reservedAgentPackageCost(config.reviewer, packageTokens.review, config))
+        : null;
+    const gaps = [];
+    if (config.mode === "production-research" && !requirements) {
+        gaps.push("explicit-evidence-requirements-missing");
+    }
+    if (config.mode === "production-research" && (!config.producer.model || !config.reviewer.model)) {
+        gaps.push("explicit-agent-models-missing");
+    }
+    if (config.mode === "production-research" &&
+        (!config.producer.effort || !config.reviewer.effort)) {
+        gaps.push("explicit-agent-effort-missing");
+    }
+    if (config.mode === "production-research" && !config.producer.verbosity) {
+        gaps.push("explicit-codex-verbosity-missing");
+    }
+    if (config.mode === "production-research" &&
+        (!config.producer.pricing || !config.reviewer.pricing)) {
+        gaps.push("explicit-agent-pricing-missing");
+    }
+    if (config.producer.agent === config.reviewer.agent) {
+        gaps.push("independent-review-route-missing");
+    }
+    if (!networkCapabilities.length && !inputPlan)
+        gaps.push("no-evidence-acquisition-plan");
+    if (capabilityVerification.status !== "verified") {
+        gaps.push("capability-lock-missing-or-drifted");
+    }
+    if (doctorAttestation && doctorAttestation.status !== "verified") {
+        gaps.push(`doctor-attestation-${doctorAttestation.status}`);
+    }
+    if (tokenReservation > config.budget.maxTokens) {
+        gaps.push(`package-token-reservations-exceed-total:${tokenReservation}/${config.budget.maxTokens}`);
+    }
+    if (wallReservation > config.budget.maxWallSeconds) {
+        gaps.push(`package-wall-reservations-exceed-total:${wallReservation}/${config.budget.maxWallSeconds}`);
+    }
+    if (estimatedMaxCostUsd !== null && estimatedMaxCostUsd > config.budget.maxCostUsd) {
+        gaps.push(`package-cost-reservations-exceed-total:${estimatedMaxCostUsd}/${config.budget.maxCostUsd}`);
+    }
+    const outputAndRepairReservation = config.budget.maxOutputTokens + config.budget.maxRepairTokens;
+    for (const [stage, tokens] of Object.entries(packageTokens)) {
+        if (tokens < outputAndRepairReservation) {
+            gaps.push(`package-output-repair-reservation-exceeds-${stage}:${outputAndRepairReservation}/${tokens}`);
+        }
+    }
+    const embeddedStageContextReservation = config.budget.maxOutputTokens * 2;
+    if (embeddedStageContextReservation > config.budget.maxInputContextTokens) {
+        gaps.push(`embedded-stage-context-reservation-exceeds-total:${embeddedStageContextReservation}/${config.budget.maxInputContextTokens}`);
+    }
+    const recommendedDiscoverOutputTokens = requirements ? 768 + requirements.minSources * 320 : null;
+    if (config.mode === "production-research" &&
+        recommendedDiscoverOutputTokens !== null &&
+        config.budget.maxOutputTokens < recommendedDiscoverOutputTokens) {
+        gaps.push(`discover-output-reservation-below-schema-recommendation:${config.budget.maxOutputTokens}/${recommendedDiscoverOutputTokens}`);
+    }
+    const estimatedInputContextTokens = inputPlan?.inputs.reduce((sum, input) => sum + Math.ceil((input.contextBytes ?? input.bytes) / 4), 0) ?? 0;
+    if (estimatedInputContextTokens > config.budget.maxInputContextTokens) {
+        gaps.push(`input-context-reservation-exceeds-total:${estimatedInputContextTokens}/${config.budget.maxInputContextTokens}`);
+    }
+    const maxTurns = {
+        discover: networkCapabilities.length
+            ? RESEARCH_BROKER_MAX_TURNS
+            : RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS,
+        analyze: RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS,
+        synthesize: RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS,
+        review: RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS,
+        repair: RESEARCH_REPAIR_MAX_TURNS,
+    };
+    const preCallTokenReservations = {
+        discover: estimatedStageTokenReservation(config.producer, estimatedInputContextTokens, maxTurns.discover, config),
+        analyze: estimatedStageTokenReservation(config.producer, config.budget.maxOutputTokens, RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS, config),
+        synthesize: estimatedStageTokenReservation(config.producer, config.budget.maxOutputTokens * 2, RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS, config),
+        review: estimatedStageTokenReservation(config.reviewer, estimatedInputContextTokens + config.budget.maxOutputTokens * 3 + 2_000, RESEARCH_STRUCTURED_OUTPUT_MAX_TURNS, config),
+    };
+    for (const [stage, reservation] of Object.entries(preCallTokenReservations)) {
+        const configured = packageTokens[stage];
+        if (reservation > configured) {
+            gaps.push(`package-precall-reservation-exceeds-${stage}:${reservation}/${configured}`);
+        }
+    }
+    if (requirements) {
+        appendEvidencePlanGaps(gaps, requirements, inputPlan, networkCapabilities);
+    }
+    const result = {
+        schemaVersion: 1,
+        mode: config.mode,
+        questionSha256: sha256Text(question),
+        evidenceRequirements: requirements,
+        capabilities: networkCapabilities,
+        inputPlan: inputPlan === null
+            ? null
+            : {
+                sha256: inputPlan.sha256,
+                inputs: inputPlan.inputs.map((input) => ({
+                    id: input.id,
+                    role: input.role,
+                    sha256: input.sha256,
+                    bytes: input.bytes,
+                    contextSha256: input.contextSha256,
+                    contextBytes: input.contextBytes,
+                    contextRanges: input.contextRanges ?? null,
+                    dimensions: input.dimensions,
+                    sourceType: input.sourceType,
+                    fullText: input.fullText,
+                    publicationDate: input.publicationDate,
+                })),
+            },
+        capabilityVerification,
+        doctorAttestation: doctorAttestation === null
+            ? null
+            : {
+                status: doctorAttestation.status,
+                errors: doctorAttestation.errors,
+                attestationSha256: doctorAttestation.attestation?.attestationSha256 ?? null,
+                checkedAt: doctorAttestation.attestation?.checkedAt ?? null,
+                expiresAt: doctorAttestation.attestation?.expiresAt ?? null,
+            },
+        gaps,
+        budget: {
+            tokenReservation,
+            wallReservation,
+            maxTokens: config.budget.maxTokens,
+            maxCostUsd: config.budget.maxCostUsd,
+            maxWallSeconds: config.budget.maxWallSeconds,
+            confirmationCostUsd: config.budget.confirmationCostUsd,
+            confirmationRequired: config.budget.maxCostUsd > config.budget.confirmationCostUsd,
+            estimatedMaxCostUsd,
+            maxBrokerContextTokens: config.budget.maxBrokerContextTokens,
+            estimatedInputContextTokens,
+            maxInputContextTokens: config.budget.maxInputContextTokens,
+            embeddedStageContextReservation,
+            recommendedDiscoverOutputTokens,
+            outputTokenLimitEnforcement: {
+                producer: "post-execution",
+                reviewer: "post-execution",
+            },
+            preCallTokenReservations,
+            maxTurns,
+        },
+        executionPolicy: {
+            producer: {
+                agent: config.producer.agent,
+                model: config.producer.model,
+                effort: config.producer.effort ?? null,
+                verbosity: config.producer.verbosity ?? null,
+                wrapperTargetPinned: Boolean(config.producer.wrapperTargetBinary),
+                turnLimitEnforcement: config.producer.agent === "claude" ? "provider" : "reservation-and-post-execution",
+            },
+            reviewer: {
+                agent: config.reviewer.agent,
+                model: config.reviewer.model,
+                effort: config.reviewer.effort ?? null,
+                verbosity: config.reviewer.verbosity ?? null,
+                wrapperTargetPinned: Boolean(config.reviewer.wrapperTargetBinary),
+                turnLimitEnforcement: config.reviewer.agent === "claude" ? "provider" : "reservation-and-post-execution",
+            },
+        },
+        readyToInitialize: capabilityVerification.status === "verified" &&
+            (config.mode === "smoke-test" || Boolean(requirements)) &&
+            gaps.length === 0,
+    };
+    return { ...result, preflightSha256: sha256Text(canonicalJson(result)) };
+}
+function estimatedStageTokenReservation(route, embeddedContextTokens, primaryMaxTurns, config) {
+    const protocolOverhead = RESEARCH_AGENT_PROTOCOL_OVERHEAD_TOKENS[route.agent];
+    const primaryPromptAndSchemaAllowance = 4_000;
+    const primaryInput = (protocolOverhead + embeddedContextTokens + primaryPromptAndSchemaAllowance) * primaryMaxTurns;
+    const repairInput = protocolOverhead +
+        Math.ceil((RESEARCH_MAX_REPAIR_SOURCE_BYTES + 2_048) / RESEARCH_ESTIMATED_BYTES_PER_TOKEN);
+    return (primaryInput +
+        config.budget.maxOutputTokens +
+        repairInput * RESEARCH_REPAIR_MAX_TURNS +
+        config.budget.maxRepairTokens);
+}
+export function reservedAgentPackageCost(route, tokens, config) {
+    if (!route.pricing)
+        return 0;
+    const maximumOutputTokens = Math.min(tokens, config.budget.maxOutputTokens + config.budget.maxRepairTokens);
+    const maximumInputTokens = Math.max(0, tokens - maximumOutputTokens);
+    const inputRate = Math.max(route.pricing.inputUsdPerMillionTokens, route.pricing.cachedInputUsdPerMillionTokens);
+    return ((maximumInputTokens * inputRate +
+        maximumOutputTokens * route.pricing.outputUsdPerMillionTokens) /
+        1_000_000);
+}
+function appendEvidencePlanGaps(gaps, requirements, inputPlan, networkCapabilities) {
+    const declaredCoverage = networkCapabilities.flatMap((capability) => capability.coverage ? [capability.coverage] : []);
+    const dimensions = new Set([
+        ...declaredCoverage.flatMap((coverage) => coverage.dimensions),
+        ...(inputPlan?.inputs.flatMap((input) => input.dimensions) ?? []),
+    ]);
+    const sourceTypes = new Set([
+        ...declaredCoverage.flatMap((coverage) => coverage.sourceTypes),
+        ...(inputPlan?.inputs.map((input) => input.sourceType) ?? []),
+    ]);
+    for (const dimension of requirements.dimensions) {
+        if (!dimensions.has(dimension))
+            gaps.push(`evidence-plan-dimension-uncovered:${dimension}`);
+    }
+    for (const sourceType of requirements.sourceTypes) {
+        if (!sourceTypes.has(sourceType)) {
+            gaps.push(`evidence-plan-source-type-uncovered:${sourceType}`);
+        }
+    }
+    const canDiscoverFullText = declaredCoverage.some((coverage) => coverage.fullText);
+    const canDiscoverDates = declaredCoverage.some((coverage) => coverage.publicationDates);
+    const plannedInputCount = inputPlan?.inputs.length ?? 0;
+    const plannedFullTextCount = inputPlan?.inputs.filter((input) => input.fullText).length ?? 0;
+    const plannedDatedCount = inputPlan?.inputs.filter((input) => input.publicationDate !== null &&
+        (requirements.publicationDateFrom === null ||
+            input.publicationDate >= requirements.publicationDateFrom) &&
+        (requirements.publicationDateTo === null ||
+            input.publicationDate <= requirements.publicationDateTo)).length ?? 0;
+    if (!networkCapabilities.length && plannedInputCount < requirements.minSources) {
+        gaps.push(`evidence-plan-min-sources-insufficient:${plannedInputCount}/${requirements.minSources}`);
+    }
+    if (requirements.minFullTextSources > plannedFullTextCount && !canDiscoverFullText) {
+        gaps.push(`evidence-plan-full-text-insufficient:${plannedFullTextCount}/${requirements.minFullTextSources}`);
+    }
+    if (requirements.minDatedSources > plannedDatedCount && !canDiscoverDates) {
+        gaps.push(`evidence-plan-dated-sources-insufficient:${plannedDatedCount}/${requirements.minDatedSources}`);
+    }
+}
+function roundMoney(value) {
+    return Math.round(value * 1_000_000) / 1_000_000;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/research/workspace/preflight.js.map

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

package/dist/research/workspace/projects.d.ts

@@ -1,9 +1,12 @@
-import type { ProjectInput, ProjectState, WorkPackage } from "./types.js";
-export declare function initializeProject(root: string, projectId: string, question: string): Promise<ProjectState>;
+import type { ProjectEvidenceRequirements, ProjectInput, ProjectState, WorkPackage, VerifiedProjectInputPlan } from "./types.js";
+export declare function initializeProject(root: string, projectId: string, question: string, evidenceRequirements?: ProjectEvidenceRequirements, budgetConfirmed?: boolean, inputPlan?: VerifiedProjectInputPlan): Promise<ProjectState>;
 export declare function addProjectInput(root: string, projectId: string, inputPath: string, role: ProjectInput["role"]): Promise<ProjectInput>;
 export declare function loadProject(root: string, projectId: string): Promise<ProjectState>;
 export declare function listProjects(root: string): Promise<ProjectState[]>;
 export declare function saveProject(root: string, project: ProjectState): Promise<void>;
+export declare function retryProjectPackage(root: string, projectId: string, packageId?: string): Promise<ProjectState>;
+export declare function forkProject(root: string, sourceProjectId: string, targetProjectId: string, resumeThrough?: "discover" | "analyze" | "synthesize"): Promise<ProjectState>;
 export declare function refreshProject(project: ProjectState): ProjectState;
 export declare function nextReadyPackage(project: ProjectState): WorkPackage | undefined;
 export declare function packageById(project: ProjectState, packageId: string): WorkPackage;
+export declare function normalizeEvidenceRequirements(value: ProjectEvidenceRequirements): ProjectEvidenceRequirements;

package/dist/research/workspace/projects.js

@@ -1,13 +1,16 @@
 import { randomUUID } from "node:crypto";
-import { lstat, readdir } from "node:fs/promises";
-import { basename, join, resolve, sep } from "node:path";
+import { cp, lstat, readdir } from "node:fs/promises";
+import { basename, dirname, join, resolve, sep } from "node:path";
 import { CliError } from "../../errors.js";
 import { RESEARCH_CONTROL_DIRECTORY } from "./constants.js";
 import { appendJournalEvent } from "./journal.js";
-import { ensureDirectory, fileSize, readJsonFile, sha256File, workspacePaths, writeJsonAtomic, } from "./storage.js";
+import { cloneProjectEvidenceReceipts } from "./evidence.js";
+import { projectInputsFromPlan, reverifyProjectInputPlan } from "./input-plan.js";
+import { evaluateProjectPreflight } from "./preflight.js";
+import { ensureDirectory, fileRecord, fileSize, readJsonFile, sha256File, workspacePaths, writeJsonAtomic, } from "./storage.js";
 import { loadWorkspaceConfig, withWorkspaceLock } from "./workspace.js";
 const PROJECT_ID_PATTERN = /^[a-z0-9][a-z0-9-]{2,63}$/;
-export async function initializeProject(root, projectId, question) {
+export async function initializeProject(root, projectId, question, evidenceRequirements, budgetConfirmed = false, inputPlan) {
     validateProjectId(projectId);
     const normalizedQuestion = question.trim();
     if (normalizedQuestion.length < 8 || normalizedQuestion.length > 4000) {
@@ -28,6 +31,36 @@ export async function initializeProject(root, projectId, question) {
             });
         }
         const config = await loadWorkspaceConfig(root);
+        if (config.mode === "production-research" && !evidenceRequirements) {
+            throw new CliError("Production research requires explicit evidence requirements.", {
+                code: "RESEARCH_EVIDENCE_REQUIREMENTS_REQUIRED",
+                exitCode: 2,
+            });
+        }
+        if (config.mode === "production-research" &&
+            config.budget.maxCostUsd > config.budget.confirmationCostUsd &&
+            !budgetConfirmed) {
+            throw new CliError(`Production budget requires explicit confirmation above $${config.budget.confirmationCostUsd}.`, {
+                code: "RESEARCH_BUDGET_CONFIRMATION_REQUIRED",
+                exitCode: 2,
+                details: {
+                    maxCostUsd: config.budget.maxCostUsd,
+                    confirmationCostUsd: config.budget.confirmationCostUsd,
+                },
+            });
+        }
+        const requirements = normalizeEvidenceRequirements(evidenceRequirements ?? defaultEvidenceRequirements(config));
+        const admittedInputPlan = inputPlan ? await reverifyProjectInputPlan(inputPlan) : undefined;
+        if (config.mode === "production-research") {
+            const preflight = await evaluateProjectPreflight(root, normalizedQuestion, requirements, admittedInputPlan ?? null);
+            if (!preflight.readyToInitialize) {
+                throw new CliError("Production project initialization was blocked by preflight.", {
+                    code: "RESEARCH_PREFLIGHT_BLOCKED",
+                    exitCode: 3,
+                    details: { gaps: preflight.gaps, preflightSha256: preflight.preflightSha256 },
+                });
+            }
+        }
         const now = new Date().toISOString();
         const project = {
             schemaVersion: 1,
@@ -36,9 +69,18 @@ export async function initializeProject(root, projectId, question) {
             status: "ready",
             createdAt: now,
             updatedAt: now,
-            inputs: [],
+            budgetConfirmedAt: budgetConfirmed ? now : null,
+            inputs: admittedInputPlan ? projectInputsFromPlan(admittedInputPlan, now) : [],
+            evidenceRequirements: requirements,
             packages: defaultWorkPackages(config),
-            usage: { tokens: 0, costUsd: 0, wallSeconds: 0 },
+            usage: {
+                tokens: 0,
+                inputTokens: 0,
+                cachedInputTokens: 0,
+                outputTokens: 0,
+                costUsd: 0,
+                wallSeconds: 0,
+            },
         };
         await Promise.all([
             ensureDirectory(projectRoot),
@@ -49,6 +91,13 @@ export async function initializeProject(root, projectId, question) {
         await appendJournalEvent(paths.journal, "project.initialized", projectId, {
             projectId,
             questionSha256: await hashQuestion(normalizedQuestion),
+            inputPlanSha256: admittedInputPlan?.sha256 ?? null,
+            inputs: project.inputs.map((input) => ({
+                id: input.id,
+                role: input.role,
+                sha256: input.sha256,
+                bytes: input.bytes,
+            })),
         });
         return project;
     });
@@ -123,10 +172,156 @@ export async function saveProject(root, project) {
     validateProjectShape(project, project.id);
     await writeJsonAtomic(join(workspacePaths(root).projects, project.id, "project.json"), project);
 }
+export async function retryProjectPackage(root, projectId, packageId) {
+    validateProjectId(projectId);
+    return withWorkspaceLock(root, "project.retry", async () => {
+        const project = await loadProject(root, projectId);
+        const selected = packageId
+            ? packageById(project, packageId)
+            : project.packages.find((item) => item.status === "failed" || item.status === "retry");
+        if (!selected || (selected.status !== "failed" && selected.status !== "retry")) {
+            throw new CliError("Project retry requires a failed or retryable package.", {
+                code: "RESEARCH_RETRY_NOT_AVAILABLE",
+                exitCode: 2,
+            });
+        }
+        const selectedIndex = project.packages.indexOf(selected);
+        const previous = {
+            status: selected.status,
+            attempts: selected.attempts,
+            failureKind: selected.lastFailureKind,
+        };
+        for (const [index, workPackage] of project.packages.entries()) {
+            if (index < selectedIndex)
+                continue;
+            workPackage.status = index === selectedIndex ? "ready" : "pending";
+            workPackage.maxAttempts = Math.max(workPackage.maxAttempts, workPackage.attempts + 1);
+            workPackage.startedAt = null;
+            workPackage.completedAt = null;
+            workPackage.lastError = null;
+            workPackage.lastFailureKind = null;
+            workPackage.retryNotBefore = null;
+        }
+        project.status = "ready";
+        project.updatedAt = new Date().toISOString();
+        await saveProject(root, project);
+        await appendJournalEvent(workspacePaths(root).journal, "project.retry.requested", projectId, {
+            projectId,
+            packageId: selected.id,
+            previous,
+            preservedOutputs: true,
+        });
+        return project;
+    });
+}
+export async function forkProject(root, sourceProjectId, targetProjectId, resumeThrough) {
+    validateProjectId(sourceProjectId);
+    validateProjectId(targetProjectId);
+    if (sourceProjectId === targetProjectId) {
+        throw new CliError("Fork target must use a different project ID.", {
+            code: "RESEARCH_PROJECT_FORK_INVALID",
+            exitCode: 2,
+        });
+    }
+    return withWorkspaceLock(root, "project.fork", async () => {
+        const source = await loadProject(root, sourceProjectId);
+        const targetRoot = join(workspacePaths(root).projects, targetProjectId);
+        if (await lstat(targetRoot).catch(() => undefined)) {
+            throw new CliError(`Research project already exists: ${targetProjectId}`, {
+                code: "RESEARCH_PROJECT_EXISTS",
+                exitCode: 2,
+            });
+        }
+        const config = await loadWorkspaceConfig(root);
+        const packages = defaultWorkPackages(config);
+        const inheritedStages = resumeThrough
+            ? ["discover", "analyze", "synthesize"].slice(0, ["discover", "analyze", "synthesize"].indexOf(resumeThrough) + 1)
+            : [];
+        for (const stage of inheritedStages) {
+            const sourcePackage = source.packages.find((item) => item.stage === stage);
+            if (sourcePackage?.status !== "complete") {
+                throw new CliError(`Cannot fork through incomplete package: ${stage}.`, {
+                    code: "RESEARCH_PROJECT_FORK_INVALID",
+                    exitCode: 2,
+                });
+            }
+        }
+        const now = new Date().toISOString();
+        for (const workPackage of packages) {
+            if (inheritedStages.includes(workPackage.stage)) {
+                workPackage.status = "complete";
+                workPackage.completedAt = now;
+            }
+        }
+        const project = {
+            schemaVersion: 1,
+            id: targetProjectId,
+            question: source.question,
+            status: "ready",
+            createdAt: now,
+            updatedAt: now,
+            budgetConfirmedAt: source.budgetConfirmedAt,
+            inputs: source.inputs.map((input) => ({ ...input })),
+            evidenceRequirements: {
+                ...source.evidenceRequirements,
+                dimensions: [...source.evidenceRequirements.dimensions],
+                sourceTypes: [...source.evidenceRequirements.sourceTypes],
+            },
+            packages,
+            usage: {
+                tokens: 0,
+                inputTokens: 0,
+                cachedInputTokens: 0,
+                outputTokens: 0,
+                costUsd: 0,
+                wallSeconds: 0,
+            },
+        };
+        await Promise.all([
+            ensureDirectory(targetRoot),
+            ensureDirectory(join(targetRoot, "outputs")),
+            ensureDirectory(join(targetRoot, "runs")),
+        ]);
+        const inheritedOutputs = [];
+        const stageOutput = {
+            discover: "outputs/evidence.json",
+            analyze: "outputs/analysis.json",
+            synthesize: "outputs/report.md",
+        };
+        for (const stage of inheritedStages) {
+            const logicalPath = stageOutput[stage];
+            const sourcePath = join(workspacePaths(root).projects, sourceProjectId, logicalPath);
+            const record = await fileRecord(sourcePath, logicalPath);
+            const destination = join(targetRoot, logicalPath);
+            await ensureDirectory(dirname(destination));
+            await cp(sourcePath, destination, { errorOnExist: true, force: false });
+            inheritedOutputs.push(record);
+        }
+        if (inheritedStages.includes("discover")) {
+            await cloneProjectEvidenceReceipts(root, sourceProjectId, targetProjectId);
+        }
+        refreshProject(project);
+        await writeJsonAtomic(join(targetRoot, "project.json"), project);
+        await appendJournalEvent(workspacePaths(root).journal, "project.forked", targetProjectId, {
+            sourceProjectId,
+            targetProjectId,
+            resumeThrough: resumeThrough ?? null,
+            inheritedOutputs,
+            inheritedUsage: false,
+        });
+        return project;
+    });
+}
 export function refreshProject(project) {
+    const now = Date.now();
     for (const workPackage of project.packages) {
         if (workPackage.status !== "pending" && workPackage.status !== "retry")
             continue;
+        if (workPackage.status === "retry" &&
+            workPackage.retryNotBefore &&
+            Date.parse(workPackage.retryNotBefore) > now) {
+            continue;
+        }
         const dependenciesComplete = workPackage.dependencies.every((dependency) => project.packages.find((candidate) => candidate.id === dependency)?.status === "complete");
         if (dependenciesComplete)
             workPackage.status = "ready";
@@ -178,6 +373,8 @@ function workPackage(id, stage, kind, executor, dependencies, expectedOutputs, m
         attempts: 0,
         maxAttempts,
         lastError: null,
+        lastFailureKind: null,
+        retryNotBefore: null,
         startedAt: null,
         completedAt: null,
     };
@@ -187,10 +384,15 @@ function validateProjectShape(project, expectedId) {
         project.id !== expectedId ||
         !PROJECT_ID_PATTERN.test(project.id) ||
         typeof project.question !== "string" ||
+        (project.budgetConfirmedAt !== null && typeof project.budgetConfirmedAt !== "string") ||
         !Array.isArray(project.inputs) ||
+        !isEvidenceRequirements(project.evidenceRequirements) ||
         !Array.isArray(project.packages) ||
         !project.usage ||
         typeof project.usage.tokens !== "number" ||
+        typeof project.usage.inputTokens !== "number" ||
+        typeof project.usage.cachedInputTokens !== "number" ||
+        typeof project.usage.outputTokens !== "number" ||
         typeof project.usage.costUsd !== "number" ||
         typeof project.usage.wallSeconds !== "number") {
         throw new CliError(`Research project state is invalid: ${expectedId}`, {
@@ -210,6 +412,88 @@ function validateProjectShape(project, expectedId) {
         });
     }
 }
+function defaultEvidenceRequirements(config) {
+    return config.mode === "production-research"
+        ? {
+            dimensions: ["research-question"],
+            sourceTypes: ["primary"],
+            minSources: 3,
+            minFullTextSources: 1,
+            minDatedSources: 1,
+            publicationDateFrom: null,
+            publicationDateTo: null,
+        }
+        : {
+            dimensions: ["research-question"],
+            sourceTypes: [],
+            minSources: 1,
+            minFullTextSources: 0,
+            minDatedSources: 0,
+            publicationDateFrom: null,
+            publicationDateTo: null,
+        };
+}
+export function normalizeEvidenceRequirements(value) {
+    const normalized = {
+        dimensions: [...new Set(value.dimensions.map(normalizeRequirementId))].sort(),
+        sourceTypes: [...new Set(value.sourceTypes.map(normalizeRequirementId))].sort(),
+        minSources: value.minSources,
+        minFullTextSources: value.minFullTextSources,
+        minDatedSources: value.minDatedSources,
+        publicationDateFrom: value.publicationDateFrom,
+        publicationDateTo: value.publicationDateTo,
+    };
+    if (!isEvidenceRequirements(normalized)) {
+        throw new CliError("Evidence requirements are invalid.", {
+            code: "RESEARCH_EVIDENCE_REQUIREMENTS_INVALID",
+            exitCode: 2,
+        });
+    }
+    return normalized;
+}
+function isEvidenceRequirements(value) {
+    return (Boolean(value) &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        Array.isArray(value.dimensions) &&
+        value.dimensions.length > 0 &&
+        value.dimensions.every(validRequirementId) &&
+        Array.isArray(value.sourceTypes) &&
+        value.sourceTypes.every(validRequirementId) &&
+        Number.isInteger(value.minSources) &&
+        value.minSources > 0 &&
+        Number.isInteger(value.minFullTextSources) &&
+        value.minFullTextSources >= 0 &&
+        value.minFullTextSources <=
+            value.minSources &&
+        Number.isInteger(value.minDatedSources) &&
+        value.minDatedSources >= 0 &&
+        value.minDatedSources <=
+            value.minSources &&
+        validDateBoundary(value.publicationDateFrom) &&
+        validDateBoundary(value.publicationDateTo) &&
+        dateRangeOrdered(value.publicationDateFrom, value.publicationDateTo));
+}
+function validDateBoundary(value) {
+    if (value === null)
+        return true;
+    if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const timestamp = Date.parse(`${value}T00:00:00.000Z`);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString().slice(0, 10) === value;
+}
+function dateRangeOrdered(from, to) {
+    return from === null || to === null || from <= to;
+}
+function normalizeRequirementId(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._:-]+/g, "-");
+}
+function validRequirementId(value) {
+    return typeof value === "string" && /^[a-z0-9][a-z0-9._:-]{0,127}$/.test(value);
+}
 function validateProjectId(projectId) {
     if (!PROJECT_ID_PATTERN.test(projectId)) {
         throw new CliError("Project ID must contain 3-64 lowercase letters, digits, or hyphens and start with a letter or digit.", { code: "RESEARCH_PROJECT_ID_INVALID", exitCode: 2 });