pi-harness-runtime 0.10.11 → 0.10.13

package/packages/context-compiler/dist/budget.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Context Compiler - Token Budget Fitting
+ *
+ * Fits optional candidates into the available token budget.
+ * Required candidates always fit first.
+ * Uses the RFC-0041 character-based estimation (1 token ≈ 4 characters).
+ */
+import type { CompiledContextItem, ContextCandidate, OmittedItem } from "./types.js";
+/**
+ * Result of budget fitting.
+ */
+export interface BudgetFitResult {
+    included: ContextCandidate[];
+    omitted: OmittedItem[];
+    estimatedTokens: number;
+}
+/**
+ * Estimate tokens from content using 4 chars/token approximation.
+ */
+export declare function estimateTokens(content: string): number;
+/**
+ * Fit candidates into the token budget.
+ *
+ * Algorithm:
+ * 1. Always include required candidates
+ * 2. Sort optional by score (descending)
+ * 3. Greedily add optional until budget exhausted
+ * 4. Record all omitted with reason "budget"
+ *
+ * @param candidates - Ranked candidates (highest score first)
+ * @param maximumTokens - Available budget
+ * @returns Candidates to include and items to omit
+ */
+export declare function fitToBudget(candidates: Array<{
+    candidate: ContextCandidate;
+    score: number;
+}>, maximumTokens: number): BudgetFitResult;
+/**
+ * Convert included candidates to compiled items.
+ */
+export declare function toCompiledItems(candidates: ContextCandidate[]): CompiledContextItem[];
+//# sourceMappingURL=budget.d.ts.map

package/packages/context-compiler/dist/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAC1B,UAAU,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EACjE,aAAa,EAAE,MAAM,GACnB,eAAe,CAmDjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,gBAAgB,EAAE,GAC5B,mBAAmB,EAAE,CAgBvB"}

package/packages/context-compiler/dist/budget.js

@@ -0,0 +1,94 @@
+/**
+ * Context Compiler - Token Budget Fitting
+ *
+ * Fits optional candidates into the available token budget.
+ * Required candidates always fit first.
+ * Uses the RFC-0041 character-based estimation (1 token ≈ 4 characters).
+ */
+/**
+ * Estimate tokens from content using 4 chars/token approximation.
+ */
+export function estimateTokens(content) {
+    if (!content || content.trim() === "")
+        return 0;
+    return Math.ceil(content.length / 4);
+}
+/**
+ * Fit candidates into the token budget.
+ *
+ * Algorithm:
+ * 1. Always include required candidates
+ * 2. Sort optional by score (descending)
+ * 3. Greedily add optional until budget exhausted
+ * 4. Record all omitted with reason "budget"
+ *
+ * @param candidates - Ranked candidates (highest score first)
+ * @param maximumTokens - Available budget
+ * @returns Candidates to include and items to omit
+ */
+export function fitToBudget(candidates, maximumTokens) {
+    const included = [];
+    const omitted = [];
+    let usedTokens = 0;
+    for (const { candidate } of candidates) {
+        const tokens = estimateTokens(candidate.content);
+        // Optional items with no content are omitted (broken/unavailable)
+        if (!candidate.required &&
+            (!candidate.content || candidate.content.trim() === "")) {
+            omitted.push({
+                id: candidate.id,
+                kind: candidate.kind,
+                reason: "source_unavailable",
+                reasonDetail: "no content",
+                estimatedTokens: 0,
+            });
+            continue;
+        }
+        if (candidate.required) {
+            // Required: always include
+            included.push(candidate);
+            usedTokens += tokens;
+            continue;
+        }
+        // Optional: check budget
+        if (usedTokens + tokens <= maximumTokens) {
+            included.push(candidate);
+            usedTokens += tokens;
+        }
+        else {
+            omitted.push({
+                id: candidate.id,
+                kind: candidate.kind,
+                reason: "budget",
+                reasonDetail: `estimated ${tokens} tokens, only ${maximumTokens - usedTokens} remaining`,
+                estimatedTokens: tokens,
+            });
+        }
+    }
+    return {
+        included,
+        omitted,
+        estimatedTokens: usedTokens,
+    };
+}
+/**
+ * Convert included candidates to compiled items.
+ */
+export function toCompiledItems(candidates) {
+    return candidates.map((c) => ({
+        id: c.id,
+        kind: c.kind,
+        content: c.content,
+        source: c.source,
+        priority: c.priority,
+        required: c.required,
+        trust: c.trust,
+        estimatedTokens: estimateTokens(c.content),
+        contentHash: c.contentHash,
+        filePath: c.filePath,
+        startLine: c.startLine,
+        endLine: c.endLine,
+        symbols: c.symbols,
+    }));
+}
+//# sourceMappingURL=budget.js.map

