dsh-mini-utility-dock 0.7.0 → 0.7.1

package/README.en.md

@@ -56,7 +56,7 @@ A consumer's `npm test` runs `loopback:check` / `guard:check` / `http:check`, co
 
 `dsh-plugin-parity` (a bin provided by this package) checks that cross-repo property directly: every host block compared in isolation after stripping the block's common indentation (the three, `dsh-host-http` included), pin agreement, block position, and a behavioral comparison. It is a manual diagnostic and **does not run in CI**: the property cannot hold while peers sit on a different branch. The member list is caller-supplied via `--member <repo>:<export>` — the guard factory's export name is per-repository by fragment design, so the tool presupposes no members; `--fleet <repo>` names the single member that opts into fleet mode, and only its guard is checked for "the relaxation stays bounded", while naming a repository that is not a member fails with a non-zero exit; without `--member` it runs the static checks only and discovers every checkout that embeds the guard block. `--self-test` needs no checkout at all: it exercises the block extractor and the block-dropping step against inline samples, so run it first whenever either changes.
 
-`dsh-plugin-docs` (another bin of this package) checks the bilingual documentation pairs for structural alignment. It names no document of its own: which pairs to check, which directory holds them, and how each is compared come from an array of `{ name, zh, en, shape? }` that the calling repository supplies through `--config <module>`; this package declares its own pairs in `docs.config.mjs` the same way. Two shapes exist. The default, `markdown`, compares the heading-level sequence and the code-fence languages on both sides; content inside a fence is exempt because that is where language-specific examples live. `changelog` compares the releases on both sides, the `Unreleased` section included, together with their sections and item counts, with section titles normalized through a bilingual category map. `--base <revision>` additionally requires both files of each declared pair to have changed since that revision: a one-sided edit is a missing translation. When that revision is the all-zero null OID, which is what `github.event.before` carries for a newly created or force-pushed branch, there is no previous state to compare, so that one requirement is skipped with a note while the structural checks still run. Repositories call it from their own `docs:check` script.
+`dsh-plugin-docs` (another bin of this package) checks the bilingual documentation pairs for structural consistency. It names no document of its own: which pairs to check, which directory holds them, and how each is compared come from an array of `{ name, zh, en, shape? }` that the calling repository supplies through `--config <module>`; this package declares its own pairs in `docs.config.mjs` the same way. Two shapes exist. The default, `markdown`, compares the heading-level sequence and the code-fence languages on both sides; content inside a fence is exempt because that is where language-specific examples live. `changelog` compares the releases on both sides, the `Unreleased` section included, together with their sections and item counts, with section titles normalized through a bilingual category map. `--base <revision>` additionally requires both files of each declared pair to have changed since that revision: a one-sided edit is a missing translation. When that revision is the all-zero null OID, which is what `github.event.before` carries for a newly created or force-pushed branch, there is no previous state to compare, so that one requirement is skipped with a note while the structural checks still run. Repositories call it from their own `docs:check` script.
 
 ## Development and verification
 

package/README.md

@@ -56,7 +56,7 @@ npm run dock:embed -- sync path/to/shared.js
 
 `dsh-plugin-parity`（本包提供的 bin）直接检这条跨仓性质：逐块（剥离块的公共缩进后）比对三个 host 块（含 `dsh-host-http`）、pin 一致性断言、块落点顺序断言与行为级对比。它是人工诊断工具，**不在 CI 中运行**：peer 处于不同分支时该性质本就不成立。成员表由调用方经 `--member <repo>:<export>` 提供——守卫工厂的导出名按片段设计是各仓自定的，故本工具不预设任何成员；`--fleet <repo>` 点名唯一启用 fleet 模式的成员，只对它检查「放宽有边界」，点名不在成员表中的仓即判 FAIL 并非零退出；不带 `--member` 时只跑静态检查，自动发现所有嵌入了宿主守卫块的仓。`--self-test` 不需要任何 checkout：它用内联样例检验块提取与「丢块」两步，改动这两个函数后先跑它。
 
