abmind 0.0.1 → 0.1.1

package/dist/cli/abmind.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * abmind — Unified CLI for AgentBridge Memory.
+ *
+ * Dispatcher shape: a single table of { name, file, aliases?, help } entries.
+ * Adding a subcommand is one line. No env-var smuggling — secrets subcommands
+ * call runSecretsCommand(action) directly.
+ */
+import { createRequire } from "node:module";
+import { dirname } from "node:path";
+import { pathToFileURL } from "node:url";
+// Resolve subcommand siblings via the package root, not relative to this script.
+// npm may copy this bin to node_modules/.bin/abmind (not a symlink).
+const req = createRequire(import.meta.url);
+const pkgDir = dirname(req.resolve("abmind/package.json"));
+const load = (name) => import(pathToFileURL(`${pkgDir}/dist/cli/${name}`).href);
+const DISPATCH = [
+    // Lifecycle (#158 Phase 4)
+    { name: "install", file: "abmind-install.js", help: "First-time setup of ~/.abmind" },
+    { name: "update", file: "abmind-update.js", help: "Build current checkout, stage new release, flip symlink" },
+    { name: "rollback", file: "abmind-rollback.js", help: "Flip current to a prior release" },
+    { name: "status", file: "abmind-status-runtime.js", help: "Show lifecycle status (version, lock, symlink)" },
+    // Memory-facing
+    { name: "recall", file: "abmind-recall.js", help: "Search memories" },
+    { name: "store", file: "abmind-store.js", help: "Store a new memory" },
+    { name: "ingest", file: "abmind-ingest.js", help: "Ingest a document into memory" },
+    { name: "backup", file: "abmind-backup.js", help: "Create encrypted backup" },
+    { name: "restore", file: "abmind-restore.js", help: "Restore from encrypted backup" },
+    { name: "edit", file: "abmind-edit.js", help: "Edit an existing memory" },
+    { name: "expand", file: "abmind-expand.js", help: "Look up source messages by ID" },
+    { name: "embed", file: "abmind-embed.js", help: "Batch embed all memories" },
+    { name: "retro-extract", file: "abmind-retro-extract.js", help: "Extract facts from retrospective files" },
+    { name: "wake-up", file: "abmind-wakeup.js", help: "Print current wake-up context" },
+    { name: "bundle", file: "abmind-bundle.js", help: "Print session bundle (SOUL + profile + notes + memory-tools)" },
+    { name: "sleep", file: "abmind-sleep.js", help: "Run a sleep cycle (--level basic|budget|normal|ultimate)" },
+    { name: "sleep-state", file: "abmind-sleep-state.js", help: "Show sleep candidates (JSON)" },
+    { name: "sleep-apply", file: "abmind-sleep-apply.js", help: "Promote/demote memories (--promote --demote --dry-run)" },
+    { name: "sleep-report", file: "abmind-sleep-report.js", help: "Generate dream report" },
+    { name: "mcp", file: "abmind-mcp.js", help: "Start MCP server (stdio)" },
+    { name: "migrate-openclaw", file: "abmind-migrate-openclaw.js", help: "Import OpenClaw session transcripts (.jsonl)" },
+    // Kiro CLI hooks (#344)
+    { name: "hook-wakeup", file: "abmind-hook-wakeup.js", help: "Kiro agentSpawn hook — wake-up context injection" },
+    { name: "hook-recall", file: "abmind-hook-recall.js", help: "Kiro userPromptSubmit hook — memory recall injection" },
+    { name: "hook-store", file: "abmind-hook-store.js", help: "Kiro stop hook — turn recording" },
+    { name: "hook-doctor", file: "abmind-hook-doctor.js", help: "Diagnose hook config, errors, active sidecars" },
+    { name: "list-secrets", help: "Show SECRET memory metadata",
+        run: async () => {
+            if (process.argv.slice(2).includes("--help")) {
+                console.log("Usage: abmind list-secrets\n\nShow SECRET memory metadata (no content, no decryption).");
+                return;
+            }
+            const m = await load("abmind-secrets.js");
+            m.runSecretsCommand("list");
+        } },
+    { name: "encrypt-secrets", help: "Encrypt existing SECRET memories",
+        run: async () => {
+            if (process.argv.slice(2).includes("--help")) {
+                console.log("Usage: abmind encrypt-secrets\n\nEncrypt existing classification=3 rows.");
+                return;
+            }
+            const m = await load("abmind-secrets.js");
+            m.runSecretsCommand("encrypt");
+        } },
+    { name: "rekey", help: "Re-encrypt with new key (--old-key <path>)",
+        run: async () => {
+            if (process.argv.slice(2).includes("--help")) {
+                console.log("Usage: abmind rekey --old-key <path-to-old-keyfile>\n\nRe-encrypt encrypted memories with a new key.");
+                return;
+            }
+            const m = await load("abmind-secrets.js");
+            m.runSecretsCommand("rekey");
+        } },
+];
+function printHelp() {
+    console.log("abmind — AgentBridge Memory CLI\n\nSubcommands:");
+    const width = Math.max(...DISPATCH.map(e => e.name.length));
+    for (const e of DISPATCH) {
+        console.log(`  ${e.name.padEnd(width)}  ${e.help}`);
+    }
+    console.log("\nRun 'abmind <subcommand> --help' for details.");
+}
+const subcommand = process.argv[2];
+if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+    printHelp();
+    process.exit(0);
+}
+const entry = DISPATCH.find(e => e.name === subcommand);
+if (!entry) {
+    console.error(`Unknown subcommand: ${subcommand}\nRun 'abmind --help' for usage.`);
+    process.exit(1);
+}
+// Shift argv so subcommand handlers see their args at argv[2+].
+process.argv.splice(2, 1);
+if (entry.run) {
+    await entry.run();
+}
+else if (entry.file) {
+    await load(entry.file);
+}
+//# sourceMappingURL=abmind.js.map

