memorix 0.6.5 → 0.7.1

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.7.1] — 2026-02-22
+
+### Fixed
+- **Dashboard checkbox checkmark not visible** — Added `position: relative/absolute` to `.obs-checkbox::after` so the ✓ renders correctly in batch select mode
+- **Embedding provider status flickers to "fulltext only"** — Replaced `initialized` boolean flag with a shared Promise lock; concurrent callers now wait for the same initialization instead of seeing `provider = null` mid-load
+- **`memorix_dashboard` MCP tool reliability** — Replaced fixed 800ms wait with TCP port polling (up to 5s) so the tool only returns after the HTTP server is actually listening
+- **Dashboard embedding status always shows "fulltext only"** — Fixed root cause: dashboard is an independent process, `isEmbeddingEnabled()` from orama-store always returns false there; now uses `provider !== null` directly
+
+## [0.7.0] — 2026-02-21
+
+### Added
+- **Memory-Driven Skills Engine** (`memorix_skills` MCP tool):
+  - `list` — Discover all `SKILL.md` files across 7 agent directories
+  - `generate` — Auto-generate project-specific skills from observation patterns (gotchas, decisions, how-it-works)
+  - `inject` — Return full skill content directly to agent context
+  - Intelligent scoring: requires skill-worthy observation types, not just volume
+  - Write to any target agent with `write: true, target: "<agent>"`
+- **Transformers.js Embedding Provider**:
+  - Pure JavaScript fallback (`@huggingface/transformers`) — no native deps required
+  - Provider chain: `fastembed` → `transformers.js` → fulltext-only
+  - Quantized model (`q8`) for small footprint
+- **Dashboard Enhancements**:
+  - Canvas donut chart for observation type distribution
+  - Embedding provider status card (enabled/provider/dimensions)
+  - Search result highlighting with `<mark>` tags
+- **17 new tests** for Skills Engine (list, generate, inject, write, scoring, dedup)
+
+### Changed
+- Scoring algorithm requires at least 1 skill-worthy type (gotcha/decision/how-it-works/problem-solution/trade-off) — pure discovery/what-changed entities won't generate skills
+- Volume bonus reduced from 2×obs to 1×obs (capped at 5) to favor quality over quantity
+- Type diversity bonus increased from 2 to 3 points per unique skill-worthy type
+
+### Fixed
+- 422 tests passing (up from 405), 34 test files, zero regressions
+
 ## [0.5.0] — 2026-02-15
 
 ### Added

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-405%20passed-brightgreen?style=flat-square" alt="Tests">
+    <img src="https://img.shields.io/badge/tests-422%20passed-brightgreen?style=flat-square" alt="Tests">
   </p>
   <p align="center">
     <a href="#-quick-start">Quick Start</a> •
@@ -28,11 +28,8 @@
 
 ## ⚡ Quick Start
 
-### 30-Second Setup (Zero Install)
+One config line. Seven agents. Zero context loss.
 
-Add Memorix to your agent's MCP config — **that's it**. No global install needed.
-
-**Windsurf** → `~/.codeium/windsurf/mcp_config.json`
 ```json
 {
   "mcpServers": {
@@ -44,17 +41,9 @@ 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) • [Kiro](#kiro)
-
-### Or Install Globally
-
-```bash
-npm install -g memorix
-```
+Add this to your agent's MCP config, restart — done. 🎉
 
-Then use `"command": "memorix"` instead of `"command": "npx"` in your config.
+> 💡 Agent-specific config paths: [Windsurf](#windsurf) • [Cursor](#cursor) • [Claude Code](#claude-code) • [Codex](#codex) • [VS Code Copilot](#vs-code-copilot) • [Antigravity](#antigravity) • [Kiro](#kiro)
 
 ---
 
@@ -97,6 +86,7 @@ Then use `"command": "memorix"` instead of `"command": "npx"` in your config.
 - **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
+- **Memory-Driven Skills** — `memorix_skills` auto-generates project-specific `SKILL.md` from observation patterns (gotchas, decisions, how-it-works)
 - **Apply with Safety** — Backup `.bak` → Atomic write → Auto-rollback on failure
 
 ### 🔒 Project Isolation
@@ -112,8 +102,11 @@ Then use `"command": "memorix"` instead of `"command": "npx"` in your config.
 - **Web Dashboard** — `memorix_dashboard` opens a beautiful web UI at `http://localhost:3210`
 - **Project Switcher** — Dropdown to view any project's data without switching IDEs
 - **Knowledge Graph** — Interactive visualization of entities and relations
