@cleocode/cleo 2026.3.7 → 2026.3.10

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cleocode/cleo",
3
- "version": "2026.3.7",
3
+ "version": "2026.3.10",
4
4
  "description": "CLEO V2 - TypeScript task management CLI for AI coding agents",
5
5
  "mcpName": "io.github.kryptobaseddev/cleo-mcp-server",
6
6
  "type": "module",
@@ -33,7 +33,9 @@
33
33
  "migrate:todos": "node dist/scripts/migrate-todo-to-tasks.js",
34
34
  "cleo:update-status": "node dist/scripts/update-task-status.js",
35
35
  "adr:validate": "tsx dev/validate-adrs.ts",
36
- "adr:manifest": "tsx dev/generate-adr-manifest.ts"
36
+ "adr:manifest": "tsx dev/generate-adr-manifest.ts",
37
+ "features:generate": "tsx dev/generate-features.ts",
38
+ "version:sync": "tsx dev/version-sync.ts"
37
39
  },
38
40
  "engines": {
39
41
  "node": ">=24.13.1"
@@ -61,7 +63,7 @@
61
63
  "server.json"
62
64
  ],
63
65
  "dependencies": {
64
- "@cleocode/caamp": "^1.1.3",
66
+ "@cleocode/caamp": "^1.5.2",
65
67
  "@cleocode/lafs-protocol": "^1.6.0",
66
68
  "@modelcontextprotocol/sdk": "^1.26.0",
67
69
  "ajv": "^8.18.0",
@@ -72,6 +74,7 @@
72
74
  "pino-roll": "^4.0.0",
73
75
  "proper-lockfile": "^4.1.2",
74
76
  "sql.js": "^1.14.0",
77
+ "sqlite-vec": "^0.1.7-alpha.2",
75
78
  "write-file-atomic": "^6.0.0",
76
79
  "yaml": "^2.8.2"
77
80
  },
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "core",
3
- "description": "Orchestration and pipeline awareness",
3
+ "description": "Orchestration and LOOM (RCASD-IVTR+C) pipeline awareness",
4
4
  "extends": "minimal",
5
- "skills": ["ct-orchestrator"],
5
+ "skills": ["ct-orchestrator", "loom"],
6
6
  "includeProtocols": ["agent-protocol"]
7
7
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "recommended",
3
- "description": "Full RCASD pipeline skills for epic-driven development",
3
+ "description": "Full LOOM (RCASD-IVTR+C pipeline) skills for epic-driven development",
4
4
  "extends": "core",
5
- "skills": ["ct-epic-architect", "ct-research-agent", "ct-spec-writer", "ct-validator"],
5
+ "skills": ["ct-epic-architect", "ct-research-agent", "ct-spec-writer", "ct-validator", "loom"],
6
6
  "includeProtocols": ["research", "consensus", "specification", "decomposition", "validation", "adr"]
7
7
  }
@@ -93,7 +93,9 @@ See the reference above for:
93
93
 
94
94
  ---
95
95
 
96
- ## Task Lifecycle Integration
96
+ ## Task Lifecycle Integration (LOOM)
97
+
98
+ All work follows the **LOOM** (Logical Order of Operations Methodology) framework through the RCASD-IVTR+C pipeline stages. See `docs/concepts/vision.md` for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.
97
99
 
98
100
  Reference: @skills/_shared/task-system-integration.md
99
101
 
@@ -35,7 +35,7 @@ MCP is the **primary** entry point. Use `cleo_query` for reads and `cleo_mutate`
35
35
  | `orchestrate` | `next` | Next task suggestion (`params: { epicId }`) |
36
36
  | `research` | `list` | Research manifest entries |
37
37
  | `research` | `show` | Research entry details (`params: { entryId }`) |
38
- | `validate` | `report` | Validate task data integrity |
38
+ | `check` | `schema` | Validate task data schema integrity |
39
39
  | `system` | `dash` | Project overview dashboard |
40
40
  | `system` | `context` | Context window usage |
41
41
  | `skills` | `list` | Available skills |
@@ -180,9 +180,11 @@ After EVERY command:
180
180
  | 11 | `E_DEPTH_EXCEEDED` | Max depth 3 (epic->task->subtask) |
181
181
  | 12 | `E_SIBLING_LIMIT` | Max 7 siblings per parent |
182
182
 
183
- ## RCSD-IVTR Lifecycle
183
+ ## RCSD-IVTR Lifecycle (LOOM)
184
184
 
185
- **Lifecycle**: See CLEO-INJECTION.md standard tier for full RCASD-IVTR+C pipeline details, or `references/rcsd-lifecycle.md` for gate enforcement and subagent architecture.
185
+ **LOOM** (Logical Order of Operations Methodology) is the systematic framework for how CLEO processes project threads through the RCASD-IVTR+C pipeline. See `docs/concepts/vision.md` for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.
186
+
187
+ **Lifecycle**: See CLEO-INJECTION.md standard tier for full RCASD-IVTR+C pipeline details, or `references/loom-lifecycle.md` for gate enforcement and subagent architecture.
186
188
 
