daftari 1.15.0 → 1.16.0

package/dist/eval/run.js

@@ -0,0 +1,78 @@
+// src/eval/run.ts
+// The answerer loop. For each question, run the answerer LLM k independent
+// times against the in-process tool surface, recording a full trace per run.
+// Results are keyed by `"${question_index}:${k_index}"` so --resume can skip
+// pairs already marked complete and re-run only the rest.
+import { err, ok } from "../frontmatter/types.js";
+import { ANSWERER_SYSTEM_PROMPT, PROMPT_VERSION } from "./prompts.js";
+import { buildToolSurface } from "./tool-surface.js";
+export async function runAnswerer(questions, vaultRoot, llm, opts) {
+    const ts = opts.timestamp ?? "2026-01-01T00:00:00Z";
+    const id = opts.resumeFrom?.id ?? opts.runId ?? `${questions.id}-${opts.model}-${ts}`;
+    const runs = { ...(opts.resumeFrom?.runs ?? {}) };
+    // Builds the current EvalRun from the live `runs` map. Snapshotting after
+    // each (q,k) status change lets the caller persist partial progress, so a
+    // failure/crash leaves a resumable file on disk (see --resume).
+    const snapshot = () => ({
+        id,
+        questions_id: questions.id,
+        answerer_model: opts.model,
+        prompt_version: PROMPT_VERSION,
+        timestamp: ts,
+        k: opts.k,
+        runs,
+    });
+    const tools = buildToolSurface(vaultRoot);
+    const toolDefs = tools.defs;
+    for (let qi = 0; qi < questions.questions.length; qi++) {
+        const q = questions.questions[qi];
+        for (let k = 0; k < opts.k; k++) {
+            const key = `${qi}:${k}`;
+            if (runs[key]?.status === "complete")
+                continue;
+            const t0 = Date.now();
+            const r = await llm.completeWithTools({
+                model: opts.model,
+                system: ANSWERER_SYSTEM_PROMPT,
+                user: q.question,
+                tools: toolDefs,
+                toolHandler: tools.handler,
+            });
+            const wall_ms = Date.now() - t0;
+            if (!r.ok) {
+                // Mark this pair incomplete, persist the partial run (completed pairs
+                // plus this incomplete one), then surface the error. Persisting here
+                // is what makes --resume work: progress made before the failure is
+                // saved, so a re-run skips the completed pairs and retries the rest.
+                runs[key] = {
+                    question_id: q.id,
+                    question_index: qi,
+                    k_index: k,
+                    status: "incomplete",
+                    trace: null,
+                };
+                await opts.persist?.(snapshot());
+                return err(r.error);
+            }
+            const trace = {
+                tool_calls: r.value.tool_calls,
+                final_answer: r.value.text,
+                total_tool_calls: r.value.tool_calls.length,
+                input_tokens: r.value.input_tokens,
+                output_tokens: r.value.output_tokens,
+                wall_ms,
+                stop_reason: r.value.stop_reason,
+            };
+            runs[key] = {
+                question_id: q.id,
+                question_index: qi,
+                k_index: k,
+                status: "complete",
+                trace,
+            };
+            await opts.persist?.(snapshot());
+        }
+    }
+    return ok(snapshot());
+}
+//# sourceMappingURL=run.js.map

