agent-working-memory 0.5.6 → 0.6.1

package/README.md

@@ -65,7 +65,7 @@ Most "memory for AI" projects are vector databases with a retrieval wrapper. AWM
 | **Over time** | Grows forever, gets noisier | Consolidation: diameter-enforced clustering, cross-topic bridges, synaptic-tagged decay |
 | **Forgetting** | Manual cleanup | Cognitive forgetting: unused memories fade, reinforced knowledge persists (access-count modulated) |
 | **Feedback** | None | Useful/not-useful signals tune confidence and retrieval rank |
-| **Correction** | Delete and re-insert | Retraction: wrong memories invalidated, corrections linked, penalties propagate |
+| **Correction** | Delete and re-insert | Retraction: wrong memories invalidated, corrections linked, penalties propagate (depth 2, decaying) |
 | **Noise rejection** | None | Multi-channel agreement gate: requires 2+ retrieval channels to agree before returning results |
 | **Duplicates** | Stored repeatedly | Reinforce-on-duplicate: near-exact matches boost existing memory instead of creating copies |
 
@@ -73,31 +73,49 @@ The design is based on cognitive science — ACT-R activation decay, Hebbian lea
 
 ---
 
-## Benchmarks (v0.5.4)
+## Benchmarks (v0.6.0)
 
-| Eval | Score | What it tests |
-|------|-------|---------------|
-| Edge Cases | **100% (34/34)** | 9 failure modes: context collapse, hub toxicity, flashbulb distortion, narcissistic interference, identity collision, contradiction trapping, bridge overshoot, noise forgetting |
-| Stress Test | **96.2% (50/52)** | 500 memories, 100 sleep cycles, 10 topic clusters, 20 bridges/cycle, catastrophic forgetting, adversarial spam, recovery |
-| Workday | **93.3%** | 43 memories across 4 simulated work sessions, knowledge transfer, context switching, cross-cutting queries, noise filtering |
-| A/B Test | **AWM 85% vs Baseline 83%** | 100 project events, 24 recall questions, 22/22 fact recall |
-| Sleep Cycle | **85.7% pre-sleep** | 60 memories, 4 topic clusters, consolidation impact measurement |
-| Token Savings | **67.5% accuracy, 55% savings** | Memory-guided context vs full conversation history, 2.2x efficiency |
-| LoCoMo | **28.2%** | Industry-standard conversational memory benchmark (1,986 QA pairs, 10 conversations) |
-| Mini Multi-Hop | **80% (4/5)** | Entity bridging across conversation turns |
+### Eval Harness (new in v0.6.0)
 
-### Consolidation (v0.5.4 with BGE-small)
+| Suite | Score | Threshold | What it tests |
+|-------|-------|-----------|---------------|
+| Retrieval | **Recall@5 = 0.800** | >= 0.80 | 200 facts, 50 queries — BM25 + vector + reranker pipeline precision |
+| Associative | **success@10 = 1.000** | >= 0.70 | 20 multi-hop causal chains — graph walk finds non-obvious connections |
+| Redundancy | **dedup F1 = 0.966** | >= 0.80 | 50 clusters × 4 paraphrases — consolidation removes duplicates correctly |
+| Temporal | **Spearman = 0.932** | >= 0.75 | 25 facts with controlled age/access — ACT-R decay ranking accuracy |
+
+Key finding: **consolidation improves retrieval by 30%** — post-consolidation recall (0.950) exceeds pre-consolidation (0.650). Removing redundant noise helps ranking.
+
+### Full Test Suite
+
+| Command | Score | What it tests |
+|---------|-------|---------------|
+| `npm run eval` | **4/4 suites pass** | Retrieval, associative, redundancy, temporal benchmarks with ablation support |
+| `npm run test:run` | **77/77 tests** | Unit tests: salience, decay, hebbian, supersession, coordination |
+| `npm run test:mcp` | **5/5 pass** | MCP protocol: write, recall, feedback, retract, stats |
+| `npm run test:self` | **94.1% EXCELLENT** | Pipeline component checks across all cognitive subsystems |
+| `npm run test:edge` | **All pass** | 9 failure modes: narcissistic interference, identity collision, contradiction trapping, bridge overshoot, noise forgetting |
+| `npm run test:stress` | **96.2% (50/52)** | 500 memories, 100 sleep cycles, catastrophic forgetting, adversarial spam, recovery |
+| `npm run test:workday` | **93.3% EXCELLENT** | 43 memories across 4 projects, cross-cutting queries, noise filtering |
+| `npm run test:ab` | **AWM 20/22 vs Baseline 18/22** | AWM outperforms keyword baseline on architecture + testing topics |
+| `npm run test:sleep` | **71.4%** | 60 memories, 4 topic clusters, consolidation impact across 3 cycles |
+| `npm run test:tokens` | **56.3% savings, 2.3x efficiency** | Memory-guided context vs full history, keyword accuracy 72.5% |
+| `npm run test:pilot` | **14/15 pass** | Production-like queries with noise rejection (5/5 noise rejected) |
+| `npm run test:locomo` | **28.2%** | Industry-standard LoCoMo conversational memory benchmark (1,986 QA pairs) |
+
+### Consolidation Health (v0.6.0)
 
 | Metric | Value |
 |--------|-------|
 | Topic clusters formed | **10** per consolidation cycle |
 | Cross-topic bridges | **20** in first cycle |
