@cleocode/cleo 2026.3.12 → 2026.3.14

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 (41) hide show
  1. package/README.md +19 -16
  2. package/dist/cli/index.js +18790 -11784
  3. package/dist/cli/index.js.map +4 -4
  4. package/dist/mcp/index.js +29402 -19482
  5. package/dist/mcp/index.js.map +4 -4
  6. package/drizzle/20260305011924_cheerful_mongu/migration.sql +2 -0
  7. package/drizzle/20260305011924_cheerful_mongu/snapshot.json +2662 -0
  8. package/drizzle/20260305203927_demonic_storm/migration.sql +28 -0
  9. package/drizzle/20260305203927_demonic_storm/snapshot.json +2924 -0
  10. package/drizzle/20260306001243_spooky_rage/migration.sql +25 -0
  11. package/drizzle/20260306001243_spooky_rage/snapshot.json +2939 -0
  12. package/drizzle-brain/20260301230215_workable_spitfire/migration.sql +68 -0
  13. package/drizzle-brain/20260301230215_workable_spitfire/snapshot.json +651 -0
  14. package/drizzle-brain/20260302050325_unknown_justin_hammer/migration.sql +23 -0
  15. package/drizzle-brain/20260302050325_unknown_justin_hammer/snapshot.json +884 -0
  16. package/drizzle-brain/20260302061755_unusual_jamie_braddock/migration.sql +2 -0
  17. package/drizzle-brain/20260302061755_unusual_jamie_braddock/snapshot.json +908 -0
  18. package/drizzle-brain/20260302193548_luxuriant_glorian/migration.sql +20 -0
  19. package/drizzle-brain/20260302193548_luxuriant_glorian/snapshot.json +1078 -0
  20. package/drizzle-brain/20260304045002_white_thunderbolt_ross/migration.sql +16 -0
  21. package/drizzle-brain/20260304045002_white_thunderbolt_ross/snapshot.json +1233 -0
  22. package/package.json +3 -3
  23. package/packages/ct-skills/skills/_shared/skill-chaining-patterns.md +1 -1
  24. package/packages/ct-skills/skills/_shared/subagent-protocol-base.md +1 -1
  25. package/packages/ct-skills/skills/ct-cleo/SKILL.md +16 -7
  26. package/packages/ct-skills/skills/ct-cleo/references/loom-lifecycle.md +1 -1
  27. package/packages/ct-skills/skills/ct-cleo/references/orchestrator-constraints.md +3 -3
  28. package/packages/ct-skills/skills/ct-cleo/references/session-protocol.md +5 -5
  29. package/packages/ct-skills/skills/ct-epic-architect/references/patterns.md +1 -1
  30. package/packages/ct-skills/skills/ct-grade/SKILL.md +9 -9
  31. package/packages/ct-skills/skills/ct-orchestrator/SKILL.md +43 -43
  32. package/packages/ct-skills/skills/ct-skill-creator/SKILL.md +1 -1
  33. package/packages/ct-skills/skills/ct-skill-creator/scripts/init_skill.py +16 -10
  34. package/packages/ct-skills/skills/ct-stickynote/README.md +14 -0
  35. package/packages/ct-skills/skills/ct-stickynote/SKILL.md +46 -0
  36. package/packages/ct-skills/skills.json +3 -3
  37. package/schemas/nexus-registry.schema.json +1 -1
  38. package/schemas/operation-constitution.schema.json +438 -0
  39. package/schemas/system-flow-atlas.schema.json +125 -0
  40. package/server.json +4 -4
  41. package/templates/CLEO-INJECTION.md +12 -12
package/README.md CHANGED
@@ -98,8 +98,8 @@ CLEO is composed of four interdependent systems:
98
98
 
99
99
  | State | What It Means |
100
100
  |------|----------------|
101
- | **Shipped** | TypeScript CLI + MCP server, SQLite storage (`tasks.db` + `brain.db`), atomic operations, four-layer anti-hallucination, RCASD-IVTR+C lifecycle gates, session management, 3-layer BRAIN retrieval (`brain.search/timeline/fetch`), BRAIN observe writes, NEXUS dispatch domain wiring (12 operations), LAFS envelopes |
102
- | **In Progress / Planned** | Embedding generation + vector similarity pipeline (`T5158`/`T5159`), PageIndex traversal/query API (`T5161`), reasoning/session integration (`T5153`), `nexus.db` migration from JSON registry, full claude-mem automation retirement hooks (`T5145`) |
101
+ | **Shipped** | TypeScript CLI + MCP server, SQLite storage (`tasks.db` + `brain.db`), atomic operations, four-layer anti-hallucination, RCASD-IVTR+C lifecycle gates, session management, 3-layer BRAIN retrieval (`memory find/timeline/fetch`), BRAIN observe writes, NEXUS dispatch domain wiring (12 operations), LAFS envelopes |
102
+ | **In Progress / Planned** | Autonomous runtime foundation and runtime forms (`T5519`, `T5520`-`T5529`, `T5573`-`T5575`) for The Hearth, The Impulse, Watchers, Conduit, Looming Engine, The Sweep, Refinery, Living BRAIN, and The Proving; Living BRAIN embedding/vector substrate (`T5158`/`T5159`); PageIndex traversal/query API (`T5161`); reasoning/session integration (`T5153`); `nexus.db` migration from JSON registry; full claude-mem automation retirement hooks (`T5145`) |
103
103
 
104
104
  ### MCP Server
