agentic-engineering-harness 0.6.26 → 0.6.28

package/dist/context/gateway.js

@@ -0,0 +1,180 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { recordEvent } from "../telemetry/events.js";
+import { resolveContextBudget } from "./budget.js";
+import { canLossyCompress, classifyFragment, isRequired as isRequiredFragment } from "./classifier.js";
+import { estimateBytes, estimateTokens } from "./estimator.js";
+import { buildContextEnvelope, renderContextEnvelope } from "./envelope.js";
+import { resolveContextPolicy } from "./policy.js";
+import { sha256 } from "./provenance.js";
+import { projectAudit, projectDiff, projectOperation, projectSource, projectValidation } from "./projectors/index.js";
+import { authorizeRetrieval } from "./retrieval/authorization.js";
+import { ContextRetrievalGateway } from "./retrieval/gateway.js";
+import { HeadroomCompressionProvider } from "./compression/headroom.js";
+import { recordContextMetrics } from "./telemetry.js";
+export class ContextBudgetGateway {
+    root;
+    config;
+    compressor;
+    persist;
+    telemetry;
+    constructor(root, config, options = {}) {
+        this.root = root;
+        this.config = config;
+        this.compressor = options.compressor ?? new HeadroomCompressionProvider(config.context?.compression?.command ? { command: config.context.compression.command } : {});
+        this.persist = options.persist ?? true;
+        this.telemetry = options.telemetry ?? true;
+    }
+    async prepare(request) {
+        const policy = resolveContextPolicy(this.config);
+        const budget = resolveContextBudget(this.config, request.role ?? request.logicalAgent, request.phase);
+        const durable = await Promise.all(request.fragments.map((fragment) => this.persistRawFragment(request.operationId, fragment)));
+        const rawBytes = durable.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
+        const rawTokens = durable.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
+        const candidates = [];
+        for (const fragment of durable) {
+            classifyFragment(fragment);
+            const optimized = await this.optimizeFragment(fragment, request.operationId, policy.compression.minTokens);
+            candidates.push({ raw: fragment, optimized });
+        }
+        const enforced = policy.mode === "enforce";
+        const delivered = enforced ? selectWithinBudget(candidates.map((candidate) => candidate.optimized), budget.maxTokens - budget.reserved.response) : durable.map(projectSource);
+        const deliveredIds = new Set(delivered.map((fragment) => fragment.id));
+        const discarded = durable.filter((fragment) => !deliveredIds.has(fragment.id));
+        const envelope = buildContextEnvelope({ version: 1, operationId: request.operationId, logicalAgent: request.logicalAgent, phase: request.phase, budget: { maximum: budget.maxTokens, estimatedDelivered: delivered.reduce((sum, fragment) => sum + fragment.estimatedTokens, 0) }, fragments: delivered, retrieval: { available: delivered.length > 0, allowedFragmentIds: delivered.map((fragment) => fragment.id) } });
+        if (this.persist)
+            await this.persistEnvelope(request.operationId, envelope);
+        const rendered = renderContextEnvelope(envelope);
+        const metrics = metricsFor(durable, candidates.map((candidate) => candidate.optimized), delivered, discarded);
+        const retrieval = new ContextRetrievalGateway(authorizeRetrieval({ root: this.root, operationId: request.operationId, logicalAgent: request.logicalAgent, allowedFragmentIds: delivered.map((fragment) => fragment.id), fragments: durable }), policy.retrieval);
+        if (this.telemetry && this.config.telemetry?.enabled !== false)
+            await this.emitTelemetry(request, metrics, envelope);
+        return { envelope, rendered, metrics, retrieval: { root: this.root, operationId: request.operationId, logicalAgent: request.logicalAgent, allowedFragmentIds: [...envelope.retrieval.allowedFragmentIds] } };
+    }
+    async optimizeFragment(fragment, operationId, minCompressionTokens) {
+        const originalTokens = estimateTokens(fragment.content);
+        if (isRequiredFragment(fragment))
+            return projectSource(fragment);
+        if (fragment.preservation === "DISCARDABLE")
+            return { ...fragment, content: "", estimatedTokens: 0, originalTokens, projected: true };
+        if (fragment.preservation === "RETRIEVABLE") {
+            const content = `[Retrievable ${fragment.kind} '${fragment.id}' (${originalTokens} tokens); use aeh_context_retrieve for the authorized raw artifact.]`;
+            return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens, projected: true };
+        }
+        let projected;
+        switch (fragment.kind) {
+            case "validation":
+                projected = projectValidation(fragment);
+                break;
+            case "audit":
+                projected = projectAudit(fragment);
+                break;
+            case "operation":
+                projected = projectOperation(fragment);
+                break;
+            case "diff":
+                projected = projectDiff(fragment);
+                break;
+            case "source":
+                projected = projectSource(fragment);
+                break;
+            case "repository-map":
+                projected = projectSource(fragment);
+                break;
+            case "tool-output":
+                projected = genericProjection(fragment);
+                break;
+            case "memory":
+                projected = genericProjection(fragment);
+                break;
+            case "instruction":
+            case "normative":
+                projected = projectSource(fragment);
+                break;
+            default: projected = projectSource(fragment);
+        }
+        if (canLossyCompress(fragment) && originalTokens >= minCompressionTokens) {
+            const compression = await this.compressor.compress(this.root, { operationId, fragment, maxTokens: Math.max(1, Math.floor(originalTokens * 0.7)), sourceSha256: fragment.source?.sha256 ?? sha256(fragment.content) });
+            if (compression.compressedTokens < projected.estimatedTokens)
+                return { ...projected, content: compression.content, estimatedTokens: compression.compressedTokens, compressed: true, compression: { provider: compression.provider, providerVersion: compression.providerVersion, reversible: compression.reversible, handle: compression.handle } };
+        }
+        return projected;
+    }
+    async persistRawFragment(operationId, fragment) {
+        if (!this.persist)
+            return { ...fragment, source: { ...fragment.source, sha256: fragment.source?.sha256 ?? sha256(fragment.content) } };
+        const relative = fragment.source?.artifact ?? path.posix.join(".harness", "context", safeSegment(operationId), `${safeSegment(fragment.id)}.raw`);
+        const absolute = safePath(this.root, relative);
+        await fs.mkdir(path.dirname(absolute), { recursive: true });
+        let actual;
+        try {
+            const existing = await fs.readFile(absolute);
+            actual = sha256(existing);
+            if (fragment.source?.sha256 && fragment.source.sha256 !== actual)
+                throw new Error(`Context source hash mismatch for '${relative}'.`);
+            if (!fragment.source?.sha256 && existing.toString("utf8") !== fragment.content)
+                throw new Error(`Context source artifact '${relative}' does not match the supplied content.`);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("Context source"))
+                throw error;
+            await fs.writeFile(absolute, fragment.content, { encoding: "utf8", flag: "wx" }).catch(async (writeError) => {
+                if (writeError.code !== "EEXIST")
+                    throw writeError;
+            });
+            actual = sha256(fragment.content);
+        }
+        return { ...fragment, source: { ...fragment.source, artifact: relative, sha256: actual } };
+    }
+    async persistEnvelope(operationId, envelope) {
+        const file = safePath(this.root, path.posix.join(".harness", "context", safeSegment(operationId), "envelope.json"));
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        await fs.writeFile(file, `${JSON.stringify(envelope, null, 2)}\n`, "utf8");
+    }
+    async emitTelemetry(request, metrics, envelope) {
+        const attributes = { operationId: request.operationId, logicalAgent: request.logicalAgent, phase: request.phase, envelopeSha256: envelope.provenance.sha256, rawBytes: metrics.rawBytes, projectedBytes: metrics.projectedBytes, deliveredBytes: metrics.deliveredBytes, estimatedRawTokens: metrics.estimatedRawTokens, estimatedDeliveredTokens: metrics.estimatedDeliveredTokens, deliveredFragments: metrics.deliveredFragments, compressedFragments: metrics.compressedFragments, discardedFragments: metrics.discardedFragments, projectionRatio: metrics.projectionRatio ?? 0, compressionRatio: metrics.compressionRatio ?? 0 };
+        await recordEvent(this.root, this.config, "harness.context.prepare", attributes);
+        await recordContextMetrics(this.root, this.config, envelope, metrics);
+        await recordEvent(this.root, this.config, "harness.context.deliver", { ...attributes, retrievalAvailable: envelope.retrieval.available });
+    }
+}
+export async function prepareContext(root, config, request, options = {}) {
+    return new ContextBudgetGateway(root, config, options).prepare(request);
+}
+function selectWithinBudget(fragments, maxTokens) {
+    const ordered = [...fragments].filter((fragment) => fragment.estimatedTokens > 0).sort((a, b) => Number(isRequiredProjection(b)) - Number(isRequiredProjection(a)) || b.priority - a.priority || a.id.localeCompare(b.id));
+    const selected = [];
+    let used = 0;
+    for (const fragment of ordered) {
+        if (used + fragment.estimatedTokens <= maxTokens) {
+            selected.push(fragment);
+            used += fragment.estimatedTokens;
+            continue;
+        }
+        if (isRequiredProjection(fragment))
+            throw new Error(`CONTEXT_BUDGET_EXCEEDED: required fragment '${fragment.id}' cannot be delivered without loss.`);
+    }
+    return selected;
+}
+function genericProjection(fragment) {
+    const lines = fragment.content.split(/\r?\n/);
+    const selected = lines.length <= 64 ? lines : [...lines.slice(0, 16), ...lines.filter((line) => /error|fail|warn|diagnostic|exception|stack/i.test(line)).slice(0, 32), ...lines.slice(-16)];
+    const content = [...new Set(selected)].join("\n") + (lines.length > selected.length ? "\n[non-authoritative repetitive lines projected; raw artifact is retrievable]" : "");
+    return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: lines.length > selected.length };
+}
+function metricsFor(raw, optimized, delivered, discarded) {
+    const rawTokens = raw.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
+    const projectedTokens = optimized.reduce((sum, fragment) => sum + estimateTokens(fragment.content), 0);
+    const deliveredTokens = delivered.reduce((sum, fragment) => sum + fragment.estimatedTokens, 0);
+    const rawBytes = raw.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
+    const projectedBytes = optimized.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
+    const deliveredBytes = delivered.reduce((sum, fragment) => sum + estimateBytes(fragment.content), 0);
+    const compressed = optimized.filter((fragment) => fragment.compressed).length;
+    return { rawBytes, projectedBytes, deliveredBytes, estimatedRawTokens: rawTokens, estimatedDeliveredTokens: deliveredTokens, retrievedFragments: 0, deliveredFragments: delivered.length, compressedFragments: compressed, discardedFragments: discarded.length, retrievalRequests: 0, retrievalRetries: 0, retrievalEscapes: 0, compressionRatio: rawTokens ? deliveredTokens / rawTokens : undefined, projectionRatio: rawTokens ? projectedTokens / rawTokens : undefined };
+}
+function safeSegment(value) { const sanitized = value.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, ""); return sanitized || "fragment"; }
+function safePath(root, relative) { if (path.isAbsolute(relative))
+    throw new Error("Context artifact paths must be relative to the project root."); const absoluteRoot = path.resolve(root); const absolute = path.resolve(absoluteRoot, relative); if (absolute !== absoluteRoot && !absolute.startsWith(`${absoluteRoot}${path.sep}`))
+    throw new Error("Context artifact path escapes the project root."); return absolute; }
+function isRequiredProjection(fragment) { return fragment.preservation === "VERBATIM" || fragment.kind === "normative"; }
+//# sourceMappingURL=gateway.js.map

