@cleocode/cleo 2026.3.7 → 2026.3.11
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/README.md +98 -84
- package/bin/postinstall.js +117 -0
- package/dist/cli/index.js +30167 -28866
- package/dist/cli/index.js.map +4 -4
- package/dist/mcp/index.js +26765 -24105
- package/dist/mcp/index.js.map +4 -4
- package/drizzle/20260302163443_free_silk_fever/migration.sql +1 -0
- package/drizzle/20260302163443_free_silk_fever/snapshot.json +2618 -0
- package/drizzle/20260302163457_robust_johnny_storm/migration.sql +1 -0
- package/drizzle/20260302163457_robust_johnny_storm/snapshot.json +2628 -0
- package/drizzle/20260302163511_late_sphinx/migration.sql +1 -0
- package/drizzle/20260302163511_late_sphinx/snapshot.json +2638 -0
- package/package.json +9 -4
- package/packages/ct-skills/profiles/core.json +2 -2
- package/packages/ct-skills/profiles/recommended.json +2 -2
- package/packages/ct-skills/skills/_shared/subagent-protocol-base.md +3 -1
- package/packages/ct-skills/skills/ct-cleo/SKILL.md +6 -4
- package/packages/ct-skills/skills/ct-cleo/references/{rcsd-lifecycle.md → loom-lifecycle.md} +23 -14
- package/packages/ct-skills/skills/ct-orchestrator/SKILL.md +8 -6
- package/packages/ct-skills/skills/manifest.json +1 -1
- package/packages/ct-skills/skills.json +20 -1
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cleocode/cleo",
|
|
3
|
-
"version": "2026.3.
|
|
3
|
+
"version": "2026.3.11",
|
|
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",
|
|
@@ -30,10 +30,13 @@
|
|
|
30
30
|
"lint": "tsc --noEmit",
|
|
31
31
|
"prepare": "npm run build",
|
|
32
32
|
"prepack": "npm run build",
|
|
33
|
+
"postinstall": "node bin/postinstall.js",
|
|
33
34
|
"migrate:todos": "node dist/scripts/migrate-todo-to-tasks.js",
|
|
34
35
|
"cleo:update-status": "node dist/scripts/update-task-status.js",
|
|
35
36
|
"adr:validate": "tsx dev/validate-adrs.ts",
|
|
36
|
-
"adr:manifest": "tsx dev/generate-adr-manifest.ts"
|
|
37
|
+
"adr:manifest": "tsx dev/generate-adr-manifest.ts",
|
|
38
|
+
"features:generate": "tsx dev/generate-features.ts",
|
|
39
|
+
"version:sync": "tsx dev/version-sync.ts"
|
|
37
40
|
},
|
|
38
41
|
"engines": {
|
|
39
42
|
"node": ">=24.13.1"
|
|
@@ -58,10 +61,11 @@
|
|
|
58
61
|
"templates",
|
|
59
62
|
"packages/ct-skills/skills",
|
|
60
63
|
"completions",
|
|
61
|
-
"server.json"
|
|
64
|
+
"server.json",
|
|
65
|
+
"bin"
|
|
62
66
|
],
|
|
63
67
|
"dependencies": {
|
|
64
|
-
"@cleocode/caamp": "^1.
|
|
68
|
+
"@cleocode/caamp": "^1.5.2",
|
|
65
69
|
"@cleocode/lafs-protocol": "^1.6.0",
|
|
66
70
|
"@modelcontextprotocol/sdk": "^1.26.0",
|
|
67
71
|
"ajv": "^8.18.0",
|
|
@@ -72,6 +76,7 @@
|
|
|
72
76
|
"pino-roll": "^4.0.0",
|
|
73
77
|
"proper-lockfile": "^4.1.2",
|
|
74
78
|
"sql.js": "^1.14.0",
|
|
79
|
+
"sqlite-vec": "^0.1.7-alpha.2",
|
|
75
80
|
"write-file-atomic": "^6.0.0",
|
|
76
81
|
"yaml": "^2.8.2"
|
|
77
82
|
},
|
|
@@ -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
|
-
| `
|
|
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
|
-
**
|
|
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
|
-
- **
|
|
217
|
+
- **LOOM Lifecycle**: `references/loom-lifecycle.md`
|
|
216
218
|
- **Anti-Patterns**: `references/anti-patterns.md`
|
package/packages/ct-skills/skills/ct-cleo/references/{rcsd-lifecycle.md → loom-lifecycle.md}
RENAMED
|
@@ -1,16 +1,23 @@
|
|
|
1
|
-
#
|
|
1
|
+
# LOOM Lifecycle (Detailed)
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
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
|
|
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
|
|
40
|
-
| |
|
|
41
|
-
|
|
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
|
-
**
|
|
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
|
-
|
|
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
|
-
|
|
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 | `
|
|
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/
|
|
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/
|
|
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
|
}
|