105
105
 
@@ -148,29 +148,32 @@ Supports: Claude Code, Claude Desktop, Cursor, Gemini CLI, Kimi, Antigravity, Wi
148
148
 
149
149
  #### Using the MCP Tools
150
150
 
151
- Your AI agent gets two tools: `cleo_query` (read) and `cleo_mutate` (write). Each takes a `domain`, `operation`, and optional `params`:
151
+ Your AI agent gets two tools: `query` (read) and `mutate` (write). Each takes a `domain`, `operation`, and optional `params`:
152
152
 
153
153
  ```bash
154
154
  # Read operations (never changes anything)
155
- cleo_query domain=tasks operation=find params={"query": "auth"}
156
- cleo_query domain=admin operation=dash
157
- cleo_query domain=tasks operation=next
155
+ query domain=tasks operation=find params={"query": "auth"}
156
+ query domain=admin operation=dash
157
+ query domain=tasks operation=next
158
158
 
159
159
  # Write operations (creates or modifies data)
160
- cleo_mutate domain=tasks operation=add params={"title": "...", "description": "..."}
161
- cleo_mutate domain=tasks operation=complete params={"taskId": "T1234", "notes": "Done."}
162
- cleo_mutate domain=issues operation=add.bug params={"title": "...", "body": "...", "dryRun": true}
160
+ mutate domain=tasks operation=add params={"title": "...", "description": "..."}
161
+ mutate domain=tasks operation=complete params={"taskId": "T1234", "notes": "Done."}
162
+ mutate domain=issues operation=add.bug params={"title": "...", "body": "...", "dryRun": true}
163
163
  ```
164
164
 
165
- 10 canonical domains, 198 operations (110 query + 88 mutate) across tasks, sessions, memory, check, pipeline, orchestration, tools, admin, nexus, and sharing. See the [MCP Usage Guide](docs/guides/mcp-usage-guide.mdx) for beginner-friendly walkthroughs.
165
+ 10 canonical domains, 256 operations (145 query + 111 mutate) across `tasks`, `session`, `memory`, `check`, `pipeline`, `orchestrate`, `tools`, `admin`, `nexus`, and `sticky`. See the [MCP Usage Guide](docs/guides/mcp-usage-guide.mdx) for beginner-friendly walkthroughs.
166
166
 
167
167
  ### Source of Truth Hierarchy
168
168
 
169
- 1. [`docs/concepts/vision.md`](docs/concepts/vision.md) - immutable product vision
169
+ 1. [`docs/concepts/CLEO-VISION.md`](docs/concepts/CLEO-VISION.md) - immutable product vision
170
170
  2. [`docs/specs/PORTABLE-BRAIN-SPEC.md`](docs/specs/PORTABLE-BRAIN-SPEC.md) - canonical normative contract
171
- 3. [`README.md`](README.md) - operational public contract
172
- 4. [`docs/specs/CLEO-STRATEGIC-ROADMAP-SPEC.md`](docs/specs/CLEO-STRATEGIC-ROADMAP-SPEC.md) - phased execution plan
173
- 5. [`docs/specs/CLEO-BRAIN-SPECIFICATION.md`](docs/specs/CLEO-BRAIN-SPECIFICATION.md) - detailed capability model
171
+ 3. [`docs/specs/CLEO-AUTONOMOUS-RUNTIME-SPEC.md`](docs/specs/CLEO-AUTONOMOUS-RUNTIME-SPEC.md) - normative mapping for The Hearth through The Proving across existing domains and hooks
172
+ 4. [`docs/specs/CLEO-CONDUIT-PROTOCOL-SPEC.md`](docs/specs/CLEO-CONDUIT-PROTOCOL-SPEC.md) - normative relay contract for Conduit: envelopes, addressing, leases, acknowledgement, retry, and runtime IPC
173
+ 5. [`docs/specs/CLEO-AUTONOMOUS-RUNTIME-IMPLEMENTATION-MAP.md`](docs/specs/CLEO-AUTONOMOUS-RUNTIME-IMPLEMENTATION-MAP.md) - concrete TypeScript vs Rust ownership and IPC boundaries for the autonomous runtime
174
+ 6. [`README.md`](README.md) - operational public contract
175
+ 7. [`docs/specs/CLEO-STRATEGIC-ROADMAP-SPEC.md`](docs/specs/CLEO-STRATEGIC-ROADMAP-SPEC.md) - phased execution plan
176
+ 8. [`docs/specs/CLEO-BRAIN-SPECIFICATION.md`](docs/specs/CLEO-BRAIN-SPECIFICATION.md) - detailed capability model
174
177
 
175
178
  ---
176
179
 
@@ -1068,8 +1071,8 @@ Subagent spawning is handled via the MCP orchestration domain:
1068
1071
 
1069
1072
  ```
1070
1073
  # Spawn a subagent for a task (via MCP)
1071
- cleo_mutate orchestrate.spawn { taskId: "T1234" }
1072
- cleo_mutate orchestrate.spawn { taskId: "T1234", skill: "ct-research-agent" }
1074
+ mutate orchestrate.spawn { taskId: "T1234" }
1075
+ mutate orchestrate.spawn { taskId: "T1234", skill: "ct-research-agent" }
1073
1076
  ```
1074
1077
 
1075
1078
  The spawn pipeline (implemented in `src/core/skills/orchestrator/spawn.ts`) automates: task validation, context loading, token injection, template rendering, and prompt generation.