@cleocode/skills 2026.11.9 → 2026.11.10

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.9",
3
+ "version": "2026.11.10",
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-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.39.0
4
+ version: 3.40.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.39.0
19
+ version: 3.40.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-13
25
+ lastReviewed: 2026-11-14
26
26
  stability: stable
27
27
  ---
28
28
 
@@ -511,7 +511,7 @@ Saga T10176's two known raw-write workarounds are normalised:
511
511
 
512
512
  | Original file | SSoT slug | Type | Notes |
513
513
  |---|---|---|---|
514
- | `docs/research/t10179-executor-probe-result.md` | `t10179-executor-probe` | research | in-sync via earlier T9791 import — verified by SHA. |
514
+ | `docs/research/t10179-executor-probe-result.md` (retired from docs/ by T14108; store record only) | `t10179-executor-probe` | research | in-sync via earlier T9791 import — verified by SHA. |
515
515
  | `.changeset/t10179-executor-probe.md` (consumed v5.108) | `t10179-changeset-archive` | note | bytes preserved verbatim from git `cc48ca10e`; archived because the pnpm/changesets `"@cleocode/cleo": patch` frontmatter does not satisfy the `changeset` DocKind schema. |
516
516
  | `.changeset/t10203-napi-step-exports.md` (consumed v5.108) | `t10203-napi-step-exports` | changeset | in-sync via the `cleo changeset add` dual-write at PR-time. |
517
517
 
@@ -7,7 +7,7 @@ adrRefs:
7
7
  - ADR-063
8
8
  - ADR-065
9
9
  metadata:
10
- version: 3.9.0
10
+ version: 3.11.0
11
11
  tier: on-demand
12
12
  install: harness
13
13
  covers:
@@ -150,8 +150,9 @@ node scripts/release-mac-smoke.mjs
150
150
  git tag -a v2026.6.0 -m "Release v2026.6.0"
151
151
  git push origin v2026.6.0
152
152
 
153
- # 6. Reconcile — runs automatically inside release-publish.yml.
154
- # Run manually only if backfilling a historical release.
153
+ # 6. Reconcile. Every full merge sweep reconciles the newest stable tag on
154
+ # origin/main once its GitHub Release exists. Run it by hand for a
155
+ # prerelease, an older stable tag, a failed sweep attempt, or right away.
155
156
  cleo release reconcile v2026.6.0
156
157
  ```
157
158
 
@@ -185,7 +186,7 @@ Exit codes (canonical):
185
186
  | Hand-editing `CHANGELOG.md` for the new version | Drift between the changeset directory and the changelog. | `cleo release plan` always auto-writes the section (T10105). Use `cleo changeset add` to author entries. |
186
187
  | Pasting one verb into another's workflow file | Multi-step orchestration belongs in `ship-e2e-smoke`. | Use `cleo release ship-e2e-smoke … --execute` for end-to-end validation. |
187
188
  | Running the pipeline on a dirty worktree | Release commit scoops up unrelated changes. | The clean-tree gate refuses to advance. |
188
- | Skipping `cleo release reconcile` after a successful tag push | 11 provenance tables stay empty; canon drift. | `release-publish.yml` runs reconcile automatically — verify it ran via `cleo release show <ver>`. |
189
+ | Skipping `cleo release reconcile` after a successful tag push | 11 provenance tables stay empty; canon drift. | The merge sweep reconciles only the newest stable tag (after its GitHub Release exists); reconcile prereleases, older tags and failed attempts by hand. Verify with `cleo release show <ver>`. |
189
190
 
190
191
  ## Critical Rules Summary
191
192
 
@@ -194,22 +195,14 @@ Exit codes (canonical):
194
195
  3. CalVer (`YYYY.MM.patch`) is the only valid version scheme.
195
196
  4. `cleo release plan` always writes the CHANGELOG section unless `--no-changelog`.
196
197
  5. The tag is created explicitly after the release PR merges; `auto-tag-on-release-merge.yml` is retired (T10434, ADR-087).
197
- 6. Provenance reconcile is invoked by `release-publish.yml`, not manually (unless backfilling).
198
+ 6. Provenance reconcile: every full merge sweep reconciles the newest stable tag merged into `origin/main` once its GitHub Release exists (`reconcileLatestRelease`). Run `cleo release reconcile <ver>` by hand for a prerelease, an older stable tag, after a failed sweep attempt, or to record it now. The shipped `release-publish.yml` consumer template also runs it.
198
199
  7. Per-task evidence gates use `cleo verify --gate --evidence` per ADR-051 — not the deleted batch verb.
199
200
  8. Use `cleo release ship-e2e-smoke` to validate the full pipeline before a real ship.
200
201
  9. A stable release reaches `latest` only through release.yml's release candidate gate (T13181). If the gate fails, the release is not shipped to users: re-run the failed Publish job or fix forward; never move `latest` by hand (there is no npm token).
201
202
 
202
203
  ## CI Job Inventory
203
204
 
204
- The authoritative reference for every job that runs in this repo's GitHub Actions pipeline — including which jobs run on PR-to-main vs push-to-main vs tag-push, branch-protection cross-check, and documented divergences — lives at:
205
-
206
- - [docs/reference/job-inventory.md](../../../../docs/reference/job-inventory.md) (T10106 · Saga T10099)
207
-
208
- Consult the inventory whenever:
209
-
210
- 1. A release verb fails CI and you need to know which gate is blocking.
211
- 2. Branch-protection required status checks need to be reconciled against actual workflow jobs.
212
- 3. A new workflow is added or an existing trigger changes — regenerate the matrix per the "How this document is maintained" section at the bottom of the inventory.
205
+ There is no maintained job inventory doc: the hand-kept `job-inventory.md` went stale and was retired in the T14108 docs census. Read the jobs and their triggers from `.github/workflows/ci.yml` and the release workflows themselves, and branch protection from `gh api repos/:owner/:repo/branches/main/protection` (see `docs/guide/branch-protection-setup.md`). The workflow classes and trigger policy are in `docs/spec/consumer-workflow-hook-contract.md`.
213
206
 
214
207
  ## See also / References
215
208
 
@@ -643,7 +643,7 @@
643
643
  },
644
644
  {
645
645
  "name": "ct-documentor",
646
- "version": "3.39.0",
646
+ "version": "3.40.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,
@@ -1088,7 +1088,7 @@
1088
1088
  },
1089
1089
  {
1090
1090
  "name": "ct-release-orchestrator",
1091
- "version": "3.9.0",
1091
+ "version": "3.11.0",
1092
1092
  "description": "Orchestrates CLEO releases. Default (T14102): cleo release cut {version} tags the newest main commit with green CI, and release.yml writes the CHANGELOG from changesets, publishes, and opens an auto-merging CHANGELOG + version PR; cleo release reconcile records provenance. The SPEC-T9345 4-verb pipeline (cleo release plan, cleo release open, PR + tag) stays one release as a fallback (T14114). The deprecated cleo release ship monolith was deleted in T10103 — do not invoke it. Use ship-e2e-smoke to validate the full pipeline end-to-end (dry-run by default). The full verb-to-state map is in docs/reference/verb-matrix.md. Use when shipping a new version, validating the release pipeline end-to-end, or promoting a completed epic to released status.",
1093
1093
  "path": "skills/ct-release-orchestrator",
1094
1094
  "tier": 1,