eklavya 1.18.3 → 1.19.1

package/dist/memory/capture.js

@@ -0,0 +1,123 @@
+import { nowIso } from '../time.js';
+import { eventUid, relativeToProject } from './identity.js';
+import { DEFAULT_PRIVACY, isOwnTraffic, pathExcluded, redact, toolExcluded } from './privacy.js';
+import { appendEvent } from './store.js';
+import { spoolEvent, takeSpooled } from './spool.js';
+/** Per-event body cap. Evidence is a pointer to work, not a copy of the repo. */
+const MAX_BODY = 4000;
+/**
+ * `minimal` keeps the shape of a session — what was asked, what was decided,
+ * where it started and stopped — and drops the per-file traffic that makes up
+ * most of the volume.
+ */
+const MINIMAL_KINDS = ['prompt', 'assistant', 'lifecycle', 'note'];
+export function policyFrom(config) {
+    return {
+        excludePaths: [...DEFAULT_PRIVACY.excludePaths, ...config.privacy.exclude_paths],
+        excludeTools: [...DEFAULT_PRIVACY.excludeTools, ...config.privacy.exclude_tools],
+        redactPatterns: config.privacy.redact_patterns,
+    };
+}
+/** Everything but the write: pure, so the exclusion rules are testable alone. */
+export function prepare(config, identity, event) {
+    if (!config.memory.enabled || config.memory.capture === 'off')
+        return null;
+    if (config.memory.capture === 'minimal' && !MINIMAL_KINDS.includes(event.kind))
+        return null;
+    const policy = policyFrom(config);
+    if (toolExcluded(event.tool, policy))
+        return null;
+    if (isOwnTraffic(event.tool, event.body))
+        return null;
+    const files = (event.files ?? []).filter((f) => !pathExcluded(f, policy));
+    // A file event whose only file was excluded is the excluded file. Keeping the
+    // event for its body would re-admit through the back door what the path rule
+    // just shut out.
+    if ((event.kind === 'file_edit' || event.kind === 'file_read') && (event.files?.length ?? 0) > 0 && files.length === 0) {
+        return null;
+    }
+    const cleaned = redact(event.body.slice(0, MAX_BODY), policy);
+    const occurredAt = event.occurredAt ?? nowIso();
+    return {
+        eventUid: eventUid({
+            host: identity.host,
+            sessionId: identity.sessionId,
+            agentId: identity.agentId,
+            kind: event.kind,
+            tool: event.tool,
+            occurredAt,
+            body: cleaned.text,
+        }),
+        project: identity.project,
+        checkout: identity.checkout,
+        sessionId: identity.sessionId,
+        agentId: identity.agentId,
+        host: identity.host,
+        source: event.source ?? 'hook',
+        kind: event.kind,
+        tool: event.tool ?? null,
+        title: event.title ? redact(event.title, policy).text : null,
+        body: cleaned.text,
+        files: files.map((f) => relativeToProject(f, identity.project)),
+        occurredAt,
+        redacted: cleaned.redacted,
+    };
+}
+export function capture(db, config, identity, event) {
+    const input = prepare(config, identity, event);
+    if (!input)
+        return 'excluded';
+    const { inserted } = appendEvent(db, input);
+    return inserted ? 'stored' : 'duplicate';
+}
+/**
+ * Capture when the database may not be reachable. The sanitised record — never
+ * the raw one — is what reaches the spool, so a degraded path cannot write a
+ * secret that the healthy path would have removed.
+ */
+export function captureOrSpool(db, config, identity, event) {
+    const input = prepare(config, identity, event);
+    if (!input)
+        return 'excluded';
+    if (db) {
+        try {
+            const { inserted } = appendEvent(db, input);
+            return inserted ? 'stored' : 'duplicate';
+        }
+        catch {
+            // Fall through to the spool: a locked or unwritable database is exactly
+            // what it exists for.
+        }
+    }
+    return spoolEvent(input);
+}
+/** Replays whatever the spool holds. Idempotent through `event_uid`. */
+export function drainSpool(db) {
+    const records = takeSpooled();
+    let replayed = 0;
+    let skipped = 0;
+    for (const record of records) {
+        const input = record;
+        // A spool line is data this process wrote earlier, but a truncated write or
+        // a hand-edited file is still possible; anything without an identity cannot
+        // be replayed idempotently and is discarded rather than guessed at.
+        if (!input || typeof input !== 'object' || !input.eventUid || !input.project) {
+            skipped++;
+            continue;
+        }
+        try {
+            const { inserted } = appendEvent(db, input);
+            if (inserted)
+                replayed++;
+            else
+                skipped++;
+        }
+        catch {
+            // Put it back rather than lose it; the next drain tries again.
+            spoolEvent(input);
+            skipped++;
+        }
+    }
+    return { replayed, skipped };
+}
+//# sourceMappingURL=capture.js.map

