fix: prevent OOM crashes during init on large codebases

.claude/settings.local.json.engram-backup-2026-04-12T09-40-51-488Z.bak

@@ -0,0 +1,50 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Read|Edit|Write|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "engram intercept",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "engram intercept",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "engram intercept",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "engram intercept",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

.cursorrules

@@ -0,0 +1,55 @@
+<!-- engram:start -->
+## Codebase Structure (auto-generated by engram)
+
+**Graph:** 451 nodes, 1005 edges | 96% extracted, 4% inferred
+**View:** general
+
+## Core entities
+
+- `extractDirectory()` (function, 2 connections) — src/miners/ast-miner.ts
+- `extractFile()` (function, 2 connections) — src/miners/ast-miner.ts
+- `generateSummary()` (function, 2 connections) — src/autogen.ts
+- `writeToFile()` (function, 2 connections) — src/autogen.ts
+- `parseReadLikeBashCommand()` (function, 2 connections) — src/intercept/handlers/bash.ts
+- `createAuthService()` (function, 2 connections) — tests/intercept/handlers/bash.test.ts
+- `hashPassword()` (function, 2 connections) — tests/intercept/handlers/bash.test.ts
+- `SessionStore` (class, 2 connections) — tests/intercept/handlers/bash.test.ts
+
+## Structure
+
+- `./` — tsup.config.ts
+- `bench/` — runner.ts
+- `src/` — autogen.ts, cli.ts, core.ts, dashboard.ts, hooks.ts, serve.ts, watcher.ts
+- `src/ccs/` — exporter.ts, importer.ts
+- `src/db/` — migrate.ts
+- `src/generators/` — aider-context.ts, cursor-mdc.ts
+- `src/graph/` — path-utils.ts, query.ts, render-utils.ts, schema.ts, store.ts
+- `src/intelligence/` — hook-log.ts, token-tracker.ts
+- `src/intercept/` — component-status.ts, context.ts, cursor-adapter.ts, dispatch.ts, formatter.ts, installer.ts, memory-md.ts, safety.ts, stats.ts
+- `src/intercept/handlers/` — bash.ts, cwd-changed.ts, edit-write.ts, lsp-capture.ts, post-tool.ts, pre-compact.ts, read.ts, session-start.ts, user-prompt.ts
+- `src/miners/` — ast-miner.ts, git-miner.ts, session-miner.ts, skills-miner.ts
+- `src/providers/` — ast.ts, context7.ts, engram-git.ts, engram-mistakes.ts, engram-structure.ts, grammar-loader.ts, lsp-connection.ts, lsp.ts, mempalace.ts, obsidian.ts, resolver.ts, types.ts
+- `src/server/` — http.ts
+- `src/tuner/` — config.ts, index.ts
+- `src/types/` — sql.js.d.ts
+- `tests/` — ast-miner.test.ts, autogen.test.ts, core.test.ts, mistake-memory.test.ts, provider-cache.test.ts, render-utils.test.ts, skills-miner.test.ts, store.test.ts, stress.test.ts, watcher.test.ts
+- `tests/ccs/` — ccs.test.ts
+- `tests/db/` — migrate.test.ts
+- `tests/fixtures/` — sample.ts
+- `tests/generators/` — cursor-mdc.test.ts
+- `tests/intercept/` — cli-intercept.test.ts, context.test.ts, cursor-adapter.test.ts, dispatch-new-events.test.ts, dispatch.test.ts, formatter.test.ts, get-file-context.test.ts, hook-log.test.ts, installer.test.ts, memory-md.test.ts, mistakes-filter.test.ts, render-file-structure.test.ts, safety.test.ts, spike-regression.test.ts, stats.test.ts
+- `tests/intercept/handlers/` — bash.test.ts, cwd-changed.test.ts, edit-write.test.ts, post-tool.test.ts, pre-compact.test.ts, read.test.ts, session-start.test.ts, user-prompt.test.ts
+- `tests/providers/` — ast.test.ts, lsp.test.ts, resolver.test.ts
+- `tests/server/` — http.test.ts
+- `tests/tuner/` — tuner.test.ts
+
+## Key dependencies
+
+- `node_path` (imported by 66 files)
+- `vitest` (imported by 41 files)
+- `node_fs` (imported by 37 files)
+- `node_os` (imported by 34 files)
+- `core.ts` (imported by 34 files)
+
+**Tip:** Run `engram query "your question"` for structural context instead of reading files.
+<!-- engram:end -->

.github/workflows/ci.yml

@@ -8,9 +8,11 @@ on:
 
 jobs:
   build-and-test:
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
+        os: [ubuntu-latest, windows-latest]
         node-version: [20, 22]
 
     steps:

.gitignore

@@ -5,3 +5,17 @@ dist/
 .env
 .DS_Store
 **/.DS_Store
+# Claude Code local hook install state — project-local, machine-specific
+.claude/settings.local.json
+# Generated IDE integration artifacts (users create these with engram gen-* commands)
+.aider-context.md
+.context/
+.cursor/
+# Dated benchmark result files (TEMPLATE.csv is tracked for reference)
+bench/results/*.json
+
+# Local planning docs (not published)
+.planning/
+
+# Hyperframes scratch/render directories (per-run intermediates)
+docs/demos/work-*/