@tiangong-ai/cli 0.0.36 → 0.0.37

package/dist/research/workspace/evidence-exhaustion.d.ts

@@ -0,0 +1,45 @@
+import type { ScientificDesignContract } from "./scientific-design.js";
+import type { ProjectState, ResearchAccessRequest, ResearchEvidenceExhaustion } from "./types.js";
+type TerminalClassification = "completed-insufficient" | "access-blocked" | "deterministic-unavailable";
+interface TerminalRouteEvent {
+    hash: string;
+    type: string;
+    timestamp: string;
+    classification: TerminalClassification;
+    journal: "workspace" | "evidence-ledger";
+}
+export interface EvidenceAccessRouteStatus {
+    id: string;
+    evidenceRoleIds: string[];
+    routeClass: ScientificDesignContract["acquisitionPlan"]["routes"][number]["routeClass"];
+    executor: ScientificDesignContract["acquisitionPlan"]["routes"][number]["executor"];
+    required: boolean;
+    accessMode: ScientificDesignContract["acquisitionPlan"]["routes"][number]["accessMode"];
+    terminalEventHashes: string[];
+    terminalEvents: TerminalRouteEvent[];
+    exhausted: boolean;
+}
+export interface EvidenceAccessStatus {
+    schemaVersion: 1;
+    projectId: string;
+    designSha256: string;
+    requiredEvidenceRoleIds: string[];
+    routes: EvidenceAccessRouteStatus[];
+    untriedRequiredAgentRouteIds: string[];
+    allRequiredAgentRoutesExhausted: boolean;
+    recommendedAction: "continue-plan-bound-agent-routes" | "assess-required-evidence-role-coverage";
+    ifEvidenceStillInsufficient: "request-reviewed-access-handoff" | "scope-pivot-required" | null;
+}
+export interface ParsedEvidenceExhaustionHandoff {
+    exhaustion: ResearchEvidenceExhaustion;
+    accessRequests: ResearchAccessRequest[];
+}
+export declare function inspectEvidenceAccessStatus(root: string, projectId: string): Promise<EvidenceAccessStatus>;
+export declare function parseEvidenceExhaustionHandoff(exhaustionValue: unknown, accessRequestsValue: unknown): ParsedEvidenceExhaustionHandoff;
+export declare function validateEvidenceExhaustionHandoff(input: {
+    root: string;
+    project: ProjectState;
+    state: "user-action-required" | "external-response-required";
+    value: ParsedEvidenceExhaustionHandoff;
+}): Promise<ParsedEvidenceExhaustionHandoff>;
+export {};

package/dist/research/workspace/evidence-exhaustion.js