package/dist/memory/capture.js.map

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

package/dist/memory/code.js

@@ -0,0 +1,186 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const LANGUAGES = {
+    '.ts': tsLike('typescript'),
+    '.tsx': tsLike('typescript'),
+    '.js': tsLike('javascript'),
+    '.jsx': tsLike('javascript'),
+    '.mjs': tsLike('javascript'),
+    '.cjs': tsLike('javascript'),
+    '.py': {
+        language: 'python',
+        lineComment: ['#'],
+        patterns: [
+            { kind: 'class', re: /^\s*class\s+([A-Za-z_]\w*)/ },
+            { kind: 'function', re: /^\s*(?:async\s+)?def\s+([A-Za-z_]\w*)/ },
+        ],
+    },
+    '.go': {
+        language: 'go',
+        lineComment: ['//'],
+        patterns: [
+            { kind: 'function', re: /^\s*func\s+(?:\([^)]*\)\s*)?([A-Za-z_]\w*)/ },
+            { kind: 'type', re: /^\s*type\s+([A-Za-z_]\w*)/ },
+        ],
+    },
+    '.rs': {
+        language: 'rust',
+        lineComment: ['//'],
+        patterns: [
+            { kind: 'function', re: /^\s*(?:pub\s+)?(?:async\s+)?fn\s+([A-Za-z_]\w*)/ },
+            { kind: 'struct', re: /^\s*(?:pub\s+)?struct\s+([A-Za-z_]\w*)/ },
+            { kind: 'enum', re: /^\s*(?:pub\s+)?enum\s+([A-Za-z_]\w*)/ },
+            { kind: 'trait', re: /^\s*(?:pub\s+)?trait\s+([A-Za-z_]\w*)/ },
+            { kind: 'impl', re: /^\s*impl(?:<[^>]*>)?\s+([A-Za-z_][\w:<>]*)/ },
+        ],
+    },
+    '.java': {
+        language: 'java',
+        lineComment: ['//'],
+        patterns: [
+            { kind: 'class', re: /^\s*(?:public\s+|private\s+|protected\s+|abstract\s+|final\s+|static\s+)*class\s+([A-Za-z_]\w*)/ },
+            { kind: 'interface', re: /^\s*(?:public\s+)?interface\s+([A-Za-z_]\w*)/ },
+            { kind: 'method', re: /^\s*(?:public|private|protected)\s+(?:static\s+)?[\w<>\[\],.\s]+\s+([A-Za-z_]\w*)\s*\(/ },
+        ],
+    },
+    '.rb': {
+        language: 'ruby',
+        lineComment: ['#'],
+        patterns: [
+            { kind: 'class', re: /^\s*class\s+([A-Za-z_]\w*)/ },
+            { kind: 'module', re: /^\s*module\s+([A-Za-z_]\w*)/ },
+            { kind: 'method', re: /^\s*def\s+([A-Za-z_?!.]\w*[?!]?)/ },
+        ],
+    },
+    '.sql': {
+        language: 'sql',
+        lineComment: ['--'],
+        patterns: [
+            { kind: 'table', re: /^\s*CREATE\s+(?:VIRTUAL\s+)?TABLE(?:\s+IF\s+NOT\s+EXISTS)?\s+([A-Za-z_]\w*)/i },
+            { kind: 'index', re: /^\s*CREATE\s+(?:UNIQUE\s+)?INDEX(?:\s+IF\s+NOT\s+EXISTS)?\s+([A-Za-z_]\w*)/i },
+            { kind: 'trigger', re: /^\s*CREATE\s+TRIGGER(?:\s+IF\s+NOT\s+EXISTS)?\s+([A-Za-z_]\w*)/i },
+        ],
+    },
+};
+function tsLike(language) {
+    return {
+        language,
+        lineComment: ['//', '*', '/*'],
+        patterns: [
+            { kind: 'class', re: /^\s*(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/ },
+            { kind: 'interface', re: /^\s*(?:export\s+)?interface\s+([A-Za-z_$][\w$]*)/ },
+            { kind: 'type', re: /^\s*(?:export\s+)?type\s+([A-Za-z_$][\w$]*)/ },
+            { kind: 'enum', re: /^\s*(?:export\s+)?(?:const\s+)?enum\s+([A-Za-z_$][\w$]*)/ },
+            { kind: 'function', re: /^\s*(?:export\s+)?(?:default\s+)?(?:async\s+)?function\s*\*?\s+([A-Za-z_$][\w$]*)/ },
+            { kind: 'const', re: /^\s*(?:export\s+)?(?:const|let)\s+([A-Za-z_$][\w$]*)\s*[:=]/ },
+        ],
+    };
+}
+export function languageOf(file) {
+    return LANGUAGES[path.extname(file).toLowerCase()]?.language ?? null;
+}
+const MAX_BYTES = 2 * 1024 * 1024;
+const MAX_SYMBOLS = 400;
+export function outline(file) {
+    const spec = LANGUAGES[path.extname(file).toLowerCase()];
+    if (!spec)
+        return null;
+    let text;
+    try {
+        if (fs.statSync(file).size > MAX_BYTES)
+            return null;
+        text = fs.readFileSync(file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const lines = text.split('\n');
+    const symbols = [];
+    for (let i = 0; i < lines.length && symbols.length < MAX_SYMBOLS; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!trimmed || spec.lineComment.some((c) => trimmed.startsWith(c)))
+            continue;
+        for (const { kind, re } of spec.patterns) {
+            const match = re.exec(line);
+            if (match?.[1]) {
+                symbols.push({ name: match[1], kind, line: i + 1, text: trimmed.slice(0, 200) });
+                break;
+            }
+        }
+    }
+    return {
+        file,
+        language: spec.language,
+        lines: lines.length,
+        symbols,
+        truncated: symbols.length >= MAX_SYMBOLS,
+    };
+}
+const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'coverage', '.next', 'vendor', '__pycache__']);
+function* walk(root, depth = 0) {
+    if (depth > 12)
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith('.') && entry.name !== '.eklavya')
+            continue;
+        const full = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            yield* walk(full, depth + 1);
+        }
+        else if (entry.isFile() && LANGUAGES[path.extname(entry.name).toLowerCase()]) {
+            yield full;
+        }
+    }
+}
+/**
+ * Finds a declaration by name across a tree, with the containing symbol.
+ *
+ * Declaration-first rather than every mention: an agent asking "where is
+ * `recordReceipt`" wants the one line that defines it, and a list of its 40
+ * call sites is the answer to a different question.
+ */
+export function findSymbol(root, name, limit = 20) {
+    const needle = name.toLowerCase();
+    const hits = [];
+    for (const file of walk(root)) {
+        const parsed = outline(file);
+        if (!parsed)
+            continue;
+        for (const symbol of parsed.symbols) {
+            if (!symbol.name.toLowerCase().includes(needle))
+                continue;
+            hits.push({ file: path.relative(root, file), line: symbol.line, text: symbol.text, symbol: symbol.name });
+            if (hits.length >= limit)
+                return hits;
+        }
+    }
+    return hits;
+}
+/** The lines around a symbol's declaration: "show me this, not the whole file". */
+export function expand(file, line, before = 5, after = 25) {
+    try {
+        const lines = fs.readFileSync(file, 'utf8').split('\n');
+        const start = Math.max(0, line - 1 - before);
+        // `after` counts lines AFTER the declaration, so the declaration's own line
+        // does not eat one of them -- `before: 2, after: 2` is five lines, centred.
+        const end = Math.min(lines.length, line + after);
+        return lines
+            .slice(start, end)
+            .map((text, i) => `${String(start + i + 1).padStart(5)}  ${text}`)
+            .join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=code.js.map

package/dist/memory/code.js.map

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

package/dist/memory/collections.js

@@ -0,0 +1,87 @@
+import { nowIso } from '../time.js';
+import { search } from './search.js';
+import { timeline } from './store.js';
+export function createCollection(db, opts) {
+    return Number(db
+        .prepare(`INSERT INTO memory_collections (name, description, filter, project, status, created_at)
+         VALUES (?, ?, ?, ?, 'ready', ?)
+         ON CONFLICT(name) DO UPDATE SET
+           description = excluded.description,
+           filter = excluded.filter,
+           project = excluded.project`)
+        .run(opts.name, opts.description ?? null, JSON.stringify(opts.filter), opts.project ?? null, nowIso())
+        .lastInsertRowid) || collectionByName(db, opts.name).id;
+}
+export function collectionByName(db, name) {
+    return db.prepare('SELECT * FROM memory_collections WHERE name = ?').get(name);
+}
+export function listCollections(db) {
+    return db.prepare('SELECT * FROM memory_collections ORDER BY name').all();
+}
+export function deleteCollection(db, name) {
+    return db.prepare('DELETE FROM memory_collections WHERE name = ?').run(name).changes > 0;
+}
+/**
+ * Re-runs a collection's query and swaps in the result.
+ *
+ * The swap is conditional and that is the point: a rebuild that finds nothing
+ * where there used to be something is far more likely to be a broken index or
+ * a mistyped filter than a genuine emptying, and overwriting on that guess
+ * destroys the collection. It keeps the last good set, marks the collection
+ * `failed`, and says why. `force` is for the developer who really did mean it.
+ */
+export function rebuildCollection(db, config, name, opts = {}) {
+    const collection = collectionByName(db, name);
+    if (!collection)
+        return null;
+    let filter;
+    try {
+        filter = JSON.parse(collection.filter);
+    }
+    catch {
+        return { name, members: 0, previous: memberCount(db, collection.id), kept: true, reason: 'unreadable_filter' };
+    }
+    const previous = memberCount(db, collection.id);
+    const searchFilter = {
+        project: filter.project ?? collection.project ?? null,
+        allProjects: filter.allProjects ?? false,
+        type: filter.type ?? null,
+        tag: filter.tag ?? null,
+        since: filter.since ?? null,
+        limit: filter.limit ?? 100,
+    };
+    const found = filter.query
+        ? search(db, filter.query, filter.mode ?? config.retrieval.mode, searchFilter).map((h) => h.entry)
+        : timeline(db, {
+            project: searchFilter.allProjects ? null : searchFilter.project,
+            type: searchFilter.type,
+            since: searchFilter.since,
+            limit: searchFilter.limit,
+        });
+    if (found.length === 0 && previous > 0 && !opts.force) {
+        db.prepare("UPDATE memory_collections SET status = 'failed' WHERE id = ?").run(collection.id);
+        return { name, members: previous, previous, kept: true, reason: 'empty_rebuild_refused' };
+    }
+    db.transaction(() => {
+        db.prepare('DELETE FROM memory_collection_items WHERE collection_id = ?').run(collection.id);
+        const insert = db.prepare('INSERT OR REPLACE INTO memory_collection_items (collection_id, entry_id, rank) VALUES (?, ?, ?)');
+        found.forEach((entry, index) => insert.run(collection.id, entry.id, found.length - index));
+        db.prepare("UPDATE memory_collections SET built_at = ?, status = 'ready' WHERE id = ?").run(nowIso(), collection.id);
+    })();
+    return { name, members: found.length, previous, kept: false };
+}
+export function collectionEntries(db, name, limit = 50) {
+    const collection = collectionByName(db, name);
+    if (!collection)
+        return [];
+    return db
+        .prepare(`SELECT e.* FROM memory_entries e
+       JOIN memory_collection_items i ON i.entry_id = e.id
+       WHERE i.collection_id = ? AND e.deleted_at IS NULL
+       ORDER BY i.rank DESC LIMIT ?`)
+        .all(collection.id, limit);
+}
+function memberCount(db, collectionId) {
+    return db.prepare('SELECT COUNT(*) AS n FROM memory_collection_items WHERE collection_id = ?').get(collectionId).n;
+}
+//# sourceMappingURL=collections.js.map

package/dist/memory/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/memory/collections.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,MAAM,EAAsC,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAkCrD,MAAM,UAAU,gBAAgB,CAC9B,EAAM,EACN,IAAsG;IAEtG,OAAO,MAAM,CACX,EAAE;SACC,OAAO,CACN;;;;;sCAK8B,CAC/B;SACA,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;SACrG,eAAe,CACnB,IAAI,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAE,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAM,EAAE,IAAY;IACnD,OAAO,EAAE,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC,GAAG,CAAC,IAAI,CAA8B,CAAC;AAC9G,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAM;IACpC,OAAO,EAAE,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC,GAAG,EAAqB,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAM,EAAE,IAAY;IACnD,OAAO,EAAE,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;AAC3F,CAAC;AAUD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAM,EACN,MAAqB,EACrB,IAAY,EACZ,OAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,IAAI,MAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAqB,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACjH,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;IAChD,MAAM,YAAY,GAAiB;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,IAAI;QACrD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,KAAK;QACxC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG;KAC3B,CAAC;IAEF,MAAM,KAAK,GAAe,MAAM,CAAC,KAAK;QACpC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAClG,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE;YACX,OAAO,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO;YAC/D,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,KAAK,EAAE,YAAY,CAAC,KAAK;YACzB,KAAK,EAAE,YAAY,CAAC,KAAK;SAC1B,CAAC,CAAC;IAEP,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACtD,EAAE,CAAC,OAAO,CAAC,8DAA8D,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAC5F,CAAC;IAED,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAClB,EAAE,CAAC,OAAO,CAAC,6DAA6D,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,iGAAiG,CAClG,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QAC3F,EAAE,CAAC,OAAO,CAAC,2EAA2E,CAAC,CAAC,GAAG,CACzF,MAAM,EAAE,EACR,UAAU,CAAC,EAAE,CACd,CAAC;IACJ,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAM,EAAE,IAAY,EAAE,KAAK,GAAG,EAAE;IAChE,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,EAAE;SACN,OAAO,CACN;;;oCAG8B,CAC/B;SACA,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAe,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,EAAM,EAAE,YAAoB;IAC/C,OACE,EAAE,CAAC,OAAO,CAAC,2EAA2E,CAAC,CAAC,GAAG,CAAC,YAAY,CAGzG,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/memory/embed.js

@@ -0,0 +1,81 @@
+/**
+ * Local semantic vectors (ADR-03).
+ *
+ * `local-hash-v1` is a dependency-free hashed bag of tokens and character
+ * 4-grams, L2-normalised, compared by cosine. The n-grams are what make it more
+ * than keyword matching: `migrations`, `migration` and `migrating` land in
+ * overlapping buckets, and so do typos. It does *not* know that `cookie` and
+ * `session token` are related — that needs a trained model, and the manual says
+ * so rather than calling this neural parity.
+ *
+ * Every vector stores the embedder that produced it, because comparing a
+ * hashed vector with a provider embedding is meaningless arithmetic.
+ */
+export const LOCAL_EMBEDDER = 'local-hash-v1';
+export const LOCAL_DIM = 256;
+function fnv1a(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193) >>> 0;
+    }
+    return h >>> 0;
+}
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}_]+/u)
+        .filter((t) => t.length > 1);
+}
+export function embedLocal(text, dim = LOCAL_DIM) {
+    const vec = new Float32Array(dim);
+    const tokens = tokenize(text);
+    for (const token of tokens) {
+        vec[fnv1a(token) % dim] += 1;
+        // Character n-grams, weighted lower: they generalise over morphology but
+        // are noisier than the whole token, so they should not outvote it.
+        const padded = `^${token}$`;
+        for (let i = 0; i + 4 <= padded.length; i++) {
+            vec[fnv1a(padded.slice(i, i + 4)) % dim] += 0.35;
+        }
+    }
+    // Sublinear damping, as TF-IDF does: a word repeated twenty times is not
+    // twenty times more about the document than a word used once. `log1p` rather
+    // than `1 + log`, which goes negative below 1 -- a single n-gram hit weighs
+    // 0.35, and a negative weight makes two related documents score as opposites.
+    for (let i = 0; i < dim; i++) {
+        const v = vec[i];
+        if (v > 0)
+            vec[i] = Math.log1p(v);
+    }
+    return normalise(vec);
+}
+export function normalise(vec) {
+    let sum = 0;
+    for (const v of vec)
+        sum += v * v;
+    const norm = Math.sqrt(sum);
+    if (norm === 0)
+        return vec;
+    for (let i = 0; i < vec.length; i++)
+        vec[i] = vec[i] / norm;
+    return vec;
+}
+/** Both arguments must already be normalised, which `embedLocal` guarantees. */
+export function cosine(a, b) {
+    const n = Math.min(a.length, b.length);
+    let dot = 0;
+    for (let i = 0; i < n; i++)
+        dot += a[i] * b[i];
+    return dot;
+}
+export function toBlob(vec) {
+    return Buffer.from(vec.buffer, vec.byteOffset, vec.byteLength);
+}
+export function fromBlob(blob) {
+    // Copy rather than view: better-sqlite3's buffer is not guaranteed aligned
+    // for Float32Array, and an unaligned view throws.
+    const copy = Buffer.from(blob);
+    return new Float32Array(copy.buffer, copy.byteOffset, copy.byteLength / 4);
+}
+//# sourceMappingURL=embed.js.map

