agentic-engineering-harness 0.6.27 → 0.6.29

package/dist/context/projectors/explorer.js

@@ -0,0 +1,5 @@
+import { projectStructuredResult } from "./structured.js";
+export function projectExplorer(fragment) {
+    return projectStructuredResult(fragment, "explorer");
+}
+//# sourceMappingURL=explorer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.js","sourceRoot":"","sources":["../../../src/context/projectors/explorer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,QAAyB;IACvD,OAAO,uBAAuB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,8 @@
+export * from "./audit.js";
+export * from "./diff.js";
+export * from "./explorer.js";
+export * from "./operation.js";
+export * from "./planner.js";
+export * from "./source.js";
+export * from "./structured.js";
+export * from "./validation.js";

package/dist/context/projectors/index.js

@@ -0,0 +1,9 @@
+export * from "./audit.js";
+export * from "./diff.js";
+export * from "./explorer.js";
+export * from "./operation.js";
+export * from "./planner.js";
+export * from "./source.js";
+export * from "./structured.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { ContextFragment, ContextFragmentProjection } from "../types.js";
+export type OperationProjectionPhase = "INITIALIZE" | "COORDINATE" | "CONSOLIDATE" | "RECOVER" | "HANDOFF";
+export declare function projectOperation(fragment: ContextFragment, phase?: OperationProjectionPhase): ContextFragmentProjection;

package/dist/context/projectors/operation.js

