gnosys 5.5.0 → 5.6.0

package/dist/lib/importProject.js

@@ -0,0 +1,135 @@
+/**
+ * Per-project bundle import — restores a .json.gz bundle produced by
+ * exportProject.ts into the central DB. Three conflict strategies for
+ * existing project IDs / memory IDs.
+ */
+import { gunzipSync } from "zlib";
+import { readFileSync } from "fs";
+import { BUNDLE_FORMAT, BUNDLE_VERSION, } from "./exportProject.js";
+/** Read and validate a bundle file. Throws on malformed or unsupported version. */
+export function readBundle(bundlePath) {
+    const compressed = readFileSync(bundlePath);
+    const json = gunzipSync(compressed).toString("utf-8");
+    const bundle = JSON.parse(json);
+    if (bundle?.manifest?.format !== BUNDLE_FORMAT) {
+        throw new Error(`Not a Gnosys project bundle: format = ${bundle?.manifest?.format ?? "<missing>"}`);
+    }
+    if (bundle.manifest.version !== BUNDLE_VERSION) {
+        throw new Error(`Unsupported bundle version ${bundle.manifest.version} (expected ${BUNDLE_VERSION})`);
+    }
+    return bundle;
+}
+function portableToDbMemory(p) {
+    const { embedding_b64, ...rest } = p;
+    return {
+        ...rest,
+        embedding: embedding_b64 ? Buffer.from(embedding_b64, "base64") : null,
+    };
+}
+/** Restore a bundle into the central DB. Returns counts and the final project ID. */
+export function importProject(db, opts) {
+    const strategy = opts.strategy ?? "merge";
+    const bundle = readBundle(opts.bundlePath);
+    let project = bundle.project;
+    if (opts.workingDirectoryOverride) {
+        project = { ...project, working_directory: opts.workingDirectoryOverride };
+    }
+    const existing = db.getProject(project.id);
+    let projectId = project.id;
+    let memoryIdRewrites = new Map();
+    let memoriesReplaced = 0;
+    if (existing) {
+        if (strategy === "replace") {
+            // Delete all of the existing project's memories before re-inserting
+            const existingMems = db.getMemoriesByProject(project.id, true);
+            for (const mem of existingMems) {
+                db.deleteMemory(mem.id);
+                memoriesReplaced++;
+            }
+            db.insertProject(project);
+        }
+        else if (strategy === "new-id") {
+            // Generate a fresh project id; remap memory project_ids during insert
+            projectId = `${project.id}-imported-${Date.now().toString(36)}`;
+            db.insertProject({ ...project, id: projectId });
+        }
+        else {
+            // merge — keep existing project row; bundle memories get inserted under it
+            // (no project upsert)
+        }
+    }
+    else {
+        db.insertProject({ ...project, id: projectId });
+    }
+    let memoriesInserted = 0;
+    let memoriesSkipped = 0;
+    for (const portable of bundle.memories) {
+        const candidate = portableToDbMemory(portable);
+        let id = candidate.id;
+        if (strategy === "new-id" && projectId !== bundle.project.id) {
+            id = `${candidate.id}-imp${Date.now().toString(36).slice(-4)}`;
+            memoryIdRewrites.set(candidate.id, id);
+        }
+        const existingMem = db.getMemory(id);
+        if (existingMem) {
+            if (strategy === "merge") {
+                memoriesSkipped++;
+                continue;
+            }
+            if (strategy === "replace") {
+                db.deleteMemory(id);
+                memoriesReplaced++;
+            }
+        }
+        const toInsert = {
+            ...candidate,
+            id,
+            project_id: projectId,
+        };
+        db.insertMemory(toInsert);
+        memoriesInserted++;
+    }
+    // Relationships — apply the same id rewrites if any
+    let relationshipsInserted = 0;
+    for (const rel of bundle.relationships) {
+        const sourceId = memoryIdRewrites.get(rel.source_id) ?? rel.source_id;
+        const targetId = memoryIdRewrites.get(rel.target_id) ?? rel.target_id;
+        try {
+            db.insertRelationship({
+                ...rel,
+                source_id: sourceId,
+                target_id: targetId,
+            });
+            relationshipsInserted++;
+        }
+        catch {
+            // Duplicate primary key (source, target, type) — skip silently in merge mode
+        }
+    }
+    // Audit log — append-only restoration; no rewrites needed since audit
+    // is keyed by autoincrement id which the DB regenerates.
+    let auditEntriesInserted = 0;
+    for (const entry of bundle.audit_log) {
+        const memoryId = entry.memory_id ? (memoryIdRewrites.get(entry.memory_id) ?? entry.memory_id) : null;
+        db.logAudit({
+            timestamp: entry.timestamp,
+            operation: entry.operation,
+            memory_id: memoryId,
+            details: entry.details,
+            duration_ms: entry.duration_ms,
+            trace_id: entry.trace_id,
+        });
+        auditEntriesInserted++;
+    }
+    return {
+        projectId,
+        projectName: project.name,
+        strategy,
+        memoriesInserted,
+        memoriesSkipped,
+        memoriesReplaced,
+        relationshipsInserted,
+        auditEntriesInserted,
+    };
+}
+//# sourceMappingURL=importProject.js.map