package/dist/eval/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/eval/run.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,0DAA0D;AAE1D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAe,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAYrD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAsB,EACtB,SAAiB,EACjB,GAAc,EACd,IAAgB;IAEhB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;IACtF,MAAM,IAAI,GAAiC,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IAEhF,0EAA0E;IAC1E,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,QAAQ,GAAG,GAAY,EAAE,CAAC,CAAC;QAC/B,EAAE;QACF,YAAY,EAAE,SAAS,CAAC,EAAE;QAC1B,cAAc,EAAE,IAAI,CAAC,KAAK;QAC1B,cAAc,EAAE,cAAc;QAC9B,SAAS,EAAE,EAAE;QACb,CAAC,EAAE,IAAI,CAAC,CAAC;QACT,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAc,KAAK,CAAC,IAAI,CAAC;IAEvC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,UAAU;gBAAE,SAAS;YAE/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC;gBACpC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,sBAAsB;gBAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ;gBAChB,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,KAAK,CAAC,OAAO;aAC3B,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,sEAAsE;gBACtE,qEAAqE;gBACrE,mEAAmE;gBACnE,qEAAqE;gBACrE,IAAI,CAAC,GAAG,CAAC,GAAG;oBACV,WAAW,EAAE,CAAC,CAAC,EAAE;oBACjB,cAAc,EAAE,EAAE;oBAClB,OAAO,EAAE,CAAC;oBACV,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,IAAI;iBACZ,CAAC;gBACF,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjC,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YAED,MAAM,KAAK,GAAU;gBACnB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU;gBAC9B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;gBAC1B,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM;gBAC3C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY;gBAClC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa;gBACpC,OAAO;gBACP,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW;aACjC,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,GAAG;gBACV,WAAW,EAAE,CAAC,CAAC,EAAE;gBACjB,cAAc,EAAE,EAAE;gBAClB,OAAO,EAAE,CAAC;gBACV,MAAM,EAAE,UAAU;gBAClB,KAAK;aACN,CAAC;YACF,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxB,CAAC"}

package/dist/eval/score.d.ts

@@ -0,0 +1,12 @@
+import { type Result } from "../frontmatter/types.js";
+import type { LlmClient } from "./llm.js";
+import { type CortexEvalError, type Grade, type Question, type Score, type Trace } from "./types.js";
+export interface AggregateOptions {
+    traces: Map<string, Trace>;
+}
+export declare function aggregateScore(grades: Grade[], questions: Question[], opts: AggregateOptions): Score;
+export interface GradeOptions {
+    model: string;
+}
+export declare function gradeAnswer(question: Question, questionIndex: number, kIndex: number, trace: Trace, llm: LlmClient, opts: GradeOptions): Promise<Result<Grade, CortexEvalError>>;
+//# sourceMappingURL=score.d.ts.map

package/dist/eval/score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/eval/score.ts"],"names":[],"mappings":"AAKA,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,KAAK,EAEV,KAAK,QAAQ,EACb,KAAK,KAAK,EAKV,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAE/B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC5B;AAUD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,KAAK,EAAE,EACf,SAAS,EAAE,QAAQ,EAAE,EACrB,IAAI,EAAE,gBAAgB,GACrB,KAAK,CAmFP;AAiCD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAiCzC"}

package/dist/eval/score.js

