@cleocode/skills 2026.11.6 → 2026.11.7-rc.ci.724

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.6",
3
+ "version": "2026.11.7-rc.ci.724",
4
4
  "description": "CLEO skill definitions - bundled with CLEO monorepo",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
@@ -2,7 +2,7 @@
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.28.0
5
+ version: 2.31.0
6
6
  tier: core
7
7
  install: harness
8
8
  covers:
@@ -117,7 +117,7 @@ Compact SDK list/find records also carry `_withheld`: omission names and origina
117
117
 
118
118
  List/find expose `data.population` with matched and returned counts, truncation, pagination, and archive eligibility. Count output equals emitted rows; use `--all` or `--limit 0` to enumerate all matches, and `--include-archive` to include archives under the same filters. Scalar/ID/table/summary modes preserve population facts on stderr. Do not treat a page as complete.
119
119
 
120
- Use `cleo backup inspect <snapshot> --record-id <id>` for read-only historical evidence; scoped absence or unknown provenance is not recovery authority.
120
+ Use `cleo backup inspect <snapshot> --record-id <id>` for read-only historical evidence; scoped absence or unknown provenance is not recovery authority. `E_DB_CORRUPT` names `cleo doctor repair-store`: preserve its quarantine receipt and inspect unreadable ranges and unmerged rows before claiming full recovery.
121
121
 
122
122
  Code-graph answers (`cleo nexus impact`, `context`, `full-context`, `why`, `search-code`, `task-symbols`, `clusters`, `flows`) carry `meta._nexus.freshness`: stale file count and sample, whether the queried symbol's own file is stale, and the refresh command with an estimated cost. A query refreshes up to 25 stale files inline within a 60 s budget (`nexus.autoRefresh.maxFiles`/`budgetMs`/`enabled`) and discloses it in `freshness.autoRefresh`; beyond that it answers from the stale index with `W_NEXUS_INDEX_STALE`. `unknown` freshness is never fresh. `cleo nexus analyze` re-parses only changed files, re-resolves every file, and reports `mode`, `reason` and per-phase cost; it falls back to a full parse (and says why) when there is no parse cache, the extractor build changed, or over 30% of files changed. `--full` forces a rebuild.
123
123
 
@@ -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, 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.
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. Hierarchy profiles supply unset caps: no profile or `llm-agent-first` is unlimited (0/0), `human-cognitive` is 7 siblings / 3 active; explicit caps, including 0, win. Older scaffolded zero caps can be removed with `cleo upgrade --migrate-hierarchy-defaults` (preview with `--dry-run`); this backs up config and also removes intentional unlimited overrides.
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.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: ct-dev-workflow
3
3
  description: Development workflow orchestration for task-driven development with atomic commits, conventional commit messages, and systematic release processes. Enforces task traceability, branch discipline, smart test scope selection, and GitHub Actions integration. Use when committing code, creating releases, managing branches, or following contribution protocols. Triggers on commit operations, release preparation, or workflow compliance needs.
4
- version: 3.12.0
4
+ version: 3.13.0
5
5
  protocol: contribution
6
6
  dependencies: []
7
7
  sharedResources:
@@ -14,7 +14,7 @@ compatibility:
14
14
  - gemini-cli
15
15
  license: MIT
16
16
  metadata:
17
- version: 3.12.0
17
+ version: 3.13.0
18
18
  tier: core
19
19
  install: harness
20
20
  covers:
@@ -28,7 +28,7 @@ metadata:
28
28
  - packages/contracts/src/git-hooks.ts
29
29
  - packages/core/src/tasks/merge-train.ts
30
30
  - packages/cleo/src/cli/commands/merge.ts
31
- lastReviewed: 2026-11-10
31
+ lastReviewed: 2026-11-13
32
32
  stability: stable
33
33
  ---
34
34
 
@@ -114,6 +114,18 @@ naming a `"projectId"`, and `.cleo/config.json` or a byte-identical copy. It lis
114
114
  paths and `git reset -q -- <paths>`; `cleo doctor` runs the same rule (`staged_cleo_state`).
115
115
  This repository's `.githooks/pre-commit` calls the template rather than copying it.
116
116
 
117
+ It also refuses any added or modified `.cleo/` path the shipped `.cleo/.gitignore` EXPLICIT
118
+ DENY rules name (backups, quarantine, logs, caches; T14549). The rules are embedded in the
119
+ hook as git pathspecs (`runtimePathspecs()`, test-enforced), so a user-edited
120
+ `.cleo/.gitignore` cannot disable it, and git matches them, so no quote, space or newline in
121
+ a name slips past. It prints an exact untrack command and `cleo doctor --fix`; every staged
122
+ change but a deletion (the repair) is checked, including renames and type changes. A FOREIGN pre-commit (no CLEO marker) is chained, not
123
+ skipped: it moves to `pre-commit.cleo-chained` and runs FIRST, so every check sees the
124
+ index it leaves; its failure stops the commit. A customized CLEO copy is still preserved.
125
+ `cleo doctor` reports git-tracked `.cleo` runtime files (`tracked_cleo_runtime`: error for
126
+ SQLite store files and sidecars, warning for the rest; `--fix` runs `git rm --cached` only and prints
127
+ the commit) and `cleo init`, `cleo upgrade` and `cleo session start` warn about them.
128
+
117
129
  `cleo init` and `cleo upgrade` no longer seed the CleoOS hub (Pi extensions, CANT
118
130
  workflows, justfile) into the global CLEO home (T13994, ADR-098); only the deprecated
