@samjurnio_/memento 0.2.0

package/dist/git.js

@@ -0,0 +1,172 @@
+import { execFile } from "node:child_process";
+import { createHash, randomBytes } from "node:crypto";
+import { rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+/**
+ * Git is the file-state transport (spec §3.2). All commands run through
+ * execFile with argv arrays — no shell, no injection surface. Snapshots are
+ * written to refs/memento/* via a TEMPORARY index so the user's real index,
+ * HEAD, and working tree are never touched.
+ */
+const execFileAsync = promisify(execFile);
+async function git(dir, args, env) {
+    const { stdout } = await execFileAsync("git", ["-C", dir, ...args], {
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+        env: env ?? process.env,
+    });
+    return stdout;
+}
+async function tryGit(dir, args) {
+    try {
+        return await git(dir, args);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Capture the workspace's git state for a packet. Returns undefined when the
+ * directory is not a git repository (packets allow workspace.git to be absent).
+ */
+export async function captureGitState(dir, options = {}) {
+    const inside = await tryGit(dir, ["rev-parse", "--is-inside-work-tree"]);
+    if (inside?.trim() !== "true") {
+        return undefined;
+    }
+    const remote = (await tryGit(dir, ["remote", "get-url", "origin"]))?.trim() ?? null;
+    const branch = (await tryGit(dir, ["rev-parse", "--abbrev-ref", "HEAD"]))?.trim() ?? null;
+    const headSha = (await tryGit(dir, ["rev-parse", "--short", "HEAD"]))?.trim() ?? null;
+    // .memento/ is excluded from dirty-state capture: writing the handoff
+    // artifacts must not make every subsequent verify report drift.
+    const rawPorcelain = (await tryGit(dir, ["status", "--porcelain=v1", "--", ":(exclude).memento"])) ?? "";
+    const porcelain = rawPorcelain
+        .split("\n")
+        .filter((line) => line.trim().length > 0 && !line.slice(3).trim().startsWith(".memento"))
+        .join("\n");
+    const diff = headSha
+        ? ((await tryGit(dir, ["diff", "HEAD", "--no-color", "--", ":(exclude).memento"])) ?? "")
+        : "";
+    const dirtyDigest = digestDirtyState(porcelain, diff);
+    const dirty = porcelain
+        .split("\n")
+        .filter((line) => line.trim().length > 0)
+        .map((line) => ({
+        path: line.slice(3).trim(),
+        state: describePorcelainCode(line.slice(0, 2)),
+    }));
+    let snapshotRef = null;
+    if (options.snapshotPacketId) {
+        snapshotRef = await snapshotWorkspace(dir, options.snapshotPacketId, headSha);
+    }
+    return { remote, branch, headSha, snapshotRef, dirtyDigest, dirty };
+}
+export function digestDirtyState(porcelain, diff) {
+    return `sha256:${createHash("sha256").update(`${porcelain}\n${diff}`).digest("hex").slice(0, 24)}`;
+}
+function describePorcelainCode(code) {
+    const map = {
+        "M": "modified",
+        "A": "added",
+        "D": "deleted",
+        "R": "renamed",
+        "C": "copied",
+        "U": "unmerged",
+        "?": "untracked",
+    };
+    const x = map[code[0] ?? " "] ?? "";
+    const y = map[code[1] ?? " "] ?? "";
+    return [x, y].filter(Boolean).join("+") || "changed";
+}
+/**
+ * Snapshot the FULL working tree (incl. uncommitted and untracked files) into
+ * a shadow commit at refs/memento/<packetId>. Uses GIT_INDEX_FILE so the user's
+ * staging area is untouched. Returns the ref name, or null on failure —
+ * snapshot failure must never block packet compilation.
+ */
+export async function snapshotWorkspace(dir, packetId, headSha) {
+    const tmpIndex = join(tmpdir(), `memento-index-${randomBytes(6).toString("hex")}`);
+    const env = { ...process.env, GIT_INDEX_FILE: tmpIndex };
+    try {
+        if (headSha) {
+            await git(dir, ["read-tree", "HEAD"], env);
+        }
+        await git(dir, ["add", "-A", "."], env);
+        const treeSha = (await git(dir, ["write-tree"], env)).trim();
+        const commitArgs = ["commit-tree", treeSha, "-m", `memento snapshot ${packetId}`];
+        if (headSha) {
+            commitArgs.push("-p", "HEAD");
+        }
+        const commitSha = (await git(dir, commitArgs, env)).trim();
+        const ref = `refs/memento/${packetId}`;
+        await git(dir, ["update-ref", ref, commitSha]);
+        return ref;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        rmSync(tmpIndex, { force: true });
+    }
+}
+/**
+ * The continuity check (spec §7.4): compare the live workspace against the
+ * git state recorded in a packet. Drift is surfaced, never auto-resolved.
+ */
+export async function verifyWorkspace(dir, expected) {
+    const current = await captureGitState(dir);
+    const drift = [];
+    if (!current) {
+        return { clean: false, drift: ["directory is not a git repository"] };
+    }
+    if (expected.headSha && current.headSha !== expected.headSha) {
+        drift.push(`HEAD moved: packet expects ${expected.headSha}, workspace is at ${current.headSha ?? "(none)"}`);
+    }
+    if (expected.branch && current.branch !== expected.branch) {
+        drift.push(`branch changed: packet expects "${expected.branch}", workspace is on "${current.branch ?? "(detached)"}"`);
+    }
+    if (current.dirtyDigest !== expected.dirtyDigest) {
+        const expectedPaths = new Set(expected.dirty.map((file) => file.path));
+        const currentPaths = new Set(current.dirty.map((file) => file.path));
+        const appeared = [...currentPaths].filter((path) => !expectedPaths.has(path));
+        const vanished = [...expectedPaths].filter((path) => !currentPaths.has(path));
+        drift.push("working-tree contents differ from capture (dirty digest mismatch)");
+        appeared.forEach((path) => drift.push(`  changed since capture: ${path}`));
+        vanished.forEach((path) => drift.push(`  no longer dirty: ${path}`));
+    }
+    return { clean: drift.length === 0, drift };
+}
+/** True if `ref` resolves in this repo (snapshots live only where captured). */
+export async function snapshotRefExists(dir, ref) {
+    return (await tryGit(dir, ["rev-parse", "--verify", "--quiet", ref])) !== null;
+}
+/**
+ * Materialize a packet's working-tree snapshot (refs/memento/<id>) back into
+ * `dir` — the receiving agent gets the prior agent's actual uncommitted AND
+ * untracked files, not just a description of them. This is what makes a memento
+ * carry executable state rather than notes.
+ *
+ * Uses a TEMPORARY index + checkout-index so the real index and HEAD are never
+ * touched. Existing files are overwritten (-f); files absent from the snapshot
+ * are left in place (non-deleting by design — restore is additive, never
+ * destructive to work the snapshot didn't know about).
+ */
+export async function restoreWorkspace(dir, snapshotRef) {
+    const tmpIndex = join(tmpdir(), `memento-restore-${randomBytes(6).toString("hex")}`);
+    const env = { ...process.env, GIT_INDEX_FILE: tmpIndex };
+    try {
+        await git(dir, ["read-tree", snapshotRef], env);
+        const files = (await git(dir, ["ls-files"], env))
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean);
+        await git(dir, ["checkout-index", "-a", "-f"], env);
+        return { files };
+    }
+    finally {
+        rmSync(tmpIndex, { force: true });
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/handoff.d.ts

@@ -0,0 +1,26 @@
+import { type WrittenArtifacts } from "./artifacts.js";
+import type { Packet } from "./packet.js";
+/**
+ * The one handoff path. CLI `compile`, the Claude hook, and the MCP
+ * `memento_handoff` tool all run through here, so every entry point gets
+ * identical behavior: adapter dispatch, session discovery, chain
+ * continuation, compilation, and artifact writing.
+ */
+export declare const AGENTS: readonly ["claude-code", "codex", "gemini-cli", "antigravity", "pi", "opencode"];
+export type AgentName = (typeof AGENTS)[number];
+export declare const REASONS: readonly ["context_exhaustion", "operator_switch", "session_end", "scheduled", "team_handoff"];
+export interface PerformHandoffOptions {
+    workspaceDir: string;
+    agent?: string;
+    transcript?: string;
+    reason?: Packet["packet"]["reason"];
+    taskId?: string;
+    noSnapshot?: boolean;
+}
+export interface HandoffResult {
+    packet: Packet;
+    artifacts: WrittenArtifacts;
+    transcriptPath: string;
+    eventCount: number;
+}
+export declare function performHandoff(options: PerformHandoffOptions): Promise<HandoffResult>;

package/dist/handoff.js

@@ -0,0 +1,80 @@
+import { existsSync } from "node:fs";
+import { latestClaudeTranscript, loadClaudeLedger } from "./adapters/claude-code.js";
+import { latestCodexRollout, loadCodexLedger } from "./adapters/codex.js";
+import { latestAntigravityConversation, loadAntigravityLedger } from "./adapters/antigravity.js";
+import { latestGeminiCheckpoint, loadGeminiLedger } from "./adapters/gemini.js";
+import { latestPiSession, loadPiLedger } from "./adapters/pi.js";
+import { latestOpencodeSession, loadOpencodeLedger } from "./adapters/opencode.js";
+import { chainFromPrior, writePacketArtifacts } from "./artifacts.js";
+import { compilePacket } from "./compile.js";
+/**
+ * The one handoff path. CLI `compile`, the Claude hook, and the MCP
+ * `memento_handoff` tool all run through here, so every entry point gets
+ * identical behavior: adapter dispatch, session discovery, chain
+ * continuation, compilation, and artifact writing.
+ */
+export const AGENTS = ["claude-code", "codex", "gemini-cli", "antigravity", "pi", "opencode"];
+export const REASONS = [
+    "context_exhaustion",
+    "operator_switch",
+    "session_end",
+    "scheduled",
+    "team_handoff",
+];
+export async function performHandoff(options) {
+    const agent = options.agent ?? "claude-code";
+    if (!AGENTS.includes(agent)) {
+        throw new Error(`Adapter "${agent}" is not implemented yet (${AGENTS.join(" | ")}).`);
+    }
+    const transcript = options.transcript ?? discoverSession(agent, options.workspaceDir);
+    if (!transcript || !existsSync(transcript)) {
+        throw new Error(`No ${agent} transcript found for ${options.workspaceDir} — pass one explicitly (--transcript / transcript).`);
+    }
+    const ledger = agent === "codex"
+        ? loadCodexLedger(transcript)
+        : agent === "gemini-cli"
+            ? loadGeminiLedger(transcript)
+            : agent === "antigravity"
+                ? loadAntigravityLedger(transcript)
+                : agent === "pi"
+                    ? loadPiLedger(transcript)
+                    : agent === "opencode"
+                        ? loadOpencodeLedger(transcript)
+                        : loadClaudeLedger(transcript);
+    if (ledger.events.length === 0) {
+        throw new Error(`Transcript ${transcript} contained no usable events.`);
+    }
+    // Continue the workspace's packet chain unless the caller pins a task.
+    const chain = options.taskId ? undefined : chainFromPrior(options.workspaceDir);
+    const packet = await compilePacket({
+        ledger,
+        workspaceDir: options.workspaceDir,
+        reason: options.reason ?? "operator_switch",
+        ...(options.taskId ? { taskId: options.taskId } : {}),
+        ...(chain ? { taskId: chain.taskId, parent: chain.parent, seq: chain.seq } : {}),
+        ...(options.noSnapshot ? { noSnapshot: true } : {}),
+    });
+    const artifacts = writePacketArtifacts(options.workspaceDir, packet);
+    return { packet, artifacts, transcriptPath: transcript, eventCount: ledger.events.length };
+}
+function discoverSession(agent, workspaceDir) {
+    switch (agent) {
+        case "codex":
+            return latestCodexRollout(workspaceDir);
+        // Gemini checkpoints carry no cwd, so discovery is global-newest,
+        // not workspace-scoped — see adapters/gemini.ts.
+        case "gemini-cli":
+            return latestGeminiCheckpoint();
+        case "antigravity":
+            return latestAntigravityConversation(workspaceDir);
+        case "pi":
+            return latestPiSession(workspaceDir);
+        // opencode sessions live in a global store with no cwd, so discovery is
+        // newest-session, not workspace-scoped — see adapters/opencode.ts.
+        case "opencode":
+            return latestOpencodeSession(workspaceDir);
+        default:
+            return latestClaudeTranscript(workspaceDir);
+    }
+}
+//# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,25 @@
+import type { Packet } from "./packet.js";
+export interface InstallResult {
+    settingsPath: string;
+    installed: string[];
+    skipped: string[];
+}
+export declare function installClaudeHooks(workspaceDir: string, command?: string): InstallResult;
+export interface CodexInstallResult {
+    configPath: string;
+    installed: boolean;
+}
+/**
+ * Register Memento as an MCP server in ~/.codex/config.toml so Codex can call
+ * memento_resume/memento_handoff natively. TOML is appended textually (no parser
+ * dependency): idempotent via a literal [mcp_servers.memento] check — the rest
+ * of the user's config is never rewritten.
+ */
+export declare function installCodexMcp(home?: string): CodexInstallResult;
+export interface HookOutcome {
+    ok: boolean;
+    message: string;
+    packet?: Packet;
+}
+export declare function handleHookPayload(payloadJson: string): Promise<HookOutcome>;
+export declare function readStdin(): Promise<string>;

package/dist/hooks.js

@@ -0,0 +1,114 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { performHandoff } from "./handoff.js";
+/**
+ * Claude Code lifecycle capture (spec §7.1/§7.2). Two pieces:
+ *
+ *  - installClaudeHooks: writes PreCompact + SessionEnd hooks into the
+ *    workspace's .claude/settings.json, each invoking `memento hook`.
+ *    PreCompact is the flagship trigger — it fires at the exact moment of
+ *    context pressure, which is when a continuation packet matters most.
+ *
+ *  - handleHookPayload: the receiving end. Claude Code pipes a JSON payload
+ *    (hook_event_name, transcript_path, cwd, …) to the hook command's stdin;
+ *    this compiles a packet from that exact transcript. It NEVER throws —
+ *    a broken hook must not break the user's session.
+ */
+const HOOK_EVENTS = ["PreCompact", "SessionEnd"];
+export function installClaudeHooks(workspaceDir, command = "memento hook") {
+    const dir = join(workspaceDir, ".claude");
+    const settingsPath = join(dir, "settings.json");
+    mkdirSync(dir, { recursive: true });
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+        }
+        catch {
+            throw new Error(`${settingsPath} is not valid JSON — fix or remove it first.`);
+        }
+    }
+    const hooks = (settings.hooks ?? {});
+    const installed = [];
+    const skipped = [];
+    for (const event of HOOK_EVENTS) {
+        const entries = hooks[event] ?? [];
+        const alreadyInstalled = entries.some((entry) => entry.hooks?.some((hook) => hook.command?.includes("memento")));
+        if (alreadyInstalled) {
+            skipped.push(event);
+            continue;
+        }
+        entries.push({ hooks: [{ type: "command", command }] });
+        hooks[event] = entries;
+        installed.push(event);
+    }
+    settings.hooks = hooks;
+    writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+    return { settingsPath, installed, skipped };
+}
+/**
+ * Register Memento as an MCP server in ~/.codex/config.toml so Codex can call
+ * memento_resume/memento_handoff natively. TOML is appended textually (no parser
+ * dependency): idempotent via a literal [mcp_servers.memento] check — the rest
+ * of the user's config is never rewritten.
+ */
+export function installCodexMcp(home = homedir()) {
+    const dir = join(home, ".codex");
+    const configPath = join(dir, "config.toml");
+    mkdirSync(dir, { recursive: true });
+    const existing = existsSync(configPath) ? readFileSync(configPath, "utf8") : "";
+    if (existing.includes("[mcp_servers.memento]")) {
+        return { configPath, installed: false };
+    }
+    const block = [
+        "",
+        "# Added by `memento install-hooks codex` — cross-agent session continuity.",
+        "[mcp_servers.memento]",
+        "command = \"memento\"",
+        "args = [\"mcp\"]",
+        "",
+    ].join("\n");
+    appendFileSync(configPath, existing.length > 0 && !existing.endsWith("\n") ? `\n${block}` : block);
+    return { configPath, installed: true };
+}
+const REASON_BY_EVENT = {
+    PreCompact: "context_exhaustion",
+    SessionEnd: "session_end",
+    Stop: "session_end",
+};
+export async function handleHookPayload(payloadJson) {
+    try {
+        const payload = JSON.parse(payloadJson);
+        const workspaceDir = payload.cwd ?? process.cwd();
+        const reason = REASON_BY_EVENT[payload.hook_event_name ?? ""] ?? "operator_switch";
+        const result = await performHandoff({
+            workspaceDir,
+            agent: "claude-code",
+            reason,
+            ...(payload.transcript_path && existsSync(payload.transcript_path)
+                ? { transcript: payload.transcript_path }
+                : {}),
+        });
+        return {
+            ok: true,
+            message: `memento hook: sealed ${result.packet.packet.id} (${reason}) → ${result.artifacts.markdownPath}`,
+            packet: result.packet,
+        };
+    }
+    catch (error) {
+        // Hooks run inside someone's live session: degrade, never disrupt.
+        return {
+            ok: false,
+            message: `memento hook: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+export async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,10 @@
+export declare function ulid(now?: number): string;
+export declare const newTaskId: () => string;
+export declare const newPacketId: () => string;
+export declare const newSessionId: () => string;
+/**
+ * Workspace identity (spec §5.1): hash of the git remote URL when one exists,
+ * else the absolute repo path. Remote-derived ids are stable across machines,
+ * which is what makes team handoff addressable.
+ */
+export declare function workspaceId(seed: string): string;

package/dist/ids.js

@@ -0,0 +1,32 @@
+import { createHash, randomBytes } from "node:crypto";
+/**
+ * ULID-style identifiers: 10 chars of Crockford-base32 time + 16 chars of
+ * randomness. Lexically sortable by creation time, no dependency needed.
+ */
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+export function ulid(now = Date.now()) {
+    let time = now;
+    let timePart = "";
+    for (let i = 0; i < 10; i += 1) {
+        timePart = CROCKFORD[time % 32] + timePart;
+        time = Math.floor(time / 32);
+    }
+    const bytes = randomBytes(16);
+    let randPart = "";
+    for (let i = 0; i < 16; i += 1) {
+        randPart += CROCKFORD[(bytes[i] ?? 0) % 32];
+    }
+    return timePart + randPart;
+}
+export const newTaskId = () => `task_${ulid()}`;
+export const newPacketId = () => `cp_${ulid()}`;
+export const newSessionId = () => `bses_${ulid()}`;
+/**
+ * Workspace identity (spec §5.1): hash of the git remote URL when one exists,
+ * else the absolute repo path. Remote-derived ids are stable across machines,
+ * which is what makes team handoff addressable.
+ */
+export function workspaceId(seed) {
+    return `ws_${createHash("sha256").update(seed).digest("hex").slice(0, 12)}`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,WAAW,EAAC,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,SAAS,GAAG,kCAAkC,CAAC;AAErD,MAAM,UAAU,IAAI,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IACzC,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,QAAQ,GAAG,SAAS,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC;QAC3C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,QAAQ,IAAI,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,QAAQ,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAW,EAAE,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACxD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACpC,OAAO,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/inject/antigravity.d.ts

@@ -0,0 +1,7 @@
+import type { Packet } from "../packet.js";
+export interface InjectResult {
+    sessionId: string;
+    transcriptPath: string;
+    sqliteUpdated?: boolean;
+}
+export declare function injectAntigravitySession(packet: Packet, workspaceDir: string, home?: string): InjectResult;