@mmnto/cli 1.105.0 → 1.107.0

package/dist/commands/qbd-seam.js

@@ -0,0 +1,150 @@
+/**
+ * The single place the query-before-derive seams resolve their ledger directory
+ * (mmnto-ai/totem#2510).
+ *
+ * ## Why this exists
+ *
+ * The seams originally each did `path.join(cwd, config.totemDir)`. That is
+ * wrong, and silently so. `resolveConfigPath` does NOT walk up the tree — it
+ * checks the cwd and then falls back to the global `~/.totem/` profile — so
+ * running a derive-class command from a subdirectory of a project resolves a
+ * config successfully (the command works) while the seam targets
+ * `<subdir>/.totem`, which does not exist. The core writer then skips, and the
+ * derive vanishes from the denominator: exactly the #2510 falsifier-1 failure,
+ * arrived at by accident instead of by gaming.
+ *
+ * The fix is to resolve the ledger directory the way this command family's
+ * EXISTING ledger writes already do — from the config root, e.g. `shield.ts`'s
+ * `path.join(configRoot, config.totemDir)` for `override` events — so QBD rows
+ * land in the same ledger as every other event the same command emits.
+ *
+ * Every seam and the doctor reader route through here, so the resolution can
+ * only be wrong in one place, and a fix lands everywhere at once. That
+ * writer/reader agreement is the load-bearing property: rows went missing
+ * precisely because the two resolved differently.
+ *
+ * ## Known residual, stated rather than hidden
+ *
+ * `resolveConfigPath` still does not walk up. Run from a subdirectory of a
+ * project that has no config of its own, it resolves the global `~/.totem/`
+ * profile, so the row lands in the global profile's ledger rather than the
+ * enclosing project's. That is consistent — telemetry follows the same config
+ * the command itself ran under, and the reader follows it too — but it is not
+ * the same as project-root discovery. Fixing it properly means changing
+ * `resolveConfigPath` semantics for EVERY command, which is a repo-wide change
+ * well outside this slice. Scoped out deliberately, not overlooked.
+ */
+/**
+ * Resolve the ledger directory QBD rows belong in, for a given cwd.
+ *
+ * Returns `undefined` when no Totem config can be resolved at all — there is no
+ * project to instrument, which is a normal state for a general-purpose command
+ * like `orient` run outside a repo.
+ */
+export async function resolveQbdLedgerDir(cwd, homeDir) {
+    return (await resolveQbdLedgerDirDetailed(cwd, homeDir)).dir;
+}
+/**
+ * As `resolveQbdLedgerDir`, but distinguishes the two reasons resolution can
+ * fail so the caller can say which happened.
+ *
+ * `CONFIG_MISSING` is the honest-absent case — no project here, nothing to
+ * instrument, an entirely normal state for a command like `orient`. Any other
+ * failure means a config exists but could not be read, which is a degradation
+ * worth naming rather than folding into "absent".
+ */
+export async function resolveQbdLedgerDirDetailed(cwd, homeDir) {
+    try {
+        // Lazy, like every sibling command module: a top-level import here is on the
+        // CLI's cold-start path for every invocation, including ones that never
+        // touch this seam.
+        const path = await import('node:path');
+        const { isGlobalConfigPath, loadConfig, resolveConfigPath } = await import('../utils.js');
+        // `homeDir` is threaded through so tests can point the global-profile lookup
+        // at a temp home. Without it, a test running in a directory with no config
+        // resolves the DEVELOPER'S REAL `~/.totem/` profile and writes telemetry
+        // into their live ledger — which is exactly what happened: this suite wrote
+        // real derive rows into the maintainer's global ledger on every run.
+        const configPath = resolveConfigPath(cwd, homeDir);
+        const config = await loadConfig(configPath);
+        const global = isGlobalConfigPath(configPath, homeDir);
+        // configRoot, NOT cwd — see the header. Mirrors the sibling ledger writes.
+        return { dir: path.join(path.dirname(configPath), config.totemDir), global };
+        // totem-context: intentional cleanup — a sensor must not fail the command it instruments (Tenet 13); the reason is returned to the caller and surfaced, never discarded.
+    }
+    catch (err) {
+        // totem-context: intentional cleanup — a sensor must not fail the command it instruments (Tenet 13); the reason is returned to the caller and surfaced, never discarded.
+        const code = typeof err === 'object' && err !== null && 'code' in err
+            ? err.code
+            : undefined;
+        if (code === 'CONFIG_MISSING') {
+            return { reason: 'no Totem config found — not a project, nothing to instrument' };
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        return { reason: `Totem config could not be loaded (${msg})` };
+    }
+}
+/**
+ * Record a derive-class action from a CLI command.
+ *
+ * Never throws, never fails the instrumented command. Returns a note whenever
+ * nothing was recorded, so the caller can surface it — a sensor that quietly
+ * declines to measure is indistinguishable from one measuring zero, which is
+ * the ADR-115 § 2 defect class.
+ */
+/**
+ * Landing in the global profile is legitimate but must never be silent: the
+ * row goes somewhere other than the project the user is looking at, and a
+ * reader comparing `doctor --compliance` in the project against these rows
+ * would otherwise see an unexplained gap.
+ */
+function globalNote(totemDir) {
+    return `query-before-derive: recorded to the global profile ledger at ${totemDir} — no project config found from this cwd`;
+}
+/**
+ * The one resolve-then-record body both public seams share.
+ *
+ * The two used to carry six duplicated statements and three byte-identical note
+ * strings. Those strings are load-bearing — the doctor render and the tests
+ * match on them — so a reworded note had to be changed in two places or the
+ * surfaces silently drifted apart. Single-sourced here.
+ *
+ * `sense` is the only real difference: which core writer runs.
+ */
+async function recordThrough(cwd, homeDir, sense) {
+    const { dir: totemDir, reason, global } = await resolveQbdLedgerDirDetailed(cwd, homeDir);
+    if (totemDir === undefined) {
+        return {
+            recorded: false,
+            note: `query-before-derive: ${reason ?? 'unresolved'} — not recording`,
+        };
+    }
+    const result = sense(totemDir);
+    if (result.skipped === true) {
+        return {
+            recorded: false,
+            note: `query-before-derive: no ledger at ${totemDir} — not recording`,
+        };
+    }
+    return { recorded: result.written, ...(global === true && { note: globalNote(totemDir) }) };
+}
+/**
+ * Record a derive-class action from a CLI command.
+ *
+ * Never throws, never fails the instrumented command. Returns a note whenever
+ * nothing was recorded, so the caller can surface it — a sensor that quietly
+ * declines to measure is indistinguishable from one measuring zero, which is
+ * the ADR-115 § 2 defect class.
+ */
+export async function recordQbdDerive(cwd, surface, onWarn, homeDir) {
+    const { senseDeriveAction } = await import('@mmnto/totem');
+    return recordThrough(cwd, homeDir, (totemDir) => senseDeriveAction({ totemDir, source: 'lint', surface }, onWarn));
+}
+/**
+ * Record a corpus query from a CLI command. Same contract as `recordQbdDerive`.
+ */
+export async function recordQbdQuery(cwd, onWarn, homeDir) {
+    const { senseCorpusQuery } = await import('@mmnto/totem');
+    return recordThrough(cwd, homeDir, (totemDir) => senseCorpusQuery({ totemDir, source: 'lint', surface: 'totem_search' }, onWarn));
+}
+//# sourceMappingURL=qbd-seam.js.map

package/dist/commands/qbd-seam.js.map

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

package/dist/commands/qbd-seam.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Seam-resolution tests for the query-before-derive instrumentation
+ * (mmnto-ai/totem#2510).
+ *
+ * ## Test isolation is load-bearing here, not hygiene
+ *
+ * Every test passes an explicit temp `homeDir`. `resolveConfigPath` falls back
+ * to the global `~/.totem/` profile when the cwd has no config, so a test that
+ * omits it resolves the DEVELOPER'S REAL profile — and on a machine whose
+ * global config sets `totemDir: '.'`, the writer then appends real derive rows
+ * to their live `~/.totem/ledger/events.ndjson`. An earlier version of this
+ * file did exactly that on every suite run. No test here may be *able* to reach
+ * the real profile.
+ */
+export {};
+//# sourceMappingURL=qbd-seam.test.d.ts.map

package/dist/commands/qbd-seam.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qbd-seam.test.d.ts","sourceRoot":"","sources":["../../src/commands/qbd-seam.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/commands/qbd-seam.test.js

@@ -0,0 +1,339 @@
+/**
+ * Seam-resolution tests for the query-before-derive instrumentation
+ * (mmnto-ai/totem#2510).
+ *
+ * ## Test isolation is load-bearing here, not hygiene
+ *
+ * Every test passes an explicit temp `homeDir`. `resolveConfigPath` falls back
+ * to the global `~/.totem/` profile when the cwd has no config, so a test that
+ * omits it resolves the DEVELOPER'S REAL profile — and on a machine whose
+ * global config sets `totemDir: '.'`, the writer then appends real derive rows
+ * to their live `~/.totem/ledger/events.ndjson`. An earlier version of this
+ * file did exactly that on every suite run. No test here may be *able* to reach
+ * the real profile.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { cleanTmpDir } from '../test-utils.js';
+import { recordQbdDerive, recordQbdQuery, resolveQbdLedgerDirDetailed } from './qbd-seam.js';
+/** A minimal VALID config — `targets` requires at least one entry. */
+const TOTEM_YAML = [
+    'targets:',
+    '  - glob: "src/**/*.ts"',
+    '    type: code',
+    '    strategy: file',
+    '',
+].join('\n');
+let projectRoot;
+/** A temp home with NO global profile — the "no config anywhere" case. */
+let emptyHome;
+beforeEach(() => {
+    projectRoot = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-seam-')));
+    fs.writeFileSync(path.join(projectRoot, 'totem.yaml'), TOTEM_YAML, 'utf-8');
+    fs.mkdirSync(path.join(projectRoot, '.totem'), { recursive: true });
+    emptyHome = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-home-')));
+});
+afterEach(() => {
+    cleanTmpDir(projectRoot);
+    cleanTmpDir(emptyHome);
+});
+/**
+ * Build a temp home that DOES carry a global profile.
+ *
+ * `totemDir: '.'` mirrors the real-world shape (it is what this machine's
+ * `~/.totem/totem.config.ts` sets), so the profile's ledger lives at
+ * `<home>/.totem/ledger/` — the layout the silent-landing finding was about.
+ */
+function homeWithGlobalProfile() {
+    const home = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-ghome-')));
+    const globalDir = path.join(home, '.totem');
+    fs.mkdirSync(globalDir, { recursive: true });
+    fs.writeFileSync(path.join(globalDir, 'totem.yaml'), `totemDir: "."\n${TOTEM_YAML}`, 'utf-8');
+    return home;
+}
+/** Where a `homeWithGlobalProfile` home keeps its ledger. */
+function globalTotemDir(home) {
+    return path.join(home, '.totem');
+}
+function ledgerRows(totemDir) {
+    const file = path.join(totemDir, 'ledger', 'events.ndjson');
+    if (!fs.existsSync(file))
+        return [];
+    return fs
+        .readFileSync(file, 'utf-8')
+        .split('\n')
+        .filter((l) => l.trim().length > 0)
+        .map((l) => JSON.parse(l));
+}
+describe('resolveQbdLedgerDirDetailed', () => {
+    it('resolves from the config root', async () => {
+        const detailed = await resolveQbdLedgerDirDetailed(projectRoot, emptyHome);
+        expect(detailed.reason ?? 'resolved').toBe('resolved');
+        expect(detailed.dir).toBe(path.join(projectRoot, '.totem'));
+        expect(detailed.global).toBe(false);
+    });
+    it('resolves a cwd that is NOT the config root to the CONFIG ROOT ledger', async () => {
+        // The discriminating case. From a subdirectory with a global profile in
+        // play, the old `path.join(cwd, config.totemDir)` would answer
+        // `<subdir>/.totem`; the correct answer is the resolved config's own root.
+        // At the project root the two agree, which is why a root-only assertion
+        // proves nothing about the bug it is supposed to pin.
+        const home = homeWithGlobalProfile();
+        try {
+            const subdir = path.join(projectRoot, 'packages', 'thing');
+            fs.mkdirSync(subdir, { recursive: true });
+            const detailed = await resolveQbdLedgerDirDetailed(subdir, home);
+            // What the old cwd-joined logic would have answered, computed from the
+            // SAME `totemDir` this fixture's profile sets (`.`) — so it is `subdir`
+            // itself, not `subdir/.totem`. Hard-coding `.totem` here made the
+            // assertion pass under both implementations, i.e. pinned nothing.
+            const oldBuggyAnswer = path.join(subdir, '.');
+            expect(detailed.dir).toBeDefined();
+            expect(detailed.dir).not.toBe(oldBuggyAnswer);
+            expect(detailed.dir).toBe(globalTotemDir(home));
+            expect(detailed.global).toBe(true);
+        }
+        finally {
+            cleanTmpDir(home);
+        }
+    });
+    it('gives two different cwds under one config root the SAME ledger dir', async () => {
+        const home = homeWithGlobalProfile();
+        try {
+            const a = path.join(projectRoot, 'packages', 'alpha');
+            const b = path.join(projectRoot, 'docs', 'deep', 'nested');
+            fs.mkdirSync(a, { recursive: true });
+            fs.mkdirSync(b, { recursive: true });
+            const fromA = await resolveQbdLedgerDirDetailed(a, home);
+            const fromB = await resolveQbdLedgerDirDetailed(b, home);
+            // Resolution is a function of the resolved config root, so two cwds that
+            // resolve the same config cannot disagree about where rows land. Under
+            // the old cwd-joined logic these two answers differed.
+            expect(fromA.dir).toBe(fromB.dir);
+            expect(fromA.dir).not.toBe(path.join(a, '.totem'));
+            expect(fromB.dir).not.toBe(path.join(b, '.totem'));
+        }
+        finally {
+            cleanTmpDir(home);
+        }
+    });
+    it('reports CONFIG_MISSING when neither cwd nor home carries a config', async () => {
+        const orphan = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-orphan-')));
+        try {
+            const detailed = await resolveQbdLedgerDirDetailed(orphan, emptyHome);
+            expect(detailed.dir).toBeUndefined();
+            expect(detailed.reason).toContain('no Totem config found');
+        }
+        finally {
+            cleanTmpDir(orphan);
+        }
+    });
+});
+describe('recordQbdDerive', () => {
+    it('records into the project ledger when run from the project root', async () => {
+        const report = await recordQbdDerive(projectRoot, 'review', () => { }, emptyHome);
+        expect(report.recorded).toBe(true);
+        expect(report.note).toBeUndefined();
+        const rows = ledgerRows(path.join(projectRoot, '.totem'));
+        expect(rows).toHaveLength(1);
+        expect(rows[0].type).toBe('derive_action');
+        expect(rows[0].activity_name).toBe('review');
+    });
+    it('never creates a stray ledger under a subdirectory', async () => {
+        const subdir = path.join(projectRoot, 'packages', 'thing');
+        fs.mkdirSync(subdir, { recursive: true });
+        const report = await recordQbdDerive(subdir, 'spec', () => { }, emptyHome);
+        expect(fs.existsSync(path.join(subdir, '.totem'))).toBe(false);
+        if (!report.recorded)
+            expect(report.note).toBeDefined();
+    });
+    it('ANNOUNCES a landing in the global profile instead of doing it silently', async () => {
+        // Legitimate, but the row goes somewhere other than the project the user is
+        // looking at — so it must say so. This was the silent half of the finding.
+        const home = homeWithGlobalProfile();
+        const orphan = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-orphan-')));
+        try {
+            const report = await recordQbdDerive(orphan, 'orient', () => { }, home);
+            expect(report.recorded).toBe(true);
+            expect(report.note).toBeDefined();
+            expect(report.note).toContain('global profile ledger');
+            // And it landed in the global profile's ledger, not the orphan cwd.
+            expect(ledgerRows(globalTotemDir(home))).toHaveLength(1);
+            expect(fs.existsSync(path.join(orphan, '.totem'))).toBe(false);
+        }
+        finally {
+            cleanTmpDir(orphan);
+            cleanTmpDir(home);
+        }
+    });
+    it('never no-ops silently when there is no project at all', async () => {
+        const orphan = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-orphan-')));
+        try {
+            const report = await recordQbdDerive(orphan, 'orient', () => { }, emptyHome);
+            expect(report.recorded).toBe(false);
+            expect(report.note).toContain('query-before-derive');
+        }
+        finally {
+            cleanTmpDir(orphan);
+        }
+    });
+});
+describe('recordQbdQuery', () => {
+    it('writes a corpus_query row carrying a correlation ID into the project ledger', async () => {
+        const report = await recordQbdQuery(projectRoot, () => { }, emptyHome);
+        expect(report.recorded).toBe(true);
+        const rows = ledgerRows(path.join(projectRoot, '.totem'));
+        expect(rows).toHaveLength(1);
+        expect(rows[0].type).toBe('corpus_query');
+        expect(rows[0].activity_name).toBe('totem_search');
+        expect(typeof rows[0].qbd_correlation_id).toBe('string');
+    });
+    it('shares the derive seam’s not-recording contract', async () => {
+        // Both seams route through one internal body, so the note strings cannot
+        // drift apart — this pins that they really are the same contract.
+        const orphan = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'totem-qbd-orphan-')));
+        try {
+            const queryReport = await recordQbdQuery(orphan, () => { }, emptyHome);
+            const deriveReport = await recordQbdDerive(orphan, 'orient', () => { }, emptyHome);
+            expect(queryReport.recorded).toBe(false);
+            expect(queryReport.note).toBe(deriveReport.note);
+        }
+        finally {
+            cleanTmpDir(orphan);
+        }
+    });
+});
+describe('review seam placement', () => {
+    /**
+     * Source pin, and an honest account of why it is one.
+     *
+     * `handleVerdictResult` is module-private and `shieldCommand` needs the
+     * orchestrator, the Lance index, git, and the exemption store before it
+     * reaches a verdict, so driving the structural branch executably is not
+     * feasible at unit scope. The previous version of this test was worse than
+     * useless: it indexed the IMPORT of `recordQbdDerive` rather than the call,
+     * never read the enclosing control flow, and would have passed after a
+     * comment edit.
+     *
+     * This one anchors to the CALL EXPRESSION inside the enclosing function body.
+     * Mutations it catches: moving the record call out of `handleVerdictResult`
+     * (structural and standard would both stop recording); deleting the fan's own
+     * call (the fan path would stop recording); the structural branch no longer
+     * routing through the shared handler before it returns.
+     *
+     * Mutations it does NOT catch, stated so the pin is not read as stronger than
+     * it is: reordering within the handler; a call that is present but
+     * unreachable; and — because these are substring matches, not parsed
+     * statements — a *comment* mentioning `recordQbdDerive(` would satisfy them
+     * just as well as the real call. Accepted, because the alternative at unit
+     * scope is no coverage at all, and building an AST harness for one call site
+     * is machinery this slice does not need.
+     */
+    const source = fs.readFileSync(path.join(__dirname, 'shield.ts'), 'utf-8');
+    /** Slice out one top-level function body by declaration name. */
+    function functionBody(name) {
+        const start = source.indexOf(`async function ${name}(`);
+        expect(start, `${name} should exist`).toBeGreaterThan(-1);
+        const rest = source.slice(start + 1);
+        const end = rest.search(/\n(?:export )?(?:async )?function /);
+        return end === -1 ? rest : rest.slice(0, end);
+    }
+    it('records the derive INSIDE the shared verdict handler', () => {
+        // Structural and standard both route through this function, so a call here
+        // fires exactly once per review and only after a verdict exists.
+        const body = functionBody('handleVerdictResult');
+        expect(body).toContain('recordQbdDerive(');
+    });
+    it('records only AFTER a verdict has parsed — never for --raw or unparsable', () => {
+        // The recording used to be the handler's first statement, which put it
+        // ahead of BOTH `if (options.raw) return` and the unparsable-verdict throw:
+        // a raw context dump recorded a derive (and could consume a query's
+        // grounding), and so did a run whose verdict never parsed.
+        //
+        // The invariant is positional, so pin it positionally: the record call must
+        // sit after the raw exit AND after the point where a verdict is parsed.
+        const body = functionBody('handleVerdictResult');
+        const rawExitIdx = body.indexOf('if (options.raw) return;');
+        const laneDeriveIdx = body.indexOf('deriveLaneOutcome(');
+        const structuralBranchIdx = body.indexOf('if (outcome.structuredVerdict)');
+        const v1BranchIdx = body.indexOf('const verdict = parseVerdict(content);');
+        const firstRecordIdx = body.indexOf('await recordReviewDerive()');
+        expect(rawExitIdx).toBeGreaterThan(-1);
+        expect(laneDeriveIdx).toBeGreaterThan(-1);
+        expect(firstRecordIdx).toBeGreaterThan(-1);
+        // After the raw exit: `--raw` returns before any record can fire.
+        expect(firstRecordIdx).toBeGreaterThan(rawExitIdx);
+        // After the verdict is derived: nothing records before parsing is attempted.
+        expect(firstRecordIdx).toBeGreaterThan(laneDeriveIdx);
+        // And the call sites are the two PARSED-verdict branches, not the body.
+        expect(firstRecordIdx).toBeGreaterThan(structuralBranchIdx);
+        expect(body.indexOf('await recordReviewDerive()', v1BranchIdx)).toBeGreaterThan(v1BranchIdx);
+    });
+    it('records on a FAIL verdict too — a failing review is a completed derive', () => {
+        // Excluding FAIL would shrink the denominator, which is the falsifier-1
+        // failure mode. The record sits at the TOP of the structured branch, ahead
+        // of the pass/fail split and ahead of the SHIELD_FAILED throw.
+        const body = functionBody('handleVerdictResult');
+        const recordIdx = body.indexOf('await recordReviewDerive()');
+        const failThrowIdx = body.indexOf("'SHIELD_FAILED'");
+        expect(failThrowIdx).toBeGreaterThan(-1);
+        expect(recordIdx).toBeLessThan(failThrowIdx);
+    });
+    it('routes the structural branch through that shared handler before returning', () => {
+        const body = functionBody('shieldCommand');
+        const structuralIdx = body.indexOf("options.mode === 'structural'");
+        expect(structuralIdx).toBeGreaterThan(-1);
+        const afterStructural = body.slice(structuralIdx);
+        const handlerIdx = afterStructural.indexOf('handleVerdictResult(');
+        const returnIdx = afterStructural.indexOf('\n    return;');
+        expect(handlerIdx).toBeGreaterThan(-1);
+        expect(returnIdx).toBeGreaterThan(-1);
+        expect(handlerIdx).toBeLessThan(returnIdx);
+    });
+    it('does NOT record the fan derive at the runReviewFan call site', () => {
+        // The call site is unreachable for the two exit-policy paths: a
+        // zero-completed-lane round and a `--fail-on` failure both PERSIST an honest
+        // verdict and only then throw, so a record placed after the call skipped
+        // exactly those reviews — completed derives escaping the denominator, with
+        // the query correlation left consumable by a later derive.
+        const body = functionBody('shieldCommand');
+        const fanIdx = body.indexOf('runReviewFan(');
+        expect(fanIdx).toBeGreaterThan(-1);
+        // Between the fan call and the branch's `return`, nothing records.
+        const afterFan = body.slice(fanIdx);
+        const returnIdx = afterFan.indexOf('\n    return;');
+        expect(returnIdx).toBeGreaterThan(-1);
+        expect(afterFan.slice(0, returnIdx)).not.toContain('await recordQbdDerive(');
+    });
+    it('writes the fan derive to the SAME totemDir the artifact was saved into', () => {
+        // Not re-resolved from cwd: a cwd with no local config falls back to the
+        // user's global `~/.totem/` profile, which appended real rows to the
+        // maintainer's live ledger during this package's tests. The artifact's own
+        // directory is both authoritative and incapable of wandering.
+        expect(fanSource).toContain('senseDeriveAction({ totemDir: ctx.totemDirAbs');
+    });
+    const fanSource = fs.readFileSync(path.join(__dirname, 'review-fan.ts'), 'utf-8');
+    it('records the fan derive the instant the verdict artifact is PERSISTED', () => {
+        // Persisted verdict ⇔ recorded derive. Ordering is the invariant, so it is
+        // pinned by ordering: the record must sit after the save and before both
+        // exit-policy throws.
+        const saveIdx = fanSource.indexOf('saveVerdictArtifact(ctx.totemDirAbs, verdict)');
+        const recordIdx = fanSource.indexOf('senseDeriveAction({ totemDir: ctx.totemDirAbs');
+        const zeroLaneThrowIdx = fanSource.indexOf('hasNoCompletedLane(verdict.lanes)');
+        const failOnIdx = fanSource.indexOf('const failOn = ctx.options.failOn;');
+        expect(saveIdx).toBeGreaterThan(-1);
+        expect(recordIdx).toBeGreaterThan(-1);
+        expect(zeroLaneThrowIdx).toBeGreaterThan(-1);
+        expect(failOnIdx).toBeGreaterThan(-1);
+        // After persistence: a fan that throws BEFORE writing an artifact records
+        // nothing, which keeps the other half of the invariant true.
+        expect(recordIdx).toBeGreaterThan(saveIdx);
+        // Before both exit-policy throws: a persisted-then-policy-throw round is a
+        // completed derive and still records.
+        expect(recordIdx).toBeLessThan(zeroLaneThrowIdx);
+        expect(recordIdx).toBeLessThan(failOnIdx);
+    });
+});
+//# sourceMappingURL=qbd-seam.test.js.map