119
131
  `cleo admin scaffold-hub` still does.
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: ct-documentor
3
3
  description: Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Carries the CLEO writing and review guides as references and coordinates ct-spec-writer and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.
4
- version: 3.38.0
4
+ version: 3.39.0
5
5
  protocol: null
6
6
  dependencies:
7
7
  - ct-spec-writer
@@ -16,13 +16,13 @@ compatibility:
16
16
  - gemini-cli
17
17
  license: MIT
18
18
  metadata:
19
- version: 3.38.0
19
+ version: 3.39.0
20
20
  tier: core
21
21
  install: harness
22
22
  covers:
23
23
  - packages/cleo/src/cli/commands/docs.ts
24
24
  - packages/contracts/src/docs-taxonomy.ts
25
- lastReviewed: 2026-11-02
25
+ lastReviewed: 2026-11-13
26
26
  stability: stable
27
27
  ---
28
28
 
@@ -83,8 +83,11 @@ paths) or stale (T14117) — and with `--apply` repairs them after creating a
83
83
  backup automatically. The ledger syncs across devices, so a row is pruned
84
84
  only when its mirror is provably gone (absent from HEAD and the default
85
85
  branch, or in a removed worktree of this device) and its blob stays
86
- referenced elsewhere; absolute paths and other devices' paths are only
87
- reported. Each pruned row is first appended to
86
+ referenced elsewhere, or when a newer row of the same owner publishes the
87
+ same path in sync and the doc's canonical head (conduit head, else registry
88
+ row; unresolvable keeps the row) is already published or never moved (a
89
+ superseded row, T14504). A blob held only by rows pruned in the same run never protects
90
+ them. Absolute paths and other devices' paths are only reported. Each pruned row is first appended to
88
91
  `.cleo/audit/docs-publications-prune.jsonl`, and stale mirrors are only
89
92
  reported (republish, or ingest the edit with `cleo docs update`). Use it for store
90
93
  hygiene checks; it never edits doc content. `--apply` runs every repair class
@@ -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.20.0
5
+ version: 4.21.0
6
6
  tier: core
7
7
  install: harness
8
8
  covers:
@@ -10,7 +10,7 @@ metadata:
10
10
  - packages/core/src/orchestration/spawn-prompt.ts
11
11
  - packages/core/src/orchestrate/orca-routing.ts
12
12
  - packages/core/src/orchestrate/spawn-ops.ts
13
- lastReviewed: 2026-11-12
13
+ lastReviewed: 2026-11-13
14
14
  stability: stable
15
15
  ---
16
16
 
@@ -595,7 +595,11 @@ task because its spawner exited. Removal also requires no open worker record,
595
595
  live session lease, process cwd or open file; a failed probe keeps the worktree.
596
596
  The shared task-lock probe remains strict for legacy callers.
597
597
  Ignored build output needs `--include-build-output` on a
598
- merged branch; nothing is force-archived. Legacy `cleo orchestrate prune` does
598
+ merged branch; nothing is force-archived. CLEO's own pnpm provisioning (the
599
+ worktree's `.pnpm-store/` and an unchanged store-dir `.npmrc`) never blocks the
600
+ proof (T14552). The spawn pre-check composes the atomicity verdict only, and the
601
+ tier-1/2 prompt's dashboard line counts finished worktrees as unproven instead
602
+ of running the proof per worktree; `cleo orchestrate dashboard` still proves. Legacy `cleo orchestrate prune` does
599
603
  not provide these retention or machine-wide controls.
600
604
 
601
605
  Never re-run a worker's full suite to "double-check": a worker's
@@ -227,7 +227,7 @@
227
227
  },
228
228
  {
229
229
  "name": "ct-cleo",
230
- "version": "2.28.0",
230
+ "version": "2.31.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,
@@ -567,7 +567,7 @@
567
567
  },
568
568
  {
569
569
  "name": "ct-dev-workflow",
570
- "version": "3.12.0",
570
+ "version": "3.13.0",
571
571
  "description": "Development workflow orchestration for task-driven development with atomic commits, conventional commit messages, and systematic release processes. Enforces task traceability, branch discipline, smart test scope selection, and GitHub Actions integration. Use when committing code, creating releases, managing branches, or following contribution protocols. Triggers on commit operations, release preparation, or workflow compliance needs.",
572
572
  "path": "skills/ct-dev-workflow",
573
573
  "tier": 0,
@@ -643,7 +643,7 @@
643
643
  },
644
644
  {
645
645
  "name": "ct-documentor",
646
- "version": "3.38.0",
646
+ "version": "3.39.0",
647
647
  "description": "Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Carries the CLEO writing and review guides as references and coordinates ct-spec-writer and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.",
648
648
  "path": "skills/ct-documentor",
649
649
  "tier": 0,
@@ -922,7 +922,7 @@
922
922
  },
923
923
  {
924
924
  "name": "ct-orchestrator",
925
- "version": "4.20.0",
925
+ "version": "4.21.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,