memorix 0.6.2 → 0.6.3

package/README.md

@@ -7,7 +7,7 @@
     <a href="https://www.npmjs.com/package/memorix"><img src="https://img.shields.io/npm/dm/memorix.svg?style=flat-square&color=blue" alt="npm downloads"></a>
     <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green.svg?style=flat-square" alt="License"></a>
     <a href="https://github.com/AVIDS2/memorix"><img src="https://img.shields.io/github/stars/AVIDS2/memorix?style=flat-square&color=yellow" alt="GitHub stars"></a>
-    <img src="https://img.shields.io/badge/tests-274%20passed-brightgreen?style=flat-square" alt="Tests">
+    <img src="https://img.shields.io/badge/tests-405%20passed-brightgreen?style=flat-square" alt="Tests">
   </p>
   <p align="center">
     <a href="#-quick-start">Quick Start</a> •
@@ -20,9 +20,9 @@
 
 ---
 
-> **One project, six agents, zero context loss.**
+> **One project, seven agents, zero context loss.**
 >
-> Memorix is a **cross-agent memory bridge** — it lets Cursor, Windsurf, Claude Code, Codex, Copilot, and Antigravity **share the same project knowledge** in real-time. Architecture decisions made in one IDE are instantly available in another. Switch tools, open new windows, start fresh sessions — your context follows you everywhere via [MCP](https://modelcontextprotocol.io/). It also **syncs MCP configs, rules, skills, and workflows** across all your agents automatically.
+> Memorix is a **cross-agent memory bridge** — it lets Cursor, Windsurf, Claude Code, Codex, Copilot, Antigravity, and **Kiro** **share the same project knowledge** in real-time. Architecture decisions made in one IDE are instantly available in another. Switch tools, open new windows, start fresh sessions — your context follows you everywhere via [MCP](https://modelcontextprotocol.io/). It also **syncs MCP configs, rules, skills, and workflows** across all your agents automatically.
 
 ---
 
@@ -46,7 +46,7 @@ Add Memorix to your agent's MCP config — **that's it**. No global install need
 
 Restart your agent and Memorix is running! 🎉
 
-> 💡 More agent configs: [Cursor](#cursor) • [Claude Code](#claude-code) • [Codex](#codex) • [VS Code Copilot](#vs-code-copilot) • [Antigravity](#antigravity)
+> 💡 More agent configs: [Cursor](#cursor) • [Claude Code](#claude-code) • [Codex](#codex) • [VS Code Copilot](#vs-code-copilot) • [Antigravity](#antigravity) • [Kiro](#kiro)
 
 ### Or Install Globally
 
@@ -93,7 +93,7 @@ Then use `"command": "memorix"` instead of `"command": "npx"` in your config.
 
 ### 🔄 Cross-Agent Workspace Sync
 
-- **6 Agent Adapters** — Windsurf, Cursor, Claude Code, Codex, VS Code Copilot, Antigravity
+- **7 Agent Adapters** — Windsurf, Cursor, Claude Code, Codex, VS Code Copilot, Antigravity, **Kiro**
 - **MCP Config Migration** — Detect and migrate MCP server configs (merges — never overwrites)
 - **Rules Sync** — Scan → Deduplicate → Conflict detection → Cross-format generation
 - **Skills & Workflows** — Copy skill folders and workflow files across agents
@@ -113,11 +113,13 @@ Then use `"command": "memorix"` instead of `"command": "npx"` in your config.
 - **Project Switcher** — Dropdown to view any project's data without switching IDEs
 - **Knowledge Graph** — Interactive visualization of entities and relations
 - **Retention Scores** — Exponential decay scoring with immunity status
+- **Observation Management** — Expand/collapse details, search, delete with confirmation, data export
 - **Light/Dark Theme** — Premium glassmorphism design, bilingual (EN/中文)
 
 ### 🪝 Auto-Memory Hooks
 
 - **Implicit Memory** — Auto-captures decisions, errors, gotchas from agent activity
+- **Session Start Injection** — Intelligently loads recent high-value memories (gotchas, decisions, problem-solutions) and injects a concise summary into the agent's system prompt at session start
 - **Multi-Language Pattern Detection** — English + Chinese keyword matching
 - **Cooldown & Noise Filtering** — 30s cooldown, skips trivial commands (ls, cat, pwd)
 - **One-Command Install** — `memorix hooks install` sets up hooks + rules for your agent
@@ -204,6 +206,20 @@ args = ["-y", "memorix@latest", "serve"]
 }
 ```
 
+### Kiro
+
+`.kiro/settings/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "memorix": {
+      "command": "npx",
+      "args": ["-y", "memorix@latest", "serve"]
+    }
+  }
+}
+```
+
 ---
 
 ## 🛠 Available MCP Tools
@@ -278,33 +294,33 @@ Files: ["src/auth/jwt.ts", "src/config.ts"]
 ### Architecture
 
 ```
-┌──────────────────────────────────────────────────────────────┐
-│                    AI Coding Agents                           │
-│  Windsurf │ Cursor │ Claude Code │ Codex │ Copilot │ Antigravity
-└────────────────────────┬─────────────────────────────────────┘
-                         │ MCP Protocol (stdio)
-┌────────────────────────▼─────────────────────────────────────┐
-│                 Memorix MCP Server (17 tools)                │
-│                                                              │
-│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐   │
-│  │   Memory     │  │   Compact    │  │  Workspace Sync  │   │
-│  │   Layer      │  │   Engine     │  │  (6 adapters)    │   │
-│  │             │  │  (3-layer)   │  │                  │   │
-│  │ • Graph     │  │              │  │ • MCP Configs    │   │
-│  │ • Retention │  │              │  │ • Rules          │   │
-│  │ • Entities  │  │              │  │ • Skills         │   │
-│  │ • Relations │  │              │  │ • Workflows      │   │
-│  └──────┬──────┘  └──────┬───────┘  └──────────────────┘   │
-│         │                │                                   │
-│  ┌──────▼────────────────▼───────────────────────────────┐  │
-│  │  Orama Store (BM25 + Vector) │ Persistence (JSONL)    │  │
-│  └───────────────────────────────────────────────────────┘  │
-│                                                              │
-│  ┌───────────────────────────────────────────────────────┐  │
-│  │  Hooks System: Normalizer → Pattern Detector → Store  │  │
-│  │  (Auto-captures decisions, bugs, gotchas from agents) │  │
-│  └───────────────────────────────────────────────────────┘  │
-└──────────────────────────────────────────────────────────────┘
+┌───────────────────────────────────────────────────────────────────┐
+│                      AI Coding Agents                              │
+│  Windsurf │ Cursor │ Claude Code │ Codex │ Copilot │ Antigravity │ Kiro
+└───────────────────────────┬───────────────────────────────────────┘
+                            │ MCP Protocol (stdio)
+┌───────────────────────────▼───────────────────────────────────────┐
+│                  Memorix MCP Server (17 tools)                    │
+│                                                                    │
+│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐         │
+│  │   Memory     │  │   Compact    │  │  Workspace Sync  │         │
+│  │   Layer      │  │   Engine     │  │  (7 adapters)    │         │
+│  │             │  │  (3-layer)   │  │                  │         │
+│  │ • Graph     │  │              │  │ • MCP Configs    │         │
+│  │ • Retention │  │              │  │ • Rules          │         │
+│  │ • Entities  │  │              │  │ • Skills         │         │
+│  │ • Relations │  │              │  │ • Workflows      │         │
+│  └──────┬──────┘  └──────┬───────┘  └──────────────────┘         │
+│         │                │                                         │
+│  ┌──────▼────────────────▼───────────────────────────────┐        │
+│  │  Orama Store (BM25 + Vector) │ Persistence (JSONL)    │        │
+│  └───────────────────────────────────────────────────────┘        │
+│                                                                    │
+│  ┌───────────────────────────────────────────────────────┐        │
+│  │  Hooks System: Normalizer → Pattern Detector → Store  │        │
+│  │  (Auto-captures decisions, bugs, gotchas from agents) │        │
+│  └───────────────────────────────────────────────────────┘        │
+└───────────────────────────────────────────────────────────────────┘
 ```
 
 ---
@@ -349,7 +365,7 @@ cd memorix
 npm install
 
 npm run dev          # tsup watch mode
-npm test             # vitest (274 tests)
+npm test             # vitest (405 tests)
 npm run lint         # TypeScript type check
 npm run build        # Production build
 ```
@@ -366,7 +382,7 @@ src/
 ├── embedding/             # Optional fastembed vector provider
 ├── hooks/                 # Auto-memory hooks (normalizer + pattern detector)
 ├── workspace/             # Cross-agent MCP/workflow/skills sync
-├── rules/                 # Cross-agent rules sync (6 adapters)
+├── rules/                 # Cross-agent rules sync (7 adapters)
 ├── dashboard/             # Visual web dashboard (knowledge graph, stats)
 ├── project/               # Git-based project detection
 └── cli/                   # CLI commands (serve, hook, sync, dashboard)

package/dist/cli/index.js

@@ -3409,7 +3409,7 @@ async function installAgentRules(agent, projectRoot) {
       rulesPath = path5.join(projectRoot, "AGENTS.md");
       break;
     case "kiro":
-      rulesPath = path5.join(projectRoot, ".kiro", "rules", "memorix.md");
+      rulesPath = path5.join(projectRoot, ".kiro", "steering", "memorix.md");
       break;
     default:
       rulesPath = path5.join(projectRoot, ".agent", "rules", "memorix.md");
@@ -4820,7 +4820,8 @@ var init_sync = __esm({
       "claude-code": "Claude Code (CLAUDE.md, .claude/rules/*.md)",
       codex: "Codex (SKILL.md, AGENTS.md)",
       windsurf: "Windsurf (.windsurfrules, .windsurf/rules/*.md)",
-      antigravity: "Antigravity (.agent/rules/*.md, GEMINI.md)"
+      antigravity: "Antigravity (.agent/rules/*.md, GEMINI.md)",
+      kiro: "Kiro (.kiro/steering/*.md, AGENTS.md)"
     };
     sync_default = defineCommand3({
       meta: {
@@ -4830,7 +4831,7 @@ var init_sync = __esm({
       args: {
         target: {
           type: "string",
-          description: "Target agent format (cursor, claude-code, codex, windsurf, antigravity)",
+          description: "Target agent format (cursor, claude-code, codex, windsurf, antigravity, kiro)",
           required: false
         },
         dry: {
@@ -4873,11 +4874,11 @@ var init_sync = __esm({
         }
         let target = args.target;
         if (!target) {
-          const available = ["cursor", "claude-code", "codex", "windsurf", "antigravity"].filter(
+          const available = ["cursor", "claude-code", "codex", "windsurf", "antigravity", "kiro"].filter(
             (t) => !sources.includes(t)
           );
           if (available.length === 0) {
-            available.push("cursor", "claude-code", "codex", "windsurf", "antigravity");
+            available.push("cursor", "claude-code", "codex", "windsurf", "antigravity", "kiro");
           }
           const selected = await p2.select({
             message: "Generate rules for which agent?",
@@ -5306,14 +5307,65 @@ async function handleHookEvent(input) {
     return { observation: null, output: defaultOutput };
   }
   switch (input.event) {
-    case "session_start":
+    case "session_start": {
+      let contextSummary = "";
+      try {
+        const { detectProject: detectProject2 } = await Promise.resolve().then(() => (init_detector(), detector_exports));
+        const { getProjectDataDir: getProjectDataDir2, loadObservationsJson: loadObservationsJson2 } = await Promise.resolve().then(() => (init_persistence(), persistence_exports));
+        const project = await detectProject2(input.cwd || process.cwd());
+        const dataDir = await getProjectDataDir2(project.id);
+        const allObs = await loadObservationsJson2(dataDir);
+        if (allObs.length > 0) {
+          const PRIORITY_ORDER = {
+            "gotcha": 6,
+            "decision": 5,
+            "problem-solution": 4,
+            "trade-off": 3,
+            "discovery": 2,
+            "how-it-works": 1
+          };
+          const scored = allObs.map((obs, i) => ({
+            obs,
+            priority: PRIORITY_ORDER[obs.type ?? ""] ?? 0,
+            recency: i
+            // higher index = more recent
+          })).sort((a, b) => {
+            if (b.priority !== a.priority) return b.priority - a.priority;
+            return b.recency - a.recency;
+          });
+          const top = scored.slice(0, 5);
+          const TYPE_EMOJI = {
+            "gotcha": "\u{1F534}",
+            "decision": "\u{1F7E4}",
+            "problem-solution": "\u{1F7E1}",
+            "trade-off": "\u2696\uFE0F",
+            "discovery": "\u{1F7E3}",
+            "how-it-works": "\u{1F535}",
+            "what-changed": "\u{1F7E2}",
+            "why-it-exists": "\u{1F7E0}",
+            "session-request": "\u{1F3AF}"
+          };
+          const lines = top.map(({ obs }) => {
+            const emoji = TYPE_EMOJI[obs.type ?? ""] ?? "\u{1F4CC}";
+            const title = obs.title ?? "(untitled)";
+            const fact = obs.facts?.[0] ? ` \u2014 ${obs.facts[0]}` : "";
+            return `${emoji} ${title}${fact}`;
+          });
+          contextSummary = `
+
+Recent project memories (${project.name}):
+${lines.join("\n")}`;
+        }
+      } catch {
+      }
       return {
         observation: null,
         output: {
           continue: true,
-          systemMessage: "Memorix is active. Your memories from previous sessions are available via memorix_search."
+          systemMessage: `Memorix is active. Your memories from previous sessions are available via memorix_search.${contextSummary}`
         }
       };
+    }
     case "pre_compact":
       return {
         observation: buildObservation(input, extractContent(input)),