package/dist/cli/abmind.js.map

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

package/dist/src/abm-v2-vocab.d.ts

@@ -0,0 +1,10 @@
+/**
+ * abm-v2-vocab.ts — Canonical emoji vocabulary for ABM-L v2.
+ * Seeded from convergent encodings in the emoji-compression study (2026-04-29).
+ * Only emoji with ≥8/10 model agreement are canonical. Others fall back to text.
+ */
+export declare const TYPE_EMOJI: Record<string, string>;
+export declare const TOPIC_EMOJI: Record<string, string>;
+export declare const EMOTION_EMOJI: Record<string, string>;
+export declare function confidenceMarker(confidence: number): string;
+//# sourceMappingURL=abm-v2-vocab.d.ts.map

package/dist/src/abm-v2-vocab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abm-v2-vocab.d.ts","sourceRoot":"","sources":["../../src/abm-v2-vocab.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY7C,CAAC;AAIF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY9C,CAAC;AAIF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0BhD,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/src/abm-v2-vocab.js

@@ -0,0 +1,66 @@
+/**
+ * abm-v2-vocab.ts — Canonical emoji vocabulary for ABM-L v2.
+ * Seeded from convergent encodings in the emoji-compression study (2026-04-29).
+ * Only emoji with ≥8/10 model agreement are canonical. Others fall back to text.
+ */
+// ── Memory type → emoji ─────────────────────────────────────────────────────
+export const TYPE_EMOJI = {
+    fact: "📌",
+    decision: "🎯",
+    preference: "❤️",
+    event: "📅",
+    lesson: "📚",
+    feedback: "💬",
+    story: "📖",
+    observation: "💭",
+    pivot: "🔀",
+    milestone: "🏆",
+    correction: "✏️",
+};
+// ── Topic → emoji ───────────────────────────────────────────────────────────
+export const TOPIC_EMOJI = {
+    coding: "💻",
+    personal: "🏠",
+    memory: "🧠",
+    security: "🔒",
+    relationships: "👥",
+    finance: "💰",
+    health: "🏥",
+    work: "💼",
+    tools: "🔧",
+    projects: "📦",
+    people: "👤",
+};
+// ── Emotion short codes → emoji ─────────────────────────────────────────────
+export const EMOTION_EMOJI = {
+    joy: "😊",
+    pride: "🦁",
+    frust: "😤",
+    sad: "😢",
+    anxious: "😰",
+    convict: "🔥",
+    love: "❤️",
+    boredom: "🥱",
+    curiosity: "🔍",
+    surprise: "😲",
+    anger: "😡",
+    fear: "😨",
+    disgust: "🤢",
+    trust: "🤝",
+    anticipation: "⏳",
+    gratitude: "🙏",
+    nostalgia: "🕰️",
+    relief: "😮‍💨",
+    excitement: "🎉",
+    confusion: "😕",
+    determination: "💪",
+    amusement: "😄",
+    empathy: "🫂",
+    loneliness: "🌑",
+    hope: "🌅",
+};
+// ── Confidence → visual marker ──────────────────────────────────────────────
+export function confidenceMarker(confidence) {
+    return String(confidence);
+}
+//# sourceMappingURL=abm-v2-vocab.js.map