package/packages/context-compiler/dist/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC7C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAC1B,UAAiE,EACjE,aAAqB;IAErB,MAAM,QAAQ,GAAuB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjD,kEAAkE;QAClE,IACC,CAAC,SAAS,CAAC,QAAQ;YACnB,CAAC,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EACtD,CAAC;YACF,OAAO,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM,EAAE,oBAAoB;gBAC5B,YAAY,EAAE,YAAY;gBAC1B,eAAe,EAAE,CAAC;aAClB,CAAC,CAAC;YACH,SAAS;QACV,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACxB,2BAA2B;YAC3B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,UAAU,IAAI,MAAM,CAAC;YACrB,SAAS;QACV,CAAC;QAED,yBAAyB;QACzB,IAAI,UAAU,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,UAAU,IAAI,MAAM,CAAC;QACtB,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,aAAa,MAAM,iBAAiB,aAAa,GAAG,UAAU,YAAY;gBACxF,eAAe,EAAE,MAAM;aACvB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO;QACN,QAAQ;QACR,OAAO;QACP,eAAe,EAAE,UAAU;KAC3B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC9B,UAA8B;IAE9B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1C,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;KAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/packages/context-compiler/dist/cache.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Context Compiler - Cache & Invalidation
+ *
+ * Generates deterministic cache keys from selected source hashes.
+ * Tracks invalidation triggers.
+ */
+import type { CompiledContext, CompiledContextItem, ContextInvalidation } from "./types.js";
+/**
+ * Generate a deterministic cache key from compiled context items.
+ * Includes source file hashes for content invalidation.
+ */
+export declare function generateCacheKey(taskId: string, items: CompiledContextItem[], taskObjective: string): string;
+/**
+ * Check if a compiled context should be invalidated.
+ *
+ * Invalidation triggers:
+ * - A selected source file hash changed
+ * - A project rule changed
+ * - A required OKF concept changed
+ * - The task objective changed
+ * - A test failure superseded an old one
+ * - Worktree branch/HEAD changed
+ */
+export declare function shouldInvalidate(previous: CompiledContext, invalidation: ContextInvalidation, currentItemHashes: Map<string, string>): boolean;
+/**
+ * Generate current item hashes from a compiled context.
+ */
+export declare function extractItemHashes(items: CompiledContextItem[]): Map<string, string>;
+/**
+ * Simple deterministic hash for strings.
+ * Used for cache keys when crypto is unavailable.
+ */
+export declare function simpleHash(text: string): string;
+//# sourceMappingURL=cache.d.ts.map

package/packages/context-compiler/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,EAAE,EAC5B,aAAa,EAAE,MAAM,GACnB,MAAM,CAWR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,eAAe,EACzB,YAAY,EAAE,mBAAmB,EACjC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,OAAO,CAuDT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,mBAAmB,EAAE,GAC1B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQrB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ/C"}

package/packages/context-compiler/dist/cache.js