package/dist/context/gateway.js.map

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

package/dist/context/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./budget.js";
+export * from "./classifier.js";
+export * from "./compression/index.js";
+export * from "./envelope.js";
+export * from "./estimator.js";
+export * from "./eval.js";
+export * from "./gateway.js";
+export * from "./policy.js";
+export * from "./preflight.js";
+export * from "./provenance.js";
+export * from "./projectors/index.js";
+export * from "./repository/index.js";
+export * from "./retrieval/index.js";
+export * from "./telemetry.js";
+export * from "./types.js";

package/dist/context/index.js

@@ -0,0 +1,16 @@
+export * from "./budget.js";
+export * from "./classifier.js";
+export * from "./compression/index.js";
+export * from "./envelope.js";
+export * from "./estimator.js";
+export * from "./eval.js";
+export * from "./gateway.js";
+export * from "./policy.js";
+export * from "./preflight.js";
+export * from "./provenance.js";
+export * from "./projectors/index.js";
+export * from "./repository/index.js";
+export * from "./retrieval/index.js";
+export * from "./telemetry.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/context/policy.d.ts

@@ -0,0 +1,6 @@
+import type { ContextConfiguration, HarnessProjectConfig } from "../core/types.js";
+import type { ContextPolicy } from "./types.js";
+export declare function resolveContextPolicy(config: HarnessProjectConfig | ContextConfiguration | undefined): ContextPolicy;
+export declare function outputMode(policy: ContextPolicy, role: string | undefined): "terse" | "compact" | "normal";
+export declare function isCompressionConfigured(policy: ContextPolicy): boolean;
+export declare function outputPolicyInstruction(policy: ContextPolicy, role: string | undefined): string | undefined;

