@younndai/lyt 0.9.0

package/dist/bench/invariant-corpus.js

@@ -0,0 +1,181 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Every figment shares a fixed authored-time so indexing is reproducible.
+const TS = "created: 2026-01-01T00:00:00.000Z\nmodified: 2026-01-01T00:00:00.000Z";
+export const INVARIANT_CORPUS = [
+    {
+        vault: "core",
+        notes: [
+            // INV-1 (V-F5): two off-topic notes tagged `turso` form a lane (tier-1);
+            // a third has `turso` heavily in the BODY but is NOT tagged turso (tier-2).
+            // The strong body hit must outrank the tag-only lane hits.
+            {
+                rel: "notes/turso-tag-a.md",
+                frontmatter: `${TS}\ntags: [turso]`,
+                body: "Meeting schedule and logistics for the offsite.",
+            },
+            {
+                rel: "notes/turso-tag-b.md",
+                frontmatter: `${TS}\ntags: [turso]`,
+                body: "Quarterly planning notes and roadmap review.",
+            },
+            {
+                rel: "notes/turso-body.md",
+                frontmatter: `${TS}\ntags: [database]`,
+                body: "turso turso turso turso turso embedded replica libsql on turso.",
+            },
+            // INV-2 (V-F11): a UNIQUE tag (one note → no lane). The token "singleton"
+            // appears ONLY as a tag, never in the body, so tags→FTS is the only path.
+            {
+                rel: "notes/unique.md",
+                frontmatter: `${TS}\ntags: [singleton]`,
+                body: "A standalone one-off note about miscellaneous topics.",
+            },
+            // INV-3 (hygiene): "espresso" lives ONLY inside a fenced code block, which
+            // FTS hygiene strips. A query for it must return zero hits.
+            {
+                rel: "notes/coffee-fence.md",
+                frontmatter: `${TS}\ntags: [coffee]`,
+                body: "Notes on tea and other beverages.\n\n```js\nfunction espresso() { return true; }\n```\n",
+            },
+            // INV-6 (arc primacy): an arc "Build Pipeline" with two members (tier-0).
+            // A separate body-only note must NOT displace the arc members from the top.
+            {
+                rel: "notes/arc-decl.md",
+                frontmatter: "t: arc-decl",
+                body: '@ARC rid=arc:build-pipeline\n  | name="Build Pipeline"\n  | category="ops"\n  | last_touched:ts=2026-01-01T00:00:00.000Z\n',
+            },
+            {
+                rel: "notes/pipeline-m1.md",
+                frontmatter: `${TS}\narcs: [build-pipeline]`,
+                body: "Stage one of the rollout.",
+            },
+            {
+                rel: "notes/pipeline-m2.md",
+                frontmatter: `${TS}\narcs: [build-pipeline]`,
+                body: "Stage two of the rollout.",
+            },
+            {
+                rel: "notes/pipeline-body.md",
+                frontmatter: `${TS}\ntags: [misc]`,
+                body: "pipeline pipeline throughput and latency pipeline.",
+            },
+        ],
+    },
+    {
+        // INV-5 (vault-scope isolation): a second vault that ALSO matches "turso".
+        // A scope:vault search of `core` must never surface this note.
+        vault: "side",
+        notes: [
+            {
+                rel: "notes/turso-side.md",
+                frontmatter: `${TS}\ntags: [database]`,
+                body: "turso replication notes from the side vault.",
+            },
+        ],
+    },
+];
+export async function runInvariants(pod) {
+    const results = [];
+    // INV-1 — V-F5: strong body hit outranks tag-only lane hits.
+    {
+        const res = await pod.search({ query: "turso", scope: "federation", limit: 20 });
+        const rankOf = (suffix) => res.results.findIndex((r) => r.figment_path.endsWith(suffix));
+        const body = rankOf("turso-body.md");
+        const tagA = rankOf("turso-tag-a.md");
+        const tagB = rankOf("turso-tag-b.md");
+        const passed = body >= 0 && tagA >= 0 && tagB >= 0 && body < tagA && body < tagB;
+        results.push({
+            id: "INV-1",
+            name: "V-F5 — strong body hit outranks tag-only lane hits",
+            passed,
+            detail: `query "turso": body#${body} vs tag-a#${tagA}, tag-b#${tagB} (body must rank first)`,
+        });
+    }
+    // INV-2 — V-F11: a unique tag (no lane) is still findable via tags→FTS.
+    {
+        const res = await pod.search({ query: "singleton", scope: "federation", limit: 20 });
+        const found = res.results.some((r) => r.figment_path.endsWith("unique.md"));
+        results.push({
+            id: "INV-2",
+            name: "V-F11 — unique tag is findable",
+            passed: found,
+            detail: `query "singleton": ${res.results.length} hit(s); unique.md ${found ? "found" : "MISSING"}`,
+        });
+    }
+    // INV-3 — hygiene: a term that lives only in a code fence is not indexed.
+    {
+        const res = await pod.search({ query: "espresso", scope: "federation", limit: 20 });
+        const passed = res.results.length === 0;
+        results.push({
+            id: "INV-3",
+            name: "Hygiene — code-fence term is not FTS-indexed",
+            passed,
+            detail: `query "espresso": expected 0 hits, got ${res.results.length}`,
+        });
+    }
+    // INV-5 — vault-scope isolation: scope:vault must not leak other vaults.
+    {
+        const res = await pod.search({
+            query: "turso",
+            scope: "vault",
+            scopeTarget: "core",
+            limit: 20,
+        });
+        const leaked = res.results.filter((r) => r.vault_name !== "core");
+        const passed = res.results.length > 0 && leaked.length === 0;
+        results.push({
+            id: "INV-5",
+            name: "Scope — vault scope does not leak other vaults",
+            passed,
+            detail: `scope=vault core "turso": ${res.results.length} hit(s), ${leaked.length} from other vaults`,
+        });
+    }
+    // INV-6 — arc primacy: tier-0 arc members keep the top under the blend.
+    {
+        const res = await pod.search({
+            query: "pipeline",
+            scope: "vault",
+            scopeTarget: "core",
+            limit: 20,
+        });
+        const top = res.results[0];
+        const passed = top !== undefined && top.tier === 0;
+        results.push({
+            id: "INV-6",
+            name: "Arc primacy — tier-0 arc members stay on top under the soft-tier blend",
+            passed,
+            detail: top === undefined
+                ? `query "pipeline": no results`
+                : `query "pipeline": top result tier=${top.tier} (expected 0)`,
+        });
+    }
+    // INV-4 — determinism: identical query → identical ranked results.
+    {
+        const a = await pod.search({ query: "turso", scope: "federation", limit: 20 });
+        const b = await pod.search({ query: "turso", scope: "federation", limit: 20 });
+        const key = (r) => JSON.stringify(r.results.map((x) => [x.figment_path, x.tier, x.confidence, x.blendedScore ?? null]));
+        const passed = key(a) === key(b);
+        results.push({
+            id: "INV-4",
+            name: "Determinism — identical query yields identical ranked results",
+            passed,
+            detail: passed ? "two runs identical (mod durationMs)" : "two runs DIFFERED",
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=invariant-corpus.js.map

package/dist/bench/invariant-corpus.js.map

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

package/dist/bench/ir-metrics.d.ts

@@ -0,0 +1,33 @@
+import type { SearchResult } from "@younndai/lyt-vault";
+export declare const NDCG_K = 10;
+export declare function dcg(grades: readonly number[]): number;
+export declare function round3(x: number): number;
+export interface GradedQuery {
+    id: string;
+    query: string;
+    scope: "federation" | "vault" | "mesh";
+    scopeTarget?: string;
+    grades: Record<string, number>;
+    traps?: string[];
+}
+export interface GradedQueryScore {
+    id: string;
+    query: string;
+    nResults: number;
+    recall: number;
+    mrr: number;
+    ndcg: number;
+    pAt1: number;
+    trapHits: number;
+}
+export declare function scoreGradedQuery(q: GradedQuery, results: readonly SearchResult[]): GradedQueryScore;
+export interface GradedAggregate {
+    queries: number;
+    ndcg: number;
+    recall: number;
+    mrr: number;
+    pAt1: number;
+    cleanliness: number;
+}
+export declare function aggregateGraded(scores: readonly GradedQueryScore[]): GradedAggregate;
+//# sourceMappingURL=ir-metrics.d.ts.map

package/dist/bench/ir-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir-metrics.d.ts","sourceRoot":"","sources":["../../src/bench/ir-metrics.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,MAAM,KAAK,CAAC;AAGzB,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAErD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,WAAW,EACd,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,gBAAgB,CAiDlB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,eAAe,CAYpF"}

package/dist/bench/ir-metrics.js

@@ -0,0 +1,79 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export const NDCG_K = 10;
+// dcg = Σ (2^grade − 1) / log2(rank + 1) — matches ir-scorer.mjs:54.
+export function dcg(grades) {
+    return grades.reduce((acc, g, i) => acc + (Math.pow(2, g) - 1) / Math.log2(i + 2), 0);
+}
+export function round3(x) {
+    return Number.isFinite(x) ? Number(x.toFixed(3)) : 0;
+}
+export function scoreGradedQuery(q, results) {
+    const relevantSuffixes = Object.keys(q.grades);
+    const gradeOf = (path) => {
+        for (const suffix of relevantSuffixes) {
+            if (path.endsWith(suffix))
+                return q.grades[suffix] ?? 0;
+        }
+        return 0;
+    };
+    // Dedup by figment path (keep first occurrence), preserving rank order.
+    const seen = new Set();
+    const ranked = [];
+    for (const r of results) {
+        if (seen.has(r.figment_path))
+            continue;
+        seen.add(r.figment_path);
+        ranked.push({ path: r.figment_path, grade: gradeOf(r.figment_path) });
+    }
+    const grades = ranked.map((x) => x.grade);
+    const retrievedRel = new Set(ranked
+        .filter((x) => x.grade >= 1)
+        .map((x) => relevantSuffixes.find((s) => x.path.endsWith(s)) ?? x.path));
+    const recall = relevantSuffixes.length ? retrievedRel.size / relevantSuffixes.length : 0;
+    const firstRelIdx = grades.findIndex((g) => g >= 1);
+    const mrr = firstRelIdx >= 0 ? 1 / (firstRelIdx + 1) : 0;
+    const idealGrades = relevantSuffixes.map((s) => q.grades[s] ?? 0).sort((a, b) => b - a);
+    const idcg = dcg(idealGrades.slice(0, NDCG_K));
+    const ndcg = idcg > 0 ? dcg(grades.slice(0, NDCG_K)) / idcg : 0;
+    const firstGrade = grades[0] ?? 0;
+    const pAt1 = firstGrade >= 1 ? 1 : 0;
+    const traps = q.traps ?? [];
+    const trapHits = ranked.filter((x) => traps.some((t) => x.path.endsWith(t))).length;
+    return {
+        id: q.id,
+        query: q.query,
+        nResults: results.length,
+        recall: round3(recall),
+        mrr: round3(mrr),
+        ndcg: round3(ndcg),
+        pAt1,
+        trapHits,
+    };
+}
+export function aggregateGraded(scores) {
+    const n = scores.length;
+    const mean = (sel) => n ? round3(scores.reduce((a, s) => a + sel(s), 0) / n) : 0;
+    return {
+        queries: n,
+        ndcg: mean((s) => s.ndcg),
+        recall: mean((s) => s.recall),
+        mrr: mean((s) => s.mrr),
+        pAt1: mean((s) => s.pAt1),
+        cleanliness: scores.reduce((a, s) => a + s.trapHits, 0),
+    };
+}
+//# sourceMappingURL=ir-metrics.js.map

package/dist/bench/ir-metrics.js.map

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

package/dist/bench/latency-bench.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_LATENCY_COUNT = 1000;
+export interface LatencyReport {
+    corpusSize: number;
+    indexMs: number;
+    querySamples: number;
+    queryP50Ms: number;
+    queryP95Ms: number;
+    queryMeanMs: number;
+    durationMs: number;
+}
+export interface RunLatencyOptions {
+    count?: number;
+}
+export declare function runLatencyBench(opts?: RunLatencyOptions): Promise<LatencyReport>;
+//# sourceMappingURL=latency-bench.d.ts.map

package/dist/bench/latency-bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-bench.d.ts","sourceRoot":"","sources":["../../src/bench/latency-bench.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAG1C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmC1F"}

package/dist/bench/latency-bench.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Lane V Workstream 2 — `lyt bench --latency` probe.
+//
+// Stands up a temp pod, seeds a synthetic corpus of `count` figments into one
+// vault, times the all-tier reindex, then runs a fixed set of queries (repeated)
+// and reports query-time p50/p95. The latency axis the quality self-test can't
+// give (a review finding). On-demand — default count is modest; pass a larger --count for a
+// federation-scale reading before any scale claim.
+import { generateLatencyCorpus, LATENCY_PROBE_TERMS } from "./latency-corpus.js";
+import { setupBenchPod } from "./pod-harness.js";
+export const DEFAULT_LATENCY_COUNT = 1000;
+const REPEATS = 3;
+// Nearest-rank percentile over an ascending-sorted array.
+function percentile(sortedAsc, p) {
+    if (sortedAsc.length === 0)
+        return 0;
+    const idx = Math.ceil((p / 100) * sortedAsc.length) - 1;
+    return sortedAsc[Math.min(sortedAsc.length - 1, Math.max(0, idx))] ?? 0;
+}
+export async function runLatencyBench(opts = {}) {
+    const startedAt = Date.now();
+    const corpusSize = Math.max(1, Math.floor(opts.count ?? DEFAULT_LATENCY_COUNT));
+    const pod = setupBenchPod();
+    try {
+        const seed = generateLatencyCorpus(corpusSize);
+        await pod.seedVault(seed.vault, seed.notes);
+        const indexStart = Date.now();
+        await pod.reindex(seed.vault);
+        const indexMs = Date.now() - indexStart;
+        const samples = [];
+        for (let r = 0; r < REPEATS; r++) {
+            for (const term of LATENCY_PROBE_TERMS) {
+                const t = Date.now();
+                await pod.search({ query: term, scope: "federation", limit: 20 });
+                samples.push(Date.now() - t);
+            }
+        }
+        const sorted = [...samples].sort((a, b) => a - b);
+        const mean = samples.length ? samples.reduce((a, b) => a + b, 0) / samples.length : 0;
+        return {
+            corpusSize,
+            indexMs,
+            querySamples: samples.length,
+            queryP50Ms: percentile(sorted, 50),
+            queryP95Ms: percentile(sorted, 95),
+            queryMeanMs: Math.round(mean),
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    finally {
+        pod.teardown();
+    }
+}
+//# sourceMappingURL=latency-bench.js.map

package/dist/bench/latency-bench.js.map

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

package/dist/bench/latency-corpus.d.ts

@@ -0,0 +1,4 @@
+import type { VaultSeed } from "./invariant-corpus.js";
+export declare const LATENCY_PROBE_TERMS: readonly string[];
+export declare function generateLatencyCorpus(count: number): VaultSeed;
+//# sourceMappingURL=latency-corpus.d.ts.map

package/dist/bench/latency-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-corpus.d.ts","sourceRoot":"","sources":["../../src/bench/latency-corpus.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA8FvD,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAW,CAAC;AAE7D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAK9D"}

package/dist/bench/latency-corpus.js

@@ -0,0 +1,109 @@
+/*
+ * Copyright 2026 MARLINK TRADING SRL (YounndAI)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const TOPICS = [
+    "turso",
+    "libsql",
+    "replica",
+    "federation",
+    "yon",
+    "primer",
+    "lane",
+    "arc",
+    "rollup",
+    "vault",
+    "mesh",
+    "figment",
+    "index",
+    "decay",
+    "snapshot",
+    "edge",
+];
+const ADJ = [
+    "embedded",
+    "local",
+    "remote",
+    "transitive",
+    "derived",
+    "cached",
+    "frozen",
+    "stale",
+    "fresh",
+    "scoped",
+];
+const NOUN = [
+    "design",
+    "note",
+    "log",
+    "spec",
+    "probe",
+    "result",
+    "trace",
+    "plan",
+    "review",
+    "digest",
+];
+// Fixed base instant — authored-time spread is deterministic per index.
+const BASE_MS = Date.parse("2026-01-01T00:00:00.000Z");
+const DAY_MS = 86_400_000;
+function word(i, pool) {
+    return pool[i % pool.length] ?? pool[0];
+}
+// Small deterministic LCG so term frequency / body length vary without RNG.
+function lcg(seed) {
+    return (seed * 1103515245 + 12345) & 0x7fffffff;
+}
+function makeNote(i) {
+    const topic = word(i, TOPICS);
+    const topic2 = word(i * 7 + 3, TOPICS);
+    const tag = word(i * 3, TOPICS);
+    const created = new Date(BASE_MS + (i % 150) * DAY_MS).toISOString();
+    const r = lcg(i);
+    const reps = 1 + (r % 6); // term frequency 1..6
+    const fillerLines = 2 + (lcg(r) % 8); // body length 2..9 paragraphs
+    const frontmatter = [
+        `title: ${word(i, ADJ)} ${topic} ${word(i, NOUN)} ${String(i).padStart(5, "0")}`,
+        `created: ${created}`,
+        `modified: ${created}`,
+        `tags: [${tag}, synthetic]`,
+        "purpose: latency-corpus filler.",
+        "topic: bench",
+        "mesh-visibility: local",
+        "weight: 3",
+    ].join("\n");
+    const lines = [
+        `This ${word(i, NOUN)} is about ${topic}. ` +
+            `${topic} `.repeat(reps).trim() +
+            ` It also touches ${topic2}.`,
+    ];
+    for (let k = 0; k < fillerLines; k++) {
+        lines.push(`Filler ${k}: ${word(i + k, ADJ)} ${word(i + k, NOUN)} regarding ${word(i + k, TOPICS)} and ${word(i + 2 * k, TOPICS)}.`);
+    }
+    return {
+        rel: `notes/syn-${String(i).padStart(5, "0")}.md`,
+        frontmatter,
+        body: lines.join("\n\n"),
+    };
+}
+// Topic terms present in the corpus — used by the latency probe as queries.
+export const LATENCY_PROBE_TERMS = TOPICS;
+export function generateLatencyCorpus(count) {
+    const n = Math.max(1, Math.floor(count));
+    const notes = [];
+    for (let i = 1; i <= n; i++)
+        notes.push(makeNote(i));
+    return { vault: "latency", notes };
+}
+//# sourceMappingURL=latency-corpus.js.map

package/dist/bench/latency-corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-corpus.js","sourceRoot":"","sources":["../../src/bench/latency-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,MAAM,GAAG;IACb,OAAO;IACP,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,KAAK;IACL,QAAQ;IACR,MAAM;IACN,KAAK;IACL,QAAQ;IACR,OAAO;IACP,MAAM;IACN,SAAS;IACT,OAAO;IACP,OAAO;IACP,UAAU;IACV,MAAM;CACP,CAAC;AACF,MAAM,GAAG,GAAG;IACV,UAAU;IACV,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;CACT,CAAC;AACF,MAAM,IAAI,GAAG;IACX,QAAQ;IACR,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;CACT,CAAC;AAEF,wEAAwE;AACxE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AACvD,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,SAAS,IAAI,CAAC,CAAS,EAAE,IAAuB;IAC9C,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC;AAC3C,CAAC;AAED,4EAA4E;AAC5E,SAAS,GAAG,CAAC,IAAY;IACvB,OAAO,CAAC,IAAI,GAAG,UAAU,GAAG,KAAK,CAAC,GAAG,UAAU,CAAC;AAClD,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB;IAChD,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B;IACpE,MAAM,WAAW,GAAG;QAClB,UAAU,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;QAChF,YAAY,OAAO,EAAE;QACrB,aAAa,OAAO,EAAE;QACtB,UAAU,GAAG,cAAc;QAC3B,iCAAiC;QACjC,cAAc;QACd,wBAAwB;QACxB,WAAW;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,KAAK,GAAG;QACZ,QAAQ,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,KAAK,IAAI;YACzC,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;YAC/B,oBAAoB,MAAM,GAAG;KAChC,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CACzH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,EAAE,aAAa,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;QACjD,WAAW;QACX,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAsB,MAAM,CAAC;AAE7D,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,MAAM,KAAK,GAAyD,EAAE,CAAC;IACvE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/bench/pod-harness.d.ts

@@ -0,0 +1,16 @@
+import { type SearchCascadeArgs, type SearchCascadeResult } from "@younndai/lyt-vault";
+export interface BenchNote {
+    rel: string;
+    frontmatter: string;
+    body: string;
+}
+export declare const BENCH_NOW_ISO = "2026-06-01T00:00:00.000Z";
+export interface BenchPod {
+    readonly home: string;
+    seedVault(name: string, notes: readonly BenchNote[]): Promise<void>;
+    reindex(name: string): Promise<void>;
+    search(args: SearchCascadeArgs): Promise<SearchCascadeResult>;
+    teardown(): void;
+}
+export declare function setupBenchPod(): BenchPod;
+//# sourceMappingURL=pod-harness.d.ts.map

package/dist/bench/pod-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pod-harness.d.ts","sourceRoot":"","sources":["../../src/bench/pod-harness.ts"],"names":[],"mappings":"AAkCA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,SAAS;IAExB,GAAG,EAAE,MAAM,CAAC;IAEZ,WAAW,EAAE,MAAM,CAAC;IAEpB,IAAI,EAAE,MAAM,CAAC;CACd;AAKD,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD,MAAM,WAAW,QAAQ;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE9D,QAAQ,IAAI,IAAI,CAAC;CAClB;AA8BD,wBAAgB,aAAa,IAAI,QAAQ,CA6DxC"}