package/dist/commands/qbd-seam.test.js.map

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

package/dist/commands/review-fan.d.ts.map

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

package/dist/commands/review-fan.js

@@ -984,6 +984,32 @@ export async function runReviewFan(ctx) {
     // The saved hash IS the content address (dedup-safe: an identical round returns
     // the existing address).
     const verdictHash = saveVerdictArtifact(ctx.totemDirAbs, verdict).hash;
+    // Query-before-derive instrumentation (mmnto-ai/totem#2510): the fan's derive
+    // is recorded HERE — the instant the verdict artifact is on disk — and not at
+    // the `runReviewFan` call site in `shield.ts`.
+    //
+    // The call site is unreachable for the two exit-policy paths below: a
+    // zero-completed-lane round and a `--fail-on` failure both PERSIST an honest
+    // verdict (including `settled=false` states, which `totem review --covariate`
+    // reads back) and only then throw. Recording after the call therefore skipped
+    // exactly those reviews — a completed derive escaping the denominator, and
+    // worse, leaving the query's correlation still consumable by a later derive.
+    //
+    // Placement keeps the other half true by construction: a fan that throws
+    // BEFORE reaching this line — a lane-assembly or invocation failure, with no
+    // artifact written — records nothing. Persisted verdict ⇔ recorded derive.
+    //
+    // Writes to `ctx.totemDirAbs` — the very directory the artifact above was
+    // saved into — rather than re-resolving from `ctx.cwd` through the seam
+    // helper. Two reasons, one correctness and one safety: the derive row belongs
+    // in the same ledger as the verdict it accompanies, and re-resolving from a
+    // cwd with no local config would fall back to the user's global `~/.totem/`
+    // profile. Routing through the helper here did exactly that, appending real
+    // rows to the maintainer's live ledger during this package's tests.
+    {
+        const { senseDeriveAction } = await import('@mmnto/totem');
+        senseDeriveAction({ totemDir: ctx.totemDirAbs, source: 'lint', surface: 'review' }, (msg) => log.warn(DISPLAY_TAG, msg));
+    }
     // ── ZERO completed verdict lanes (Gate G3, mmnto-ai/totem#2452): the honest verdict
     // is now WRITTEN — hard-error ──
     // Keyed on `hasNoCompletedLane` (⇔ `verdict.completedLaneCount === 0`, superRefine-bound):