@mmnto/mcp 1.97.0 → 1.98.1

package/README.md

@@ -1,6 +1,6 @@
 # @mmnto/mcp
 
-MCP (Model Context Protocol) server for [Totem](https://github.com/mmnto-ai/totem) — a local-first, file-anchored substrate that makes AI-agent work queryable, enforceable, and derivable in your codebase. A stdio-based server that exposes a Totem project's knowledge index to MCP-compatible agents. Installs the `totem-mcp` binary.
+MCP (Model Context Protocol) server for [Totem](https://github.com/mmnto-ai/totem), the local-first toolkit that keeps AI-agent work queryable, enforceable, and derivable as plain files in your codebase. A stdio-based server that exposes a Totem project's knowledge index to MCP-compatible agents. Installs the `totem-mcp` binary.
 
 ## Setup
 

package/dist/description.test.js

@@ -8,9 +8,11 @@ describe('package self-description parity (mmnto-ai/totem#2336 D1 family alignme
         const pkgUrl = new URL('../package.json', import.meta.url);
         const pkg = JSON.parse(readFileSync(pkgUrl, 'utf-8'));
         expect(pkg.name).toBe('@mmnto/mcp');
-        expect(pkg.description).toContain('a local-first, file-anchored substrate that makes AI-agent work queryable, enforceable, and derivable in your codebase');
-        // Guards against a regression to the retired category.
+        expect(pkg.description).toContain('local-first toolkit that keeps AI-agent work queryable, enforceable, and derivable as plain files in your codebase');
+        // Guards against regressions to retired vocabulary.
         expect(pkg.description).not.toContain('persistent memory and context layer');
+        expect(pkg.description).not.toContain('substrate');
+        expect(pkg.description).not.toContain('—');
     });
 });
 //# sourceMappingURL=description.test.js.map

