Skip to content

Releases

signoff-cli 4.8.0:闸门按代价分层

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 12 Nov 15:14

闸门按代价分层,反向对照只问「会不会红」。

钩子:提交跑快检,推送跑全套

  • signoff init 装的三个钩子各司其职:pre-commit 跑 p1 的快检层,pre-push 与 CI 跑全套。快检入口取自
    .signoff/config.json 的 fast_cmd 或 package.json 的 test:fast;两样都没有就退回全套——没声明就没有这一层。
  • .signoff/cache.json 的键带上运行模式(fast / full):快检通过不能替推送那一次的全套作保。
  • 本仓库新增 node test/smoke.js(8 项,约 2.4 s),断言落在真正渲染出的页面 chip 上,不是源码里的字符串。
  • npm test 改成两段并行(test/run-all.js):用例一条没少,全套 93 s → 50 s 量级,推送闸门 126 s → 53 s。
    node test/selftest.js 仍是完整串行路径,并支持 SIGNOFF_TIMING=1 排出最慢的 12 条用例。

反向对照:改过的测试必须在旧代码上红

signoff p1 --negative-control 把这次改过的测试文件放进 git worktree 检出的 base 版本里跑一遍,必须红。
两棵树都绿判红(green-on-base),在 base 上跑不起来单列 cannot-run-on-base,不冒充「测出来了」。
推送与 CI 自动带上,只有 touched 非空才付这笔钱,--nc-budget 默认 180 s、超时算红。
它只问「会不会红」,所以套件在 SIGNOFF_NC=1 下第一条红就收工:反向对照 60.4 s → 2.2 s。

界面:金额带词、版面有据可查

  • 侧栏与看板的金额一律先出词再出数:中文 费用 $0.02,英文 cost $0.02;class="cost" 的可见文本都形如 费用 $…。
  • 看板加「Token 与费用」:累计 token、金额、按天、按任务组、按提交的 agent 花费;signoff tokens 在终端问同一件事。
    数据只读本机 DSH 会话记录,金额按 DeepSeek 峰/谷价估算,.signoff/prices.json 可覆盖;读不到就写明原因而不是显示 0。
  • 新增 docs/DESIGN.md、node tools/ui-shot.js(看板出图)、jsconfig.json + npm run typecheck(运行时依赖仍是零)。

修复(挑要紧的)

  • 看板任务组的三个数字取同一个窗口,不再在一句话里自相矛盾。
  • integrity / review / fix 统一走 git -z:路径含中文或空格时不再被八进制转义骗成「没有改动」
    (删掉 tests/测试.test.js 的断言曾判 clean,Lib/P1.js 曾能覆盖 lib/p1.js)。
  • fix 回滚不再删掉补丁自己新建、被 .gitignore 挡住的文件;patterns 不再把回滚/被推翻/被拒算成门失败。
  • dispute 不再把拼错的命令当证据,--budget 带 timeout 与 SIGKILL;uninstall 收走新增状态。

English

Gates are layered by cost; the negative control only asks whether a test goes red.

  • Hooks now have separate jobs: pre-commit runs the p1 fast layer, pre-push and CI run the full suite. The fast
    command comes from .signoff/config.json or package.json; with neither declared the hook falls back to the full
    suite instead of waving the commit through. The cache key carries the run mode, so a green fast run cannot stand
    in for the full run at push time.
  • npm test runs two shards in parallel (test/run-all.js): no case was dropped, the suite went 93 s → 50 s range,
    and the push gate 126 s → 53 s. node test/selftest.js remains the full serial path and accepts
    SIGNOFF_TIMING=1 to rank the slowest cases.
  • New signoff p1 --negative-control: the test files touched by a change run inside a base version checked out with
    git worktree and must go red. Green on both trees is green-on-base; a base checkout where they cannot start
    is reported as cannot-run-on-base instead of pretending the test proved anything. Under SIGNOFF_NC=1 the suite
    stops at the first red, taking the negative control from 60.4 s to 2.2 s.
  • Amounts always carry a label first (费用 $0.02 / cost $0.02); the board gains a "Token and cost" block fed by
    this machine's DSH session records (read-only, no network), and signoff tokens answers the same question in the
    terminal. When the records are unreadable the block says why instead of showing 0.
  • New docs/DESIGN.md, node tools/ui-shot.js, jsconfig.json + npm run typecheck; runtime dependencies stay zero.
  • integrity, review and fix now parse git -z instead of human-readable output: paths with Chinese characters
    or spaces no longer look like "nothing changed". Rollback, refutation and rejection are recorded as tool outcomes,
    not gate failures.