+- **Type Distribution Chart** — Canvas donut chart showing observation type breakdown
+- **Embedding Status** — Real-time display of vector search provider status (enabled/provider/dimensions)
 - **Retention Scores** — Exponential decay scoring with immunity status
-- **Observation Management** — Expand/collapse details, search, delete with confirmation, data export
+- **Observation Management** — Expand/collapse details, **search with text highlighting**, delete with confirmation, data export
+- **Batch Cleanup** — Auto-detect and bulk-delete low-quality observations
 - **Light/Dark Theme** — Premium glassmorphism design, bilingual (EN/中文)
 
 ### 🪝 Auto-Memory Hooks
@@ -139,6 +132,32 @@ Session 2: New chat, same project
 
 ## 🔧 Agent Configuration
 
+### Windsurf
+
+`~/.codeium/windsurf/mcp_config.json`:
+```json
+{
+  "mcpServers": {
+    "memorix": {
+      "command": "npx",
+      "args": ["-y", "memorix@latest", "serve"]
+    }
+  }
+}
+```
+
+> **Timeout troubleshooting** — If you see `MCP server initialization timed out after 60 seconds`, add `--cwd` to force the project root:
+> ```json
+> {
+>   "mcpServers": {
+>     "memorix": {
+>       "command": "npx",
+>       "args": ["-y", "memorix@latest", "serve", "--cwd", "<your-project-path>"]
+>     }
+>   }
+> }
+> ```
+
 ### Cursor
 
 `.cursor/mcp.json`:
@@ -327,15 +346,26 @@ Files: ["src/auth/jwt.ts", "src/config.ts"]
 
 ## 🔮 Optional: Vector Search
 
-Install `fastembed` for hybrid (BM25 + semantic) search:
+Memorix supports **hybrid search** (BM25 + semantic vectors) with a provider priority chain:
+
+| Priority | Provider | How to Enable | Notes |
+|----------|----------|---------------|-------|
+| 1st | `fastembed` | `npm install -g fastembed` | Fastest, native ONNX bindings |
+| 2nd | `transformers.js` | `npm install -g @huggingface/transformers` | Pure JS/WASM, cross-platform |
+| Fallback | Full-text (BM25) | Always available | Already very effective for code |
 
 ```bash
+# Option A: Native speed (recommended if it installs cleanly)
 npm install -g fastembed
+
+# Option B: Universal compatibility (works everywhere, no native deps)
+npm install -g @huggingface/transformers
 ```
 
-- **Without it** — BM25 full-text search (already very effective for code)
-- **With it** — Queries like "authentication" also match "login flow" via semantic similarity
-- Local ONNX inference, zero API calls, zero privacy risk
+- **Without either** — BM25 full-text search works great out of the box
+- **With any provider** — Queries like "authentication" also match "login flow" via semantic similarity
+- Both run **locally** — zero API calls, zero privacy risk, zero cost
+- The dashboard shows which provider is active in real-time
 
 ---
 
@@ -379,7 +409,8 @@ src/
 ├── memory/                # Graph, observations, retention, entity extraction
 ├── store/                 # Orama search engine + disk persistence
 ├── compact/               # 3-layer Progressive Disclosure engine
-├── embedding/             # Optional fastembed vector provider
+├── embedding/             # Vector providers (fastembed → transformers.js → fallback)
+├── skills/                # Memory-driven project skills engine (list → generate → inject)
 ├── hooks/                 # Auto-memory hooks (normalizer + pattern detector)
 ├── workspace/             # Cross-agent MCP/workflow/skills sync
 ├── rules/                 # Cross-agent rules sync (7 adapters)