@cleocode/core 2026.4.74 → 2026.4.75

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/core",
-  "version": "2026.4.74",
+  "version": "2026.4.75",
   "description": "CLEO core business logic kernel — tasks, sessions, memory, orchestration, lifecycle, with bundled SQLite store",
   "type": "module",
   "main": "./dist/index.js",
@@ -76,13 +76,13 @@
     "write-file-atomic": "^7.0.1",
     "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@cleocode/adapters": "2026.4.74",
-    "@cleocode/contracts": "2026.4.74",
-    "@cleocode/agents": "2026.4.74",
-    "@cleocode/caamp": "2026.4.74",
-    "@cleocode/lafs": "2026.4.74",
-    "@cleocode/skills": "2026.4.74",
-    "@cleocode/nexus": "2026.4.74"
+    "@cleocode/agents": "2026.4.75",
+    "@cleocode/caamp": "2026.4.75",
+    "@cleocode/lafs": "2026.4.75",
+    "@cleocode/adapters": "2026.4.75",
+    "@cleocode/contracts": "2026.4.75",
+    "@cleocode/nexus": "2026.4.75",
+    "@cleocode/skills": "2026.4.75"
   },
   "engines": {
     "node": ">=24.0.0"

package/src/__tests__/injection-mvi-tiers.test.ts

@@ -30,8 +30,10 @@ describe('CLEO-INJECTION v2.4.0 CLI-only template', () => {
   });
 
   describe('Version and identity', () => {
-    it('has version 2.4.0', () => {
-      expect(content).toContain('Version: 2.4.0');
+    it('has version 2.4.1 (v2026.4.74 template update)', () => {
+      // Added: Triggers table, Orchestration + Docs cheat-sheets, Pre-Complete
+      // Gate Ritual, exit codes 80+83, and corrected `cleo observe` → `cleo memory observe`.
+      expect(content).toContain('Version: 2.4.1');
     });
 
     it('declares CLI-only dispatch', () => {
@@ -71,7 +73,8 @@ describe('CLEO-INJECTION v2.4.0 CLI-only template', () => {
       expect(content).toContain('cleo memory find');
       expect(content).toContain('cleo memory timeline');
       expect(content).toContain('cleo memory fetch');
-      expect(content).toContain('cleo observe');
+      // v2.4.1: corrected from bare `cleo observe` to actual CLI command
+      expect(content).toContain('cleo memory observe');
     });
 
     it('includes Error Handling', () => {
@@ -125,9 +128,9 @@ describe('CLEO-INJECTION v2.4.0 CLI-only template', () => {
   });
 
   describe('Template size', () => {
-    it('is under 100 lines (token-optimized)', () => {
+    it('is under 200 lines (token-optimized; v2.4.1 adds Triggers/Orchestration/Docs/Gate Ritual sections — ~140 lines still compact)', () => {
       const lines = content.split('\n').length;
-      expect(lines).toBeLessThanOrEqual(100);
+      expect(lines).toBeLessThanOrEqual(200);
     });
 
     it('is at least 50 lines (not accidentally empty)', () => {

package/templates/CLEO-INJECTION.md

@@ -1,6 +1,6 @@
 # CLEO Protocol
 
-Version: 2.4.0 | CLI-only dispatch | `cleo <command> [args]`
+Version: 2.4.1 | CLI-only dispatch | `cleo <command> [args]`
 
 ## Session Start (cheapest-first)
 
@@ -9,6 +9,7 @@ Version: 2.4.0 | CLI-only dispatch | `cleo <command> [args]`
 3. `cleo current` — active task? (~100 tokens)
 4. `cleo next` — what to work on (~300 tokens)
 5. `cleo show {id}` — full details for chosen task (~400 tokens)
+6. `cleo orchestrate start --epic TXXX` — for epics with ≥ 5 children (~300 tokens, auto-inits LOOM)
 
 ## Work Loop
 
@@ -18,6 +19,17 @@ Version: 2.4.0 | CLI-only dispatch | `cleo <command> [args]`
 4. `cleo complete {id}` → mark done
 5. `cleo next` → continue or end session
 
+## Triggers (when to call what)
+
+| Signal | Action |
+|--------|--------|
+| Epic with ≥ 5 child tasks just created | Run `cleo orchestrate start <epicId>` before touching any child |
+| You just ran `cleo complete <id>` for a non-trivial task | Run `cleo memory observe "..." --title "..."` with what you learned |
+| Task acceptance criterion contains "test" | Propose an `AcceptanceGate` with `kind:"test"` via `cleo req add` |
+| Session token budget ≈ 80% consumed | Run `cleo session end --note "..."` and hand off |
+| Multiple related tasks ready in parallel | Run `cleo orchestrate ready --epic <id>` for the wave set |
+| About to call `cleo complete` | First: check gates via `cleo show <id>` → run tests → then complete |
+
 ## Task Discovery
 
 **Use `cleo find` for discovery. NEVER `cleo list` for browsing.**
@@ -46,10 +58,30 @@ Version: 2.4.0 | CLI-only dispatch | `cleo <command> [args]`
 | Search | `cleo memory find "query"` | 50/hit |
 | Context | `cleo memory timeline <id>` | 200-500 |
 | Details | `cleo memory fetch <id>` | 500/entry |
-| Save | `cleo observe "text" --title "title"` | — |
+| Save | `cleo memory observe "text" --title "title"` | — |
+| LLM status | `cleo memory llm-status` | 50 |
+| Ground-truth promote | `cleo memory verify <id>` (owner only) | 50 |
 
 Memory bridge (`.cleo/memory-bridge.md`) auto-refreshes on session end and task completion.
 
+## Orchestration (for epics ≥ 5 tasks)
+
+| Goal | Command |
+|------|---------|
+| Initialize epic pipeline | `cleo orchestrate start <epicId>` (auto-inits LOOM research stage) |
+| Get parallel-safe wave | `cleo orchestrate ready --epic <id>` |
+| Get spawn prompt for a task | `cleo orchestrate spawn <taskId>` |
+| Multi-agent IVTR loop | `cleo orchestrate ivtr <taskId> --start` |
+| View epic wave plan | `cleo orchestrate waves <epicId>` |
+
+## Documents & Attachments
+
+| Goal | Command |
+|------|---------|
+| Attach file/url to task | `cleo docs add <taskId> <file>` or `--url <url>` |
+| List task attachments | `cleo docs list --task <id>` |
+| Generate llms.txt summary | `cleo docs generate --for <taskId>` |
+
 ## Error Handling
 
 Check exit code (`0` = success) and `"success"` in JSON output after every command.
@@ -59,6 +91,24 @@ Check exit code (`0` = success) and `"success"` in JSON output after every comma
 | 4 | `E_NOT_FOUND` | `cleo find` to verify ID |
 | 6 | `E_VALIDATION` | Check field lengths |
 | 10 | `E_PARENT_NOT_FOUND` | `cleo exists <id>` |
+| 80 | `E_LIFECYCLE_GATE_FAILED` | Parent epic not in implementation stage yet — advance with `cleo lifecycle complete` |
+| 83 | `E_IVTR_INCOMPLETE` | IVTR loop not released — run `cleo orchestrate ivtr <id> --next` |
+
+## Pre-Complete Gate Ritual
+
+MANDATORY before every `cleo complete <id>`:
+
+1. `cleo show <id>` — inspect gates
+2. Run each acceptance criterion verifiable (tests, lint, file checks)
+3. `cleo verify <id> --run` — executes programmatic AcceptanceGates
+4. `cleo memory observe "..." --title "..."` — capture learnings
+5. `cleo complete <id>` — should pass cleanly
+
+Anti-patterns to avoid:
+- ❌ Calling `cleo complete` without verifying tests actually ran
+- ❌ Marking all gates green on `cleo verify --all` when only some criteria were checked
+- ❌ Skipping `cleo memory observe` on non-trivial tasks
+- ❌ Self-attesting without programmatic proof (IVTR validate phase exists to prevent this)
 
 ## Rules