@@ -0,0 +1,99 @@
+/**
+ * Context Compiler - Cache & Invalidation
+ *
+ * Generates deterministic cache keys from selected source hashes.
+ * Tracks invalidation triggers.
+ */
+/**
+ * Generate a deterministic cache key from compiled context items.
+ * Includes source file hashes for content invalidation.
+ */
+export function generateCacheKey(taskId, items, taskObjective) {
+    // Sort by source path for determinism
+    const hashes = items
+        .filter((item) => item.contentHash)
+        .map((item) => `${item.source}:${item.contentHash}`)
+        .sort();
+    const objectiveHash = simpleHash(taskObjective);
+    const combined = `${taskId}:${objectiveHash}:${hashes.join(",")}`;
+    return `ctx:${simpleHash(combined)}`;
+}
+/**
+ * Check if a compiled context should be invalidated.
+ *
+ * Invalidation triggers:
+ * - A selected source file hash changed
+ * - A project rule changed
+ * - A required OKF concept changed
+ * - The task objective changed
+ * - A test failure superseded an old one
+ * - Worktree branch/HEAD changed
+ */
+export function shouldInvalidate(previous, invalidation, currentItemHashes) {
+    switch (invalidation.reason) {
+        case "source_hash_changed": {
+            const changed = invalidation.details?.sourcePath;
+            if (!changed)
+                return true;
+            const item = previous.items.find((i) => i.source === changed);
+            if (!item)
+                return false;
+            const currentHash = currentItemHashes.get(changed);
+            return currentHash !== item.contentHash;
+        }
+        case "project_rule_changed": {
+            const rulePath = invalidation.details?.rulePath;
+            const ruleItem = previous.items.find((i) => i.kind === "project_rule" &&
+                (i.source === rulePath || i.filePath === rulePath));
+            return ruleItem !== undefined;
+        }
+        case "required_okf_changed": {
+            const okfId = invalidation.details?.okfId;
+            return (previous.items.find((i) => i.kind === "okf_concept" && i.id === okfId && i.required) !== undefined);
+        }
+        case "task_objective_changed": {
+            return true; // Always invalidate on objective change
+        }
+        case "test_failure_superseded": {
+            const oldFailure = invalidation.details?.oldFailureId;
+            if (!oldFailure)
+                return false;
+            const existingFailure = previous.items.find((i) => i.kind === "test_failure" && i.id === oldFailure);
+            return existingFailure !== undefined;
+        }
+        case "worktree_branch_changed": {
+            const oldBranch = invalidation.details?.oldBranch;
+            const newBranch = invalidation.details?.newBranch;
+            // Invalidate if any source file changed or if branch changed
+            return oldBranch !== newBranch;
+        }
+        default:
+            return false;
+    }
+}
+/**
+ * Generate current item hashes from a compiled context.
+ */
+export function extractItemHashes(items) {
+    const map = new Map();
+    for (const item of items) {
+        if (item.contentHash) {
+            map.set(item.source, item.contentHash);
+        }
+    }
+    return map;
+}
+/**
+ * Simple deterministic hash for strings.
+ * Used for cache keys when crypto is unavailable.
+ */
+export function simpleHash(text) {
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+        const char = text.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash |= 0;
+    }
+    return Math.abs(hash).toString(16).padStart(8, "0");
+}
+//# sourceMappingURL=cache.js.map

package/packages/context-compiler/dist/cache.js.map

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