@@ -0,0 +1,365 @@
+import { CliError } from "../../errors.js";
+import { loadBoundAcquisitionDesign } from "./acquisition-routes.js";
+import { evidenceLedgerPath, verifyEvidenceLedger } from "./evidence-ledger.js";
+import { readJournal, verifyJournal } from "./journal.js";
+import { loadProject } from "./projects.js";
+import { isObject, workspacePaths } from "./storage.js";
+const IDENTIFIER = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+const SHA256 = /^[a-f0-9]{64}$/;
+const SENSITIVE_QUERY_KEY = /^(?:access[_-]?token|api[_-]?key|apikey|auth|authorization|awsaccesskeyid|code|cookie|credential|key|password|secret|session(?:[_-]?id)?|sig|signature|token|x[_-]amz[_-](?:credential|security[_-]?token|signature)|x[_-]goog[_-](?:credential|signature))$/i;
+const TRACKING_QUERY_KEY = /^(?:utm_[a-z0-9_]+|fbclid|gclid|mc_cid|mc_eid|ref|source)$/i;
+export async function inspectEvidenceAccessStatus(root, projectId) {
+    const project = await loadProject(root, projectId);
+    const design = await loadBoundAcquisitionDesign(root, project);
+    const paths = workspacePaths(root);
+    const ledgerPath = evidenceLedgerPath(root, project.id);
+    await Promise.all([verifyJournal(paths.journal), verifyEvidenceLedger(root, project.id)]);
+    const [workspaceEvents, ledgerEvents] = await Promise.all([
+        readJournal(paths.journal),
+        readJournal(ledgerPath),
+    ]);
+    const routes = design.acquisitionPlan.routes.map((route) => {
+        const terminalEvents = terminalEventsForRoute(project.id, route, workspaceEvents, ledgerEvents);
+        return {
+            id: route.id,
+            evidenceRoleIds: [...route.evidenceRoleIds],
+            routeClass: route.routeClass,
+            executor: route.executor,
+            required: route.required,
+            accessMode: route.accessMode,
+            terminalEventHashes: terminalEvents.map((event) => event.hash),
+            terminalEvents,
+            exhausted: terminalEvents.length > 0,
+        };
+    });
+    const untriedRequiredAgentRouteIds = routes
+        .filter((route) => route.required && route.executor === "agent" && !route.exhausted)
+        .map((route) => route.id);
+    const nonAgentRoutes = routes.filter((route) => route.required && route.executor !== "agent");
+    return {
+        schemaVersion: 1,
+        projectId: project.id,
+        designSha256: project.scientificDesign.designSha256,
+        requiredEvidenceRoleIds: design.evidenceRoles
+            .filter((role) => role.required)
+            .map((role) => role.id),
+        routes,
+        untriedRequiredAgentRouteIds,
+        allRequiredAgentRoutesExhausted: untriedRequiredAgentRouteIds.length === 0,
+        recommendedAction: untriedRequiredAgentRouteIds.length > 0
+            ? "continue-plan-bound-agent-routes"
+            : "assess-required-evidence-role-coverage",
+        ifEvidenceStillInsufficient: untriedRequiredAgentRouteIds.length > 0
+            ? null
+            : nonAgentRoutes.length > 0
+                ? "request-reviewed-access-handoff"
+                : "scope-pivot-required",
+    };
+}
+export function parseEvidenceExhaustionHandoff(exhaustionValue, accessRequestsValue) {
+    if (!isObject(exhaustionValue))
+        throw invalidHandoff();
+    assertExactKeys(exhaustionValue, [
+        "missingEvidenceRoleIds",
+        "routeAttempts",
+        "remainingRouteIds",
+    ]);
+    const missingEvidenceRoleIds = stringSet(exhaustionValue.missingEvidenceRoleIds, 1, 100, IDENTIFIER);
+    const remainingRouteIds = stringSet(exhaustionValue.remainingRouteIds, 0, 100, IDENTIFIER);
+    if (!Array.isArray(exhaustionValue.routeAttempts) || exhaustionValue.routeAttempts.length < 1) {
+        throw invalidHandoff();
+    }
+    const routeAttempts = exhaustionValue.routeAttempts.map((attempt) => {
+        if (!isObject(attempt))
+            throw invalidHandoff();
+        assertExactKeys(attempt, ["routeId", "terminalEventHashes", "outcome"]);
+        if (typeof attempt.routeId !== "string" ||
+            !IDENTIFIER.test(attempt.routeId) ||
+            !["completed-insufficient", "access-blocked", "deterministic-unavailable"].includes(String(attempt.outcome))) {
+            throw invalidHandoff();
+        }
+        return {
+            routeId: attempt.routeId,
+            terminalEventHashes: stringSet(attempt.terminalEventHashes, 1, 100, SHA256),
+            outcome: attempt.outcome,
+        };
+    });
+    if (new Set(routeAttempts.map((attempt) => attempt.routeId)).size !== routeAttempts.length) {
+        throw invalidHandoff();
+    }
+    if (!Array.isArray(accessRequestsValue) || accessRequestsValue.length > 100) {
+        throw invalidHandoff();
+    }
+    const accessRequests = accessRequestsValue.map(parseAccessRequest);
+    if (new Set(accessRequests.map((request) => request.id)).size !== accessRequests.length) {
+        throw invalidHandoff();
+    }
+    return {
+        exhaustion: { missingEvidenceRoleIds, routeAttempts, remainingRouteIds },
+        accessRequests,
+    };
+}
+export async function validateEvidenceExhaustionHandoff(input) {
+    const status = await inspectEvidenceAccessStatus(input.root, input.project.id);
+    const routeById = new Map(status.routes.map((route) => [route.id, route]));
+    const requiredRoles = new Set(status.requiredEvidenceRoleIds);
+    const missingRoles = new Set(input.value.exhaustion.missingEvidenceRoleIds);
+    if ([...missingRoles].some((roleId) => !requiredRoles.has(roleId)))
+        throw unproven();
+    const relevantAgentRoutes = status.routes.filter((route) => route.required &&
+        route.executor === "agent" &&
+        route.evidenceRoleIds.some((roleId) => missingRoles.has(roleId)));
+    const attemptByRoute = new Map(input.value.exhaustion.routeAttempts.map((attempt) => [attempt.routeId, attempt]));
+    if (attemptByRoute.size !== relevantAgentRoutes.length ||
+        relevantAgentRoutes.some((route) => !attemptByRoute.has(route.id))) {
+        throw unproven();
+    }
+    for (const route of relevantAgentRoutes) {
+        const attempt = attemptByRoute.get(route.id);
+        const terminalByHash = new Map(route.terminalEvents.map((event) => [event.hash, event]));
+        if (attempt.terminalEventHashes.some((hash) => terminalByHash.get(hash)?.classification !== attempt.outcome)) {
+            throw unproven();
+        }
+    }
+    const relevantNonAgentRoutes = status.routes.filter((route) => route.required &&
+        route.executor !== "agent" &&
+        route.evidenceRoleIds.some((roleId) => missingRoles.has(roleId)));
+    const remainingRoutes = input.value.exhaustion.remainingRouteIds.map((routeId) => routeById.get(routeId));
+    const expectedExecutor = input.state === "user-action-required" ? "user" : "external-party";
+    if (remainingRoutes.some((route) => !route ||
+        !route.required ||
+        route.executor !== expectedExecutor ||
+        !route.evidenceRoleIds.some((roleId) => missingRoles.has(roleId))) ||
+        (remainingRoutes.length === 0
+            ? relevantNonAgentRoutes.length > 0 || input.state !== "user-action-required"
+            : [...missingRoles].some((roleId) => !remainingRoutes.some((route) => route?.evidenceRoleIds.includes(roleId))))) {
+        throw unproven();
+    }
+    const requestByRoute = new Map(input.value.accessRequests.map((request) => [request.routeId, request]));
+    if (requestByRoute.size !== remainingRoutes.length ||
+        input.value.exhaustion.remainingRouteIds.some((routeId) => !requestByRoute.has(routeId))) {
+        throw invalidHandoff();
+    }
+    const triedRouteIds = new Set(input.value.exhaustion.routeAttempts.map((attempt) => attempt.routeId));
+    const coveredRoles = new Set();
+    for (const route of remainingRoutes) {
+        const request = requestByRoute.get(route.id);
+        if (request.evidenceRoleIds.some((roleId) => !missingRoles.has(roleId) || !route.evidenceRoleIds.includes(roleId)) ||
+            request.alternativesTriedRouteIds.length !== triedRouteIds.size ||
+            request.alternativesTriedRouteIds.some((routeId) => !triedRouteIds.has(routeId)) ||
+            !resourceTypeMatchesRoute(request.resourceType, route.routeClass)) {
+            throw invalidHandoff();
+        }
+        request.evidenceRoleIds.forEach((roleId) => coveredRoles.add(roleId));
+    }
+    if (remainingRoutes.length > 0 && [...missingRoles].some((roleId) => !coveredRoles.has(roleId))) {
+        throw invalidHandoff();
+    }
+    return input.value;
+}
+function terminalEventsForRoute(projectId, route, workspaceEvents, ledgerEvents) {
+    const events = [];
+    for (const event of workspaceEvents) {
+        if (event.scope !== projectId || event.payload.projectId !== projectId)
+            continue;
+        const classification = workspaceTerminalClassification(route, event);
+        if (classification) {
+            events.push({
+                hash: event.hash,
+                type: event.type,
+                timestamp: event.timestamp,
+                classification,
+                journal: "workspace",
+            });
+        }
+    }
+    for (const event of ledgerEvents) {
+        if (event.scope !== projectId || event.payload.projectId !== projectId)
+            continue;
+        const classification = ledgerTerminalClassification(route, event);
+        if (classification) {
+            events.push({
+                hash: event.hash,
+                type: event.type,
+                timestamp: event.timestamp,
+                classification,
+                journal: "evidence-ledger",
+            });
+        }
+    }
+    return events.sort((left, right) => left.timestamp.localeCompare(right.timestamp) || left.hash.localeCompare(right.hash));
+}
+function workspaceTerminalClassification(route, event) {
+    if (route.routeClass !== "broker-capability" ||
+        event.payload.acquisitionRouteId !== route.id ||
+        event.payload.capabilityId !== route.capabilityId) {
+        return null;
+    }
+    if (["capability.fetch.completed", "capability.fetch.reused"].includes(event.type)) {
+        return "completed-insufficient";
+    }
+    if (event.type !== "capability.fetch.failed")
+        return null;
+    const failureKind = String(event.payload.failureKind);
+    if (failureKind === "authentication")
+        return "access-blocked";
+    return null;
+}
+function ledgerTerminalClassification(route, event) {
+    if (route.routeClass === "native-discovery") {
+        if (event.type !== "activity.recorded" ||
+            event.payload.acquisitionRouteId !== route.id ||
+            event.payload.kind !== route.activityKind ||
+            event.payload.channel !== route.activityChannel) {
+            return null;
+        }
+        if (event.payload.status === "completed")
+            return "completed-insufficient";
+        return null;
+    }
+    if (!["open-access-download", "authorized-browser"].includes(route.routeClass))
+        return null;
+    if (event.payload.acquisitionRouteId !== route.id)
+        return null;
+    const backend = event.payload.backend;
+    if (!route.downloadBackends.includes(backend))
+        return null;
+    if (event.type === "download.bound")
+        return "completed-insufficient";
+    if (event.type !== "download.failed" || event.payload.status === "cancelled")
+        return null;
+    const failureCode = String(event.payload.failureCode ?? "");
+    if (/not-found|unsupported|invalid-content|no-open-access|oa-exhausted|unavailable/i.test(failureCode)) {
+        return "deterministic-unavailable";
+    }
+    return null;
+}
+function parseAccessRequest(value) {
+    if (!isObject(value))
+        throw invalidHandoff();
+    assertExactKeys(value, [
+        "id",
+        "routeId",
+        "resourceType",
+        "resourceName",
+        "officialLocator",
+        "evidenceRoleIds",
+        "rationale",
+        "alternativesTriedRouteIds",
+        "requestedAction",
+        "resumeCriteria",
+        "costStatus",
+    ]);
+    const resourceTypes = [
+        "database-subscription",
+        "article-purchase",
+        "institutional-access",
+        "licensed-dataset",
+        "owner-provided-material",
+        "external-data-request",
+        "field-data-collection",
+    ];
+    if (typeof value.id !== "string" ||
+        !IDENTIFIER.test(value.id) ||
+        typeof value.routeId !== "string" ||
+        !IDENTIFIER.test(value.routeId) ||
+        !resourceTypes.includes(value.resourceType) ||
+        !boundedString(value.resourceName, 3, 500) ||
+        !boundedString(value.rationale, 8, 2_000) ||
+        !boundedString(value.requestedAction, 8, 1_000) ||
+        !boundedString(value.resumeCriteria, 8, 1_000) ||
+        !["unknown", "provider-quote-required"].includes(String(value.costStatus))) {
+        throw invalidHandoff();
+    }
+    const resourceType = value.resourceType;
+    const officialLocator = safeOfficialLocator(value.officialLocator);
+    if ([
+        "database-subscription",
+        "article-purchase",
+        "institutional-access",
+        "licensed-dataset",
+    ].includes(resourceType) &&
+        !officialLocator) {
+        throw invalidHandoff();
+    }
+    return {
+        id: value.id,
+        routeId: value.routeId,
+        resourceType,
+        resourceName: value.resourceName.trim(),
+        officialLocator,
+        evidenceRoleIds: stringSet(value.evidenceRoleIds, 1, 100, IDENTIFIER),
+        rationale: value.rationale.trim(),
+        alternativesTriedRouteIds: stringSet(value.alternativesTriedRouteIds, 1, 100, IDENTIFIER),
+        requestedAction: value.requestedAction.trim(),
+        resumeCriteria: value.resumeCriteria.trim(),
+        costStatus: value.costStatus,
+    };
+}
+function safeOfficialLocator(value) {
+    if (value === null)
+        return null;
+    if (typeof value !== "string" || value.length > 2_000)
+        throw invalidHandoff();
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw invalidHandoff();
+    }
+    if (url.protocol !== "https:" || url.username || url.password || url.hash)
+        throw invalidHandoff();
+    if ([...url.searchParams.keys()].some((key) => SENSITIVE_QUERY_KEY.test(key))) {
+        throw invalidHandoff();
+    }
+    for (const key of [...url.searchParams.keys()]) {
+        if (TRACKING_QUERY_KEY.test(key))
+            url.searchParams.delete(key);
+    }
+    url.searchParams.sort();
+    return url.toString();
+}
+function resourceTypeMatchesRoute(resourceType, routeClass) {
+    if (routeClass === "licensed-resource") {
+        return [
+            "database-subscription",
+            "article-purchase",
+            "institutional-access",
+            "licensed-dataset",
+        ].includes(resourceType);
+    }
+    if (routeClass === "owner-provided-resource")
+        return resourceType === "owner-provided-material";
+    if (routeClass === "external-data-request")
+        return resourceType === "external-data-request";
+    return routeClass === "field-data-collection" && resourceType === "field-data-collection";
+}
+function stringSet(value, minimum, maximum, pattern) {
+    if (!Array.isArray(value) ||
+        value.length < minimum ||
+        value.length > maximum ||
+        value.some((item) => typeof item !== "string" || !pattern.test(item)) ||
+        new Set(value).size !== value.length) {
+        throw invalidHandoff();
+    }
+    return value;
+}
+function assertExactKeys(value, keys) {
+    const expected = new Set(keys);
+    if (Object.keys(value).some((key) => !expected.has(key)))
+        throw invalidHandoff();
+}
+function boundedString(value, minimum, maximum) {
+    return typeof value === "string" && value.trim().length >= minimum && value.length <= maximum;
+}
+function invalidHandoff() {
+    return new CliError("Handoff request failed validation.", {
+        code: "RESEARCH_PROJECT_HANDOFF_INVALID",
+        exitCode: 2,
+    });
+}
+function unproven() {
+    return new CliError("Evidence exhaustion is not proven by every required plan-bound terminal event.", { code: "RESEARCH_EVIDENCE_EXHAUSTION_UNPROVEN", exitCode: 3 });
+}
+//# sourceMappingURL=evidence-exhaustion.js.map