-| Edges strengthened | **127** per cycle |
+| Edges strengthened | **135** per cycle (access-weighted) |
 | Graph size at scale | **3,000-4,500 edges** (500 memories) |
 | Recall after 100 cycles | **90%** stable |
 | Catastrophic forgetting survival | **5/5** (100%) |
+| Post-dedup retrieval | **0.950** (consolidation improves recall) |
 
-All evals are reproducible: `npm run test:edge`, `npm run test:stress`, `npm run test:workday`, etc. See [Testing & Evaluation](#testing--evaluation).
+All evals are reproducible. See [Testing & Evaluation](#testing--evaluation).
 
 ---
 
@@ -313,21 +331,34 @@ For detailed architecture including pipeline phases, database schema, and system
 ### Unit Tests
 
 ```bash
-npx vitest run    # 68 tests
+npx vitest run    # 77 tests (salience, decay, hebbian, supersession)
 ```
 
-### Eval Suites
+### Eval Harness (v0.6.0)
+
+```bash
+npm run eval                        # All 4 benchmark suites
+npm run eval -- --suite=retrieval   # Single suite
+npm run eval -- --bm25-only         # Ablation: BM25 only
+npm run eval -- --no-graph-walk     # Ablation: disable graph walk
+```
 
-| Command | What it tests | Score |
-|---------|--------------|-------|
-| `npm run test:edge` | 9 adversarial failure modes: context collapse, hub toxicity, flashbulb distortion, narcissistic interference, identity collision, contradiction trapping, bridge overshoot, noise benefit | **100% (34/34)** |
-| `npm run test:stress` | 500 memories, 100 sleep cycles, 10 clusters, 20 bridges, catastrophic forgetting, adversarial spam, recovery | **96.2% (50/52)** |
-| `npm run test:workday` | 43 memories across 4 projects, 14 recall challenges, noise filtering | **93.3%** |
-| `npm run test:ab` | AWM vs keyword baseline, 100 events, 24 questions | **AWM 85% (22/22 recall)** |
-| `npm run test:sleep` | 60 memories, 4 topic clusters, consolidation impact | **85.7% pre-sleep** |
-| `npm run test:tokens` | Token savings vs full conversation history | **67.5% accuracy, 55% savings** |
-| `npm run test:locomo` | LoCoMo conversational memory benchmark (1,986 QA pairs) | **28.2%** |
-| `npm run test:self` | Pipeline component checks | **97.4%** |
+Suites: retrieval (Recall@5), associative (multi-hop), redundancy (dedup F1), temporal (Spearman vs ACT-R). Ablation flags isolate each pipeline component's contribution.
+
+### Full Test Suite
+
+```bash
+npm run test:mcp      # MCP protocol smoke test (5/5)
+npm run test:self     # Pipeline component checks (94.1%)
+npm run test:edge     # 9 adversarial failure modes
+npm run test:stress   # 500 memories, 100 consolidation cycles (96.2%)
+npm run test:workday  # 4-session production simulation (93.3%)
+npm run test:ab       # AWM vs baseline comparison
+npm run test:sleep    # Consolidation impact measurement
+npm run test:tokens   # Token savings analysis (56.3% savings)
+npm run test:pilot    # Production-like query validation (14/15)
+npm run test:locomo   # LoCoMo industry benchmark (28.2%)
+```
 
 ---
 
@@ -363,34 +394,38 @@ npx vitest run    # 68 tests
 
 All three ML models run locally via ONNX. No external API calls for retrieval. The entire system is a single SQLite file + a Node.js process.
 
-## What's New in v0.5.4
+## What's New in v0.6.1
+
+- **Embedding version tracking** — new `embedding_model` column prevents silent drift when changing models. Each embedding records its source model.
+- **Batch embedding backfill** — consolidation uses `embedBatch()` (batch size 32) instead of single-item loop. 10x faster for large backfills.
+- **Deeper retraction propagation** — confidence penalties now propagate 2 hops (was 1) with 50% decay per hop, capped at 20 affected nodes.
+- **Retrieval timeouts** — 5s timeout on query expansion, 10s on cross-encoder reranker. Both fail gracefully to text-only signals.
+- **Channel push delivery** — assignments delivered directly to worker HTTP endpoints with mailbox fallback.
+- **Cross-UUID assignment migration** — resolves assignments across alternate agent UUIDs.
+
+### v0.6.0
 
-- **BGE-small-en-v1.5 embedding model** — retrieval-optimized, 60% higher cosine for related short texts
-- **Diameter-enforced clustering** — prevents semantic chaining, forms 10 distinct topic clusters
-- **Direct cross-topic bridging** — 20 bridges per consolidation cycle
-- **Dual BM25 retrieval** — keyword-stripped + expanded queries for better precision
-- **Multi-channel agreement gate** — OOD detection prevents off-topic results
-- **Reinforce-on-duplicate** — near-duplicate writes boost existing memories
-- **No-discard salience** — low-salience memories stored at reduced confidence (available for fallback recall)
-- **Synaptic tagging** — access count modulates decay (heavily-used memories persist longer)
-- **Coref expansion** — pronoun queries auto-expanded with recent entity names
-- **Async consolidation** — embedding backfill ensures all memories are clusterable
-- **Auto-backup** — database copied to backups/ on server startup
+- **Memory taxonomy** — memories classified as `episodic`, `semantic`, `procedural`, or `unclassified`. Auto-classified on write. Filter by type on recall.
+- **Query-adaptive retrieval** — pipeline adapts to query type: `targeted` | `exploratory` | `balanced` | `auto`.
+- **Decision propagation** — decisions broadcast to coordination layer for cross-agent discovery.
+- **Eval harness** — `npm run eval` benchmarks retrieval, associative, redundancy, and temporal performance.
+- **DB hardening** — busy_timeout, integrity check on startup, hot backups every 10 min, WAL checkpoint on shutdown.
 
-See [CHANGELOG-0.5.4.md](CHANGELOG-0.5.4.md) for full details.
+See [CHANGELOG.md](CHANGELOG.md) for full details.
 
 ## Project Status
 
-AWM is in active development (v0.5.4). The core memory pipeline, consolidation system, and MCP integration are stable and used daily in production coding workflows.
+AWM is in active development (v0.6.1). The core memory pipeline, consolidation system, multi-agent coordination, and MCP integration are stable and used daily in production coding workflows.
 
 - Core retrieval and consolidation: **stable**
 - MCP tools and Claude Code integration: **stable**
+- Multi-agent coordination: **stable** (v0.6.0)
 - Task management: **stable**
 - Hook sidecar and auto-checkpoint: **stable**
 - HTTP API: **stable** (for custom agents)
-- Cognitive consolidation (clustering, bridging): **stable** (v0.5.4)
+- Eval harness: **stable** (v0.6.0)
 
-See [CHANGELOG-0.5.4.md](CHANGELOG-0.5.4.md) for version history.
+See [CHANGELOG.md](CHANGELOG.md) for version history.
 
 ---
 

package/dist/adapters/claude-code.d.ts

@@ -0,0 +1,4 @@
+import type { CLIAdapter } from './types.js';
+declare const adapter: CLIAdapter;
+export default adapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AAG7E,QAAA,MAAM,OAAO,EAAE,UAwNd,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/adapters/claude-code.js

@@ -0,0 +1,218 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Claude Code adapter — writes .mcp.json, CLAUDE.md, and hooks.
+ *
+ * This is a direct extraction of the original setup() behavior.
+ * Zero behavioral change from the monolithic version.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { resolveMcpCommand, homedir, AWM_INSTRUCTION_CONTENT } from './common.js';
+const adapter = {
+    id: 'claude-code',
+    name: 'Claude Code',
+    supportsProjectScope: true,
+    supportsGlobalScope: true,
+    writeMcpConfig(ctx) {
+        const mcpCmd = resolveMcpCommand(ctx);
+        const mcpConfig = { ...mcpCmd, env: ctx.envVars };
+        // Global: ~/.mcp.json (standard MCP location, all projects)
+        // Project: .claude/mcp.json (Claude Code's native project scope)
+        const mcpJsonPath = ctx.isGlobal
+            ? join(homedir(), '.mcp.json')
+            : join(ctx.cwd, '.claude', 'mcp.json');
+        const mcpDir = dirname(mcpJsonPath);
+        if (!existsSync(mcpDir)) {
+            mkdirSync(mcpDir, { recursive: true });
+        }
+        let existing = {};
+        if (existsSync(mcpJsonPath)) {
+            try {
+                existing = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+            }
+            catch {
+                existing = {};
+            }
+        }
+        if (!existing.mcpServers)
+            existing.mcpServers = {};
+        existing.mcpServers['agent-working-memory'] = mcpConfig;
+        writeFileSync(mcpJsonPath, JSON.stringify(existing, null, 2) + '\n');
+        return `MCP config: ${mcpJsonPath}`;
+    },
+    writeInstructions(ctx, skip) {
+        const claudeMdPath = ctx.isGlobal
+            ? join(homedir(), '.claude', 'CLAUDE.md')
+            : join(ctx.cwd, 'CLAUDE.md');
+        if (skip)
+            return 'CLAUDE.md: skipped (--no-instructions)';
+        // Ensure parent directory exists
+        const dir = dirname(claudeMdPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        if (existsSync(claudeMdPath)) {
+            const content = readFileSync(claudeMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                return 'CLAUDE.md: already has AWM section (skipped)';
+            }
+            writeFileSync(claudeMdPath, content.trimEnd() + '\n\n' + AWM_INSTRUCTION_CONTENT);
+            return 'CLAUDE.md: appended AWM workflow section';
+        }
+        const title = ctx.isGlobal ? '# Global Instructions' : `# ${basename(ctx.cwd)}`;
+        writeFileSync(claudeMdPath, `${title}\n\n${AWM_INSTRUCTION_CONTENT}`);
+        return 'CLAUDE.md: created with AWM workflow section';
+    },
+    writeHooks(ctx, skip) {
+        if (skip)
+            return 'Hooks: skipped (--no-hooks)';
+        const settingsPath = join(homedir(), '.claude', 'settings.json');
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            }
+            catch {
+                settings = {};
+            }
+        }
+        if (!settings.hooks)
+            settings.hooks = {};
+        const hookUrl = `http://127.0.0.1:${ctx.hookPort}/hooks/checkpoint`;
+        // Stop — remind Claude to write/recall/switch tasks
+        settings.hooks.Stop = [{
+                matcher: '',
+                hooks: [{
+                        type: 'command',
+                        command: 'echo "MEMORY: (1) Did you learn anything new? Call memory_write. (2) Are you about to work on a topic you might have prior knowledge about? Call memory_recall. (3) Switching tasks? Call memory_task_begin."',
+                        timeout: 5,
+                        async: true,
+                    }],
+            }];
+        // Multi-port fallback for separate memory pools
+        const altPort = ctx.hookPort === '8401' ? '8402' : '8401';
+        const hookUrlAlt = `http://127.0.0.1:${altPort}/hooks/checkpoint`;
+        const buildHookCmd = (event, maxTime) => {
+            const primary = `curl -sf -X POST ${hookUrl} -H "Content-Type: application/json" -H "Authorization: Bearer ${ctx.hookSecret}" -d "{\\"hook_event_name\\":\\"${event}\\"}" --max-time ${maxTime}`;
+            const fallback = `curl -sf -X POST ${hookUrlAlt} -H "Content-Type: application/json" -H "Authorization: Bearer ${ctx.hookSecret}" -d "{\\"hook_event_name\\":\\"${event}\\"}" --max-time ${maxTime}`;
+            return `${primary} || ${fallback}`;
+        };
+        // PreCompact — auto-checkpoint before context compaction
+        settings.hooks.PreCompact = [{
+                matcher: '',
+                hooks: [{
+                        type: 'command',
+                        command: buildHookCmd('PreCompact', 5),
+                        timeout: 10,
+                    }],
+            }];
+        // SessionEnd — auto-checkpoint on session close
+        settings.hooks.SessionEnd = [{
+                matcher: '',
+                hooks: [{
+                        type: 'command',
+                        command: buildHookCmd('SessionEnd', 2),
+                        timeout: 5,
+                    }],
+            }];
+        const settingsDir = dirname(settingsPath);
+        if (!existsSync(settingsDir)) {
+            mkdirSync(settingsDir, { recursive: true });
+        }
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+        return `Hooks: Stop + PreCompact + SessionEnd (port ${ctx.hookPort})`;
+    },
+    diagnose(ctx) {
+        const results = [];
+        // Check MCP config — Claude Code reads from both locations, check all
+        const globalPath = join(homedir(), '.mcp.json');
+        const projectPath = join(ctx.cwd, '.claude', 'mcp.json');
+        const candidates = [projectPath, globalPath];
+        let foundConfig = false;
+        for (const mcpJsonPath of candidates) {
+            if (!existsSync(mcpJsonPath))
+                continue;
+            try {
+                const config = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+                if (config.mcpServers?.['agent-working-memory']) {
+                    results.push({ check: 'MCP config', status: 'ok', message: `AWM registered in ${mcpJsonPath}` });
+                    foundConfig = true;
+                    break;
+                }
+            }
+            catch { /* not valid JSON, skip */ }
+        }
+        if (!foundConfig) {
+            results.push({
+                check: 'MCP config',
+                status: 'fail',
+                message: 'No AWM MCP config found',
+                fix: `Run: awm setup claude-code${ctx.isGlobal ? ' --global' : ''}`,
+            });
+        }
+        // Check MCP entrypoint
+        if (ctx.hasDist) {
+            results.push({ check: 'MCP entrypoint', status: 'ok', message: `dist/mcp.js exists` });
+        }
+        else {
+            results.push({
+                check: 'MCP entrypoint',
+                status: 'warn',
+                message: 'dist/mcp.js not found — using dev mode (npx tsx)',
+                fix: 'Run: npm run build',
+            });
+        }
+        // Check database
+        if (existsSync(ctx.dbPath)) {
+            results.push({ check: 'Database', status: 'ok', message: ctx.dbPath });
+        }
+        else {
+            results.push({ check: 'Database', status: 'warn', message: `${ctx.dbPath} not found (will be created on first use)` });
+        }
+        // Check CLAUDE.md
+        const claudeMdPath = ctx.isGlobal
+            ? join(homedir(), '.claude', 'CLAUDE.md')
+            : join(ctx.cwd, 'CLAUDE.md');
+        if (existsSync(claudeMdPath)) {
+            const content = readFileSync(claudeMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                results.push({ check: 'Instructions', status: 'ok', message: `CLAUDE.md has AWM section` });
+            }
+            else {
+                results.push({
+                    check: 'Instructions',
+                    status: 'warn',
+                    message: `CLAUDE.md exists but missing AWM section`,
+                    fix: `Run: awm setup claude-code${ctx.isGlobal ? ' --global' : ''}`,
+                });
+            }
+        }
+        else {
+            results.push({ check: 'Instructions', status: 'warn', message: `CLAUDE.md not found` });
+        }
+        // Check hooks
+        const settingsPath = join(homedir(), '.claude', 'settings.json');
+        if (existsSync(settingsPath)) {
+            try {
+                const settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+                const hasHooks = settings.hooks?.PreCompact && settings.hooks?.SessionEnd;
+                if (hasHooks) {
+                    results.push({ check: 'Hooks', status: 'ok', message: 'PreCompact + SessionEnd configured' });
+                }
+                else {
+                    results.push({ check: 'Hooks', status: 'warn', message: 'Hooks partially configured' });
+                }
+            }
+            catch {
+                results.push({ check: 'Hooks', status: 'warn', message: 'settings.json is not valid JSON' });
+            }
+        }
+        else {
+            results.push({ check: 'Hooks', status: 'warn', message: 'No hooks configured (auto-checkpoint disabled)' });
+        }
+        return results;
+    },
+};
+export default adapter;
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,sCAAsC;AAEtC;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,OAAO,GAAe;IAC1B,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,aAAa;IACnB,oBAAoB,EAAE,IAAI;IAC1B,mBAAmB,EAAE,IAAI;IAEzB,cAAc,CAAC,GAAiB;QAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAElD,4DAA4D;QAC5D,iEAAiE;QACjE,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ;YAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC;YAC9B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,QAAQ,GAAQ,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;YAC5D,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,UAAU;YAAE,QAAQ,CAAC,UAAU,GAAG,EAAE,CAAC;QAEnD,QAAQ,CAAC,UAAU,CAAC,sBAAsB,CAAC,GAAG,SAAS,CAAC;QACxD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACrE,OAAO,eAAe,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,iBAAiB,CAAC,GAAiB,EAAE,IAAa;QAChD,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAE/B,IAAI,IAAI;YAAE,OAAO,wCAAwC,CAAC;QAE1D,iCAAiC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxC,OAAO,8CAA8C,CAAC;YACxD,CAAC;YACD,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,uBAAuB,CAAC,CAAC;YAClF,OAAO,0CAA0C,CAAC;QACpD,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAChF,aAAa,CAAC,YAAY,EAAE,GAAG,KAAK,OAAO,uBAAuB,EAAE,CAAC,CAAC;QACtE,OAAO,8CAA8C,CAAC;IACxD,CAAC;IAED,UAAU,CAAC,GAAiB,EAAE,IAAa;QACzC,IAAI,IAAI;YAAE,OAAO,6BAA6B,CAAC;QAE/C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,QAAQ,GAAQ,EAAE,CAAC;QACvB,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,GAAG,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK;YAAE,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;QAEzC,MAAM,OAAO,GAAG,oBAAoB,GAAG,CAAC,QAAQ,mBAAmB,CAAC;QAEpE,oDAAoD;QACpD,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;gBACrB,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,CAAC;wBACN,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,+MAA+M;wBACxN,OAAO,EAAE,CAAC;wBACV,KAAK,EAAE,IAAI;qBACZ,CAAC;aACH,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1D,MAAM,UAAU,GAAG,oBAAoB,OAAO,mBAAmB,CAAC;QAClE,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE;YACtD,MAAM,OAAO,GAAG,oBAAoB,OAAO,kEAAkE,GAAG,CAAC,UAAU,mCAAmC,KAAK,oBAAoB,OAAO,EAAE,CAAC;YACjM,MAAM,QAAQ,GAAG,oBAAoB,UAAU,kEAAkE,GAAG,CAAC,UAAU,mCAAmC,KAAK,oBAAoB,OAAO,EAAE,CAAC;YACrM,OAAO,GAAG,OAAO,OAAO,QAAQ,EAAE,CAAC;QACrC,CAAC,CAAC;QAEF,yDAAyD;QACzD,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC;gBAC3B,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,CAAC;wBACN,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;wBACtC,OAAO,EAAE,EAAE;qBACZ,CAAC;aACH,CAAC,CAAC;QAEH,gDAAgD;QAChD,QAAQ,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC;gBAC3B,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,CAAC;wBACN,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;wBACtC,OAAO,EAAE,CAAC;qBACX,CAAC;aACH,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAEtE,OAAO,+CAA+C,GAAG,CAAC,QAAQ,GAAG,CAAC;IACxE,CAAC;IAED,QAAQ,CAAC,GAAiB;QACxB,MAAM,OAAO,GAAuB,EAAE,CAAC;QAEvC,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAE7C,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,KAAK,MAAM,WAAW,IAAI,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;gBAAE,SAAS;YACvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC9D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,sBAAsB,CAAC,EAAE,CAAC;oBAChD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,WAAW,EAAE,EAAE,CAAC,CAAC;oBACjG,WAAW,GAAG,IAAI,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,YAAY;gBACnB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,yBAAyB;gBAClC,GAAG,EAAE,6BAA6B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;aACpE,CAAC,CAAC;QACL,CAAC;QAED,uBAAuB;QACvB,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,gBAAgB;gBACvB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,kDAAkD;gBAC3D,GAAG,EAAE,oBAAoB;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB;QACjB,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,2CAA2C,EAAE,CAAC,CAAC;QACzH,CAAC;QAED,kBAAkB;QAClB,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/B,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;YAC9F,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,cAAc;oBACrB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,0CAA0C;oBACnD,GAAG,EAAE,6BAA6B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;iBACpE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,cAAc;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;gBACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,UAAU,IAAI,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;gBAC1E,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;gBAChG,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;gBAC1F,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;YAC/F,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC,CAAC;QAC9G,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,4 @@
+import type { CLIAdapter } from './types.js';
+declare const adapter: CLIAdapter;
+export default adapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AA4G7E,QAAA,MAAM,OAAO,EAAE,UA2Id,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/adapters/codex.js

@@ -0,0 +1,226 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Codex CLI adapter — writes TOML config, AGENTS.md instructions.
+ *
+ * Codex stores MCP config in ~/.codex/config.toml (global only).
+ * Uses snake_case [mcp_servers.name] sections.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { resolveMcpCommand, homedir, AWM_INSTRUCTION_CONTENT } from './common.js';
+function parseTOML(content) {
+    const doc = { sections: new Map(), preamble: [] };
+    let currentSection = '';
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Section header
+        const sectionMatch = trimmed.match(/^\[([^\]]+)\]$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            if (!doc.sections.has(currentSection)) {
+                doc.sections.set(currentSection, {});
+            }
+            continue;
+        }
+        // Skip comments and empty lines
+        if (!trimmed || trimmed.startsWith('#')) {
+            if (!currentSection)
+                doc.preamble.push(line);
+            continue;
+        }
+        // Key = value
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1) {
+            if (!currentSection)
+                doc.preamble.push(line);
+            continue;
+        }
+        const key = trimmed.slice(0, eqIdx).trim();
+        const rawVal = trimmed.slice(eqIdx + 1).trim();
+        if (!currentSection) {
+            if (!doc.sections.has(''))
+                doc.sections.set('', {});
+            doc.sections.get('')[key] = parseTomlValue(rawVal);
+            continue;
+        }
+        if (!doc.sections.has(currentSection)) {
+            doc.sections.set(currentSection, {});
+        }
+        doc.sections.get(currentSection)[key] = parseTomlValue(rawVal);
+    }
+    return doc;
+}
+function parseTomlValue(raw) {
+    // Array: ["a", "b"]
+    if (raw.startsWith('[')) {
+        const inner = raw.slice(1, raw.lastIndexOf(']'));
+        return inner.split(',')
+            .map(s => s.trim().replace(/^["']|["']$/g, ''))
+            .filter(s => s.length > 0);
+    }
+    // Quoted string
+    return raw.replace(/^["']|["']$/g, '');
+}
+function serializeTOML(doc) {
+    const lines = [];
+    // Preamble (top-level content before any section)
+    if (doc.preamble.length > 0) {
+        lines.push(...doc.preamble);
+        if (lines.length > 0 && lines[lines.length - 1].trim() !== '') {
+            lines.push('');
+        }
+    }
+    for (const [section, values] of doc.sections) {
+        if (section === '')
+            continue; // already in preamble
+        lines.push(`[${section}]`);
+        for (const [key, val] of Object.entries(values)) {
+            if (Array.isArray(val)) {
+                const items = val.map(v => `"${v}"`).join(', ');
+                lines.push(`${key} = [${items}]`);
+            }
+            else {
+                lines.push(`${key} = "${val}"`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ─── Adapter ──────────────────────────────────────────
+const adapter = {
+    id: 'codex',
+    name: 'Codex',
+    supportsProjectScope: false,
+    supportsGlobalScope: true,
+    writeMcpConfig(ctx) {
+        if (!ctx.isGlobal) {
+            console.log('  Note: Codex only supports global MCP config. Using --global automatically.');
+        }
+        const configPath = join(homedir(), '.codex', 'config.toml');
+        const mcpCmd = resolveMcpCommand(ctx);
+        // Read existing config or start fresh
+        let doc;
+        if (existsSync(configPath)) {
+            doc = parseTOML(readFileSync(configPath, 'utf-8'));
+        }
+        else {
+            doc = { sections: new Map(), preamble: [] };
+            mkdirSync(dirname(configPath), { recursive: true });
+        }
+        // Write the MCP server section
+        const sectionName = 'mcp_servers.agent-working-memory';
+        doc.sections.set(sectionName, {
+            command: mcpCmd.command,
+            args: mcpCmd.args,
+        });
+        // Write env vars in a sub-section
+        const envSection = `${sectionName}.env`;
+        const envEntries = {};
+        for (const [key, val] of Object.entries(ctx.envVars)) {
+            envEntries[key] = val;
+        }
+        doc.sections.set(envSection, envEntries);
+        writeFileSync(configPath, serializeTOML(doc));
+        return `MCP config: ${configPath}`;
+    },
+    writeInstructions(ctx, skip) {
+        const agentsMdPath = join(ctx.cwd, 'AGENTS.md');
+        if (skip)
+            return 'AGENTS.md: skipped (--no-instructions)';
+        if (existsSync(agentsMdPath)) {
+            const content = readFileSync(agentsMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                return 'AGENTS.md: already has AWM section (skipped)';
+            }
+            writeFileSync(agentsMdPath, content.trimEnd() + '\n\n' + AWM_INSTRUCTION_CONTENT);
+            return 'AGENTS.md: appended AWM workflow section';
+        }
+        const title = `# ${basename(ctx.cwd)} — Agent Instructions`;
+        writeFileSync(agentsMdPath, `${title}\n\n${AWM_INSTRUCTION_CONTENT}`);
+        return 'AGENTS.md: created with AWM workflow section';
+    },
+    writeHooks(_ctx, _skip) {
+        return 'Hooks: not supported by Codex (auto-checkpoint unavailable)';
+    },
+    diagnose(ctx) {
+        const results = [];
+        // Check TOML config
+        const configPath = join(homedir(), '.codex', 'config.toml');
+        if (!existsSync(configPath)) {
+            results.push({
+                check: 'MCP config',
+                status: 'fail',
+                message: `${configPath} not found`,
+                fix: 'Run: awm setup codex',
+            });
+        }
+        else {
+            try {
+                const doc = parseTOML(readFileSync(configPath, 'utf-8'));
+                if (doc.sections.has('mcp_servers.agent-working-memory')) {
+                    results.push({ check: 'MCP config', status: 'ok', message: `AWM registered in ${configPath}` });
+                    // Verify the command points to a real file
+                    const section = doc.sections.get('mcp_servers.agent-working-memory');
+                    const args = section.args;
+                    if (Array.isArray(args) && args.length > 0) {
+                        const entrypoint = args[args.length - 1];
+                        if (existsSync(entrypoint)) {
+                            results.push({ check: 'MCP entrypoint', status: 'ok', message: entrypoint });
+                        }
+                        else {
+                            results.push({
+                                check: 'MCP entrypoint',
+                                status: 'fail',
+                                message: `Configured entrypoint not found: ${entrypoint}`,
+                                fix: 'Run: npm run build (in AWM package) then awm setup codex',
+                            });
+                        }
+                    }
+                }
+                else {
+                    results.push({
+                        check: 'MCP config',
+                        status: 'fail',
+                        message: 'config.toml exists but missing agent-working-memory section',
+                        fix: 'Run: awm setup codex',
+                    });
+                }
+            }
+            catch {
+                results.push({ check: 'MCP config', status: 'fail', message: `${configPath} could not be parsed` });
+            }
+        }
+        // Check database
+        if (existsSync(ctx.dbPath)) {
+            results.push({ check: 'Database', status: 'ok', message: ctx.dbPath });
+        }
+        else {
+            results.push({ check: 'Database', status: 'warn', message: `${ctx.dbPath} not found (will be created on first use)` });
+        }
+        // Check AGENTS.md
+        const agentsMdPath = join(ctx.cwd, 'AGENTS.md');
+        if (existsSync(agentsMdPath)) {
+            const content = readFileSync(agentsMdPath, 'utf-8');
+            if (content.includes('## Memory (AWM)')) {
+                results.push({ check: 'Instructions', status: 'ok', message: 'AGENTS.md has AWM section' });
+            }
+            else {
+                results.push({
+                    check: 'Instructions',
+                    status: 'warn',
+                    message: 'AGENTS.md exists but missing AWM section',
+                    fix: 'Run: awm setup codex',
+                });
+            }
+        }
+        else {
+            results.push({ check: 'Instructions', status: 'warn', message: 'AGENTS.md not found' });
+        }
+        return results;
+    },
+};
+export default adapter;
+//# sourceMappingURL=codex.js.map