package/packages/context-compiler/dist/compiler.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Context Compiler - Compiler
+ *
+ * Main entry point for context compilation.
+ * Pipeline: collect → policy filter → score → deduplicate → fit budget → source graph.
+ */
+import type { ContextCompileRequest, ContextSourceEdge, OmittedItem } from "./types.js";
+import { toCompiledItems } from "./budget.js";
+/**
+ * Default clock for generating timestamps.
+ */
+export declare function createClock(): {
+    now: () => Date;
+};
+export interface Clock {
+    now: () => Date;
+}
+/**
+ * Compile context from candidates.
+ *
+ * Pipeline:
+ * 1. Apply policy filter (deny patterns, size limits)
+ * 2. Score optional candidates
+ * 3. Merge file slices
+ * 4. Deduplicate
+ * 5. Fit to token budget
+ * 6. Generate source graph
+ * 7. Return CompiledContext
+ */
+export declare function compileContext(request: ContextCompileRequest, clock?: Clock): Promise<CompiledContextOutput>;
+/**
+ * Compiled context output (extended with cache key).
+ */
+export interface CompiledContextOutput {
+    taskId: string;
+    items: ReturnType<typeof toCompiledItems>[number][];
+    omitted: OmittedItem[];
+    estimatedTokens: number;
+    sourceGraph: ContextSourceEdge[];
+    generatedAt: string;
+    mapping: Record<string, string>;
+    cacheKey: string;
+}
+/**
+ * Enrich context candidates with OKF concepts from ~/.pi/okf/.
+ *
+ * This is optional - if the OKF directory doesn't exist,
+ * candidates remain unchanged.
+ *
+ * Usage:
+ * ```ts
+ * const enriched = enrichWithOkf(candidates);
+ * const result = await compileContext({ ...request, candidates: enriched });
+ * ```
+ */
+export declare function enrichWithOkf(candidates: ContextCompileRequest["candidates"], okfPath?: string): ContextCompileRequest["candidates"];
+//# sourceMappingURL=compiler.d.ts.map

package/packages/context-compiler/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,iBAAiB,EAEjB,WAAW,EACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAA+B,eAAe,EAAE,MAAM,aAAa,CAAC;AAW3E;;GAEG;AACH,wBAAgB,WAAW;IACjB,GAAG;EACZ;AAED,MAAM,WAAW,KAAK;IACrB,GAAG,EAAE,MAAM,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,GAAE,KAAqB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAgHhC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAoGD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,EAC/C,OAAO,CAAC,EAAE,MAAM,GACd,qBAAqB,CAAC,YAAY,CAAC,CAoBrC"}

package/packages/context-compiler/dist/compiler.js