@@ -0,0 +1,154 @@
+// src/eval/score.ts
+// Aggregation of per-(question, k) grades into the headline tier-weighted
+// score. Pure math. The LLM grader is added in Task 10; this v1 only
+// computes scores from already-graded inputs.
+import { ok } from "../frontmatter/types.js";
+import { GRADER_PROMPT } from "./prompts.js";
+import { TIER_WEIGHT, TIERS, } from "./types.js";
+// Maps verdict to numeric value; null means excluded from aggregate.
+const VERDICT_VALUE = {
+    yes: 1.0,
+    partial: 0.5,
+    no: 0.0,
+    ungraded: null,
+};
+export function aggregateScore(grades, questions, opts) {
+    const byTier = blankByTier();
+    // Group grades by question_id without non-null assertions.
+    const byQuestion = new Map();
+    for (const grade of grades) {
+        pushTo(byQuestion, grade.question_id, grade);
+    }
+    for (const tier of TIERS) {
+        const tierQuestions = questions.filter((q) => q.tier === tier);
+        const perQuestionMeans = [];
+        const efficiencyHits = [];
+        for (const q of tierQuestions) {
+            // Only include grades with a numeric verdict value (excludes ungraded).
+            const qGrades = (byQuestion.get(q.id) ?? []).filter((grade) => {
+                const val = VERDICT_VALUE[grade.verdict];
+                return val !== null;
+            });
+            if (qGrades.length === 0)
+                continue;
+            const values = qGrades.map((grade) => {
+                // Safe: we already filtered nulls above.
+                const val = VERDICT_VALUE[grade.verdict];
+                return val !== null ? val : 0;
+            });
+            const mean = avg(values);
+            perQuestionMeans.push(mean);
+            for (const grade of qGrades) {
+                const val = VERDICT_VALUE[grade.verdict];
+                if (val !== null && val > 0) {
+                    const t = opts.traces.get(`${grade.question_id}:${grade.k_index}`);
+                    if (t)
+                        efficiencyHits.push(t.total_tool_calls);
+                }
+            }
+        }
+        byTier[tier] = {
+            mean: perQuestionMeans.length > 0 ? avg(perQuestionMeans) : 0,
+            std: perQuestionMeans.length > 0 ? stddev(perQuestionMeans) : 0,
+            n: perQuestionMeans.length,
+            trace_efficiency: efficiencyHits.length > 0 ? avg(efficiencyHits) : 0,
+        };
+    }
+    // Weighted aggregate: sum(weight * tier_mean * tier_n) / sum(weight * tier_n)
+    let num = 0;
+    let denom = 0;
+    for (const tier of TIERS) {
+        const w = TIER_WEIGHT[tier];
+        const ts = byTier[tier];
+        num += w * ts.mean * ts.n;
+        denom += w * ts.n;
+    }
+    const score = denom > 0 ? num / denom : 0;
+    const scoreStd = denom > 0
+        ? Math.sqrt(TIERS.reduce((acc, t) => {
+            const w = TIER_WEIGHT[t];
+            const ts = byTier[t];
+            return acc + ((w * ts.n) / denom) * ts.std ** 2;
+        }, 0))
+        : 0;
+    return {
+        score,
+        score_std: scoreStd,
+        by_tier: byTier,
+        models: { generator: "", answerer: "", grader: "" },
+        prompt_version: 0,
+        spec_version: 0,
+        questions_id: "",
+        results_id: "",
+        vault_hash: "",
+        k: 0,
+        n: 0,
+        timestamp: "",
+    };
+}
+function blankByTier() {
+    return {
+        retrieval: { mean: 0, std: 0, n: 0, trace_efficiency: 0 },
+        cross_reference: { mean: 0, std: 0, n: 0, trace_efficiency: 0 },
+        contradiction: { mean: 0, std: 0, n: 0, trace_efficiency: 0 },
+    };
+}
+// Appends `value` to the array at `key`, creating the array on first use.
+// Mirrors the pushTo pattern from subgraph.ts to avoid non-null assertions.
+function pushTo(m, key, value) {
+    const arr = m.get(key);
+    if (arr) {
+        arr.push(value);
+    }
+    else {
+        m.set(key, [value]);
+    }
+}
+function avg(xs) {
+    return xs.reduce((a, b) => a + b, 0) / xs.length;
+}
+function stddev(xs) {
+    if (xs.length < 2)
+        return 0;
+    const m = avg(xs);
+    return Math.sqrt(xs.reduce((acc, x) => acc + (x - m) ** 2, 0) / xs.length);
+}
+export async function gradeAnswer(question, questionIndex, kIndex, trace, llm, opts) {
+    const cited = extractCitations(trace.final_answer);
+    const user = GRADER_PROMPT.replace("{{QUESTION}}", question.question)
+        .replace("{{EXPECTED_ANSWER}}", question.expected_answer)
+        .replace("{{EXPECTED_SOURCES}}", question.expected_sources.join(", "))
+        .replace("{{CLAIMED_ANSWER}}", trace.final_answer)
+        .replace("{{CITED_SOURCES}}", cited.join(", "));
+    const schema = {
+        type: "object",
+        required: ["correct", "reasoning"],
+        properties: {
+            correct: { enum: ["yes", "partial", "no"] },
+            reasoning: { type: "string" },
+        },
+    };
+    const r = await llm.completeJson({ model: opts.model, system: "", user, schema });
+    if (!r.ok)
+        return r;
+    // biome-ignore lint/suspicious/noExplicitAny: parsed JSON
+    const parsed = r.value.parsed;
+    const verdict = parsed?.correct === "yes" || parsed?.correct === "partial" || parsed?.correct === "no"
+        ? parsed.correct
+        : "ungraded";
+    return ok({
+        question_id: question.id,
+        question_index: questionIndex,
+        k_index: kIndex,
+        verdict,
+        reasoning: typeof parsed?.reasoning === "string" ? parsed.reasoning : "",
+        grader_model: opts.model,
+    });
+}
+function extractCitations(answer) {
+    const out = [];
+    for (const m of answer.matchAll(/\[([^\]]+\.md)\]/g))
+        out.push(m[1]);
+    return out;
+}
+//# sourceMappingURL=score.js.map

