@cleocode/skills 2026.10.7 → 2026.10.8

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.10.7",
3
+ "version": "2026.10.8",
4
4
  "description": "CLEO skill definitions - bundled with CLEO monorepo",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
@@ -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.7.9
4
+ version: 2.8.2
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.7.9
20
+ version: 2.8.2
21
21
  tier: core
22
22
  install: harness
23
23
  covers:
@@ -25,10 +25,11 @@ metadata:
25
25
  - packages/cleo/src/cli/commands/complete.ts
26
26
  - packages/cleo/src/cli/commands/start.ts
27
27
  - packages/cleo/src/cli/commands/claim.ts
28
+ - packages/core/src/doctor/container-reaper.ts
28
29
  - packages/core/src/validation/protocols/cant/implementation.cant
29
30
  - packages/core/src/validation/protocols/protocols-markdown/implementation.md
30
31
  loomStage: implementation
31
- lastReviewed: 2026-10-03
32
+ lastReviewed: 2026-10-11
32
33
  stability: stable
33
34
  ---
34
35
 
@@ -124,6 +125,14 @@ Context injection for implementation tasks spawned via cleo-subagent. Provides d
124
125
  3. **Document as you go** - Track progress for output file
125
126
  4. **Handle blockers** - Report if unable to proceed
126
127
 
128
+ ### Throwaway Containers
129
+
130
+ A database or service started for a test run must not outlive it. A `docker run` without `--rm` leaves an anonymous volume behind on every run; on 2026-10-10 that came to 475 volumes and 52 GB.
131
+
132
+ - One-shot: `docker run --rm --label cleo.task=T#### --label cleo.ttl=4h postgres:17 …`
133
+ - Reused across runs: a named volume (`-v t####-pgdata:/var/lib/postgresql/data`) plus the same two labels, and stop the container when the task ends.
134
+ - `cleo doctor system` reports long-running database containers and dangling volumes. `cleo doctor system --repair` lists, as a dry run, the STOPPED `cleo.ttl` containers that stopped longer ago than their ttl (or were created that long ago and never started), and the anonymous dangling volumes (including ones left by non-CLEO containers). `--repair --apply` removes only those. It never removes a running container: one running past its ttl since its last start is reported for you to stop. It never touches an unlabelled container or a named volume. Removing them is the owner's call, so relay the list through your orchestrator first.
135
+
127
136
  ### Post-Execution
128
137
 
129
138
  1. **Verify against criteria** - Check each acceptance criterion. `cleo verify <id> --run`
@@ -200,7 +209,7 @@ Record it with `cleo docs add {{TASK_ID}} --content - --type note --slug {{TOPIC
200
209
 
201
210
  ## Acceptance Criteria Verification
202
211
 
203
- Record each criterion's changed artifacts and actual verification results. A merged PR with green CI provides provenance; it cannot automatically satisfy implementation, testing and review. Use `pr:<number>;files:<changed-path>` for implementation (`pr:<component>@<integration>` when your PR merged into an integration branch) and actual result atoms for test/review gates, with explicit `satisfies:T1234#AC1` links for canonical criteria. The PR must relate to the task; documentation-only changes cannot prove a code fix. Research and documentation tasks may use appropriately scoped documentary evidence. Fetch the merge commit before claiming its artifact bytes were inspected. Criterion edits require fresh evidence. A completed child does not establish that its parent's independent criteria were met.
212
+ Record each criterion's changed artifacts and actual verification results. A merged PR with green CI provides provenance; it cannot automatically satisfy implementation, testing and review. Use `pr:<number>;files:<changed-path>` for implementation (`pr:<component>@<integration>` when your PR merged into an integration branch) and actual result atoms for test/review gates, with explicit `satisfies:T1234#AC1` links for canonical criteria. The PR must relate to the task; documentation-only changes cannot prove a code fix. Research and documentation tasks may use appropriately scoped documentary evidence. Fetch the merge commit before claiming its artifact bytes were inspected. Criterion edits require fresh evidence. A completed child does not establish that its parent's independent criteria were met. `cleo verify <id> --all` sets every required gate at once and still requires `--evidence`; bare `--all` is rejected with `E_EVIDENCE_MISSING`. A failing `tool:<name>` reason names the resolved command and its source, so check that command before retrying.
204
213
 
205
214
 
206
215
  | Criterion | Status | Notes |
@@ -1490,7 +1490,7 @@
1490
1490
  },
1491
1491
  {
1492
1492
  "name": "ct-task-executor",
1493
- "version": "2.7.9",
1493
+ "version": "2.8.2",
1494
1494
  "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.",
1495
1495
  "path": "skills/ct-task-executor",
1496
1496
  "tier": 0,