@nxuss/lemma 1.17.0 → 1.18.1

package/dist/esm/cloud/store/PostgresBrainStore.js

@@ -0,0 +1,176 @@
+import { createHash, randomBytes } from 'crypto';
+import { LemmaApiError } from '../../contracts/errors.js';
+import { tokenize, termFrequencies } from '../../subconscious/TheBrainV2.js';
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** Genera un id al estilo del Brain local: sha1 12-hex, con sal aleatoria. */
+function generateId(query) {
+    const queryKey = query.trim().toLowerCase().substring(0, 200);
+    return createHash('sha1')
+        .update(queryKey + Date.now() + randomBytes(8).toString('hex'))
+        .digest('hex')
+        .substring(0, 12);
+}
+/** Texto del que se derivan los términos de búsqueda: query + response + claims. */
+function searchableText(m) {
+    const parts = [m.query, m.response];
+    if (Array.isArray(m.claims)) {
+        for (const c of m.claims)
+            if (typeof c?.text === 'string')
+                parts.push(c.text);
+    }
+    return parts.filter((p) => typeof p === 'string' && p.length > 0).join(' ');
+}
+/** Normaliza una memoria arbitraria a la forma persistible, enriqueciéndola con
+ * termes/termFreq si no venía de un Brain que ya las computara. */
+export function normalizeMemory(memory) {
+    const m = isRecord(memory) ? memory : {};
+    const query = typeof m.query === 'string' ? m.query : '';
+    const response = typeof m.response === 'string' ? m.response : '';
+    const terms = Array.isArray(m.terms) && m.terms.length > 0
+        ? [...new Set(m.terms.filter((t) => typeof t === 'string'))]
+        : tokenize(searchableText(m));
+    const termFreq = isRecord(m.termFreq) ? m.termFreq : termFrequencies(terms);
+    const projectId = typeof m.projectId === 'string' ? m.projectId : null;
+    const id = typeof m.id === 'string' && m.id.length > 0 ? m.id : generateId(query || response || Math.random().toString(36));
+    const payload = {
+        ...(isRecord(memory) ? memory : {}),
+        id,
+        query,
+        response,
+        terms,
+        termFreq,
+    };
+    return { id, query, response, projectId, terms, termFreq, payload };
+}
+const PUT_SQL = `
+  INSERT INTO memories (id, tenant_id, project_id, query, response, payload, terms)
+  VALUES ($1, $2, $3, $4, $5, $6::jsonb, $7::text[])
+  ON CONFLICT (id, tenant_id) DO UPDATE SET
+    payload = EXCLUDED.payload,
+    terms = EXCLUDED.terms,
+    query = EXCLUDED.query,
+    response = EXCLUDED.response,
+    project_id = EXCLUDED.project_id,
+    updated_at = now()
+`;
+const GET_SQL = `
+  SELECT payload FROM memories
+  WHERE tenant_id = $1 AND id = $2
+  LIMIT 1
+`;
+const LIST_BY_IDS_SQL = `
+  SELECT id, payload FROM memories
+  WHERE tenant_id = $1 AND id = ANY($2::text[])
+`;
+const SEARCH_CANDIDATES_SQL = `
+  WITH q AS (
+    SELECT to_tsquery('simple', array_to_string($2::text[], ' | ')) AS tq
+  )
+  SELECT m.id AS id,
+    ts_rank_cd(array_to_tsvector(m.terms), q.tq)::numeric AS score
+  FROM memories m, q
+  WHERE m.tenant_id = $1
+    AND array_to_tsvector(m.terms) @@ q.tq
+  ORDER BY score DESC
+  LIMIT $3::int
+`;
+export class PostgresBrainStore {
+    constructor(pool, opts = {}) {
+        this.pool = pool;
+        this.opts = opts;
+        this.lane = 'B';
+    }
+    async put(tenantId, memory) {
+        const { id, query, response, projectId, terms, termFreq, payload } = normalizeMemory(memory);
+        const m = isRecord(memory) ? memory : {};
+        const claims = Array.isArray(m.claims) ? m.claims.filter((c) => isRecord(c)) : [];
+        const evidence = [];
+        const collect = (kind, hashes) => {
+            if (!hashes)
+                return;
+            for (const [target, h] of Object.entries(hashes)) {
+                if (typeof h === 'string')
+                    evidence.push({ kind, target, hash: h });
+            }
+        };
+        collect('file', m.fileHashes);
+        collect('symbol', m.symbolHashes);
+        collect('symbol_normalized', m.symbolNormalizedHashes);
+        const derivedFrom = Array.isArray(m.derivedFrom)
+            ? m.derivedFrom.filter((d) => typeof d === 'string')
+            : [];
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            await client.query(PUT_SQL, [id, tenantId, projectId, query, response, JSON.stringify(payload), terms]);
+            await client.query('DELETE FROM claims WHERE tenant_id = $1 AND memory_id = $2', [tenantId, id]);
+            for (const c of claims) {
+                const cid = typeof c.id === 'string' && c.id ? c.id : generateId(c.text || Math.random().toString(36));
+                await client.query('INSERT INTO claims (id, memory_id, tenant_id, text, payload) VALUES ($1, $2, $3, $4, $5::jsonb)', [cid, id, tenantId, typeof c.text === 'string' ? c.text : '', JSON.stringify(c)]);
+            }
+            await client.query('DELETE FROM evidence_hashes WHERE tenant_id = $1 AND memory_id = $2', [tenantId, id]);
+            for (const e of evidence) {
+                await client.query('INSERT INTO evidence_hashes (tenant_id, memory_id, kind, target, hash) VALUES ($1, $2, $3, $4, $5)', [tenantId, id, e.kind, e.target, e.hash]);
+            }
+            await client.query('DELETE FROM memory_edges WHERE tenant_id = $1 AND memory_id = $2', [tenantId, id]);
+            for (const dep of derivedFrom) {
+                await client.query('INSERT INTO memory_edges (tenant_id, memory_id, derived_from) VALUES ($1, $2, $3)', [tenantId, id, dep]);
+            }
+            await client.query('COMMIT');
+            return id;
+        }
+        catch (err) {
+            await client.query('ROLLBACK');
+            throw new LemmaApiError({ code: 'internal', status: 500, message: 'Failed to store memory', internal: err });
+        }
+        finally {
+            client.release();
+        }
+    }
+    async get(tenantId, id) {
+        const { rows } = await this.pool.query(GET_SQL, [tenantId, id]);
+        if (rows.length === 0)
+            return null;
+        return rows[0].payload;
+    }
+    async searchCandidates(tenantId, query, limit) {
+        const terms = tokenize(query);
+        if (terms.length === 0)
+            return [];
+        const safeLimit = Math.max(1, Math.min(Math.trunc(limit) || 10, this.opts.maxCandidates ?? 100));
+        const { rows } = await this.pool.query(SEARCH_CANDIDATES_SQL, [tenantId, terms, safeLimit]);
+        return rows.map((r) => ({ id: r.id, score: Number(r.score) }));
+    }
+    async listByIds(tenantId, ids) {
+        if (ids.length === 0)
+            return new Map();
+        const { rows } = await this.pool.query(LIST_BY_IDS_SQL, [tenantId, ids]);
+        const out = new Map();
+        for (const r of rows)
+            out.set(r.id, r.payload);
+        return out;
+    }
+    async delete(tenantId, id) {
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            await client.query('DELETE FROM memory_edges WHERE tenant_id = $1 AND memory_id = $2', [tenantId, id]);
+            await client.query('DELETE FROM claims WHERE tenant_id = $1 AND memory_id = $2', [tenantId, id]);
+            await client.query('DELETE FROM evidence_hashes WHERE tenant_id = $1 AND memory_id = $2', [tenantId, id]);
+            const res = await client.query('DELETE FROM memories WHERE tenant_id = $1 AND id = $2', [tenantId, id]);
+            await client.query('COMMIT');
+            return (res.rowCount ?? 0) > 0;
+        }
+        catch (err) {
+            await client.query('ROLLBACK');
+            throw new LemmaApiError({ code: 'internal', status: 500, message: 'Failed to delete memory', internal: err });
+        }
+        finally {
+            client.release();
+        }
+    }
+}
+export default PostgresBrainStore;
+//# sourceMappingURL=PostgresBrainStore.js.map

