@cleocode/skills 2026.11.5 → 2026.11.6-canary.1

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/skills",
3
- "version": "2026.11.5",
3
+ "version": "2026.11.6-canary.1",
4
4
  "description": "CLEO skill definitions - bundled with CLEO monorepo",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
@@ -2,14 +2,14 @@
2
2
  name: ct-cleo
3
3
  description: CLEO task management protocol - session, task, and workflow guidance. Use when managing tasks, sessions, or multi-agent workflows with the CLEO CLI protocol.
4
4
  metadata:
5
- version: 2.26.0
5
+ version: 2.28.0
6
6
  tier: core
7
7
  install: harness
8
8
  covers:
9
9
  - packages/cleo/src/cli/commands/session.ts
10
10
  - packages/cleo/src/cli/commands/focus.ts
11
11
  - packages/cleo/src/cli/commands/sticky.ts
12
- lastReviewed: 2026-11-12
12
+ lastReviewed: 2026-11-13
13
13
  stability: stable
14
14
  ---
15
15
 
@@ -239,7 +239,7 @@ This internal budget contract does not add a `--token-budget` flag to add/update
239
239
  | `references/memory.md` | recall or record BRAIN memory (progressive disclosure) |
240
240
  | `references/sticky-notes.md` | capture a thought before it is a task: `cleo sticky jot "..."`, then `cleo sticky convert <id> --to-task` |
241
241
 
242
- - Task hierarchy, Saga commands, add-batch decomposition, docs policy, and evidence detail live in the on-demand reference; emit `task-creation`, `documents`, and `evidence` when needed.
242
+ - Task hierarchy, depth/sibling errors, shell quoting, Saga commands, add-batch decomposition, docs policy, and evidence detail live in the on-demand reference; emit `task-creation`, `documents`, and `evidence` when needed.
243
243
  - For add-batch input, The top-level JSON MUST be an array of task objects, not an object wrapper like `{ "tasks": [...] }`.
244
244
  - Dry-run count semantics: `/data/count` and `/data/wouldCreate` predict writes; `/data/insertedCount` must be `0` for dry-run.
245
245
  - Mutation output paths: use `/data/created/0`, `/data/updated/0`, and `/data/deleted/0`; never parse legacy full records. `--output id` emits affected IDs once in created/updated/deleted order from these canonical arrays.
@@ -2,7 +2,7 @@
2
2
  name: ct-lead
3
3
  description: "Phase Lead orchestration playbook for spawning and supervising a parallel worker swarm in one wave. Use when spawned by ct-orchestrator with role=orchestrator to fan out N leaf workers in one `cleo orchestrate fanout` call, read worker completion messages on AgentMBX plus pipeline_manifest, await rollupWaveStatus convergence, and return ONE rolled-up contract string to the parent Orchestrator. Triggers: 'phase lead', 'wave lead', 'supervise wave', 'fan out workers', 'aggregate worker results', 'rollup wave', any task with role=orchestrator that is itself a child of another orchestrator. Implements ADR-070 hierarchical orchestration."
4
4
  metadata:
5
- version: 1.10.0
5
+ version: 1.11.0
6
6
  tier: core
7
7
  install: harness
8
8
  covers:
@@ -66,6 +66,8 @@ Scope status with `cleo orchestrate status <epicId>` (or `--epic <epicId>`);
66
66
  omit the epic for overall project status. File each finding through the runner
67
67
  with `cleo add "Finding title" --type task --parent <epicId> --acceptance "AC1|AC2"`.
68
68
  Only task creation is allowed, with a required parent and acceptance criteria;
69
+ the parent must be your epic or a task inside its subtree (`--parent none` and
70
+ any other parent are refused before the command runs).
69
71
  `--description` is optional. Task updates, other task types, JSON input and
70
72
  validation bypasses remain unavailable.
71
73
 
@@ -2,7 +2,7 @@
2
2
  name: ct-orchestrator
3
3
  description: "Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. Use when the user asks to \"orchestrate\", \"orchestrator mode\", \"run as orchestrator\", \"delegate to subagents\", \"coordinate agents\", \"spawn subagents\", \"multi-agent workflow\", \"context-protected workflow\", \"agent farm\", \"HITL orchestration\", \"pipeline management\", or needs to manage complex workflows by delegating work to subagents while protecting the main context window. Enforces ORC-001 through ORC-009 constraints. Provider-neutral — works with any AI agent runtime."
4
4
  metadata:
5
- version: 4.19.0
5
+ version: 4.20.0
6
6
  tier: core
7
7
  install: harness
8
8
  covers:
@@ -538,7 +538,7 @@ When operating without continuous HITL oversight, additional constraints apply:
538
538
  | `cleo orchestrate ready T1575` | Parallel-safe tasks in current wave |
539
539
  | `cleo orchestrate spawn T1586 --json` | Generate resolved spawn prompt |
540
540
  | `cleo orchestrate next T1575` | Suggest next task |
