@cleocode/skills 2026.11.9 → 2026.11.10-rc.ci.727
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,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.
|
|
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.
|
|
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-
|
|
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.
|
|
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
|
|
154
|
-
# Run
|
|
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. |
|
|
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
|
|
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
|
-
|
|
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
|
|
package/skills/manifest.json
CHANGED
|
@@ -643,7 +643,7 @@
|
|
|
643
643
|
},
|
|
644
644
|
{
|
|
645
645
|
"name": "ct-documentor",
|
|
646
|
-
"version": "3.
|
|
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.
|
|
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,
|