elepha 0.1.0

package/dist/summarizer/rollup-provider.js

@@ -0,0 +1,224 @@
+// Haiku-backed session rollup generation. Same defensive-parsing contract as
+// the per-turn summarizer (see haiku-provider.ts): the model wraps JSON in
+// markdown fences regardless of instructions, so output is extracted, not
+// trusted.
+import Anthropic from '@anthropic-ai/sdk';
+import { z } from 'zod';
+import { DECISION_PROVENANCE_OVERLAP_THRESHOLD, DEFAULT_ANTHROPIC_MODEL, ROLLUP_MAX_TOKENS, ROLLUP_RETRY_MAX_TOKENS, } from '../config/constants.js';
+import { callAnthropicJson, extractJsonCandidate } from './anthropic-call.js';
+import { SummarizerCallLog } from './call-log.js';
+import { cacheableSystemPrompt } from './prompt-cache.js';
+import { buildRollupMergeUserContent, buildRollupUserContent, ROLLUP_MERGE_SYSTEM_PROMPT, ROLLUP_SYSTEM_PROMPT, } from './rollup-prompt.js';
+/**
+ * `turn_index` arrives as a STRING from this model - `"turn_index": "0"` -
+ * despite the prompt asking for a number, in fixed-sampling runs, reproducibly.
+ *
+ * The first version of this field was `z.number().int().optional()`, whose
+ * comment claimed optionality meant "a model that ignores the instruction
+ * still parses". It does not: `optional()` tolerates an ABSENT key, not a
+ * wrong-typed one, so every rollup failed to parse and a rebuild died on
+ * its first three sessions. Textbook instance of this codebase's own
+ * "format instructions in a prompt are a suggestion, not a contract" - added
+ * while fixing a different instance of the same rule.
+ */
+function coerceTurnIndex(value) {
+    if (typeof value === 'number' && Number.isInteger(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && /^-?\d+$/.test(value.trim())) {
+        return Number(value.trim());
+    }
+    return undefined;
+}
+/**
+ * One decision, or undefined if it is unusable.
+ *
+ * Nothing here can fail the enclosing rollup. A malformed or hollow decision
+ * costs that decision; it must never cost the title, the summary, the pending
+ * items and every other decision in the session, which is what a strict
+ * element schema inside `z.array()` does.
+ */
+function coerceDecision(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return undefined;
+    }
+    const rec = raw;
+    const what = typeof rec.what === 'string' ? rec.what.trim() : '';
+    // A decision with no reason is dropped, per the prompt contract ("omit
+    // that decision entirely rather than emitting a hollow one"). Counted and
+    // reported by the caller rather than dropped silently - see
+    // RollupResult.droppedDecisions.
+    const why = typeof rec.why === 'string' ? rec.why.trim() : '';
+    if (what === '' || why === '') {
+        return undefined;
+    }
+    return { what, why, turn_index: coerceTurnIndex(rec.turn_index) };
+}
+const rollupSchema = z.object({
+    title: z.string().min(1),
+    summary: z.string().min(1),
+    decisions: z.array(z.unknown()),
+    pending_items: z.array(z.unknown()),
+});
+const EMPTY_ROLLUP = { title: '', summary: '', decisions: [], pending_items: [], droppedDecisions: 0 };
+function tryParse(candidate) {
+    try {
+        const result = rollupSchema.safeParse(JSON.parse(candidate));
+        if (!result.success) {
+            return undefined;
+        }
+        const decisions = [];
+        let droppedDecisions = 0;
+        for (const raw of result.data.decisions) {
+            const decision = coerceDecision(raw);
+            if (decision) {
+                decisions.push(decision);
+            }
+            else {
+                droppedDecisions++;
+            }
+        }
+        return {
+            title: result.data.title,
+            summary: result.data.summary,
+            decisions,
+            pending_items: result.data.pending_items.filter((p) => typeof p === 'string' && p.trim() !== ''),
+            droppedDecisions,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function parseRollup(raw) {
+    for (const candidate of extractJsonCandidate(raw)) {
+        const parsed = tryParse(candidate);
+        if (parsed) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+const STOPWORDS = new Set('the a an to for and or with by as at is are was were be been it its this that from into use used using in on of'.split(' '));
+function tokens(s) {
+    return new Set(s
+        .toLowerCase()
+        .replace(/[^a-z0-9_./-]+/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length > 2 && !STOPWORDS.has(t)));
+}
+function overlap(a, b) {
+    if (a.size === 0 || b.size === 0) {
+        return 0;
+    }
+    let shared = 0;
+    for (const t of a) {
+        if (b.has(t)) {
+            shared++;
+        }
+    }
+    return shared / Math.min(a.size, b.size);
+}
+/**
+ * Assigns each returned decision a turn of origin, IN CODE.
+ *
+ * The prompt asks for `turn_index`, but the whole reason this exists is that
+ * the merge model does not reliably follow ordering instructions - trusting it
+ * to self-report provenance would rebuild the bug one level up. So:
+ *
+ *  1. Accept the model's `turn_index` only when it names a turn that was
+ *     actually in this batch. Anything else is discarded silently-as-data, not
+ *     silently-as-failure: the next steps still produce a value.
+ *  2. Otherwise, match the decision text against the batch's own per-turn
+ *     decision strings and take the best-overlapping turn.
+ *  3. Otherwise, fall back to the batch's LAST turn index. The decision came
+ *     out of this batch, so its true origin is somewhere in it; biasing the
+ *     fallback newest keeps an unplaceable decision visible in the brief
+ *     instead of sinking it to the bottom, which is the failure mode being
+ *     fixed. Over-attributing recency is recoverable; under-attributing it is
+ *     the bug.
+ */
+export function attributeDecisions(decisions, batch) {
+    if (batch.length === 0) {
+        return decisions.map((d) => ({ what: d.what, why: d.why }));
+    }
+    const byIndex = new Map(batch.map((t) => [t.turnIndex, t]));
+    const lastTurn = batch[batch.length - 1];
+    const turnTokens = batch.map((t) => ({ turn: t, toks: tokens(t.decisions.join(' ')) }));
+    return decisions.map((d) => {
+        const claimed = d.turn_index !== undefined ? byIndex.get(d.turn_index) : undefined;
+        if (claimed) {
+            return { what: d.what, why: d.why, turnIndex: claimed.turnIndex, at: claimed.startedAt };
+        }
+        const dt = tokens(d.what);
+        let best;
+        for (const candidate of turnTokens) {
+            const score = overlap(dt, candidate.toks);
+            if (score >= DECISION_PROVENANCE_OVERLAP_THRESHOLD && (best === undefined || score > best.score)) {
+                best = { turn: candidate.turn, score };
+            }
+        }
+        const resolved = best?.turn ?? lastTurn;
+        return { what: d.what, why: d.why, turnIndex: resolved.turnIndex, at: resolved.startedAt };
+    });
+}
+export class HaikuRollupProvider {
+    client;
+    model;
+    callLog;
+    constructor(options = {}) {
+        this.client = new Anthropic(options.apiKey ? { apiKey: options.apiKey } : {});
+        this.model = options.model ?? DEFAULT_ANTHROPIC_MODEL;
+        this.callLog = options.callLog ?? new SummarizerCallLog();
+    }
+    rollup(turns) {
+        if (turns.length === 0) {
+            return Promise.resolve({ output: EMPTY_ROLLUP, status: 'empty_turn' });
+        }
+        return this.call(ROLLUP_SYSTEM_PROMPT, buildRollupUserContent(turns));
+    }
+    merge(previous, newTurns) {
+        if (newTurns.length === 0) {
+            return Promise.resolve({ output: EMPTY_ROLLUP, status: 'empty_turn' });
+        }
+        return this.call(ROLLUP_MERGE_SYSTEM_PROMPT, buildRollupMergeUserContent(previous, newTurns));
+    }
+    /**
+     * One rollup request, retried ONCE at a larger output budget if the first
+     * attempt ran out of room mid-JSON.
+     *
+     * A same-budget retry risks the same truncation, so it is pure waste.
+     * The only thing worth changing is the budget - the input was never the
+     * problem. (A malformed-but-complete response is a different failure and
+     * is not retried here: rollups are recomputed from turn rows on the next
+     * pass, and the watermark deliberately does not advance on failure.)
+     */
+    async call(system, userContent) {
+        const first = await this.callOnce(system, userContent, ROLLUP_MAX_TOKENS, 1);
+        if (first.status === 'ok' || !first.truncated) {
+            return { output: first.output, status: first.status };
+        }
+        const retried = await this.callOnce(system, userContent, ROLLUP_RETRY_MAX_TOKENS, 2);
+        return { output: retried.output, status: retried.status };
+    }
+    async callOnce(system, userContent, maxTokens, attempt) {
+        // A session rollup is far larger than a per-turn summary: a 17-turn session
+        // produced enough decisions to blow straight through 1024 tokens and truncate
+        // mid-JSON, which surfaced only as an unexplained parse_error. Sized with
+        // headroom, and truncation is now reported distinctly rather than looking like
+        // a malformed response.
+        const result = await callAnthropicJson({
+            client: this.client,
+            model: this.model,
+            callLog: this.callLog,
+            system: cacheableSystemPrompt(system),
+            user: userContent,
+            maxTokens,
+            parse: parseRollup,
+            job: 'rollup_merge',
+            attempt,
+        });
+        return { output: result.output ?? EMPTY_ROLLUP, status: result.status, truncated: result.truncated };
+    }
+}
+//# sourceMappingURL=rollup-provider.js.map

package/dist/summarizer/rollup-provider.js.map

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

package/dist/types/index.js

@@ -0,0 +1,10 @@
+// Shared types: SessionTurn, ToolName, etc.
+export const TOOL_METADATA = {
+    'claude-code': { displayName: 'Claude Code' },
+    codex: { displayName: 'Codex' },
+};
+export const SUPPORTED_TOOLS = Object.keys(TOOL_METADATA);
+export function isToolName(value) {
+    return SUPPORTED_TOOLS.includes(value);
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAI5C,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,aAAa,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE;IAC7C,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;CACzB,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAe,CAAC;AAExE,MAAM,UAAU,UAAU,CAAC,KAAc;IACrC,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAiB,CAAC,CAAC;AACvD,CAAC"}

package/dist/util/error.js

@@ -0,0 +1,5 @@
+/** Returns a display-safe message from an unknown thrown value. */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=error.js.map

package/dist/util/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/util/error.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/util/fs.js

@@ -0,0 +1,97 @@
+import { randomUUID } from 'node:crypto';
+import { chmodSync, copyFileSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { PRIVATE_DIR_MODE } from '../config/constants.js';
+/** Creates a directory and ensures it is private even when it already existed. */
+export function ensurePrivateDir(dir) {
+    mkdirSync(dir, { recursive: true });
+    chmodSync(dir, PRIVATE_DIR_MODE);
+}
+/** Creates missing directories and hardens only the directories created by this call. */
+export function ensureCreatedDirsPrivate(dir) {
+    const firstCreated = mkdirSync(dir, { recursive: true });
+    if (firstCreated === undefined) {
+        return;
+    }
+    const firstCreatedPath = path.resolve(firstCreated);
+    let current = path.resolve(dir);
+    while (true) {
+        chmodSync(current, PRIVATE_DIR_MODE);
+        if (current === firstCreatedPath) {
+            return;
+        }
+        current = path.dirname(current);
+    }
+}
+/** Applies a restrictive mode to an already-written private file. */
+export function setPrivateFileMode(file, mode) {
+    chmodSync(file, mode);
+}
+/** Atomically replace a file without replacing a symlink that points at it. */
+export function atomicWrite(file, text, mode) {
+    const target = (() => {
+        try {
+            return lstatSync(file).isSymbolicLink() ? realpathSync(file) : file;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return file;
+            }
+            throw error;
+        }
+    })();
+    mkdirSync(path.dirname(target), { recursive: true });
+    const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
+    writeFileSync(temporary, text, { mode });
+    renameSync(temporary, target);
+    chmodSync(target, mode);
+}
+/** Atomically replaces a file with a byte-for-byte private copy without treating binary data as text. */
+export function atomicCopyPrivateFile(source, destination, mode) {
+    const target = (() => {
+        try {
+            return lstatSync(destination).isSymbolicLink() ? realpathSync(destination) : destination;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return destination;
+            }
+            throw error;
+        }
+    })();
+    ensurePrivateDir(path.dirname(target));
+    const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
+    copyFileSync(source, temporary);
+    chmodSync(temporary, mode);
+    renameSync(temporary, target);
+    chmodSync(target, mode);
+}
+/** Read JSON only when the complete file can be read and parsed. */
+export function readJson(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Create the parent directory and write a newline-terminated JSON file. */
+export function writeJson(file, value, mode) {
+    mkdirSync(path.dirname(file), { recursive: true });
+    writeFileSync(file, `${JSON.stringify(value)}\n`, { mode });
+}
+/** Lists regular files without turning a missing optional directory into an error. */
+export function listRegularFiles(directory) {
+    try {
+        return readdirSync(directory, { withFileTypes: true })
+            .filter((entry) => entry.isFile())
+            .map((entry) => path.join(directory, entry.name));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/util/fs.js.map

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

package/dist/util/relative-time.js

@@ -0,0 +1,12 @@
+import { DAY_MS } from '../config/constants.js';
+export function relativeTime(iso, now) {
+    const age = Math.max(0, now - Date.parse(iso));
+    if (age < 60 * 60 * 1000) {
+        return `${Math.floor(age / 60000)}m ago`;
+    }
+    if (age < DAY_MS) {
+        return `${Math.floor(age / (60 * 60 * 1000))}h ago`;
+    }
+    return `${Math.floor(age / DAY_MS)}d ago`;
+}
+//# sourceMappingURL=relative-time.js.map

package/dist/util/relative-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-time.js","sourceRoot":"","sources":["../../src/util/relative-time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,GAAW;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,IAAI,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACvB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;IAC7C,CAAC;IACD,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;QACf,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;AAC9C,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+    "name": "elepha",
+    "version": "0.1.0",
+    "description": "Local memory layer for developers switching between AI coding CLIs",
+    "keywords": [
+        "claude-code",
+        "codex",
+        "coding-agent",
+        "ai-memory",
+        "agent-memory",
+        "agent-memory",
+        "session-memory",
+        "session-history",
+        "context-management",
+        "developer-tools",
+        "cli",
+        "local-first"
+    ],
+    "homepage": "https://github.com/elepha-app/elepha#readme",
+    "bugs": {
+        "url": "https://github.com/elepha-app/elepha/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/elepha-app/elepha.git"
+    },
+    "license": "MPL-2.0",
+    "type": "module",
+    "bin": {
+        "elepha": "./bin/elepha.js"
+    },
+    "files": [
+        "dist",
+        "bin"
+    ],
+    "engines": {
+        "node": ">=22"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "prepublishOnly": "npm run build",
+        "build": "tsc -p tsconfig.json",
+        "dev": "tsx watch src/cli/index.ts",
+        "start": "node dist/cli/index.js",
+        "test": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
+        "changeset": "changeset",
+        "release": "changeset version && changeset publish",
+        "format-lint": "biome check --write .",
+        "format:check": "biome check ."
+    },
+    "dependencies": {
+        "@anthropic-ai/sdk": "^0.122.0",
+        "@clack/prompts": "^1.7.0",
+        "@modelcontextprotocol/sdk": "^1.30.0",
+        "better-sqlite3": "^13.0.3",
+        "chokidar": "^5.0.0",
+        "commander": "^15.0.0",
+        "smol-toml": "^1.8.0",
+        "zod": "^4.5.2"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "2.5.11",
+        "@changesets/cli": "^3.0.1",
+        "@commitlint/cli": "^21.2.2",
+        "@commitlint/config-conventional": "^21.2.2",
+        "@types/better-sqlite3": "^9.6.0",
+        "@types/node": "^26.4.0",
+        "tsx": "^4.23.12",
+        "typescript": "^7.0.2",
+        "vitest": "^4.1.11"
+    },
+    "allowScripts": {
+        "better-sqlite3@13.0.3": true,
+        "esbuild@0.28.2": true,
+        "fsevents@2.3.3": true
+    }
+}