Full self-test: 619 passed / 0 failed. Published from GitHub Actions with a provenance attestation.

4.7.1 — 声明退后,验证上前

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 13:13

4.7.1

声明退后,验证上前。

  • 发布走 CI:新增 .github/workflows/publish.yml,tag 触发、id-token: write、npm publish --provenance,
    发布前硬校验 tag 等于 package.json 版本;publishConfig.provenance 打开,本地裸发布会被拒。
  • 发布闸门补三处:--pre 增 changelog-version、citation-version,--post 增 git-tag。版本号写在四份
    文档里就必须四处一致,从此不靠人记。
  • 声明去重:README 不再复制 © 行,只指向 NOTICE 与 TRADEMARK.md;© 只剩两处同步点(LICENSE、
    NOTICE)。标志去掉边款——128px 下字高只有 2.73px,读不出的东西不留在图里。
  • 新增 TRADEMARK.md(能说什么、不能做什么、标志授权、未注册的事实)与 docs/verify-release.md
    (provenance、integrity、tag 一致性,附处置表)。
  • 供应链收紧:第三方 actions 钉到 commit SHA、CI 不再执行 @latest、mcp-publisher 下载加 sha256、
    ci/signoff 收窄为只读 token、补 CODEOWNERS 与 dependabot。
  • 元数据回真:CITATION.cff 从 4.3.1 回到本版、ARCH-HEALTH 版本、pre-commit 的包名与 rev、
    action.yml 默认版本不再浮动在 latest。
  • 包体瘦身:files 加 !docs/diagrams/,4.3MB 文档配图与 test/ 不再进包。
  • npm 侧:4.7.0 已 deprecate(无 tag、无 changelog、代码已回滚),本版取 4.7.1 以高于它并成为 latest。
  • 自测 491 passed / 0 failed。

English

Declarations step back; verification steps forward.

  • Publishing moves to CI: a new .github/workflows/publish.yml runs on tags with id-token: write and
    npm publish --provenance, failing hard unless the tag equals the package.json version.
    publishConfig.provenance is on, so a bare local publish is refused.
  • Three new release gates: changelog-version and citation-version in --pre, git-tag in --post.
    A version named in four documents must now agree in all four.
  • Declarations deduplicated: the READMEs no longer copy the copyright line and point at NOTICE and
    TRADEMARK.md instead; © has exactly two places to keep in sync (LICENSE, NOTICE). The mark
    lost its side-inscription: at 128px it was 2.73px tall, so nothing readable was lost.
  • New TRADEMARK.md (what others may say, must not do, logo permission, the unregistered fact) and
    docs/verify-release.md (provenance, integrity, tag agreement, with a disposition table).
  • Supply chain tightened: third-party actions pinned to commit SHAs, no @latest in CI, sha256 check
    on the mcp-publisher download, read-only default token in ci/signoff, plus CODEOWNERS and
    dependabot.
  • Metadata corrected: CITATION.cff moves from 4.3.1 to this version, ARCH-HEALTH version,
    the pre-commit package name and rev, and action.yml no longer floats on latest.
  • Smaller package: !docs/diagrams/ keeps 4.3MB of documentation images and test/ out of the tarball.
  • npm side: 4.7.0 is deprecated (no tag, no changelog, reverted); this release is 4.7.1 to sit above it
    and become latest.
  • 491 passed / 0 failed.

v4.6.2 — 位置重新对齐

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 08:28

4.6.2

把首行徽章放回去(含 CI 状态)。

  • 4.5.0 重写 README 时丢了首行的五枚徽章:npm 版本、周下载、Node 版本、CI 状态、许可。
    现在中英两个 README 都把徽章放在标题正下方,并加了自测断言——少一枚就红,不会再被一次改写带走。
  • 自测 459 passed / 0 failed(新增十枚徽章断言)。判定逻辑没动。

English

