@cleocode/skills 2026.11.13 → 2026.11.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cleocode/skills",
3
- "version": "2026.11.13",
3
+ "version": "2026.11.14",
4
4
  "description": "CLEO skill definitions - bundled with CLEO monorepo",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
@@ -114,8 +114,10 @@ Reference: @skills/_shared/task-system-integration.md
114
114
  ```
115
115
 
116
116
  Do not start another session or re-claim a preallocated task. Export the allocated
117
- `CLEO_SESSION_ID` and `CLEO_AGENT_ID` on every command. A missing, expired or foreign
118
- binding returns blocked to the coordinator for handoff; never replace it yourself.
117
+ `CLEO_SESSION_ID` and `CLEO_AGENT_ID` on every command. An expired claim lease on your own
118
+ task is not a blocker: renew it with `cleo claim {{TASK_ID}} --renew` and carry on. A missing
119
+ session, or a claim another session now holds (the renewal is refused with `E_TASK_CLAIMED`),
120
+ returns blocked to the coordinator for handoff; never replace it yourself.
119
121
 
120
122
  ---
121
123
 
@@ -225,5 +227,5 @@ If work cannot proceed:
225
227
  | Returning full content | Bloats orchestrator context | Return only summary message |
226
228
  | Manual JSONL append | No validation, race conditions | Use `cleo research add` |
227
229
  | Missing manifest entry | Orchestrator can't find findings | Always create manifest entry |
228
- | Starting or re-claiming a preallocated task | Replaces the worker binding or steals a claim | Preserve the allocated session and claim. A missing, expired or foreign binding returns blocked to the coordinator for handoff. |
230
+ | Starting or re-claiming a preallocated task | Replaces the worker binding or steals a claim | Preserve the allocated session and claim. Renew your own expired lease with `cleo claim {{TASK_ID}} --renew`; a missing session or a claim another session holds returns blocked to the coordinator for handoff. |
229
231
  | Incomplete checklist | Protocol violation | Verify all items before return |
@@ -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.24.0
5
+ version: 4.25.0
6
6
  tier: core
7
7
  install: harness
8
8
  covers:
@@ -298,8 +298,15 @@ since harness shells keep neither cwd nor env between calls (the git shim reads
298
298
  same identity line in its Session Linkage block: both `CLEO_SESSION_ID` and `CLEO_AGENT_ID`,
299
299
  so teammates sharing one harness session keep separate claims and focus (T14269).
300
300
  The prompt names the allocated **Worker Session** and the separate **Coordinator Session**;
301
- workers preserve the preclaim and never start a session or re-claim. Expired or foreign
302
- claims return to the coordinator for handoff. Execution backends receive `workerSession`
301
+ workers preserve the preclaim and never start a session or re-claim. A worker's lease
302
+ renews with every CLEO command it runs (reads included) and with the heavy-command hook's beat
303
+ before each shell command, so it stays live while the worker is (T14546). The hook binds a
304
+ worker by its process (a `CLEO_SESSION_ID` in the harness environment, else the worktree
305
+ lock of the directory it runs in), never by command text, and renews only while that
306
+ session holds the claim, so launch workers in their task worktree. A worker whose
307
+ lease still lapsed renews it itself with `cleo claim <id> --renew` and carries on; no resume
308
+ spawn is needed. Only a refused renewal (`E_TASK_CLAIMED`: another session took the task)
309
+ or an ended session returns to the coordinator for handoff. Execution backends receive `workerSession`
303
310
  separately from `coordinatorSessionId`; a CLI's own environment does not prove Orca's
304
311
  launched worker inherited it.
305
312
  `workerSession.role` comes from dispatch and controls the shell binding (worker by
@@ -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.14.0
4
+ version: 2.15.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.14.0
20
+ version: 2.15.0
21
21
  tier: core
22
22
  install: harness
23
23
  covers:
@@ -351,11 +351,20 @@ cleo complete T1234 --if-match <updatedAt>
351
351
  task. If another session holds it, the start is refused with `E_TASK_CLAIMED`
352
352
  and nothing is written; `error.details` names the `holder` (session, agent,
353
353
  `leaseExpiresAt`), whether the lease has `expired`, and the `override` flag.
354
- Your mutations renew your leases; `cleo stop`, `cleo complete` and ending your
355
- session release them. The human `assignee` is a separate field.
354
+ Your activity renews your leases (T14546): every mutation, a read once half the
355
+ lease is gone, and, where the heavy-command hook is installed, the shell commands
356
+ you run. The hook knows you by your process, never by your command text: a
357
+ `CLEO_SESSION_ID` in your harness environment, else the task worktree you run in
358
+ (its spawn lock), and only while you hold the claim. `cleo stop`, `cleo complete` and
359
+ ending your session release them. The human `assignee` is a separate field.
360
+
361
+ An expired lease on your own task is not a reason to stop. Renew it and carry
362
+ on; while no other session has claimed the task, the renewal revives it. If the
363
+ renewal is refused with `E_TASK_CLAIMED`, another session holds the task now:
364
+ stop and report that holder to your orchestrator.
356
365
 
357
366
  ```bash
358
- cleo claim T1234 --renew # extend your lease during a long step
367
+ cleo claim T1234 --renew # extend your lease, or revive your own expired one
359
368
  cleo start T1234 --take-over # holder's lease EXPIRED (audited)
360
369
  cleo start T1234 --force-claim # holder is LIVE: only with a clear reason (audited)
361
370
  ```
@@ -922,7 +922,7 @@
922
922
  },
923
923
  {
924
924
  "name": "ct-orchestrator",
925
- "version": "4.24.0",
925
+ "version": "4.25.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.14.0",
1413
+ "version": "2.15.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,