@@ -0,0 +1,219 @@
+/**
+ * Context Compiler - Compiler
+ *
+ * Main entry point for context compilation.
+ * Pipeline: collect → policy filter → score → deduplicate → fit budget → source graph.
+ */
+import { ContextCompileError } from "./types.js";
+import { estimateTokens, fitToBudget, toCompiledItems } from "./budget.js";
+import { generateCacheKey } from "./cache.js";
+import { deduplicateCandidates, mergeFileSlices } from "./deduplicate.js";
+import { applyPolicyFilter, mergePolicy } from "./filter.js";
+import { mergeWeights, rankCandidates } from "./score.js";
+import { loadOkfConcepts, okfDirectoryExists, getOkfPath, } from "./okf-loader.js";
+/**
+ * Default clock for generating timestamps.
+ */
+export function createClock() {
+    return { now: () => new Date() };
+}
+/**
+ * Compile context from candidates.
+ *
+ * Pipeline:
+ * 1. Apply policy filter (deny patterns, size limits)
+ * 2. Score optional candidates
+ * 3. Merge file slices
+ * 4. Deduplicate
+ * 5. Fit to token budget
+ * 6. Generate source graph
+ * 7. Return CompiledContext
+ */
+export async function compileContext(request, clock = createClock()) {
+    const { taskId, taskObjective, maximumTokens, candidates, scoringWeights, policy, } = request;
+    // 0. Validate required sources exist
+    const missingRequired = candidates
+        .filter((c) => c.required)
+        .filter((c) => !c.content.trim());
+    if (missingRequired.length > 0) {
+        const first = missingRequired[0];
+        if (!first)
+            throw new Error("Internal: missingRequired should not be empty");
+        throw new ContextCompileError("MISSING_REQUIRED_SOURCE", `Required source "${first.source}" has no content`, {
+            missingSources: missingRequired.map((c) => c.source),
+        });
+    }
+    // 1. Apply policy filter
+    const resolvedPolicy = mergePolicy(policy);
+    const { passed: policyPassed, denied: policyDenied } = applyPolicyFilter(candidates, resolvedPolicy);
+    const policyOmitted = policyDenied.map(({ candidate, reason }) => ({
+        id: candidate.id,
+        kind: candidate.kind,
+        reason: "policy_denied",
+        reasonDetail: reason,
+        estimatedTokens: estimateTokens(candidate.content),
+        deniedBy: reason,
+    }));
+    // 2. Score optional candidates
+    const weights = mergeWeights(scoringWeights);
+    const scoreContext = {
+        directFileReferences: extractDirectReferences(taskObjective),
+        taskDependencies: extractDependencies(taskObjective),
+    };
+    // 3. Merge file slices (before scoring)
+    const merged = mergeFileSlices(policyPassed);
+    // 4. Deduplicate
+    const { unique: deduped, duplicates: dupIds } = deduplicateCandidates(merged);
+    const dedupOmitted = dupIds.map((id) => {
+        const c = candidates.find((x) => x.id === id);
+        return {
+            id,
+            kind: c?.kind ?? "source_file",
+            reason: "duplicate",
+            reasonDetail: `duplicate of ${c?.source ?? id}`,
+            estimatedTokens: estimateTokens(c?.content ?? ""),
+        };
+    });
+    // 5. Rank by score
+    const ranked = rankCandidates(deduped, weights, scoreContext);
+    // 6. Fit to budget
+    const { included, omitted: budgetOmitted } = fitToBudget(ranked, maximumTokens);
+    // 7. Convert to compiled items
+    const compiledItems = toCompiledItems(included);
+    // 8. Generate source graph
+    const sourceGraph = buildSourceGraph(compiledItems);
+    // 9. Generate cache key
+    const cacheKey = generateCacheKey(taskId, compiledItems, taskObjective);
+    // 10. Build mapping
+    const mapping = {};
+    for (const c of candidates) {
+        const compiled = compiledItems.find((i) => i.id === c.id);
+        if (compiled) {
+            mapping[c.id] = compiled.id;
+        }
+    }
+    const totalOmitted = [...policyOmitted, ...dedupOmitted, ...budgetOmitted];
+    return {
+        taskId,
+        items: compiledItems,
+        omitted: totalOmitted,
+        estimatedTokens: compiledItems.reduce((sum, item) => sum + item.estimatedTokens, 0),
+        sourceGraph,
+        generatedAt: clock.now().toISOString(),
+        mapping,
+        cacheKey,
+    };
+}
+/**
+ * Extract direct file references from task objective.
+ * Looks for quoted paths, file patterns.
+ */
+function extractDirectReferences(objective) {
+    const refs = new Set();
+    // Match quoted paths
+    const quotedMatches = objective.matchAll(/(["'`])([^`1]+)\1/g);
+    for (const match of quotedMatches) {
+        const path = match[2];
+        if (path)
+            refs.add(path);
+    }
+    // Match common file patterns
+    const filePattern = /[a-zA-Z][a-zA-Z0-9_/-]*\.(ts|tsx|js|jsx|py|go|rs|java|cpp|h|c|md|json|yaml|yml|toml)\b/g;
+    for (const match of objective.matchAll(filePattern)) {
+        const path = match[0];
+        if (path)
+            refs.add(path);
+    }
+    return refs;
+}
+/**
+ * Extract dependency references from task objective.
+ */
+function extractDependencies(objective) {
+    const deps = [];
+    // Match "depends on X", "related to Y"
+    const depPatterns = [
+        /(?:depends on|related to|imports from)\s+([A-Za-z][A-Za-z0-9_.-]*)/gi,
+    ];
+    for (const pattern of depPatterns) {
+        for (const match of objective.matchAll(pattern)) {
+            const name = match[1];
+            if (name)
+                deps.push(name);
+        }
+    }
+    return [...new Set(deps)];
+}
+/**
+ * Build source graph edges between related items.
+ */
+function buildSourceGraph(items) {
+    const edges = [];
+    const okfItems = items.filter((i) => i.kind === "okf_concept");
+    const sourceItems = items.filter((i) => i.kind === "source_file");
+    const testItems = items.filter((i) => i.kind === "test_failure");
+    // OKF concepts → source files they reference
+    for (const okf of okfItems) {
+        for (const src of sourceItems) {
+            if (okf.content.includes(src.source) ||
+                (src.filePath && okf.content.includes(src.filePath))) {
+                edges.push({
+                    from: okf.id,
+                    to: src.id,
+                    label: "references",
+                    weight: 3,
+                });
+            }
+        }
+    }
+    // Source files → test failures they relate to
+    for (const src of sourceItems) {
+        for (const test of testItems) {
+            if (test.content.includes(src.source) ||
+                (src.filePath && test.content.includes(src.filePath))) {
+                edges.push({
+                    from: src.id,
+                    to: test.id,
+                    label: "causes_failure",
+                    weight: 5,
+                });
+            }
+        }
+    }
+    // Sort edges deterministically
+    edges.sort((a, b) => {
+        const keyA = `${a.from}:${a.to}:${a.label}`;
+        const keyB = `${b.from}:${b.to}:${b.label}`;
+        return keyA.localeCompare(keyB);
+    });
+    return edges;
+}
+// --- OKF Integration --------------------------------------------------------
+/**
+ * Enrich context candidates with OKF concepts from ~/.pi/okf/.
+ *
+ * This is optional - if the OKF directory doesn't exist,
+ * candidates remain unchanged.
+ *
+ * Usage:
+ * ```ts
+ * const enriched = enrichWithOkf(candidates);
+ * const result = await compileContext({ ...request, candidates: enriched });
+ * ```
+ */
+export function enrichWithOkf(candidates, okfPath) {
+    const okfConcepts = loadOkfConcepts(okfPath);
+    if (okfConcepts.length === 0) {
+        return candidates;
+    }
+    // Log for debugging (can be removed in production)
+    if (okfDirectoryExists(okfPath)) {
+        console.log(`[OKF] Loaded ${okfConcepts.length} concepts from ${getOkfPath()}`);
+    }
+    // Merge OKF concepts with existing candidates
+    // Existing candidates take precedence (won't be overwritten)
+    const existingIds = new Set(candidates.map((c) => c.id));
+    const newConcepts = okfConcepts.filter((c) => !existingIds.has(c.id));
+    return [...candidates, ...newConcepts];
+}
+//# sourceMappingURL=compiler.js.map

package/packages/context-compiler/dist/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACN,eAAe,EACf,kBAAkB,EAClB,UAAU,GACV,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAClC,CAAC;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAA8B,EAC9B,KAAK,GAAU,WAAW,EAAE;IAE5B,MAAM,EACL,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,cAAc,EACd,MAAM,GACN,GAAG,OAAO,CAAC;IAEZ,qCAAqC;IACrC,MAAM,eAAe,GAAG,UAAU;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK;YACT,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAClE,MAAM,IAAI,mBAAmB,CAC5B,yBAAyB,EACzB,oBAAoB,KAAK,CAAC,MAAM,kBAAkB,EAClD;YACC,cAAc,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;SACpD,CACD,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,iBAAiB,CACvE,UAAU,EACV,cAAc,CACd,CAAC;IAEF,MAAM,aAAa,GAAkB,YAAY,CAAC,GAAG,CACpD,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3B,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM,EAAE,eAAiC;QACzC,YAAY,EAAE,MAAM;QACpB,eAAe,EAAE,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC;QAClD,QAAQ,EAAE,MAAM;KAChB,CAAC,CACF,CAAC;IAEF,+BAA+B;IAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG;QACpB,oBAAoB,EAAE,uBAAuB,CAAC,aAAa,CAAC;QAC5D,gBAAgB,EAAE,mBAAmB,CAAC,aAAa,CAAC;KACpD,CAAC;IAEF,wCAAwC;IACxC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IAE7C,iBAAiB;IACjB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE9E,MAAM,YAAY,GAAkB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QACrD,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,OAAO;YACN,EAAE;YACF,IAAI,EAAE,CAAC,EAAE,IAAI,IAAI,aAAa;YAC9B,MAAM,EAAE,WAA6B;YACrC,YAAY,EAAE,gBAAgB,CAAC,EAAE,MAAM,IAAI,EAAE,EAAE;YAC/C,eAAe,EAAE,cAAc,CAAC,CAAC,EAAE,OAAO,IAAI,EAAE,CAAC;SACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAE9D,mBAAmB;IACnB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,WAAW,CACvD,MAAM,EACN,aAAa,CACb,CAAC;IAEF,+BAA+B;IAC/B,MAAM,aAAa,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEhD,2BAA2B;IAC3B,MAAM,WAAW,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAEpD,wBAAwB;IACxB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAExE,oBAAoB;IACpB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,YAAY,EAAE,GAAG,aAAa,CAAC,CAAC;IAE3E,OAAO;QACN,MAAM;QACN,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,YAAY;QACrB,eAAe,EAAE,aAAa,CAAC,MAAM,CACpC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,eAAe,EACzC,CAAC,CACD;QACD,WAAW;QACX,WAAW,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtC,OAAO;QACP,QAAQ;KACR,CAAC;AACH,CAAC;AAgBD;;;GAGG;AACH,SAAS,uBAAuB,CAAC,SAAiB;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,qBAAqB;IACrB,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,6BAA6B;IAC7B,MAAM,WAAW,GAChB,yFAAyF,CAAC;IAC3F,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,uCAAuC;IACvC,MAAM,WAAW,GAAG;QACnB,sEAAsE;KACtE,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACF,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACxB,KAAmD;IAEnD,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;IAEjE,6CAA6C;IAC7C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC/B,IACC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;gBAChC,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EACnD,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,GAAG,CAAC,EAAE;oBACZ,EAAE,EAAE,GAAG,CAAC,EAAE;oBACV,KAAK,EAAE,YAAY;oBACnB,MAAM,EAAE,CAAC;iBACT,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,8CAA8C;IAC9C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC9B,IACC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;gBACjC,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EACpD,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,GAAG,CAAC,EAAE;oBACZ,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,KAAK,EAAE,gBAAgB;oBACvB,MAAM,EAAE,CAAC;iBACT,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACd,CAAC;AAED,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC5B,UAA+C,EAC/C,OAAgB;IAEhB,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC;IACnB,CAAC;IAED,mDAAmD;IACnD,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CACV,gBAAgB,WAAW,CAAC,MAAM,kBAAkB,UAAU,EAAE,EAAE,CAClE,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,6DAA6D;IAC7D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO,CAAC,GAAG,UAAU,EAAE,GAAG,WAAW,CAAC,CAAC;AACxC,CAAC"}

package/packages/context-compiler/dist/deduplicate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Context Compiler - Deduplication
+ *
+ * Removes duplicate candidates and merges overlapping source file slices.
+ * Uses content normalization for deduplication (same as RFC-0041).
+ */
+import type { ContextCandidate } from "./types.js";
+/**
+ * Deduplicate candidates by normalized content.
+ * Required candidates are never deduplicated (preserved).
+ *
+ * For source files with overlapping ranges, merge into a single slice.
+ *
+ * @returns [uniqueCandidates, duplicateIds]
+ */
+export declare function deduplicateCandidates(candidates: ContextCandidate[]): {
+    unique: ContextCandidate[];
+    duplicates: string[];
+};
+/**
+ * Merge overlapping file slices from the same file.
+ * Merges adjacent/overlapping line ranges and deduplicates symbols.
+ */
+export declare function mergeFileSlices(candidates: ContextCandidate[]): ContextCandidate[];
+//# sourceMappingURL=deduplicate.d.ts.map

package/packages/context-compiler/dist/deduplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicate.d.ts","sourceRoot":"","sources":["../src/deduplicate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG;IACtE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB,CAwBA;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,gBAAgB,EAAE,GAC5B,gBAAgB,EAAE,CAoCpB"}