package/dist/src/abm-v2-vocab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abm-v2-vocab.js","sourceRoot":"","sources":["../../src/abm-v2-vocab.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,UAAU,GAA2B;IAChD,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,WAAW,EAAE,IAAI;IACjB,KAAK,EAAE,IAAI;IACX,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,+EAA+E;AAE/E,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,aAAa,EAAE,IAAI;IACnB,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;CACb,CAAC;AAEF,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,GAAG,EAAE,IAAI;IACT,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,IAAI;IACT,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,IAAI;IAChB,IAAI,EAAE,IAAI;CACX,CAAC;AAEF,+EAA+E;AAE/E,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5B,CAAC"}

package/dist/src/adapters/openclaw.d.ts

@@ -0,0 +1,66 @@
+/**
+ * abmind OpenClaw plugin — registers memory capability via registerMemoryCapability (Path A).
+ *
+ * Usage: In OpenClaw plugin config, point to this module.
+ * Requires abmind to be installed and ABMIND_HOME set (or defaults to ~/.abmind).
+ */
+interface OcPluginApi {
+    logger: {
+        info(msg: string): void;
+        error(msg: string): void;
+    };
+    registerMemoryCapability(cap: {
+        promptBuilder: () => string[];
+        flushPlanResolver: () => {
+            softThresholdTokens: number;
+            forceFlushTranscriptBytes: number;
+            reserveTokensFloor: number;
+            prompt: string;
+            systemPrompt: string;
+            relativePath: string;
+        } | null;
+        runtime: {
+            getMemorySearchManager(params: {
+                cfg: unknown;
+                agentId: string;
+            }): Promise<{
+                manager: OcSearchManager | null;
+                error?: string;
+            }>;
+            resolveMemoryBackendConfig(params: {
+                cfg: unknown;
+                agentId: string;
+            }): {
+                backend: "external";
+            };
+            closeAllMemorySearchManagers?(): Promise<void>;
+        };
+    }): void;
+}
+interface OcSearchManager {
+    search(query: string, opts?: {
+        maxResults?: number;
+    }): Promise<Array<{
+        content: string;
+        path: string;
+        score: number;
+        snippet: string;
+    }>>;
+    readFile(params: {
+        relPath: string;
+        from?: number;
+        lines?: number;
+    }): Promise<{
+        text: string;
+        path: string;
+    }>;
+    status(): {
+        enabled: boolean;
+        ready: boolean;
+        error?: string;
+    };
+    close?(): Promise<void>;
+}
+export declare function register(api: OcPluginApi): Promise<void>;
+export {};
+//# sourceMappingURL=openclaw.d.ts.map

package/dist/src/adapters/openclaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../../src/adapters/openclaw.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,UAAU,WAAW;IACnB,MAAM,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9D,wBAAwB,CAAC,GAAG,EAAE;QAC5B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;QAC9B,iBAAiB,EAAE,MAAM;YACvB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,yBAAyB,EAAE,MAAM,CAAC;YAClC,kBAAkB,EAAE,MAAM,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,EAAE,MAAM,CAAC;YACrB,YAAY,EAAE,MAAM,CAAC;SACtB,GAAG,IAAI,CAAC;QACT,OAAO,EAAE;YACP,sBAAsB,CAAC,MAAM,EAAE;gBAAE,GAAG,EAAE,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG,OAAO,CAAC;gBACzE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;gBAChC,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC,CAAC;YACH,0BAA0B,CAAC,MAAM,EAAE;gBAAE,GAAG,EAAE,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG;gBAAE,OAAO,EAAE,UAAU,CAAA;aAAE,CAAC;YAC/F,4BAA4B,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;SAChD,CAAC;KACH,GAAG,IAAI,CAAC;CACV;AAED,UAAU,eAAe;IACvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACzI,QAAQ,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9G,MAAM,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E9D"}

