@cleocode/skills 2026.5.108 → 2026.5.109
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. Coordinates ct-docs-lookup, ct-docs-write, ct-docs-review, 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.2.0
|
|
5
5
|
tier: 3
|
|
6
6
|
core: false
|
|
7
7
|
category: specialist
|
|
@@ -96,6 +96,36 @@ cleo docs add T1234 docs/drafts/feature-x.md \
|
|
|
96
96
|
- The owner ID (`T1234` above) auto-classifies the attachment by prefix:
|
|
97
97
|
`T###` → task, `ses_*` → session, `O-*` → observation.
|
|
98
98
|
|
|
99
|
+
### Strict flag validation (T10359 · closes T10238)
|
|
100
|
+
|
|
101
|
+
`cleo docs add` rejects unknown flags with `E_UNKNOWN_FLAG` + Levenshtein
|
|
102
|
+
"did you mean" suggestions and exits with code `6` (`VALIDATION_ERROR`).
|
|
103
|
+
This closes the silent-absorption footgun where citty's underlying
|
|
104
|
+
`parseArgs({ strict: false })` accepted typo'd flags (e.g. `--titel`,
|
|
105
|
+
`--title`) as positional values.
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
# Typo → E_UNKNOWN_FLAG with suggestion
|
|
109
|
+
$ cleo docs add T123 file.md --titel "X"
|
|
110
|
+
{
|
|
111
|
+
"success": false,
|
|
112
|
+
"error": {
|
|
113
|
+
"code": 6,
|
|
114
|
+
"codeName": "E_UNKNOWN_FLAG",
|
|
115
|
+
"message": "E_UNKNOWN_FLAG: unknown flag '--titel' for 'docs add'. Did you mean: --type, --slug?",
|
|
116
|
+
"fix": "Try one of: --type, --slug. Run `cleo docs add --help` for the full flag list.",
|
|
117
|
+
"alternatives": [{ "action": "--type", "command": "--type" }, { "action": "--slug", "command": "--slug" }],
|
|
118
|
+
"details": { "flag": "--titel", "knownFlags": [...] }
|
|
119
|
+
},
|
|
120
|
+
"meta": { ... }
|
|
121
|
+
}
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
The accepted positional + named surface is enumerated in
|
|
125
|
+
`cleo docs add --help` — agents MUST consult `--help` rather than guessing
|
|
126
|
+
flag names. Use the `--flag=value` form (`--type=spec`) or
|
|
127
|
+
`--flag value` (`--type spec`) — both are recognised.
|
|
128
|
+
|
|
99
129
|
### Publish to a git-tracked path (when the doc must live on disk)
|
|
100
130
|
|
|
101
131
|
```bash
|