187
189
  ## Pipeline Awareness
188
190
 
@@ -212,5 +214,5 @@ Epics follow the RCASD-IVTR+C lifecycle managed through pipeline stages. Use `pi
212
214
  For detailed guidance on specific topics, see:
213
215
 
214
216
  - **Session Protocol**: `references/session-protocol.md`
215
- - **RCSD Lifecycle**: `references/rcsd-lifecycle.md`
217
+ - **LOOM Lifecycle**: `references/loom-lifecycle.md`
216
218
  - **Anti-Patterns**: `references/anti-patterns.md`
@@ -1,16 +1,23 @@
1
- # RCSD-IVTR Lifecycle (Detailed)
1
+ # LOOM Lifecycle (Detailed)
2
2
 
3
- Projects follow a structured lifecycle with gate enforcement.
3
+ **LOOM** (Logical Order of Operations Methodology) is the systematic framework for how CLEO processes project threads through the RCASD-IVTR+C pipeline. This document details the lifecycle stages and gate enforcement.
4
+
5
+ See `docs/concepts/vision.md` for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.
4
6
 
5
7
  ## Pipeline Stages
6
8
 
7
9
  ```
8
- RCSD PIPELINE (setup phase):
9
- Research -> Consensus -> Specification -> Decomposition
10
- |
11
- v
12
- EXECUTION (core/polish):
13
- Implementation -> Contribution -> Release
10
+ LOOM (RCASD-IVTR+C) PIPELINE:
11
+
12
+ RCASD (Planning Phase):
13
+ Research -> Consensus -> Architecture Decision -> Specification -> Decomposition
14
+ |
15
+ v
16
+ IVTR (Execution Phase):
17
+ Implementation -> Validation -> Testing -> Release
18
+
19
+ +C (Cross-Cutting):
20
+ Contribution (applies across all stages)
14
21
  ```
15
22
 
16
23
  Each stage has a **lifecycle gate**. Entering a later stage requires prior stages to be `completed` or `skipped`. Gate enforcement mode is configured in `.cleo/config.json` (`strict` | `advisory` | `off`).
@@ -31,14 +38,16 @@ Each stage has a **lifecycle gate**. Entering a later stage requires prior stage
31
38
 
32
39
  ## Lifecycle Gate Enforcement
33
40
 
34
- CLEO enforces RCSD-IVTR lifecycle progression through automatic gate checks at spawn time.
41
+ CLEO enforces LOOM (RCASD-IVTR+C) lifecycle progression through automatic gate checks at spawn time.
35
42
 
36
43
  ```
37
- research --+---> consensus --+---> specification --+---> decomposition
38
- | | |
39
- | GATE | GATE | GATE
40
- | | |
41
- +-----------------+---------------------+---> implementation ---> release
44
+ research --+---> consensus --+---> architecture_decision --+---> specification --+---> decomposition
45
+ | | | |
46
+ | GATE | GATE | GATE | GATE
47
+ | | | |
48
+ +-----------------+------------------------------+--------------------+---> implementation --+---> release
49
+ |
50
+ validation/testing
42
51
  ```
43
52
 
44
53
  | Enforcement Mode | On Gate Failure | Default |
@@ -55,11 +55,13 @@ You are the **Orchestrator** - a conductor, not a musician. Coordinate complex w
55
55
  | ORC-008 | Zero architectural decisions | "Architecture MUST be pre-decided by HITL" |
56
56
  | ORC-009 | MUST NEVER write code | "Every line of code is written by a subagent" |
57
57
 
58
- ## RCASD Pipeline Management
58
+ ## RCASD Pipeline Management (LOOM)
59
59
 
60
- The orchestrator manages epic-level pipeline progression through the RCASD-IVTR+C lifecycle.
60
+ The orchestrator manages epic-level pipeline progression through the **LOOM** (Logical Order of Operations Methodology) framework — the systematic approach for processing project threads through the RCASD-IVTR+C lifecycle.
61
61
 
62
- **RCASD Pipeline Flow**: Research -> Consensus -> Architecture Decision -> Specification -> Decomposition -> Implementation -> Validation -> Testing -> Release -> Contribution
62
+ **LOOM Pipeline Flow**: Research -> Consensus -> Architecture Decision -> Specification -> Decomposition -> Implementation -> Validation -> Testing -> Release -> Contribution
63
+
64
+ See `docs/concepts/vision.md` for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.
63
65
 
64
66
  ### Pipeline Decision Matrix
65
67
 
@@ -118,7 +120,7 @@ This separation means the orchestrator protocol works identically regardless of
118
120
  ### Quick Start — MCP (Recommended)
119
121
 
120
122
  ```
