@awareness-sdk/local 0.1.4 → 0.1.6

package/package.json

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

package/src/daemon.mjs

@@ -42,6 +42,26 @@ function nowISO() {
   return new Date().toISOString();
 }
 
+/** Categories surfaced as top-level user_preferences (mirrors cloud PREFERENCE_FIRST_CATEGORIES). */
+const PREFERENCE_FIRST_CATEGORIES = new Set([
+  'personal_preference', 'activity_preference', 'important_detail', 'career_info',
+]);
+const MAX_USER_PREFERENCES = 15;
+
+/** Split knowledge cards into {user_preferences, knowledge_cards}. */
+function splitPreferences(cards) {
+  const prefs = [];
+  const other = [];
+  for (const c of cards) {
+    if (PREFERENCE_FIRST_CATEGORIES.has(c.category) && prefs.length < MAX_USER_PREFERENCES) {
+      prefs.push(c);
+    } else {
+      other.push(c);
+    }
+  }
+  return { user_preferences: prefs, knowledge_cards: other };
+}
+
 /**
  * Send a JSON response.
  * @param {http.ServerResponse} res
@@ -647,16 +667,40 @@ export class AwarenessLocalDaemon {
         const recentSessions = this.indexer.getRecentSessions(args.days ?? 7);
         const spec = this._loadSpec();
 
+        // Compute attention_summary for LLM-side triage
+        const now = Date.now();
+        const staleDays = 3;
+        const staleCutoff = now - staleDays * 86400000;
+        const staleTasks = openTasks.filter(t => {
+          const created = t.created_at ? new Date(t.created_at).getTime() : now;
+          return created < staleCutoff;
+        }).length;
+        const riskCards = this.indexer.db
+          .prepare("SELECT COUNT(*) as cnt FROM knowledge_cards WHERE (category = 'risk' OR category = 'pitfall') AND status = 'active'")
+          .get();
+        const highRisks = riskCards?.cnt || 0;
+
+        const attentionSummary = {
+          stale_tasks: staleTasks,
+          high_risks: highRisks,
+          total_open_tasks: openTasks.length,
+          total_knowledge_cards: recentCards.length,
+          needs_attention: staleTasks > 0 || highRisks > 0,
+        };
+
+        const { user_preferences, knowledge_cards: otherCards } = splitPreferences(recentCards);
         return {
           content: [{
             type: 'text',
             text: JSON.stringify({
               session_id: session.id,
               mode: 'local',
-              knowledge_cards: recentCards,
+              user_preferences,
+              knowledge_cards: otherCards,
               open_tasks: openTasks,
               recent_sessions: recentSessions,
               stats,
+              attention_summary: attentionSummary,
               synthesized_rules: spec.core_lines?.join('\n') || '',
               init_guides: spec.init_guides || {},
               agent_profiles: [],
@@ -1526,12 +1570,13 @@ ${item.description || item.title || ''}
 
     switch (type) {
       case 'context': {
-        // Full context dump
+        // Full context dump with preference separation
         const stats = this.indexer.getStats();
         const knowledge = this.indexer.getRecentKnowledge(limit);
         const tasks = this.indexer.getOpenTasks(0);
         const sessions = this.indexer.getRecentSessions(7);
-        return { stats, knowledge_cards: knowledge, open_tasks: tasks, recent_sessions: sessions, mode: 'local' };
+        const { user_preferences, knowledge_cards: otherCards } = splitPreferences(knowledge);
+        return { stats, user_preferences, knowledge_cards: otherCards, open_tasks: tasks, recent_sessions: sessions, mode: 'local' };
       }
 
       case 'tasks': {

package/src/mcp-server.mjs

@@ -19,6 +19,26 @@ import { z } from 'zod';
 // Helpers
 // ---------------------------------------------------------------------------
 
+/** Categories surfaced as top-level user_preferences (mirrors cloud). */
+const PREFERENCE_FIRST_CATEGORIES = new Set([
+  'personal_preference', 'activity_preference', 'important_detail', 'career_info',
+]);
+const MAX_USER_PREFERENCES = 15;
+
+/** Split knowledge cards into {user_preferences, knowledge_cards}. */
+function splitPreferences(cards) {
+  const prefs = [];
+  const other = [];
+  for (const c of cards) {
+    if (PREFERENCE_FIRST_CATEGORIES.has(c.category) && prefs.length < MAX_USER_PREFERENCES) {
+      prefs.push(c);
+    } else {
+      other.push(c);
+    }
+  }
+  return { user_preferences: prefs, knowledge_cards: other };
+}
+
 /**
  * Wrap a result object in the MCP-standard content envelope.
  * @param {object} result
@@ -118,10 +138,12 @@ export class LocalMcpServer {
           // Load workflow rules from awareness-spec.json
           const spec = this.engine.loadSpec();
 
+          const { user_preferences, knowledge_cards: otherCards } = splitPreferences(recentCards);
           return mcpResult({
             session_id: session.id,
             mode: 'local',
-            knowledge_cards: recentCards,
+            user_preferences,
+            knowledge_cards: otherCards,
             open_tasks: openTasks,
             recent_sessions: recentSessions,
             stats,

package/src/spec/awareness-spec.json

@@ -58,7 +58,7 @@
     {
       "name": "awareness_init",
       "short_desc": "Load cross-session project memory and context",
-      "long_desc": "Load cross-session project memory. Returns session_id, context (narratives, tasks, knowledge, active_skills), and usage rules. Call ONCE at session start."
+      "long_desc": "Load cross-session project memory. Returns session_id, context (narratives, tasks, knowledge, active_skills, attention_summary), and usage rules. Call ONCE at session start. ATTENTION PROTOCOL: When context.attention_summary.needs_attention is true, review all attention items (stale tasks, high risks) and automatically: (1) remind the user about stale tasks, (2) warn about high risks before starting work, (3) update resolved items via awareness_record."
     },
     {
       "name": "awareness_get_agent_prompt",
@@ -385,7 +385,8 @@
       "notes_lines": [
         "## OpenClaw Notes",
         "- OpenClaw uses a plugin-based configuration via ~/.openclaw/openclaw.json.",
-        "- Install the Awareness plugin: openclaw plugins install @awareness-sdk/openclaw-memory",
+        "- Install as plugin: openclaw plugins install @awareness-sdk/openclaw-memory",
+        "- Or install as skill: npx clawhub@latest install awareness-memory",
         "- MCP tools are exposed through the plugin system, no rules file needed."
       ]
     }