@younndai/lyt 0.9.0

package/dist/bench/pod-harness.js

@@ -0,0 +1,127 @@
+/*
+ * 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` temp-pod harness.
+//
+// Stands up a THROWAWAY pod under os.tmpdir (never the user's ~/lyt), seeds
+// vaults + figments offline (federation self-heal disabled AND a synthetic
+// identity pinned → no gh, no network, no interactive prompts), reindexes all
+// content tiers, and runs the cascade. Productized from
+// tools/lane-v/quality-probe.mjs (which only PROBED an already-built pod); this
+// also BUILDS the pod, so the bench ships self-contained.
+//
+// Pod safety: LYT_HOME is repointed to a fresh mkdtemp dir for the harness'
+// lifetime and restored on teardown. The dir is created by mkdtemp under
+// os.tmpdir — it can never be ~/lyt — but we assert it (and reject anything
+// under ~/lyt) anyway (defence-in-depth, mirroring quality-probe.mjs's guard).
+import { mkdirSync, mkdtempSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { dirname, join, resolve, sep } from "node:path";
+import { initVaultFlow, rebuildVaultFlow, searchCascadeFlow, } from "@younndai/lyt-vault";
+// Fixed clock threaded into reindex so temporal caches (keyword decay,
+// recent-activity) are deterministic — the bench's metrics must not drift with
+// wall-clock time.
+export const BENCH_NOW_ISO = "2026-06-01T00:00:00.000Z";
+const REAL_POD = resolve(homedir(), "lyt");
+const BENCH_PREFIX = "lyt-bench-";
+// Sweep leaked bench pods older than this (Windows libSQL handle lag can defeat
+// the teardown rmSync). Age-gated so a concurrent run's live pod is never hit.
+const STALE_POD_MS = 10 * 60_000;
+// Best-effort reaper for bench pods a prior run failed to delete. Everything it
+// touches is a mkdtemp dir named `lyt-bench-*` under os.tmpdir — junction-free,
+// L0-safe. Age-gated + fully swallowed; never fails the bench.
+function sweepStaleBenchPods(nowMs) {
+    let entries;
+    try {
+        entries = readdirSync(tmpdir());
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (!name.startsWith(BENCH_PREFIX))
+            continue;
+        const full = join(tmpdir(), name);
+        try {
+            if (nowMs - statSync(full).mtimeMs < STALE_POD_MS)
+                continue;
+            rmSync(full, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
+        }
+        catch {
+            // leave it; never fail on cleanup
+        }
+    }
+}
+export function setupBenchPod() {
+    sweepStaleBenchPods(Date.now());
+    const home = mkdtempSync(join(tmpdir(), BENCH_PREFIX));
+    const resolvedHome = resolve(home);
+    if (resolvedHome === REAL_POD || resolvedHome.startsWith(REAL_POD + sep)) {
+        throw new Error(`bench: refusing to run against the real pod (${REAL_POD}).`);
+    }
+    const prevLytHome = process.env["LYT_HOME"];
+    const prevIdentity = process.env["LYT_IDENTITY_OVERRIDE"];
+    process.env["LYT_HOME"] = home;
+    // Pin a synthetic identity so vault scaffolding (initVault -> getIdentity)
+    // never spawns `gh auth status` / `gh api /user`. WITHOUT this the bench
+    // throws on any machine where gh is missing/unauthed (release review C1) — this
+    // is what makes it truly offline + safe to run anywhere. Mirrors how every
+    // init-touching test pins LYT_IDENTITY_OVERRIDE.
+    process.env["LYT_IDENTITY_OVERRIDE"] = "github:lyt-bench";
+    return {
+        home,
+        async seedVault(name, notes) {
+            const init = await initVaultFlow({
+                name,
+                gitInit: false,
+                commitInitial: false,
+                selfHeal: { federation: { enabled: false } },
+            });
+            for (const note of notes) {
+                const full = join(init.vaultPath, note.rel);
+                mkdirSync(dirname(full), { recursive: true });
+                writeFileSync(full, `---\n${note.frontmatter}\n---\n${note.body}\n`, "utf8");
+            }
+        },
+        async reindex(name) {
+            await rebuildVaultFlow({ vault: name, nowIso: BENCH_NOW_ISO });
+        },
+        async search(args) {
+            return searchCascadeFlow(args);
+        },
+        teardown() {
+            // Restore env FIRST, unconditionally — a cleanup failure must never leave
+            // LYT_HOME / LYT_IDENTITY_OVERRIDE dangling.
+            if (prevLytHome === undefined)
+                delete process.env["LYT_HOME"];
+            else
+                process.env["LYT_HOME"] = prevLytHome;
+            if (prevIdentity === undefined)
+                delete process.env["LYT_IDENTITY_OVERRIDE"];
+            else
+                process.env["LYT_IDENTITY_OVERRIDE"] = prevIdentity;
+            // `home` is a fresh mkdtemp dir under os.tmpdir — no junctions, L0-safe.
+            // Best-effort: Windows libSQL handle lag can still defeat this; whatever is
+            // left is reaped by the next run's sweepStaleBenchPods.
+            try {
+                rmSync(home, { recursive: true, force: true, maxRetries: 5, retryDelay: 300 });
+            }
+            catch {
+                // leave for the next run's sweep
+            }
+        },
+    };
+}
+//# sourceMappingURL=pod-harness.js.map

package/dist/bench/pod-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pod-harness.js","sourceRoot":"","sources":["../../src/bench/pod-harness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,sDAAsD;AACtD,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,8EAA8E;AAC9E,wDAAwD;AACxD,gFAAgF;AAChF,0DAA0D;AAC1D,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,+EAA+E;AAE/E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAExD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAW7B,uEAAuE;AACvE,+EAA+E;AAC/E,mBAAmB;AACnB,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC;AAexD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;AAC3C,MAAM,YAAY,GAAG,YAAY,CAAC;AAClC,gFAAgF;AAChF,+EAA+E;AAC/E,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC;AAEjC,gFAAgF;AAChF,gFAAgF;AAChF,+DAA+D;AAC/D,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,SAAS;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,YAAY;gBAAE,SAAS;YAC5D,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAEhC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,gDAAgD,QAAQ,IAAI,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC/B,2EAA2E;IAC3E,yEAAyE;IACzE,gFAAgF;IAChF,2EAA2E;IAC3E,iDAAiD;IACjD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,kBAAkB,CAAC;IAE1D,OAAO;QACL,IAAI;QAEJ,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK;YACzB,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC;gBAC/B,IAAI;gBACJ,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,KAAK;gBACpB,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;aAC7C,CAAC,CAAC;YACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9C,aAAa,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,WAAW,UAAU,IAAI,CAAC,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,MAAM,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,QAAQ;YACN,0EAA0E;YAC1E,6CAA6C;YAC7C,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;;gBACzD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC;YAC3C,IAAI,YAAY,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;;gBACvE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,GAAG,YAAY,CAAC;YACzD,yEAAyE;YACzE,4EAA4E;YAC5E,wDAAwD;YACxD,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;YACjF,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,20 @@
+import { type InvariantResult } from "./invariant-corpus.js";
+import { type GradedAggregate, type GradedQueryScore } from "./ir-metrics.js";
+export interface GradedReport {
+    queries: GradedQueryScore[];
+    aggregate: GradedAggregate;
+}
+export interface BenchReport {
+    invariants: InvariantResult[];
+    graded: GradedReport;
+    invariantsPassed: number;
+    invariantsTotal: number;
+    quick: boolean;
+    ok: boolean;
+    durationMs: number;
+}
+export interface RunBenchOptions {
+    quick?: boolean;
+}
+export declare function runBench(opts?: RunBenchOptions): Promise<BenchReport>;
+//# sourceMappingURL=run-bench.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-bench.d.ts","sourceRoot":"","sources":["../../src/bench/run-bench.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IAExB,KAAK,EAAE,OAAO,CAAC;IASf,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAOD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAmCD,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAgB/E"}

package/dist/bench/run-bench.js

@@ -0,0 +1,86 @@
+/*
+ * 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` orchestrator.
+//
+// Runs two phases, each in its OWN isolated temp pod (so the invariant corpus
+// and the graded corpus never cross-contaminate each other's queries):
+// D-core — pass/fail retrieval invariants (the regression canary)
+// E-lite — a planted-relevance graded score (nDCG/recall/MRR/P@1 + cleanliness)
+// Metrics-only output — no user content, by construction (synthetic corpora).
+// `--quick` runs only the D-core invariants (the every-CI fast path).
+import { gradedCorpus, GRADED_QUERIES } from "./graded-corpus.js";
+import { INVARIANT_CORPUS, runInvariants } from "./invariant-corpus.js";
+import { aggregateGraded, scoreGradedQuery, } from "./ir-metrics.js";
+import { setupBenchPod } from "./pod-harness.js";
+const EMPTY_GRADED = {
+    queries: [],
+    aggregate: { queries: 0, ndcg: 0, recall: 0, mrr: 0, pAt1: 0, cleanliness: 0 },
+};
+async function runInvariantPhase() {
+    const pod = setupBenchPod();
+    try {
+        for (const seed of INVARIANT_CORPUS)
+            await pod.seedVault(seed.vault, seed.notes);
+        for (const seed of INVARIANT_CORPUS)
+            await pod.reindex(seed.vault);
+        return await runInvariants(pod);
+    }
+    finally {
+        pod.teardown();
+    }
+}
+async function runGradedPhase() {
+    const pod = setupBenchPod();
+    try {
+        const seeds = gradedCorpus();
+        for (const seed of seeds)
+            await pod.seedVault(seed.vault, seed.notes);
+        for (const seed of seeds)
+            await pod.reindex(seed.vault);
+        const queries = [];
+        for (const q of GRADED_QUERIES) {
+            const res = await pod.search({
+                query: q.query,
+                scope: q.scope,
+                ...(q.scopeTarget !== undefined ? { scopeTarget: q.scopeTarget } : {}),
+                limit: 20,
+            });
+            queries.push(scoreGradedQuery(q, res.results));
+        }
+        return { queries, aggregate: aggregateGraded(queries) };
+    }
+    finally {
+        pod.teardown();
+    }
+}
+export async function runBench(opts = {}) {
+    const startedAt = Date.now();
+    const quick = opts.quick === true;
+    const invariants = await runInvariantPhase();
+    const graded = quick ? EMPTY_GRADED : await runGradedPhase();
+    const invariantsPassed = invariants.filter((i) => i.passed).length;
+    const ok = invariantsPassed === invariants.length && graded.aggregate.cleanliness === 0;
+    return {
+        invariants,
+        graded,
+        invariantsPassed,
+        invariantsTotal: invariants.length,
+        quick,
+        ok,
+        durationMs: Date.now() - startedAt,
+    };
+}
+//# sourceMappingURL=run-bench.js.map

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

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

package/dist/cli-automator-run.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+export declare function resolveNoPushOpt(opts: {
+    push?: boolean;
+    noPush?: boolean;
+}): boolean;
+export declare function buildAutomatorRunSubcommand(): Command;
+//# sourceMappingURL=cli-automator-run.d.ts.map

package/dist/cli-automator-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-automator-run.d.ts","sourceRoot":"","sources":["../src/cli-automator-run.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEpF;AAED,wBAAgB,2BAA2B,IAAI,OAAO,CAyDrD"}

package/dist/cli-automator-run.js

@@ -0,0 +1,80 @@
+/*
+ * 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.
+ */
+// `lyt automator run <rid|name>` subcommand (block-B Commit 7).
+//
+// Lives in the meta @younndai/lyt CLI because runFiveStep pulls in lyt-runner
+// and lyt-runner depends on lyt-vault — registering `run` inside lyt-vault
+// would create a circular dep. Mirrors the lyt-mesh subcommand-attach pattern
+// at packages/lyt/src/cli.ts.
+//
+// Per Lock 0.3 (SAI-compatible — brief §Conventions L191), --json emits a
+// deterministic JSON envelope so SAIs / Claude Code / Codex can consume the
+// invocation result without screen-scraping.
+import { Command } from "commander";
+import { uuid7BytesToDashedString } from "@younndai/lyt-vault";
+import { runAutomator } from "./automator-run.js";
+// commander stores `--no-push` as push:false (negated-flag convention); the
+// noPush key is only set by test harnesses invoking the action directly.
+// Track C Wave 3 F9: reading only opts.noPush dropped the CLI flag entirely
+// and the run pushed. Exported so the regression test locks the mapping.
+export function resolveNoPushOpt(opts) {
+    return opts.push === false || opts.noPush === true;
+}
+export function buildAutomatorRunSubcommand() {
+    return new Command("run")
+        .description("Run a declared automator end-to-end (5-step protocol: lease → sync → body → commit → release).")
+        .argument("<automator>", "Automator name or rid (e.g. 'metadata-filler' or 'automator:metadata-filler')")
+        .option("--vault <name>", "Vault name to run against; required when more than one vault is registered")
+        .option("--dry-run", "Skip lease acquisition + git pull/push (still invokes the body for inspection)")
+        .option("--no-push", "Run the commit step but skip `git push` (still commits locally)")
+        .option("--json", "Emit JSON instead of human-readable output")
+        .action(async (automator, opts) => {
+        const noPush = resolveNoPushOpt(opts);
+        const result = await runAutomator({
+            automator,
+            ...(opts.vault !== undefined ? { vault: opts.vault } : {}),
+            ...(opts.dryRun === true ? { dryRun: true } : {}),
+            ...(noPush ? { noPush: true } : {}),
+        });
+        const payload = {
+            ok: result.ok,
+            automator: result.plan.automatorName,
+            automator_version: result.automatorVersion,
+            run_id_hex: uuid7BytesToDashedString(result.runId).replace(/-/g, ""),
+            vault: {
+                name: result.plan.vaultName,
+                path: result.plan.vaultPath,
+            },
+            status: result.status,
+            error_summary: result.errorSummary,
+            dry_run: opts.dryRun === true,
+            no_push: noPush,
+            body: result.body ?? null,
+        };
+        if (opts.json === true) {
+            // eslint-disable-next-line no-console
+            console.log(JSON.stringify(payload, null, 2));
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.log(`${result.ok ? "✓" : "✗"} automator:${payload.automator} ` +
+                `→ status=${payload.status}${payload.error_summary !== null ? ` (${payload.error_summary})` : ""}`);
+        }
+        if (!result.ok)
+            process.exit(1);
+    });
+}
+//# sourceMappingURL=cli-automator-run.js.map

