@awareness-sdk/local 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awareness-sdk/local",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Local-first AI agent memory system. No account needed.",
   "license": "Apache-2.0",
   "type": "module",

package/src/core/cloud-sync.mjs

@@ -375,6 +375,10 @@ export class CloudSync {
       console.error(`${LOG_PREFIX} syncToCloud failed:`, err.message);
     }
 
+    if (synced > 0) {
+      this._recordSyncEvent('memories', { count: synced, direction: 'push' });
+    }
+
     return { synced, errors };
   }
 
@@ -426,6 +430,7 @@ export class CloudSync {
 
       if (pulled > 0) {
         console.log(`${LOG_PREFIX} Pulled ${pulled} memories from cloud`);
+        this._recordSyncEvent('memories', { count: pulled, direction: 'pull' });
       }
     } catch (err) {
       console.error(`${LOG_PREFIX} pullFromCloud failed:`, err.message);
@@ -496,6 +501,7 @@ export class CloudSync {
 
       if (synced > 0) {
         console.log(`${LOG_PREFIX} Pushed ${synced} knowledge cards to cloud` + (errors ? ` (${errors} errors)` : ''));
+        this._recordSyncEvent('insights', { count: synced, direction: 'push' });
       }
     } catch (err) {
       console.error(`${LOG_PREFIX} syncInsightsToCloud failed:`, err.message);
@@ -563,6 +569,7 @@ export class CloudSync {
 
       if (synced > 0) {
         console.log(`${LOG_PREFIX} Pushed ${synced} tasks to cloud` + (errors ? ` (${errors} errors)` : ''));
+        this._recordSyncEvent('tasks', { count: synced, direction: 'push' });
       }
     } catch (err) {
       console.error(`${LOG_PREFIX} syncTasksToCloud failed:`, err.message);
@@ -1171,6 +1178,51 @@ export class CloudSync {
     }
   }
 
+  // =========================================================================
+  // Public — sync history
+  // =========================================================================
+
+  /**
+   * Record a sync event to the sync_state table for history tracking.
+   * @param {string} type — "memories" | "insights" | "tasks"
+   * @param {object} details — { count, direction: "push"|"pull" }
+   */
+  _recordSyncEvent(type, details) {
+    try {
+      const timestamp = new Date().toISOString();
+      const key = `sync_log:${timestamp}`;
+      const value = JSON.stringify({ type, details, timestamp });
+      this._setSyncState(key, value);
+    } catch {
+      // Non-critical — don't crash on history logging failure
+    }
+  }
+
+  /**
+   * Get recent sync history events.
+   * @param {number} [limit=20] — Maximum number of events to return
+   * @returns {Array<{ type: string, details: object, timestamp: string }>}
+   */
+  getSyncHistory(limit = 20) {
+    try {
+      const rows = this.indexer.db
+        .prepare(
+          `SELECT value FROM sync_state WHERE key LIKE 'sync_log:%' ORDER BY key DESC LIMIT ?`
+        )
+        .all(limit);
+
+      return rows.map((row) => {
+        try {
+          return JSON.parse(row.value);
+        } catch {
+          return null;
+        }
+      }).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+
   // =========================================================================
   // Internal — utilities
   // =========================================================================

package/src/core/knowledge-extractor.mjs

@@ -84,8 +84,14 @@ export class KnowledgeExtractor {
     if (preExtractedInsights && this._hasInsights(preExtractedInsights)) {
       result = this.processPreExtracted(preExtractedInsights, metadata);
     } else {
-      // Layer 2: Rule engine fallback (SDK/API writes without agent)
-      result = this.extractByRules(content, metadata);
+      // Skip rule engine for raw tool captures — they produce low-quality cards
+      const skipTypes = new Set(['tool_use', 'code_change', 'session_checkpoint']);
+      if (skipTypes.has(metadata?.type)) {
+        result = { cards: [], tasks: [], risks: [] };
+      } else {
+        // Layer 2: Rule engine fallback (SDK/API writes without agent)
+        result = this.extractByRules(content, metadata);
+      }
     }
 
     // Persist extracted artifacts to disk + index

package/src/daemon.mjs

@@ -1072,6 +1072,8 @@ export class AwarenessLocalDaemon {
     const config = this._loadConfig();
     const cloud = config.cloud || {};
 
+    const history = this.cloudSync ? this.cloudSync.getSyncHistory() : [];
+
     return jsonResponse(res, {
       cloud_enabled: !!cloud.enabled,
       api_base: cloud.api_base || null,
@@ -1079,6 +1081,7 @@ export class AwarenessLocalDaemon {
       auto_sync: cloud.auto_sync ?? true,
       last_push_at: cloud.last_push_at || null,
       last_pull_at: cloud.last_pull_at || null,
+      history,
     });
   }
 

package/src/web/index.html

@@ -215,6 +215,17 @@ body {
 .sync-history { margin-top: 20px; }
 .sync-history h4 { font-size: 0.9rem; font-weight: 600; margin-bottom: 12px; color: var(--text-secondary); }
 .sync-history-empty { font-size: 0.85rem; color: var(--text-muted); padding: 16px; text-align: center; }
+.sync-history-list { max-height: 300px; overflow-y: auto; }
+.sync-history-item {
+  display: flex; align-items: center; gap: 10px;
+  padding: 8px 12px; border-bottom: 1px solid var(--border);
+  font-size: 0.85rem;
+}
+.sync-history-item:last-child { border-bottom: none; }
+.sync-history-icon { font-size: 1rem; flex-shrink: 0; }
+.sync-history-type { font-weight: 500; min-width: 70px; }
+.sync-history-count { color: var(--text-secondary); }
+.sync-history-time { margin-left: auto; color: var(--text-muted); font-size: 0.8rem; white-space: nowrap; }
 
 /* ---- Settings ---- */
 .settings-section { margin-bottom: 28px; }
@@ -754,6 +765,31 @@ async function loadSync() {
     descEl.textContent = 'Memories are stored locally only. Connect to cloud for backup and cross-device sync.';
     btnEl.textContent = 'Connect to Cloud';
   }
+
+  // Render sync history
+  var historyEl = document.getElementById('sync-history');
+  if (data.history && data.history.length > 0) {
+    var html = '<h4>Sync History</h4><div class="sync-history-list">';
+    for (var i = 0; i < data.history.length; i++) {
+      var item = data.history[i];
+      var dir = (item.details && item.details.direction) || 'push';
+      var icon = dir === 'pull' ? '\u2B07\uFE0F' : '\u2B06\uFE0F';
+      var type = item.type || 'memories';
+      var count = (item.details && item.details.count) || 0;
+      var time = item.timestamp ? formatDate(item.timestamp) : '';
+      html += '<div class="sync-history-item">'
+        + '<span class="sync-history-icon">' + icon + '</span>'
+        + '<span class="sync-history-type">' + type + '</span>'
+        + '<span class="sync-history-count">' + count + ' ' + dir + '</span>'
+        + '<span class="sync-history-time">' + time + '</span>'
+        + '</div>';
+    }
+    html += '</div>';
+    historyEl.innerHTML = html;
+  } else {
+    historyEl.innerHTML = '<h4>Sync History</h4>'
+      + '<div class="sync-history-empty">No sync history yet. Connect to cloud to enable sync.</div>';
+  }
 }
 
 var _authApiKey = null;