agentic-engineering-harness 0.8.1 → 0.8.3

package/dist/context/projectors/index.js

@@ -1,6 +1,7 @@
 export * from "./audit.js";
 export * from "./diff.js";
 export * from "./explorer.js";
+export * from "./informational.js";
 export * from "./operation.js";
 export * from "./planner.js";
 export * from "./source.js";

package/dist/context/projectors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/projectors/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/projectors/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/context/projectors/informational.d.ts

@@ -0,0 +1,48 @@
+import type { InformationalContextBudget } from "../budget.js";
+import type { UserFacingClaim } from "../../operations/evidence.js";
+export interface InformationalProjectionSourceInput {
+    path: string;
+    ref: string;
+    sha256: string;
+    fileSha256?: string;
+    relevance: string;
+    content: string;
+}
+export interface InformationalProjectedSource {
+    path: string;
+    ref: string;
+    sha256: string;
+    fileSha256?: string;
+    relevance: string;
+    summary: string;
+}
+export interface InformationalProjectionMetrics {
+    rawEvidenceTokens: number;
+    legacyPayloadTokens: number;
+    projectedPayloadTokens: number;
+    informationalPayloadTokens: number;
+    duplicatePayloadTokensAvoided: number;
+    sourceCount: number;
+    projectedSourceCount: number;
+    deferredSourceCount: number;
+    targetTokens: number;
+    softLimitTokens: number;
+    exceptionalTokens: number;
+    headroomAttempted: boolean;
+    headroomApplied: boolean;
+}
+export interface InformationalContextProjection {
+    claims: UserFacingClaim[];
+    sources: InformationalProjectedSource[];
+    summary: string;
+    human: string;
+    metrics: InformationalProjectionMetrics;
+}
+/**
+ * Project repository evidence into a lead-sized informational result. Raw
+ * source bytes are intentionally absent; every claim and source points to a
+ * live repository-relative evidence ref instead.
+ */
+export declare function projectInformationalContext(request: string, provider: string, input: InformationalProjectionSourceInput[], budget: InformationalContextBudget): InformationalContextProjection;
+/** Deterministic estimate of the exact former lead-visible representation from main. */
+export declare function estimateLegacyInformationalTokens(input: InformationalProjectionSourceInput[], provider?: string): number;

package/dist/context/projectors/informational.js

@@ -0,0 +1,154 @@
+import { estimateTokens } from "../estimator.js";
+import { sha256 } from "../provenance.js";
+/**
+ * Project repository evidence into a lead-sized informational result. Raw
+ * source bytes are intentionally absent; every claim and source points to a
+ * live repository-relative evidence ref instead.
+ */
+export function projectInformationalContext(request, provider, input, budget) {
+    const unique = deduplicateSources(input);
+    const projectedSources = unique.map((source) => ({
+        path: source.path,
+        ref: source.ref,
+        sha256: source.sha256,
+        ...(source.fileSha256 ? { fileSha256: source.fileSha256 } : {}),
+        relevance: source.relevance,
+        summary: summarizeSource(source.content, request, budget.sourceSummaryTokens)
+    }));
+    const sourceCount = unique.length;
+    const rawEvidenceTokens = unique.reduce((sum, source) => sum + estimateTokens(source.content), 0);
+    const baseClaims = [
+        { text: `The answer is grounded in a bounded read-only repository context containing ${sourceCount} source file(s).`, source: "repository-context", verified: true, evidenceRefs: unique.map((source) => source.ref), priority: 80 },
+        { text: "No engineering operation, audit report, findings, TaskContract, or delivery artifact was created for this informational request.", source: "repository-context", verified: true, priority: 100 }
+    ];
+    const sources = fitSources(projectedSources, baseClaims, provider, budget);
+    const claims = baseClaims.map((claim) => ({ ...claim, evidenceRefs: claim.evidenceRefs?.filter((ref) => sources.some((source) => source.ref === ref)) }));
+    const summary = summarizeProjection(sources, request, budget.exceptionalTokens);
+    const human = [
+        "INFORMATIONAL — repository-grounded answer (no engineering lifecycle created).",
+        sources.length ? `The compact projection contains ${sources.length} verified source summary(ies); deeper source detail is available by explicit evidence reference.` : "No readable matching source was available; no implementation claim is asserted.",
+        "Evidence provenance: repository-context. Source details remain available by reference and are retrieved only when needed."
+    ].join("\n\n");
+    const projectedAnswer = { intent: "informational", provenance: ["repository-context"], inspected: { provider, fileCount: sourceCount, bounded: true }, claims, sources, summary, human };
+    const projectedPayloadTokens = estimateTokens(JSON.stringify(projectedAnswer));
+    const informationalPayloadTokens = projectedPayloadTokens + estimateTokens("Bounded repository-grounded informational answer available in structuredContent.");
+    const legacyPayloadTokens = estimateLegacyInformationalTokens(input, provider);
+    return {
+        claims,
+        sources,
+        summary,
+        human,
+        metrics: {
+            rawEvidenceTokens,
+            legacyPayloadTokens,
+            projectedPayloadTokens,
+            informationalPayloadTokens,
+            duplicatePayloadTokensAvoided: Math.max(0, legacyPayloadTokens - informationalPayloadTokens),
+            sourceCount,
+            projectedSourceCount: sources.length,
+            deferredSourceCount: sources.filter((source) => source.summary.startsWith("Summary deferred")).length,
+            targetTokens: budget.targetTokens,
+            softLimitTokens: budget.softLimitTokens,
+            exceptionalTokens: budget.exceptionalTokens,
+            headroomAttempted: false,
+            headroomApplied: false
+        }
+    };
+}
+/** Deterministic estimate of the exact former lead-visible representation from main. */
+export function estimateLegacyInformationalTokens(input, provider = "filesystem") {
+    const sources = [];
+    let totalBytes = 0;
+    for (const source of input.slice(0, 8)) {
+        if (totalBytes >= 20_000)
+            break;
+        const excerpt = source.content.slice(0, Math.min(4_000, 20_000 - totalBytes));
+        if (!excerpt)
+            continue;
+        totalBytes += Buffer.byteLength(excerpt, "utf8");
+        sources.push({ path: source.path, excerpt, sha256: sha256(excerpt) });
+    }
+    const claims = [
+        { text: `The answer is grounded in a bounded read-only repository context containing ${sources.length} source file(s).`, source: "repository-context", verified: true },
+        { text: "No engineering operation, audit report, findings, TaskContract, or delivery artifact was created for this informational request.", source: "repository-context", verified: true }
+    ];
+    const pathLines = sources.length ? sources.map((source) => `- ${source.path}`).join("\n") : "- No matching readable source file was available; repository-map metadata was still consulted.";
+    const excerptText = sources.slice(0, 4).map((source) => `\n${source.path}:\n${compactExcerpt(source.excerpt)}`).join("\n");
+    const human = [
+        "INFORMATIONAL — repository-grounded answer (no engineering lifecycle created).",
+        `I used the bounded repository-context surface to orient this explanation. Relevant files:\n${pathLines}`,
+        sources.length ? `The selected source excerpts are the evidence for the explanation; they are repository context, not audit findings.${excerptText}` : "The repository context map did not expose a readable matching source file, so no implementation claim is asserted.",
+        "Evidence provenance: repository-context. This answer is explanatory, not an evaluation of correctness or safety."
+    ].join("\n\n");
+    return estimateTokens(JSON.stringify({ intent: "informational", provenance: ["repository-context"], inspected: { provider, files: sources.map((source) => source.path), bounded: true }, claims, sources, human }));
+}
+function deduplicateSources(input) {
+    const seen = new Set();
+    const result = [];
+    for (const source of input) {
+        const key = `${source.path}\u0000${source.sha256}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(source);
+    }
+    return result;
+}
+function summarizeSource(content, request, maxTokens) {
+    const terms = request.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().split(/[^a-z0-9]+/).filter((term) => term.length >= 3);
+    const lines = content.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    const relevant = lines.filter((line) => terms.some((term) => line.toLowerCase().includes(term)));
+    const structural = lines.filter((line) => /^(export|import|class|interface|type|function|async function|const|let|enum|public|private|protected)\b/.test(line));
+    const selected = [...new Set([...relevant, ...structural, ...lines.slice(0, 2)])].map((line) => truncate(line, 260));
+    const bounded = fitTokenLines(selected, maxTokens);
+    return bounded ? `Implementation signals: ${bounded}` : "No concise implementation signal was available; use the evidence reference for a targeted source read.";
+}
+function fitSources(sources, claims, provider, budget) {
+    let selected = [...sources];
+    if (estimateProjectionTokens(selected, claims, provider) > budget.exceptionalTokens) {
+        // Keep every reference addressable. Defer prose so a summary budget can
+        // never make an otherwise relevant source unreachable.
+        selected = selected.map((source) => ({ ...source, summary: "Summary deferred; retrieve this evidence reference for targeted detail." }));
+    }
+    if (estimateProjectionTokens(selected, claims, provider) > budget.softLimitTokens) {
+        selected = selected.map((source) => ({ ...source, summary: fitTokenLines(source.summary.split(/\r?\n/), Math.min(96, budget.sourceSummaryTokens)) }));
+    }
+    return selected;
+}
+function summarizeProjection(sources, request, maxTokens) {
+    if (!sources.length)
+        return "The repository context map did not expose a readable matching source file.";
+    const question = request.trim().replace(/\s+/g, " ");
+    const text = `The bounded repository inspection selected ${sources.length} relevant source file(s) for “${truncate(question, 180)}”. ${sources.map((source) => `${source.path}: ${source.summary.replace(/\n/g, " ")}`).join(" ")}`;
+    return fitTokenLines([text], Math.min(maxTokens, 280));
+}
+function estimateProjectionTokens(sources, claims, provider) {
+    return estimateTokens(JSON.stringify({ intent: "informational", provenance: ["repository-context"], inspected: { provider, fileCount: sources.length, bounded: true }, claims, sources, summary: summarizeProjection(sources, "repository question", 280) }));
+}
+function fitTokenLines(lines, maxTokens) {
+    const selected = [];
+    let used = 0;
+    for (const line of lines) {
+        const remaining = maxTokens - used;
+        if (remaining <= 0)
+            break;
+        const clipped = truncateByTokens(line, remaining);
+        if (!clipped)
+            break;
+        selected.push(clipped);
+        used += estimateTokens(`${clipped}\n`);
+    }
+    return selected.join("\n");
+}
+function truncateByTokens(value, maxTokens) {
+    if (estimateTokens(value) <= maxTokens)
+        return value;
+    const maxChars = Math.max(1, maxTokens * 4 - 3);
+    return `${value.slice(0, maxChars)}…`;
+}
+function truncate(value, maxCharacters) { return value.length <= maxCharacters ? value : `${value.slice(0, maxCharacters - 1)}…`; }
+function compactExcerpt(content) {
+    const lines = content.split(/\r?\n/).filter((line) => line.trim()).slice(0, 18);
+    return lines.join("\n").slice(0, 1_200);
+}
+//# sourceMappingURL=informational.js.map

package/dist/context/projectors/informational.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"informational.js","sourceRoot":"","sources":["../../../src/context/projectors/informational.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA8C1C;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAe,EACf,QAAgB,EAChB,KAA2C,EAC3C,MAAkC;IAElC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,mBAAmB,CAAC;KAC9E,CAAC,CAAC,CAAC;IACJ,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,MAAM,UAAU,GAAsB;QACpC,EAAE,IAAI,EAAE,+EAA+E,WAAW,kBAAkB,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;QACpO,EAAE,IAAI,EAAE,kIAAkI,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE;KAC1M,CAAC;IACF,MAAM,OAAO,GAAG,UAAU,CAAC,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1J,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG;QACZ,gFAAgF;QAChF,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,mCAAmC,OAAO,CAAC,MAAM,kGAAkG,CAAC,CAAC,CAAC,iFAAiF;QACxP,2HAA2H;KAC5H,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,MAAM,eAAe,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACzL,MAAM,sBAAsB,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/E,MAAM,0BAA0B,GAAG,sBAAsB,GAAG,cAAc,CAAC,kFAAkF,CAAC,CAAC;IAC/J,MAAM,mBAAmB,GAAG,iCAAiC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/E,OAAO;QACL,MAAM;QACN,OAAO;QACP,OAAO;QACP,KAAK;QACL,OAAO,EAAE;YACP,iBAAiB;YACjB,mBAAmB;YACnB,sBAAsB;YACtB,0BAA0B;YAC1B,6BAA6B,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,GAAG,0BAA0B,CAAC;YAC5F,WAAW;YACX,oBAAoB,EAAE,OAAO,CAAC,MAAM;YACpC,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM;YACrG,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;YAC3C,iBAAiB,EAAE,KAAK;YACxB,eAAe,EAAE,KAAK;SACvB;KACF,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iCAAiC,CAAC,KAA2C,EAAE,QAAQ,GAAG,YAAY;IACpH,MAAM,OAAO,GAA6D,EAAE,CAAC;IAC7E,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvC,IAAI,UAAU,IAAI,MAAM;YAAE,MAAM;QAChC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAsB;QAChC,EAAE,IAAI,EAAE,+EAA+E,OAAO,CAAC,MAAM,kBAAkB,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACvK,EAAE,IAAI,EAAE,kIAAkI,EAAE,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC3L,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gGAAgG,CAAC;IAC7L,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3H,MAAM,KAAK,GAAG;QACZ,gFAAgF;QAChF,8FAA8F,SAAS,EAAE;QACzG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,sHAAsH,WAAW,EAAE,CAAC,CAAC,CAAC,oHAAoH;QAC3Q,kHAAkH;KACnH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACtN,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA2C;IACrE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAAC,MAAM,MAAM,GAAyC,EAAE,CAAC;IACxF,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC;QACnD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,OAAe,EAAE,SAAiB;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC5I,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yGAAyG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChK,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACrH,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC,CAAC,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC,CAAC,wGAAwG,CAAC;AACnK,CAAC;AAED,SAAS,UAAU,CAAC,OAAuC,EAAE,MAAyB,EAAE,QAAgB,EAAE,MAAkC;IAC1I,IAAI,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC5B,IAAI,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACpF,wEAAwE;QACxE,uDAAuD;QACvD,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,yEAAyE,EAAE,CAAC,CAAC,CAAC;IAC3I,CAAC;IACD,IAAI,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;QAClF,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAuC,EAAE,OAAe,EAAE,SAAiB;IACtG,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,4EAA4E,CAAC;IACzG,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,8CAA8C,OAAO,CAAC,MAAM,iCAAiC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACpO,OAAO,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAuC,EAAE,MAAyB,EAAE,QAAgB;IACpH,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAChQ,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,SAAiB;IACvD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;QAAC,IAAI,SAAS,IAAI,CAAC;YAAE,MAAM;QAC9D,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,MAAM;QACpB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAAC,IAAI,IAAI,cAAc,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IACxD,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,aAAqB,IAAY,OAAO,KAAK,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAE3J,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/dist/context/repository/map.js

@@ -8,7 +8,7 @@ export async function buildRepositoryContextMap(root, config, request = {}) {
     return { ...rendered, map: graph };
 }
 async function filesystemContextMap(root) {
-    const ignored = new Set([".git", "node_modules", "dist", ".harness", ".config"]);
+    const ignored = new Set([".git", "node_modules", "dist", ".harness", ".config", ".aeh-test-results", "coverage", ".vitest", ".cache"]);
     const files = [];
     async function visit(directory) {
         if (files.length >= 5_000)

package/dist/context/repository/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../src/context/repository/map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAA4B,MAAM,aAAa,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAY,EAAE,MAA4B,EAAE,UAAiC,EAAE;IAC7H,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,gBAAgB,EAAE,SAAS,IAAI,yBAAyB,CAAC,IAAI,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtJ,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,IAAI,KAAK,CAAC,CAAC;IAClG,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;IAAC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC7G,KAAK,UAAU,KAAK,CAAC,SAAiB;QACpC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;YAAE,OAAO;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAgC,CAAC,EAAE,CAAC;YACvH,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;iBAC1C,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7F,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;gBAAE,OAAO;QACpC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC3G,CAAC;AACD,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../src/context/repository/map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAA4B,MAAM,aAAa,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAY,EAAE,MAA4B,EAAE,UAAiC,EAAE;IAC7H,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,gBAAgB,EAAE,SAAS,IAAI,yBAAyB,CAAC,IAAI,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACtJ,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,IAAI,KAAK,CAAC,CAAC;IAClG,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IAAC,MAAM,KAAK,GAAa,EAAE,CAAC;IACnK,KAAK,UAAU,KAAK,CAAC,SAAiB;QACpC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;YAAE,OAAO;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAgC,CAAC,EAAE,CAAC;YACvH,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;iBAC1C,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7F,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;gBAAE,OAAO;QACpC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC3G,CAAC;AACD,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC"}

package/dist/context/transport.d.ts

@@ -1,6 +1,19 @@
 import type { HarnessProjectConfig } from "../core/types.js";
-import type { AgentExecutionSelection } from "../agents/types.js";
+import type { AgentExecutionSelection, ContextCapabilityRequirement, RuntimeCapabilities } from "../agents/types.js";
 import { runProcess } from "../utils/process.js";
+export interface ResolvedContextCapabilityRequirements {
+    repositoryMap: ContextCapabilityRequirement;
+    semanticRetrieval: ContextCapabilityRequirement;
+    rawRetrieval: ContextCapabilityRequirement;
+    compression: ContextCapabilityRequirement;
+    source: "agent-contract" | "coordinator-default" | "project-default";
+}
+export interface TransportCapabilities {
+    mcpProjection: boolean;
+    localMcpProjection: boolean;
+    directRuntimeConfig: boolean;
+    reasons: string[];
+}
 export interface EffectiveContextCapabilities {
     contextGateway: boolean;
     repositoryMap: boolean;
@@ -11,7 +24,23 @@ export interface EffectiveContextCapabilities {
         context: boolean;
         headroom: boolean;
     };
+    requirements: ResolvedContextCapabilityRequirements;
+    runtimeCapabilities: RuntimeCapabilities;
+    transportCapabilities: TransportCapabilities;
+    requiredByProject: {
+        semanticRetrieval: boolean;
+        rawRetrieval: boolean;
+        repositoryMap: boolean;
+        compression: boolean;
+    };
+    requiredByExecutionContract: {
+        semanticRetrieval: boolean;
+        rawRetrieval: boolean;
+        repositoryMap: boolean;
+        compression: boolean;
+    };
     readinessRequirements: string[];
+    degradations: string[];
     reasons: string[];
 }
 export interface TransportProbe {
@@ -24,6 +53,9 @@ export interface PodmanSerenaProbe {
     exposesSerena: boolean;
     message: string;
 }
+export declare function resolveContextCapabilityRequirements(config: HarnessProjectConfig, selection: AgentExecutionSelection): ResolvedContextCapabilityRequirements;
+export declare function runtimeCapabilitiesFor(selection: AgentExecutionSelection): RuntimeCapabilities;
+export declare function transportCapabilitiesFor(config: HarnessProjectConfig, selection: AgentExecutionSelection): TransportCapabilities;
 /** Resolve effective capabilities without touching external runtimes. */
 export declare function staticContextCapabilities(config: HarnessProjectConfig, selection: AgentExecutionSelection): EffectiveContextCapabilities;
 export declare function resolveContextTransportCapabilities(root: string, config: HarnessProjectConfig, selection: AgentExecutionSelection, probe?: TransportProbe & {

package/dist/context/transport.js

@@ -1,44 +1,148 @@
 import { commandExists, runProcess } from "../utils/process.js";
+/**
+ * Runtime defaults are an adapter registry, not policy. Context code consumes
+ * capabilities from this registry and from the selected execution contract;
+ * it never treats a runtime name as proof that MCP is available.
+ */
+const RUNTIME_CAPABILITY_REGISTRY = {
+    opencode: { mcp: true, stdioMcp: true, localMcp: true, runtimeConfigInjection: true, nativeToolProjection: true },
+    // Codex supports local stdio MCP. AEH's direct adapter does not currently
+    // inject project-scoped config, while Paseo projects MCP into the session.
+    codex: { mcp: true, stdioMcp: true, localMcp: true, runtimeConfigInjection: false, nativeToolProjection: true }
+};
+const TRANSPORT_CAPABILITY_REGISTRY = {
+    paseo: { mcpProjection: true, localMcpProjection: true, directRuntimeConfig: false },
+    direct: { mcpProjection: true, localMcpProjection: true, directRuntimeConfig: true },
+    podman: { mcpProjection: false, localMcpProjection: false, directRuntimeConfig: false },
+    none: { mcpProjection: false, localMcpProjection: false, directRuntimeConfig: false }
+};
+export function resolveContextCapabilityRequirements(config, selection) {
+    const configured = selection.contextRequirements;
+    const coordinator = selection.role === "orchestrator" || selection.role === "coordinator";
+    const semanticConfigured = Boolean(config.context?.semanticRetrieval?.provider && config.context.semanticRetrieval.provider !== "none");
+    const semanticDefault = semanticConfigured && config.context?.semanticRetrieval?.required !== false ? "REQUIRED" : "OPTIONAL";
+    const compressionConfigured = Boolean(config.context?.compression?.provider && config.context.compression.provider !== "none");
+    const defaults = coordinator
+        ? { repositoryMap: "FORBIDDEN", semanticRetrieval: "FORBIDDEN", rawRetrieval: "FORBIDDEN", compression: "OPTIONAL" }
+        : {
+            repositoryMap: "OPTIONAL",
+            semanticRetrieval: semanticDefault,
+            rawRetrieval: "OPTIONAL",
+            compression: compressionConfigured && config.context?.compression?.required !== false ? "REQUIRED" : "OPTIONAL"
+        };
+    return {
+        repositoryMap: configured?.repositoryMap ?? defaults.repositoryMap ?? "OPTIONAL",
+        semanticRetrieval: configured?.semanticRetrieval ?? defaults.semanticRetrieval ?? "OPTIONAL",
+        rawRetrieval: configured?.rawRetrieval ?? defaults.rawRetrieval ?? "OPTIONAL",
+        compression: configured?.compression ?? defaults.compression ?? "OPTIONAL",
+        source: configured ? "agent-contract" : coordinator ? "coordinator-default" : "project-default"
+    };
+}
+export function runtimeCapabilitiesFor(selection) {
+    return { ...(RUNTIME_CAPABILITY_REGISTRY[selection.runtimeAdapter] ?? {}), ...(selection.runtimeCapabilities ?? {}) };
+}
+export function transportCapabilitiesFor(config, selection) {
+    const transport = effectiveTransport(config, selection);
+    const runtime = runtimeCapabilitiesFor(selection);
+    const registered = TRANSPORT_CAPABILITY_REGISTRY[transport] ?? { mcpProjection: false, localMcpProjection: false, directRuntimeConfig: false };
+    const reasons = [];
+    if (runtime.mcp !== true)
+        reasons.push(`runtime '${selection.runtimeName}' does not declare MCP capability`);
+    if (runtime.stdioMcp !== true)
+        reasons.push(`runtime '${selection.runtimeName}' does not declare stdio MCP capability`);
+    if (runtime.localMcp !== true)
+        reasons.push(`runtime '${selection.runtimeName}' does not declare local MCP capability`);
+    if (!registered.mcpProjection || !registered.localMcpProjection)
+        reasons.push(`transport '${transport}' does not project local MCP servers`);
+    if (transport === "direct" && runtime.runtimeConfigInjection !== true)
+        reasons.push(`direct runtime adapter '${selection.runtimeName}' does not inject project MCP configuration`);
+    if (transport === "paseo" && runtime.nativeToolProjection !== true)
+        reasons.push(`runtime '${selection.runtimeName}' does not declare native MCP projection through Paseo`);
+    return { ...registered, directRuntimeConfig: registered.directRuntimeConfig && runtime.runtimeConfigInjection === true, reasons };
+}
 /** Resolve effective capabilities without touching external runtimes. */
 export function staticContextCapabilities(config, selection) {
-    const transport = effectiveTransport(config, selection);
+    const requirements = resolveContextCapabilityRequirements(config, selection);
+    const runtimeCapabilities = runtimeCapabilitiesFor(selection);
+    const transportCapabilities = transportCapabilitiesFor(config, selection);
     const semanticConfigured = Boolean(config.context?.semanticRetrieval?.provider && config.context.semanticRetrieval.provider !== "none");
-    const agentCanUseContext = selection.role !== "orchestrator" && selection.logicalAgent !== "operation-supervisor";
-    const opencodeSurface = selection.runtimeAdapter === "opencode" && agentCanUseContext;
-    const directOrPaseo = transport === "direct" || transport === "paseo" || (selection.transport === "inherit" && transport === "none");
-    const semanticRetrieval = semanticConfigured && opencodeSurface && directOrPaseo;
-    const authorizedRetrieval = Boolean(config.context) && agentCanUseContext && opencodeSurface && transport !== "podman" && directOrPaseo;
-    const mcpServers = { serena: semanticRetrieval, context: authorizedRetrieval, headroom: false };
-    const reasons = [];
-    const readinessRequirements = [];
+    const rawConfigured = Boolean(config.context);
+    const repositoryMapConfigured = config.context?.repositoryMap?.enabled !== false;
+    const semanticAvailableBySurface = semanticConfigured && requirements.semanticRetrieval !== "FORBIDDEN" && transportCapabilities.reasons.length === 0;
+    const semanticRetrieval = semanticAvailableBySurface;
+    const authorizedRetrieval = rawConfigured && requirements.rawRetrieval !== "FORBIDDEN" && transportCapabilities.reasons.length === 0;
+    const repositoryMap = repositoryMapConfigured && requirements.repositoryMap !== "FORBIDDEN";
+    const requiredByProject = {
+        semanticRetrieval: semanticConfigured && config.context?.semanticRetrieval?.required !== false,
+        rawRetrieval: false,
+        repositoryMap: false,
+        compression: Boolean(config.context?.compression?.provider && config.context.compression.provider !== "none" && config.context.compression.required !== false)
+    };
+    const requiredByExecutionContract = {
+        semanticRetrieval: requirements.semanticRetrieval === "REQUIRED",
+        rawRetrieval: requirements.rawRetrieval === "REQUIRED",
+        repositoryMap: requirements.repositoryMap === "REQUIRED",
+        compression: requirements.compression === "REQUIRED"
+    };
+    const reasons = [...transportCapabilities.reasons];
+    const degradations = [];
     if (!semanticConfigured)
-        reasons.push("semantic retrieval is disabled by project configuration");
-    if (transport === "podman") {
-        reasons.push("Podman has no AEH-managed Serena MCP projection; host or image binaries do not prove an executable semantic surface");
-        readinessRequirements.push("Podman semantic retrieval requires an explicitly wired in-container MCP server");
-    }
-    else if (!semanticRetrieval && semanticConfigured) {
-        reasons.push(`transport '${transport}' and runtime '${selection.runtimeAdapter}' do not expose Serena MCP`);
-    }
-    if (!authorizedRetrieval && config.context && transport === "podman")
-        reasons.push("Podman does not expose the host AEH raw-retrieval MCP");
+        reasons.push("semantic retrieval is not configured for this project");
+    if (requirements.semanticRetrieval === "FORBIDDEN")
+        reasons.push("execution contract forbids semantic repository retrieval");
+    if (requirements.rawRetrieval === "FORBIDDEN")
+        reasons.push("execution contract forbids raw context retrieval");
+    if (requirements.repositoryMap === "FORBIDDEN")
+        reasons.push("execution contract forbids repository-map context");
+    if (semanticConfigured && requirements.semanticRetrieval !== "FORBIDDEN" && !semanticRetrieval && !requiredByProject.semanticRetrieval)
+        degradations.push("Serena unavailable; bounded repository-map/raw context fallback is active");
+    const readinessRequirements = [];
     if (semanticRetrieval)
         readinessRequirements.push("Serena MCP initialize/tools/list readiness");
     if (authorizedRetrieval)
         readinessRequirements.push("AEH context MCP authorization and source-hash verification");
-    return { contextGateway: true, repositoryMap: true, semanticRetrieval, authorizedRetrieval, mcpServers, readinessRequirements, reasons };
+    return {
+        contextGateway: true,
+        repositoryMap,
+        semanticRetrieval,
+        authorizedRetrieval,
+        mcpServers: { serena: semanticRetrieval, context: authorizedRetrieval, headroom: false },
+        requirements,
+        runtimeCapabilities,
+        transportCapabilities,
+        requiredByProject,
+        requiredByExecutionContract,
+        readinessRequirements,
+        degradations,
+        reasons
+    };
 }
 export async function resolveContextTransportCapabilities(root, config, selection, probe = {}) {
     const capabilities = staticContextCapabilities(config, selection);
     const semanticConfigured = Boolean(config.context?.semanticRetrieval?.provider && config.context.semanticRetrieval.provider !== "none");
+    if (probe.mode === "live" && semanticConfigured && capabilities.semanticRetrieval) {
+        const { SerenaSemanticProvider } = await import("./repository/serena.js");
+        const health = await new SerenaSemanticProvider().doctor(root);
+        if (!health.ok) {
+            capabilities.semanticRetrieval = false;
+            capabilities.mcpServers.serena = false;
+            capabilities.reasons.push(`Serena readiness failed: ${health.message}`);
+            if (!capabilities.requiredByProject.semanticRetrieval || !capabilities.requiredByExecutionContract.semanticRetrieval)
+                capabilities.degradations.push(`Serena unavailable; explicit fallback: ${health.message}`);
+        }
+    }
     if (probe.mode === "live" && effectiveTransport(config, selection) === "podman" && config.security?.sandbox?.image) {
         const live = await probePodmanSerena(root, config.security.sandbox.image, probe);
         capabilities.reasons.push(`live Podman probe: ${live.message}`);
         if (!live.available || !live.imagePresent || !live.exposesSerena)
             capabilities.readinessRequirements.push("pre-provisioned Podman image with Serena executable");
     }
-    if (semanticConfigured && config.context?.semanticRetrieval?.required !== false && !capabilities.semanticRetrieval) {
-        throw new Error(`UNSUPPORTED_CAPABILITY: Serena semantic retrieval is unavailable for transport '${effectiveTransport(config, selection)}' and runtime '${selection.runtimeAdapter}'. ${capabilities.reasons.join("; ")}`);
+    // Project `required=true` is scoped by the contract: it cannot force the
+    // coordinator or an OPTIONAL/FORBIDDEN worker surface to use Serena. An
+    // explicit execution-contract REQUIRED, however, is independently binding.
+    const required = capabilities.requiredByExecutionContract.semanticRetrieval;
+    if (required && !capabilities.semanticRetrieval) {
+        throw new Error(`UNSUPPORTED_CAPABILITY: Serena semantic retrieval is required by the execution contract, but is unavailable for transport '${effectiveTransport(config, selection)}' and runtime '${selection.runtimeName}'. ${capabilities.reasons.join("; ")}`);
     }
     return capabilities;
 }
@@ -57,7 +161,7 @@ export async function probePodmanSerena(root, image, probe = {}) {
         : { available: true, imagePresent: true, exposesSerena: false, message: "configured Podman image does not expose Serena" };
 }
 function effectiveTransport(config, selection) {
-    return selection.transport === "inherit" ? (config.orchestration?.provider ?? "none") : selection.transport;
+    return !selection.transport || selection.transport === "inherit" ? (config.orchestration?.provider ?? "none") : selection.transport;
 }
 function quote(value) { return `'${value.replaceAll("'", "'\\''")}'`; }
 //# sourceMappingURL=transport.js.map

package/dist/context/transport.js.map

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

package/dist/context/types.d.ts

@@ -147,12 +147,12 @@ export declare const contextFragmentSchema: z.ZodObject<{
         memory: "memory";
         validation: "validation";
         source: "source";
-        skill: "skill";
-        operation: "operation";
         instruction: "instruction";
         "execution-envelope": "execution-envelope";
         "agent-charter": "agent-charter";
+        skill: "skill";
         diff: "diff";
+        operation: "operation";
         handoff: "handoff";
         "tool-output": "tool-output";
         "repository-map": "repository-map";
@@ -192,12 +192,12 @@ export declare const contextEnvelopeSchema: z.ZodObject<{
             memory: "memory";
             validation: "validation";
             source: "source";
-            skill: "skill";
-            operation: "operation";
             instruction: "instruction";
             "execution-envelope": "execution-envelope";
             "agent-charter": "agent-charter";
+            skill: "skill";
             diff: "diff";
+            operation: "operation";
             handoff: "handoff";
             "tool-output": "tool-output";
             "repository-map": "repository-map";

package/dist/core/config.js

@@ -21,6 +21,19 @@ const contextBudgetSchema = z.object({ inputTokens: z.number().int().positive().
 const contextSchema = z.object({
     mode: z.enum(["observe", "enforce"]).optional(),
     budgets: z.object({ default: contextBudgetSchema.optional(), agents: z.record(z.string(), contextBudgetSchema).optional(), phases: z.record(z.string(), contextBudgetSchema).optional() }).optional(),
+    informational: z.object({ targetTokens: z.number().int().positive().optional(), softLimitTokens: z.number().int().positive().optional(), exceptionalTokens: z.number().int().positive().optional(), maxSources: z.number().int().positive().optional(), sourceSummaryTokens: z.number().int().positive().optional(), maxInitialBytesPerSource: z.number().int().positive().optional(), maxInitialBytesTotal: z.number().int().positive().optional() }).optional().superRefine((value, ctx) => {
+        const target = value?.targetTokens ?? 8_000;
+        const soft = value?.softLimitTokens ?? 12_000;
+        const exceptional = value?.exceptionalTokens ?? 15_000;
+        if (soft < target)
+            ctx.addIssue({ code: "custom", path: ["softLimitTokens"], message: "informational softLimitTokens must be >= targetTokens" });
+        if (exceptional < soft)
+            ctx.addIssue({ code: "custom", path: ["exceptionalTokens"], message: "informational exceptionalTokens must be >= softLimitTokens" });
+        const perSource = value?.maxInitialBytesPerSource ?? 4_000;
+        const total = value?.maxInitialBytesTotal ?? 20_000;
+        if (total < perSource)
+            ctx.addIssue({ code: "custom", path: ["maxInitialBytesTotal"], message: "informational maxInitialBytesTotal must be >= maxInitialBytesPerSource" });
+    }),
     repositoryMap: z.object({ enabled: z.boolean().optional(), tokenBudget: z.number().int().positive().optional(), maxGraphHops: z.number().int().positive().optional() }).optional(),
     semanticRetrieval: z.object({ provider: z.string().min(1).optional(), required: z.boolean().optional(), editing: z.boolean().optional() }).optional(),
     compression: z.object({ provider: z.string().min(1).optional(), required: z.boolean().optional(), minTokens: z.number().int().positive().optional(), reversible: z.boolean().optional(), command: z.string().min(1).optional() }).optional(),