package/dist/cli-automator-run.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/*
+ * 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.
+ */
+import { createRequire } from "node:module";
+import { Command } from "commander";
+import { buildMcpSubcommand } from "@younndai/lyt-mcp";
+import { buildCloneAllCommand, buildPodStatusCommand, buildSourceCommand, buildStatusCommand, buildSyncCommand, } from "@younndai/lyt-mesh";
+import { buildSkillsCommand } from "@younndai/lyt-skills";
+import { registerVaultVerbs } from "@younndai/lyt-vault";
+import { buildAgentManualCommand, buildDiscoverCommand, buildRepairCommand, } from "@younndai/lyt-vault";
+import { buildAutomatorRunSubcommand } from "./cli-automator-run.js";
+import { buildBenchCommand } from "./commands/bench.js";
+import { buildCaptureCommand } from "./commands/capture.js";
+import { buildLytInitCommand } from "./commands/init.js";
+import { buildPrimerCommand } from "./commands/primer.js";
+import { buildReindexCommand } from "./commands/reindex.js";
+import { buildSearchCommand } from "./commands/search.js";
+const program = new Command();
+program
+    .name("lyt")
+    .description("Lyt — federated markdown-vault mesh CLI (vault + mesh + sync + mcp + help + doctor + pattern + machine + identity + audit + friction + provenance + capture-metric + automator)")
+    .version(createRequire(import.meta.url)("../package.json").version);
+// release review + block-A.3 Commit 11 — single source of truth for
+// the @younndai/lyt-vault verb surface; sync / mcp are kept here because
+// they live in separate workspaces.
+//
+// v1.B.1 delta: the meta CLI used to compose @younndai/lyt-mesh's
+// `buildMeshSubcommand()` directly, but that registers a `mesh` parent
+// that now collides with @younndai/lyt-vault's new v1.B.1 mesh command
+// (init/join/list). Resolution: registerVaultVerbs registers the v1.B.1
+// mesh parent (the canonical surface per master plan §5 v1.B.1); the
+// surviving lyt-mesh subcommands (clone-all, source, status) are
+// attached AFTER. The legacy lyt-mesh `init` subcommand (manifest-
+// driven Phase 7D) is intentionally NOT re-attached — the v1.B.1 multi-
+// mesh `mesh init <name>` supersedes it per master plan §5 (manifest-
+// driven bulk init moves to v1.B.3).
+//
+// v1.C.1 delta: the legacy lyt-mesh `validate` subcommand (parent_vault
+// FK dangling-check) is ALSO intentionally NOT re-attached — the v1.C.1
+// `lyt mesh validate` (cross-mesh @MESH_EDGE walker, registered by
+// registerVaultVerbs via commands/mesh.ts) supersedes it per master plan
+// §v1.C.1:609 acceptance "lyt mesh validate warns on broken edges". The
+// legacy parent_vault FK check is now repaired by v1.C.4 `lyt repair`
+// per master plan §G-5:277 (validate = read-only / repair = write
+// boundary). Same pattern as the v1.B.1 mesh-init supersession above.
+// v1.C.4 ships `lyt repair` at the meta-CLI top level (federation-design
+// §6:250 lists it next to `lyt init` + `lyt discover`).
+//
+// block-B Commit 7 delta: same composition shape applies to `automator`.
+// registerVaultVerbs registers the v1 automator parent with list/log/status
+// subcommands (lyt-vault has no lyt-runner dep). The meta CLI attaches `run`
+// here, because runFiveStep + the metadata-filler body live in packages that
+// depend on lyt-vault — registering them inside lyt-vault would create a
+// cycle. Mirror of the lyt-mesh subcommand attach pattern above.
+registerVaultVerbs(program);
+const meshCmd = program.commands.find((c) => c.name() === "mesh");
+if (meshCmd === undefined) {
+    throw new Error("@younndai/lyt meta CLI: expected registerVaultVerbs to register a 'mesh' command but none was found.");
+}
+meshCmd.addCommand(buildCloneAllCommand());
+meshCmd.addCommand(buildSourceCommand());
+meshCmd.addCommand(buildStatusCommand());
+const automatorCmd = program.commands.find((c) => c.name() === "automator");
+if (automatorCmd === undefined) {
+    throw new Error("@younndai/lyt meta CLI: expected registerVaultVerbs to register an 'automator' command but none was found.");
+}
+automatorCmd.addCommand(buildAutomatorRunSubcommand());
+program.addCommand(buildSyncCommand());
+// Brief B (B.4) — `lyt status`: top-level publish-drift trust surface (per-vault
+// + pod unpushed/no-remote/clean). Distinct from `lyt mesh status` (the
+// mesh-graph renderer attached under `mesh` above): different scope, different
+// answer ("is my stuff published?" vs "what's the federation topology?").
+program.addCommand(buildPodStatusCommand());
+program.addCommand(buildMcpSubcommand());
+// v1.D.3b — `lyt search` lives at the meta-CLI level per master-plan
+// §v1.D.3:785 wording "lyt search" (no `vault` subcommand). The
+// default scope is federation; placing it under `vault` would tilt
+// user mental model toward single-vault use. The cascade engine
+// itself lives in @younndai/lyt-vault (data-layer ownership); the
+// command builder here is the CLI-surface adapter.
+program.addCommand(buildSearchCommand());
+// V-C-1 Phase E / V-C-2 — `lyt capture "<text>"`: the frictionless top-level
+// alias for `pattern run knowledge-capture capture` the wizard advertises.
+// True alias (same ceremony: mandatory purpose+topic, 8-field contract) +
+// index-on-write so a capture is searchable immediately. Top-level like
+// search/primer/reindex; the flow lives in @younndai/lyt-vault.
+program.addCommand(buildCaptureCommand());
+// v1.D.4 — `lyt primer` mirrors the meta-CLI posture of `lyt search`.
+// Same rationale: the verb operates at vault | mesh | federation scope
+// per master-plan §v1.D.4:832; placing it under `vault` would tilt
+// mental model. The generator flow lives in @younndai/lyt-vault; the
+// command builder here is the CLI-surface adapter.
+program.addCommand(buildPrimerCommand());
+// Lane V Phase 0 (0.5 / CLI gaps C1+C2) — `lyt reindex [--all|--mesh|--vault]`
+// rebuilds all content-tier caches (lanes+arcs+fts+rollup) across the pod, a
+// mesh, or one vault. Top-level (like search/primer) because its mental model
+// is pod-wide. The reindexFlow lives in @younndai/lyt-vault (data-layer
+// ownership); this is the CLI-surface adapter.
+program.addCommand(buildReindexCommand());
+// Lane V Workstream 2 — `lyt bench`: privacy-trivial retrieval self-test over a
+// synthetic temp pod (never the user's ~/lyt). Top-level like search/primer/
+// reindex. The harness lives in ./bench (productized from tools/lane-v, which is
+// dev-only and not shipped); this is the CLI-surface adapter.
+program.addCommand(buildBenchCommand());
+// v1.B.4 — `lyt init` lives at the meta-CLI top level per OD-1 default +
+// master-plan §v1.B.4:543 + federation-design §5:248. Composes
+// meshInitFlow + federationInitFlow into idempotent bootstrap with
+// three branches (fresh / re-init / discovery) + `--auto` default.
+program.addCommand(buildLytInitCommand());
+// v1.C.3 — `lyt discover` lives at the meta-CLI top level per OD-1 default +
+// federation-design §6:249 (lists `lyt discover` next to `lyt init`).
+// Read-only walk of GH-accessible repos; clusters discovered Lyt vaults
+// by @VAULT_HOME_MESH.mesh_name; per-cluster orphan-recovery prompt
+// (adopt / external / skip) ships in Commit 3. Mirror lyt search / lyt
+// primer / lyt init top-level attach pattern.
+program.addCommand(buildDiscoverCommand());
+// v1.C.4 — `lyt repair` lives at the meta-CLI top level per OD-1 default +
+// federation-design §6:250 (lists `lyt repair` next to `lyt init` +
+// `lyt discover`). Default mode is --dry-run; --apply performs writes
+// across the 4 federation-design §11:515-521 failure classes (broken
+// @MESH_EDGE, broken @MESH_SUBSCRIPTION, mesh.yon parse error → restore
+// from Git, orphan vault re-attach). G-5 contract LOCK: this is the
+// write side of validate = read-only / repair = write per master-plan
+// §G-5:277.
+program.addCommand(buildRepairCommand());
+// v1.F.3 — `lyt skills` lives at the meta-CLI top level per OD-2 default +
+// master-plan §v1.F.3:1033 verb wording ("lyt skills install"). Composes
+// symlinkSkillsTriRuntime + listSkillsTriRuntime into the symlink + runtime-
+// state-reporting surface for the 10 bundled skills across ~/.claude/skills,
+// ~/.codex/skills, ~/.agents/skills. Per OD-5 + OD-16 ratified 2026-06-01,
+// the legacy standalone `lyt-skills` bin + copy-based `installSkills` flow
+// were removed in the same phase (pre-release clean slate).
+program.addCommand(buildSkillsCommand());
+// v1.G.5 — `lyt agent-manual --runtime {claude|codex|agents|generic}
+// [--install] [--dry-run]` at the meta-CLI top level. Mirrors the
+// discover / repair / skills attach pattern above. Generates the Lyt
+// agent manual (~150 lines / ~1.5K tokens) and writes it (or previews
+// it) into agent-runtime global instructions files via the
+// `<!-- lyt-manual v<lyt-version> BEGIN -->...END -->` marker pattern
+// (D9 update-path primitive per the ratified default ratified 2026-06-01).
+program.addCommand(buildAgentManualCommand());
+program.parseAsync(process.argv).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    // eslint-disable-next-line no-console
+    console.error(`lyt: ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CACV,iLAAiL,CAClL;KACA,OAAO,CAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC,CAAC;AAE/F,oEAAoE;AACpE,yEAAyE;AACzE,oCAAoC;AACpC,EAAE;AACF,kEAAkE;AAClE,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,qEAAqE;AACrE,iEAAiE;AACjE,mEAAmE;AACnE,wEAAwE;AACxE,sEAAsE;AACtE,qCAAqC;AACrC,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,mEAAmE;AACnE,yEAAyE;AACzE,wEAAwE;AACxE,sEAAsE;AACtE,kEAAkE;AAClE,sEAAsE;AACtE,yEAAyE;AACzE,wDAAwD;AACxD,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,iEAAiE;AACjE,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC;AAClE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IAC1B,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;AACJ,CAAC;AACD,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAC3C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,WAAW,CAAC,CAAC;AAC5E,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;IAC/B,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAC;AACJ,CAAC;AACD,YAAY,CAAC,UAAU,CAAC,2BAA2B,EAAE,CAAC,CAAC;AAEvD,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACvC,iFAAiF;AACjF,wEAAwE;AACxE,+EAA+E;AAC/E,0EAA0E;AAC1E,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAC5C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,qEAAqE;AACrE,gEAAgE;AAChE,mEAAmE;AACnE,gEAAgE;AAChE,kEAAkE;AAClE,mDAAmD;AACnD,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,6EAA6E;AAC7E,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,gEAAgE;AAChE,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,sEAAsE;AACtE,uEAAuE;AACvE,mEAAmE;AACnE,qEAAqE;AACrE,mDAAmD;AACnD,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,wEAAwE;AACxE,+CAA+C;AAC/C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,gFAAgF;AAChF,6EAA6E;AAC7E,iFAAiF;AACjF,8DAA8D;AAC9D,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAExC,yEAAyE;AACzE,+DAA+D;AAC/D,mEAAmE;AACnE,mEAAmE;AACnE,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;AAE1C,6EAA6E;AAC7E,sEAAsE;AACtE,wEAAwE;AACxE,oEAAoE;AACpE,uEAAuE;AACvE,8CAA8C;AAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;AAE3C,2EAA2E;AAC3E,oEAAoE;AACpE,sEAAsE;AACtE,qEAAqE;AACrE,wEAAwE;AACxE,oEAAoE;AACpE,sEAAsE;AACtE,YAAY;AACZ,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,4DAA4D;AAC5D,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEzC,qEAAqE;AACrE,kEAAkE;AAClE,qEAAqE;AACrE,sEAAsE;AACtE,2DAA2D;AAC3D,sEAAsE;AACtE,2EAA2E;AAC3E,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;AAE9C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/bench.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function buildBenchCommand(): Command;
+//# sourceMappingURL=bench.d.ts.map

package/dist/commands/bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.d.ts","sourceRoot":"","sources":["../../src/commands/bench.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,iBAAiB,IAAI,OAAO,CAsF3C"}

package/dist/commands/bench.js

@@ -0,0 +1,92 @@
+/*
+ * 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.
+ */
+import { Command } from "commander";
+import { DEFAULT_LATENCY_COUNT, runLatencyBench } from "../bench/latency-bench.js";
+import { runBench } from "../bench/run-bench.js";
+// Lane V Workstream 2 — `lyt bench`: a privacy-trivial retrieval self-test.
+// Stands up TEMP throwaway pods under os.tmpdir (never the user's ~/lyt), seeds
+// tiny deterministic synthetic corpora, indexes them, and reports:
+// • (default) D-core invariants + E-lite graded quality
+// • --quick invariants only (the fast every-CI path)
+// • --latency index + query p50/p95 on a synthetic corpus (--count to scale)
+// No user content is read, by construction — safe to run anywhere.
+export function buildBenchCommand() {
+    return new Command("bench")
+        .description("Self-test Lyt's retrieval engine against synthetic corpora (privacy-trivial — reads no user content). Asserts the retrieval invariants and reports a graded quality score; exits non-zero if an invariant or hygiene trap regressed.")
+        .option("--json", "Emit a JSON report instead of the human-readable summary")
+        .option("--quick", "Run only the pass/fail invariants (skip the graded-quality phase — faster)")
+        .option("--latency", "Run the latency benchmark (index + query p50/p95) instead of the quality self-test")
+        .option("--count <n>", `Latency corpus size (default ${DEFAULT_LATENCY_COUNT}; use 5000+ for a federation-scale reading)`)
+        .action(async (opts) => {
+        try {
+            if (opts.latency === true) {
+                const parsed = opts.count !== undefined ? Number.parseInt(opts.count, 10) : undefined;
+                const report = await runLatencyBench(parsed !== undefined && Number.isFinite(parsed) ? { count: parsed } : {});
+                if (opts.json === true) {
+                    // eslint-disable-next-line no-console
+                    console.log(JSON.stringify(report, null, 2));
+                    return;
+                }
+                // eslint-disable-next-line no-console
+                console.log([
+                    `lyt bench --latency — synthetic corpus (${report.durationMs}ms)`,
+                    `  index:  ${report.indexMs}ms  (${report.corpusSize} figments, all tiers)`,
+                    `  query:  p50 ${report.queryP50Ms}ms   p95 ${report.queryP95Ms}ms   mean ${report.queryMeanMs}ms   (${report.querySamples} samples)`,
+                ].join("\n"));
+                return;
+            }
+            const report = await runBench({ quick: opts.quick === true });
+            if (opts.json === true) {
+                // eslint-disable-next-line no-console
+                console.log(JSON.stringify(report, null, 2));
+                if (!report.ok)
+                    process.exitCode = 1;
+                return;
+            }
+            const lines = [
+                `lyt bench — retrieval self-test${report.quick ? " (quick)" : ""} (${report.durationMs}ms)`,
+                "",
+                `Invariants (${report.invariantsPassed}/${report.invariantsTotal} passed):`,
+            ];
+            for (const inv of report.invariants) {
+                lines.push(`  ${inv.passed ? "✓" : "✗"} ${inv.id}  ${inv.name}`);
+                if (!inv.passed)
+                    lines.push(`        ${inv.detail}`);
+            }
+            if (!report.quick) {
+                const g = report.graded.aggregate;
+                lines.push("", `Quality (synthetic graded oracle, ${g.queries} queries):`, `  nDCG@10 ${g.ndcg}   recall ${g.recall}   MRR ${g.mrr}   P@1 ${g.pAt1}   cleanliness ${g.cleanliness}`);
+                for (const q of report.graded.queries) {
+                    lines.push(`    ${q.id.padEnd(14)} nDCG ${q.ndcg}  recall ${q.recall}  MRR ${q.mrr}`);
+                }
+                lines.push("  (nDCG < 1.0 is expected — Q-replica is a deliberate non-aced case: raw BM25 ≠ graded relevance, the known v2 rank-fusion residual.)");
+            }
+            lines.push("", report.ok
+                ? "PASS — invariants hold and no hygiene trap leaked."
+                : "FAIL — an invariant or hygiene trap regressed.");
+            // eslint-disable-next-line no-console
+            console.log(lines.join("\n"));
+            if (!report.ok)
+                process.exitCode = 1;
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.error(`lyt bench: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 2;
+        }
+    });
+}
+//# sourceMappingURL=bench.js.map