agentmesh-ai 0.3.1 → 0.4.0

package/dist/memory/merge-view.js

@@ -1,19 +1,26 @@
-import { getEffectiveStatus } from './write-utils.js';
+import { getEffectiveStatus, inferCategory, isRule } from './write-utils.js';
 /** Merge all agent memories into a single sorted list, with optional filtering. */
 export function mergeMemories(memories, options) {
     let entries = [];
     for (const memory of memories) {
-        // Filter by agent if specified
-        if (options?.agent && memory.agent !== options.agent) {
+        if (options?.agent && memory.agent !== options.agent)
             continue;
-        }
         for (const entry of memory.entries) {
-            // Filter by tags if specified
+            // Filter by tags
             if (options?.tags && options.tags.length > 0) {
                 const hasMatchingTag = options.tags.some(tag => entry.tags.includes(tag));
                 if (!hasMatchingTag)
                     continue;
             }
+            // Filter by topics (for drill-down read)
+            if (options?.topics && options.topics.length > 0) {
+                const matchesTopic = options.topics.some(t => t.toLowerCase() === entry.topic.toLowerCase());
+                if (!matchesTopic)
+                    continue;
+            }
+            // Filter private entries from other agents
+            if (entry.scope === 'private' && options?.agent !== memory.agent)
+                continue;
             entries.push({
                 ...entry,
                 agent: memory.agent,
@@ -29,31 +36,106 @@ export function mergeMemories(memories, options) {
         const scoreB = entryScore(b, now, sevenDaysMs);
         return scoreB - scoreA;
     });
-    // Apply limit
-    const limit = options?.limit ?? 50;
-    if (entries.length > limit) {
-        entries = entries.slice(0, limit);
+    // Apply limit (skip for topic-specific reads)
+    if (!options?.topics) {
+        const limit = options?.limit ?? 50;
+        if (entries.length > limit) {
+            entries = entries.slice(0, limit);
+        }
     }
     return entries;
 }
 function entryScore(entry, now, recentWindow) {
     let score = 0;
-    // Status weight: protected > proposal > auto
     const status = getEffectiveStatus(entry);
     if (status === 'protected')
         score += 30;
     else if (status === 'proposal')
         score += 15;
-    // Recency weight: entries within last 7 days get a boost
     const entryTime = new Date(entry.date).getTime();
     if (now - entryTime < recentWindow) {
         score += 30;
     }
-    // Tie-break by date (newest first)
-    score += entryTime / 1e15; // tiny fractional component for ordering
+    score += entryTime / 1e15;
     return score;
 }
-/** Format merged entries as a human-readable string for AI consumption. */
+// ── Index Format ─────────────────────────────────────────────────────────────
+/** Category display names and order. */
+const CATEGORY_LABELS = {
+    decision: 'Decisions',
+    api: 'APIs',
+    convention: 'Conventions',
+    gotcha: 'Gotchas',
+    dependency: 'Dependencies',
+    project_fact: 'Project Facts',
+    user_pref: 'User Preferences',
+};
+const CATEGORY_ORDER = [
+    'convention', 'decision', 'api', 'gotcha', 'dependency', 'project_fact', 'user_pref',
+];
+/**
+ * Format entries as a compact index grouped by category.
+ * Rules (conventions + protected decisions) are placed at the top.
+ */
+export function formatMemoryIndex(entries, myAgentId, myLastActive) {
+    if (entries.length === 0) {
+        return 'No shared memories found.\n\nStart recording knowledge with write_memory after completing tasks.';
+    }
+    const lines = [];
+    // Recent changes summary
+    if (myLastActive) {
+        const changes = getRecentChanges(entries, myAgentId ?? '', myLastActive);
+        if (changes.length > 0) {
+            lines.push('📬 Recent changes:');
+            for (const c of changes) {
+                lines.push(`  ${c}`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push(`# Shared Memory Index (${entries.length} entries)\n`);
+    // Separate rules from knowledge
+    const rules = entries.filter(e => isRule(e));
+    const knowledge = entries.filter(e => !isRule(e));
+    // Rules section
+    if (rules.length > 0) {
+        lines.push(`## ⚡ Rules (${rules.length}) — must follow`);
+        lines.push('| Topic | Agent | Date | Status |');
+        lines.push('|-------|-------|------|--------|');
+        for (const e of rules) {
+            const badge = getEffectiveStatus(e) === 'protected' ? '🔒' : '';
+            const summary = e.summary ?? e.content.slice(0, 50).replace(/\n/g, ' ');
+            lines.push(`| ${e.topic} | ${e.agent} | ${e.date.slice(0, 10)} | ${badge} |`);
+        }
+        lines.push('');
+    }
+    // Knowledge grouped by category
+    const grouped = groupByCategory(knowledge);
+    for (const cat of CATEGORY_ORDER) {
+        const group = grouped.get(cat);
+        if (!group || group.length === 0)
+            continue;
+        lines.push(`## ${CATEGORY_LABELS[cat]} (${group.length})`);
+        lines.push('| Topic | Agent | Date | Status |');
+        lines.push('|-------|-------|------|--------|');
+        for (const e of group) {
+            const status = getEffectiveStatus(e);
+            const badge = status === 'protected' ? '🔒' : status === 'proposal' ? '📋' : status === 'awaiting_votes' ? '🗳️' : '';
+            const priv = e.scope === 'private' ? ' 🔒Private' : '';
+            lines.push(`| ${e.topic} | ${e.agent} | ${e.date.slice(0, 10)} | ${badge}${priv} |`);
+        }
+        lines.push('');
+    }
+    // Usage hints
+    lines.push('---');
+    lines.push('To read full details: call read_memory with topics: ["Topic Name", ...]');
+    lines.push('To search: call search_memory with query and optional category filter');
+    lines.push('');
+    lines.push('💡 After completing your task, record important findings with write_memory.');
+    lines.push('   Focus on: API changes, decisions, gotchas, conventions.');
+    return lines.join('\n');
+}
+/** Format merged entries as full detail view (for topic drill-down). */
 export function formatMergedMemories(entries, totalBeforeLimit) {
     if (entries.length === 0) {
         return 'No shared memories found.';
@@ -63,7 +145,8 @@ export function formatMergedMemories(entries, totalBeforeLimit) {
     for (const entry of entries) {
         const effectiveStatus = getEffectiveStatus(entry);
         const badge = effectiveStatus === 'protected' ? ' 🔒' : effectiveStatus === 'proposal' ? ' 📋' : '';
-        lines.push(`## ${entry.topic}${badge}`);
+        const catLabel = entry.category ? ` [${entry.category}]` : '';
+        lines.push(`## ${entry.topic}${badge}${catLabel}`);
         lines.push(`Agent: ${entry.agent} (${entry.agent_role})`);
         lines.push(`Date: ${entry.date}`);
         if (effectiveStatus !== 'auto') {
@@ -86,4 +169,42 @@ export function formatMergedMemories(entries, totalBeforeLimit) {
     }
     return lines.join('\n');
 }
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function groupByCategory(entries) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const cat = entry.category ?? inferCategory(entry.tags, entry.topic);
+        if (!groups.has(cat))
+            groups.set(cat, []);
+        groups.get(cat).push(entry);
+    }
+    return groups;
+}
+function getRecentChanges(entries, myAgentId, lastActive) {
+    const lastTime = new Date(lastActive).getTime();
+    const changes = [];
+    const newEntries = entries.filter(e => e.agent !== myAgentId && new Date(e.date).getTime() > lastTime);
+    if (newEntries.length === 0)
+        return changes;
+    // Group by agent
+    const byAgent = new Map();
+    for (const e of newEntries) {
+        if (!byAgent.has(e.agent))
+            byAgent.set(e.agent, []);
+        byAgent.get(e.agent).push(e);
+    }
+    for (const [agent, agentEntries] of byAgent) {
+        const topics = agentEntries.map(e => e.topic).slice(0, 3);
+        changes.push(`+ ${agentEntries.length} new by ${agent}: ${topics.join(', ')}`);
+    }
+    // Pending proposals
+    const proposals = entries.filter(e => {
+        const s = getEffectiveStatus(e);
+        return (s === 'proposal' || s === 'awaiting_votes') && e.agent !== myAgentId;
+    });
+    if (proposals.length > 0) {
+        changes.push(`📋 ${proposals.length} proposal(s) waiting for input`);
+    }
+    return changes;
+}
 //# sourceMappingURL=merge-view.js.map

package/dist/memory/merge-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge-view.js","sourceRoot":"","sources":["../../src/memory/merge-view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"merge-view.js","sourceRoot":"","sources":["../../src/memory/merge-view.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE7E,mFAAmF;AACnF,MAAM,UAAU,aAAa,CAC3B,QAA2B,EAC3B,OAA2B;IAE3B,IAAI,OAAO,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;YAAE,SAAS;QAE/D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,iBAAiB;YACjB,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7C,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1E,IAAI,CAAC,cAAc;oBAAE,SAAS;YAChC,CAAC;YAED,yCAAyC;YACzC,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CACnD,CAAC;gBACF,IAAI,CAAC,YAAY;oBAAE,SAAS;YAC9B,CAAC;YAED,2CAA2C;YAC3C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,EAAE,KAAK,KAAK,MAAM,CAAC,KAAK;gBAAE,SAAS;YAE3E,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,KAAK;gBACR,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,IAAI;aACxB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/C,OAAO,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC3B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,KAAwB,EAAE,GAAW,EAAE,YAAoB;IAC7E,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,WAAW;QAAE,KAAK,IAAI,EAAE,CAAC;SACnC,IAAI,MAAM,KAAK,UAAU;QAAE,KAAK,IAAI,EAAE,CAAC;IAE5C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IACjD,IAAI,GAAG,GAAG,SAAS,GAAG,YAAY,EAAE,CAAC;QACnC,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,IAAI,SAAS,GAAG,IAAI,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gFAAgF;AAEhF,wCAAwC;AACxC,MAAM,eAAe,GAAmC;IACtD,QAAQ,EAAE,WAAW;IACrB,GAAG,EAAE,MAAM;IACX,UAAU,EAAE,aAAa;IACzB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,kBAAkB;CAC9B,CAAC;AAEF,MAAM,cAAc,GAAqB;IACvC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW;CACrF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA4B,EAC5B,SAAkB,EAClB,YAAqB;IAErB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,kGAAkG,CAAC;IAC5G,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yBAAyB;IACzB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;IAElE,gCAAgC;IAChC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAElD,gBAAgB;IAChB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;QAChF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,gCAAgC;IAChC,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAE3C,KAAK,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACtH,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,cAAc;IACd,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;IAC1F,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAEzE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,OAA4B,EAAE,gBAAyB;IAC1F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;IAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,WAAW,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,gBAAgB,IAAI,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,MAAM,OAAO,gBAAgB,sDAAsD,CAAC,CAAC;IACtH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,gFAAgF;AAEhF,SAAS,eAAe,CAAC,OAA4B;IACnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA4B,EAAE,SAAiB,EAAE,UAAkB;IAC3F,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IACvG,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAE5C,iBAAiB;IACjB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,KAAK,YAAY,CAAC,MAAM,WAAW,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACnC,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC,MAAM,gCAAgC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/memory/schema.d.ts

@@ -8,27 +8,36 @@ export declare const memoryEntrySchema: z.ZodObject<{
     content: z.ZodString;
     date: z.ZodString;
     decided_with: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    status: z.ZodOptional<z.ZodEnum<["auto", "proposal", "protected"]>>;
+    status: z.ZodOptional<z.ZodEnum<["auto", "proposal", "awaiting_votes", "accepted", "rejected", "protected"]>>;
     protected: z.ZodOptional<z.ZodBoolean>;
     owner: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<["decision", "api", "convention", "gotcha", "dependency", "project_fact", "user_pref"]>>;
+    scope: z.ZodOptional<z.ZodEnum<["shared", "private"]>>;
+    summary: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     topic: string;
     tags: string[];
     content: string;
     date: string;
-    status?: "auto" | "proposal" | "protected" | undefined;
+    status?: "auto" | "proposal" | "awaiting_votes" | "accepted" | "rejected" | "protected" | undefined;
     decided_with?: string[] | undefined;
     protected?: boolean | undefined;
     owner?: string | undefined;
+    category?: "decision" | "api" | "convention" | "gotcha" | "dependency" | "project_fact" | "user_pref" | undefined;
+    scope?: "shared" | "private" | undefined;
+    summary?: string | undefined;
 }, {
     topic: string;
     content: string;
     date: string;
-    status?: "auto" | "proposal" | "protected" | undefined;
+    status?: "auto" | "proposal" | "awaiting_votes" | "accepted" | "rejected" | "protected" | undefined;
     tags?: string[] | undefined;
     decided_with?: string[] | undefined;
     protected?: boolean | undefined;
     owner?: string | undefined;
+    category?: "decision" | "api" | "convention" | "gotcha" | "dependency" | "project_fact" | "user_pref" | undefined;
+    scope?: "shared" | "private" | undefined;
+    summary?: string | undefined;
 }>;
 export declare const agentMemoryFileSchema: z.ZodObject<{
     agent: z.ZodString;
@@ -41,27 +50,36 @@ export declare const agentMemoryFileSchema: z.ZodObject<{
         content: z.ZodString;
         date: z.ZodString;
         decided_with: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        status: z.ZodOptional<z.ZodEnum<["auto", "proposal", "protected"]>>;
+        status: z.ZodOptional<z.ZodEnum<["auto", "proposal", "awaiting_votes", "accepted", "rejected", "protected"]>>;
         protected: z.ZodOptional<z.ZodBoolean>;
         owner: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodEnum<["decision", "api", "convention", "gotcha", "dependency", "project_fact", "user_pref"]>>;
+        scope: z.ZodOptional<z.ZodEnum<["shared", "private"]>>;
+        summary: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         topic: string;
         tags: string[];
         content: string;
         date: string;
-        status?: "auto" | "proposal" | "protected" | undefined;
+        status?: "auto" | "proposal" | "awaiting_votes" | "accepted" | "rejected" | "protected" | undefined;
         decided_with?: string[] | undefined;
         protected?: boolean | undefined;
         owner?: string | undefined;
+        category?: "decision" | "api" | "convention" | "gotcha" | "dependency" | "project_fact" | "user_pref" | undefined;
+        scope?: "shared" | "private" | undefined;
+        summary?: string | undefined;
     }, {
         topic: string;
         content: string;
         date: string;
-        status?: "auto" | "proposal" | "protected" | undefined;
+        status?: "auto" | "proposal" | "awaiting_votes" | "accepted" | "rejected" | "protected" | undefined;
         tags?: string[] | undefined;
         decided_with?: string[] | undefined;
         protected?: boolean | undefined;
         owner?: string | undefined;
+        category?: "decision" | "api" | "convention" | "gotcha" | "dependency" | "project_fact" | "user_pref" | undefined;
+        scope?: "shared" | "private" | undefined;
+        summary?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     entries: {
@@ -69,10 +87,13 @@ export declare const agentMemoryFileSchema: z.ZodObject<{
         tags: string[];
         content: string;
         date: string;
-        status?: "auto" | "proposal" | "protected" | undefined;
+        status?: "auto" | "proposal" | "awaiting_votes" | "accepted" | "rejected" | "protected" | undefined;
         decided_with?: string[] | undefined;
         protected?: boolean | undefined;
         owner?: string | undefined;
+        category?: "decision" | "api" | "convention" | "gotcha" | "dependency" | "project_fact" | "user_pref" | undefined;
+        scope?: "shared" | "private" | undefined;
+        summary?: string | undefined;
     }[];
     agent: string;
     role: string;
@@ -87,11 +108,14 @@ export declare const agentMemoryFileSchema: z.ZodObject<{
         topic: string;
         content: string;
         date: string;
-        status?: "auto" | "proposal" | "protected" | undefined;
+        status?: "auto" | "proposal" | "awaiting_votes" | "accepted" | "rejected" | "protected" | undefined;
         tags?: string[] | undefined;
         decided_with?: string[] | undefined;
         protected?: boolean | undefined;
         owner?: string | undefined;
+        category?: "decision" | "api" | "convention" | "gotcha" | "dependency" | "project_fact" | "user_pref" | undefined;
+        scope?: "shared" | "private" | undefined;
+        summary?: string | undefined;
     }[] | undefined;
 }>;
 export declare const agentInfoSchema: z.ZodObject<{

package/dist/memory/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/memory/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAK1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM1B,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/memory/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY5B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMhC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;EAK1B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM1B,CAAC"}

package/dist/memory/schema.js

@@ -8,9 +8,12 @@ export const memoryEntrySchema = z.object({
     content: z.string().min(1),
     date: z.string(),
     decided_with: z.array(z.string()).optional(),
-    status: z.enum(['auto', 'proposal', 'protected']).optional(),
+    status: z.enum(['auto', 'proposal', 'awaiting_votes', 'accepted', 'rejected', 'protected']).optional(),
     protected: z.boolean().optional(), // backward compat
     owner: z.string().optional(),
+    category: z.enum(['decision', 'api', 'convention', 'gotcha', 'dependency', 'project_fact', 'user_pref']).optional(),
+    scope: z.enum(['shared', 'private']).optional(),
+    summary: z.string().optional(),
 });
 export const agentMemoryFileSchema = z.object({
     agent: z.string().min(1),

package/dist/memory/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/memory/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,kBAAkB;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/memory/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtG,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,kBAAkB;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnH,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC,CAAC"}

package/dist/memory/searcher.d.ts

@@ -1,7 +1,18 @@
 /**
- * Memory searcher - search across all agent memories by keyword or tags.
+ * Memory searcher - search across all agent memories by keyword.
+ *
+ * Enhanced with: word boundary matching, category filtering, multi-term bonus,
+ * protected boost, and configurable result limits.
  */
-import type { AgentMemoryFile, MergedMemoryEntry } from './types.js';
-/** Search all memories for entries matching the query string. */
-export declare function searchMemories(memories: AgentMemoryFile[], query: string): MergedMemoryEntry[];
+import type { AgentMemoryFile, MemoryCategory, MergedMemoryEntry } from './types.js';
+export interface SearchOptions {
+    query: string;
+    category?: MemoryCategory;
+    limit?: number;
+}
+/** Search all memories for entries matching the query. */
+export declare function searchMemories(memories: AgentMemoryFile[], query: string, options?: {
+    category?: MemoryCategory;
+    limit?: number;
+}): MergedMemoryEntry[];
 //# sourceMappingURL=searcher.d.ts.map

package/dist/memory/searcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searcher.d.ts","sourceRoot":"","sources":["../../src/memory/searcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,iEAAiE;AACjE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,KAAK,EAAE,MAAM,GACZ,iBAAiB,EAAE,CAyBrB"}
+{"version":3,"file":"searcher.d.ts","sourceRoot":"","sources":["../../src/memory/searcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGrF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,eAAe,EAAE,EAC3B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,iBAAiB,EAAE,CAiCrB"}

package/dist/memory/searcher.js

@@ -1,48 +1,100 @@
-/** Search all memories for entries matching the query string. */
-export function searchMemories(memories, query) {
+import { getEffectiveStatus, inferCategory } from './write-utils.js';
+/** Search all memories for entries matching the query. */
+export function searchMemories(memories, query, options) {
     const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    if (terms.length === 0)
+        return [];
+    const limit = options?.limit ?? 10;
     const results = [];
     for (const memory of memories) {
         for (const entry of memory.entries) {
-            const score = calculateRelevance(entry, memory, terms);
+            // Skip private entries from other agents
+            if (entry.scope === 'private')
+                continue;
+            // Category filter
+            if (options?.category) {
+                const entryCat = entry.category ?? inferCategory(entry.tags, entry.topic);
+                if (entryCat !== options.category)
+                    continue;
+            }
+            const merged = {
+                ...entry,
+                agent: memory.agent,
+                agent_role: memory.role,
+            };
+            const score = calculateRelevance(merged, terms);
             if (score > 0) {
-                results.push({
-                    entry: {
-                        ...entry,
-                        agent: memory.agent,
-                        agent_role: memory.role,
-                    },
-                    score,
-                });
+                results.push({ entry: merged, score });
             }
         }
     }
-    // Sort by relevance score, highest first
     results.sort((a, b) => b.score - a.score);
-    return results.map(r => r.entry);
+    return results.slice(0, limit).map(r => r.entry);
+}
+/** Escape regex special characters. */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Count non-overlapping occurrences of a substring. */
+function countOccurrences(text, term) {
+    let count = 0;
+    let pos = 0;
+    while ((pos = text.indexOf(term, pos)) !== -1) {
+        count++;
+        pos += term.length;
+    }
+    return count;
 }
-function calculateRelevance(entry, memory, terms) {
+function calculateRelevance(entry, terms) {
     let score = 0;
     const topicLower = entry.topic.toLowerCase();
     const contentLower = entry.content.toLowerCase();
     const tagsLower = entry.tags.map(t => t.toLowerCase());
-    const agentLower = memory.agent.toLowerCase();
+    const agentLower = entry.agent.toLowerCase();
+    let matchedTermCount = 0;
     for (const term of terms) {
-        // Topic match (highest weight)
-        if (topicLower.includes(term))
-            score += 10;
-        // Tag exact match (high weight)
-        if (tagsLower.includes(term))
+        let termMatched = false;
+        // Topic: word boundary match (+15) or substring (+8)
+        const wordBoundary = new RegExp(`\\b${escapeRegex(term)}\\b`, 'i');
+        if (wordBoundary.test(entry.topic)) {
+            score += 15;
+            termMatched = true;
+        }
+        else if (topicLower.includes(term)) {
             score += 8;
-        // Agent name match
-        if (agentLower.includes(term))
-            score += 3;
-        // Content match (lower weight, but still relevant)
-        if (contentLower.includes(term))
-            score += 2;
-        // Tag partial match
-        if (tagsLower.some(t => t.includes(term)))
+            termMatched = true;
+        }
+        // Tag exact match (+10)
+        if (tagsLower.includes(term)) {
+            score += 10;
+            termMatched = true;
+        }
+        // Tag partial match (+4)
+        else if (tagsLower.some(t => t.includes(term))) {
             score += 4;
+            termMatched = true;
+        }
+        // Content: count occurrences, cap at 10
+        const contentHits = countOccurrences(contentLower, term);
+        if (contentHits > 0) {
+            score += Math.min(contentHits * 2, 10);
+            termMatched = true;
+        }
+        // Agent name match (+3)
+        if (agentLower.includes(term)) {
+            score += 3;
+            termMatched = true;
+        }
+        if (termMatched)
+            matchedTermCount++;
+    }
+    // Multi-term bonus: all terms present → +10
+    if (terms.length > 1 && matchedTermCount === terms.length) {
+        score += 10;
+    }
+    // Protected entries boost (+5) — settled knowledge is more reliable
+    if (getEffectiveStatus(entry) === 'protected') {
+        score += 5;
     }
     return score;
 }

package/dist/memory/searcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"searcher.js","sourceRoot":"","sources":["../../src/memory/searcher.ts"],"names":[],"mappings":"AAKA,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAC5B,QAA2B,EAC3B,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE/D,MAAM,OAAO,GAAuD,EAAE,CAAC;IAEvE,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE;wBACL,GAAG,KAAK;wBACR,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,UAAU,EAAE,MAAM,CAAC,IAAI;qBACxB;oBACD,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE1C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAyD,EACzD,MAAyB,EACzB,KAAe;IAEf,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,+BAA+B;QAC/B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,EAAE,CAAC;QAE3C,gCAAgC;QAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAEzC,mBAAmB;QACnB,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAE1C,mDAAmD;QACnD,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAE5C,oBAAoB;QACpB,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"searcher.js","sourceRoot":"","sources":["../../src/memory/searcher.ts"],"names":[],"mappings":"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"}

package/dist/memory/types.d.ts

@@ -1,8 +1,12 @@
 /**
  * Core data types for AgentHub shared memory.
  */
-/** Memory entry status levels */
-export type MemoryStatus = 'auto' | 'proposal' | 'protected';
+/** Memory entry status levels (extended lifecycle) */
+export type MemoryStatus = 'auto' | 'proposal' | 'awaiting_votes' | 'accepted' | 'rejected' | 'protected';
+/** Memory category — closed taxonomy for structured organization */
+export type MemoryCategory = 'decision' | 'api' | 'convention' | 'gotcha' | 'dependency' | 'project_fact' | 'user_pref';
+/** Memory scope — who can see this entry */
+export type MemoryScope = 'shared' | 'private';
 /** A single knowledge entry recorded by an agent */
 export interface MemoryEntry {
     topic: string;
@@ -13,6 +17,9 @@ export interface MemoryEntry {
     status?: MemoryStatus;
     protected?: boolean;
     owner?: string;
+    category?: MemoryCategory;
+    scope?: MemoryScope;
+    summary?: string;
 }
 /** An agent's complete memory file */
 export interface AgentMemoryFile {
@@ -46,6 +53,7 @@ export interface MergedMemoryEntry extends MemoryEntry {
 export interface ReadMemoryOptions {
     tags?: string[];
     agent?: string;
+    topics?: string[];
     limit?: number;
 }
 /** Options for writing memory */
@@ -57,6 +65,9 @@ export interface WriteMemoryOptions {
     status?: MemoryStatus;
     protected?: boolean;
     owner?: string;
+    category?: MemoryCategory;
+    scope?: MemoryScope;
+    summary?: string;
 }
 /** Result of a write operation */
 export interface WriteResult {
@@ -68,5 +79,15 @@ export interface WriteResult {
 /** Options for searching memory */
 export interface SearchMemoryOptions {
     query: string;
+    category?: MemoryCategory;
+    limit?: number;
+}
+/** Memory event — for audit trail (protocol definition, implementation later) */
+export interface MemoryEvent {
+    type: 'created' | 'updated' | 'status_changed';
+    agent: string;
+    topic: string;
+    timestamp: string;
+    detail?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/memory/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oCAAoC;AACpC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CAEpB;AAED,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,mCAAmC;AACnC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"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"}

package/dist/memory/write-utils.d.ts

@@ -1,4 +1,4 @@
-import type { AgentMemoryFile, MemoryEntry, MemoryStatus, WriteMemoryOptions, WriteResult } from './types.js';
+import type { AgentMemoryFile, MemoryEntry, MemoryCategory, MemoryStatus, WriteMemoryOptions, WriteResult } from './types.js';
 /** Resolve the effective status of a memory entry (handles backward compat). */
 export declare function getEffectiveStatus(entry: {
     status?: MemoryStatus;
@@ -20,6 +20,10 @@ export declare function validateContent(content: string): {
     blocked?: WriteResult;
     warnings: string[];
 };
+/** Infer category from tags and topic when not explicitly provided. */
+export declare function inferCategory(tags: string[], topic: string): MemoryCategory;
+/** Check if an entry represents a rule (convention or protected decision). */
+export declare function isRule(entry: MemoryEntry): boolean;
 /** Build a new MemoryEntry from write options. */
 export declare function buildMemoryEntry(options: WriteMemoryOptions, now: string): MemoryEntry;
 /**