-`dsh-plugin-docs`（同样是本包的 bin）校验双语文档的结构对齐。它不预设文档名：检查哪些文档对、文件位于哪个目录、按什么形状比较，都由调用仓通过 `--config <module>` 提供一个 `{ name, zh, en, shape? }` 数组决定；本包用同一种方式声明自己的 `docs.config.mjs`。形状有两种。默认的 `markdown` 比较中英两侧的标题层级序列与代码围栏语言，围栏内的内容豁免，因为语言相关的示例写在那里。`changelog` 比较中英两侧的版本段（含 `Unreleased` 段）、分类段与小节条目数，分类标题经双语映射归一。`--base <revision>` 额外要求声明的每一对文件在该 revision 之后一起改动，单边改动即缺翻译；revision 为全 0 的 null OID（新建分支或强推时 `github.event.before` 即为此值）时没有可比的前态，这一项跳过并给出提示，其余结构校验照常。各仓的 `docs:check` script 调用它。
+`dsh-plugin-docs`（同样是本包的 bin）校验双语文档的结构一致性。它不预设文档名：检查哪些文档对、文件位于哪个目录、按什么形状比较，都由调用仓通过 `--config <module>` 提供一个 `{ name, zh, en, shape? }` 数组决定；本包用同一种方式声明自己的 `docs.config.mjs`。形状有两种。默认的 `markdown` 比较中英两侧的标题层级序列与代码围栏语言，围栏内的内容豁免，因为语言相关的示例写在那里。`changelog` 比较中英两侧的版本段（含 `Unreleased` 段）、分类段与小节条目数，分类标题经双语映射归一。`--base <revision>` 额外要求声明的每一对文件在该 revision 之后一起改动，单边改动即缺翻译；revision 为全 0 的 null OID（新建分支或强推时 `github.event.before` 即为此值）时没有可比的前态，这一项跳过并给出提示，其余结构校验照常。各仓的 `docs:check` script 调用它。
 
 ## 开发与验证
 

package/bin/dsh-plugin-parity.js

@@ -8,11 +8,11 @@
 // a Host that parses to no hostname skipping the allowlist in one copy while
 // another denies it.
 //
-// The copies are no longer hand-written: they are embedded blocks generated from
-// dsh-mini-utility-dock by the dock CLI — `dist/loopback.js` (the predicates),
-// `dist/guard.js` (the enforcement policy) and `dist/host-http.js` (the response
-// glue: JSON replies, the POST gate, the browser authorizer). So this checker
-// asserts three things a generator alone cannot:
+// The consumer copies are embedded blocks generated from this package's `dist/`
+// files by the dock CLI — `dist/loopback.js` (the predicates), `dist/guard.js`
+// (the enforcement policy) and `dist/host-http.js` (the response glue: JSON
+// replies, the POST gate, the browser authorizer). So this checker asserts three
+// things a generator alone cannot:
 //
 //   * every embedded block is byte-identical in every member (a hand edit to
 //     one copy, or a repo that never re-ran `loopback:sync` / `guard:sync` /
@@ -293,8 +293,8 @@ for (const block of BLOCKS) {
 //    Every pattern here matches a CODE SHAPE, not a word. These files are scanned
 //    as text with the generated blocks dropped, so a bare keyword also matches
 //    prose: a doc comment explaining why a private helper is NOT a second guard
-//    used to fail the very repository that documented its reasoning. An
-//    explanation is not enforcement; reading a header or declaring a function is.
+//    would read as a decision. An explanation is not enforcement; reading a
+//    header or declaring a function is.
 const ENFORCEMENT = [
   [/LOOPBACK_HOSTNAMES\s*=(?!=)/, 'redefines LOOPBACK_HOSTNAMES'],
   [/(?:const|function|let)\s+isLoopbackName\b/, 'defines a private isLoopbackName'],

package/docs/CHANGELOG.en.md

@@ -3,6 +3,12 @@
 Release notes are generated from the matching version section; newest first.
 For Chinese, see [CHANGELOG.md](CHANGELOG.md).
 
+## 0.7.1 - 2026-09-29
+
+### Maintenance
+
+- No interface changed: only the explanatory text in `bin/` and `test/` and two README phrasings were rewritten; `dist/`, the CLI arguments and the `--config` contract are untouched.
+
 ## 0.7.0 - 2026-09-29
 
 ### Changed

package/docs/CHANGELOG.md

@@ -3,6 +3,12 @@
 Release Notes 由对应版本段生成；最新版本在前。
 英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## 0.7.1 - 2026-09-29
+
+### 维护
+
+- 无接口变更：`dsh-plugin-docs` 与 `dsh-plugin-parity` 的参数、输出和 `dist/` 片段字节均未改动，本次只改写 bin 与测试中的说明文字，并把 README 里「结构对齐」的说法改为「结构一致性」。
+
 ## 0.7.0 - 2026-09-29
 
 ### 变更

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mini-utility-dock",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "The DSH plugin family's shared assets: source fragments (the loopback predicates, host request guard and host HTTP glue for host halves, the utility launcher for client halves), the embedding CLI, and the family diagnostics — cross-repo drift check and bilingual docs structure check.",
   "type": "module",
   "bin": {