package/dist/lib/importProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importProject.js","sourceRoot":"","sources":["../../src/lib/importProject.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,EACL,aAAa,EACb,cAAc,GAGf,MAAM,oBAAoB,CAAC;AA4B5B,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;IAEjD,IAAI,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,yCAAyC,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,WAAW,EAAE,CACnF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,CAAC,QAAQ,CAAC,OAAO,cAAc,cAAc,GAAG,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAiB;IAC3C,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;KACvE,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAC3B,EAAY,EACZ,IAA0B;IAE1B,MAAM,QAAQ,GAAmB,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE3C,IAAI,OAAO,GAAc,MAAM,CAAC,OAAO,CAAC;IACxC,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,iBAAiB,EAAE,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3C,IAAI,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;IAC3B,IAAI,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,oEAAoE;YACpE,MAAM,YAAY,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC/D,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACxB,gBAAgB,EAAE,CAAC;YACrB,CAAC;YACD,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,sEAAsE;YACtE,SAAS,GAAG,GAAG,OAAO,CAAC,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAChE,EAAE,CAAC,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,2EAA2E;YAC3E,sBAAsB;QACxB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;QAEtB,IAAI,QAAQ,KAAK,QAAQ,IAAI,SAAS,KAAK,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAC7D,EAAE,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,eAAe,EAAE,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBACpB,gBAAgB,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG;YACf,GAAG,SAAS;YACZ,EAAE;YACF,UAAU,EAAE,SAAS;SACtB,CAAC;QACF,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1B,gBAAgB,EAAE,CAAC;IACrB,CAAC;IAED,oDAAoD;IACpD,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;QACtE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC;QACtE,IAAI,CAAC;YACH,EAAE,CAAC,kBAAkB,CAAC;gBACpB,GAAG,GAAG;gBACN,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;YACH,qBAAqB,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,6EAA6E;QAC/E,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,yDAAyD;IACzD,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrG,EAAE,CAAC,QAAQ,CAAC;YACV,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,SAAS,EAAE,QAAQ;YACnB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,oBAAoB,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,SAAS;QACT,WAAW,EAAE,OAAO,CAAC,IAAI;QACzB,QAAQ;QACR,gBAAgB;QAChB,eAAe;QACf,gBAAgB;QAChB,qBAAqB;QACrB,oBAAoB;KACrB,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnosys",
-  "version": "5.5.0",
+  "version": "5.6.0",
   "description": "Gnosys — Persistent Memory for AI Agents. Sandbox-first runtime, central SQLite brain, federated search, Dream Mode, Web Knowledge Base, Obsidian export.",
   "type": "module",
   "main": "dist/index.js",
@@ -37,8 +37,13 @@
     "dotenv": "^17.3.1",
     "glob": "^13.0.6",
     "gray-matter": "^4.0.3",
+    "ink": "^7.0.1",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
     "mammoth": "^1.12.0",
     "pdf-parse": "^2.4.5",
+    "react": "^19.2.5",
     "turndown": "^7.2.2",
     "ulidx": "^2.4.1",
     "zod": "^4.3.6"
@@ -46,6 +51,7 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.10.0",
+    "@types/react": "^19.2.14",
     "@types/turndown": "^5.0.6",
     "@vitest/coverage-v8": "^4.1.0",
     "tsx": "^4.19.0",