skill-family-doc-render 0.6.1 → 0.6.2
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 +11 -0
- package/README.md +20 -20
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,16 @@
|
|
|
1
1
|
# 变更日志
|
|
2
2
|
|
|
3
|
+
## 0.6.2 - 2026-10-13
|
|
4
|
+
|
|
5
|
+
### 变更
|
|
6
|
+
|
|
7
|
+
- 按本仓联合发布合同,`skill-family-doc-render` 与 `skill-family-docs`、公开站点对齐为 0.6.2。渲染器 README 里指向当前源版本的安装和 `npx` 示例改为 0.6.2;已发布的 0.4.5,以及「不重新发布 0.6.0」,保持原句。渲染器的公开 API、命令行参数、输入合同、模板和业务实现均未改变,运行依赖仍精确锁定原版本。Foundation 0.22.0 钉扎不变。
|
|
8
|
+
- 本版没有渲染器行为变化。相对 0.6.1 的说明修正是:`skill-family-docs-help` 的源文件与四份 adapter,以及 `packages/skill-family-docs/README.md`、仓库根 `README.md`,把过期能力状态句改为「主流程替换已随 0.6.1 正式发布并分发。」这些正文已在版本对齐前进入当前 HEAD。当时覆盖输入变化后,`site-coverage-lock.json` 已由原 `--refresh-coverage` 入口刷新。
|
|
9
|
+
|
|
10
|
+
### 说明
|
|
11
|
+
|
|
12
|
+
- 本地源包版本为 0.6.2 候选,不代表已经正式发布。安装或使用 `npx` 前,先在官方 npm 确认 `skill-family-doc-render@0.6.2` 可用。已发布的 0.6.1 保留,不覆盖该版本。
|
|
13
|
+
|
|
3
14
|
## 0.6.1 - 2026-10-12
|
|
4
15
|
|
|
5
16
|
### 变更
|
package/README.md
CHANGED
|
@@ -16,20 +16,20 @@ 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.6.
|
|
19
|
+
> **Version boundary:** this source tree is version `0.6.2`. That is the local version and the
|
|
20
20
|
> intended joint target for the renderer, documentation plugin, and public site. Confirm this
|
|
21
21
|
> exact version in the official npm registry before `npm install` or `npx`. Published `0.4.5`
|
|
22
22
|
> preserves the `markdown-v1`, `editorial`, and `--check-project` behavior introduced in 0.4.0
|
|
23
|
-
> and has no `--conclusion-output` or `--read-proof`. Those two commands belong to this 0.6.
|
|
23
|
+
> and has no `--conclusion-output` or `--read-proof`. Those two commands belong to this 0.6.2
|
|
24
24
|
> CLI. The examples give the command shape for that version. They leave publication, Skill
|
|
25
|
-
> Family Hub registration, and new host-reply acceptance to the official records for `0.6.
|
|
25
|
+
> Family Hub registration, and new host-reply acceptance to the official records for `0.6.2`.
|
|
26
26
|
|
|
27
27
|
## Install
|
|
28
28
|
|
|
29
|
-
After confirming `skill-family-doc-render@0.6.
|
|
29
|
+
After confirming `skill-family-doc-render@0.6.2` in the official npm registry, install that exact version:
|
|
30
30
|
|
|
31
31
|
```sh
|
|
32
|
-
npm install --save-exact skill-family-doc-render@0.6.
|
|
32
|
+
npm install --save-exact skill-family-doc-render@0.6.2
|
|
33
33
|
```
|
|
34
34
|
|
|
35
35
|
Requires Node.js `>=22.22.2 <23` (aligned with the skill-family foundation packages).
|
|
@@ -46,34 +46,34 @@ notes.
|
|
|
46
46
|
|
|
47
47
|
## CLI
|
|
48
48
|
|
|
49
|
-
Use the exact 0.6.
|
|
49
|
+
Use the exact 0.6.2 CLI for rendering, checks, coverage maintenance, the Git index assertion, and the proof commands. Confirm `skill-family-doc-render@0.6.2` in the official npm registry before running them. Published 0.4.5 can run the commands that omit `--conclusion-output` and `--read-proof`.
|
|
50
50
|
|
|
51
51
|
```sh
|
|
52
52
|
# render all repos with a site field (writes to disk)
|
|
53
|
-
npx skill-family-doc-render@0.6.
|
|
53
|
+
npx skill-family-doc-render@0.6.2
|
|
54
54
|
|
|
55
55
|
# drift check only: compare in-memory render against the on-disk site-baseline.json, write nothing
|
|
56
|
-
npx skill-family-doc-render@0.6.
|
|
56
|
+
npx skill-family-doc-render@0.6.2 --check
|
|
57
57
|
|
|
58
58
|
# render / check a single repo by name
|
|
59
|
-
npx skill-family-doc-render@0.6.
|
|
59
|
+
npx skill-family-doc-render@0.6.2 --repo <name>
|
|
60
60
|
|
|
61
61
|
# assert every rendered file is tracked in the Git index, then render
|
|
62
|
-
npx skill-family-doc-render@0.6.
|
|
62
|
+
npx skill-family-doc-render@0.6.2 --assert-git
|
|
63
63
|
|
|
64
64
|
# run both the drift and Git index tracking checks without writing
|
|
65
|
-
npx skill-family-doc-render@0.6.
|
|
65
|
+
npx skill-family-doc-render@0.6.2 --check --assert-git
|
|
66
66
|
|
|
67
67
|
# inspect or refresh the reviewed product-input snapshot
|
|
68
|
-
npx skill-family-doc-render@0.6.
|
|
69
|
-
npx skill-family-doc-render@0.6.
|
|
70
|
-
npx skill-family-doc-render@0.6.
|
|
68
|
+
npx skill-family-doc-render@0.6.2 --status --repo <name>
|
|
69
|
+
npx skill-family-doc-render@0.6.2 --refresh-coverage --repo <name>
|
|
70
|
+
npx skill-family-doc-render@0.6.2 --check-project --repo <name>
|
|
71
71
|
|
|
72
72
|
# after the mechanical check, exclusive-create one proof; do not overwrite
|
|
73
|
-
npx skill-family-doc-render@0.6.
|
|
73
|
+
npx skill-family-doc-render@0.6.2 --check-project --repo <name> --conclusion-output /absolute/path/conclusion.json
|
|
74
74
|
|
|
75
75
|
# read one existing proof from any working directory; write nothing
|
|
76
|
-
npx skill-family-doc-render@0.6.
|
|
76
|
+
npx skill-family-doc-render@0.6.2 --read-proof --proof-root /absolute/proof-root --proof relative/conclusion.json
|
|
77
77
|
```
|
|
78
78
|
|
|
79
79
|
`--check-project` still requires the current directory to own `public-release.json`.
|
|
@@ -104,7 +104,7 @@ Same-version `DOCS_CLEAR` maps to `pass` only when `completion` is `complete`;
|
|
|
104
104
|
That status keeps the proof's recorded non-pass. A missing file, damaged JSON, a different
|
|
105
105
|
provider, or an unknown same-version domain code is `unavailable` (exit `2`). Earlier
|
|
106
106
|
local-candidate runs exercised proof output and proof reading; those runs keep their original
|
|
107
|
-
scene limits. Publication, Hub registration, and new host replies for `0.6.
|
|
107
|
+
scene limits. Publication, Hub registration, and new host replies for `0.6.2` stay with the
|
|
108
108
|
official records. These proof commands consume the Foundation
|
|
109
109
|
`professional-conclusion` contract from `skill-family-contracts@0.22.0`. Refreshing a proof
|
|
110
110
|
means running `--check-project` again to a new output path. Remediation, site creation, and
|
|
@@ -318,7 +318,7 @@ Foundation packages below, it uses exact `marked@18.0.11` for Markdown tokenizat
|
|
|
318
318
|
Apache-2.0
|
|
319
319
|
|
|
320
320
|
<!-- release-skill:capability:safe-first-command -->
|
|
321
|
-
> **Start here:** run `npx skill-family-doc-render@0.6.
|
|
321
|
+
> **Start here:** run `npx skill-family-doc-render@0.6.2 --check-project --repo <name>` after
|
|
322
322
|
> confirming that exact version in the official registry. From a local checkout, stay in the
|
|
323
323
|
> directory that owns `public-release.json` and call
|
|
324
324
|
> `node /absolute/path/to/skill-family-doc-render/bin/skill-family-doc-render.mjs --check-project --repo <name>`,
|
|
@@ -346,6 +346,6 @@ Apache-2.0
|
|
|
346
346
|
Display help and run a read-only project check:
|
|
347
347
|
|
|
348
348
|
```sh
|
|
349
|
-
npx skill-family-doc-render@0.6.
|
|
350
|
-
npx skill-family-doc-render@0.6.
|
|
349
|
+
npx skill-family-doc-render@0.6.2 --help
|
|
350
|
+
npx skill-family-doc-render@0.6.2 --check-project --repo <name>
|
|
351
351
|
```
|
package/package.json
CHANGED