skill-family-doc-render 0.4.4 → 0.4.5
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/CHANGELOG.md +6 -0
- package/README.md +17 -17
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -16,22 +16,22 @@ publication APIs. A failure before commit removes staging and leaves the existin
|
|
|
16
16
|
untouched. After commit, or when publication is indeterminate, staging or displaced data may
|
|
17
17
|
remain for diagnosis; the renderer does not guess or roll back.
|
|
18
18
|
|
|
19
|
-
> **Version boundary:** this source tree is version `0.4.
|
|
20
|
-
> official npm registry before treating it as installable. Version 0.4.
|
|
19
|
+
> **Version boundary:** this source tree is version `0.4.5`. Verify that exact version in the
|
|
20
|
+
> official npm registry before treating it as installable. Version 0.4.5 preserves the
|
|
21
21
|
> `markdown-v1`, `editorial`, and `--check-project` behavior introduced in 0.4.0 and aligns the
|
|
22
|
-
> renderer, documentation plugin, and public site at 0.4.
|
|
22
|
+
> renderer, documentation plugin, and public site at 0.4.5 for the joint release.
|
|
23
23
|
|
|
24
24
|
## Install
|
|
25
25
|
|
|
26
26
|
After confirming availability, install this release with an exact version:
|
|
27
27
|
|
|
28
28
|
```sh
|
|
29
|
-
npm install --save-exact skill-family-doc-render@0.4.
|
|
29
|
+
npm install --save-exact skill-family-doc-render@0.4.5
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
Requires Node.js `>=22.22.2 <23` (aligned with the skill-family foundation packages).
|
|
33
33
|
|
|
34
|
-
Version 0.4.
|
|
34
|
+
Version 0.4.5 has exact runtime dependencies on `marked@18.0.11`,
|
|
35
35
|
`skill-family-contracts@0.19.3`, and `skill-family-harness-node@0.19.3`. `marked` supplies the
|
|
36
36
|
Markdown lexer; the renderer applies its own restricted-format validation before passing semantic
|
|
37
37
|
content to the template. The workspace profile check separately uses
|
|
@@ -42,28 +42,28 @@ notes.
|
|
|
42
42
|
|
|
43
43
|
## CLI
|
|
44
44
|
|
|
45
|
-
Use the exact 0.4.
|
|
45
|
+
Use the exact 0.4.5 CLI for rendering, checks, coverage maintenance, and the Git index assertion:
|
|
46
46
|
|
|
47
47
|
```sh
|
|
48
48
|
# render all repos with a site field (writes to disk)
|
|
49
|
-
npx skill-family-doc-render@0.4.
|
|
49
|
+
npx skill-family-doc-render@0.4.5
|
|
50
50
|
|
|
51
51
|
# drift check only: compare in-memory render against the on-disk site-baseline.json, write nothing
|
|
52
|
-
npx skill-family-doc-render@0.4.
|
|
52
|
+
npx skill-family-doc-render@0.4.5 --check
|
|
53
53
|
|
|
54
54
|
# render / check a single repo by name
|
|
55
|
-
npx skill-family-doc-render@0.4.
|
|
55
|
+
npx skill-family-doc-render@0.4.5 --repo <name>
|
|
56
56
|
|
|
57
57
|
# assert every rendered file is tracked in the Git index, then render
|
|
58
|
-
npx skill-family-doc-render@0.4.
|
|
58
|
+
npx skill-family-doc-render@0.4.5 --assert-git
|
|
59
59
|
|
|
60
60
|
# run both the drift and Git index tracking checks without writing
|
|
61
|
-
npx skill-family-doc-render@0.4.
|
|
61
|
+
npx skill-family-doc-render@0.4.5 --check --assert-git
|
|
62
62
|
|
|
63
63
|
# inspect or refresh the reviewed product-input snapshot
|
|
64
|
-
npx skill-family-doc-render@0.4.
|
|
65
|
-
npx skill-family-doc-render@0.4.
|
|
66
|
-
npx skill-family-doc-render@0.4.
|
|
64
|
+
npx skill-family-doc-render@0.4.5 --status --repo <name>
|
|
65
|
+
npx skill-family-doc-render@0.4.5 --refresh-coverage --repo <name>
|
|
66
|
+
npx skill-family-doc-render@0.4.5 --check-project --repo <name>
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
The current directory must be the workspace that owns `public-release.json`. From this package's
|
|
@@ -283,7 +283,7 @@ Foundation packages below, it uses exact `marked@18.0.11` for Markdown tokenizat
|
|
|
283
283
|
Apache-2.0
|
|
284
284
|
|
|
285
285
|
<!-- release-skill:capability:safe-first-command -->
|
|
286
|
-
> **Start here:** run `npx skill-family-doc-render@0.4.
|
|
286
|
+
> **Start here:** run `npx skill-family-doc-render@0.4.5 --check-project --repo <name>` after
|
|
287
287
|
> confirming that exact release in the official registry. From a local checkout, use
|
|
288
288
|
> `node bin/skill-family-doc-render.mjs --check-project --repo <name>`. The check is read-only:
|
|
289
289
|
> it renders in memory, compares against the on-disk `site-baseline.json`, writes
|
|
@@ -307,6 +307,6 @@ Apache-2.0
|
|
|
307
307
|
Display help and run a read-only project check:
|
|
308
308
|
|
|
309
309
|
```sh
|
|
310
|
-
npx skill-family-doc-render@0.4.
|
|
311
|
-
npx skill-family-doc-render@0.4.
|
|
310
|
+
npx skill-family-doc-render@0.4.5 --help
|
|
311
|
+
npx skill-family-doc-render@0.4.5 --check-project --repo <name>
|
|
312
312
|
```
|
package/package.json
CHANGED