package/dist/src/adapters/openclaw.js

@@ -0,0 +1,97 @@
+/**
+ * abmind OpenClaw plugin — registers memory capability via registerMemoryCapability (Path A).
+ *
+ * Usage: In OpenClaw plugin config, point to this module.
+ * Requires abmind to be installed and ABMIND_HOME set (or defaults to ~/.abmind).
+ */
+import { loadMemoryConfig } from "../memory-config.js";
+import { MemoryManager } from "../memory-manager.js";
+import { createMemoryBackend } from "../backend-factory.js";
+import { loadMasterUserId } from "../user-utils.js";
+import { abmindHome } from "../mem-paths.js";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+export async function register(api) {
+    const config = loadMemoryConfig();
+    const memory = new MemoryManager(config);
+    await memory.initialize();
+    let backend = null;
+    try {
+        backend = await createMemoryBackend(config);
+    }
+    catch (err) {
+        api.logger.error(`[abmind] Failed to create backend: ${err}`);
+    }
+    const masterUserId = loadMasterUserId();
+    const dataDir = abmindHome();
+    const promptBuilder = () => {
+        try {
+            const wakeup = memory.buildWakeUp();
+            return wakeup ? [wakeup] : [];
+        }
+        catch (err) {
+            api.logger.error(`[abmind] promptBuilder failed: ${err}`);
+            return [];
+        }
+    };
+    const flushPlanResolver = () => ({
+        softThresholdTokens: 80000,
+        forceFlushTranscriptBytes: 200000,
+        reserveTokensFloor: 20000,
+        prompt: "Summarize the conversation so far.",
+        systemPrompt: "You are a conversation summarizer.",
+        relativePath: "memory/compaction",
+    });
+    const buildSearchManager = () => ({
+        async search(query, opts) {
+            if (!backend)
+                return [];
+            try {
+                const result = await backend.recall({ translated: [query], userId: masterUserId, limit: opts?.maxResults ?? 10 });
+                return result.results.map(r => ({
+                    content: r.content,
+                    path: `memory://${r.source}`,
+                    score: r.score ?? 0.5,
+                    snippet: r.content.slice(0, 200),
+                }));
+            }
+            catch (err) {
+                api.logger.error(`[abmind] search failed: ${err}`);
+                return [];
+            }
+        },
+        async readFile({ relPath }) {
+            const fullPath = join(dataDir, relPath);
+            if (!existsSync(fullPath))
+                return { text: "", path: fullPath };
+            try {
+                return { text: readFileSync(fullPath, "utf-8"), path: fullPath };
+            }
+            catch {
+                return { text: "", path: fullPath };
+            }
+        },
+        status() {
+            const stats = memory.getStats();
+            return { enabled: true, ready: !!stats, error: stats ? undefined : "Memory not initialized" };
+        },
+        async close() { memory.close(); },
+    });
+    api.registerMemoryCapability({
+        promptBuilder,
+        flushPlanResolver,
+        runtime: {
+            async getMemorySearchManager() {
+                return { manager: buildSearchManager() };
+            },
+            resolveMemoryBackendConfig() {
+                return { backend: "external" };
+            },
+            async closeAllMemorySearchManagers() {
+                memory.close();
+            },
+        },
+    });
+    api.logger.info(`[abmind] Memory plugin registered (user: ${masterUserId}, data: ${dataDir})`);
+}
+//# sourceMappingURL=openclaw.js.map

package/dist/src/adapters/openclaw.js.map

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