package/dist/description.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"description.test.js","sourceRoot":"","sources":["../src/description.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,wFAAwF;AACxF,sFAAsF;AACtF,sEAAsE;AACtE,QAAQ,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACzF,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnD,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,SAAS,CAC/B,wHAAwH,CACzH,CAAC;QACF,uDAAuD;QACvD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"description.test.js","sourceRoot":"","sources":["../src/description.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,wFAAwF;AACxF,sFAAsF;AACtF,sEAAsE;AACtE,QAAQ,CAAC,2EAA2E,EAAE,GAAG,EAAE;IACzF,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnD,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,SAAS,CAC/B,oHAAoH,CACrH,CAAC;QACF,oDAAoD;QACpD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC7E,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/search-log.d.ts

@@ -7,7 +7,54 @@ export interface SearchLogEntry {
     durationMs: number;
     topScore: number | null;
     error?: string;
+    /**
+     * A.3.a schema extension (ADR-029 flight-readiness note; ruled in on
+     * mmnto-ai/totem#2362). Env-derived at log time; the ~420 pre-extension
+     * entries stay permanently unattributed (no retro-inference — Tenet 20).
+     *
+     * Agent runtime attribution per ADR-078 § Decision item 2, STRICTLY
+     * orthogonal to any emitter/subsystem identifier. Derived from
+     * `TOTEM_SELF_AGENT` — the one env-carried agent identity in this cohort
+     * (packages/core/src/orchestration-resolver.ts § resolveSelfAgents,
+     * highest-precedence layer). `null` (stamped explicitly, never guessed —
+     * Tenet 4) when the env var is absent, so the reader can partition legacy +
+     * hookless events into an explicit "unattributed" bucket rather than a
+     * fabricated seat. The ADR-029 compliance reader renders this field as
+     * attribution COVERAGE (per-seat entry counts); per-seat compliance rates
+     * wait on a commit-side identity primitive, because commits carry no seat
+     * identity to join against (ruled on mmnto-ai/totem#2362).
+     */
+    agent_source?: string | null;
+    /** A.3.a: explicit session id passed through from `TOTEM_SESSION_ID` if present, else null (never guessed). Reserved forward primitive for the ADR-078 commit-side session join; deliberately inert in the current repo-wide windowing. */
+    session_id?: string | null;
+    /** A.3.a: trace-correlation id passed through from `TOTEM_CORRELATION_ID` if present, else null (never guessed). Reserved for the A.3.c end-to-end correlation pass; carried now so the trio lands in one producer touch. */
+    correlation_id?: string | null;
 }
+/**
+ * The A.3.a attribution trio stamped onto every `SearchLogEntry` at log time.
+ * Every field is `string | null` — a present value or an explicit `null`
+ * (Tenet 4: absence is stamped, never guessed).
+ */
+export interface SearchLogAttribution {
+    agent_source: string | null;
+    session_id: string | null;
+    correlation_id: string | null;
+}
+/**
+ * Derive the A.3.a attribution trio from the environment (default
+ * `process.env`). Pure — no I/O, no side effects — so the producer stamp is
+ * testable without touching the filesystem.
+ *
+ * - `agent_source`: from `TOTEM_SELF_AGENT`, reusing the same read + comma
+ *   parsing precedent as `resolveSelfAgents` (orchestration-resolver.ts). The
+ *   MCP server is spawned under a single seat, so the first non-empty
+ *   comma-separated entry is that seat; a bare value passes through unchanged.
+ * - `session_id` / `correlation_id`: straight pass-through from
+ *   `TOTEM_SESSION_ID` / `TOTEM_CORRELATION_ID`.
+ *
+ * Any field whose env var is absent or blank is stamped `null`.
+ */
+export declare function deriveSearchLogAttribution(env?: NodeJS.ProcessEnv): SearchLogAttribution;
 export interface SearchStats {
     totalCalls: number;
     avgDuration: number;
@@ -21,12 +68,19 @@ export declare function setLogDir(totemDir: string): void;
 /**
  * Record a search call.
  *
+ * - Stamps the A.3.a attribution trio (`agent_source` / `session_id` /
+ *   `correlation_id`) from the environment at log time — one producer touch
+ *   shared by every call site. A caller-supplied value (none today) wins over
+ *   the env derivation.
  * - Always appends to the in-memory array.
  * - Best-effort appends a single JSON line to `{totemDir}/.search-log.jsonl`.
  *   File writes are fire-and-forget — failures are silently swallowed because
  *   writing to stdout/stderr would corrupt the MCP stdio transport.
+ *
+ * Returns the stamped entry so the attribution stamp is observable in tests
+ * without touching the filesystem.
  */
-export declare function logSearch(entry: SearchLogEntry): void;
+export declare function logSearch(entry: SearchLogEntry): SearchLogEntry;
 /**
  * Compute aggregate stats from the in-memory search log.
  */

package/dist/search-log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-log.d.ts","sourceRoot":"","sources":["../src/search-log.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAgBrD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAc5C"}
+{"version":3,"file":"search-log.d.ts","sourceRoot":"","sources":["../src/search-log.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,2OAA2O;IAC3O,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,6NAA6N;IAC7N,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,oBAAoB,CAgBtB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAsB/D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAc5C"}

package/dist/search-log.js

@@ -1,5 +1,45 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+/**
+ * Read one env var, trim it, and normalize empty/whitespace-only to `null`.
+ * `null` is the explicit "not present" stamp (Tenet 4) — never a guessed value.
+ */
+function envOrNull(env, key) {
+    const raw = env[key];
+    if (typeof raw !== 'string')
+        return null;
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/**
+ * Derive the A.3.a attribution trio from the environment (default
+ * `process.env`). Pure — no I/O, no side effects — so the producer stamp is
+ * testable without touching the filesystem.
+ *
+ * - `agent_source`: from `TOTEM_SELF_AGENT`, reusing the same read + comma
+ *   parsing precedent as `resolveSelfAgents` (orchestration-resolver.ts). The
+ *   MCP server is spawned under a single seat, so the first non-empty
+ *   comma-separated entry is that seat; a bare value passes through unchanged.
+ * - `session_id` / `correlation_id`: straight pass-through from
+ *   `TOTEM_SESSION_ID` / `TOTEM_CORRELATION_ID`.
+ *
+ * Any field whose env var is absent or blank is stamped `null`.
+ */
+export function deriveSearchLogAttribution(env = process.env) {
+    const selfAgentRaw = envOrNull(env, 'TOTEM_SELF_AGENT');
+    const agent_source = selfAgentRaw !== null
+        ? // Same comma-split as resolveSelfAgents; take the first non-empty seat.
+            (selfAgentRaw
+                .split(',')
+                .map((s) => s.trim())
+                .find((s) => s.length > 0) ?? null)
+        : null;
+    return {
+        agent_source,
+        session_id: envOrNull(env, 'TOTEM_SESSION_ID'),
+        correlation_id: envOrNull(env, 'TOTEM_CORRELATION_ID'),
+    };
+}
 /** In-memory log of search calls for the current server session. */
 const entries = [];
 /** Resolved path to the JSONL log file, set on first logSearch call. */
@@ -14,17 +54,28 @@ export function setLogDir(totemDir) {
 /**
  * Record a search call.
  *
+ * - Stamps the A.3.a attribution trio (`agent_source` / `session_id` /
+ *   `correlation_id`) from the environment at log time — one producer touch
+ *   shared by every call site. A caller-supplied value (none today) wins over
+ *   the env derivation.
  * - Always appends to the in-memory array.
  * - Best-effort appends a single JSON line to `{totemDir}/.search-log.jsonl`.
  *   File writes are fire-and-forget — failures are silently swallowed because
  *   writing to stdout/stderr would corrupt the MCP stdio transport.
+ *
+ * Returns the stamped entry so the attribution stamp is observable in tests
+ * without touching the filesystem.
  */
 export function logSearch(entry) {
-    entries.push(entry);
+    // Env stamp LAST: the attribution trio is governance telemetry, so the
+    // environment-derived values are authoritative — a caller-supplied (or
+    // spread-truthy `undefined`) trio field must never displace the stamp.
+    const stamped = { ...entry, ...deriveSearchLogAttribution() };
+    entries.push(stamped);
     // Best-effort, non-blocking file append
     if (logFilePath) {
         try {
-            const line = JSON.stringify(entry) + '\n';
+            const line = JSON.stringify(stamped) + '\n';
             // fs.promises.appendFile returns a promise — we intentionally do NOT await it.
             // The .catch() swallows any write error silently (no stdout/stderr writes).
             fs.promises.appendFile(logFilePath, line, 'utf-8').catch(() => {
@@ -35,6 +86,7 @@ export function logSearch(entry) {
             // Intentionally empty — synchronous errors from JSON.stringify etc.
         }
     }
+    return stamped;
 }
 /**
  * Compute aggregate stats from the in-memory search log.

package/dist/search-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-log.js","sourceRoot":"","sources":["../src/search-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAmBlC,oEAAoE;AACpE,MAAM,OAAO,GAAqB,EAAE,CAAC;AAErC,wEAAwE;AACxE,IAAI,WAA+B,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEpB,wCAAwC;IACxC,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAC1C,+EAA+E;YAC/E,4EAA4E;YAC5E,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC5D,8EAA8E;YAChF,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAElC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;IAEnF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;IAC1D,MAAM,WAAW,GACf,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAS,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1F,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAClD,CAAC"}
+{"version":3,"file":"search-log.js","sourceRoot":"","sources":["../src/search-log.ts"],"names":[],"mappings":"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"}

package/dist/search-log.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=search-log.test.d.ts.map

package/dist/search-log.test.d.ts.map

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

package/dist/search-log.test.js

@@ -0,0 +1,89 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { deriveSearchLogAttribution, logSearch } from './search-log.js';
+// ─── deriveSearchLogAttribution (pure — env in, trio out) ───
+describe('deriveSearchLogAttribution', () => {
+    it('stamps all three fields from the environment when present', () => {
+        const attribution = deriveSearchLogAttribution({
+            TOTEM_SELF_AGENT: 'totem-claude',
+            TOTEM_SESSION_ID: 'sess-123',
+            TOTEM_CORRELATION_ID: 'corr-abc',
+        });
+        expect(attribution).toEqual({
+            agent_source: 'totem-claude',
+            session_id: 'sess-123',
+            correlation_id: 'corr-abc',
+        });
+    });
+    it('stamps null for every field when the env is absent (Tenet 4 — never guess)', () => {
+        expect(deriveSearchLogAttribution({})).toEqual({
+            agent_source: null,
+            session_id: null,
+            correlation_id: null,
+        });
+    });
+    it('stamps null per-field independently (partial env)', () => {
+        const attribution = deriveSearchLogAttribution({ TOTEM_SESSION_ID: 'only-session' });
+        expect(attribution.agent_source).toBeNull();
+        expect(attribution.session_id).toBe('only-session');
+        expect(attribution.correlation_id).toBeNull();
+    });
+    it('treats whitespace-only env values as absent → null', () => {
+        const attribution = deriveSearchLogAttribution({
+            TOTEM_SELF_AGENT: '   ',
+            TOTEM_SESSION_ID: '\t',
+            TOTEM_CORRELATION_ID: '',
+        });
+        expect(attribution).toEqual({
+            agent_source: null,
+            session_id: null,
+            correlation_id: null,
+        });
+    });
+    it('takes the first non-empty seat from a comma-separated TOTEM_SELF_AGENT', () => {
+        // Mirrors resolveSelfAgents' comma parsing — the MCP server runs under a
+        // single seat, so the first entry is that seat.
+        expect(deriveSearchLogAttribution({ TOTEM_SELF_AGENT: ' , totem-gemini , extra' }).agent_source).toBe('totem-gemini');
+    });
+});
+// ─── logSearch stamping (no setLogDir → in-memory only, no fs) ───
+describe('logSearch attribution stamp', () => {
+    const ENV_KEYS = ['TOTEM_SELF_AGENT', 'TOTEM_SESSION_ID', 'TOTEM_CORRELATION_ID'];
+    const saved = {};
+    const baseEntry = {
+        timestamp: '2026-07-15T00:00:00.000Z',
+        query: 'q',
+        resultCount: 0,
+        durationMs: 1,
+        topScore: null,
+    };
+    beforeEach(() => {
+        for (const k of ENV_KEYS) {
+            saved[k] = process.env[k];
+            delete process.env[k];
+        }
+    });
+    afterEach(() => {
+        for (const k of ENV_KEYS) {
+            if (saved[k] === undefined)
+                delete process.env[k];
+            else
+                process.env[k] = saved[k];
+        }
+    });
+    it('stamps the trio from process.env onto the returned entry', () => {
+        process.env.TOTEM_SELF_AGENT = 'totem-claude';
+        process.env.TOTEM_SESSION_ID = 'sess-9';
+        process.env.TOTEM_CORRELATION_ID = 'corr-9';
+        const stamped = logSearch({ ...baseEntry });
+        expect(stamped.agent_source).toBe('totem-claude');
+        expect(stamped.session_id).toBe('sess-9');
+        expect(stamped.correlation_id).toBe('corr-9');
+    });
+    it('stamps explicit null on every field when the env is absent', () => {
+        const stamped = logSearch({ ...baseEntry });
+        expect(stamped.agent_source).toBeNull();
+        expect(stamped.session_id).toBeNull();
+        expect(stamped.correlation_id).toBeNull();
+    });
+});
+//# sourceMappingURL=search-log.test.js.map

package/dist/search-log.test.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mmnto/mcp",
-  "version": "1.97.0",
-  "description": "MCP server for Totem — a local-first, file-anchored substrate that makes AI-agent work queryable, enforceable, and derivable in your codebase",
+  "version": "1.98.1",
+  "description": "MCP server for Totem, the local-first toolkit that keeps AI-agent work queryable, enforceable, and derivable as plain files in your codebase",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -22,7 +22,7 @@
     "dotenv": "^16.4.0",
     "jiti": "^2.4.0",
     "zod": "^3.24.0",
-    "@mmnto/totem": "1.97.0"
+    "@mmnto/totem": "1.98.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",