package/dist/memory/embed.js.map

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

package/dist/memory/hosts.js

@@ -0,0 +1,71 @@
+/**
+ * Host capability descriptors (PRD CAP-01, EXT-01; ADR-06).
+ *
+ * The rule this file enforces is "record capabilities rather than fabricate
+ * missing events". A host that cannot tell us a tool failed must not have a
+ * memory that quietly implies every tool succeeded, and a host nobody has run
+ * a fixture through must not be advertised as supported.
+ *
+ * `status` is the honest axis. `proven` means there is a transcript fixture and
+ * a passing test in this repository. `unverified` means the adapter is written
+ * from documentation and nobody has run it. Nothing is listed here that has no
+ * adapter at all — the parity ledger tracks those.
+ */
+export const HOSTS = {
+    'claude-code': {
+        id: 'claude-code',
+        label: 'Claude Code',
+        status: 'proven',
+        hooks: true,
+        transcripts: true,
+        toolOutcomes: true,
+        agentIdentity: true,
+        humanDisplay: true,
+        modelContext: true,
+    },
+    cursor: {
+        id: 'cursor',
+        label: 'Cursor',
+        status: 'unverified',
+        hooks: false,
+        transcripts: false,
+        toolOutcomes: false,
+        agentIdentity: false,
+        humanDisplay: false,
+        // The MCP server works, so explicit tool calls are captured. Nothing else
+        // is: with no hooks there is no seam to capture a prompt or an edit at.
+        modelContext: false,
+        notes: 'MCP tools only. No hooks, so nothing is captured that the model does not explicitly log.',
+    },
+    cowork: {
+        id: 'cowork',
+        label: 'Claude Cowork',
+        status: 'unverified',
+        hooks: true,
+        transcripts: false,
+        toolOutcomes: true,
+        agentIdentity: true,
+        humanDisplay: true,
+        modelContext: true,
+        notes: 'No git commits, so the commit gate never fires there; `surface.ts` already says so at session start.',
+    },
+};
+export function capabilitiesOf(host) {
+    return (HOSTS[host ?? 'claude-code'] ?? {
+        id: host ?? 'unknown',
+        label: host ?? 'unknown host',
+        status: 'unverified',
+        hooks: false,
+        transcripts: false,
+        toolOutcomes: false,
+        agentIdentity: false,
+        humanDisplay: false,
+        modelContext: false,
+        notes: 'Unrecognised host: assume nothing is delivered that was not explicitly logged.',
+    });
+}
+/** The hosts an install may honestly claim to support today. */
+export function provenHosts() {
+    return Object.values(HOSTS).filter((h) => h.status === 'proven');
+}
+//# sourceMappingURL=hosts.js.map

package/dist/memory/hosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.js","sourceRoot":"","sources":["../../src/memory/hosts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH,MAAM,CAAC,MAAM,KAAK,GAAqC;IACrD,aAAa,EAAE;QACb,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;QACnB,0EAA0E;QAC1E,wEAAwE;QACxE,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,0FAA0F;KAClG;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,sGAAsG;KAC9G;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAA+B;IAC5D,OAAO,CACL,KAAK,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI;QAC9B,EAAE,EAAE,IAAI,IAAI,SAAS;QACrB,KAAK,EAAE,IAAI,IAAI,cAAc;QAC7B,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,KAAK;QACpB,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,gFAAgF;KACxF,CACF,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;AACnE,CAAC"}