npm - engrm - Versions diffs - 0.2.1 → 0.2.3 - Mend

engrm 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/cli.js +33 -10
package/dist/hooks/session-start.js +291 -0
package/dist/hooks/stop.js +18 -0
package/package.json +1 -1

package/dist/cli.js CHANGED Viewed

@@ -1075,21 +1075,44 @@ async function openBrowser(url) {
     return false;
   }
 }
+var PAGE_STYLE = `
+*{margin:0;padding:0;box-sizing:border-box}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#06060e;color:#fff;min-height:100vh;display:flex;align-items:center;justify-content:center;padding:24px}
+body::before{content:'';position:fixed;inset:0;z-index:-1;background:radial-gradient(ellipse at 30% 20%,rgba(0,212,255,0.06) 0%,transparent 50%),radial-gradient(ellipse at 70% 80%,rgba(123,44,191,0.06) 0%,transparent 50%)}
+.card{width:100%;max-width:440px;padding:48px 40px;border-radius:16px;border:1px solid rgba(255,255,255,0.07);background:rgba(255,255,255,0.02);backdrop-filter:blur(20px);text-align:center}
+.logo{display:flex;align-items:center;justify-content:center;gap:12px;margin-bottom:28px}
+.logo span{font-size:1.3rem;font-weight:700}
+.icon{width:56px;height:56px;border-radius:50%;display:flex;align-items:center;justify-content:center;margin:0 auto 20px}
+.icon.success{background:rgba(16,185,129,0.12);border:2px solid rgba(16,185,129,0.3)}
+.icon.error{background:rgba(239,68,68,0.12);border:2px solid rgba(239,68,68,0.3)}
+h1{font-size:1.4rem;font-weight:700;margin-bottom:8px}
+p{color:rgba(255,255,255,0.6);font-size:0.9rem;line-height:1.5}
+.hint{margin-top:24px;padding:12px 16px;font-size:0.82rem;color:rgba(255,255,255,0.4);background:rgba(255,255,255,0.02);border:1px solid rgba(255,255,255,0.06);border-radius:8px}
+a{color:#00d4ff;text-decoration:none}
+`;
+var LOGO_SVG = `<svg viewBox="0 0 40 40" fill="none" xmlns="http://www.w3.org/2000/svg" style="width:32px;height:32px"><rect width="40" height="40" rx="10" fill="#0c0c1e"/><rect x="0.5" y="0.5" width="39" height="39" rx="9.5" stroke="rgba(255,255,255,0.08)"/><path d="M12 12h10M12 20h8M12 28h10M12 12v16" stroke="white" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/><circle cx="13" cy="7" r="3" fill="#00d4ff"/><circle cx="33" cy="33" r="3" fill="#7b2cbf"/></svg>`;
 function successPage() {
   return `<!DOCTYPE html>
-<html><head><title>Engrm</title>
-<style>body{font-family:system-ui;display:flex;justify-content:center;align-items:center;min-height:100vh;margin:0;background:#f8f9fa}
-.card{text-align:center;padding:3rem;border-radius:12px;background:white;box-shadow:0 2px 12px rgba(0,0,0,0.1)}
-h1{color:#10b981;margin-bottom:0.5rem}p{color:#6b7280}</style></head>
-<body><div class="card"><h1>Connected!</h1><p>You can close this tab and return to the terminal.</p></div></body></html>`;
+<html><head><title>Engrm — Connected</title><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect rx='6' width='32' height='32' fill='%230c0c1e'/><text x='7' y='24' font-family='system-ui' font-weight='700' font-size='22' fill='white'>E</text><circle cx='10' cy='6' r='3' fill='%2300d4ff'/><circle cx='26' cy='26' r='3' fill='%237b2cbf'/></svg>"><style>${PAGE_STYLE}</style></head>
+<body><div class="card">
+<div class="logo">${LOGO_SVG}<span>Engrm</span></div>
+<div class="icon success"><svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="#10b981" stroke-width="2.5" stroke-linecap="round"><path d="M20 6L9 17l-5-5"/></svg></div>
+<h1>Connected!</h1>
+<p>Your device is now linked to your Engrm account. Memory will sync automatically across all your devices.</p>
+<div class="hint">You can close this tab and return to the terminal. Your next Claude Code session will have memory.</div>
+</div></body></html>`;
 }
 function errorPage(message) {
+  const safeMessage = message.replace(/[<>&"']/g, (c) => `&#${c.charCodeAt(0)};`);
   return `<!DOCTYPE html>
-<html><head><title>Engrm</title>
-<style>body{font-family:system-ui;display:flex;justify-content:center;align-items:center;min-height:100vh;margin:0;background:#f8f9fa}
-.card{text-align:center;padding:3rem;border-radius:12px;background:white;box-shadow:0 2px 12px rgba(0,0,0,0.1)}
-h1{color:#ef4444;margin-bottom:0.5rem}p{color:#6b7280}</style></head>
-<body><div class="card"><h1>Authorization Failed</h1><p>${message}</p></div></body></html>`;
+<html><head><title>Engrm — Error</title><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><rect rx='6' width='32' height='32' fill='%230c0c1e'/><text x='7' y='24' font-family='system-ui' font-weight='700' font-size='22' fill='white'>E</text><circle cx='10' cy='6' r='3' fill='%2300d4ff'/><circle cx='26' cy='26' r='3' fill='%237b2cbf'/></svg>"><style>${PAGE_STYLE}</style></head>
+<body><div class="card">
+<div class="logo">${LOGO_SVG}<span>Engrm</span></div>
+<div class="icon error"><svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="#ef4444" stroke-width="2.5" stroke-linecap="round"><path d="M18 6L6 18M6 6l12 12"/></svg></div>
+<h1>Authorization Failed</h1>
+<p>${safeMessage}</p>
+<div class="hint">Try running <code style="color:#00d4ff">engrm init</code> again, or use <code style="color:#00d4ff">engrm init --token=cmt_xxx</code> with a provisioning token from <a href="https://engrm.dev">engrm.dev</a>.</div>
+</div></body></html>`;
 }
 // src/register.ts

package/dist/hooks/session-start.js CHANGED Viewed

@@ -1409,6 +1409,288 @@ function recommendPacks(stacks, installedPacks) {
   return recommendations;
 }
+// src/sync/auth.ts
+function getApiKey(config) {
+  const envKey = process.env.ENGRM_TOKEN;
+  if (envKey && envKey.startsWith("cvk_"))
+    return envKey;
+  if (config.candengo_api_key && config.candengo_api_key.length > 0) {
+    return config.candengo_api_key;
+  }
+  return null;
+}
+function getBaseUrl(config) {
+  if (config.candengo_url && config.candengo_url.length > 0) {
+    return config.candengo_url;
+  }
+  return null;
+}
+function buildSourceId(config, localId, type = "obs") {
+  return `${config.user_id}-${config.device_id}-${type}-${localId}`;
+}
+function parseSourceId(sourceId) {
+  const obsIndex = sourceId.lastIndexOf("-obs-");
+  if (obsIndex === -1)
+    return null;
+  const prefix = sourceId.slice(0, obsIndex);
+  const localIdStr = sourceId.slice(obsIndex + 5);
+  const localId = parseInt(localIdStr, 10);
+  if (isNaN(localId))
+    return null;
+  const firstDash = prefix.indexOf("-");
+  if (firstDash === -1)
+    return null;
+  return {
+    userId: prefix.slice(0, firstDash),
+    deviceId: prefix.slice(firstDash + 1),
+    localId
+  };
+}
+// src/embeddings/embedder.ts
+var _available = null;
+var _pipeline = null;
+var MODEL_NAME = "Xenova/all-MiniLM-L6-v2";
+async function embedText(text) {
+  const pipe = await getPipeline();
+  if (!pipe)
+    return null;
+  try {
+    const output = await pipe(text, { pooling: "mean", normalize: true });
+    return new Float32Array(output.data);
+  } catch {
+    return null;
+  }
+}
+function composeEmbeddingText(obs) {
+  const parts = [obs.title];
+  if (obs.narrative)
+    parts.push(obs.narrative);
+  if (obs.facts) {
+    try {
+      const facts = JSON.parse(obs.facts);
+      if (Array.isArray(facts) && facts.length > 0) {
+        parts.push(facts.map((f) => `- ${f}`).join(`
+`));
+      }
+    } catch {
+      parts.push(obs.facts);
+    }
+  }
+  if (obs.concepts) {
+    try {
+      const concepts = JSON.parse(obs.concepts);
+      if (Array.isArray(concepts) && concepts.length > 0) {
+        parts.push(concepts.join(", "));
+      }
+    } catch {}
+  }
+  return parts.join(`
+`);
+}
+async function getPipeline() {
+  if (_pipeline)
+    return _pipeline;
+  if (_available === false)
+    return null;
+  try {
+    const { pipeline } = await import("@xenova/transformers");
+    _pipeline = await pipeline("feature-extraction", MODEL_NAME);
+    _available = true;
+    return _pipeline;
+  } catch (err) {
+    _available = false;
+    console.error(`[engrm] Local embedding model unavailable: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  }
+}
+// src/sync/pull.ts
+var PULL_CURSOR_KEY = "pull_cursor";
+var MAX_PAGES = 20;
+async function pullFromVector(db, client, config, limit = 50) {
+  let cursor = db.getSyncState(PULL_CURSOR_KEY) ?? undefined;
+  let totalReceived = 0;
+  let totalMerged = 0;
+  let totalSkipped = 0;
+  for (let page = 0;page < MAX_PAGES; page++) {
+    const response = await client.pullChanges(cursor, limit);
+    const { merged, skipped } = mergeChanges(db, config, response.changes);
+    totalReceived += response.changes.length;
+    totalMerged += merged;
+    totalSkipped += skipped;
+    if (response.cursor) {
+      db.setSyncState(PULL_CURSOR_KEY, response.cursor);
+      cursor = response.cursor;
+    }
+    if (!response.has_more || response.changes.length === 0)
+      break;
+  }
+  return { received: totalReceived, merged: totalMerged, skipped: totalSkipped };
+}
+function mergeChanges(db, config, changes) {
+  let merged = 0;
+  let skipped = 0;
+  for (const change of changes) {
+    const parsed = parseSourceId(change.source_id);
+    if (parsed && parsed.deviceId === config.device_id) {
+      skipped++;
+      continue;
+    }
+    const existing = db.db.query("SELECT id FROM observations WHERE remote_source_id = ?").get(change.source_id);
+    if (existing) {
+      skipped++;
+      continue;
+    }
+    const projectCanonical = change.metadata?.project_canonical ?? null;
+    if (!projectCanonical) {
+      skipped++;
+      continue;
+    }
+    let project = db.getProjectByCanonicalId(projectCanonical);
+    if (!project) {
+      project = db.upsertProject({
+        canonical_id: projectCanonical,
+        name: change.metadata?.project_name ?? projectCanonical.split("/").pop() ?? "unknown"
+      });
+    }
+    const obs = db.insertObservation({
+      session_id: change.metadata?.session_id ?? null,
+      project_id: project.id,
+      type: change.metadata?.type ?? "discovery",
+      title: change.metadata?.title ?? change.content.split(`
+`)[0] ?? "Untitled",
+      narrative: extractNarrative(change.content),
+      facts: change.metadata?.facts ? JSON.stringify(change.metadata.facts) : null,
+      concepts: change.metadata?.concepts ? JSON.stringify(change.metadata.concepts) : null,
+      quality: change.metadata?.quality ?? 0.5,
+      lifecycle: "active",
+      sensitivity: "shared",
+      user_id: change.metadata?.user_id ?? "unknown",
+      device_id: change.metadata?.device_id ?? "unknown",
+      agent: change.metadata?.agent ?? "unknown"
+    });
+    db.db.query("UPDATE observations SET remote_source_id = ? WHERE id = ?").run(change.source_id, obs.id);
+    if (db.vecAvailable) {
+      embedAndInsert(db, obs).catch(() => {});
+    }
+    merged++;
+  }
+  return { merged, skipped };
+}
+async function embedAndInsert(db, obs) {
+  const text = composeEmbeddingText(obs);
+  const embedding = await embedText(text);
+  if (embedding)
+    db.vecInsert(obs.id, embedding);
+}
+function extractNarrative(content) {
+  const lines = content.split(`
+`);
+  if (lines.length <= 1)
+    return null;
+  const narrative = lines.slice(1).join(`
+`).trim();
+  return narrative.length > 0 ? narrative : null;
+}
+// src/sync/client.ts
+class VectorClient {
+  baseUrl;
+  apiKey;
+  siteId;
+  namespace;
+  constructor(config) {
+    const baseUrl = getBaseUrl(config);
+    const apiKey = getApiKey(config);
+    if (!baseUrl || !apiKey) {
+      throw new Error("VectorClient requires candengo_url and candengo_api_key");
+    }
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+    this.siteId = config.site_id;
+    this.namespace = config.namespace;
+  }
+  static isConfigured(config) {
+    return getApiKey(config) !== null && getBaseUrl(config) !== null;
+  }
+  async ingest(doc) {
+    await this.request("POST", "/v1/ingest", doc);
+  }
+  async batchIngest(docs) {
+    if (docs.length === 0)
+      return;
+    await this.request("POST", "/v1/ingest/batch", { documents: docs });
+  }
+  async search(query, metadataFilter, limit = 10) {
+    const body = { query, limit };
+    if (metadataFilter) {
+      body.metadata_filter = metadataFilter;
+    }
+    return this.request("POST", "/v1/search", body);
+  }
+  async deleteBySourceIds(sourceIds) {
+    if (sourceIds.length === 0)
+      return;
+    await this.request("POST", "/v1/documents/delete", {
+      source_ids: sourceIds
+    });
+  }
+  async pullChanges(cursor, limit = 50) {
+    const params = new URLSearchParams;
+    if (cursor)
+      params.set("cursor", cursor);
+    params.set("namespace", this.namespace);
+    params.set("limit", String(limit));
+    return this.request("GET", `/v1/sync/changes?${params.toString()}`);
+  }
+  async sendTelemetry(beacon) {
+    await this.request("POST", "/v1/mem/telemetry", beacon);
+  }
+  async health() {
+    try {
+      await this.request("GET", "/health");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`,
+      "Content-Type": "application/json"
+    };
+    const init = { method, headers };
+    if (body && method !== "GET") {
+      init.body = JSON.stringify(body);
+    }
+    const response = await fetch(url, init);
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new VectorApiError(response.status, text, path);
+    }
+    if (response.status === 204 || response.headers.get("content-length") === "0") {
+      return;
+    }
+    return response.json();
+  }
+}
+class VectorApiError extends Error {
+  status;
+  body;
+  path;
+  constructor(status, body, path) {
+    super(`Vector API error ${status} on ${path}: ${body}`);
+    this.status = status;
+    this.body = body;
+    this.path = path;
+    this.name = "VectorApiError";
+  }
+}
 // hooks/session-start.ts
 async function main() {
   const chunks = [];
@@ -1435,6 +1717,15 @@ async function main() {
     process.exit(0);
   }
   try {
+    if (config.sync.enabled && config.candengo_api_key) {
+      try {
+        const client = new VectorClient(config.candengo_url, config.candengo_api_key, config.site_id, config.namespace);
+        const pullResult = await pullFromVector(db, client, config, 50);
+        if (pullResult.merged > 0) {
+          console.error(`Engrm: synced ${pullResult.merged} observation(s) from server`);
+        }
+      } catch {}
+    }
     const context = buildSessionContext(db, event.cwd, {
       tokenBudget: 800,
       scope: config.search.scope

package/dist/hooks/stop.js CHANGED Viewed

@@ -1074,6 +1074,24 @@ function getBaseUrl(config) {
 function buildSourceId(config, localId, type = "obs") {
   return `${config.user_id}-${config.device_id}-${type}-${localId}`;
 }
+function parseSourceId(sourceId) {
+  const obsIndex = sourceId.lastIndexOf("-obs-");
+  if (obsIndex === -1)
+    return null;
+  const prefix = sourceId.slice(0, obsIndex);
+  const localIdStr = sourceId.slice(obsIndex + 5);
+  const localId = parseInt(localIdStr, 10);
+  if (isNaN(localId))
+    return null;
+  const firstDash = prefix.indexOf("-");
+  if (firstDash === -1)
+    return null;
+  return {
+    userId: prefix.slice(0, firstDash),
+    deviceId: prefix.slice(firstDash + 1),
+    localId
+  };
+}
 // src/sync/client.ts
 class VectorClient {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "engrm",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Cross-device, team-shared memory layer for AI coding agents",
   "type": "module",
   "main": "dist/server.js",