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.
Files changed (3) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +20 -20
  3. 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.1`. That is the local version and the
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.1
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.1`.
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.1` in the official npm registry, install that exact version:
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.1
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.1 CLI for rendering, checks, coverage maintenance, the Git index assertion, and the proof commands. Confirm `skill-family-doc-render@0.6.1` in the official npm registry before running them. Published 0.4.5 can run the commands that omit `--conclusion-output` and `--read-proof`.
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.1
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.1 --check
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.1 --repo <name>
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.1 --assert-git
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.1 --check --assert-git
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.1 --status --repo <name>
69
- npx skill-family-doc-render@0.6.1 --refresh-coverage --repo <name>
70
- npx skill-family-doc-render@0.6.1 --check-project --repo <name>
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.1 --check-project --repo <name> --conclusion-output /absolute/path/conclusion.json
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.1 --read-proof --proof-root /absolute/proof-root --proof relative/conclusion.json
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.1` stay with the
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.1 --check-project --repo <name>` after
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.1 --help
350
- npx skill-family-doc-render@0.6.1 --check-project --repo <name>
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skill-family-doc-render",
3
- "version": "0.6.1",
3
+ "version": "0.6.2",
4
4
  "description": "Config-driven GitHub Pages knowledge-site renderer for skill-family projects (multi-repo capable).",
5
5
  "author": "广州市风荷科技有限公司",
6
6
  "license": "Apache-2.0",