package/dist/context/policy.js

@@ -0,0 +1,40 @@
+const defaultModes = {
+    explorer: "terse",
+    planner: "compact",
+    "spec-manager": "compact",
+    implementer: "compact",
+    reviewer: "compact",
+    "operation-supervisor": "terse"
+};
+export function resolveContextPolicy(config) {
+    const value = "context" in (config ?? {}) ? config.context : config;
+    const compression = value?.compression;
+    return {
+        mode: value?.mode ?? "enforce",
+        defaultBudget: value?.budgets?.default ?? { inputTokens: 16_000 },
+        agentBudgets: value?.budgets?.agents ?? {},
+        phaseBudgets: value?.budgets?.phases ?? {},
+        repositoryMap: { enabled: value?.repositoryMap?.enabled ?? true, tokenBudget: value?.repositoryMap?.tokenBudget ?? 2_000, maxGraphHops: value?.repositoryMap?.maxGraphHops ?? 2 },
+        semanticRetrieval: { provider: value?.semanticRetrieval?.provider ?? "serena", required: value?.semanticRetrieval?.required ?? true, editing: value?.semanticRetrieval?.editing ?? false },
+        compression: { provider: compression?.provider ?? "headroom", required: compression?.required ?? true, minTokens: compression?.minTokens ?? 2_000, reversible: compression?.reversible ?? true, command: compression?.command },
+        retrieval: { maxRequestsPerTurn: value?.retrieval?.maxRequestsPerTurn ?? 8, maxTokensPerRequest: value?.retrieval?.maxTokensPerRequest ?? 6_000, maxTotalTokensPerTurn: value?.retrieval?.maxTotalTokensPerTurn ?? 20_000 },
+        outputPolicy: { enabled: value?.outputPolicy?.enabled ?? true, modes: { ...defaultModes, ...(value?.outputPolicy?.modes ?? {}) } }
+    };
+}
+export function outputMode(policy, role) {
+    return policy.outputPolicy.modes[role ?? ""] ?? "compact";
+}
+export function isCompressionConfigured(policy) {
+    return policy.compression.provider === "headroom" && policy.compression.required;
+}
+export function outputPolicyInstruction(policy, role) {
+    if (!policy.outputPolicy.enabled)
+        return undefined;
+    const mode = outputMode(policy, role);
+    if (mode === "terse")
+        return "Output policy: terse. Do not restate the assignment or narrate trivial successful tool calls. Prefer durable artifact references; preserve evidence, uncertainty, blockers and exact structured-result contracts.";
+    if (mode === "compact")
+        return "Output policy: compact. Explain meaningful decisions and blockers, omit ceremony and repetitive summaries, and preserve everything required for safe implementation/review. Never shorten structured-result JSON.";
+    return "Output policy: normal. Be concise but complete; preserve exact evidence and structured-result contracts.";
+}
+//# sourceMappingURL=policy.js.map