541
- | `cleo orchestrate status T1575` | Epic status plus durable worker records (`workers`); omit the ID for overall project status, or use `--epic T1575` |
541
+ | `cleo orchestrate status T1575` | Epic status plus durable worker records (`workers`); omit the ID for overall project status, or use `--epic T1575` (a positional and a different `--epic` is refused) |
542
542
  | `cleo saga rollup <sagaId>` | Cross-Epic status aggregation when orchestrating a multi-Epic Saga (ADR-073) |
543
543
  | `cleo saga members <sagaId>` | Member Epics of a Saga (parent_id containment — NOT `task_relations.groups`) |
544
544
  | `cleo find "query"` | Search tasks |
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: ct-task-executor
3
3
  description: General implementation task execution for completing assigned CLEO tasks by following instructions and producing concrete deliverables. Handles coding, configuration, documentation work with quality verification against acceptance criteria and progress reporting. Use when executing implementation tasks, completing assigned work, or producing task deliverables. Triggers on implementation tasks, general execution needs, or task completion work.
4
- version: 2.12.0
4
+ version: 2.13.0
5
5
  protocol: implementation
6
6
  adrRefs:
7
7
  - ADR-070
@@ -17,7 +17,7 @@ compatibility:
17
17
  - gemini-cli
18
18
  license: MIT
19
19
  metadata:
20
- version: 2.12.0
20
+ version: 2.13.0
21
21
  tier: core
22
22
  install: harness
23
23
  covers:
@@ -142,7 +142,9 @@ A database or service started for a test run must not outlive it. A `docker run`
142
142
  results remain successful. Resolve the reported cause before retrying. This
143
143
  is the only command that executes the typed gates; evidence writes, `cleo done` and
144
144
  `cleo complete` read the cached passes and execute nothing (pass `--run-typed` to opt
145
- in). `--run --req REQ-A,REQ-B` runs only those gates and leaves the other gates'
145
+ in; a linked gate the machine-wide ledger refused to start fails that write with
146
+ `E_GATE_ADMISSION_REFUSED`, exit 28, and records nothing: retry when the machine has
147
+ headroom, or use `ci:<pr>`). `--run --req REQ-A,REQ-B` runs only those gates and leaves the other gates'
146
148
  cached passes as they are. A typed gate whose command is wrong (an
147
149
  absolute path into a removed worktree, say) is fixed in place with
148
150
  `cleo req replace <id> <REQ-ID> --gate '<json>'`. Prefer a repo-relative command and
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "name": "ct-cleo",
230
- "version": "2.26.0",
230
+ "version": "2.28.0",
231
231
  "description": "CLEO task management protocol - session, task, and workflow guidance. Use when managing tasks, sessions, or multi-agent workflows with the CLEO CLI protocol.",
232
232
  "path": "skills/ct-cleo",
233
233
  "tier": 0,
@@ -886,7 +886,7 @@
886
886
  },
887
887
  {
888
888
  "name": "ct-lead",
889
- "version": "1.10.0",
889
+ "version": "1.11.0",
890
890
  "description": "Phase Lead orchestration playbook for spawning and supervising a parallel worker swarm in one wave. Use when spawned by ct-orchestrator with role=orchestrator to fan out N leaf workers in one `cleo orchestrate fanout` call, read worker completion messages on AgentMBX plus pipeline_manifest, await rollupWaveStatus convergence, and return ONE rolled-up contract string to the parent Orchestrator. Triggers: 'phase lead', 'wave lead', 'supervise wave', 'fan out workers', 'aggregate worker results', 'rollup wave', any task with role=orchestrator that is itself a child of another orchestrator. Implements ADR-070 hierarchical orchestration.",
891
891
  "path": "skills/ct-lead",
892
892
  "tier": 0,
@@ -922,7 +922,7 @@
922
922
  },
923
923
  {
924
924
  "name": "ct-orchestrator",
925
- "version": "4.19.0",
925
+ "version": "4.20.0",
926
926
  "description": "Pipeline-aware orchestration skill for managing complex workflows through subagent delegation. Use when the user asks to \\\"orchestrate\\\", \\\"orchestrator mode\\\", \\\"run as orchestrator\\\", \\\"delegate to subagents\\\", \\\"coordinate agents\\\", \\\"spawn subagents\\\", \\\"multi-agent workflow\\\", \\\"context-protected workflow\\\", \\\"agent farm\\\", \\\"HITL orchestration\\\", \\\"pipeline management\\\", or needs to manage complex workflows by delegating work to subagents while protecting the main context window. Enforces ORC-001 through ORC-009 constraints. Provider-neutral — works with any AI agent runtime.",
927
927
  "path": "skills/ct-orchestrator",
928
928
  "tier": 0,
@@ -1410,7 +1410,7 @@
1410
1410
  },
1411
1411
  {
1412
1412
  "name": "ct-task-executor",
1413
- "version": "2.12.0",
1413
+ "version": "2.13.0",
1414
1414
  "description": "General implementation task execution for completing assigned CLEO tasks by following instructions and producing concrete deliverables. Handles coding, configuration, documentation work with quality verification against acceptance criteria and progress reporting. Use when executing implementation tasks, completing assigned work, or producing task deliverables. Triggers on implementation tasks, general execution needs, or task completion work.",
1415
1415
  "path": "skills/ct-task-executor",
1416
1416
  "tier": 0,