@@ -0,0 +1,26 @@
+import { estimateTokens } from "../estimator.js";
+export function projectOperation(fragment, phase = "COORDINATE") {
+    const value = parseJson(fragment.content);
+    const lines = [`phase=${phase}`];
+    for (const key of ["id", "status", "revision", "currentPhase", "error"])
+        if (value?.[key] !== undefined)
+            lines.push(`${key}=${format(value[key])}`);
+    for (const key of ["participants", "findings", "progress", "result"])
+        if (value?.[key] !== undefined)
+            lines.push(`${key}=${summarize(value[key])}`);
+    lines.push("authoritative OperationRecord remains in its durable artifact");
+    const content = lines.join("\n");
+    return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
+}
+function parseJson(content) { try {
+    const value = JSON.parse(content);
+    return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+catch {
+    return undefined;
+} }
+function format(value) { return typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : summarize(value); }
+function summarize(value) { if (Array.isArray(value))
+    return `count=${value.length}`; if (value && typeof value === "object")
+    return `keys=${Object.keys(value).sort().join(",")}`; return String(value ?? ""); }
+//# sourceMappingURL=operation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../../src/context/projectors/operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKjD,MAAM,UAAU,gBAAgB,CAAC,QAAyB,EAAE,QAAkC,YAAY;IACxG,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC;QAAE,IAAI,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACpJ,KAAK,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC;QAAE,IAAI,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACpJ,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/I,CAAC;AAED,SAAS,SAAS,CAAC,OAAe,IAAyC,IAAI,CAAC;IAAC,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAAC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAgC,CAAC,CAAC,CAAC,SAAS,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,SAAS,CAAC;AAAC,CAAC,CAAC,CAAC;AAC/Q,SAAS,MAAM,CAAC,KAAc,IAAY,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC3K,SAAS,SAAS,CAAC,KAAc,IAAY,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;IAAE,OAAO,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { ContextFragment, ContextFragmentProjection } from "../types.js";
+export declare function projectPlanner(fragment: ContextFragment): ContextFragmentProjection;

package/dist/context/projectors/planner.js

@@ -0,0 +1,5 @@
+import { projectStructuredResult } from "./structured.js";
+export function projectPlanner(fragment) {
+    return projectStructuredResult(fragment, "planner");
+}
+//# sourceMappingURL=planner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../../src/context/projectors/planner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,OAAO,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { ContextFragment, ContextFragmentProjection } from "../types.js";
+export declare function projectSource(fragment: ContextFragment): ContextFragmentProjection;

package/dist/context/projectors/source.js

@@ -0,0 +1,5 @@
+import { estimateTokens } from "../estimator.js";
+export function projectSource(fragment) {
+    return { ...fragment, content: fragment.content, estimatedTokens: estimateTokens(fragment.content), originalTokens: estimateTokens(fragment.content), projected: false };
+}
+//# sourceMappingURL=source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/context/projectors/source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC3K,CAAC"}

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

@@ -0,0 +1,2 @@
+import type { ContextFragment, ContextFragmentProjection } from "../types.js";
+export declare function projectStructuredResult(fragment: ContextFragment, role: string): ContextFragmentProjection;

package/dist/context/projectors/structured.js

@@ -0,0 +1,24 @@
+import { estimateTokens } from "../estimator.js";
+export function projectStructuredResult(fragment, role) {
+    let content = fragment.content;
+    try {
+        const value = JSON.parse(fragment.content);
+        if (value && typeof value === "object") {
+            const record = value;
+            const keys = Object.keys(record).sort();
+            content = [`role=${role}`, ...keys.map((key) => `${key}=${summarize(record[key])}`), "authoritative structured result remains in its durable artifact"].join("\n");
+        }
+    }
+    catch {
+        content = `${fragment.content}\nauthoritative structured result remains in its durable artifact`;
+    }
+    return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
+}
+function summarize(value) {
+    if (Array.isArray(value))
+        return `count=${value.length}`;
+    if (value && typeof value === "object")
+        return `keys=${Object.keys(value).sort().join(",")}`;
+    return String(value ?? "");
+}
+//# sourceMappingURL=structured.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../../src/context/projectors/structured.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,uBAAuB,CAAC,QAAyB,EAAE,IAAY;IAC7E,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,iEAAiE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrK,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,GAAG,QAAQ,CAAC,OAAO,mEAAmE,CAAC;IAAC,CAAC;IAC7G,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC/I,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC;IACzD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACxH,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ValidationReport } from "../../core/types.js";
+import type { ContextFragment, ContextFragmentProjection } from "../types.js";
+export declare function projectValidation(fragment: ContextFragment, report?: ValidationReport): ContextFragmentProjection;

package/dist/context/projectors/validation.js

@@ -0,0 +1,25 @@
+import { estimateTokens } from "../estimator.js";
+export function projectValidation(fragment, report) {
+    const raw = report ?? parseReport(fragment.content);
+    const checks = raw?.checks ?? [];
+    const failing = checks.filter((check) => check.status === "FAIL" || check.status === "WARN");
+    const lines = [
+        `status=${raw?.status ?? "UNKNOWN"}`,
+        `taskId=${raw?.taskId ?? "unknown"}`,
+        `checks=${checks.length} failingOrWarning=${failing.length}`,
+        ...failing.map((check) => `${check.status} ${check.id}: ${check.message}${check.details ? ` details=${JSON.stringify(check.details)}` : ""}`),
+        raw?.changedFiles?.length ? `changedFiles=${raw.changedFiles.join(",")}` : undefined,
+        "authoritative raw validation artifact is available through the fragment source"
+    ].filter((line) => Boolean(line));
+    return { ...fragment, content: lines.join("\n"), estimatedTokens: estimateTokens(lines.join("\n")), originalTokens: estimateTokens(fragment.content), projected: true };
+}
+function parseReport(content) {
+    try {
+        const value = JSON.parse(content);
+        return Array.isArray(value.checks) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/context/projectors/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,iBAAiB,CAAC,QAAyB,EAAE,MAAyB;IACpF,MAAM,GAAG,GAAG,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAG;QACZ,UAAU,GAAG,EAAE,MAAM,IAAI,SAAS,EAAE;QACpC,UAAU,GAAG,EAAE,MAAM,IAAI,SAAS,EAAE;QACpC,UAAU,MAAM,CAAC,MAAM,qBAAqB,OAAO,CAAC,MAAM,EAAE;QAC5D,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7I,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QACpF,gFAAgF;KACjF,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC1K,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;QACtD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC/B,CAAC"}

package/dist/context/provenance.d.ts

@@ -0,0 +1,3 @@
+export declare const CONTEXT_PROJECTION_VERSION = "aeh-context-v1";
+export declare function sha256(value: string | Buffer): string;
+export declare function stableJson(value: unknown): string;

package/dist/context/provenance.js

@@ -0,0 +1,13 @@
+import { createHash } from "node:crypto";
+export const CONTEXT_PROJECTION_VERSION = "aeh-context-v1";
+export function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+export function stableJson(value) {
+    return JSON.stringify(value, (_key, nested) => {
+        if (!nested || typeof nested !== "object" || Array.isArray(nested))
+            return nested;
+        return Object.fromEntries(Object.entries(nested).sort(([a], [b]) => a.localeCompare(b)));
+    });
+}
+//# sourceMappingURL=provenance.js.map

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,3 @@
+import type { RepositoryContextMap } from "./types.js";
+export declare function loadGraphifyContextMap(root: string, graphPath?: string): Promise<RepositoryContextMap | undefined>;
+export { normalizeGraphDocument } from "../../providers/graphifyModel.js";

package/dist/context/repository/graphify.js

@@ -0,0 +1,7 @@
+import { canonicalGraphToRepositoryMap, loadCanonicalGraph } from "../../providers/graphifyModel.js";
+export async function loadGraphifyContextMap(root, graphPath = "graphify-out/graph.json") {
+    const graph = await loadCanonicalGraph(root, graphPath);
+    return graph ? canonicalGraphToRepositoryMap(graph) : undefined;
+}
+export { normalizeGraphDocument } from "../../providers/graphifyModel.js";
+//# 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":"AACA,OAAO,EAAE,6BAA6B,EAAE,kBAAkB,EAA0B,MAAM,kCAAkC,CAAC;AAE7H,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,SAAS,GAAG,yBAAyB;IAC9F,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,CAAC,CAAC,6BAA6B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC"}

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.6.1";
+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.6.1";
+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