package/dist/context/policy.js.map

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

package/dist/context/preflight.d.ts

@@ -0,0 +1,13 @@
+import type { HarnessProjectConfig } from "../core/types.js";
+export interface ContextReadiness {
+    ok: boolean;
+    checks: Array<{
+        component: string;
+        ok: boolean;
+        required: boolean;
+        message: string;
+        version?: string;
+    }>;
+}
+export declare function checkContextReadiness(root: string, config: HarnessProjectConfig): Promise<ContextReadiness>;
+export declare function assertContextReadiness(root: string, config: HarnessProjectConfig): Promise<void>;

package/dist/context/preflight.js

@@ -0,0 +1,19 @@
+import { HeadroomCompressionProvider } from "./compression/headroom.js";
+import { SerenaSemanticProvider } from "./repository/serena.js";
+export async function checkContextReadiness(root, config) {
+    if (!config.context)
+        return { ok: true, checks: [] };
+    const checks = [];
+    const semantic = await new SerenaSemanticProvider().doctor(root);
+    checks.push({ component: "serena", required: config.context.semanticRetrieval?.required ?? true, ...semantic });
+    const compression = await new HeadroomCompressionProvider({ command: config.context.compression?.command }).doctor(root);
+    checks.push({ component: "headroom", required: config.context.compression?.required ?? true, ...compression });
+    return { ok: checks.every((check) => !check.required || check.ok), checks };
+}
+export async function assertContextReadiness(root, config) {
+    const readiness = await checkContextReadiness(root, config);
+    const failures = readiness.checks.filter((check) => check.required && !check.ok);
+    if (failures.length)
+        throw new Error(`BLOCKED_EXTERNAL: mandatory context provider readiness failed. ${failures.map((failure) => `${failure.component}: ${failure.message}`).join("; ")}`);
+}
+//# sourceMappingURL=preflight.js.map

