memgrid 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -1,80 +1,99 @@
-# Changelog
-
-All notable changes to MemGrid.
-
-## v0.5.0 — Multi-Language + Incremental Sync (2026-06-28)
-
-### Added — Language-Agnostic Scanner Architecture
-- `Scanner` interface: `name`, `scan()`, `scanFiles?()`, `detect()`
-- `CompositeScanner`: auto-detects and composes multiple language scanners
-- **TypeScript** — `ts-morph` AST (classes, methods, exported functions, call graph associations)
-- **JavaScript** — regex (exported functions, classes, arrow functions)
-- **Python** — regex (functions, classes, decorators, docstrings)
-- **Go** — regex (functions, methods, structs, interfaces)
-- **Rust** — regex (functions, structs, enums, traits, impl blocks)
-- **Markdown** — headings as knowledge units from any `.md` file
-- **Rules** — `.claude/rules/*.md` → pattern + trigger units (universal, extracted from TS scanner)
-- **Config** — `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `docker-compose.yml` (universal)
-
-### Added — Incremental Sync
-- `memgrid sync` CLI command for incremental re-scan after code changes
-- `mg.sync()` API: hash-based file diff against baseline snapshot
-- File snapshots stored in `mesh.json.fileSnapshot` (SHA-256 per scanned file)
-- Fuzzy match repair: Jaccard + Dice similarity for fixing broken associations
-- Stale detection: marks orphaned units when source files are deleted
-- Fast path: 0 changes detected in ~5ms (hash compare only)
-
-### Changed
-- `mg.init()` now records initial file snapshot for future syncs
-- `MemoryGrid` type extended with optional `fileSnapshot`
-
-### Performance
-| Scenario | Time |
-|----------|------|
-| Sync 0 changes | ~5ms |
-| Sync 1 file | ~2s |
-| Sync 5 files (typical PR) | ~2-3s |
-| Full init (150 units) | ~10s |
-
-## v0.4.0 — Hybrid Semantic Search (2026-06-27)
-
-### Added
-- Hybrid search: combines MiniSearch (keyword) with semantic similarity
-- Configurable `semanticWeight` (0.0 = pure keyword, 1.0 = pure semantic)
-- Keyword embedding provider built-in (no external API required)
-- `--semantic` flag on CLI search command
-
-### Performance
-- 10 searches: 670ms → 3ms (223x improvement)
-- Repeated queries: 0ms (LRU cache)
-- Disk reload: 45ms → 5ms (9x, switched from YAML to JSON)
-
-## v0.3.0 — Auto-Learning Engine (2026-06-27)
-
-### Added
-- Post-task analysis: `mg.analyzeTask()` detects new methods, patterns, errors, decisions
-- `mg.applySuggestions()` writes learning results back to grid
-- `mg.formatSuggestions()` renders diff for human review
-- Learning suggestion types: `add`, `archive`, `update_confidence`
-
-### Changed
-- Memory unit meta fields: `confidence` (0.0-1.0) and `status` (active/stale/archived)
-
-## v0.2.0 — MCP Server + Tests (2026-06-26)
-
-### Added
-- Full MCP (Model Context Protocol) server via `memgrid serve`
-- MCP tools: `memgrid_search`, `memgrid_context`
-- Test suite with Vitest
-- Septonir project integration test
-
-## v0.1.0 — Core Engine (2026-06-26)
-
-### Added
-- TypeScript AST scanning with `ts-morph`: extracts methods, classes, exported functions
-- Rule extraction from `.claude/rules/*.md` (sections → pattern/trigger units)
-- Example extraction from `.claude/examples/` (good/bad patterns)
-- Config extraction from `package.json`, `docker-compose.yml`
-- Association graph building (call graph, pattern matching)
-- CLI: `init`, `search`, `add`, `stats`
-- File-based storage in `.claude/memory-grid/`
+# Changelog
+
+All notable changes to MemGrid.
+
+## v0.5.2 — Auto-Sync Hooks (unreleased)
+
+### Added
+- `memgrid init` auto-configures memory sync hooks:
+  - **Claude Code PostCompletion** → runs `memgrid sync` after each task
+  - **Git post-commit** → runs `memgrid sync` after each commit
+  - All injections are non-destructive (merges with existing config)
+
+### Changed
+- README: added Auto-Sync Hooks section + CLAUDE.md integration template
+
+## v0.5.1 — Search Bug Fix (2026-06-28)
+
+### Fixed
+- `memgrid search` returning empty results after fresh init
+  - Root cause: ES2022 `#private` fields broke internal cache access
+  - Fix: `listUnitsSync()` public method replaces direct private field access
+  - Also added `store.load()` to `search()`, `sync()`, `stats()` entry points
+
+## v0.5.0 — Multi-Language + Incremental Sync (2026-06-28)
+
+### Added — Language-Agnostic Scanner Architecture
+- `Scanner` interface: `name`, `scan()`, `scanFiles?()`, `detect()`
+- `CompositeScanner`: auto-detects and composes multiple language scanners
+- **TypeScript** — `ts-morph` AST (classes, methods, exported functions, call graph associations)
+- **JavaScript** — regex (exported functions, classes, arrow functions)
+- **Python** — regex (functions, classes, decorators, docstrings)
+- **Go** — regex (functions, methods, structs, interfaces)
+- **Rust** — regex (functions, structs, enums, traits, impl blocks)
+- **Markdown** — headings as knowledge units from any `.md` file
+- **Rules** — `.claude/rules/*.md` → pattern + trigger units (universal, extracted from TS scanner)
+- **Config** — `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `docker-compose.yml` (universal)
+
+### Added — Incremental Sync
+- `memgrid sync` CLI command for incremental re-scan after code changes
+- `mg.sync()` API: hash-based file diff against baseline snapshot
+- File snapshots stored in `mesh.json.fileSnapshot` (SHA-256 per scanned file)
+- Fuzzy match repair: Jaccard + Dice similarity for fixing broken associations
+- Stale detection: marks orphaned units when source files are deleted
+- Fast path: 0 changes detected in ~5ms (hash compare only)
+
+### Changed
+- `mg.init()` now records initial file snapshot for future syncs
+- `MemoryGrid` type extended with optional `fileSnapshot`
+
+### Performance
+| Scenario | Time |
+|----------|------|
+| Sync 0 changes | ~5ms |
+| Sync 1 file | ~2s |
+| Sync 5 files (typical PR) | ~2-3s |
+| Full init (150 units) | ~10s |
+
+## v0.4.0 — Hybrid Semantic Search (2026-06-27)
+
+### Added
+- Hybrid search: combines MiniSearch (keyword) with semantic similarity
+- Configurable `semanticWeight` (0.0 = pure keyword, 1.0 = pure semantic)
+- Keyword embedding provider built-in (no external API required)
+- `--semantic` flag on CLI search command
+
+### Performance
+- 10 searches: 670ms → 3ms (223x improvement)
+- Repeated queries: 0ms (LRU cache)
+- Disk reload: 45ms → 5ms (9x, switched from YAML to JSON)
+
+## v0.3.0 — Auto-Learning Engine (2026-06-27)
+
+### Added
+- Post-task analysis: `mg.analyzeTask()` detects new methods, patterns, errors, decisions
+- `mg.applySuggestions()` writes learning results back to grid
+- `mg.formatSuggestions()` renders diff for human review
+- Learning suggestion types: `add`, `archive`, `update_confidence`
+
+### Changed
+- Memory unit meta fields: `confidence` (0.0-1.0) and `status` (active/stale/archived)
+
+## v0.2.0 — MCP Server + Tests (2026-06-26)
+
+### Added
+- Full MCP (Model Context Protocol) server via `memgrid serve`
+- MCP tools: `memgrid_search`, `memgrid_context`
+- Test suite with Vitest
+- Septonir project integration test
+
+## v0.1.0 — Core Engine (2026-06-26)
+
+### Added
+- TypeScript AST scanning with `ts-morph`: extracts methods, classes, exported functions
+- Rule extraction from `.claude/rules/*.md` (sections → pattern/trigger units)
+- Example extraction from `.claude/examples/` (good/bad patterns)
+- Config extraction from `package.json`, `docker-compose.yml`
+- Association graph building (call graph, pattern matching)
+- CLI: `init`, `search`, `add`, `stats`
+- File-based storage in `.claude/memory-grid/`

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 wenliangw
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 wenliangw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.