package/dist/src/backend-factory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Backend factory — creates the configured MemoryBackend.
+ * Tries IPC socket first (fast), falls back to SQLite (standalone).
+ */
+import type { MemoryBackend } from "./memory-backend.js";
+import type { MemoryConfig } from "./memory-config.js";
+/** Create and initialize a MemoryBackend. Tries IPC socket first, falls back to SQLite. */
+export declare function createMemoryBackend(config: MemoryConfig): Promise<MemoryBackend>;
+//# sourceMappingURL=backend-factory.d.ts.map

package/dist/src/backend-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-factory.d.ts","sourceRoot":"","sources":["../../src/backend-factory.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,2FAA2F;AAC3F,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBtF"}

package/dist/src/backend-factory.js

@@ -0,0 +1,23 @@
+import { getAbmindEnv } from "./env-schema.js";
+import { SqliteBackend } from "./sqlite-backend.js";
+/** Create and initialize a MemoryBackend. Tries IPC socket first, falls back to SQLite. */
+export async function createMemoryBackend(config) {
+    const backendType = getAbmindEnv().memoryBackend;
+    if (backendType !== "sqlite") {
+        throw new Error(`Unknown MEMORY_BACKEND: ${backendType}. Supported: sqlite`);
+    }
+    // Try IPC first (bridge is running, DB already open)
+    if (getAbmindEnv().memoryIpc) {
+        try {
+            const { IpcBackend } = await import("./memory-ipc-client.js");
+            const ipc = new IpcBackend();
+            await ipc.initialize();
+            return ipc;
+        }
+        catch { /* socket not available — fall through to SQLite */ }
+    }
+    const backend = new SqliteBackend(config);
+    await backend.initialize();
+    return backend;
+}
+//# sourceMappingURL=backend-factory.js.map

package/dist/src/backend-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-factory.js","sourceRoot":"","sources":["../../src/backend-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ/C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAoB;IAC5D,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC,aAAa,CAAC;IACjD,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,qBAAqB,CAAC,CAAC;IAC/E,CAAC;IAED,qDAAqD;IACrD,IAAI,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAC9D,MAAM,GAAG,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,MAAM,CAAC,CAAC,mDAAmD,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/backup.d.ts

@@ -0,0 +1,19 @@
+/**
+ * backup.ts — Encrypted backup/restore for abmind memory.
+ * Format: plaintext header (salt, iv, version) + AES-256-GCM encrypted ZIP.
+ */
+import type Database from "better-sqlite3";
+export interface BackupResult {
+    path: string;
+    memories: number;
+    files: number;
+    sizeBytes: number;
+}
+export interface RestoreResult {
+    restored: number;
+    skipped: number;
+    files: number;
+}
+export declare function createBackup(db: Database.Database, memoryDir: string, passphrase: string, outputPath: string): BackupResult;
+export declare function restoreBackup(db: Database.Database, memoryDir: string, passphrase: string, inputPath: string, mode: "merge" | "replace"): RestoreResult;
+//# sourceMappingURL=backup.d.ts.map

package/dist/src/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAQ3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAoCD,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAmD3H;AAID,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,aAAa,CAoHvJ"}

package/dist/src/backup.js