package/dist/eval/score.js.map

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

package/dist/eval/storage.d.ts

@@ -0,0 +1,10 @@
+import { type Result } from "../frontmatter/types.js";
+import { type CortexEvalError, type EvalRun, type HistoryEntry, type HistoryFile, type QuestionSet, type Score } from "./types.js";
+export declare function writeQuestionSet(vault: string, qs: QuestionSet): Promise<void>;
+export declare function readQuestionSet(vault: string, id: string): Promise<Result<QuestionSet, CortexEvalError>>;
+export declare function writeResults(vault: string, run: EvalRun): Promise<void>;
+export declare function readResults(vault: string, id: string): Promise<Result<EvalRun, CortexEvalError>>;
+export declare function writeScore(vault: string, score: Score): Promise<void>;
+export declare function appendHistory(vault: string, entry: HistoryEntry): Promise<void>;
+export declare function readHistory(vault: string): Promise<Result<HistoryFile, CortexEvalError>>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/eval/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/eval/storage.ts"],"names":[],"mappings":"AAOA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,OAAO,EAEZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AA0BpB,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAE/C;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAEhG;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3E;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrF;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAY9F"}

package/dist/eval/storage.js

@@ -0,0 +1,69 @@
+// src/eval/storage.ts
+// JSON I/O under .daftari/eval/. No business logic — just paths, schemas,
+// rotation. Read paths are read-only-compatible per spec §12 resolution 5.
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { err, ok } from "../frontmatter/types.js";
+import { HISTORY_RETENTION, } from "./types.js";
+const EVAL_DIR = (vault) => join(vault, ".daftari", "eval");
+const QS_DIR = (vault) => join(EVAL_DIR(vault), "questions");
+const RES_DIR = (vault) => join(EVAL_DIR(vault), "results");
+const SCORE_DIR = (vault) => join(EVAL_DIR(vault), "scores");
+const HIST_FILE = (vault) => join(EVAL_DIR(vault), "history.json");
+async function ensureDir(p) {
+    await mkdir(p, { recursive: true });
+}
+function writeJson(path, value) {
+    return writeFile(path, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+async function readJson(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        return ok(JSON.parse(raw));
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        return err({ kind: "runtime", message: `read ${path}: ${msg}` });
+    }
+}
+export async function writeQuestionSet(vault, qs) {
+    await ensureDir(QS_DIR(vault));
+    await writeJson(join(QS_DIR(vault), `${qs.id}.json`), qs);
+}
+export function readQuestionSet(vault, id) {
+    return readJson(join(QS_DIR(vault), `${id}.json`));
+}
+export async function writeResults(vault, run) {
+    await ensureDir(RES_DIR(vault));
+    await writeJson(join(RES_DIR(vault), `${run.id}.json`), run);
+}
+export function readResults(vault, id) {
+    return readJson(join(RES_DIR(vault), `${id}.json`));
+}
+export async function writeScore(vault, score) {
+    await ensureDir(SCORE_DIR(vault));
+    await writeJson(join(SCORE_DIR(vault), `${score.results_id}.json`), score);
+}
+export async function appendHistory(vault, entry) {
+    await ensureDir(EVAL_DIR(vault));
+    const current = await readHistory(vault);
+    const runs = current.ok ? [...current.value.runs, entry] : [entry];
+    const trimmed = runs.slice(-HISTORY_RETENTION);
+    const out = { version: 1, runs: trimmed };
+    await writeJson(HIST_FILE(vault), out);
+}
+export async function readHistory(vault) {
+    const path = HIST_FILE(vault);
+    if (!existsSync(path))
+        return ok({ version: 1, runs: [] });
+    const r = await readJson(path);
+    if (!r.ok)
+        return r;
+    if (typeof r.value.version === "number" && r.value.version > 1) {
+        process.stderr.write(`daftari eval: history.json version ${r.value.version} is newer than supported (1); leaving untouched\n`);
+        return ok({ version: 1, runs: [] });
+    }
+    return r;
+}
+//# sourceMappingURL=storage.js.map

package/dist/eval/storage.js.map

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

package/dist/eval/subgraph.d.ts

@@ -0,0 +1,17 @@
+import { type Result } from "../frontmatter/types.js";
+import type { CortexEvalError, SubgraphEdge } from "./types.js";
+export interface SubgraphOptions {
+    maxNodes?: number;
+}
+export interface SubgraphNode {
+    path: string;
+    body: string;
+    frontmatter: Record<string, unknown>;
+}
+export interface Subgraph {
+    seed_doc: string;
+    nodes: SubgraphNode[];
+    edges: SubgraphEdge[];
+}
+export declare function sampleSubgraph(vaultRoot: string, seed: string, opts?: SubgraphOptions): Promise<Result<Subgraph, CortexEvalError>>;
+//# sourceMappingURL=subgraph.d.ts.map

package/dist/eval/subgraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph.d.ts","sourceRoot":"","sources":["../../src/eval/subgraph.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CA6D5C"}

package/dist/eval/subgraph.js

@@ -0,0 +1,214 @@
+// Deterministic subgraph sampling for the cortex quality metric.
+//
+// Given a vault and a seed string, derive a small connected subgraph rooted at
+// one "seed doc". The seed→doc mapping is stratified by collection so a vault
+// with one dense collection cannot dominate every sample. From the seed we hop
+// along four edge kinds — frontmatter `sources`, in-body markdown links, logged
+// tensions, and `superseded_by` revision links — collecting neighbours until a
+// node cap is reached. In Daftari's data model `sources:` holds external
+// citation slugs (not in-vault paths), so the real in-vault doc→doc revision
+// edge lives in `superseded_by:`, walked bidirectionally below.
+//
+// Pure given (vault state + seed): the same inputs always yield the same
+// subgraph. All randomness is replaced by SHA-256 indexing over sorted inputs.
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { listTensions } from "../curation/tension.js";
+import { parseDocument } from "../frontmatter/parser.js";
+import { err, ok } from "../frontmatter/types.js";
+import { openIndexForActiveProvider } from "../tools/search.js";
+export async function sampleSubgraph(vaultRoot, seed, opts = {}) {
+    const maxNodes = opts.maxNodes ?? 5;
+    const indexRes = openIndexForActiveProvider(vaultRoot);
+    if (!indexRes.ok) {
+        return err({ kind: "runtime", message: `vault index unavailable: ${indexRes.error.message}` });
+    }
+    const db = indexRes.value;
+    let docs;
+    try {
+        docs = db.prepare("SELECT path, superseded_by FROM documents").all();
+    }
+    finally {
+        db.close();
+    }
+    if (docs.length === 0) {
+        return err({ kind: "runtime", message: "vault has no indexed documents" });
+    }
+    const strata = stratifyByCollection(docs.map((d) => d.path));
+    const stratumNames = [...strata.keys()].sort();
+    const stratumIdx = hashToIndex(`${seed}:stratum`, stratumNames.length);
+    const stratumName = stratumNames[stratumIdx];
+    const stratumDocs = [...(strata.get(stratumName) ?? [])].sort();
+    const seedIdx = hashToIndex(`${seed}:doc`, stratumDocs.length);
+    const seedDoc = stratumDocs[seedIdx];
+    const visited = new Map();
+    const edges = [];
+    const tensionsByDoc = await loadTensionEdges(vaultRoot);
+    // Bidirectional supersede map, built from the already-materialized SQL rows
+    // (no extra file reads). Bidirectional so a seed landing on EITHER the old or
+    // the new doc reaches its counterpart.
+    const supersededByDoc = new Map();
+    for (const d of docs) {
+        if (typeof d.superseded_by === "string" && d.superseded_by.length > 0) {
+            pushTo(supersededByDoc, d.path, { other: d.superseded_by });
+            pushTo(supersededByDoc, d.superseded_by, { other: d.path });
+        }
+    }
+    await loadNode(vaultRoot, seedDoc, visited);
+    await walkHop(vaultRoot, seedDoc, visited, edges, tensionsByDoc, supersededByDoc);
+    const firstHopNeighbors = [...visited.keys()].filter((p) => p !== seedDoc);
+    for (const n of firstHopNeighbors) {
+        if (visited.size >= maxNodes)
+            break;
+        await walkHop(vaultRoot, n, visited, edges, tensionsByDoc, supersededByDoc);
+    }
+    const nodes = trimToCap(seedDoc, visited, edges, maxNodes);
+    const nodePaths = new Set(nodes.map((n) => n.path));
+    return ok({
+        seed_doc: seedDoc,
+        nodes,
+        edges: edges.filter((e) => keepEdge(e, nodePaths)),
+    });
+}
+// An edge is kept when its `from` survived the node cap, and:
+//  - for `link`/`tension`/`superseded` edges, the `to` is also a retained
+//    in-vault node — these reference other vault documents, so a dangling
+//    target means the neighbour was trimmed or never existed and the edge is
+//    meaningless.
+//  - for `sources` edges, the `to` is a provenance citation that is, by the
+//    vault's frontmatter convention, an external source slug rather than an
+//    in-vault `.md` path. Such an edge records real provenance off the seed
+//    doc and is retained even though the cited source is not itself a node.
+function keepEdge(e, nodePaths) {
+    if (!nodePaths.has(e.from))
+        return false;
+    if (e.kind === "sources")
+        return true;
+    return nodePaths.has(e.to);
+}
+async function loadTensionEdges(vaultRoot) {
+    const tensionsByDoc = new Map();
+    const tensionsRes = await listTensions(vaultRoot);
+    if (!tensionsRes.ok)
+        return tensionsByDoc;
+    for (const t of tensionsRes.value) {
+        pushTo(tensionsByDoc, t.sourceA, { other: t.sourceB });
+        pushTo(tensionsByDoc, t.sourceB, { other: t.sourceA });
+    }
+    return tensionsByDoc;
+}
+function stratifyByCollection(paths) {
+    const m = new Map();
+    for (const p of paths) {
+        const collection = p.split("/")[0] || "_root";
+        pushTo(m, collection, p);
+    }
+    return m;
+}
+// Appends `value` to the array at `key`, creating the array on first use.
+// Replaces the `map.get(key)!.push(...)` non-null-assertion idiom that biome's
+// lint/style/noNonNullAssertion rule forbids.
+function pushTo(m, key, value) {
+    const arr = m.get(key);
+    if (arr)
+        arr.push(value);
+    else
+        m.set(key, [value]);
+}
+function hashToIndex(input, mod) {
+    if (mod <= 0)
+        throw new Error("mod must be positive");
+    const h = createHash("sha256").update(input).digest();
+    const n = h.readUInt32BE(0);
+    return n % mod;
+}
+// Loads a document's frontmatter + body into `visited`. Uses the project's
+// canonical parser; on malformed YAML it falls back to empty frontmatter so the
+// walk continues. A missing file is silently skipped.
+async function loadNode(vaultRoot, path, visited) {
+    if (visited.has(path))
+        return;
+    let raw;
+    try {
+        raw = await readFile(resolve(vaultRoot, path), "utf8");
+    }
+    catch {
+        return; // Missing doc — silently skip.
+    }
+    const parsed = parseDocument(raw);
+    if (parsed.ok) {
+        visited.set(path, { path, body: parsed.value.content, frontmatter: parsed.value.raw });
+    }
+    else {
+        visited.set(path, { path, body: raw, frontmatter: {} });
+    }
+}
+async function walkHop(vaultRoot, from, visited, edges, tensionsByDoc, supersededByDoc) {
+    const node = visited.get(from);
+    if (!node)
+        return;
+    const sources = Array.isArray(node.frontmatter.sources)
+        ? node.frontmatter.sources
+        : [];
+    for (const s of sources) {
+        if (typeof s !== "string")
+            continue;
+        edges.push({ from, to: s, kind: "sources" });
+        await loadNode(vaultRoot, s, visited);
+    }
+    const links = extractInVaultLinks(node.body);
+    for (const l of links) {
+        edges.push({ from, to: l, kind: "link" });
+        await loadNode(vaultRoot, l, visited);
+    }
+    const tensions = tensionsByDoc.get(from) ?? [];
+    for (const t of tensions) {
+        edges.push({ from, to: t.other, kind: "tension" });
+        await loadNode(vaultRoot, t.other, visited);
+    }
+    const superseded = supersededByDoc.get(from) ?? [];
+    for (const s of superseded) {
+        edges.push({ from, to: s.other, kind: "superseded" });
+        await loadNode(vaultRoot, s.other, visited);
+    }
+}
+function trimToCap(seed, visited, edges, cap) {
+    if (visited.size <= cap)
+        return [...visited.values()];
+    const degree = new Map();
+    for (const e of edges) {
+        degree.set(e.from, (degree.get(e.from) ?? 0) + 1);
+        degree.set(e.to, (degree.get(e.to) ?? 0) + 1);
+    }
+    const ranked = [...visited.entries()]
+        .map(([path, node]) => ({ path, node, degree: degree.get(path) ?? 0 }))
+        .sort((a, b) => {
+        if (a.path === seed)
+            return -1;
+        if (b.path === seed)
+            return 1;
+        // Higher degree wins; path tiebreak keeps the cut deterministic
+        // independent of engine sort stability.
+        return b.degree - a.degree || a.path.localeCompare(b.path);
+    });
+    return ranked.slice(0, cap).map((r) => r.node);
+}
+// Deliberately matches only standard markdown links to in-vault `.md` files —
+// `[text](path.md)` / `[text](path.md#anchor)`, skipping web/mailto and
+// absolute-rooted hrefs. Wiki-style `[[links]]` are not a Daftari vault
+// convention and are intentionally unsupported.
+function extractInVaultLinks(body) {
+    const out = [];
+    const re = /\[[^\]]*\]\(([^)]+\.md)(?:#[^)]*)?\)/g;
+    for (const m of body.matchAll(re)) {
+        const href = m[1];
+        if (/^https?:|^mailto:/i.test(href))
+            continue;
+        if (href.startsWith("/"))
+            continue;
+        out.push(href);
+    }
+    return out;
+}
+//# sourceMappingURL=subgraph.js.map

package/dist/eval/subgraph.js.map

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

package/dist/eval/tool-surface.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDef } from "./llm.js";
+export interface ToolSurface {
+    defs: ToolDef[];
+    handler: (name: string, input: unknown) => Promise<unknown>;
+}
+export declare function buildToolSurface(vaultRoot: string): ToolSurface;
+//# sourceMappingURL=tool-surface.d.ts.map

package/dist/eval/tool-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-surface.d.ts","sourceRoot":"","sources":["../../src/eval/tool-surface.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAiID,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAyB/D"}