compound-agent 1.4.4 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/CHANGELOG.md +55 -35
  2. package/LICENSE +1 -1
  3. package/README.md +80 -138
  4. package/context7.json +21 -0
  5. package/dist/cli.js +933 -753
  6. package/dist/cli.js.map +1 -1
  7. package/dist/index.js.map +1 -1
  8. package/llms.txt +31 -0
  9. package/package.json +22 -8
package/llms.txt ADDED
@@ -0,0 +1,31 @@
1
+ # Compound Agent
2
+
3
+ > Semantic memory plugin for Claude Code. Captures lessons from mistakes, corrections, and discoveries. Stores them in git-tracked JSONL with SQLite FTS5 indexing and local vector embeddings (EmbeddingGemma-300M via node-llama-cpp). Retrieves relevant knowledge at session start, during planning, and before architectural decisions. Install as a dev dependency, run `npx ca setup`, and every work cycle compounds -- mistakes become searchable lessons that prevent recurrence.
4
+
5
+ Compound Agent is a TypeScript CLI tool (`ca`) installable via npm/pnpm. It integrates with Claude Code through hooks (SessionStart, PreCompact, UserPromptSubmit, PostToolUseFailure, PostToolUse) and slash commands (/compound:brainstorm, /compound:plan, /compound:work, /compound:review, /compound:compound, /compound:lfg). Storage uses a three-layer architecture: Beads for issue tracking, Semantic Memory for knowledge, and Workflows for structured development phases.
6
+
7
+ ## Core Documentation
8
+
9
+ - [README](https://github.com/Nathandela/compound-agent/blob/main/README.md): Installation, quick start, CLI reference, memory schema
10
+ - [Architecture](https://github.com/Nathandela/compound-agent/blob/main/docs/ARCHITECTURE-V2.md): Three-layer architecture (Beads + Semantic Memory + Workflows)
11
+ - [AGENTS.md](https://github.com/Nathandela/compound-agent/blob/main/AGENTS.md): Agent workflow instructions and phase contracts
12
+ - [CHANGELOG](https://github.com/Nathandela/compound-agent/blob/main/CHANGELOG.md): Version history and migration notes
13
+
14
+ ## API and Schema
15
+
16
+ - [Public API](https://github.com/Nathandela/compound-agent/blob/main/src/index.ts): Exported functions and types
17
+ - [Memory types](https://github.com/Nathandela/compound-agent/blob/main/src/memory/types.ts): Zod schemas for lesson, solution, pattern, preference
18
+ - [Migration guide](https://github.com/Nathandela/compound-agent/blob/main/docs/MIGRATION.md): Migrating from learning-agent to compound-agent
19
+
20
+ ## Design Decisions
21
+
22
+ - [ADR-001](https://github.com/Nathandela/compound-agent/blob/main/docs/adr/ADR-001-jsonl-with-sqlite-index.md): JSONL with SQLite FTS5 index (git-friendly source of truth)
23
+ - [ADR-002](https://github.com/Nathandela/compound-agent/blob/main/docs/adr/ADR-002-local-embeddings.md): Local embeddings via node-llama-cpp (no cloud dependency)
24
+ - [ADR-003](https://github.com/Nathandela/compound-agent/blob/main/docs/adr/ADR-003-zod-schema-validation.md): Zod schema validation (runtime type safety)
25
+ - [ADR-004](https://github.com/Nathandela/compound-agent/blob/main/docs/adr/ADR-004-hybrid-search.md): Hybrid search (70% vector + 30% BM25)
26
+
27
+ ## Optional
28
+
29
+ - [Competitive landscape](https://github.com/Nathandela/compound-agent/blob/main/docs/LANDSCAPE.md): Comparison with mem0, Letta, Claude Reflect, GitHub Copilot Memory
30
+ - [Contributing](https://github.com/Nathandela/compound-agent/blob/main/CONTRIBUTING.md): Development setup and TDD workflow
31
+ - [Resource lifecycle](https://github.com/Nathandela/compound-agent/blob/main/docs/RESOURCE_LIFECYCLE.md): Singleton management for SQLite and embeddings
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "compound-agent",
3
- "version": "1.4.4",
3
+ "version": "1.5.0",
4
4
  "description": "Semantically-intelligent workflow plugin for Claude Code",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -19,16 +19,19 @@
19
19
  "dist",
20
20
  "docs/research",
21
21
  "scripts/postinstall.mjs",
22
- "CHANGELOG.md"
22
+ "CHANGELOG.md",
23
+ "llms.txt",
24
+ "context7.json"
23
25
  ],
24
26
  "repository": {
25
27
  "type": "git",
26
- "url": "git+https://github.com/Nathandela/learning_agent.git"
28
+ "url": "git+https://github.com/Nathandela/compound-agent.git"
27
29
  },
28
30
  "bugs": {
29
- "url": "https://github.com/Nathandela/learning_agent/issues"
31
+ "url": "https://github.com/Nathandela/compound-agent/issues"
30
32
  },
31
- "homepage": "https://github.com/Nathandela/learning_agent#readme",
33
+ "homepage": "https://github.com/Nathandela/compound-agent#readme",
34
+ "llms": "https://raw.githubusercontent.com/Nathandela/compound-agent/main/llms.txt",
32
35
  "scripts": {
33
36
  "postinstall": "node scripts/postinstall.mjs",
34
37
  "prebuild": "tsx scripts/extract-changelog.ts",
@@ -50,11 +53,22 @@
50
53
  },
51
54
  "keywords": [
52
55
  "claude",
53
- "compound",
54
- "workflow",
56
+ "claude-code",
57
+ "compound-agent",
58
+ "semantic-memory",
55
59
  "memory",
60
+ "embeddings",
61
+ "vector-search",
56
62
  "ai",
57
- "agent"
63
+ "agent",
64
+ "llm",
65
+ "plugin",
66
+ "cli",
67
+ "developer-tools",
68
+ "workflow",
69
+ "tdd",
70
+ "sqlite",
71
+ "knowledge-management"
58
72
  ],
59
73
  "author": "Nathan Delacrétaz",
60
74
  "license": "MIT",