The badge row is back, CI status included.

  • The 4.5.0 README rewrite dropped the five badges on the first line: npm version, weekly downloads, Node version,
    CI status and license. Both READMEs now carry them directly under the title, and a self-test assertion fails if
    any is missing, so another rewrite cannot take them away silently.
  • 459 passed / 0 failed (ten new badge assertions). Verdict logic untouched.

v4.6.1 — 两种语言,一条线

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 08:18

4.6.1

修一个只在 CI 上暴露的回归:中英同步把 CRLF 检出误判成「没同步」。

  • 4.6.0 引入的 tools/sync-bilingual.mjs 假设 \n 行尾。Windows runner 的 core.autocrlf=true 会把仓库检出成 CRLF,
    于是自测报 README.md out of sync,三个矩阵任务全红(本机因为文件本来就是 LF 而没暴露)。
    现在比较与写入都与行尾无关:CRLF 检出照常通过,写回时保持该文件原有行尾,不产生 \r\r\n。
  • 新增 .gitattributes(* text=auto eol=lf,图片与压缩包标 binary),仓库不再随检出机器的行尾设置变形。
  • 自测仍是 449 passed / 0 failed;另外用「把 README 转成 CRLF 再跑 --check」复现并验证了这次修复。

English

Fixes a regression that only showed up on CI: the bilingual sync treated a CRLF checkout as out of sync.

  • The tools/sync-bilingual.mjs added in 4.6.0 assumed \n line endings. A Windows runner with
    core.autocrlf=true checks the repo out with CRLF, so the self-test reported README.md out of sync and all three
    matrix jobs went red (locally the files were already LF, so it never showed). Comparison and writing are now
    line-ending agnostic: a CRLF checkout passes, writing keeps the file's existing endings, and no \r\r\n is produced.
  • New .gitattributes (* text=auto eol=lf, binaries marked) so the repository no longer changes shape with the
    checkout machine's line-ending settings.
  • Still 449 passed / 0 failed, and the fix was reproduced by converting the README to CRLF and running --check.

v4.6.0 — 一页之内,两种说法

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 08:10

4.6.0

