smart-claude-memory-mcp 2.1.0

package/dist/transactions/checkpoint.js

@@ -0,0 +1,272 @@
+// Transactional Workflow Checkpoint Service (Agentic OS 2026 / Mission 4 / Phase A).
+//
+// Pure service layer — NO MCP tool definitions live here (those land in Phase B
+// under src/tools/checkpoint.ts). This module is the binding glue between the
+// three earlier missions:
+//
+//   * M1 (agent_skills)        — `skillId` ties the checkpoint to a JIT-retrieved
+//                                skill boundary.
+//   * M2 (trajectory_summaries) — `sourceChunkId` pinned on commit IS the replay
+//                                anchor; restore replays it via the existing
+//                                `get_trajectory_summary` RPC.
+//   * M3 (skill_candidates)    — rollback events feed the miner as negative
+//                                examples (the LEFT JOIN extension itself is
+//                                deferred to Phase B; this module emits the
+//                                durable rolledback row that the miner reads).
+//
+// All functions:
+//   * validate inputs and throw Error with `[M4]` prefix on bad shape
+//   * surface Supabase failures verbatim wrapped with `[M4] <op>: <msg>`
+//   * return typed results — no `any`, no placeholders
+//
+// Style mirrors src/sleep/miner.ts and src/trajectory/daemon.ts: throw on
+// I/O failure (the caller / future Phase-B tool wrapper translates to MCP
+// error envelope), use `supabase` from ../supabase.js, no module-level state
+// (this is a pure service — daemon-style state belongs in Phase B if/when
+// we add a checkpoint reaper).
+import { supabase } from "../supabase.js";
+// ─── validation helpers ─────────────────────────────────────────────────────
+function requireProjectId(projectId, fn) {
+    if (typeof projectId !== "string" || projectId.trim().length === 0) {
+        throw new Error(`[M4] ${fn}: projectId must be a non-empty string`);
+    }
+}
+function requireCheckpointId(id, fn) {
+    if (typeof id !== "number" || !Number.isInteger(id) || id <= 0) {
+        throw new Error(`[M4] ${fn}: checkpointId must be a positive integer`);
+    }
+}
+function requireStepIndex(idx, fn) {
+    if (typeof idx !== "number" || !Number.isInteger(idx) || idx < 0) {
+        throw new Error(`[M4] ${fn}: stepIndex must be a non-negative integer`);
+    }
+}
+function requireStepLabel(label, fn) {
+    if (typeof label !== "string" || label.trim().length === 0) {
+        throw new Error(`[M4] ${fn}: stepLabel must be a non-empty string`);
+    }
+}
+function requireSourceChunkId(id, fn) {
+    if (typeof id !== "number" || !Number.isInteger(id) || id <= 0) {
+        throw new Error(`[M4] ${fn}: sourceChunkId must be a positive integer`);
+    }
+}
+function requireReason(reason, fn) {
+    if (typeof reason !== "string" || reason.trim().length === 0) {
+        throw new Error(`[M4] ${fn}: reason must be a non-empty string`);
+    }
+}
+// ─── openCheckpoint ─────────────────────────────────────────────────────────
+export async function openCheckpoint(args) {
+    requireProjectId(args.projectId, "openCheckpoint");
+    requireStepIndex(args.stepIndex, "openCheckpoint");
+    requireStepLabel(args.stepLabel, "openCheckpoint");
+    const skillId = args.skillId === undefined || args.skillId === null ? null : args.skillId;
+    if (skillId !== null && (!Number.isInteger(skillId) || skillId <= 0)) {
+        throw new Error(`[M4] openCheckpoint: skillId must be a positive integer or null`);
+    }
+    const parentId = args.parentId === undefined || args.parentId === null ? null : args.parentId;
+    if (parentId !== null && (!Number.isInteger(parentId) || parentId <= 0)) {
+        throw new Error(`[M4] openCheckpoint: parentId must be a positive integer or null`);
+    }
+    console.log(`[M4] openCheckpoint: project=${args.projectId} step=${args.stepIndex} label=${args.stepLabel} parent=${parentId ?? "root"}`);
+    const { data, error } = await supabase
+        .from("workflow_checkpoints")
+        .insert({
+        project_id: args.projectId,
+        skill_id: skillId,
+        step_index: args.stepIndex,
+        step_label: args.stepLabel,
+        parent_id: parentId,
+        status: "open",
+    })
+        .select("id, status")
+        .single();
+    if (error) {
+        throw new Error(`[M4] openCheckpoint: insert failed: ${error.message}`);
+    }
+    if (!data || typeof data.id !== "number") {
+        throw new Error(`[M4] openCheckpoint: insert returned no row`);
+    }
+    if (data.status !== "open") {
+        throw new Error(`[M4] openCheckpoint: unexpected status '${String(data.status)}'`);
+    }
+    return { id: data.id, status: "open" };
+}
+// ─── commitCheckpoint ───────────────────────────────────────────────────────
+export async function commitCheckpoint(args) {
+    requireProjectId(args.projectId, "commitCheckpoint");
+    requireCheckpointId(args.checkpointId, "commitCheckpoint");
+    requireSourceChunkId(args.sourceChunkId, "commitCheckpoint");
+    console.log(`[M4] commitCheckpoint: project=${args.projectId} id=${args.checkpointId} source_chunk_id=${args.sourceChunkId}`);
+    const { data, error } = await supabase
+        .from("workflow_checkpoints")
+        .update({
+        status: "committed",
+        source_chunk_id: args.sourceChunkId,
+        committed_at: new Date().toISOString(),
+    })
+        .eq("id", args.checkpointId)
+        .eq("project_id", args.projectId)
+        .eq("status", "open") // only open rows commit — idempotency + safety
+        .select("id, status, source_chunk_id")
+        .single();
+    if (error) {
+        throw new Error(`[M4] commitCheckpoint: update failed: ${error.message}`);
+    }
+    if (!data || typeof data.id !== "number") {
+        throw new Error(`[M4] commitCheckpoint: row not found, not open, or project mismatch (id=${args.checkpointId})`);
+    }
+    if (data.status !== "committed") {
+        throw new Error(`[M4] commitCheckpoint: unexpected status '${String(data.status)}'`);
+    }
+    if (typeof data.source_chunk_id !== "number") {
+        throw new Error(`[M4] commitCheckpoint: source_chunk_id not persisted`);
+    }
+    return {
+        id: data.id,
+        status: "committed",
+        sourceChunkId: data.source_chunk_id,
+    };
+}
+// ─── rollbackCheckpoint ─────────────────────────────────────────────────────
+//
+// Walks the parent chain to find the deepest committed ancestor's
+// source_chunk_id via the SQL helper terminal_committed_checkpoint, then
+// marks the target row as rolledback. The replay anchor (if any) is
+// returned so the caller can drive restoreFrom().
+export async function rollbackCheckpoint(args) {
+    requireProjectId(args.projectId, "rollbackCheckpoint");
+    requireCheckpointId(args.checkpointId, "rollbackCheckpoint");
+    requireReason(args.reason, "rollbackCheckpoint");
+    console.log(`[M4] rollbackCheckpoint: project=${args.projectId} id=${args.checkpointId} reason=${args.reason}`);
+    // 1. Load the target row to discover its skill_id and parent_id so we can
+    //    walk the chain from the parent (rolledback rows never anchor replay).
+    const { data: target, error: loadErr } = await supabase
+        .from("workflow_checkpoints")
+        .select("id, project_id, skill_id, parent_id, status")
+        .eq("id", args.checkpointId)
+        .eq("project_id", args.projectId)
+        .maybeSingle();
+    if (loadErr) {
+        throw new Error(`[M4] rollbackCheckpoint: lookup failed: ${loadErr.message}`);
+    }
+    if (!target) {
+        throw new Error(`[M4] rollbackCheckpoint: checkpoint ${args.checkpointId} not found in project ${args.projectId}`);
+    }
+    if (target.status === "rolledback") {
+        throw new Error(`[M4] rollbackCheckpoint: checkpoint ${args.checkpointId} is already rolledback`);
+    }
+    // 2. Find the replay anchor: deepest committed source_chunk_id reachable
+    //    from the PARENT (not this row — we're rolling this one back).
+    //    NULL parent = root rollback: no anchor exists.
+    let restoredFrom = null;
+    const parentId = typeof target.parent_id === "number" ? target.parent_id : null;
+    if (parentId !== null) {
+        const skillId = typeof target.skill_id === "number" ? target.skill_id : null;
+        const { data: rpcData, error: rpcErr } = await supabase.rpc("terminal_committed_checkpoint", {
+            p_project_id: args.projectId,
+            p_skill_id: skillId,
+            p_root_id: parentId,
+        });
+        if (rpcErr) {
+            throw new Error(`[M4] rollbackCheckpoint: terminal_committed_checkpoint RPC failed: ${rpcErr.message}`);
+        }
+        // Supabase RPC returns the scalar directly (PostgREST flattens single-column functions).
+        const sourceChunkId = typeof rpcData === "number"
+            ? rpcData
+            : Array.isArray(rpcData) && rpcData.length > 0 && typeof rpcData[0] === "number"
+                ? rpcData[0]
+                : null;
+        if (sourceChunkId !== null) {
+            restoredFrom = { checkpointId: parentId, sourceChunkId };
+        }
+    }
+    // 3. Mark this row rolledback. We use the same .eq() guard pattern as
+    //    commit to prevent double-rollback races.
+    const { data, error } = await supabase
+        .from("workflow_checkpoints")
+        .update({
+        status: "rolledback",
+        rollback_reason: args.reason,
+    })
+        .eq("id", args.checkpointId)
+        .eq("project_id", args.projectId)
+        .neq("status", "rolledback")
+        .select("id, status")
+        .single();
+    if (error) {
+        throw new Error(`[M4] rollbackCheckpoint: update failed: ${error.message}`);
+    }
+    if (!data || typeof data.id !== "number") {
+        throw new Error(`[M4] rollbackCheckpoint: row not found or already rolledback (id=${args.checkpointId})`);
+    }
+    if (data.status !== "rolledback") {
+        throw new Error(`[M4] rollbackCheckpoint: unexpected status '${String(data.status)}'`);
+    }
+    return {
+        id: data.id,
+        status: "rolledback",
+        restoredFrom,
+    };
+}
+// ─── listCheckpoints ────────────────────────────────────────────────────────
+export async function listCheckpoints(args) {
+    requireProjectId(args.projectId, "listCheckpoints");
+    const limit = args.limit === undefined ? 50 : args.limit;
+    if (!Number.isInteger(limit) || limit <= 0 || limit > 500) {
+        throw new Error(`[M4] listCheckpoints: limit must be an integer in (0, 500]`);
+    }
+    let q = supabase
+        .from("workflow_checkpoints")
+        .select("id, project_id, skill_id, step_index, step_label, parent_id, source_chunk_id, status, rollback_reason, created_at, committed_at")
+        .eq("project_id", args.projectId);
+    if (args.status !== undefined) {
+        q = q.eq("status", args.status);
+    }
+    if (args.skillId !== undefined && args.skillId !== null) {
+        q = q.eq("skill_id", args.skillId);
+    }
+    const { data, error } = await q
+        .order("id", { ascending: false })
+        .limit(limit);
+    if (error) {
+        throw new Error(`[M4] listCheckpoints: query failed: ${error.message}`);
+    }
+    return (data ?? []);
+}
+export async function restoreFrom(args) {
+    requireProjectId(args.projectId, "restoreFrom");
+    requireCheckpointId(args.checkpointId, "restoreFrom");
+    console.log(`[M4] restoreFrom: project=${args.projectId} id=${args.checkpointId}`);
+    const { data: row, error: loadErr } = await supabase
+        .from("workflow_checkpoints")
+        .select("id, source_chunk_id, status")
+        .eq("id", args.checkpointId)
+        .eq("project_id", args.projectId)
+        .maybeSingle();
+    if (loadErr) {
+        throw new Error(`[M4] restoreFrom: lookup failed: ${loadErr.message}`);
+    }
+    if (!row) {
+        throw new Error(`[M4] restoreFrom: checkpoint ${args.checkpointId} not found in project ${args.projectId}`);
+    }
+    const replayChunkId = typeof row.source_chunk_id === "number" ? row.source_chunk_id : null;
+    if (replayChunkId === null) {
+        return { replayChunkId: null, summary: null };
+    }
+    const { data: rpcData, error: rpcErr } = await supabase.rpc("get_trajectory_summary", { p_chunk_id: replayChunkId });
+    if (rpcErr) {
+        throw new Error(`[M4] restoreFrom: get_trajectory_summary RPC failed: ${rpcErr.message}`);
+    }
+    const rows = (rpcData ?? []);
+    if (rows.length === 0) {
+        // Checkpoint pinned a chunk but no summary exists yet (M2 daemon hasn't
+        // run on it, or summary was purged). Return the pointer without payload
+        // — caller can fall back to raw memory_chunks if desired.
+        return { replayChunkId, summary: null };
+    }
+    const first = rows[0];
+    return { replayChunkId, summary: first.summary };
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/transactions/checkpoint.js.map

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

package/dist/verification-gate.js

@@ -0,0 +1,43 @@
+// Shared pending-verification flag used by the Hard Stop / Manual Test Gate.
+// The MCP server writes this file after any code-producing tool call; the hook
+// reads it to block subsequent destructive tool calls; confirm_verification
+// clears it.
+import { writeFile, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir, homedir } from "node:os";
+// TODO(v1.2.0): drop the legacy CLAUDE_MEMORY_GATE_DIR fallback after the Smart Claude Memory rebrand has settled.
+// The on-disk dir `~/.claude-memory` is intentionally preserved to keep existing backups discoverable.
+export const FLAG_DIR = process.env.SMART_CLAUDE_MEMORY_GATE_DIR ??
+    process.env.CLAUDE_MEMORY_GATE_DIR ??
+    join(homedir(), ".claude-memory");
+export const FLAG_PATH = join(FLAG_DIR, "verification-pending.json");
+export async function setPending(payload) {
+    await writeFile(FLAG_PATH, JSON.stringify(payload, null, 2), { flag: "w" }).catch(async () => {
+        // If the dir doesn't exist, create it via os.tmpdir fallback then retry at FLAG_DIR.
+        const { mkdir } = await import("node:fs/promises");
+        await mkdir(FLAG_DIR, { recursive: true });
+        await writeFile(FLAG_PATH, JSON.stringify(payload, null, 2));
+    });
+}
+export async function clearPending() {
+    try {
+        await rm(FLAG_PATH, { force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function getPending() {
+    try {
+        await stat(FLAG_PATH);
+        const { readFile } = await import("node:fs/promises");
+        const raw = await readFile(FLAG_PATH, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+void tmpdir; // satisfy ts lint; kept for future fallback
+//# sourceMappingURL=verification-gate.js.map

package/dist/verification-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-gate.js","sourceRoot":"","sources":["../src/verification-gate.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,4EAA4E;AAC5E,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE1C,mHAAmH;AACnH,uGAAuG;AACvG,MAAM,CAAC,MAAM,QAAQ,GACnB,OAAO,CAAC,GAAG,CAAC,4BAA4B;IACxC,OAAO,CAAC,GAAG,CAAC,sBAAsB;IAClC,IAAI,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;AAUrE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAoB;IACnD,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;QAC3F,qFAAqF;QACrF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,MAAM,CAAC,CAAC,4CAA4C"}

package/dist/version.js

@@ -0,0 +1,16 @@
+// Single source of truth for the package version.
+//
+// All runtime version reporting (MCP server registration, check_system_health,
+// delegate_task synthesis envelope) MUST import VERSION from here so the value
+// stays in lock-step with package.json. Hard-coded literals are forbidden —
+// they drift silently and make health reports lie.
+//
+// Mechanism: createRequire is the safest cross-Node, NodeNext-friendly way to
+// load a JSON file from an ESM module. tsconfig has resolveJsonModule + the
+// `import ... with { type: "json" }` form would also work, but createRequire
+// avoids loader-flag friction across Node versions.
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,mDAAmD;AACnD,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,oDAAoD;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC"}

package/hooks/README.md

@@ -0,0 +1,54 @@
+# Hooks
+
+Distributable Claude Code hooks that pair well with `smart-claude-memory`.
+
+## `md-policy.py`
+
+Enforces a **Zero-Local-MD policy** in any project: only a whitelisted set of `.md` files may exist at the project root; everything else must live in cloud memory and be retrieved via `search_memory`.
+
+### What it does
+
+- **Blocks** `Write`/`Edit` on any `.md` file outside the project root or outside the allowlist.
+- **Warns** (does not block) when `CLAUDE.md` or `MEMORY.md` exceeds a soft token limit — your cue to prune.
+
+### Install per project
+
+1. Pick (or create) the target project's `.claude/settings.json` or `.claude/settings.local.json`.
+2. Add the hook entry:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python \"/abs/path/to/smart-claude-memory/hooks/md-policy.py\""
+          }
+        ]
+      }
+    ]
+  },
+  "env": {
+    "CLAUDE_MD_POLICY_WORKSPACE": "/abs/path/to/your/project",
+    "CLAUDE_MD_POLICY_ALLOW_ROOT_MD": "CLAUDE.md,MEMORY.md,README.md",
+    "CLAUDE_MD_POLICY_TOKEN_LIMIT": "3000"
+  }
+}
+```
+
+3. Restart Claude Code.
+
+### Environment variables
+
+| Name | Default | Purpose |
+|---|---|---|
+| `CLAUDE_MD_POLICY_WORKSPACE` | — (required) | Absolute path of the project root the policy applies to. If unset, the hook no-ops. |
+| `CLAUDE_MD_POLICY_ALLOW_ROOT_MD` | `CLAUDE.md,MEMORY.md,README.md` | Comma-separated filenames allowed at the root. |
+| `CLAUDE_MD_POLICY_TOKEN_LIMIT` | `3000` | Soft limit for `CLAUDE.md` and `MEMORY.md`. Over → warn, never block. |
+
+### Failure mode
+
+Any malformed input, missing env var, or unhandled exception resolves to `{"decision": "allow"}` — the hook never blocks through its own bugs.