package/dist/research/workspace/evidence-exhaustion.js.map

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

package/dist/research/workspace/native-activity.d.ts

@@ -8,6 +8,11 @@ export declare const nativeActivityRecordSchema: {
             readonly type: "integer";
             readonly const: 1;
         };
+        readonly acquisitionRouteId: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$";
+            readonly description: "Required for a project with a frozen scientific design; binds this event to one exact planned agent route.";
+        };
         readonly kind: {
             readonly type: "string";
             readonly enum: readonly ["web-search", "database-search", "browser-navigation", "download", "file-inspection"];
@@ -48,6 +53,7 @@ export declare const nativeActivityRecordSchema: {
 export interface NativeActivityReceipt {
     activityId: string;
     projectId: string;
+    acquisitionRouteId: string | null;
     stage: "discover" | "acquire";
     kind: string;
     channel: string;

package/dist/research/workspace/native-activity.js

@@ -1,8 +1,9 @@
 import { randomUUID } from "node:crypto";
-import { join } from "node:path";
+import { resolveAgentAcquisitionRoute } from "./acquisition-routes.js";
 import { appendEvidenceLedgerEvent, listEvidenceCandidates } from "./evidence-ledger.js";
+import { loadProject } from "./projects.js";
 import { sanitizeResearchValue } from "./sanitization.js";
-import { canonicalJson, isObject, readJsonFile, sha256Text, workspacePaths } from "./storage.js";
+import { canonicalJson, isObject, sha256Text } from "./storage.js";
 import { StructuredOutputError } from "./schemas.js";
 const IDENTIFIER = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
 export const nativeActivityRecordSchema = {
@@ -21,6 +22,11 @@ export const nativeActivityRecordSchema = {
     ],
     properties: {
         schemaVersion: { type: "integer", const: 1 },
+        acquisitionRouteId: {
+            type: "string",
+            pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
+            description: "Required for a project with a frozen scientific design; binds this event to one exact planned agent route.",
+        },
         kind: {
             type: "string",
             enum: ["web-search", "database-search", "browser-navigation", "download", "file-inspection"],
@@ -61,6 +67,7 @@ export async function recordNativeResearchActivity(input) {
         throw activityError("Native activity record must be a JSON object.");
     const allowed = new Set([
         "schemaVersion",
+        "acquisitionRouteId",
         "kind",
         "channel",
         "input",
@@ -72,6 +79,9 @@ export async function recordNativeResearchActivity(input) {
     const unknown = Object.keys(value).filter((key) => !allowed.has(key));
     if (unknown.length ||
         value.schemaVersion !== 1 ||
+        (value.acquisitionRouteId !== undefined &&
+            (typeof value.acquisitionRouteId !== "string" ||
+                !IDENTIFIER.test(value.acquisitionRouteId))) ||
         ![
             "web-search",
             "database-search",
@@ -106,13 +116,11 @@ export async function recordNativeResearchActivity(input) {
     if (value.challenge !== "none" && value.status !== "blocked") {
         throw activityError("A native challenge must be recorded with blocked status.");
     }
-    const project = await readJsonFile(join(workspacePaths(input.root).projects, input.projectId, "project.json"), `Research project ${input.projectId}`);
-    const packages = Array.isArray(project.packages) ? project.packages : [];
-    const active = packages.find((workPackage) => isObject(workPackage) &&
-        (workPackage.stage === "discover" || workPackage.stage === "acquire") &&
+    const project = await loadProject(input.root, input.projectId);
+    const active = project.packages.find((workPackage) => (workPackage.stage === "discover" || workPackage.stage === "acquire") &&
         workPackage.status === "running" &&
         workPackage.executor === "producer");
-    if (!isObject(active) || (active.stage !== "discover" && active.stage !== "acquire")) {
+    if (!active || (active.stage !== "discover" && active.stage !== "acquire")) {
         throw activityError("Native activity may be recorded only during an active discover or acquire stage.");
     }
     const stage = active.stage;
@@ -121,6 +129,14 @@ export async function recordNativeResearchActivity(input) {
         (stage === "acquire" && ["web-search", "database-search"].includes(kind))) {
         throw activityError(`Native ${kind} activity is not valid during ${stage}.`);
     }
+    const route = await resolveAgentAcquisitionRoute({
+        root: input.root,
+        project,
+        routeId: value.acquisitionRouteId,
+        routeClasses: ["native-discovery"],
+        activityKind: value.kind,
+        activityChannel: value.channel,
+    });
     const candidateIds = value.candidateIds;
     const known = new Set((await listEvidenceCandidates(input.root, input.projectId)).map((candidate) => candidate.id));
     const missing = candidateIds.filter((candidateId) => !known.has(candidateId));
@@ -131,6 +147,7 @@ export async function recordNativeResearchActivity(input) {
     const receipt = {
         activityId: `activity-${randomUUID()}`,
         projectId: input.projectId,
+        acquisitionRouteId: route?.id ?? null,
         stage,
         kind,
         channel: value.channel,

package/dist/research/workspace/native-activity.js.map

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

package/dist/research/workspace/preflight.js

@@ -97,7 +97,7 @@ export async function evaluateProjectPreflight(root, question, requirements, inp
         gaps.push(...designEvaluation.issueCodes.map((code) => `scientific-design:${code}`));
     }
     if (options.publicationPolicy && options.scientificDesign) {
-        appendScientificDesignContractGaps(gaps, options.scientificDesign.contract, options.publicationPolicy, requirements);
+        appendScientificDesignContractGaps(gaps, options.scientificDesign.contract, options.publicationPolicy, requirements, new Set(networkCapabilities.map((capability) => capability.id)));
     }
     if (config.mode === "production-research" && !requirements) {
         gaps.push("explicit-evidence-requirements-missing");
@@ -465,7 +465,7 @@ function appendEvidencePlanGaps(gaps, coverageGaps, requirements, inputPlan, net
         gaps.push(`evidence-plan-dated-sources-insufficient:${plannedDatedCount}/${requirements.minDatedSources}`);
     }
 }
-function appendScientificDesignContractGaps(gaps, design, policy, requirements) {
+function appendScientificDesignContractGaps(gaps, design, policy, requirements, availableCapabilityIds) {
     const prefix = "scientific-design-contract:";
     gaps.push(...scientificDesignPolicyGaps(design, policy).map((gap) => `${prefix}${gap}`));
     if (policy.targetJournal) {
@@ -477,7 +477,23 @@ function appendScientificDesignContractGaps(gaps, design, policy, requirements)
         gaps.push(`${prefix}policy-journal-approval-unbound`);
     }
     const requiredRoles = design.evidenceRoles.filter((role) => role.required);
+    const requiredRoleIds = new Set(requiredRoles.map((role) => role.id));
+    const requiredBrokerRoutes = design.acquisitionPlan.routes.filter((route) => route.required &&
+        route.executor === "agent" &&
+        route.routeClass === "broker-capability" &&
+        route.evidenceRoleIds.some((roleId) => requiredRoleIds.has(roleId)));
+    for (const route of requiredBrokerRoutes) {
+        if (route.capabilityId && !availableCapabilityIds.has(route.capabilityId)) {
+            gaps.push(`${prefix}acquisition-capability-unavailable:${route.id}:${route.capabilityId}`);
+        }
+    }
     if (requirements) {
+        const mappedCapabilityIds = new Set(requiredBrokerRoutes.flatMap((route) => (route.capabilityId ? [route.capabilityId] : [])));
+        for (const capabilityId of requirements.requiredCapabilityIds ?? []) {
+            if (!mappedCapabilityIds.has(capabilityId)) {
+                gaps.push(`${prefix}required-capability-route-unmapped:${capabilityId}`);
+            }
+        }
         const mappedDimensions = new Set(requiredRoles.flatMap((role) => role.coverageDimensionIds));
         const mappedSourceTypes = new Set(requiredRoles.flatMap((role) => role.sourceTypeRequirements));
         for (const dimension of requirements.dimensions) {