说明文档中英同页、两张图回到原位;许可与法律声明按全球适用范围做了脱敏;发行与商业化有了可核对的论证。

  • 中英同页:README.md 与六篇 docs/*.md 在中文正文之后,原样嵌入对应 .en.md 全文(标题降一级,## English 一节),
    仍保留开头的 English: ….en.md 指路。英文正文只有一个源头(.en.md),由 tools/sync-bilingual.mjs 同步,
    自测用 --check 防止两边漂移。
  • 图回到原位:架构图 signoff-1-capability.png 回到「七道关」一节,工作原理图 signoff-4-flow.png 回到「看板」一节;
    英文侧用 -en.png 孪生件。docs/diagrams/README.md 补上 flow / competitors 两行与英文产物说明。
  • 许可与法律:LICENSE 著作权人改为 SignOff contributors(不写个人姓名与邮箱);新增 NOTICE(名字与图标不随 MIT 授权、
    第三方商标不背书、本机无遥测、按现状提供);新增 docs/legal.md 与英文版,写清 MIT 覆盖什么、不覆盖什么、
    隐私与数据留在本机、使用者侧的出口管制/行业合规、贡献与管辖口径。SECURITY.md 去掉个人邮箱,改走 GitHub 私密通道。
  • 发行与商业化论证:新增 docs/release-model.md,用可核对的数字(npm 月下载 3 237、零运行时依赖、免费钩子层同行)
    论证团队协作与 AI 集群两类需求、为什么判定本身没有定价空间、如果收费只有「托管看板」与「团队合规包」两种形态,
    以及重新评估的两个触发条件(周下载连续四周 >5 000、三家以上组织提出采购或 SLA)。
  • 自测 449 passed / 0 failed:新增中英同页、图在位、许可与 NOTICE、法律与发行文档五类断言。
  • 判定逻辑没动。

English

Docs are bilingual on one page, both diagrams are back in place, the license and legal notice are de-identified for
worldwide use, and the release/commercial model now has a checkable argument.

  • Bilingual on one page: README.md and six docs/*.md files now carry the full English text (from the matching
    .en.md, headings demoted, under a ## English section) right after the Chinese body, while the leading
    English: ….en.md pointer stays. The English text has a single source (.en.md), synced by
    tools/sync-bilingual.mjs, and a self-test (--check) prevents drift.
  • Diagrams restored: the architecture image signoff-1-capability.png is back in the gates section and the
    workflow image signoff-4-flow.png back in the board section, with the -en.png twins on the English side.
    docs/diagrams/README.md now lists the flow and competitors images and their English twins.
  • License and legal: LICENSE names SignOff contributors instead of a person; a new NOTICE states that the
    name and icons are not part of the MIT grant, that third-party marks imply no endorsement, that the tool runs
    locally with no telemetry, and that it is provided as is. docs/legal.md (with an English twin) covers what MIT
    does and does not cover, privacy, user-side export-control and sector compliance, contributions, and jurisdiction.
    SECURITY.md drops the personal mailbox in favour of the GitHub private channel.
  • Release and commercial model: new docs/release-model.md argues, with checkable numbers (3,237 monthly npm
    downloads, zero runtime dependencies, free hook-layer peers), why teams and AI clusters have a need but the verdict
    itself has no pricing power, that only a hosted board and a team compliance pack are defensible paid shapes, and what
    would trigger a re-evaluation (weekly downloads above 5,000 for four weeks; three or more organisations asking for
    procurement or an SLA).
  • 449 passed / 0 failed, with new assertions for bilingual pages, diagram placement, license and NOTICE, and the legal
    and release documents.
  • Verdict logic untouched.

v4.5.0 — 一页看全

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 07:53

4.5.0

看板一页看全,剩下点开;对外说明重排成中英同构的七段。

  • DSH 面板:一个仓库一张卡,列一页数据(判决、过闸率、提交数、组任务数、最近一次跑闸、七关徽章、组任务行),
    挡路项最多 3 行、组任务补满到 9 行;只有还没画完时才出现「打开完整页面(还有 N 组)」,装得下就不显示按钮。
    只读:不跑关、不写状态、不改阈值;文案跟浏览器语言。面板 1.1.0。
  • 说明文档重排:README.md 与新 README.en.md 同为七段(上手 / 七关 / 看板 / 接入 / 匿名对照 / 边界 / 索引);
    docs/gates.md、docs/integrations.md、docs/trust.md 按同一骨架重写,各有一份 .en.md 孪生件。
  • 删掉过时内容:docs/release-notes-4.4.0.md(CHANGELOG 里已有对应条目)、docs/metrics-sample.md(一次性数据样板)、
    docs/threat-model.md(并入 docs/trust.md);gates.md 里早已不存在的 gates/*.py 路径改成 lib/p*.js。
  • 修掉会把人带沟里的说明:SKILL.md 教的 signoff run 不存在(改为 signoff guard / signoff all);
    MCP 的 signoff_run 工具原本转发给 signoff run,现在转发 signoff guard(full: true → --full)。
  • 自测 432 passed / 0 failed:新增面板浅渲染(test/panel-smoke.js)、文档英文孪生件、相对链接零断链、
    SKILL/MCP 口径四类断言。
  • 判定逻辑没动。

English

The board fits one page and only then offers more; the published docs are regrouped into the same seven sections
in both languages.

  • DSH panel: one card per repository, one page of data (verdict, pass rate, commits, task groups, last gate run,
    seven gate badges, task rows). Blockers take at most 3 rows and task rows fill up to 9; "Open full page (N more)"
    appears only when something is left over
    . Read-only: runs no gate, writes no state, changes no threshold; text
    follows the browser language. Panel 1.1.0.
  • Docs regrouped: README.md and the new README.en.md share seven sections (start / gates / board /
    integrations / anonymous comparison / limits / index); docs/gates.md, docs/integrations.md and
    docs/trust.md were rewritten on the same skeleton, each with an .en.md twin.
  • Stale material removed: docs/release-notes-4.4.0.md (the CHANGELOG has the same entry), docs/metrics-sample.md
    (one-off sample), docs/threat-model.md (merged into docs/trust.md); the long-gone gates/*.py paths in
    gates.md now point at lib/p*.js.
  • Fixed instructions that led people astray: SKILL.md taught signoff run, which does not exist (now
    signoff guard / signoff all); the MCP signoff_run tool forwarded to signoff run and now forwards to
    signoff guard (full: true → --full).
  • 432 passed / 0 failed, with new assertions for the panel smoke render (test/panel-smoke.js), English twins,
    zero broken relative links, and the SKILL/MCP wording.
  • Verdict logic untouched.

v4.4.5 — 叫对名字

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 07:34

4.4.5

看板按项目名说话:最近一次跑闸、按任务都写成「SignOff 项目更新 4.4.x 版」。

  • report --json 新增顶层 project;每组任务新增 label:组内最新提交标题里有 x.y.z 时写
    「<项目> 项目更新 <版本> 版」(英文页写 <project> project update <version>),没有版本时写「<项目> · <区域>」。
  • 「最近一次跑闸」这个 mark 的 label 同样按项目名,detail 变成「最近一次跑闸 · 全过 · 0.61s」。
  • 项目名解析:.signoff/config.json 的 project → package.json 的 productName / displayName / name
    → 仓库目录名,再去掉 @scope/ 与 -cli|-app|-mcp|-server 后缀;本仓库加 productName: "SignOff"。
  • label 只做展示:id、title、--task 的筛选语义不变,原始区域名仍在 title 与页面 meta 里。
  • 契约新增 C11(任务与跑闸按项目名说话);自测 420 passed / 0 failed,新增 4 条断言。
  • 判定逻辑没动。

English

The board speaks in project names: the last gate run and every task group now read "SignOff project update 4.4.x".

  • report --json gains a top-level project, and every task group gains a label: when the newest commit subject
    in the group contains x.y.z it becomes <project> project update <version> (Chinese: <项目> 项目更新 <版本> 版),
    otherwise <project> · <area>.
  • The "last gate run" mark is labelled the same way, and its detail reads "最近一次跑闸 · 全过 · 0.61s".
  • Project name resolution: .signoff/config.json project → package.json productName / displayName / name
    → repository directory name, then strip @scope/ and -cli|-app|-mcp|-server; this repo now sets
    productName: "SignOff".
  • label is display-only: id, title and --task filtering keep their meaning, and the original area name stays
    in title and in the page meta.
  • Contract clause C11 added; npm test 420 passed / 0 failed with four new assertions.
  • Verdict logic untouched.

v4.4.4 — 停住空转

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 07:16

4.4.4

修 tools/arch-health.mjs:Windows 上四条规则一直是空转,Linux CI 却红在第一个环上。

  • listJs() 在 Windows 返回 lib\\report.js,requiresOf() 返回 lib/report.js,两边对不上,依赖图整张是空的:
    本机永远"0 违规、38/40",CI(Linux)第一次真跑就抛 comp.join is not a function。现在两边都规范成 /。
  • requiresOf() 只认顶层 require。写在函数体里的 require 是惰性的,不构成模块初始化期的环;
    以前把 bootstrap.js → guard.js、checkpoint.js → p4.js 这类懒加载判成 R1 环,属于误报。
  • cycles() 的返回值是"分量数组的数组",原来 for (const [comp] of …) 把分量拆碎,遇到环就崩;改成整份取用。
  • 基线 docs/arch-health-baseline.json 的键同样是反斜杠,导致两个超限文件一直被当成"新增";键已统一成 /。
  • 新增 3 条自测(退出码、路径分隔符、不把懒加载判成环),npm test 416 passed / 0 failed。
  • 判定逻辑没动。

English

Fixes tools/arch-health.mjs: on Windows all four rules were no-ops, while Linux CI went red on the first cycle.

  • listJs() returned lib\\report.js on Windows while requiresOf() returned lib/report.js, so the dependency
    graph was empty: locally it always said "0 violations, 38/40", and CI (Linux) crashed with
    comp.join is not a function on its first real run. Both sides now normalise to /.
  • requiresOf() only counts top-level requires. A require inside a function body is lazy and cannot form a
    module-initialisation cycle; previously bootstrap.js → guard.js and checkpoint.js → p4.js were reported as R1.
  • cycles() returns an array of components; for (const [comp] of …) split each component apart and crashed on the
    first cycle. It now takes the component whole.
  • The keys in docs/arch-health-baseline.json had the same backslash problem, so the two oversize files were always
    treated as new; they are normalised too.
  • Three new self-tests (exit code, path separators, lazy requires are not cycles): npm test 416 passed / 0 failed.
  • Verdict logic untouched.

v4.4.3 — 再收一寸

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 07:09

4.4.3

匿名再收紧:对比表与象限图只剩编号,能反推到具体项目的信息都删掉。

  • 4.4.2 只把名字换成了 B1/B2/B3,但表里还写着"Node 钩子安装器""Python 钩子框架""Go 钩子运行器"、每家精确周下载,
    象限图的点也带着同样后缀——这些足够反推出具体项目,等于没匿名。
  • 现在:对比表只剩"给判决 / 留证据 / 采用量级"三列,量级只写"千万级/周以上";象限图四个点只标 B1 B2 B3 C;
    每格理由里的"单二进制""跨语言"这类实现描述一并删掉。
  • README 与两份对比文档里的象限图链接加 ?v=4.4.3:GitHub 的图片代理会缓存旧图,不换 URL 看到的还是旧版。
  • 行为无变化:判定、退出码 0/1/2、账本与页面结构都没动。

English

Anonymity, properly: the comparison table and quadrant keep only labels — anything traceable to a specific
project is gone.

  • 4.4.2 swapped names for B1/B2/B3 but still said "Node hook installer", "Python hook framework", "Go hook
    runner" and listed each peer's exact weekly downloads; the quadrant points carried the same suffixes. That is
    enough to identify every one of them, which defeats the point.
  • Now: the table has three columns — verdict, evidence, adoption magnitude ("tens of millions/week or more"); the
    four quadrant points are labelled B1 B2 B3 C; implementation details such as "single binary" and
    "cross-language" are removed from the per-cell reasoning.
  • The quadrant links in the README and both comparison docs now carry ?v=4.4.3, because GitHub's image proxy
    caches the old file under the old URL.
  • No behaviour change: verdicts, exit codes, ledger format and page structure are untouched.

v4.4.2 — 不留名字

Choose a tag to compare

@ayuanxx-max ayuanxx-max released this 11 Nov 07:03

4.4.2

对比一律匿名:同行只说类型(A–F),不点名、不列对方的星标与下载数。

  • 同一套匿名标记贯穿全部对外文字:A 平台级、B 钩子层(B1/B2/B3)、C 密钥扫描、D 文本规则、E 供应链证明、
    F 覆盖率。docs/COMPARISON.md、COMPARISON.en.md、README 第八节、docs/trust.md、docs/promotion.md
    全部改用这套标记;采用规模只留量级("数千万/周""数万 star 级"),不再逐家列数字。
  • 象限图重画:docs/diagrams/src/quadrant.mmd 的四个点改成 B1/B2/B3/C;signoff-3-user*.mmd 里
    "仓库已有 husky 等钩子"改成"已装别人的钩子(B1 类安装器)"。
  • 规则写进 docs/prerequisites.md 与 docs/COMPARISON.md 开头,以后新写的对比照此办理。
    例外只留给机械标识:--engine gitleaks 这类命令行取值、.pre-commit-config.yaml 这类文件名,
    以及"怎么和已有钩子共存"的操作步骤。
  • 行为无变化:判定、退出码 0/1/2、账本格式、页面结构都没动。

English

Comparisons are anonymous from here on: peers are labelled by type (A–F), with no vendor names and no
per-peer star or download figures.

  • One label scheme across every outward-facing text: A platform, B hooks (B1/B2/B3), C secret scan, D prose rules,
    E supply chain, F coverage. docs/COMPARISON.md, COMPARISON.en.md, section 8 of the README, docs/trust.md
    and docs/promotion.md all use it; adoption is stated as a magnitude ("tens of millions/week") instead of a
    per-vendor table.
  • Redrawn quadrant: the four points in docs/diagrams/src/quadrant.mmd are now B1/B2/B3/C, and
    signoff-3-user*.mmd says "another hook layer (a B1-style installer)" instead of naming one.
  • The rule is recorded in docs/prerequisites.md and at the top of docs/COMPARISON.md; future comparisons
    follow it. The only exceptions are mechanical identifiers: CLI values such as --engine gitleaks, file names
    such as .pre-commit-config.yaml, and the how-to steps for coexisting with an existing hook.
  • No behaviour change: verdicts, exit codes, ledger format and page structure are untouched.