@pcircle/memesh 2.10.0 → 2.11.0

package/dist/cli/view.js

@@ -0,0 +1,484 @@
+#!/usr/bin/env node
+import Database from 'better-sqlite3';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execFile } from 'child_process';
+import { fileURLToPath } from 'url';
+function queryData(dbPath) {
+    const emptyData = {
+        entities: [],
+        relations: [],
+        stats: {
+            totalEntities: 0,
+            totalObservations: 0,
+            totalRelations: 0,
+            totalTags: 0,
+            typeDistribution: {},
+            tagDistribution: {},
+        },
+    };
+    if (!fs.existsSync(dbPath)) {
+        return emptyData;
+    }
+    let db;
+    try {
+        db = new Database(dbPath, { readonly: true });
+    }
+    catch (err) {
+        console.error(`[memesh-view] Cannot open database at ${dbPath}: ${err.message}`);
+        return emptyData;
+    }
+    try {
+        const tables = db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name IN ('entities', 'observations', 'relations', 'tags')")
+            .all()
+            .map((r) => r.name);
+        if (!tables.includes('entities')) {
+            return emptyData;
+        }
+        const entityRows = db
+            .prepare('SELECT id, name, type FROM entities LIMIT 5000')
+            .all();
+        const obsRows = tables.includes('observations')
+            ? db
+                .prepare('SELECT entity_id, content FROM observations')
+                .all()
+            : [];
+        const tagRows = tables.includes('tags')
+            ? db.prepare('SELECT entity_id, tag FROM tags').all()
+            : [];
+        const relationRows = tables.includes('relations')
+            ? db
+                .prepare('SELECT from_entity_id, to_entity_id, relation_type FROM relations')
+                .all()
+            : [];
+        const entityMap = new Map();
+        for (const e of entityRows) {
+            entityMap.set(e.id, e.name);
+        }
+        const obsByEntity = new Map();
+        for (const o of obsRows) {
+            const arr = obsByEntity.get(o.entity_id) ?? [];
+            arr.push(o.content);
+            obsByEntity.set(o.entity_id, arr);
+        }
+        const tagsByEntity = new Map();
+        for (const t of tagRows) {
+            const arr = tagsByEntity.get(t.entity_id) ?? [];
+            arr.push(t.tag);
+            tagsByEntity.set(t.entity_id, arr);
+        }
+        const entities = entityRows.map((e) => ({
+            id: e.id,
+            name: e.name,
+            type: e.type,
+            observations: obsByEntity.get(e.id) ?? [],
+            tags: tagsByEntity.get(e.id) ?? [],
+        }));
+        const relations = relationRows
+            .filter((r) => entityMap.has(r.from_entity_id) && entityMap.has(r.to_entity_id))
+            .map((r) => ({
+            from: entityMap.get(r.from_entity_id),
+            to: entityMap.get(r.to_entity_id),
+            type: r.relation_type,
+        }));
+        const typeDistribution = {};
+        for (const e of entityRows) {
+            typeDistribution[e.type] = (typeDistribution[e.type] ?? 0) + 1;
+        }
+        const tagDistribution = {};
+        for (const t of tagRows) {
+            tagDistribution[t.tag] = (tagDistribution[t.tag] ?? 0) + 1;
+        }
+        return {
+            entities,
+            relations,
+            stats: {
+                totalEntities: entityRows.length,
+                totalObservations: obsRows.length,
+                totalRelations: relationRows.length,
+                totalTags: tagRows.length,
+                typeDistribution,
+                tagDistribution,
+            },
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+function escapeJsonForHtml(json) {
+    return json
+        .replace(/&/g, '\\u0026')
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+export function generateDashboardHtml(dbPath) {
+    const resolvedPath = dbPath ??
+        process.env.MEMESH_DB_PATH ??
+        path.join(os.homedir(), '.memesh', 'knowledge-graph.db');
+    const data = queryData(resolvedPath);
+    const dataJson = escapeJsonForHtml(JSON.stringify(data));
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>MeMesh Dashboard</title>
+  <!-- d3.js for force-directed graph -->
+  <script src="https://d3js.org/d3.v7.min.js"><\/script>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+      background: #0d1117; color: #c9d1d9; line-height: 1.5;
+    }
+    .container { max-width: 1400px; margin: 0 auto; padding: 24px; }
+    h1 { font-size: 28px; margin-bottom: 24px; color: #f0f6fc; }
+    h2 { font-size: 20px; margin-bottom: 12px; color: #f0f6fc; }
+
+    /* Stats cards */
+    .stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 16px; margin-bottom: 32px; }
+    .stat-card {
+      background: #161b22; border: 1px solid #30363d; border-radius: 8px;
+      padding: 20px; text-align: center;
+    }
+    .stat-card .value { font-size: 36px; font-weight: 700; color: #58a6ff; }
+    .stat-card .label { font-size: 14px; color: #8b949e; margin-top: 4px; }
+
+    /* Graph */
+    .graph-container {
+      background: #161b22; border: 1px solid #30363d; border-radius: 8px;
+      margin-bottom: 32px; overflow: hidden;
+    }
+    .graph-container svg { width: 100%; height: 500px; display: block; }
+    .graph-container svg text { fill: #c9d1d9; font-size: 11px; pointer-events: none; }
+    .link-label { fill: #484f58; font-size: 9px; }
+
+    /* Tables */
+    .tables { display: grid; grid-template-columns: 1fr 1fr; gap: 24px; margin-bottom: 32px; }
+    @media (max-width: 800px) { .tables { grid-template-columns: 1fr; } }
+    .table-section { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 16px; }
+    table { width: 100%; border-collapse: collapse; }
+    th, td { padding: 8px 12px; text-align: left; border-bottom: 1px solid #21262d; }
+    th { color: #8b949e; font-size: 12px; text-transform: uppercase; letter-spacing: 0.5px; }
+    td { font-size: 14px; }
+
+    /* Entity table */
+    .entity-section { margin-bottom: 32px; }
+    .search-box {
+      width: 100%; padding: 10px 14px; margin-bottom: 16px;
+      background: #0d1117; border: 1px solid #30363d; border-radius: 6px;
+      color: #c9d1d9; font-size: 14px; outline: none;
+    }
+    .search-box:focus { border-color: #58a6ff; }
+    .entity-table-wrap {
+      background: #161b22; border: 1px solid #30363d; border-radius: 8px;
+      overflow: auto; max-height: 500px;
+    }
+
+    /* Tooltip */
+    .tooltip {
+      position: absolute; pointer-events: none; background: #1c2128;
+      border: 1px solid #30363d; border-radius: 6px; padding: 10px 14px;
+      font-size: 13px; max-width: 300px; display: none; z-index: 10;
+    }
+    .tooltip .tt-name { font-weight: 600; color: #f0f6fc; }
+    .tooltip .tt-type { color: #8b949e; font-size: 12px; }
+    .tooltip .tt-obs { margin-top: 6px; color: #c9d1d9; white-space: pre-line; }
+  </style>
+</head>
+<body>
+<div class="container">
+  <h1>MeMesh Dashboard</h1>
+
+  <div class="stats" id="stats"></div>
+
+  <h2>Knowledge Graph</h2>
+  <div class="graph-container"><svg id="graph"></svg></div>
+
+  <div class="entity-section">
+    <h2>Entities</h2>
+    <input class="search-box" id="search" type="text" placeholder="Search entities...">
+    <div class="entity-table-wrap">
+      <table>
+        <thead><tr><th>Name</th><th>Type</th><th>Observations</th><th>Tags</th></tr></thead>
+        <tbody id="entity-tbody"></tbody>
+      </table>
+    </div>
+  </div>
+
+  <div class="tables">
+    <div class="table-section">
+      <h2>Type Distribution</h2>
+      <table><thead><tr><th>Type</th><th>Count</th></tr></thead><tbody id="type-tbody"></tbody></table>
+    </div>
+    <div class="table-section">
+      <h2>Tag Distribution</h2>
+      <table><thead><tr><th>Tag</th><th>Count</th></tr></thead><tbody id="tag-tbody"></tbody></table>
+    </div>
+  </div>
+</div>
+
+<div class="tooltip" id="tooltip">
+  <div class="tt-name"></div>
+  <div class="tt-type"></div>
+  <div class="tt-obs"></div>
+</div>
+
+<script>
+const DATA = ${dataJson};
+
+// Safe text escaping for DOM insertion
+function esc(s) { var d = document.createElement('div'); d.textContent = s; return d.innerHTML; }
+
+// --- Stats ---
+(function renderStats() {
+  var s = DATA.stats;
+  var cards = [
+    { label: 'Entities', value: s.totalEntities },
+    { label: 'Observations', value: s.totalObservations },
+    { label: 'Relations', value: s.totalRelations },
+    { label: 'Tags', value: s.totalTags },
+  ];
+  var el = document.getElementById('stats');
+  el.textContent = '';
+  cards.forEach(function(c) {
+    var card = document.createElement('div');
+    card.className = 'stat-card';
+    var val = document.createElement('div');
+    val.className = 'value';
+    val.textContent = String(c.value);
+    var lbl = document.createElement('div');
+    lbl.className = 'label';
+    lbl.textContent = c.label;
+    card.appendChild(val);
+    card.appendChild(lbl);
+    el.appendChild(card);
+  });
+})();
+
+// --- Entity table ---
+function renderEntityTable(filter) {
+  var f = (filter || '').toLowerCase();
+  var tbody = document.getElementById('entity-tbody');
+  tbody.textContent = '';
+  var filtered = DATA.entities.filter(function(e) {
+    return !f || e.name.toLowerCase().includes(f) || e.type.toLowerCase().includes(f);
+  });
+  if (filtered.length === 0) {
+    var tr = document.createElement('tr');
+    var td = document.createElement('td');
+    td.colSpan = 4;
+    td.style.textAlign = 'center';
+    td.style.color = '#8b949e';
+    td.textContent = 'No entities';
+    tr.appendChild(td);
+    tbody.appendChild(tr);
+    return;
+  }
+  filtered.forEach(function(e) {
+    var tr = document.createElement('tr');
+    var tdName = document.createElement('td'); tdName.textContent = e.name;
+    var tdType = document.createElement('td'); tdType.textContent = e.type;
+    var tdObs = document.createElement('td'); tdObs.textContent = String(e.observations.length);
+    var tdTags = document.createElement('td'); tdTags.textContent = e.tags.join(', ');
+    tr.appendChild(tdName); tr.appendChild(tdType); tr.appendChild(tdObs); tr.appendChild(tdTags);
+    tbody.appendChild(tr);
+  });
+}
+document.getElementById('search').addEventListener('input', function() { renderEntityTable(this.value); });
+renderEntityTable('');
+
+// --- Distribution tables ---
+(function renderDistributions() {
+  function fillTable(tbodyId, data) {
+    var tbody = document.getElementById(tbodyId);
+    tbody.textContent = '';
+    var entries = Object.entries(data).sort(function(a, b) { return b[1] - a[1]; });
+    if (entries.length === 0) {
+      var tr = document.createElement('tr');
+      var td = document.createElement('td');
+      td.colSpan = 2; td.style.textAlign = 'center'; td.style.color = '#8b949e';
+      td.textContent = 'No data';
+      tr.appendChild(td); tbody.appendChild(tr);
+      return;
+    }
+    entries.forEach(function(pair) {
+      var tr = document.createElement('tr');
+      var tdKey = document.createElement('td'); tdKey.textContent = pair[0];
+      var tdVal = document.createElement('td'); tdVal.textContent = String(pair[1]);
+      tr.appendChild(tdKey); tr.appendChild(tdVal); tbody.appendChild(tr);
+    });
+  }
+  fillTable('type-tbody', DATA.stats.typeDistribution);
+  fillTable('tag-tbody', DATA.stats.tagDistribution);
+})();
+
+// --- D3.js Force Graph ---
+(function renderGraph() {
+  if (DATA.relations.length === 0 && DATA.entities.length === 0) return;
+
+  var svg = d3.select('#graph');
+  var width = svg.node().getBoundingClientRect().width || 800;
+
+  // Only show the most connected entities to keep graph readable
+  var MAX_GRAPH_NODES = 40;
+  var degreeMap = {};
+  DATA.relations.forEach(function(r) {
+    degreeMap[r.from] = (degreeMap[r.from] || 0) + 1;
+    degreeMap[r.to] = (degreeMap[r.to] || 0) + 1;
+  });
+
+  // Sort by connection count, take top N
+  var topNames = Object.entries(degreeMap)
+    .sort(function(a, b) { return b[1] - a[1]; })
+    .slice(0, MAX_GRAPH_NODES)
+    .map(function(e) { return e[0]; });
+  var topSet = new Set(topNames);
+
+  // If no relations, show top 50 entities instead
+  var graphEntities = topSet.size > 0
+    ? DATA.entities.filter(function(e) { return topSet.has(e.name); })
+    : DATA.entities.slice(0, 50);
+
+  if (graphEntities.length === 0) return;
+
+  // Scale height based on node count
+  var height = Math.max(500, Math.min(700, graphEntities.length * 6));
+  svg.attr('viewBox', [0, 0, width, height]);
+  svg.style('height', height + 'px');
+
+  var color = d3.scaleOrdinal(d3.schemeTableau10);
+
+  var nodes = graphEntities.map(function(e) {
+    return {
+      id: e.name,
+      type: e.type,
+      observations: e.observations,
+      radius: 6 + Math.min(e.observations.length, 5),
+    };
+  });
+
+  var nameSet = new Set(nodes.map(function(n) { return n.id; }));
+  var links = DATA.relations
+    .filter(function(r) { return nameSet.has(r.from) && nameSet.has(r.to); })
+    .map(function(r) { return { source: r.from, target: r.to, type: r.type }; });
+
+  var simulation = d3.forceSimulation(nodes)
+    .force('link', d3.forceLink(links).id(function(d) { return d.id; }).distance(200))
+    .force('charge', d3.forceManyBody().strength(-500))
+    .force('center', d3.forceCenter(width / 2, height / 2))
+    .force('collision', d3.forceCollide().radius(function(d) { return d.radius + 4; }));
+
+  var g = svg.append('g');
+
+  // Zoom
+  svg.call(d3.zoom().scaleExtent([0.2, 5]).on('zoom', function(event) {
+    g.attr('transform', event.transform);
+  }));
+
+  // Links
+  var link = g.append('g')
+    .selectAll('line')
+    .data(links)
+    .join('line')
+    .attr('stroke', '#30363d')
+    .attr('stroke-width', 1.5);
+
+  // Link labels
+  var linkLabel = g.append('g')
+    .selectAll('text')
+    .data(links)
+    .join('text')
+    .attr('class', 'link-label')
+    .text(function(d) { return d.type; });
+
+  // Nodes
+  var node = g.append('g')
+    .selectAll('circle')
+    .data(nodes)
+    .join('circle')
+    .attr('r', function(d) { return d.radius; })
+    .attr('fill', function(d) { return color(d.type); })
+    .attr('stroke', '#0d1117')
+    .attr('stroke-width', 1.5)
+    .call(drag(simulation));
+
+  // Node labels
+  var label = g.append('g')
+    .selectAll('text')
+    .data(nodes)
+    .join('text')
+    .text(function(d) { return d.id.length > 35 ? d.id.slice(0, 35) + '...' : d.id; })
+    .attr('dx', function(d) { return d.radius + 4; })
+    .attr('dy', 4);
+
+  // Tooltip
+  var tooltipEl = document.getElementById('tooltip');
+  node.on('mouseover', function(event, d) {
+    tooltipEl.style.display = 'block';
+    tooltipEl.querySelector('.tt-name').textContent = d.id;
+    tooltipEl.querySelector('.tt-type').textContent = d.type;
+    tooltipEl.querySelector('.tt-obs').textContent = d.observations.slice(0, 3).join('\\n');
+  }).on('mousemove', function(event) {
+    tooltipEl.style.left = (event.pageX + 12) + 'px';
+    tooltipEl.style.top = (event.pageY - 10) + 'px';
+  }).on('mouseout', function() {
+    tooltipEl.style.display = 'none';
+  });
+
+  simulation.on('tick', function() {
+    link
+      .attr('x1', function(d) { return d.source.x; }).attr('y1', function(d) { return d.source.y; })
+      .attr('x2', function(d) { return d.target.x; }).attr('y2', function(d) { return d.target.y; });
+    linkLabel
+      .attr('x', function(d) { return (d.source.x + d.target.x) / 2; })
+      .attr('y', function(d) { return (d.source.y + d.target.y) / 2; });
+    node.attr('cx', function(d) { return d.x; }).attr('cy', function(d) { return d.y; });
+    label.attr('x', function(d) { return d.x; }).attr('y', function(d) { return d.y; });
+  });
+
+  function drag(simulation) {
+    return d3.drag()
+      .on('start', function(event, d) {
+        if (!event.active) simulation.alphaTarget(0.3).restart();
+        d.fx = d.x; d.fy = d.y;
+      })
+      .on('drag', function(event, d) { d.fx = event.x; d.fy = event.y; })
+      .on('end', function(event, d) {
+        if (!event.active) simulation.alphaTarget(0);
+        d.fx = null; d.fy = null;
+      });
+  }
+})();
+<\/script>
+</body>
+</html>`;
+}
+const isDirectRun = process.argv[1] &&
+    fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+if (isDirectRun) {
+    const dbPath = process.env.MEMESH_DB_PATH ??
+        path.join(os.homedir(), '.memesh', 'knowledge-graph.db');
+    const html = generateDashboardHtml(dbPath);
+    const outPath = path.join(os.tmpdir(), 'memesh-dashboard.html');
+    fs.writeFileSync(outPath, html, 'utf-8');
+    const platform = process.platform;
+    const cmd = platform === 'darwin' ? 'open' : 'xdg-open';
+    const args = platform === 'win32' ? ['/c', 'start', '', outPath] : [outPath];
+    const bin = platform === 'win32' ? 'cmd.exe' : cmd;
+    execFile(bin, args, (err) => {
+        if (err) {
+            console.error(`Could not open browser: ${err.message}`);
+            console.log(`Dashboard written to: ${outPath}`);
+        }
+        else {
+            console.log(`Dashboard opened: ${outPath}`);
+        }
+    });
+}
+//# sourceMappingURL=view.js.map

package/dist/cli/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../src/cli/view.ts"],"names":[],"mappings":";AAEA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAyBpC,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,SAAS,GAAkB;QAC/B,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,KAAK,EAAE;YACL,aAAa,EAAE,CAAC;YAChB,iBAAiB,EAAE,CAAC;YACpB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC;YACZ,gBAAgB,EAAE,EAAE;YACpB,eAAe,EAAE,EAAE;SACpB;KACF,CAAC;IAEF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,EAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,yCAAyC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QAEH,MAAM,MAAM,GAAG,EAAE;aACd,OAAO,CACN,iHAAiH,CAClH;aACA,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC;QAErC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QAGD,MAAM,UAAU,GAAG,EAAE;aAClB,OAAO,CAAC,gDAAgD,CAAC;aACzD,GAAG,EAAuD,CAAC;QAG9D,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC7C,CAAC,CAAE,EAAE;iBACA,OAAO,CAAC,6CAA6C,CAAC;iBACtD,GAAG,EAAoD;YAC5D,CAAC,CAAC,EAAE,CAAC;QAGP,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,CAAC,CAAE,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,GAAG,EAG/C;YACL,CAAC,CAAC,EAAE,CAAC;QAGP,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC/C,CAAC,CAAE,EAAE;iBACA,OAAO,CACN,mEAAmE,CACpE;iBACA,GAAG,EAIH;YACL,CAAC,CAAC,EAAE,CAAC;QAGP,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAGD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACpB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QAGD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAChD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAChB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QAGD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE;YACzC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE;SACnC,CAAC,CAAC,CAAC;QAGJ,MAAM,SAAS,GAAG,YAAY;aAC3B,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CACxE;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAE;YACtC,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAE;YAClC,IAAI,EAAE,CAAC,CAAC,aAAa;SACtB,CAAC,CAAC,CAAC;QAGN,MAAM,gBAAgB,GAA2B,EAAE,CAAC;QACpD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;QAGD,MAAM,eAAe,GAA2B,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO;YACL,QAAQ;YACR,SAAS;YACT,KAAK,EAAE;gBACL,aAAa,EAAE,UAAU,CAAC,MAAM;gBAChC,iBAAiB,EAAE,OAAO,CAAC,MAAM;gBACjC,cAAc,EAAE,YAAY,CAAC,MAAM;gBACnC,SAAS,EAAE,OAAO,CAAC,MAAM;gBACzB,gBAAgB;gBAChB,eAAe;aAChB;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAKD,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAMD,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,MAAM,YAAY,GAChB,MAAM;QACN,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA4GM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAmOf,CAAC;AACT,CAAC;AAGD,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACf,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnE,IAAI,WAAW,EAAE,CAAC;IAChB,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC;IAChE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAGzC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IACxD,MAAM,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAEnD,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1B,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,KAAK,CAAC,2BAA2B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,5 @@
+import Database from 'better-sqlite3';
+export declare function openDatabase(dbPath?: string): Database.Database;
+export declare function closeDatabase(): void;
+export declare function getDatabase(): Database.Database;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAyDtC,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAiB/D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAG/C"}

package/dist/db.js

@@ -0,0 +1,80 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+let db = null;
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS entities (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  type TEXT NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  metadata JSON
+);
+
+CREATE TABLE IF NOT EXISTS observations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_id INTEGER NOT NULL,
+  content TEXT NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE TABLE IF NOT EXISTS relations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_entity_id INTEGER NOT NULL,
+  to_entity_id INTEGER NOT NULL,
+  relation_type TEXT NOT NULL,
+  metadata JSON,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY (from_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+  FOREIGN KEY (to_entity_id) REFERENCES entities(id) ON DELETE CASCADE,
+  UNIQUE(from_entity_id, to_entity_id, relation_type)
+);
+
+CREATE TABLE IF NOT EXISTS tags (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_id INTEGER NOT NULL,
+  tag TEXT NOT NULL,
+  FOREIGN KEY (entity_id) REFERENCES entities(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_tags_entity ON tags(entity_id);
+CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+CREATE INDEX IF NOT EXISTS idx_observations_entity ON observations(entity_id);
+CREATE INDEX IF NOT EXISTS idx_relations_from ON relations(from_entity_id);
+CREATE INDEX IF NOT EXISTS idx_relations_to ON relations(to_entity_id);
+`;
+const FTS_SQL = `
+CREATE VIRTUAL TABLE IF NOT EXISTS entities_fts USING fts5(
+  name, observations, content='',
+  tokenize='unicode61 remove_diacritics 1'
+);
+`;
+export function openDatabase(dbPath) {
+    if (db)
+        return db;
+    const resolvedPath = dbPath
+        ?? process.env.MEMESH_DB_PATH
+        ?? path.join(os.homedir(), '.memesh', 'knowledge-graph.db');
+    const dir = path.dirname(resolvedPath);
+    fs.mkdirSync(dir, { recursive: true });
+    db = new Database(resolvedPath);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    db.exec(SCHEMA_SQL);
+    db.exec(FTS_SQL);
+    return db;
+}
+export function closeDatabase() {
+    if (db) {
+        db.close();
+        db = null;
+    }
+}
+export function getDatabase() {
+    if (!db)
+        throw new Error('Database not opened');
+    return db;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,IAAI,EAAE,GAA6B,IAAI,CAAC;AAExC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyClB,CAAC;AAEF,MAAM,OAAO,GAAG;;;;;CAKf,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAe;IAC1C,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,YAAY,GAAG,MAAM;WACtB,OAAO,CAAC,GAAG,CAAC,cAAc;WAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAE9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,EAAE,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpB,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,4 @@
-export * from './telemetry/index.js';
-export { MCPToolInterface } from './core/MCPToolInterface.js';
-export { CheckpointDetector } from './core/CheckpointDetector.js';
-export type { ToolMetadata, ToolInvocationResult, ToolDependencyCheck } from './core/MCPToolInterface.js';
-export type { CheckpointCallback, CheckpointMetadata, CheckpointTriggerResult } from './core/CheckpointDetector.js';
-export { Checkpoint } from './types/Checkpoint.js';
+export { openDatabase, closeDatabase, getDatabase } from './db.js';
+export { KnowledgeGraph } from './knowledge-graph.js';
+export type { Entity, Relation, CreateEntityInput, SearchOptions } from './knowledge-graph.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+CA,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC1G,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGpH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,34 +1,3 @@
-import { logger } from './utils/logger.js';
-async function main() {
-    logger.info('🤖 MeMesh starting...');
-    logger.info('Mode: MCP Server (local knowledge graph + memory)');
-    logger.info('\n✅ MeMesh ready!');
-    logger.info('Use as MCP server via Claude Code, Cursor, or other MCP clients.\n');
-}
-async function shutdown(signal) {
-    logger.info(`\n${signal} received. Shutting down gracefully...`);
-    const shutdownTimeout = setTimeout(() => {
-        logger.error('⚠️  Shutdown timeout reached (5s), forcing exit');
-        process.exit(1);
-    }, 5000);
-    try {
-        clearTimeout(shutdownTimeout);
-        process.exit(0);
-    }
-    catch (error) {
-        logger.error('Error during shutdown:', error);
-        clearTimeout(shutdownTimeout);
-        process.exit(1);
-    }
-}
-process.once('SIGTERM', () => shutdown('SIGTERM'));
-process.once('SIGINT', () => shutdown('SIGINT'));
-main().catch((error) => {
-    logger.error('Failed to start MeMesh:', error);
-    process.exit(1);
-});
-export * from './telemetry/index.js';
-export { MCPToolInterface } from './core/MCPToolInterface.js';
-export { CheckpointDetector } from './core/CheckpointDetector.js';
-export { Checkpoint } from './types/Checkpoint.js';
+export { openDatabase, closeDatabase, getDatabase } from './db.js';
+export { KnowledgeGraph } from './knowledge-graph.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAEjE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACjC,MAAM,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;AACpF,CAAC;AAKD,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,wCAAwC,CAAC,CAAC;IAEjE,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE;QACtC,MAAM,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,IAAI,CAAC;QACH,YAAY,CAAC,eAAe,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC9C,YAAY,CAAC,eAAe,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAGD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAGjD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAGH,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAOlE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}