memgrid 0.5.0 → 0.5.2

package/README.md

@@ -1,251 +1,284 @@
-# MemGrid
-
-> Project-level semantic memory for AI coding agents. Replaces full-codebase context loading with a self-evolving knowledge-mesh.
-
-## 🧠 What is MemGrid?
-
-MemGrid builds a **memory mesh** of your project — not as flat documents, but as interconnected **knowledge units**. Each unit represents one thing: a method, a component, a design pattern, a bug fix, a coding style preference, or a tooling rule.
-
-When an AI coding agent starts a task, instead of dumping your entire codebase into context, MemGrid retrieves only the relevant units — and traverses their associations to pull in related context.
-
-Think of it as **your project's persistent brain** that gets sharper with every task.
-
-## 🎯 The Problem
-
-AI coding tools today face a context dilemma:
-
-- Load the whole project → massive token waste, slow responses, OOM
-- Load only open files → no context, generic output, repeated mistakes
-- Start fresh every session → no learning, inconsistent style
-
-MemGrid solves this by giving the agent exactly what it needs, nothing it doesn't.
-
-## 📐 Architecture
-
-```
-┌─────────────────────────────────────────┐
-│           MemGrid (Agent Brain)          │
-│                                          │
-│  ┌────────────────────────────────────┐  │
-│  │  Scheduler Layer (Meta-Cognition)  │  │
-│  │  skill_trigger / mcp_trigger      │  │
-│  │  rule_trigger                     │  │
-│  │  "What tool for what task"        │  │
-│  └──────────┬─────────────────────────┘  │
-│             │ drives                     │
-│  ┌──────────▼─────────────────────────┐  │
-│  │  Knowledge Layer (Semantics)       │  │
-│  │  method / component / pattern      │  │
-│  │  config / error_solution           │  │
-│  │  "What this project is"             │  │
-│  └──────────┬─────────────────────────┘  │
-│             │ shapes                     │
-│  ┌──────────▼─────────────────────────┐  │
-│  │  Style Layer (Your DNA)            │  │
-│  │  style_preference                  │  │
-│  │  architecture_principle            │  │
-│  │  decision (why we did this)        │  │
-│  │  "What your code looks like"       │  │
-│  └────────────────────────────────────┘  │
-└─────────────────────────────────────────┘
-```
-
-## 🚀 Quick Start
-
-```bash
-npm install -g memgrid
-# or
-pnpm add -g memgrid
-```
-
-### Initialize
-
-```bash
-cd your-project
-memgrid init
-```
-
-MemGrid auto-detects your project's languages and scans all relevant source files.
-
-**Supported languages:** TypeScript, JavaScript, Python, Go, Rust, and any Markdown documentation.
-
-```bash
-# Example output for a TypeScript + Markdown + Rules project:
-# 🔍 Scanning project (typescript, markdown, rules, config)...
-```
-
-The grid is stored in `.claude/memory-grid/`.
-
-### Search
-
-```bash
-# Hybrid search (keyword + semantic, configurable weight)
-memgrid search "add file upload to creation endpoint"
-
-# With options
-memgrid search "error handling pattern" --semantic 0.6 --max 5 --hops 2
-```
-
-### Incremental Sync
-
-Fast sync after code changes — only re-scans changed files:
-
-```bash
-memgrid sync
-# Output:
-# 📁 Changed files:  3
-# 🗑️  Removed files:  0
-# 📝 Updated units:  12
-# ⚠️  Stale units:    0
-# 🔗 Repaired links: 2
-# ⏱️  Done in 1834ms
-```
-
-### Add Custom Units
-
-```bash
-memgrid add \
-  --type decision \
-  --summary "Why we chose PostgreSQL over MongoDB" \
-  --description "ACID compliance for financial data, team expertise, $REASON" \
-  --file docs/decisions/database.md
-```
-
-### Stats
-
-```bash
-memgrid stats
-# 📊 MemGrid Statistics
-#   Total units:    150
-#   Active:         142
-#   Archived:       8
-#   Last scan:      2026-06-28T10:00:00.000Z
-```
-
-### MCP Server
-
-```bash
-memgrid serve
-```
-
-Exposes MemGrid as an MCP tool — plug into Claude Desktop, VS Code, or any MCP-compatible agent.
-
-## 📦 Memory Unit Types
-
-| Type | What it stores | Example |
-|------|---------------|---------|
-| `method` | A function/class method | `CreationDomainService.create()` |
-| `component` | A UI component | `CreationCard` |
-| `pattern` | Design pattern or convention | ResponseBuilder chain pattern |
-| `config` | Configuration/env | Docker services, tech stack |
-| `error_solution` | A bug + how it was fixed | "GLM OOM → switch to DeepSeek" |
-| `decision` | A code decision + rationale | "Why delete returns true, not null" |
-| `skill_trigger` | When to use which skill | "Figma work → enable chakra MCP" |
-| `mcp_trigger` | When to call which MCP | "New Chakra component → get_component_example" |
-| `rule_trigger` | When to load which rule | "Server code → load coding-philosophy" |
-| `style_preference` | Your coding style | "functional pipes over for-loops" |
-| `architecture_principle` | Architecture red lines | "Controller never calls Repository directly" |
-
-## 🆚 vs Alternatives
-
-| | Claude Auto Memory | Mem0 | Cursor Indexing | **MemGrid** |
-|---|---|---|---|---|
-| Granularity | Documents | Conversations | Files | **Knowledge units** |
-| Structure | Flat text | Flat | File tree | **Mesh (graph)** |
-| Retrieval | Full load | Semantic | Semantic | **Hybrid + Traverse** |
-| Learning | Linear append | None | None | **Post-task self-evolution** |
-| Incremental sync | No | No | Full re-index | **Hash-diff incremental** |
-| Tool-aware | No | No | No | **Trigger units** |
-| Style-aware | Rules only | No | No | **Style layer** |
-
-## 📊 Performance
-
-| Scenario | Time |
-|----------|------|
-| Search (keyword) | < 3ms |
-| Search (repeated, LRU) | 0ms |
-| Sync (0 changes) | ~5ms |
-| Sync (1 file changed) | ~2s |
-| Full init (150 units) | ~10s |
-
-## 📁 File Format
-
-Memory units are stored as JSON in `.claude/memory-grid/units/` — **Git-friendly and human-readable**.
-
-```json
-{
-  "id": "method_creation_create",
-  "type": "method",
-  "summary": "CreationDomainService.create — Create a new work",
-  "source": {
-    "file": "apps/server/src/creation/creation.domain-service.ts",
-    "lines": "45-67"
-  },
-  "signatures": ["CreationDomainService.create"],
-  "content": {
-    "description": "Creates a new work, verifies ownership, saves to DB",
-    "inputs": "userId: string, dto: Partial<CreationEntity>",
-    "outputs": "ApiResponse{ value: savedEntity }"
-  },
-  "associations": [
-    {
-      "to": "pattern_response_builder",
-      "relation": "implements_pattern",
-      "weight": 0.9
-    }
-  ],
-  "meta": {
-    "created": "2026-06-28T00:00:00.000Z",
-    "updated": "2026-06-28T00:00:00.000Z",
-    "confidence": 0.8,
-    "usage_count": 0,
-    "status": "active"
-  }
-}
-```
-
-`mesh.json` stores the grid metadata including `fileSnapshot` for incremental sync and `edgeIndex` for fast association traversal.
-
-## 🌐 Language Support
-
-MemGrid is **language-agnostic** at its core. Scanners are swappable plugins:
-
-| Scanner | Detects | Extracts |
-|---------|---------|----------|
-| **TypeScript** | `tsconfig.json`, `.ts` files | Classes, methods, exported functions (AST via ts-morph) |
-| **JavaScript** | `package.json` (no tsconfig), `.js` files | Exported functions, classes, arrow functions (regex) |
-| **Python** | `pyproject.toml`, `.py` files | Functions, classes, decorators, docstrings (regex) |
-| **Go** | `go.mod`, `.go` files | Functions, methods, structs, interfaces (regex) |
-| **Rust** | `Cargo.toml`, `.rs` files | Functions, structs, enums, traits, impl blocks (regex) |
-| **Markdown** | Any `.md` files | Headings as knowledge units |
-| **Rules** | `.claude/rules/*.md` | Design patterns, coding rules, trigger units |
-| **Config** | `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `docker-compose.yml` | Tech stack, dependencies, infrastructure |
-
-**Adding a new language** means implementing the `Scanner` interface — the core engine (storage, retrieval, learning, sync) stays untouched.
-
-```typescript
-// src/scanner/python.ts (example)
-export class PythonScanner implements Scanner {
-  readonly name = 'python';
-  detect(projectRoot: string): boolean { ... }
-  async scan(options: ScanOptions): Promise<MemoryUnit[]> { ... }
-}
-```
-
-## 🔌 Integration
-
-MemGrid outputs **standardized Markdown context** consumable by any AI coding tool:
-
-- **Claude Code** — via MCP Server or Hook
-- **Cursor / Windsurf** — via Rules file injection
-- **GitHub Copilot** — via `.github/copilot-instructions.md`
-- **Aider / Cline / Continue** — via custom prompt templates
-
-```bash
-# Start MCP Server
-memgrid serve
-```
-
-## License
-
-MIT
+# MemGrid
+
+> Project-level semantic memory for AI coding agents. Replaces full-codebase context loading with a self-evolving knowledge-mesh.
+
+## 🧠 What is MemGrid?
+
+MemGrid builds a **memory mesh** of your project — not as flat documents, but as interconnected **knowledge units**. Each unit represents one thing: a method, a component, a design pattern, a bug fix, a coding style preference, or a tooling rule.
+
+When an AI coding agent starts a task, instead of dumping your entire codebase into context, MemGrid retrieves only the relevant units — and traverses their associations to pull in related context.
+
+Think of it as **your project's persistent brain** that gets sharper with every task.
+
+## 🎯 The Problem
+
+AI coding tools today face a context dilemma:
+
+- Load the whole project → massive token waste, slow responses, OOM
+- Load only open files → no context, generic output, repeated mistakes
+- Start fresh every session → no learning, inconsistent style
+
+MemGrid solves this by giving the agent exactly what it needs, nothing it doesn't.
+
+## 📐 Architecture
+
+```
+┌─────────────────────────────────────────┐
+│           MemGrid (Agent Brain)          │
+│                                          │
+│  ┌────────────────────────────────────┐  │
+│  │  Scheduler Layer (Meta-Cognition)  │  │
+│  │  skill_trigger / mcp_trigger      │  │
+│  │  rule_trigger                     │  │
+│  │  "What tool for what task"        │  │
+│  └──────────┬─────────────────────────┘  │
+│             │ drives                     │
+│  ┌──────────▼─────────────────────────┐  │
+│  │  Knowledge Layer (Semantics)       │  │
+│  │  method / component / pattern      │  │
+│  │  config / error_solution           │  │
+│  │  "What this project is"             │  │
+│  └──────────┬─────────────────────────┘  │
+│             │ shapes                     │
+│  ┌──────────▼─────────────────────────┐  │
+│  │  Style Layer (Your DNA)            │  │
+│  │  style_preference                  │  │
+│  │  architecture_principle            │  │
+│  │  decision (why we did this)        │  │
+│  │  "What your code looks like"       │  │
+│  └────────────────────────────────────┘  │
+└─────────────────────────────────────────┘
+```
+
+## 🚀 Quick Start
+
+```bash
+npm install -g memgrid
+# or
+pnpm add -g memgrid
+```
+
+### Initialize
+
+```bash
+cd your-project
+memgrid init
+```
+
+MemGrid auto-detects your project's languages and scans all relevant source files.
+
+**Supported languages:** TypeScript, JavaScript, Python, Go, Rust, and any Markdown documentation.
+
+```bash
+# Example output for a TypeScript + Markdown + Rules project:
+# 🔍 Scanning project (typescript, markdown, rules, config)...
+```
+
+The grid is stored in `.claude/memory-grid/`.
+
+### Search
+
+```bash
+# Hybrid search (keyword + semantic, configurable weight)
+memgrid search "add file upload to creation endpoint"
+
+# With options
+memgrid search "error handling pattern" --semantic 0.6 --max 5 --hops 2
+```
+
+### Incremental Sync
+
+Fast sync after code changes — only re-scans changed files:
+
+```bash
+memgrid sync
+# Output:
+# 📁 Changed files:  3
+# 🗑️  Removed files:  0
+# 📝 Updated units:  12
+# ⚠️  Stale units:    0
+# 🔗 Repaired links: 2
+# ⏱️  Done in 1834ms
+```
+
+### Add Custom Units
+
+```bash
+memgrid add \
+  --type decision \
+  --summary "Why we chose PostgreSQL over MongoDB" \
+  --description "ACID compliance for financial data, team expertise, $REASON" \
+  --file docs/decisions/database.md
+```
+
+### Stats
+
+```bash
+memgrid stats
+# 📊 MemGrid Statistics
+#   Total units:    150
+#   Active:         142
+#   Archived:       8
+#   Last scan:      2026-06-28T10:00:00.000Z
+```
+
+### MCP Server
+
+```bash
+memgrid serve
+```
+
+Exposes MemGrid as an MCP tool — plug into Claude Desktop, VS Code, or any MCP-compatible agent.
+
+## 📦 Memory Unit Types
+
+| Type | What it stores | Example |
+|------|---------------|---------|
+| `method` | A function/class method | `CreationDomainService.create()` |
+| `component` | A UI component | `CreationCard` |
+| `pattern` | Design pattern or convention | ResponseBuilder chain pattern |
+| `config` | Configuration/env | Docker services, tech stack |
+| `error_solution` | A bug + how it was fixed | "GLM OOM → switch to DeepSeek" |
+| `decision` | A code decision + rationale | "Why delete returns true, not null" |
+| `skill_trigger` | When to use which skill | "Figma work → enable chakra MCP" |
+| `mcp_trigger` | When to call which MCP | "New Chakra component → get_component_example" |
+| `rule_trigger` | When to load which rule | "Server code → load coding-philosophy" |
+| `style_preference` | Your coding style | "functional pipes over for-loops" |
+| `architecture_principle` | Architecture red lines | "Controller never calls Repository directly" |
+
+## 🆚 vs Alternatives
+
+| | Claude Auto Memory | Mem0 | Cursor Indexing | **MemGrid** |
+|---|---|---|---|---|
+| Granularity | Documents | Conversations | Files | **Knowledge units** |
+| Structure | Flat text | Flat | File tree | **Mesh (graph)** |
+| Retrieval | Full load | Semantic | Semantic | **Hybrid + Traverse** |
+| Learning | Linear append | None | None | **Post-task self-evolution** |
+| Incremental sync | No | No | Full re-index | **Hash-diff incremental** |
+| Tool-aware | No | No | No | **Trigger units** |
+| Style-aware | Rules only | No | No | **Style layer** |
+
+## 📊 Performance
+
+| Scenario | Time |
+|----------|------|
+| Search (keyword) | < 3ms |
+| Search (repeated, LRU) | 0ms |
+| Sync (0 changes) | ~5ms |
+| Sync (1 file changed) | ~2s |
+| Full init (150 units) | ~10s |
+
+## 📁 File Format
+
+Memory units are stored as JSON in `.claude/memory-grid/units/` — **Git-friendly and human-readable**.
+
+```json
+{
+  "id": "method_creation_create",
+  "type": "method",
+  "summary": "CreationDomainService.create — Create a new work",
+  "source": {
+    "file": "apps/server/src/creation/creation.domain-service.ts",
+    "lines": "45-67"
+  },
+  "signatures": ["CreationDomainService.create"],
+  "content": {
+    "description": "Creates a new work, verifies ownership, saves to DB",
+    "inputs": "userId: string, dto: Partial<CreationEntity>",
+    "outputs": "ApiResponse{ value: savedEntity }"
+  },
+  "associations": [
+    {
+      "to": "pattern_response_builder",
+      "relation": "implements_pattern",
+      "weight": 0.9
+    }
+  ],
+  "meta": {
+    "created": "2026-06-28T00:00:00.000Z",
+    "updated": "2026-06-28T00:00:00.000Z",
+    "confidence": 0.8,
+    "usage_count": 0,
+    "status": "active"
+  }
+}
+```
+
+`mesh.json` stores the grid metadata including `fileSnapshot` for incremental sync and `edgeIndex` for fast association traversal.
+
+## 🌐 Language Support
+
+MemGrid is **language-agnostic** at its core. Scanners are swappable plugins:
+
+| Scanner | Detects | Extracts |
+|---------|---------|----------|
+| **TypeScript** | `tsconfig.json`, `.ts` files | Classes, methods, exported functions (AST via ts-morph) |
+| **JavaScript** | `package.json` (no tsconfig), `.js` files | Exported functions, classes, arrow functions (regex) |
+| **Python** | `pyproject.toml`, `.py` files | Functions, classes, decorators, docstrings (regex) |
+| **Go** | `go.mod`, `.go` files | Functions, methods, structs, interfaces (regex) |
+| **Rust** | `Cargo.toml`, `.rs` files | Functions, structs, enums, traits, impl blocks (regex) |
+| **Markdown** | Any `.md` files | Headings as knowledge units |
+| **Rules** | `.claude/rules/*.md` | Design patterns, coding rules, trigger units |
+| **Config** | `package.json`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `docker-compose.yml` | Tech stack, dependencies, infrastructure |
+
+**Adding a new language** means implementing the `Scanner` interface — the core engine (storage, retrieval, learning, sync) stays untouched.
+
+```typescript
+// src/scanner/python.ts (example)
+export class PythonScanner implements Scanner {
+  readonly name = 'python';
+  detect(projectRoot: string): boolean { ... }
+  async scan(options: ScanOptions): Promise<MemoryUnit[]> { ... }
+}
+```
+
+## 🔌 Integration
+
+MemGrid outputs **standardized Markdown context** consumable by any AI coding tool:
+
+- **Claude Code** — via MCP Server or Hook
+- **Cursor / Windsurf** — via Rules file injection
+- **GitHub Copilot** — via `.github/copilot-instructions.md`
+- **Aider / Cline / Continue** — via custom prompt templates
+
+```bash
+# Start MCP Server
+memgrid serve
+```
+
+## 🔄 Auto-Sync Hooks
+
+`memgrid init` automatically configures hooks so your memory grid stays up to date without manual effort:
+
+| Hook | Trigger | What it does |
+|------|---------|--------------|
+| **PostCompletion** | Claude Code finishes a task | Runs `memgrid sync` automatically |
+| **post-commit** | `git commit` | Runs `memgrid sync` (covers non-Claude changes) |
+
+All injections are **non-destructive** — existing config is merged, never overwritten.
+
+## 📝 CLAUDE.md Integration (optional)
+
+To make your AI agent proactive about memory, add these sections to your CLAUDE.md:
+
+```markdown
+## MemGrid
+
+Before any task, search the memory grid for relevant context:
+
+```bash
+npx memgrid search "<what you're about to do>" --max 10
+```
+
+After completing code changes, sync the grid back:
+
+```bash
+npx memgrid sync
+```
+```
+
+> ⚠️ MemGrid won't touch your CLAUDE.md. The hooks above handle automatic sync. This snippet is just a recommendation — add it if you want your AI agent to actively *search* the grid before starting.
+
+## License
+
+MIT

package/dist/claude-md.d.ts

@@ -0,0 +1,4 @@
+export declare function injectMemGridFlow(projectRoot: string): {
+    action: 'created' | 'injected' | 'skipped';
+};
+//# sourceMappingURL=claude-md.d.ts.map

package/dist/claude-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../src/claude-md.ts"],"names":[],"mappings":"AA4BA,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAClB;IAAE,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;CAAE,CAqChD"}

package/dist/claude-md.js

@@ -0,0 +1,58 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const STARTUP_SECTION = `## 启动流程
+
+**每次任务开始时，必须先执行：**
+
+\`\`\`bash
+npx memgrid search "<任务关键词>" --max 10
+\`\`\`
+
+这会从项目的记忆网格中检索最相关的上下文：
+
+- 方法签名与实现
+- 设计模式与规则
+- 代码哲学与决策
+- 项目结构与配置`;
+const END_SECTION = `## 结束流程
+
+**每次代码变更完成后，必须执行：**
+
+\`\`\`bash
+npx memgrid sync
+\`\`\`
+
+这不是可选的——是任务结束的强制步骤。MemGrid 会增量分析代码变更，将新的方法签名、设计模式、决策等写入记忆网格，确保下一次任务启动时知识是最新的。`;
+export function injectMemGridFlow(projectRoot) {
+    const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
+    if (!fs.existsSync(claudeMdPath)) {
+        const content = `# Project\n\n${STARTUP_SECTION}\n\n${END_SECTION}\n`;
+        fs.writeFileSync(claudeMdPath, content, 'utf-8');
+        return { action: 'created' };
+    }
+    const existing = fs.readFileSync(claudeMdPath, 'utf-8');
+    const hasSearch = existing.includes('memgrid search');
+    const hasSync = existing.includes('memgrid sync');
+    if (hasSearch && hasSync) {
+        return { action: 'skipped' };
+    }
+    let modified = existing;
+    // Inject startup section after the first # heading line
+    if (!hasSearch) {
+        const headingMatch = modified.match(/^# .+$/m);
+        if (headingMatch && headingMatch.index !== undefined) {
+            const insertAt = headingMatch.index + headingMatch[0].length;
+            modified = modified.slice(0, insertAt) + '\n\n' + STARTUP_SECTION + '\n' + modified.slice(insertAt);
+        }
+        else {
+            modified = STARTUP_SECTION + '\n\n' + modified;
+        }
+    }
+    // Append end section
+    if (!hasSync) {
+        modified = modified.trimEnd() + '\n\n' + END_SECTION + '\n';
+    }
+    fs.writeFileSync(claudeMdPath, modified, 'utf-8');
+    return { action: 'injected' };
+}
+//# sourceMappingURL=claude-md.js.map

package/dist/claude-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.js","sourceRoot":"","sources":["../src/claude-md.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,eAAe,GAAG;;;;;;;;;;;;;UAad,CAAC;AAEX,MAAM,WAAW,GAAG;;;;;;;;8EAQ0D,CAAC;AAE/E,MAAM,UAAU,iBAAiB,CAC/B,WAAmB;IAEnB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,gBAAgB,eAAe,OAAO,WAAW,IAAI,CAAC;QACtE,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAElD,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAExB,wDAAwD;IACxD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,YAAY,IAAI,YAAY,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7D,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,MAAM,GAAG,eAAe,GAAG,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtG,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,eAAe,GAAG,MAAM,GAAG,QAAQ,CAAC;QACjD,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IAC9D,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC"}

package/dist/hooks.d.ts

@@ -0,0 +1,18 @@
+export interface InjectResult {
+    /** Which hooks were configured */
+    actions: string[];
+    /** Per-hook status */
+    details: {
+        claudeSettings?: 'created' | 'merged' | 'already_exists';
+        postCommit?: 'created' | 'already_exists' | 'not_hooky_project';
+    };
+}
+/**
+ * Inject MemGrid sync hooks into the project.
+ *
+ * Two hooks:
+ * 1. .claude/settings.json → PostCompletion: auto-sync after Claude finishes a task
+ * 2. .git/hooks/post-commit → auto-sync after git commit (covers non-Claude changes)
+ */
+export declare function injectHooks(projectRoot: string): InjectResult;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sBAAsB;IACtB,OAAO,EAAE;QACP,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC;QACzD,UAAU,CAAC,EAAE,SAAS,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;KACjE,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAqB7D"}