@@ -0,0 +1,191 @@
+/**
+ * backup.ts — Encrypted backup/restore for abmind memory.
+ * Format: plaintext header (salt, iv, version) + AES-256-GCM encrypted ZIP.
+ */
+import { createCipheriv, createDecipheriv, pbkdf2Sync, randomBytes } from "node:crypto";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { deflateSync, inflateSync } from "node:zlib";
+import { logInfo } from "./mem-logger.js";
+const TAG = "backup";
+const MAGIC = Buffer.from("ABMIND\x00\x01");
+const PBKDF2_ITERATIONS = 100_000;
+const HEADER_SIZE = 54; // 8 magic + 2 version + 32 salt + 12 iv
+function deriveKey(passphrase, salt) {
+    return pbkdf2Sync(passphrase, salt, PBKDF2_ITERATIONS, 32, "sha256");
+}
+function encrypt(key, iv, data) {
+    const cipher = createCipheriv("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([cipher.update(data), cipher.final()]);
+    const authTag = cipher.getAuthTag();
+    return Buffer.concat([encrypted, authTag]); // tag appended (16 bytes)
+}
+function decrypt(key, iv, data) {
+    const authTag = data.subarray(data.length - 16);
+    const encrypted = data.subarray(0, data.length - 16);
+    const decipher = createDecipheriv("aes-256-gcm", key, iv);
+    decipher.setAuthTag(authTag);
+    return Buffer.concat([decipher.update(encrypted), decipher.final()]);
+}
+function collectMdFiles(baseDir, subDirs) {
+    const files = [];
+    for (const sub of subDirs) {
+        const dir = join(baseDir, sub);
+        if (!existsSync(dir))
+            continue;
+        for (const f of readdirSync(dir)) {
+            if (!f.endsWith(".md"))
+                continue;
+            files.push({ path: `${sub}/${f}`, content: readFileSync(join(dir, f), "utf-8") });
+        }
+    }
+    return files;
+}
+// ── Backup ───────────────────────────────────────────────────────────────────
+export function createBackup(db, memoryDir, passphrase, outputPath) {
+    const salt = randomBytes(32);
+    const iv = randomBytes(12);
+    const key = deriveKey(passphrase, salt);
+    // Export tables
+    const memories = db.prepare("SELECT * FROM extracted_memories").all();
+    const watermarks = db.prepare("SELECT * FROM extraction_watermarks").all();
+    const entityGraph = db.prepare("SELECT * FROM entity_graph").all();
+    const ingested = db.prepare("SELECT * FROM ingested_documents").all();
+    const schemaVersion = 17; // current schema version
+    // Export .md files
+    const mdFiles = collectMdFiles(memoryDir, ["daily", "weekly", "quarterly", "retrospectives", "core"]);
+    // Build ZIP-like JSON payload (using JSON for simplicity — ZIP adds dep)
+    const manifest = {
+        version: schemaVersion,
+        createdAt: Date.now(),
+        memoriesCount: memories.length,
+        filesCount: mdFiles.length,
+    };
+    const payload = JSON.stringify({
+        manifest,
+        tables: {
+            extracted_memories: memories,
+            extraction_watermarks: watermarks,
+            entity_graph: entityGraph,
+            ingested_documents: ingested,
+        },
+        files: mdFiles,
+    });
+    // Compress then encrypt
+    const compressed = deflateSync(Buffer.from(payload, "utf-8"));
+    const encrypted = encrypt(key, iv, compressed);
+    // Write header + body
+    const header = Buffer.alloc(HEADER_SIZE);
+    MAGIC.copy(header, 0);
+    header.writeUInt16LE(schemaVersion, 8);
+    salt.copy(header, 10);
+    iv.copy(header, 42);
+    const output = Buffer.concat([header, encrypted]);
+    mkdirSync(join(outputPath, ".."), { recursive: true });
+    writeFileSync(outputPath, output);
+    logInfo(TAG, `Backup complete: ${memories.length} memories, ${mdFiles.length} files → ${outputPath} (${output.length} bytes)`);
+    return { path: outputPath, memories: memories.length, files: mdFiles.length, sizeBytes: output.length };
+}
+// ── Restore ──────────────────────────────────────────────────────────────────
+export function restoreBackup(db, memoryDir, passphrase, inputPath, mode) {
+    const raw = readFileSync(inputPath);
+    // Parse header
+    const magic = raw.subarray(0, 8);
+    if (!magic.equals(MAGIC))
+        throw new Error("Invalid backup file (bad magic)");
+    const _version = raw.readUInt16LE(8);
+    const salt = raw.subarray(10, 42);
+    const iv = raw.subarray(42, 54);
+    const body = raw.subarray(HEADER_SIZE);
+    // Decrypt + decompress
+    const key = deriveKey(passphrase, salt);
+    let decrypted;
+    try {
+        decrypted = decrypt(key, iv, body);
+    }
+    catch {
+        throw new Error("Decryption failed — wrong passphrase or corrupted file");
+    }
+    const decompressed = inflateSync(decrypted).toString("utf-8");
+    const data = JSON.parse(decompressed);
+    let restored = 0;
+    let skipped = 0;
+    if (mode === "replace") {
+        // Wipe existing data
+        db.exec("DELETE FROM extracted_memories");
+        db.exec("DELETE FROM extraction_watermarks");
+        db.exec("DELETE FROM entity_graph");
+        db.exec("DELETE FROM ingested_documents");
+    }
+    // Restore extracted_memories
+    const memCols = Object.keys(data.tables.extracted_memories[0] ?? {});
+    if (memCols.length > 0 && data.tables.extracted_memories.length > 0) {
+        // Get current table columns for forward-compat
+        const tableInfo = db.prepare("PRAGMA table_info(extracted_memories)").all();
+        const validCols = new Set(tableInfo.map(c => c.name));
+        const useCols = memCols.filter(c => validCols.has(c));
+        const placeholders = useCols.map(() => "?").join(",");
+        const insertSql = mode === "merge"
+            ? `INSERT OR IGNORE INTO extracted_memories (${useCols.join(",")}) VALUES (${placeholders})`
+            : `INSERT INTO extracted_memories (${useCols.join(",")}) VALUES (${placeholders})`;
+        const stmt = db.prepare(insertSql);
+        const tx = db.transaction(() => {
+            for (const row of data.tables.extracted_memories) {
+                const values = useCols.map(c => row[c] ?? null);
+                const result = stmt.run(...values);
+                if (result.changes > 0)
+                    restored++;
+                else
+                    skipped++;
+            }
+        });
+        tx();
+    }
+    // Restore entity_graph
+    if (data.tables.entity_graph.length > 0) {
+        const stmt = db.prepare(mode === "merge"
+            ? "INSERT OR IGNORE INTO entity_graph (entity_a, entity_b, relation, source_memory_id, created_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?)"
+            : "INSERT INTO entity_graph (entity_a, entity_b, relation, source_memory_id, created_at, last_seen_at) VALUES (?, ?, ?, ?, ?, ?)");
+        for (const row of data.tables.entity_graph) {
+            stmt.run(row.entity_a, row.entity_b, row.relation, row.source_memory_id, row.created_at, row.last_seen_at);
+        }
+    }
+    // Restore extraction_watermarks
+    if (data.tables.extraction_watermarks.length > 0) {
+        const stmt = db.prepare("INSERT OR REPLACE INTO extraction_watermarks (user_id, last_processed_timestamp) VALUES (?, ?)");
+        for (const row of data.tables.extraction_watermarks) {
+            stmt.run(row.user_id, row.last_processed_timestamp);
+        }
+    }
+    // Restore ingested_documents
+    if (data.tables.ingested_documents.length > 0) {
+        const stmt = db.prepare(mode === "merge"
+            ? "INSERT OR IGNORE INTO ingested_documents (user_id, source_type, identifier, chunk_count, ingested_at) VALUES (?, ?, ?, ?, ?)"
+            : "INSERT INTO ingested_documents (user_id, source_type, identifier, chunk_count, ingested_at) VALUES (?, ?, ?, ?, ?)");
+        for (const row of data.tables.ingested_documents) {
+            stmt.run(row.user_id, row.source_type, row.identifier, row.chunk_count, row.ingested_at);
+        }
+    }
+    // Restore .md files
+    let filesRestored = 0;
+    for (const file of data.files) {
+        const target = join(memoryDir, file.path);
+        if (mode === "merge" && existsSync(target))
+            continue;
+        mkdirSync(join(target, ".."), { recursive: true });
+        writeFileSync(target, file.content, "utf-8");
+        filesRestored++;
+    }
+    // FTS rebuild (replace only — merge uses INSERT triggers)
+    if (mode === "replace") {
+        try {
+            db.exec("INSERT INTO extracted_memories_fts(extracted_memories_fts) VALUES('rebuild')");
+            db.exec("INSERT INTO content_en_trigram(content_en_trigram) VALUES('rebuild')");
+            db.exec("INSERT INTO content_original_trigram(content_original_trigram) VALUES('rebuild')");
+        }
+        catch { /* FTS rebuild best-effort */ }
+    }
+    logInfo(TAG, `Restore complete (${mode}): ${restored} memories restored, ${skipped} skipped, ${filesRestored} files`);
+    return { restored, skipped, files: filesRestored };
+}
+//# sourceMappingURL=backup.js.map