package/dist/esm/cloud/store/PostgresBrainStore.js.map

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

package/dist/esm/cloud/store/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lemma API v2 — BrainStore implementations (Lane B stub)
+ */
+export * from './PostgresBrainStore.js';
+export * from './FileBrainStore.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/cloud/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cloud/store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/esm/cloud/store/index.js

@@ -0,0 +1,6 @@
+/**
+ * Lemma API v2 — BrainStore implementations (Lane B stub)
+ */
+export * from './PostgresBrainStore.js';
+export * from './FileBrainStore.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/cloud/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cloud/store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/esm/cloud/types.d.ts

@@ -24,8 +24,6 @@ export interface TenantStats {
     misses: number;
     totalRequests: number;
     hitRate: number;
-    estimatedTokensSaved: number;
-    estimatedCostSaved: number;
     cacheSize: number;
 }
 export declare const PLAN_LIMITS: Record<string, {
@@ -33,6 +31,4 @@ export declare const PLAN_LIMITS: Record<string, {
     monthlyRequests: number;
     cacheEntries: number;
 }>;
-export declare const AVG_TOKENS_PER_REQUEST = 800;
-export declare const COST_PER_TOKEN = 0.000002;
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/cloud/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cloud/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAIhH,CAAC;AAEF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,cAAc,WAAW,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cloud/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAIhH,CAAC"}

package/dist/esm/cloud/types.js

@@ -6,6 +6,4 @@ export const PLAN_LIMITS = {
     pro: { dailyRequests: 5000, monthlyRequests: 50000, cacheEntries: 10000 },
     scale: { dailyRequests: Infinity, monthlyRequests: Infinity, cacheEntries: Infinity },
 };
-export const AVG_TOKENS_PER_REQUEST = 800;
-export const COST_PER_TOKEN = 0.000002; // gpt-4o-mini input+output blended
 //# sourceMappingURL=types.js.map

package/dist/esm/cloud/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cloud/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+BH,MAAM,CAAC,MAAM,WAAW,GAA6F;IACnH,IAAI,EAAG,EAAE,aAAa,EAAE,IAAK,EAAI,eAAe,EAAE,KAAM,EAAI,YAAY,EAAE,GAAG,EAAE;IAC/E,GAAG,EAAI,EAAE,aAAa,EAAE,IAAK,EAAI,eAAe,EAAE,KAAM,EAAI,YAAY,EAAE,KAAM,EAAE;IAClF,KAAK,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;CACtF,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,mCAAmC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cloud/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6BH,MAAM,CAAC,MAAM,WAAW,GAA6F;IACnH,IAAI,EAAG,EAAE,aAAa,EAAE,IAAK,EAAI,eAAe,EAAE,KAAM,EAAI,YAAY,EAAE,GAAG,EAAE;IAC/E,GAAG,EAAI,EAAE,aAAa,EAAE,IAAK,EAAI,eAAe,EAAE,KAAM,EAAI,YAAY,EAAE,KAAM,EAAE;IAClF,KAAK,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;CACtF,CAAC"}

package/dist/esm/cloud/v2/app.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lemma API v2 — HTTP factory (Lane C)
+ *
+ * createApp(deps) — dependency-injected, no global singletons, so tests build the
+ * app with in-memory stores/resolvers/ledgers. PROHIBITED: touching
+ * src/cloud/server.ts — the v1 server stays untouched; v2 lives entirely here.
+ *
+ * Ownership: Lane C.
+ */
+import { type Express } from 'express';
+import { type MountDeps } from './routes/index.js';
+export type AppDeps = MountDeps;
+export declare function createApp(deps: AppDeps): Express;
+export default createApp;
+//# sourceMappingURL=app.d.ts.map

package/dist/esm/cloud/v2/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../../src/cloud/v2/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAgB,EAAE,KAAK,OAAO,EAA4E,MAAM,SAAS,CAAC;AAE1H,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGvD,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC;AAoChC,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAehD;AAED,eAAe,SAAS,CAAC"}

package/dist/esm/cloud/v2/app.js

@@ -0,0 +1,57 @@
+/**
+ * Lemma API v2 — HTTP factory (Lane C)
+ *
+ * createApp(deps) — dependency-injected, no global singletons, so tests build the
+ * app with in-memory stores/resolvers/ledgers. PROHIBITED: touching
+ * src/cloud/server.ts — the v1 server stays untouched; v2 lives entirely here.
+ *
+ * Ownership: Lane C.
+ */
+import express from 'express';
+import { LemmaApiError } from '../../contracts/errors.js';
+import { mountRoutes } from './routes/index.js';
+import { MAX_BODY_BYTES } from './routes/memories.js';
+/** Body-parser errors (malformed JSON, over the size cap) never carry a code we
+ *  can trust from Express — normalize them to the same envelope as every other
+ *  /v2 failure instead of leaking a raw parser message. */
+function isBodyParserError(err) {
+    return typeof err === 'object' && err !== null && ('type' in err || 'statusCode' in err || 'status' in err);
+}
+function errorHandler() {
+    return (err, _req, res, _next) => {
+        if (err instanceof LemmaApiError) {
+            res.status(err.status).json(err.toJSON());
+            return;
+        }
+        if (isBodyParserError(err)) {
+            const status = err.status ?? err.statusCode;
+            const apiErr = new LemmaApiError({
+                code: 'invalid_request',
+                status: status === 413 ? 413 : 400,
+                message: 'invalid or too-large request body',
+            });
+            res.status(apiErr.status).json(apiErr.toJSON());
+            return;
+        }
+        // Unknown error: log server-side for debugging, but the response NEVER carries
+        // a file path, a SQL fragment or a stack trace — only the stable internal code.
+        // eslint-disable-next-line no-console
+        console.error('[lemma:v2] unhandled error', err);
+        const apiErr = new LemmaApiError({ code: 'internal', status: 500, message: 'internal error' });
+        res.status(500).json(apiErr.toJSON());
+    };
+}
+export function createApp(deps) {
+    const app = express();
+    app.disable('x-powered-by');
+    app.use(express.json({ limit: MAX_BODY_BYTES }));
+    mountRoutes(app, deps);
+    app.use((_req, res) => {
+        const apiErr = new LemmaApiError({ code: 'not_found', status: 404, message: 'no such route' });
+        res.status(404).json(apiErr.toJSON());
+    });
+    app.use(errorHandler());
+    return app;
+}
+export default createApp;
+//# sourceMappingURL=app.js.map

package/dist/esm/cloud/v2/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/cloud/v2/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,OAAmG,MAAM,SAAS,CAAC;AAC1H,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAInD;;2DAE2D;AAC3D,SAAS,iBAAiB,CAAC,GAAY;IACrC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,YAAY,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,CAAC,CAAC;AAC9G,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,CAAC,GAAY,EAAE,IAAa,EAAE,GAAa,EAAE,KAAmB,EAAE,EAAE;QACzE,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAI,GAAgD,CAAC,MAAM,IAAK,GAA+B,CAAC,UAAU,CAAC;YACvH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;gBAC/B,IAAI,EAAE,iBAAiB;gBACvB,MAAM,EAAE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;gBAClC,OAAO,EAAE,mCAAmC;aAC7C,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,+EAA+E;QAC/E,gFAAgF;QAChF,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;IAEjD,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IAExB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,eAAe,SAAS,CAAC"}

package/dist/esm/cloud/v2/routes/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lemma API v2 — route index (Lane C)
+ *
+ * Mounts every /v2 route, including ./scrub (owned by Lane F — its handler is
+ * framework-agnostic by design, see routes/scrub.ts's header comment; this file
+ * does the Express wiring on Lane F's behalf).
+ *
+ * /v2/scrub is mounted BEFORE the auth middleware: its openapi.yaml operation
+ * declares `security: []` (stateless, no tenant to scope it to), so registering
+ * it ahead of `authenticateV2` — Express matches routes in registration order —
+ * is what keeps it public while every other /v2 route stays behind a bearer key.
+ *
+ * Ownership: Lane C.
+ */
+import type { Express } from 'express';
+import { type AuthenticateV2Deps } from '../../identity/authenticateV2.js';
+import { type MemoriesDeps } from './memories.js';
+import { type RecallDeps } from './recall.js';
+import { type VerifyDeps } from './verify.js';
+import { type UsageDeps } from './usage.js';
+export type MountDeps = AuthenticateV2Deps & MemoriesDeps & RecallDeps & VerifyDeps & UsageDeps;
+export declare function mountRoutes(app: Express, deps: MountDeps): void;
+export default mountRoutes;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/cloud/v2/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cloud/v2/routes/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAA4C,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAIvD,MAAM,MAAM,SAAS,GAAG,kBAAkB,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhG,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAuB/D;AAED,eAAe,WAAW,CAAC"}

package/dist/esm/cloud/v2/routes/index.js

@@ -0,0 +1,32 @@
+import { authenticateV2 } from '../../identity/authenticateV2.js';
+import { createMemoryHandler, forgetMemoryHandler } from './memories.js';
+import { recallHandler } from './recall.js';
+import { verifyHandler } from './verify.js';
+import { usageHandler } from './usage.js';
+import { scrubRouter } from './scrub.js';
+import { LemmaApiError } from '../../../contracts/errors.js';
+export function mountRoutes(app, deps) {
+    // Public: no tenant, no auth (Lane F, stateless).
+    const scrub = scrubRouter();
+    app.post('/v2/scrub', (req, res, next) => {
+        try {
+            if (req.body === undefined) {
+                throw new LemmaApiError({ code: 'invalid_request', status: 400, message: 'request body must be a JSON object' });
+            }
+            res.json(scrub.handle(req.body));
+        }
+        catch (err) {
+            next(err);
+        }
+    });
+    // Everything below requires a valid tenant.
+    const auth = authenticateV2(deps);
+    app.use('/v2', auth);
+    app.post('/v2/memories', createMemoryHandler(deps));
+    app.delete('/v2/memories/:id', forgetMemoryHandler(deps));
+    app.post('/v2/recall', recallHandler(deps));
+    app.post('/v2/verify', verifyHandler(deps));
+    app.get('/v2/usage', usageHandler(deps));
+}
+export default mountRoutes;
+//# sourceMappingURL=index.js.map

package/dist/esm/cloud/v2/routes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cloud/v2/routes/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,cAAc,EAA2B,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,aAAa,EAAmB,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAmB,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAkB,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,IAAe;IACvD,kDAAkD;IAClD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACnH,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,4CAA4C;IAC5C,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAErB,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,GAAG,CAAC,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,eAAe,WAAW,CAAC"}

package/dist/esm/cloud/v2/routes/memories.d.ts

@@ -0,0 +1,83 @@
+import type { RequestHandler } from 'express';
+import { z, type ZodError } from 'zod';
+import { LemmaApiError } from '../../../contracts/errors.js';
+import type { CreateMemoryRequest, MemoryClaim, MemoryState } from '../../../contracts/api-v2.types.js';
+import type { Evidence } from '../../../contracts/evidence.js';
+import type { BrainStore } from '../../../contracts/store.js';
+export declare const MAX_CLAIMS = 50;
+export declare const MAX_VERIFY_IDS = 200;
+export declare const MAX_BODY_BYTES = 1000000;
+export declare const EvidenceSchema: z.ZodObject<{
+    files: z.ZodRecord<z.ZodString, z.ZodString>;
+    symbols: z.ZodRecord<z.ZodString, z.ZodString>;
+    symbolsNormalized: z.ZodRecord<z.ZodString, z.ZodString>;
+    branch: z.ZodOptional<z.ZodString>;
+    commit: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CreateMemoryRequestSchema: z.ZodObject<{
+    claims: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        symbols: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            filePath: z.ZodString;
+            symbolName: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    evidence: z.ZodObject<{
+        files: z.ZodRecord<z.ZodString, z.ZodString>;
+        symbols: z.ZodRecord<z.ZodString, z.ZodString>;
+        symbolsNormalized: z.ZodRecord<z.ZodString, z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    derivedFrom: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/** Turns the first zod issue into the API's stable invalid_request shape — never a raw zod dump. */
+export declare function zodToApiError(error: ZodError): LemmaApiError;
+/** What Lane C persists via `BrainStore.put`. `query`/`response` feed the store's
+ *  BM25 indexing (see FileBrainStore.searchCandidates) — same convention the v1
+ *  Brain already writes, so a v2-written record stays searchable. */
+export interface StoredMemory {
+    claims: MemoryClaim[];
+    derivedFrom?: string[];
+    query: string;
+    response: string;
+    createdAt: number;
+}
+declare function isStoredMemory(v: unknown): v is StoredMemory;
+/**
+ * Builds the persisted claims from the request: each claim only tracks the
+ * files/symbols it explicitly declared, hashed from the top-level `evidence`
+ * bundle the client supplied. A declared path/symbol with no matching hash in
+ * `evidence` is a malformed request (the client can't establish a baseline it
+ * never sent) — this throws `invalid_request` naming the missing field, it never
+ * silently stores an untracked claim.
+ */
+export declare function buildClaims(body: CreateMemoryRequest): MemoryClaim[];
+export interface MemoryStateResult {
+    state: MemoryState;
+    staleFiles: string[];
+    cosmeticChanges: string[];
+}
+/**
+ * Aggregates a memory's claims into one `MemoryState`. Precedence is worst-case
+ * fail-closed: any claim `unverified` ⇒ the memory is `unverified` (even if other
+ * claims are provably stale); otherwise any claim `stale` ⇒ `stale`; otherwise
+ * `fresh`. A memory whose claims track nothing is always `fresh` (nothing to go
+ * stale) — same as `TheBrainV2.checkClaimFreshness` for an evidence-less claim.
+ *
+ * `contradicted` is not produced here: detecting two stored claims about the same
+ * subject diverging is not part of this lane's acceptance criteria (see plan §3,
+ * Lane C) — noted under lane-notes/C.md ## decisions.
+ */
+export declare function computeMemoryState(claims: MemoryClaim[], currentEvidence: Evidence | undefined): MemoryStateResult;
+export interface MemoriesDeps {
+    store: Pick<BrainStore, 'put' | 'get' | 'delete'>;
+}
+/** POST /v2/memories */
+export declare function createMemoryHandler(deps: MemoriesDeps): RequestHandler;
+/** DELETE /v2/memories/:id */
+export declare function forgetMemoryHandler(deps: MemoriesDeps): RequestHandler;
+export { isStoredMemory };
+export default createMemoryHandler;
+//# sourceMappingURL=memories.d.ts.map

package/dist/esm/cloud/v2/routes/memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memories.d.ts","sourceRoot":"","sources":["../../../../../src/cloud/v2/routes/memories.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EACV,mBAAmB,EAGnB,WAAW,EACX,WAAW,EACZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAM3D,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,cAAc,UAAY,CAAC;AAIxC,eAAO,MAAM,cAAc;;;;;;iBAMK,CAAC;AAEjC,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;iBAapC,CAAC;AAEH,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAS5D;AAID;;qEAEqE;AACrE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iBAAS,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,CAMrD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,EAAE,CA4CpE;AAyDD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,iBAAiB,CAoBlH;AAID,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC;CACnD;AAED,wBAAwB;AACxB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CA+BtE;AAED,8BAA8B;AAC9B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAoBtE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,eAAe,mBAAmB,CAAC"}