121
- cleo_query({ domain: "orchestrate", operation: "start", params: { epicId: "T1575" }})
123
+ cleo_mutate({ domain: "orchestrate", operation: "start", params: { epicId: "T1575" }})
122
124
  ```
123
125
 
124
126
  **Returns**: Session state, context budget, next task, pipeline stage, and recommended action in one call.
@@ -230,7 +232,7 @@ The spawn prompt combines the **Base Protocol** (`agents/cleo-subagent/AGENT.md`
230
232
  ### Phase 1: Discovery
231
233
 
232
234
  ```
233
- cleo_query({ domain: "orchestrate", operation: "start", params: { epicId: "T1575" }})
235
+ cleo_mutate({ domain: "orchestrate", operation: "start", params: { epicId: "T1575" }})
234
236
  cleo_query({ domain: "research", operation: "pending" })
235
237
  cleo_query({ domain: "pipeline", operation: "stage.status", params: { epicId: "T1575" }})
236
238
  ```
@@ -322,7 +324,7 @@ Content flows between subagents via **manifest-mediated handoffs**, not through
322
324
  | Handling Manifest Followups | Subagent left TODOs | `research.pending`, `tasks.add` |
323
325
  | Parallel Execution | Independent tasks in same wave | `orchestrate.analyze`, `orchestrate.ready` |
324
326
  | Pipeline-Aware Orchestration | Multi-stage epics | `pipeline.stage.status`, `pipeline.stage.validate`, `pipeline.stage.gate.pass` |
325
- | Quality Gates | Verification required | `validate.report`, `pipeline.stage.validate` |
327
+ | Quality Gates | Verification required | `check.schema`, `pipeline.stage.validate` |
326
328
  | Release | Ship a version | `release.create`, `release.ship` |
327
329
 
328
330
  > Full executable workflows for each pattern: `references/orchestrator-patterns.md`
@@ -54,7 +54,7 @@
54
54
  "status": "active",
55
55
  "tier": 0,
56
56
  "token_budget": 6000,
57
- "references": ["skills/ct-cleo/references/session-protocol.md", "skills/ct-cleo/references/rcsd-lifecycle.md", "skills/ct-cleo/references/anti-patterns.md"],
57
+ "references": ["skills/ct-cleo/references/session-protocol.md", "skills/ct-cleo/references/loom-lifecycle.md", "skills/ct-cleo/references/anti-patterns.md"],
58
58
  "capabilities": {
59
59
  "inputs": ["TASK_ID", "SESSION_ID"],
60
60
  "outputs": ["session-state", "task-state"],
@@ -7,7 +7,7 @@
7
7
  "description": "CLEO task management protocol - core guidance for session, task, and workflow operations. Provides MCP-first workflow, CLI fallback, session protocol, task discovery patterns, RCSD lifecycle overview, and error handling. Load this skill for detailed CLEO protocol guidance.",
8
8
  "version": "2.0.0",
9
9
  "path": "skills/ct-cleo/SKILL.md",
10
- "references": ["skills/ct-cleo/references/session-protocol.md", "skills/ct-cleo/references/rcsd-lifecycle.md", "skills/ct-cleo/references/anti-patterns.md"],
10
+ "references": ["skills/ct-cleo/references/session-protocol.md", "skills/ct-cleo/references/loom-lifecycle.md", "skills/ct-cleo/references/anti-patterns.md"],
11
11
  "core": true,
12
12
  "category": "core",
13
13
  "tier": 0,
@@ -241,6 +241,25 @@
241
241
  "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
242
242
  "license": "MIT",
243
243
  "metadata": {}
244
+ },
245
+ {
246
+ "name": "loom",
247
+ "description": "LOOM (Logical Order of Operations Methodology) - the systematic framework for how CLEO processes project threads through the RCASD-IVTR+C pipeline. LOOM encompasses the full lifecycle methodology that transforms raw ideas into delivered artifacts, from Research through Release with the Contribution protocol (+C) running across all stages. References docs/concepts/vision.md for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.",
248
+ "version": "1.0.0",
249
+ "path": "docs/concepts/vision.md",
250
+ "references": [".cleo/adrs/ADR-007-domain-consolidation.md", ".cleo/adrs/ADR-009-BRAIN-cognitive-architecture.md"],
251
+ "core": false,
252
+ "category": "core",
253
+ "tier": 0,
254
+ "protocol": null,
255
+ "dependencies": [],
256
+ "sharedResources": [],
257
+ "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
258
+ "license": "MIT",
259
+ "metadata": {
260
+ "concepts": ["LOOM", "RCASD-IVTR+C", "lifecycle pipeline", "neural hierarchy", "brain metaphor"],
261
+ "domains": ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sharing"]
262
+ }
244
263
  }
245
264
  ]
246
265
  }