@ghl-ai/aw 0.1.37-beta.36 → 0.1.37-beta.37

package/memory-sync.mjs

@@ -0,0 +1,127 @@
+// memory-sync.mjs — Bidirectional memory sync: pull from MCP, write to local files.
+
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { callMemoryTool } from './memory-bridge.mjs';
+
+const MANIFEST_FILE = 'manifest.json';
+const STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
+
+/**
+ * Check if local memory cache is stale (>24h since last sync).
+ * @param {string} registryDir — path to ~/.aw_registry/memory/
+ * @returns {boolean} true if stale or manifest missing
+ */
+export function checkStaleness(registryDir) {
+  const manifestPath = join(registryDir, MANIFEST_FILE);
+  if (!existsSync(manifestPath)) return true;
+  try {
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    if (!manifest.lastSync) return true;
+    const lastSync = new Date(manifest.lastSync).getTime();
+    return Date.now() - lastSync > STALE_THRESHOLD_MS;
+  } catch {
+    return true;
+  }
+}
+
+/**
+ * Group a memory into a target file based on overlay/angle.
+ * @param {object} mem — memory object with overlay, angle fields
+ * @returns {string} filename (e.g. 'incidents.md', 'patterns.md', 'product.md', 'core.md')
+ */
+function classifyMemory(mem) {
+  const overlays = Array.isArray(mem.overlay) ? mem.overlay : (Array.isArray(mem.overlays) ? mem.overlays : []);
+  const angles = Array.isArray(mem.angle) ? mem.angle : (Array.isArray(mem.angles) ? mem.angles : []);
+
+  const overlayStr = overlays.join(' ').toLowerCase();
+  const angleStr = angles.join(' ').toLowerCase();
+
+  if (overlayStr.includes('incident')) return 'incidents.md';
+  if (overlayStr.includes('service') || angleStr.includes('technical')) return 'patterns.md';
+  if (overlayStr.includes('product')) return 'product.md';
+  return 'core.md';
+}
+
+/**
+ * Pull top memories from MCP and write grouped files.
+ * @param {string} registryDir — path to ~/.aw_registry/memory/
+ * @returns {Promise<{ total: number, files: Record<string, number> }>}
+ */
+export async function pullAndWriteMemories(registryDir) {
+  const result = await callMemoryTool('memory_search', { query: '*', limit: 50 });
+  const memories = Array.isArray(result) ? result : (result?.memories ?? result?.results ?? []);
+
+  // Group by target file
+  const groups = {};
+  for (const mem of memories) {
+    const file = classifyMemory(mem);
+    if (!groups[file]) groups[file] = [];
+    groups[file].push(mem);
+  }
+
+  const now = new Date().toISOString();
+  const fileCounts = {};
+
+  for (const [filename, mems] of Object.entries(groups)) {
+    const sectionName = filename.replace('.md', '').replace(/^\w/, c => c.toUpperCase());
+    const lines = [
+      '<!-- aw:memory:auto-synced -->',
+      `<!-- last-sync: ${now} -->`,
+      '<!-- DO NOT EDIT — regenerated by `aw memory sync` -->',
+      '',
+      `## ${sectionName}`,
+    ];
+
+    for (const mem of mems) {
+      const content = mem.content ?? mem.text ?? JSON.stringify(mem);
+      const confidence = mem.confidence ?? mem.classification_confidence ?? '';
+      const id = mem.id ?? '';
+      const meta = [
+        confidence ? `confidence: ${confidence}` : null,
+        id ? `id: ${id}` : null,
+      ].filter(Boolean).join(' | ');
+
+      lines.push(`- ${content}${meta ? ` <!-- ${meta} -->` : ''}`);
+    }
+
+    lines.push('');
+    writeFileSync(join(registryDir, filename), lines.join('\n'));
+    fileCounts[filename] = mems.length;
+  }
+
+  return { total: memories.length, files: fileCounts };
+}
+
+/**
+ * Write manifest.json with sync metadata.
+ * @param {string} registryDir — path to ~/.aw_registry/memory/
+ * @param {number} count — number of memories synced
+ */
+export function writeManifest(registryDir, count) {
+  const manifest = {
+    lastSync: new Date().toISOString(),
+    memoriesSynced: count,
+    version: 1,
+  };
+  writeFileSync(join(registryDir, MANIFEST_FILE), JSON.stringify(manifest, null, 2) + '\n');
+}
+
+/**
+ * Main sync function — check staleness, pull, write, update manifest.
+ * @param {string} registryDir — path to ~/.aw_registry/memory/
+ * @param {object} [opts]
+ * @param {boolean} [opts.force] — skip staleness check
+ * @returns {Promise<{ skipped: boolean, total?: number, files?: Record<string, number> }>}
+ */
+export async function syncMemories(registryDir, opts = {}) {
+  mkdirSync(registryDir, { recursive: true });
+
+  if (!opts.force && !checkStaleness(registryDir)) {
+    return { skipped: true };
+  }
+
+  const { total, files } = await pullAndWriteMemories(registryDir);
+  writeManifest(registryDir, total);
+  return { skipped: false, total, files };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.37-beta.36",
+  "version": "0.1.37-beta.37",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": "bin.js",
@@ -27,7 +27,8 @@
     "ecc.mjs",
     "render-rules.mjs",
     "telemetry.mjs",
-    "memory-bridge.mjs"
+    "memory-bridge.mjs",
+    "memory-sync.mjs"
   ],
   "engines": {
     "node": ">=18.0.0"