memorix 0.6.2 → 0.6.4

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

@@ -52,6 +52,9 @@ function sanitizeProjectId(projectId) {
   return projectId.replace(/\//g, "--").replace(/[<>:"|?*\\]/g, "_");
 }
 async function getProjectDataDir(projectId, baseDir) {
+  if (projectId === "__invalid__") {
+    throw new Error("Cannot create data directory for invalid project");
+  }
   const base = baseDir ?? DEFAULT_DATA_DIR;
   const dirName = sanitizeProjectId(projectId);
   const dataDir = path2.join(base, dirName);
@@ -1223,6 +1226,7 @@ __export(detector_exports, {
 });
 import { execSync } from "child_process";
 import { existsSync } from "fs";
+import os2 from "os";
 import path3 from "path";
 function detectProject(cwd) {
   const basePath = cwd ?? process.cwd();
@@ -1233,11 +1237,77 @@ function detectProject(cwd) {
     const name2 = id2.split("/").pop() ?? path3.basename(rootPath);
     return { id: id2, name: name2, gitRemote, rootPath };
   }
+  if (!isValidProjectRoot(rootPath)) {
+    console.error(`[memorix] Skipped invalid project root: ${rootPath}`);
+    return { id: "__invalid__", name: "unknown", rootPath };
+  }
   const name = path3.basename(rootPath);
   const id = `local/${name}`;
   console.error(`[memorix] Warning: no git remote found at ${rootPath}, using fallback projectId: ${id}`);
   return { id, name, rootPath };
 }
+function isValidProjectRoot(dirPath) {
+  const resolved = path3.resolve(dirPath);
+  const home = path3.resolve(os2.homedir());
+  if (resolved === home) return false;
+  if (resolved === path3.parse(resolved).root) return false;
+  const basename2 = path3.basename(resolved).toLowerCase();
+  const knownNonProjectDirs = /* @__PURE__ */ new Set([
+    // IDE / editor config dirs
+    ".vscode",
+    ".cursor",
+    ".windsurf",
+    ".kiro",
+    ".codex",
+    ".gemini",
+    ".claude",
+    ".github",
+    ".git",
+    // OS / system dirs
+    "desktop",
+    "documents",
+    "downloads",
+    "pictures",
+    "videos",
+    "music",
+    "appdata",
+    "application data",
+    "library",
+    // Package manager / tool dirs
+    "node_modules",
+    ".npm",
+    ".yarn",
+    ".pnpm-store",
+    ".config",
+    ".local",
+    ".cache",
+    ".ssh",
+    ".memorix"
+  ]);
+  if (knownNonProjectDirs.has(basename2)) {
+    const parent = path3.resolve(path3.dirname(resolved));
+    if (parent === home || parent === path3.parse(parent).root) {
+      return false;
+    }
+  }
+  const projectIndicators = [
+    "package.json",
+    "Cargo.toml",
+    "go.mod",
+    "pyproject.toml",
+    "setup.py",
+    "pom.xml",
+    "build.gradle",
+    "Makefile",
+    "CMakeLists.txt",
+    "composer.json",
+    "Gemfile",
+    ".git",
+    "README.md",
+    "README"
+  ];
+  return projectIndicators.some((f) => existsSync(path3.join(resolved, f)));
+}
 function findPackageRoot(cwd) {
   let dir = path3.resolve(cwd);
   const root = path3.parse(dir).root;
@@ -3164,7 +3234,7 @@ __export(installers_exports, {
 });
 import * as fs3 from "fs/promises";
 import * as path5 from "path";
-import * as os2 from "os";
+import * as os3 from "os";
 import { createRequire } from "module";
 function resolveHookCommand() {
   if (process.platform === "win32") {
@@ -3269,7 +3339,7 @@ function getProjectConfigPath(agent, projectRoot) {
   }
 }
 function getGlobalConfigPath(agent) {
-  const home = os2.homedir();
+  const home = os3.homedir();
   switch (agent) {
     case "claude":
     case "copilot":
@@ -3284,7 +3354,7 @@ function getGlobalConfigPath(agent) {
 }
 async function detectInstalledAgents() {
   const agents = [];
-  const home = os2.homedir();
+  const home = os3.homedir();
   const claudeDir = path5.join(home, ".claude");
   try {
     await fs3.access(claudeDir);
@@ -3409,7 +3479,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 +4890,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 +4901,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 +4944,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?",
@@ -5028,9 +5099,10 @@ function normalizeCursor(payload, event) {
   return result;
 }
 function normalizeHookInput(payload) {
+  const directEvent = typeof payload.event === "string" ? EVENT_MAP[payload.event] : void 0;
   const agent = detectAgent(payload);
   const rawEventName = extractEventName(payload, agent);
-  const event = EVENT_MAP[rawEventName] ?? "post_tool";
+  const event = directEvent ?? EVENT_MAP[rawEventName] ?? "post_tool";
   const timestamp = payload.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
   let agentSpecific = {};
   switch (agent) {
@@ -5063,6 +5135,16 @@ var init_normalizer = __esm({
     "use strict";
     init_esm_shims();
     EVENT_MAP = {
+      // Identity mappings — already-normalized event names
+      // This allows direct payloads like { event: 'session_start' } to work
+      session_start: "session_start",
+      user_prompt: "user_prompt",
+      post_edit: "post_edit",
+      post_command: "post_command",
+      post_tool: "post_tool",
+      pre_compact: "pre_compact",
+      session_end: "session_end",
+      post_response: "post_response",
       // Claude Code / VS Code Copilot
       SessionStart: "session_start",
       UserPromptSubmit: "user_prompt",
@@ -5306,14 +5388,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)),