Repository navigation
Releases
signoff-cli 4.8.0:闸门按代价分层
闸门按代价分层,反向对照只问「会不会红」。
钩子:提交跑快检,推送跑全套
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-commitruns the p1 fast layer,pre-pushand CI run the full suite. The fast
command comes from.signoff/config.jsonorpackage.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 testruns 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.jsremains the full serial path and accepts
SIGNOFF_TIMING=1to 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 worktreeand must go red. Green on both trees isgreen-on-base; a base checkout where they cannot start
is reported ascannot-run-on-baseinstead of pretending the test proved anything. UnderSIGNOFF_NC=1the 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), andsignoff tokensanswers 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,reviewandfixnow parsegit -zinstead 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 — 声明退后,验证上前
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.ymlruns on tags withid-token: writeand
npm publish --provenance, failing hard unless the tag equals thepackage.jsonversion.
publishConfig.provenanceis on, so a bare local publish is refused. - Three new release gates:
changelog-versionandcitation-versionin--pre,git-tagin--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
NOTICEand
TRADEMARK.mdinstead;©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
@latestin CI, sha256 check
on the mcp-publisher download, read-only default token inci/signoff, plusCODEOWNERSand
dependabot. - Metadata corrected:
CITATION.cffmoves from 4.3.1 to this version,ARCH-HEALTHversion,
the pre-commit package name and rev, andaction.ymlno longer floats onlatest. - Smaller package:
!docs/diagrams/keeps 4.3MB of documentation images andtest/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 becomelatest. - 491 passed / 0 failed.
v4.6.2 — 位置重新对齐
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 — 两种语言,一条线
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.mjsadded in 4.6.0 assumed\nline endings. A Windows runner with
core.autocrlf=truechecks the repo out with CRLF, so the self-test reportedREADME.md out of syncand 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\nis 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 — 一页之内,两种说法
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.mdand sixdocs/*.mdfiles now carry the full English text (from the matching
.en.md, headings demoted, under a## Englishsection) right after the Chinese body, while the leading
English: ….en.mdpointer 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.pngis back in the gates section and the
workflow imagesignoff-4-flow.pngback in the board section, with the-en.pngtwins on the English side.
docs/diagrams/README.mdnow lists the flow and competitors images and their English twins. - License and legal:
LICENSEnamesSignOff contributorsinstead of a person; a newNOTICEstates 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.mddrops the personal mailbox in favour of the GitHub private channel. - Release and commercial model: new
docs/release-model.mdargues, 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 — 一页看全
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.mdand the newREADME.en.mdshare seven sections (start / gates / board /
integrations / anonymous comparison / limits / index);docs/gates.md,docs/integrations.mdand
docs/trust.mdwere rewritten on the same skeleton, each with an.en.mdtwin. - 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 intodocs/trust.md); the long-gonegates/*.pypaths in
gates.mdnow point atlib/p*.js. - Fixed instructions that led people astray:
SKILL.mdtaughtsignoff run, which does not exist (now
signoff guard/signoff all); the MCPsignoff_runtool forwarded tosignoff runand 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 — 叫对名字
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 --jsongains a top-levelproject, and every task group gains alabel: when the newest commit subject
in the group containsx.y.zit 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.jsonproject→package.jsonproductName/displayName/name
→ repository directory name, then strip@scope/and-cli|-app|-mcp|-server; this repo now sets
productName: "SignOff". labelis display-only:id,titleand--taskfiltering keep their meaning, and the original area name stays
intitleand in the page meta.- Contract clause C11 added;
npm test420 passed / 0 failed with four new assertions. - Verdict logic untouched.
v4.4.4 — 停住空转
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 test416 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()returnedlib\\report.json Windows whilerequiresOf()returnedlib/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 functionon 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; previouslybootstrap.js → guard.jsandcheckpoint.js → p4.jswere 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.jsonhad 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 test416 passed / 0 failed. - Verdict logic untouched.
v4.4.3 — 再收一寸
4.4.3
匿名再收紧:对比表与象限图只剩编号,能反推到具体项目的信息都删掉。
- 4.4.2 只把名字换成了 B1/B2/B3,但表里还写着"Node 钩子安装器""Python 钩子框架""Go 钩子运行器"、每家精确周下载,
象限图的点也带着同样后缀——这些足够反推出具体项目,等于没匿名。 - 现在:对比表只剩"给判决 / 留证据 / 采用量级"三列,量级只写"千万级/周以上";象限图四个点只标
B1B2B3C;
每格理由里的"单二进制""跨语言"这类实现描述一并删掉。 - 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 labelledB1B2B3C; 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 — 不留名字
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
anddocs/promotion.mdall 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.mmdare now B1/B2/B3/C, and
signoff-3-user*.mmdsays "another hook layer (a B1-style installer)" instead of naming one. - The rule is recorded in
docs/prerequisites.mdand at the top ofdocs/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.