package/dist/context/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/context/preflight.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIhE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAA4B;IACpF,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrD,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,sBAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,IAAI,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IAChH,MAAM,WAAW,GAAG,MAAM,IAAI,2BAA2B,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzH,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,IAAI,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IAC/G,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAA4B;IACrF,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjF,IAAI,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7L,CAAC"}

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

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

package/dist/context/projectors/audit.js

@@ -0,0 +1,30 @@
+import { estimateTokens } from "../estimator.js";
+export function projectAudit(fragment) {
+    const source = parseJson(fragment.content);
+    const findings = Array.isArray(source?.findings) ? source.findings : [];
+    const lines = findings.map((finding) => {
+        const item = record(finding);
+        return [item.id, item.severity, item.location, item.evidence, item.status].filter(Boolean).join(" | ");
+    });
+    const content = [
+        `findings=${findings.length}`,
+        ...lines,
+        "authoritative raw audit evidence is available through the fragment source"
+    ].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 record(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return {};
+    const item = value;
+    const location = item.location && typeof item.location === "object" ? JSON.stringify(item.location) : String(item.location ?? "");
+    return { id: String(item.id ?? ""), severity: String(item.severity ?? ""), location, evidence: String(item.evidence ?? item.summary ?? ""), status: String(item.status ?? "") };
+}
+//# sourceMappingURL=audit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/context/projectors/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG;QACd,YAAY,QAAQ,CAAC,MAAM,EAAE;QAC7B,GAAG,KAAK;QACR,2EAA2E;KAC5E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,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;IAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAClI,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;AAClL,CAAC"}

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

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

package/dist/context/projectors/diff.js

@@ -0,0 +1,8 @@
+import { estimateTokens } from "../estimator.js";
+export function projectDiff(fragment) {
+    const lines = fragment.content.split(/\r?\n/);
+    const selected = lines.filter((line) => /^(diff --git|\+\+\+|---|@@|\+[^+]|-[^-])/.test(line));
+    const content = [...new Set(selected)].join("\n") || "No selected diff hunks; retrieve the authoritative diff artifact for exact anchors.";
+    return { ...fragment, content, estimatedTokens: estimateTokens(content), originalTokens: estimateTokens(fragment.content), projected: true };
+}
+//# sourceMappingURL=diff.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/context/projectors/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,UAAU,WAAW,CAAC,QAAyB;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qFAAqF,CAAC;IAC3I,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"}

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

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

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