Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

Merge main into delta provenance display and refresh package

tt-a1i438b99bc3468
diff --cc CHANGELOG.md
index 0ea76128,9fd3fb91..ca804b08
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@@ -7,7 -7,7 +7,8 @@@ All notable changes are documented here
> Development identity: `v2.17.0-dev.1`. Not a stable release.
### Fixed
+- **Architecture Delta provenance visibility.** Repository revision, provider, link-mode, and location-representation changes now produce a separate redacted provenance receipt and visible Delta notice instead of an empty authored-change claim. Provenance-only comparisons keep graph counts at zero, leave Review disabled, avoid false SVG change states, and carry the same truthful distinction into Share Cards.
+ - **Compare 输入快照一致性 (#400)。** 原始输入校验使用首次读取的字节快照,使其与回执哈希和差异计算保持一致;读取后原文件发生变化不会影响本次比较,非法原始字段仍会被拒绝。
- **DSH plugin refresh.** Adapter 0.2.0 pins the current Archify development snapshot, includes the newer runtime and CLI fixes, and targets DSH 0.1.2-rc.1. Release metadata replaces the frozen 0.1.0 packaging source; the tarball uses the canonical clean-Skill stager and documents independent plugin upgrades.
- **Machine-readable CLI argument failures (#330).** `validate --json` and `deliver --json` now keep invalid or missing option values, unknown options and diagram types, unsupported option combinations, and usage errors inside one versioned failure receipt on stdout. These failures use the `arguments` stage, stable diagnostic codes, and exit status 2, while human-mode stderr behavior remains unchanged.
- **Complete artifact-check receipts (#311).** The checker now lets stdout drain before exiting, so large JSON receipts remain complete through pipes. Validation, delivery, and architecture comparison retain their original success/failure status without truncated-JSON errors.
diff --cc archify.zip
index 6be52b5e,a44866db..243922be
Binary files differ
diff --cc docs/authoring-cookbook.zh-CN.md
index 9fb62c62,f9a24988..1b3b7296
--- a/docs/authoring-cookbook.zh-CN.md
+++ b/docs/authoring-cookbook.zh-CN.md
@@@ -95,8 -95,8 +95,10 @@@ node bin/archify.mjs compare architectu
architecture-delta.html --quality showcase --json
```
+仓库 revision、provider、链接模式或地址表达方式的变化会与组件、关系和边界变化分开报告。仅来源发生变化时,Delta 页面不会把任何图实体标为已变化,来源摘要也不会暴露仓库 URL。
+
+ `compare` 首次读取两份输入后,会使用捕获的原始字节进行校验、计算回执哈希并生成差异;之后原文件的变化不会影响本次比较。非法原始字段仍会在规范化之前被拒绝。
+
## 6. 检查最终文件
确定性校验不会在真实浏览器中运行 Viewer。如果环境有 Chrome 或 Chromium,请对刚刚交付的 HTML 收集自动化浏览器证据: