agentic-engineering-harness 0.6.27 → 0.6.28

package/dist/context/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../../src/context/provenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAE3D,MAAM,UAAU,MAAM,CAAC,KAAsB;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QAClF,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/context/repository/graphify.d.ts

@@ -0,0 +1,2 @@
+import type { RepositoryContextMap } from "./types.js";
+export declare function loadGraphifyContextMap(root: string, graphPath?: string): Promise<RepositoryContextMap | undefined>;

package/dist/context/repository/graphify.js

@@ -0,0 +1,36 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function loadGraphifyContextMap(root, graphPath = "graphify-out/graph.json") {
+    let value;
+    try {
+        value = JSON.parse(await fs.readFile(path.resolve(root, graphPath), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    return normalizeGraph(value);
+}
+function normalizeGraph(value) {
+    const object = value && typeof value === "object" ? value : {};
+    const rawNodes = Array.isArray(object.nodes) ? object.nodes : Array.isArray(object.files) ? object.files : [];
+    const nodes = rawNodes.flatMap((item, index) => {
+        if (!item || typeof item !== "object")
+            return [];
+        const record = item;
+        const file = String(record.file ?? record.path ?? record.name ?? "");
+        if (!file)
+            return [];
+        return [{ id: String(record.id ?? `${file}#${index}`), file, symbol: typeof record.symbol === "string" ? record.symbol : typeof record.name === "string" && record.name !== file ? record.name : undefined, signature: typeof record.signature === "string" ? record.signature : undefined, centrality: typeof record.centrality === "number" ? record.centrality : undefined, community: typeof record.community === "string" ? record.community : undefined }];
+    });
+    const rawEdges = Array.isArray(object.edges) ? object.edges : Array.isArray(object.links) ? object.links : [];
+    const edges = rawEdges.flatMap((item) => {
+        if (!item || typeof item !== "object")
+            return [];
+        const record = item;
+        const from = String(record.from ?? record.source ?? "");
+        const to = String(record.to ?? record.target ?? "");
+        return from && to ? [{ from, to, kind: typeof record.kind === "string" ? record.kind : typeof record.type === "string" ? record.type : undefined }] : [];
+    });
+    return { nodes, edges, provider: "graphify", generatedAt: typeof object.generatedAt === "string" ? object.generatedAt : undefined };
+}
+//# sourceMappingURL=graphify.js.map

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

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

package/dist/context/repository/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./graphify.js";
+export * from "./map.js";
+export * from "./rank.js";
+export * from "./render.js";
+export * from "./serena.js";
+export * from "./types.js";

package/dist/context/repository/index.js

@@ -0,0 +1,7 @@
+export * from "./graphify.js";
+export * from "./map.js";
+export * from "./rank.js";
+export * from "./render.js";
+export * from "./serena.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/context/repository/map.d.ts

@@ -0,0 +1,6 @@
+import type { HarnessProjectConfig } from "../../core/types.js";
+import type { RepositoryContextMap, RepositoryRankRequest } from "./types.js";
+import { type RepositoryMapRender } from "./render.js";
+export declare function buildRepositoryContextMap(root: string, config: HarnessProjectConfig, request?: RepositoryRankRequest): Promise<RepositoryMapRender & {
+    map: RepositoryContextMap;
+}>;

package/dist/context/repository/map.js

@@ -0,0 +1,34 @@
+import { loadGraphifyContextMap } from "./graphify.js";
+import { rankRepositoryNodes } from "./rank.js";
+import { renderRepositoryMap } from "./render.js";
+export async function buildRepositoryContextMap(root, config, request = {}) {
+    const graph = await loadGraphifyContextMap(root, config.codeIntelligence?.graphPath ?? "graphify-out/graph.json") ?? await filesystemContextMap(root);
+    const ranked = rankRepositoryNodes(graph, request);
+    const rendered = renderRepositoryMap(ranked, config.context?.repositoryMap?.tokenBudget ?? 2_000);
+    return { ...rendered, map: graph };
+}
+async function filesystemContextMap(root) {
+    const ignored = new Set([".git", "node_modules", "dist", ".harness", ".config"]);
+    const files = [];
+    async function visit(directory) {
+        if (files.length >= 5_000)
+            return;
+        for (const entry of await fs.readdir(directory, { withFileTypes: true }).catch(() => [])) {
+            if (ignored.has(entry.name))
+                continue;
+            const absolute = path.join(directory, entry.name);
+            if (entry.isDirectory())
+                await visit(absolute);
+            else if (entry.isFile())
+                files.push(path.relative(root, absolute).replaceAll(path.sep, "/"));
+            if (files.length >= 5_000)
+                return;
+        }
+    }
+    await visit(root);
+    files.sort();
+    return { provider: "filesystem", nodes: files.map((file) => ({ id: `file:${file}`, file })), edges: [] };
+}
+import fs from "node:fs/promises";
+import path from "node:path";
+//# sourceMappingURL=map.js.map

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

@@ -0,0 +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"}

package/dist/context/repository/rank.d.ts

@@ -0,0 +1,3 @@
+import type { RankedRepositoryNode, RepositoryContextMap, RepositoryNode, RepositoryRankRequest } from "./types.js";
+export declare function rankRepositoryNodes(map: RepositoryContextMap, request: RepositoryRankRequest): RankedRepositoryNode[];
+export declare function repositoryNodeKey(node: RepositoryNode): string;

package/dist/context/repository/rank.js

@@ -0,0 +1,43 @@
+export function rankRepositoryNodes(map, request) {
+    const explicit = new Set(request.explicitPaths ?? []);
+    const allowed = new Set(request.allowedPaths ?? []);
+    const changed = new Set(request.changedFiles ?? []);
+    const findings = new Set(request.findingLocations ?? []);
+    const references = new Set(request.referenceIds ?? []);
+    const ranked = map.nodes.map((node) => {
+        const reasons = [];
+        let score = 0;
+        if (explicit.has(node.file)) {
+            score += 100;
+            reasons.push("explicit-scope");
+        }
+        if (allowed.has(node.file)) {
+            score += 60;
+            reasons.push("task-scope");
+        }
+        if (changed.has(node.file) || node.changed) {
+            score += 40;
+            reasons.push("changed-file");
+        }
+        if (findings.has(node.file)) {
+            score += 35;
+            reasons.push("finding-location");
+        }
+        if (request.symbol && (node.symbol === request.symbol || node.file.includes(request.symbol))) {
+            score += 50;
+            reasons.push("exact-symbol");
+        }
+        if (references.has(node.id)) {
+            score += 30;
+            reasons.push("reference");
+        }
+        if (node.centrality !== undefined) {
+            score += Math.round(Math.max(0, Math.min(1, node.centrality)) * 20);
+            reasons.push("centrality");
+        }
+        return { ...node, score, reasons };
+    });
+    return ranked.sort((a, b) => b.score - a.score || a.file.localeCompare(b.file) || (a.symbol ?? "").localeCompare(b.symbol ?? "") || a.id.localeCompare(b.id));
+}
+export function repositoryNodeKey(node) { return `${node.file}${node.symbol ? `#${node.symbol}` : ""}`; }
+//# sourceMappingURL=rank.js.map

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

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

package/dist/context/repository/render.d.ts

@@ -0,0 +1,8 @@
+import type { RankedRepositoryNode } from "./types.js";
+export interface RepositoryMapRender {
+    content: string;
+    selected: string[];
+    omitted: string[];
+    estimatedTokens: number;
+}
+export declare function renderRepositoryMap(nodes: RankedRepositoryNode[], tokenBudget: number): RepositoryMapRender;

package/dist/context/repository/render.js

@@ -0,0 +1,21 @@
+import { estimateTokens } from "../estimator.js";
+export function renderRepositoryMap(nodes, tokenBudget) {
+    if (!Number.isInteger(tokenBudget) || tokenBudget <= 0)
+        throw new Error("Repository map token budget must be positive.");
+    const selected = [];
+    const omitted = [];
+    let tokens = 0;
+    for (const node of nodes) {
+        const line = `${node.file}${node.symbol ? ` :: ${node.symbol}` : ""}${node.signature ? ` ${node.signature}` : ""} [score=${node.score}${node.reasons.length ? ` ${node.reasons.join(",")}` : ""}]`;
+        const next = estimateTokens(`${line}\n`);
+        if (tokens + next <= tokenBudget) {
+            selected.push(node);
+            tokens += next;
+        }
+        else
+            omitted.push(node);
+    }
+    const content = [...selected.map((node) => `${node.file}${node.symbol ? ` :: ${node.symbol}` : ""}${node.signature ? ` ${node.signature}` : ""} [score=${node.score}${node.reasons.length ? ` ${node.reasons.join(",")}` : ""}]`), omitted.length ? `[${omitted.length} lower-ranked repository nodes omitted; retrieve by authorized map fragment]` : undefined].filter((line) => Boolean(line)).join("\n");
+    return { content, selected: selected.map((node) => node.id), omitted: omitted.map((node) => node.id), estimatedTokens: estimateTokens(content) };
+}
+//# sourceMappingURL=render.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/context/repository/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKjD,MAAM,UAAU,mBAAmB,CAAC,KAA6B,EAAE,WAAmB;IACpF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACzH,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAAC,MAAM,OAAO,GAA2B,EAAE,CAAC;IAAC,IAAI,MAAM,GAAG,CAAC,CAAC;IACxG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACnM,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC;YAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAAC,MAAM,IAAI,IAAI,CAAC;QAAC,CAAC;;YAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,8EAA8E,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7Z,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;AACnJ,CAAC"}

package/dist/context/repository/serena.d.ts

@@ -0,0 +1,11 @@
+import type { McpServerConfig } from "../../core/types.js";
+import type { ProviderHealth } from "../compression/types.js";
+export declare const SERENA_VERSION = "1.5.3";
+export declare class SerenaSemanticProvider {
+    private readonly command;
+    readonly name = "serena";
+    constructor(command?: string);
+    doctor(root: string): Promise<ProviderHealth>;
+    mcpServer(root: string): McpServerConfig;
+}
+export declare function semanticFirstInstruction(): string;

package/dist/context/repository/serena.js

@@ -0,0 +1,26 @@
+import { commandExists, runProcess } from "../../utils/process.js";
+export const SERENA_VERSION = "1.5.3";
+export class SerenaSemanticProvider {
+    command;
+    name = "serena";
+    constructor(command = "serena") {
+        this.command = command;
+    }
+    async doctor(root) {
+        if (!(await commandExists(this.command, root)))
+            return { ok: false, message: `Serena executable '${this.command}' was not found in the reconciled toolchain PATH.` };
+        const result = await runProcess(`${quote(this.command)} --version`, { cwd: root, timeoutMs: 15_000 });
+        if (result.exitCode !== 0)
+            return { ok: false, message: `Serena health check failed: ${result.stderr || result.stdout}` };
+        const version = (result.stdout || result.stderr).trim().split(/\r?\n/)[0];
+        return { ok: version.includes(SERENA_VERSION), version, message: version.includes(SERENA_VERSION) ? `Serena semantic retrieval ready (${version}).` : `Serena version drift: expected ${SERENA_VERSION}, got ${version}.` };
+    }
+    mcpServer(root) {
+        return { description: "AEH-managed local Serena semantic repository retrieval; editing is disabled by default.", type: "local", command: [this.command, "start-mcp-server", "--context", "ide-assistant", "--project", root], enabled: true, timeoutMs: 30_000 };
+    }
+}
+export function semanticFirstInstruction() {
+    return ["Semantic repository policy:", "1. Locate relevant symbols before reading complete files.", "2. Inspect symbol bodies only when required.", "3. Find referencing symbols before broad repository search.", "4. Read complete files only when file-level context is semantically required.", "5. Do not use Serena memory as AEH historical memory; Engram remains memory authority.", "6. Serena editing is disabled unless the assigned role and frozen scope explicitly permit it."].join("\n");
+}
+function quote(value) { return `'${value.replaceAll("'", "'\\''")}'`; }
+//# sourceMappingURL=serena.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serena.js","sourceRoot":"","sources":["../../../src/context/repository/serena.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGnE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,OAAO,sBAAsB;IAEJ;IADpB,IAAI,GAAG,QAAQ,CAAC;IACzB,YAA6B,UAAU,QAAQ;QAAlB,YAAO,GAAP,OAAO,CAAW;IAAG,CAAC;IAEnD,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,sBAAsB,IAAI,CAAC,OAAO,mDAAmD,EAAE,CAAC;QACrK,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACtG,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,+BAA+B,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1H,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,oCAAoC,OAAO,IAAI,CAAC,CAAC,CAAC,kCAAkC,cAAc,SAAS,OAAO,GAAG,EAAE,CAAC;IAC9N,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,OAAO,EAAE,WAAW,EAAE,yFAAyF,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACnQ,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,CAAC,6BAA6B,EAAE,2DAA2D,EAAE,8CAA8C,EAAE,6DAA6D,EAAE,+EAA+E,EAAE,wFAAwF,EAAE,+FAA+F,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5e,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,IAAY,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/context/repository/types.d.ts

@@ -0,0 +1,34 @@
+export interface RepositoryNode {
+    id: string;
+    file: string;
+    symbol?: string;
+    signature?: string;
+    centrality?: number;
+    changed?: boolean;
+    community?: string;
+}
+export interface RepositoryEdge {
+    from: string;
+    to: string;
+    kind?: string;
+}
+export interface RepositoryContextMap {
+    nodes: RepositoryNode[];
+    edges: RepositoryEdge[];
+    provider: "graphify" | "filesystem" | string;
+    generatedAt?: string;
+}
+export interface RepositoryRankRequest {
+    explicitPaths?: string[];
+    allowedPaths?: string[];
+    changedFiles?: string[];
+    findingLocations?: string[];
+    symbol?: string;
+    referenceIds?: string[];
+    maxGraphHops?: number;
+}
+export interface RankedRepositoryNode extends RepositoryNode {
+    score: number;
+    reasons: string[];
+    distance?: number;
+}

package/dist/context/repository/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/context/repository/types.ts"],"names":[],"mappings":""}

package/dist/context/retrieval/authorization.d.ts

@@ -0,0 +1,11 @@
+import type { ContextFragment } from "../types.js";
+export interface RetrievalAuthorization {
+    root: string;
+    operationId: string;
+    logicalAgent: string;
+    allowedFragmentIds: string[];
+    fragments: Map<string, ContextFragment>;
+}
+export declare function authorizeRetrieval(input: Omit<RetrievalAuthorization, "fragments"> & {
+    fragments: ContextFragment[];
+}): RetrievalAuthorization;

package/dist/context/retrieval/authorization.js

@@ -0,0 +1,9 @@
+export function authorizeRetrieval(input) {
+    const fragments = new Map(input.fragments.map((fragment) => [fragment.id, fragment]));
+    const allowed = new Set(input.allowedFragmentIds);
+    for (const id of allowed)
+        if (!fragments.has(id))
+            throw new Error(`Cannot authorize unknown context fragment '${id}'.`);
+    return { ...input, allowedFragmentIds: [...allowed].sort(), fragments };
+}
+//# sourceMappingURL=authorization.js.map

package/dist/context/retrieval/authorization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.js","sourceRoot":"","sources":["../../../src/context/retrieval/authorization.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,kBAAkB,CAAC,KAAmF;IACpH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAClD,KAAK,MAAM,EAAE,IAAI,OAAO;QAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,EAAE,IAAI,CAAC,CAAC;IACxH,OAAO,EAAE,GAAG,KAAK,EAAE,kBAAkB,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC;AAC1E,CAAC"}

package/dist/context/retrieval/gateway.d.ts

@@ -0,0 +1,33 @@
+import type { RetrievalAuthorization } from "./authorization.js";
+export interface RetrievalRequest {
+    fragmentId: string;
+    section?: "raw" | "source";
+    maxTokens?: number;
+}
+export interface RetrievalResult {
+    fragmentId: string;
+    content: string;
+    artifact: string;
+    sha256: string;
+    estimatedTokens: number;
+    repeated: boolean;
+}
+export interface RetrievalLimits {
+    maxRequestsPerTurn: number;
+    maxTokensPerRequest: number;
+    maxTotalTokensPerTurn: number;
+}
+export declare class ContextRetrievalGateway {
+    private readonly authorization;
+    private readonly limits;
+    private requests;
+    private totalTokens;
+    private readonly seen;
+    constructor(authorization: RetrievalAuthorization, limits: RetrievalLimits);
+    get metrics(): {
+        requests: number;
+        repeated: number;
+        totalTokens: number;
+    };
+    retrieve(request: RetrievalRequest): Promise<RetrievalResult>;
+}

package/dist/context/retrieval/gateway.js

@@ -0,0 +1,69 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { estimateTokens } from "../estimator.js";
+import { sha256 } from "../provenance.js";
+export class ContextRetrievalGateway {
+    authorization;
+    limits;
+    requests = 0;
+    totalTokens = 0;
+    seen = new Set();
+    constructor(authorization, limits) {
+        this.authorization = authorization;
+        this.limits = limits;
+    }
+    get metrics() { return { requests: this.requests, repeated: [...this.seen].length < this.requests ? this.requests - [...this.seen].length : 0, totalTokens: this.totalTokens }; }
+    async retrieve(request) {
+        if (!this.authorization.allowedFragmentIds.includes(request.fragmentId))
+            throw new Error(`CONTEXT_RETRIEVAL_UNAUTHORIZED: fragment '${request.fragmentId}' is not authorized for operation '${this.authorization.operationId}'.`);
+        if (this.requests >= this.limits.maxRequestsPerTurn)
+            throw new Error("CONTEXT_RETRIEVAL_BUDGET_EXCEEDED: maximum requests per turn reached.");
+        const fragment = this.authorization.fragments.get(request.fragmentId);
+        if (!fragment)
+            throw new Error(`CONTEXT_RETRIEVAL_NOT_FOUND: fragment '${request.fragmentId}'.`);
+        const artifact = fragment.source?.artifact;
+        if (!artifact)
+            throw new Error(`CONTEXT_RETRIEVAL_NO_ARTIFACT: fragment '${request.fragmentId}' has no durable raw artifact.`);
+        const absolute = safeArtifactPath(this.authorization.root, artifact);
+        const raw = await fs.readFile(absolute, "utf8");
+        const expected = fragment.source?.sha256;
+        const actual = sha256(raw);
+        if (expected && expected !== actual)
+            throw new Error(`CONTEXT_RETRIEVAL_HASH_MISMATCH: ${artifact}.`);
+        const maxTokens = Math.min(request.maxTokens ?? this.limits.maxTokensPerRequest, this.limits.maxTokensPerRequest);
+        const tokens = estimateTokens(raw);
+        if (this.totalTokens + Math.min(tokens, maxTokens) > this.limits.maxTotalTokensPerTurn)
+            throw new Error("CONTEXT_RETRIEVAL_BUDGET_EXCEEDED: maximum tokens per turn reached.");
+        if (request.section && request.section !== "raw")
+            throw new Error(`Unsupported context retrieval section '${request.section}'.`);
+        this.requests += 1;
+        const repeated = this.seen.has(request.fragmentId);
+        this.seen.add(request.fragmentId);
+        const content = tokens <= maxTokens ? raw : boundedLines(raw, maxTokens);
+        this.totalTokens += estimateTokens(content);
+        return { fragmentId: request.fragmentId, content, artifact, sha256: actual, estimatedTokens: estimateTokens(content), repeated };
+    }
+}
+function safeArtifactPath(root, artifact) {
+    if (path.isAbsolute(artifact))
+        throw new Error("CONTEXT_RETRIEVAL_PATH_REJECTED: artifact paths must be relative to the operation root.");
+    const absoluteRoot = path.resolve(root);
+    const absolute = path.resolve(absoluteRoot, artifact);
+    if (absolute !== absoluteRoot && !absolute.startsWith(`${absoluteRoot}${path.sep}`))
+        throw new Error("CONTEXT_RETRIEVAL_PATH_REJECTED: artifact escapes the operation root.");
+    return absolute;
+}
+function boundedLines(value, maxTokens) {
+    const lines = value.split(/\r?\n/);
+    const selected = [];
+    let used = 0;
+    for (const line of lines) {
+        const next = estimateTokens(`${line}\n`);
+        if (used + next > maxTokens)
+            break;
+        selected.push(line);
+        used += next;
+    }
+    return `${selected.join("\n")}\n[bounded retrieval excerpt; retrieve again with a larger authorized budget for the complete raw artifact]`;
+}
+//# sourceMappingURL=gateway.js.map

package/dist/context/retrieval/gateway.js.map

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

package/dist/context/retrieval/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./authorization.js";
+export * from "./gateway.js";
+export * from "./mcp.js";
+export * from "./persisted.js";
+export * from "./server.js";

package/dist/context/retrieval/index.js

@@ -0,0 +1,6 @@
+export * from "./authorization.js";
+export * from "./gateway.js";
+export * from "./mcp.js";
+export * from "./persisted.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/retrieval/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/context/retrieval/mcp.d.ts

@@ -0,0 +1,3 @@
+import type { ContextRetrievalGateway, RetrievalRequest } from "./gateway.js";
+export declare function contextRetrievalToolDescription(): Record<string, unknown>;
+export declare function handleContextRetrievalRequest(gateway: ContextRetrievalGateway, request: RetrievalRequest): Promise<Record<string, unknown>>;

package/dist/context/retrieval/mcp.js

@@ -0,0 +1,8 @@
+export function contextRetrievalToolDescription() {
+    return { name: "aeh_context_retrieve", description: "Retrieve an already-authorized AEH context fragment artifact; arbitrary filesystem paths are rejected.", inputSchema: { type: "object", required: ["fragmentId"], properties: { fragmentId: { type: "string", minLength: 1 }, section: { enum: ["raw", "source"] }, maxTokens: { type: "integer", minimum: 1 } }, additionalProperties: false } };
+}
+export async function handleContextRetrievalRequest(gateway, request) {
+    const result = await gateway.retrieve(request);
+    return { status: "OK", ...result };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/context/retrieval/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/context/retrieval/mcp.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,+BAA+B;IAC7C,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,wGAAwG,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE,CAAC;AACzY,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAAgC,EAAE,OAAyB;IAC7G,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;AACrC,CAAC"}

package/dist/context/retrieval/persisted.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessProjectConfig } from "../../core/types.js";
+import { type RetrievalRequest } from "./gateway.js";
+export declare function retrievePersistedContext(root: string, config: HarnessProjectConfig, operationId: string, logicalAgent: string, request: RetrievalRequest): Promise<import("./gateway.js").RetrievalResult>;

package/dist/context/retrieval/persisted.js

@@ -0,0 +1,22 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { assertContextEnvelope } from "../types.js";
+import { ContextRetrievalGateway } from "./gateway.js";
+import { authorizeRetrieval } from "./authorization.js";
+import { recordEvent } from "../../telemetry/events.js";
+export async function retrievePersistedContext(root, config, operationId, logicalAgent, request) {
+    const envelopePath = path.resolve(root, ".harness", "context", safeSegment(operationId), "envelope.json");
+    const envelope = assertContextEnvelope(JSON.parse(await fs.readFile(envelopePath, "utf8")));
+    if (envelope.operationId !== operationId)
+        throw new Error("CONTEXT_RETRIEVAL_OPERATION_MISMATCH: envelope belongs to another operation.");
+    if (envelope.logicalAgent !== logicalAgent)
+        throw new Error("CONTEXT_RETRIEVAL_AGENT_MISMATCH: fragment is not authorized for this logical agent.");
+    const limits = config.context?.retrieval ?? {};
+    const gateway = new ContextRetrievalGateway(authorizeRetrieval({ root, operationId, logicalAgent, allowedFragmentIds: envelope.retrieval.allowedFragmentIds, fragments: envelope.fragments }), { maxRequestsPerTurn: limits.maxRequestsPerTurn ?? 8, maxTokensPerRequest: limits.maxTokensPerRequest ?? 6_000, maxTotalTokensPerTurn: limits.maxTotalTokensPerTurn ?? 20_000 });
+    const result = await gateway.retrieve(request);
+    if (config.telemetry?.enabled !== false)
+        await recordEvent(root, config, "harness.context.retrieve_original", { operationId, logicalAgent, fragmentId: request.fragmentId, estimatedTokens: result.estimatedTokens, repeated: result.repeated, artifact: result.artifact, sha256: result.sha256 });
+    return result;
+}
+function safeSegment(value) { const sanitized = value.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, ""); return sanitized || "operation"; }
+//# sourceMappingURL=persisted.js.map

package/dist/context/retrieval/persisted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted.js","sourceRoot":"","sources":["../../../src/context/retrieval/persisted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAyB,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAY,EAAE,MAA4B,EAAE,WAAmB,EAAE,YAAoB,EAAE,OAAyB;IAC7J,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5F,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAC1I,IAAI,QAAQ,CAAC,YAAY,KAAK,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IACpJ,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAAC,kBAAkB,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,KAAK,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,MAAM,EAAE,CAAC,CAAC;IAChX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,SAAS,EAAE,OAAO,KAAK,KAAK;QAAE,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,mCAAmC,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnS,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,IAAY,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC"}

package/dist/context/retrieval/server.d.ts

@@ -0,0 +1 @@
+export declare function serveContextRetrievalMcp(): Promise<void>;

package/dist/context/retrieval/server.js

@@ -0,0 +1,52 @@
+import readline from "node:readline";
+import { loadProjectConfig } from "../../core/config.js";
+import { contextRetrievalToolDescription } from "./mcp.js";
+import { retrievePersistedContext } from "./persisted.js";
+export async function serveContextRetrievalMcp() {
+    const root = process.env.AEH_CONTEXT_ROOT?.trim() || process.cwd();
+    const operationId = process.env.AEH_CONTEXT_OPERATION_ID?.trim();
+    const logicalAgent = process.env.AEH_LOGICAL_AGENT?.trim();
+    if (!operationId || !logicalAgent)
+        throw new Error("AEH context MCP requires AEH_CONTEXT_OPERATION_ID and AEH_LOGICAL_AGENT.");
+    const config = await loadProjectConfig(root);
+    const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (request.id === undefined || request.id === null)
+            continue;
+        try {
+            write({ jsonrpc: "2.0", id: request.id, result: await handle(request, root, config, operationId, logicalAgent) });
+        }
+        catch (error) {
+            write({ jsonrpc: "2.0", id: request.id, error: { code: -32603, message: error instanceof Error ? error.message : String(error) } });
+        }
+    }
+}
+async function handle(request, root, config, operationId, logicalAgent) {
+    if (request.method === "initialize")
+        return { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "aeh-context-retrieval", version: "1" } };
+    if (request.method === "ping")
+        return {};
+    if (request.method === "tools/list")
+        return { tools: [contextRetrievalToolDescription()] };
+    if (request.method !== "tools/call")
+        throw new Error(`Unsupported MCP method: ${request.method ?? "<missing>"}`);
+    const params = request.params ?? {};
+    if (params.name !== "aeh_context_retrieve")
+        throw new Error(`Unknown context tool '${String(params.name)}'.`);
+    const args = params.arguments && typeof params.arguments === "object" && !Array.isArray(params.arguments) ? params.arguments : {};
+    if (typeof args.fragmentId !== "string" || !args.fragmentId.trim())
+        throw new Error("fragmentId is required.");
+    const result = await retrievePersistedContext(root, config, operationId, logicalAgent, { fragmentId: args.fragmentId, section: args.section === "source" ? "source" : "raw", maxTokens: typeof args.maxTokens === "number" ? args.maxTokens : undefined });
+    return { content: [{ type: "text", text: result.content }], structuredContent: result };
+}
+function write(value) { process.stdout.write(`${JSON.stringify(value)}\n`); }
+//# sourceMappingURL=server.js.map

package/dist/context/retrieval/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/context/retrieval/server.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,+BAA+B,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,EAAE,CAAC;IACjE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC/H,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnF,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,OAA6G,CAAC;QAClH,IAAI,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAS;QAAC,CAAC;QACzE,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI;YAAE,SAAS;QAC9D,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;QAAC,CAAC;QAC1H,OAAO,KAAK,EAAE,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAAC,CAAC;IACxJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,OAA8D,EAAE,IAAY,EAAE,MAAqD,EAAE,WAAmB,EAAE,YAAoB;IAClM,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;IACxK,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACzC,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC,+BAA+B,EAAE,CAAC,EAAE,CAAC;IAC3F,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC,CAAC;IACjH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAAC,IAAI,MAAM,CAAC,IAAI,KAAK,sBAAsB;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnJ,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAoC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7J,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/G,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3P,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC;AAC1F,CAAC;AAED,SAAS,KAAK,CAAC,KAAc,IAAU,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/context/telemetry.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessProjectConfig } from "../core/types.js";
+import type { ContextEnvelope, ContextMetrics } from "./types.js";
+export declare function recordContextMetrics(root: string, config: HarnessProjectConfig, envelope: ContextEnvelope, metrics: ContextMetrics): Promise<void>;

package/dist/context/telemetry.js

@@ -0,0 +1,9 @@
+import { recordEvent } from "../telemetry/events.js";
+export async function recordContextMetrics(root, config, envelope, metrics) {
+    const base = { operationId: envelope.operationId, logicalAgent: envelope.logicalAgent, phase: envelope.phase, envelopeSha256: envelope.provenance.sha256 };
+    await recordEvent(root, config, "harness.context.project", { ...base, projectedBytes: metrics.projectedBytes, projectionRatio: metrics.projectionRatio ?? 0 });
+    if (metrics.compressedFragments > 0)
+        await recordEvent(root, config, "harness.context.compress", { ...base, compressedFragments: metrics.compressedFragments, compressionRatio: metrics.compressionRatio ?? 0 });
+    await recordEvent(root, config, "harness.context.operation_summary", { ...base, rawBytes: metrics.rawBytes, deliveredBytes: metrics.deliveredBytes, estimatedRawTokens: metrics.estimatedRawTokens, estimatedDeliveredTokens: metrics.estimatedDeliveredTokens, deliveredFragments: metrics.deliveredFragments, discardedFragments: metrics.discardedFragments });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/context/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/context/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAA4B,EAAE,QAAyB,EAAE,OAAuB;IACvI,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAC3J,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,yBAAyB,EAAE,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/J,IAAI,OAAO,CAAC,mBAAmB,GAAG,CAAC;QAAE,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,GAAG,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC,CAAC;IACjN,MAAM,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,mCAAmC,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,OAAO,CAAC,wBAAwB,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACpW,CAAC"}