somtum 0.1.2

package/dist/cli/search.d.ts

@@ -0,0 +1,16 @@
+import type { RetrievalResult } from '../core/retriever/types.js';
+export declare function runSearch(opts: {
+    query: string;
+    k?: number;
+    strategy?: string;
+    cwd?: string;
+    dbPath?: string;
+    projectId?: string;
+}): Promise<RetrievalResult[]>;
+export declare function searchCommand(query: string, options?: {
+    strategy?: string;
+    k?: number;
+    json?: boolean;
+    cwd?: string;
+}): Promise<number>;
+//# sourceMappingURL=search.d.ts.map

package/dist/cli/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/cli/search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AASlE,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAuB7B;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,OAAO,CAAC,MAAM,CAAC,CAkCjB"}

package/dist/cli/search.js

@@ -0,0 +1,62 @@
+import { join } from 'node:path';
+import { openDb } from '../core/db.js';
+import { resolveProjectId } from '../core/project_id.js';
+import { loadConfig, projectDir } from '../config.js';
+import { makeRetriever } from '../core/retriever/factory.js';
+import { RetrievalStrategy as RetrievalStrategyEnum } from '../core/schema.js';
+function snippet(body, max = 160) {
+    const single = body.replace(/\s+/g, ' ').trim();
+    return single.length <= max ? single : `${single.slice(0, max - 1)}…`;
+}
+export async function runSearch(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const config = loadConfig({ cwd });
+    const k = opts.k ?? config.retrieval.k;
+    const projectId = opts.projectId ?? resolveProjectId(cwd);
+    const dbPath = opts.dbPath ?? join(projectDir(projectId), 'db.sqlite');
+    // Resolve strategy: prefer explicit arg → config default
+    const strategyRaw = opts.strategy ?? config.retrieval.strategy;
+    const strategyParsed = RetrievalStrategyEnum.safeParse(strategyRaw);
+    const strategy = strategyParsed.success ? strategyParsed.data : 'bm25';
+    if (strategyParsed.success && strategyRaw !== strategy) {
+        console.warn(`[somtum] unknown strategy "${strategyRaw}", falling back to bm25`);
+    }
+    const db = openDb({ path: dbPath });
+    try {
+        const retriever = makeRetriever(strategy, db, config);
+        return await retriever.search(opts.query, { k, projectId });
+    }
+    finally {
+        db.close();
+    }
+}
+export async function searchCommand(query, options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const searchOpts = { query, cwd };
+    if (options.k !== undefined)
+        searchOpts.k = options.k;
+    if (options.strategy !== undefined)
+        searchOpts.strategy = options.strategy;
+    const results = await runSearch(searchOpts);
+    if (options.json) {
+        console.log(JSON.stringify(results.map((r) => ({
+            id: r.id,
+            score: r.score,
+            source: r.source,
+            title: r.observation.title,
+            kind: r.observation.kind,
+            files: r.observation.files,
+        })), null, 2));
+        return 0;
+    }
+    if (results.length === 0) {
+        console.log('no matches');
+        return 0;
+    }
+    for (const r of results) {
+        console.log(`${r.id}  [${r.observation.kind}] ${r.observation.title}  (${r.source}: ${r.score.toFixed(3)})`);
+        console.log(`  ${snippet(r.observation.body)}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=search.js.map

package/dist/cli/search.js.map

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

package/dist/cli/show.d.ts

@@ -0,0 +1,12 @@
+import type { Observation } from '../core/schema.js';
+export declare function runShow(opts: {
+    id: string;
+    cwd?: string;
+    dbPath?: string;
+    projectId?: string;
+}): Observation | null;
+export declare function showCommand(id: string, options?: {
+    json?: boolean;
+    cwd?: string;
+}): number;
+//# sourceMappingURL=show.d.ts.map

package/dist/cli/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../src/cli/show.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,WAAW,GAAG,IAAI,CAWrB;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA4B9F"}

package/dist/cli/show.js

@@ -0,0 +1,49 @@
+import { join } from 'node:path';
+import { openDb } from '../core/db.js';
+import { MemoryStore } from '../core/store.js';
+import { resolveProjectId } from '../core/project_id.js';
+import { projectDir } from '../config.js';
+export function runShow(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const projectId = opts.projectId ?? resolveProjectId(cwd);
+    const dbPath = opts.dbPath ?? join(projectDir(projectId), 'db.sqlite');
+    const db = openDb({ path: dbPath });
+    try {
+        const store = new MemoryStore(db);
+        return store.get(opts.id);
+    }
+    finally {
+        db.close();
+    }
+}
+export function showCommand(id, options = {}) {
+    const obs = runShow({ id, cwd: options.cwd ?? process.cwd() });
+    if (!obs) {
+        console.error(`no observation with id ${id}`);
+        return 1;
+    }
+    if (options.json) {
+        // embedding is a Buffer; serialize length not contents
+        const { embedding, ...rest } = obs;
+        const serializable = { ...rest, embedding_bytes: embedding ? embedding.length : null };
+        console.log(JSON.stringify(serializable, null, 2));
+        return 0;
+    }
+    console.log(`id:         ${obs.id}`);
+    console.log(`project:    ${obs.project_id}`);
+    console.log(`session:    ${obs.session_id}`);
+    console.log(`kind:       ${obs.kind}`);
+    console.log(`created:    ${new Date(obs.created_at).toISOString()}`);
+    if (obs.files.length > 0)
+        console.log(`files:      ${obs.files.join(', ')}`);
+    if (obs.tags.length > 0)
+        console.log(`tags:       ${obs.tags.join(', ')}`);
+    console.log(`saved est:  ${obs.tokens_saved} tokens`);
+    console.log(`spent est:  ${obs.tokens_spent} tokens`);
+    console.log('');
+    console.log(`# ${obs.title}`);
+    console.log('');
+    console.log(obs.body);
+    return 0;
+}
+//# sourceMappingURL=show.js.map

package/dist/cli/show.js.map

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

package/dist/cli/stats.d.ts

@@ -0,0 +1,27 @@
+export interface StatsSnapshot {
+    project_id: string;
+    memories: number;
+    by_kind: Record<string, number>;
+    cache_entries: number;
+    cache_hits: number;
+    cache_misses: number;
+    cache_hit_rate: number | null;
+    retrieval_by_strategy: Array<{
+        strategy: string;
+        call_count: number;
+    }>;
+    tokens_saved_estimated: number;
+    tokens_spent_estimated: number;
+    net_estimated: number;
+    breakeven_ratio_estimated: number | null;
+}
+export declare function collectStats(opts?: {
+    cwd?: string;
+    dbPath?: string;
+    projectId?: string;
+}): StatsSnapshot;
+export declare function statsCommand(options?: {
+    json?: boolean;
+    cwd?: string;
+}): number;
+//# sourceMappingURL=stats.d.ts.map

package/dist/cli/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cli/stats.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qBAAqB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,CA8B5G;AAiCD,wBAAgB,YAAY,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAQnF"}

package/dist/cli/stats.js

@@ -0,0 +1,80 @@
+import { join } from 'node:path';
+import { openDb } from '../core/db.js';
+import { MemoryStore } from '../core/store.js';
+import { PromptCache } from '../core/cache.js';
+import { RetrievalStatsStore } from '../core/retrieval_stats.js';
+import { resolveProjectId } from '../core/project_id.js';
+import { projectDir } from '../config.js';
+export function collectStats(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const projectId = opts.projectId ?? resolveProjectId(cwd);
+    const dbPath = opts.dbPath ?? join(projectDir(projectId), 'db.sqlite');
+    const db = openDb({ path: dbPath });
+    try {
+        const store = new MemoryStore(db);
+        const cache = new PromptCache(db);
+        const statsStore = new RetrievalStatsStore(db);
+        const saved = store.totalTokensSaved(projectId);
+        const spent = store.totalTokensSpent(projectId);
+        const cacheHits = statsStore.getCacheHitSummary(projectId);
+        const retrievalBreakdown = statsStore.getRetrievalBreakdown(projectId);
+        return {
+            project_id: projectId,
+            memories: store.countByProject(projectId),
+            by_kind: store.countByKind(projectId),
+            cache_entries: cache.count(),
+            cache_hits: cacheHits.hit_count,
+            cache_misses: cacheHits.miss_count,
+            cache_hit_rate: cacheHits.hit_rate,
+            retrieval_by_strategy: retrievalBreakdown,
+            tokens_saved_estimated: saved,
+            tokens_spent_estimated: spent,
+            net_estimated: saved - spent,
+            breakeven_ratio_estimated: spent > 0 ? Number((saved / spent).toFixed(2)) : null,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+function printHuman(s) {
+    console.log(`project        ${s.project_id}`);
+    console.log(`memories       ${s.memories}`);
+    for (const [k, n] of Object.entries(s.by_kind)) {
+        if (n > 0)
+            console.log(`  ${k.padEnd(15)} ${n}`);
+    }
+    console.log(`cache entries  ${s.cache_entries}`);
+    console.log(`cache hits     ${s.cache_hits}`);
+    console.log(`cache misses   ${s.cache_misses}`);
+    const hitRate = s.cache_hit_rate !== null ? `${(s.cache_hit_rate * 100).toFixed(1)}%` : 'n/a';
+    console.log(`cache hit rate ${hitRate}`);
+    if (s.retrieval_by_strategy.length > 0) {
+        console.log(`retrieval calls by strategy:`);
+        for (const r of s.retrieval_by_strategy) {
+            console.log(`  ${r.strategy.padEnd(12)} ${r.call_count}`);
+        }
+    }
+    console.log(`tokens saved   ${s.tokens_saved_estimated} (estimated)`);
+    console.log(`tokens spent   ${s.tokens_spent_estimated} (estimated)`);
+    console.log(`net            ${s.net_estimated} (estimated)`);
+    const br = s.breakeven_ratio_estimated;
+    if (br !== null) {
+        const warn = br < 1.5 ? '  — below 1.5x, check `somtum doctor`' : '';
+        console.log(`breakeven      ${br}x (estimated)${warn}`);
+    }
+    else {
+        console.log(`breakeven      n/a (no extraction cost recorded yet)`);
+    }
+}
+export function statsCommand(options = {}) {
+    const snap = collectStats({ cwd: options.cwd ?? process.cwd() });
+    if (options.json) {
+        console.log(JSON.stringify(snap, null, 2));
+    }
+    else {
+        printHuman(snap);
+    }
+    return 0;
+}
+//# sourceMappingURL=stats.js.map

package/dist/cli/stats.js.map

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

package/dist/cli/sync.d.ts

@@ -0,0 +1,18 @@
+export interface SyncResult {
+    direction: 'push' | 'pull' | 'status';
+    local_count: number;
+    remote_count: number | null;
+    transferred: number;
+    remote: string;
+}
+export declare function runSync(opts: {
+    direction: 'push' | 'pull' | 'status';
+    cwd?: string;
+    remote?: string;
+}): Promise<SyncResult>;
+export declare function syncCommand(direction: 'push' | 'pull' | 'status', options?: {
+    remote?: string;
+    json?: boolean;
+    cwd?: string;
+}): Promise<number>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cli/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0EtB;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,EACrC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9D,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/cli/sync.js

@@ -0,0 +1,138 @@
+// SSH-based push/pull sync (M6). Transfers observations as JSONL so we can
+// merge rather than overwrite. Conflict rule: if the same ULID already exists
+// locally the remote copy is skipped (ULIDs are unique across machines).
+// Relies on `scp` being available in PATH.
+import { execFileSync, execSync } from 'node:child_process';
+import { unlinkSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { openDb } from '../core/db.js';
+import { resolveProjectId } from '../core/project_id.js';
+import { loadConfig, projectDir } from '../config.js';
+import { runExport } from './export.js';
+import { runImport } from './import.js';
+// Parses "user@host:/remote/path" or "host:/remote/path"
+function parseRemote(remote) {
+    const colonIdx = remote.indexOf(':');
+    if (colonIdx === -1)
+        throw new Error(`invalid sync.remote: "${remote}". Expected user@host:/path`);
+    return { userHost: remote.slice(0, colonIdx), path: remote.slice(colonIdx + 1) };
+}
+function scpTo(localPath, remote) {
+    execFileSync('scp', ['-q', localPath, remote], { stdio: ['ignore', 'ignore', 'pipe'] });
+}
+function scpFrom(remote, localPath) {
+    execFileSync('scp', ['-q', remote, localPath], { stdio: ['ignore', 'ignore', 'pipe'] });
+}
+function remoteCount(userHost, remotePath) {
+    try {
+        const out = execSync(`ssh -o BatchMode=yes -o ConnectTimeout=5 ${userHost} "wc -l < '${remotePath}' 2>/dev/null || echo 0"`, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        return Number.parseInt(out.trim(), 10);
+    }
+    catch {
+        return null;
+    }
+}
+export async function runSync(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const config = loadConfig({ cwd });
+    const projectId = resolveProjectId(cwd);
+    const dbPath = join(projectDir(projectId), 'db.sqlite');
+    const remote = opts.remote ?? config.sync.remote;
+    if (!remote) {
+        throw new Error('sync.remote is not configured. Set it via `somtum config set sync.remote "user@host:/path/.somtum/projects/<id>"`');
+    }
+    const { userHost, path: remotePath } = parseRemote(remote);
+    const remoteJsonl = `${remotePath}/observations.jsonl`;
+    const localJsonl = join(projectDir(projectId), 'observations.jsonl');
+    const db = openDb({ path: dbPath });
+    let localCount;
+    try {
+        const { MemoryStore } = await import('../core/store.js');
+        localCount = new MemoryStore(db).countByProject(projectId);
+    }
+    finally {
+        db.close();
+    }
+    if (opts.direction === 'status') {
+        const remoteLineCount = remoteCount(userHost, remoteJsonl);
+        return {
+            direction: 'status',
+            local_count: localCount,
+            remote_count: remoteLineCount,
+            transferred: 0,
+            remote,
+        };
+    }
+    if (opts.direction === 'push') {
+        // Export local observations to JSONL then scp to remote.
+        runExport({ format: 'jsonl', output: localJsonl, cwd });
+        try {
+            // Ensure remote directory exists via SSH mkdir.
+            execSync(`ssh -o BatchMode=yes ${userHost} "mkdir -p '${remotePath}'"`, { stdio: ['ignore', 'ignore', 'pipe'] });
+            scpTo(localJsonl, `${userHost}:${remoteJsonl}`);
+        }
+        finally {
+            if (existsSync(localJsonl))
+                unlinkSync(localJsonl);
+        }
+        return {
+            direction: 'push',
+            local_count: localCount,
+            remote_count: localCount,
+            transferred: localCount,
+            remote,
+        };
+    }
+    // pull: copy remote JSONL locally and merge.
+    const tmpPath = join(tmpdir(), `somtum-pull-${projectId}.jsonl`);
+    try {
+        scpFrom(`${userHost}:${remoteJsonl}`, tmpPath);
+        const importResult = runImport({ input: tmpPath, format: 'jsonl', cwd });
+        return {
+            direction: 'pull',
+            local_count: localCount + importResult.imported,
+            remote_count: localCount + importResult.imported + importResult.skipped,
+            transferred: importResult.imported,
+            remote,
+        };
+    }
+    finally {
+        if (existsSync(tmpPath))
+            unlinkSync(tmpPath);
+    }
+}
+export async function syncCommand(direction, options = {}) {
+    let result;
+    try {
+        const syncOpts = {
+            direction,
+            cwd: options.cwd ?? process.cwd(),
+        };
+        if (options.remote !== undefined)
+            syncOpts.remote = options.remote;
+        result = await runSync(syncOpts);
+    }
+    catch (err) {
+        console.error(`sync error: ${err.message}`);
+        return 1;
+    }
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return 0;
+    }
+    if (direction === 'status') {
+        console.log(`local   ${result.local_count} observations`);
+        const remoteStr = result.remote_count !== null ? String(result.remote_count) : 'unreachable';
+        console.log(`remote  ${remoteStr} observation lines`);
+        console.log(`remote  ${result.remote}`);
+    }
+    else if (direction === 'push') {
+        console.log(`pushed ${result.transferred} observations to ${result.remote}`);
+    }
+    else {
+        console.log(`pulled ${result.transferred} new observations from ${result.remote}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/sync.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import { type Config } from './core/schema.js';
+export declare const GLOBAL_DIR: string;
+export declare const GLOBAL_CONFIG_PATH: string;
+export declare const PROJECT_CONFIG_RELATIVE: string;
+export interface LoadOptions {
+    cwd?: string;
+    global?: string;
+}
+export declare function loadConfig(options?: LoadOptions): Config;
+export declare function ensureGlobalDir(): string;
+export declare function projectDir(projectId: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,MAAM,EAAoB,MAAM,kBAAkB,CAAC;AAE/E,eAAO,MAAM,UAAU,QAA2D,CAAC;AACnF,eAAO,MAAM,kBAAkB,QAAkC,CAAC;AAClE,eAAO,MAAM,uBAAuB,QAAiC,CAAC;AA2BtE,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,WAAgB,GAAG,MAAM,CAS5D;AAED,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/config.js

@@ -0,0 +1,52 @@
+import { readFileSync, existsSync, mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { ConfigSchema } from './core/schema.js';
+export const GLOBAL_DIR = process.env['SOMTUM_HOME'] ?? join(homedir(), '.somtum');
+export const GLOBAL_CONFIG_PATH = join(GLOBAL_DIR, 'config.json');
+export const PROJECT_CONFIG_RELATIVE = join('.somtum', 'config.json');
+function readJsonIfExists(path) {
+    if (!existsSync(path))
+        return undefined;
+    const raw = readFileSync(path, 'utf8');
+    if (raw.trim() === '')
+        return undefined;
+    return JSON.parse(raw);
+}
+function deepMerge(base, over) {
+    if (over === undefined || over === null)
+        return base;
+    if (typeof base !== 'object' ||
+        base === null ||
+        Array.isArray(base) ||
+        typeof over !== 'object' ||
+        Array.isArray(over)) {
+        return over;
+    }
+    const out = { ...base };
+    for (const [k, v] of Object.entries(over)) {
+        out[k] = deepMerge(base[k], v);
+    }
+    return out;
+}
+export function loadConfig(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const globalPath = options.global ?? GLOBAL_CONFIG_PATH;
+    const globalRaw = (readJsonIfExists(globalPath) ?? {});
+    const projectRaw = (readJsonIfExists(join(cwd, PROJECT_CONFIG_RELATIVE)) ?? {});
+    const merged = deepMerge(globalRaw, projectRaw);
+    return ConfigSchema.parse(merged);
+}
+export function ensureGlobalDir() {
+    if (!existsSync(GLOBAL_DIR)) {
+        mkdirSync(GLOBAL_DIR, { recursive: true });
+    }
+    return GLOBAL_DIR;
+}
+export function projectDir(projectId) {
+    const dir = join(GLOBAL_DIR, 'projects', projectId);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    return dir;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/cache.d.ts

@@ -0,0 +1,29 @@
+import type { DB } from './db.js';
+import { type CacheEntry, type CacheEntryInput } from './schema.js';
+import { type Embedder } from './embeddings.js';
+export declare const CACHE_FINGERPRINT_VERSION = 1;
+export declare function normalizePrompt(prompt: string): string;
+export declare function hashPrompt(prompt: string): string;
+export declare class PromptCache {
+    private readonly db;
+    constructor(db: DB);
+    lookupByHash(promptHash: string): CacheEntry | null;
+    put(input: CacheEntryInput & {
+        prompt_embedding?: Buffer;
+    }): CacheEntry;
+    lookupFuzzy(prompt: string, embedder: Embedder, threshold: number): Promise<{
+        entry: CacheEntry;
+        similarity: number;
+    } | null>;
+    getById(id: string): CacheEntry | null;
+    setPromptEmbedding(id: string, v: Float32Array): void;
+    listMissingPromptEmbeddings(): {
+        id: string;
+        prompt_text: string;
+    }[];
+    recordFalseHit(id: string): void;
+    touch(id: string): void;
+    invalidate(id: string): void;
+    count(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAIzB,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAsC3C,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,EAAE;IAEnC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUnD,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;IA2CjE,WAAW,CACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA4B5D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAOtC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,IAAI;IAMrD,2BAA2B,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE;IASpE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMhC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQvB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,IAAI,MAAM;CAMhB"}