Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
fix: preserve license provenance in distributions (#265)
tt-a1i7a16d30322f5
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 30b1fc3c..01a3d26d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,6 +4,12 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo## [Unreleased]+> Development identity: `v2.17.0-dev.0`. Not a stable release.++### Fixed+- **License provenance in distributions.** Source and packaged Skill distributions retain Cocoon AI's exact MIT copyright notice, package staging and smoke tests fail closed when the notice or LICENSE is missing or altered, and the deterministic ZIP carries the same LICENSE bytes as the repository.+- **Unsupported experiment source chains.** The Hivenue and Taiga Mermaid inputs and their generated derivatives are removed from the current tree because no verifiable redistribution license was available; the retained validation evidence now reports the remaining 3-source / 9-artifact set without rewriting historical results.+## [2.16.0] — 2026-08-30### Addeddiff --git a/LICENSE b/LICENSEindex 4c27b715..0f9f9397 100644--- a/LICENSE+++ b/LICENSE@@ -1,7 +1,7 @@MIT LicenseCopyright (c) 2026 tt-a1i (Archify)-Copyright (c) 2025 Cocoon AI (original "architecture-diagram-generator")+Copyright (c) 2025 Cocoon AIPermission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealdiff --git a/README.md b/README.mdindex ffbb93e6..c4e24ae1 100644--- a/README.md+++ b/README.md@@ -21,9 +21,9 @@ Archify is a Node.js rendering and validation system for Cursor, Claude Code, Co-+-**Current stable version:** `v2.16.0`. See [Changelog](CHANGELOG.md#2160--2026-08-30).+**Current development version:** `v2.17.0-dev.0`. See [Changelog](CHANGELOG.md#unreleased).**[Project page](https://tt-a1i.github.io/archify/)** · **[Scenario guide](https://tt-a1i.github.io/archify/guide.html)** · **[Proof Lab](https://tt-a1i.github.io/archify/gallery.html)**diff --git a/README_EN.md b/README_EN.mdindex ffbb93e6..c4e24ae1 100644--- a/README_EN.md+++ b/README_EN.md@@ -21,9 +21,9 @@ Archify is a Node.js rendering and validation system for Cursor, Claude Code, Co-+-**Current stable version:** `v2.16.0`. See [Changelog](CHANGELOG.md#2160--2026-08-30).+**Current development version:** `v2.17.0-dev.0`. See [Changelog](CHANGELOG.md#unreleased).**[Project page](https://tt-a1i.github.io/archify/)** · **[Scenario guide](https://tt-a1i.github.io/archify/guide.html)** · **[Proof Lab](https://tt-a1i.github.io/archify/gallery.html)**diff --git a/README_ZH.md b/README_ZH.mdindex 1676447e..9511bb8e 100644--- a/README_ZH.md+++ b/README_ZH.md@@ -17,9 +17,9 @@ Archify 是一套基于 Node.js 的渲染与校验系统,并以 Agent Skill-+-**当前稳定版本:** `v2.16.0`。详见[版本历史](CHANGELOG.md#2160--2026-08-30)。+**当前开发版本:** `v2.17.0-dev.0`。详见[版本历史](CHANGELOG.md#unreleased)。**[在线项目页](https://tt-a1i.github.io/archify/)** · **[场景选图指南](https://tt-a1i.github.io/archify/guide.html)** · **[Proof Lab](https://tt-a1i.github.io/archify/gallery.html)**diff --git a/ROADMAP.md b/ROADMAP.mdindex 2c4a53a1..8d247a6e 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -1,6 +1,6 @@# Archify Roadmap-The current stable version is `v2.16.0`. [CHANGELOG.md](CHANGELOG.md) is the single owner for delivered feature history. This file owns architectural direction, retained rationale, and explicitly declined ideas.+The current development line is `v2.17.0-dev.0`; it contains the work under Changelog Unreleased and is not a stable release. [CHANGELOG.md](CHANGELOG.md) is the single owner for delivered feature history. This file owns architectural direction, retained rationale, and explicitly declined ideas.<details><summary>Archived delivered-slice context (frozen; no longer maintained as a second changelog)</summary>@@ -160,7 +160,7 @@ Architecture diagrams use a free-coordinate component graph. The typed modes use| Phase | Deliverable | Target ||---|---|---|-| ~~**Validate**~~ | ~~5-Mermaid blind-rate experiment~~ | **DONE — FAILED** (see below) |+| ~~**Validate**~~ | ~~Original 5-Mermaid blind-rate experiment; 3 licensed inputs retained~~ | **DONE — FAILED** (see below) || **P0** | JSON IR + JSON Schema validator + `schema_version` enforcement | **DONE** — shipped for architecture, workflow, sequence, dataflow, and lifecycle, enforced at runtime via ajv || **P0.5** | Pure-JS renderers take IR → HTML using the existing template. Coordinates required (no auto-layout). | **DONE** — architecture, workflow, sequence, data-flow, and lifecycle renderers ship in `archify/renderers/` || ~~**P1**~~ | ~~Mermaid flowchart parser → IR~~ | **KILLED** — experiment showed auto-layout + CSS is not enough |@@ -170,7 +170,7 @@ Architecture diagrams use a free-coordinate component graph. The typed modes use### Validation experiment — FAILED (2026-04-16)-The experiment tested whether auto-layout (dagre) + archify CSS (version B) looked meaningfully better than stock Mermaid (version A). 5 real-world Mermaid flowcharts were rendered in three versions (A/B/C), randomized, and blind-rated by the project owner.+The experiment tested whether auto-layout (dagre) + archify CSS (version B) looked meaningfully better than stock Mermaid (version A). The original run rendered five real-world Mermaid flowcharts in three versions (A/B/C), randomized them, and had the project owner blind-rate them. On 2026-09-01, two inputs and their derivatives were removed because their repositories did not provide verifiable redistribution licenses; the current tree retains three inputs and nine screenshots, so the original five-input run is no longer fully reproducible from HEAD.**Result:** Owner rated C (archify hand-placed) as good-looking; A and B as both not good-looking. B was not meaningfully better than A. Both pass criteria failed. Full data in `experiments/v3-mermaid-validation/RESULT.md`.diff --git a/archify.zip b/archify.zipindex 55b3bbea..cfb97a10 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/LICENSE b/archify/LICENSEindex 4c27b715..0f9f9397 100644--- a/archify/LICENSE+++ b/archify/LICENSE@@ -1,7 +1,7 @@MIT LicenseCopyright (c) 2026 tt-a1i (Archify)-Copyright (c) 2025 Cocoon AI (original "architecture-diagram-generator")+Copyright (c) 2025 Cocoon AIPermission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealdiff --git a/archify/SKILL.md b/archify/SKILL.mdindex 7ce2b3fc..4011ba54 100644--- a/archify/SKILL.md+++ b/archify/SKILL.md@@ -3,7 +3,7 @@ name: archifydescription: Create polished, validated architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as explorable standalone HTML with inline SVG, dark/light themes, optional trace motion, and PNG/JPEG/WebP/SVG/WebM export. Accept plain-language requirements or pasted Mermaid flowchart, sequenceDiagram, and stateDiagram input; inspect repository evidence when the diagram must reflect real code. Use when the user asks to visualize system architecture, infrastructure, cloud/security/network topology, technical workflows, API call sequences, request lifecycles, data pipelines, ETL/ELT, data lineage, state machines, or to convert/beautify Mermaid.license: MITmetadata:- version: "2.16"+ version: "2.17"author: tt-a1ibased_on: Cocoon-AI/architecture-diagram-generator (MIT, v1.0)---diff --git a/archify/assets/template.html b/archify/assets/template.htmlindex a3fd8cb5..11c5d716 100644--- a/archify/assets/template.html+++ b/archify/assets/template.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>[PROJECT NAME] Architecture Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/examples/dataflow-product-analytics.html b/archify/examples/dataflow-product-analytics.htmlindex 01ddabca..e382cdab 100644--- a/archify/examples/dataflow-product-analytics.html+++ b/archify/examples/dataflow-product-analytics.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Product Analytics Data Flow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/examples/lifecycle-agent-run.html b/archify/examples/lifecycle-agent-run.htmlindex db481754..d98ca626 100644--- a/archify/examples/lifecycle-agent-run.html+++ b/archify/examples/lifecycle-agent-run.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Agent Run Lifecycle Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/examples/sequence-cache-miss-request.html b/archify/examples/sequence-cache-miss-request.htmlindex 6c91f299..338c9d48 100644--- a/archify/examples/sequence-cache-miss-request.html+++ b/archify/examples/sequence-cache-miss-request.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Cache Miss Request Sequence Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/examples/web-app-rendered.html b/archify/examples/web-app-rendered.htmlindex c4c1eb1c..e4ee520b 100644--- a/archify/examples/web-app-rendered.html+++ b/archify/examples/web-app-rendered.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Sample Web App Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/examples/workflow-agent-tool-call-rendered.html b/archify/examples/workflow-agent-tool-call-rendered.htmlindex 0f4842f9..b4ed8b9f 100644--- a/archify/examples/workflow-agent-tool-call-rendered.html+++ b/archify/examples/workflow-agent-tool-call-rendered.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Agent Tool Call Workflow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/package-lock.json b/archify/package-lock.jsonindex fe4d05f9..1de671d2 100644--- a/archify/package-lock.json+++ b/archify/package-lock.json@@ -1,12 +1,12 @@{"name": "archify",- "version": "2.16.0",+ "version": "2.17.0-dev.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "archify",- "version": "2.16.0",+ "version": "2.17.0-dev.0","license": "MIT","bin": {"archify": "bin/archify.mjs"diff --git a/archify/package.json b/archify/package.jsonindex f727bdb1..445de6d2 100644--- a/archify/package.json+++ b/archify/package.json@@ -1,6 +1,6 @@{"name": "archify",- "version": "2.16.0",+ "version": "2.17.0-dev.0","private": true,"type": "module","description": "JSON-IR diagram renderers (architecture / workflow / sequence / dataflow / lifecycle).",diff --git a/archify/skill-release.json b/archify/skill-release.jsonindex bcaa0771..5f9dfb01 100644--- a/archify/skill-release.json+++ b/archify/skill-release.json@@ -1,8 +1,8 @@{"schemaVersion": 1,"skillId": "archify",- "channel": "stable",- "version": "2.16.0",+ "channel": "development",+ "version": "2.17.0-dev.0","source": {"repository": "https://github.com/tt-a1i/archify"},diff --git a/archify/test/clean-skill-staging.test.mjs b/archify/test/clean-skill-staging.test.mjsindex c7d7f84d..2cc6bcb6 100644--- a/archify/test/clean-skill-staging.test.mjs+++ b/archify/test/clean-skill-staging.test.mjs@@ -25,6 +25,7 @@ function write(root, relative, content, mode = null) {function repositoryFixture() {const root = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-clean-stage-'));+ write(root, 'archify/LICENSE', 'MIT License\n');write(root, 'archify/package.json', JSON.stringify({name: 'archify-fixture',scripts: { test: 'node --test' },diff --git a/archify/test/release-package-gates.test.mjs b/archify/test/release-package-gates.test.mjsindex f84838d1..e554cb9a 100644--- a/archify/test/release-package-gates.test.mjs+++ b/archify/test/release-package-gates.test.mjs@@ -248,6 +248,40 @@ test('package smoke verifies the embedded notifier identity and local disable swassert.match(source, /reason !== 'disabled'/);});+test('package smoke rejects a missing or modified distribution license', () => {+ const packageSmoke = path.join(repoRoot, 'scripts', 'package-smoke.mjs');+ const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-package-license-gate-'));+ try {+ const staged = path.join(fixture, 'archify');+ stageCleanSkill({ repoRoot, destination: staged });+ const licensePath = path.join(staged, 'LICENSE');++ fs.rmSync(licensePath);+ let result = spawnSync(process.execPath, [packageSmoke, staged], { encoding: 'utf8' });+ assert.notEqual(result.status, 0, 'missing LICENSE must fail package smoke');+ assert.match(`${result.stdout}\n${result.stderr}`, /packaged skill is missing LICENSE/);++ const repositoryLicense = fs.readFileSync(path.join(repoRoot, 'LICENSE'), 'utf8');+ fs.writeFileSync(+ licensePath,+ repositoryLicense.replace(+ 'Copyright (c) 2025 Cocoon AI',+ 'Copyright (c) 2025 Cocoon AI (original "architecture-diagram-generator")',+ ),+ );+ result = spawnSync(process.execPath, [packageSmoke, staged], { encoding: 'utf8' });+ assert.notEqual(result.status, 0, 'modified upstream notice must fail package smoke');+ assert.match(`${result.stdout}\n${result.stderr}`, /missing the exact Cocoon AI copyright line/);++ fs.writeFileSync(licensePath, 'Copyright (c) 2025 Cocoon AI\n');+ result = spawnSync(process.execPath, [packageSmoke, staged], { encoding: 'utf8' });+ assert.notEqual(result.status, 0, 'truncated LICENSE must fail package smoke');+ assert.match(`${result.stdout}\n${result.stderr}`, /must byte-match the repository LICENSE/);+ } finally {+ fs.rmSync(fixture, { recursive: true, force: true });+ }+});+test('package smoke increments an arbitrary-precision SemVer patch without Number coercion', () => {const scratch = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-package-bigint-version-'));const skillRoot = path.join(scratch, 'archify');@@ -274,10 +308,11 @@ test('package smoke increments an arbitrary-precision SemVer patch without Numbe}});-test('archive build refuses to silently omit required notifier files', () => {+test('archive build refuses to silently omit required release files', () => {const buildSource = fs.readFileSync(path.join(repoRoot, 'scripts', 'build-zip.sh'), 'utf8');const stageSource = fs.readFileSync(path.join(repoRoot, 'scripts', 'stage-clean-skill.mjs'), 'utf8');assert.match(buildSource, /stage-clean-skill\.mjs/);+ assert.match(stageSource, /archify\/LICENSE/);assert.match(stageSource, /archify\/skill-release\.json/);assert.match(stageSource, /archify\/scripts\/check-update\.mjs/);assert.match(stageSource, /archify\/scripts\/update-contract\.mjs/);diff --git a/docs/article-archify.md b/docs/article-archify.mdindex ecf6c376..5a0159fa 100644--- a/docs/article-archify.md+++ b/docs/article-archify.md@@ -35,13 +35,13 @@ Archify 的 Roadmap 里有一段不常出现在开源项目中的文字:为了验证这个判断,作者做了一个盲测实验。-五张真实 Mermaid 流程图,每张渲染三个版本:+原始实验用了五张真实 Mermaid 流程图,每张渲染三个版本:- **版本 A**:原生 Mermaid,dagre 布局,默认主题。- **版本 B**:同样 dagre 布局,但换上 archify 的深色配色、JetBrains Mono 字体、slate-900 背景。布局不动——只换皮。- **版本 C**:archify 手动布局——Claude 分配语义类(`c-frontend`、`c-backend`、`c-security` 等),手动摆放坐标,archify CSS 是最后一步。-15 张截图打乱、去标签,盲评 1-10 分。+原始 15 张截图打乱、去标签,盲评 1-10 分。2026-09-01 因其中两个来源仓库没有可核验的再分发许可,当前仓库已移除这两组输入和衍生物,仅保留 3 图、9 张截图;因此原始 5 图实验无法再从当前 HEAD 完整复现。结论写在 `experiments/v3-mermaid-validation/RESULT.md` 里,只一行:diff --git a/docs/assets/archify-live-proof.gif b/docs/assets/archify-live-proof.gifindex cc4b548c..4528cb7d 100644Binary files a/docs/assets/archify-live-proof.gif and b/docs/assets/archify-live-proof.gif differdiff --git a/docs/assets/archify-live-proof.json b/docs/assets/archify-live-proof.jsonindex b2a1627f..1e8fbee8 100644--- a/docs/assets/archify-live-proof.json+++ b/docs/assets/archify-live-proof.json@@ -7,13 +7,13 @@"fps": 10,"frameCount": 54,"durationSeconds": 5.4,- "bytes": 1592110,- "sha256": "5e62f72b2116d0f77f4ee4d6f255b1896876ec88a1c08d8d5cb29bd98e929d5e",+ "bytes": 1576470,+ "sha256": "27978667316724012006e50755e17a2566419019483f76c4cc394766fa308cd6","scenes": [{"id": "signal-flow","artifact": "docs/gallery/artifacts/agent-tool-call.workflow.html",- "artifactSha256": "325680d835f68cb04089bb5d3fdd1b5671abf1790a15fbcae2167dbe6e756f0b",+ "artifactSha256": "3222bddc0bcbf348203d35f223c62f470f9a4d39faa2cb36d12edad573f0eef4","view": "happy-path","eyebrow": "WORKFLOW · SIGNAL FLOW","title": "Agent Tool Call",@@ -22,7 +22,7 @@{"id": "blueprint","artifact": "docs/gallery/artifacts/production-deployment.architecture.html",- "artifactSha256": "547c27a1c2d53314c2948690a973f3b259bb6a0ec4e25755916681ca533a2d51",+ "artifactSha256": "ba819b3b53dc05b6bee4bdb2dfc98029942601dc463c695f515d62768883dfc1","view": "request-boundary","eyebrow": "ARCHITECTURE · BLUEPRINT","title": "Production Deployment",@@ -31,7 +31,7 @@{"id": "classic","artifact": "docs/gallery/artifacts/cache-miss.sequence.html",- "artifactSha256": "951f07c29b75138566808e40f0ed251145d2c0bdc228dd5e3ecb98387d9d4dfa",+ "artifactSha256": "a576c9f464037267cdae651aa5c44f96a07111357d37ab21d305a33d1c07b116","view": "cache-fallback","eyebrow": "SEQUENCE · CLASSIC","title": "Cache Miss Request",diff --git a/docs/cases/mco-runtime.architecture.html b/docs/cases/mco-runtime.architecture.htmlindex 1b826f5b..0be9c479 100644--- a/docs/cases/mco-runtime.architecture.html+++ b/docs/cases/mco-runtime.architecture.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>MCO Runtime Architecture Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery.html b/docs/gallery.htmlindex 4d8bd854..e378c6aa 100644--- a/docs/gallery.html+++ b/docs/gallery.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify gallery 2.16.0">+ <meta name="generator" content="archify gallery 2.17.0-dev.0"><title>Archify Proof Lab — Generated Diagram Gallery</title><meta name="description" content="A generated gallery of validated, self-contained Archify diagrams. Every preview links to its exact JSON source and interactive HTML artifact."><meta name="theme-color" content="#eff2f1">@@ -298,7 +298,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 11E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="325680d835f68cb04089bb5d3fdd1b5671abf1790a15fbcae2167dbe6e756f0b">325680d835f6</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="3222bddc0bcbf348203d35f223c62f470f9a4d39faa2cb36d12edad573f0eef4">3222bddc0bcb</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/agent-tool-call.workflow.html?present=1&play=1#view=happy-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -328,7 +328,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 12E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="547c27a1c2d53314c2948690a973f3b259bb6a0ec4e25755916681ca533a2d51">547c27a1c2d5</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="ba819b3b53dc05b6bee4bdb2dfc98029942601dc463c695f515d62768883dfc1">ba819b3b53dc</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/production-deployment.architecture.html?present=1&play=1#view=request-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -357,7 +357,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">7N · 12E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="951f07c29b75138566808e40f0ed251145d2c0bdc228dd5e3ecb98387d9d4dfa">951f07c29b75</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="a576c9f464037267cdae651aa5c44f96a07111357d37ab21d305a33d1c07b116">a576c9f46403</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/cache-miss.sequence.html?present=1&play=1#view=cache-fallback" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -386,7 +386,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 10E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="f3e4fa7d0250b3d39a11a7b862d2b422691978bd3ef287d0ee565ce55a1af187">f3e4fa7d0250</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="ba3e605376074b0a995ac488e21182db075e7e0bac82f2741c5848aa413b6a2e">ba3e60537607</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/release-delivery.workflow.html?present=1&play=1#view=approval-to-production" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -415,7 +415,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">11N · 10E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="c4e58c04598281bbc40c4ebd6b3d671178ee87163d1e243c7e57589eddbd043c">c4e58c045982</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="6be408ea7ff522e00f955a01d6dbf0907565c01cf1bf2c72b10ab0de738e6a1c">6be408ea7ff5</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/incident-response.workflow.html?present=1&play=1#view=mitigate-and-verify" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -444,7 +444,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 10E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="522aa268f25a8132ec43e75b6297a548b9779d6ef76c4d7acd724f7d3ee07dc7">522aa268f25a</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="3135f04797ba721b0d1a29ac2f6218e5662b3ab78a9fbbd064710cda8687ca21">3135f04797ba</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/product-analytics.dataflow.html?present=1&play=1#view=consent-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -473,7 +473,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">7N · 14E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="9b84690a9aa5f0a2911504070038aeb5b7521f6a072e2dfc73fe2b5bf00f6b20">9b84690a9aa5</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="b6486afeabcc1e646dda61fc4ea514b2543d2b800787e2febea4a344c1603e38">b6486afeabcc</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/async-job-roundtrip.sequence.html?present=1&play=1#view=work-and-retry" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -502,7 +502,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">12N · 12E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="e97d2b573072ce84575c8bd6cf79068d90a5f192fcddad9735bc250a35aa92cd">e97d2b573072</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="90ed7007685c7f47f07d07a71878f4d3af29451ec50f37d79996d1ff70503570">90ed7007685c</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/event-stream.dataflow.html?present=1&play=1#view=order-transit" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -531,7 +531,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 6E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="9e3bbe37fbc36a477ed48bdfb40e19da422d22ac6dd63e6067d749a622122094">9e3bbe37fbc3</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="331d74948038f7d6b3194714c322442daf82a384b5b23f9dfe11663dcbe7d443">331d74948038</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/agent-run.lifecycle.html?present=1&play=1#view=main-lifecycle" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -560,7 +560,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">11N · 6E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="8278f33c028b9dfdddf6d04501c6c9b7d905ecd95ab45d20a58bee8d748cba37">8278f33c028b</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="8f8843346af796e8f311b74ece37be4bce7872f91d2daf73aaeb353bc8762624">8f8843346af7</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/deployment-release.lifecycle.html?present=1&play=1#view=rollback-outcomes" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -589,7 +589,7 @@<div class="receipt-cell"><span class="receipt-label">Artifact</span><span class="receipt-value ok">9/9 pass</span></div><div class="receipt-cell"><span class="receipt-label">Composition</span><span class="receipt-value ok" title="0 crossings · 0 border runs · 0 micro segments · 0 cramped turns">SHOWCASE · PASS</span></div><div class="receipt-cell"><span class="receipt-label">Graph</span><span class="receipt-value">10N · 9E</span></div>- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="d2ace03a19456e1ba1e24ed5ec2ef8de495190cbf1f59d54ab9d138d460a5ab8">d2ace03a1945</span></div>+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="620e0d5983a5739b297a0bdd9442caca83876d715e15b2041bfa0ba33026b212">620e0d5983a5</span></div></div><div class="card-actions"><a class="card-link primary" href="gallery/artifacts/web-app.architecture.html?present=1&play=1#view=request-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>@@ -642,14 +642,14 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre><footer><div class="shell footer-inner"><span data-en="Generated from Archify's checked-in examples. No hand-authored capability claims." data-zh="由 Archify 仓库内示例自动生成,不手写可能过期的能力声明。">Generated from Archify's checked-in examples. No hand-authored capability claims.</span>- <span data-en="Archify v2.16.0 · stable · MIT" data-zh="Archify v2.16.0 · 稳定版 · MIT">Archify v2.16.0 · stable · MIT</span>+ <span data-en="Archify v2.17.0-dev.0 · development · MIT" data-zh="Archify v2.17.0-dev.0 · 开发版 · MIT">Archify v2.17.0-dev.0 · development · MIT</span></div></footer><script id="gallery-manifest" type="application/json">{"schemaVersion": 1,"generator": "scripts/build-gallery.mjs",- "archifyVersion": "2.16.0",+ "archifyVersion": "2.17.0-dev.0","entryCount": 11,"checkCount": 99,"entries": [@@ -675,8 +675,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 12,"edgeCount": 11,- "artifactBytes": 723032,- "artifactSha256": "325680d835f68cb04089bb5d3fdd1b5671abf1790a15fbcae2167dbe6e756f0b",+ "artifactBytes": 723038,+ "artifactSha256": "3222bddc0bcbf348203d35f223c62f470f9a4d39faa2cb36d12edad573f0eef4","sourceBytes": 5687,"sourceSha256": "4d3f6c23de2ca7d306e05d0041a9506833bb5a164a2bddc2d1984cf4da3ee90c","checks": [@@ -775,8 +775,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": "deployment-ownership","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 724866,- "artifactSha256": "547c27a1c2d53314c2948690a973f3b259bb6a0ec4e25755916681ca533a2d51",+ "artifactBytes": 724872,+ "artifactSha256": "ba819b3b53dc05b6bee4bdb2dfc98029942601dc463c695f515d62768883dfc1","sourceBytes": 5476,"sourceSha256": "ec484aa8576664fdb207b543fa49486b23273faccb7a5071e1a0becfb48c22eb","checks": [@@ -875,8 +875,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 7,"edgeCount": 12,- "artifactBytes": 716836,- "artifactSha256": "951f07c29b75138566808e40f0ed251145d2c0bdc228dd5e3ecb98387d9d4dfa",+ "artifactBytes": 716842,+ "artifactSha256": "a576c9f464037267cdae651aa5c44f96a07111357d37ab21d305a33d1c07b116","sourceBytes": 4345,"sourceSha256": "4bbaa6ca3cd4036002fd5d0f3a332eb922cec69d09bac3d7925f95beb4308389","checks": [@@ -975,8 +975,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 719232,- "artifactSha256": "f3e4fa7d0250b3d39a11a7b862d2b422691978bd3ef287d0ee565ce55a1af187",+ "artifactBytes": 719238,+ "artifactSha256": "ba3e605376074b0a995ac488e21182db075e7e0bac82f2741c5848aa413b6a2e","sourceBytes": 5164,"sourceSha256": "e5c880417eac1623923c3dd5461e0c78acd762e1621a28bd53fc14a84cad6a91","checks": [@@ -1075,8 +1075,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 11,"edgeCount": 10,- "artifactBytes": 716561,- "artifactSha256": "c4e58c04598281bbc40c4ebd6b3d671178ee87163d1e243c7e57589eddbd043c",+ "artifactBytes": 716567,+ "artifactSha256": "6be408ea7ff522e00f955a01d6dbf0907565c01cf1bf2c72b10ab0de738e6a1c","sourceBytes": 5375,"sourceSha256": "5c760c82eee545dfb7da38a4e628059d7891af4cfbfc13c8a7009ea64f69aa1b","checks": [@@ -1175,8 +1175,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 720490,- "artifactSha256": "522aa268f25a8132ec43e75b6297a548b9779d6ef76c4d7acd724f7d3ee07dc7",+ "artifactBytes": 720496,+ "artifactSha256": "3135f04797ba721b0d1a29ac2f6218e5662b3ab78a9fbbd064710cda8687ca21","sourceBytes": 5627,"sourceSha256": "6fa38a7ccedf96da592d60b392783b846188eaa3ec9136c6dc06ca020e43a110","checks": [@@ -1275,8 +1275,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 7,"edgeCount": 14,- "artifactBytes": 717246,- "artifactSha256": "9b84690a9aa5f0a2911504070038aeb5b7521f6a072e2dfc73fe2b5bf00f6b20",+ "artifactBytes": 717252,+ "artifactSha256": "b6486afeabcc1e646dda61fc4ea514b2543d2b800787e2febea4a344c1603e38","sourceBytes": 4370,"sourceSha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9","checks": [@@ -1375,8 +1375,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 12,"edgeCount": 12,- "artifactBytes": 724453,- "artifactSha256": "e97d2b573072ce84575c8bd6cf79068d90a5f192fcddad9735bc250a35aa92cd",+ "artifactBytes": 724459,+ "artifactSha256": "90ed7007685c7f47f07d07a71878f4d3af29451ec50f37d79996d1ff70503570","sourceBytes": 5433,"sourceSha256": "a92d6597ddbe164f395da32a7d4b33cfae08edd7d9600a6fb45a2058e5bbb43e","checks": [@@ -1475,8 +1475,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 6,- "artifactBytes": 714125,- "artifactSha256": "9e3bbe37fbc36a477ed48bdfb40e19da422d22ac6dd63e6067d749a622122094",+ "artifactBytes": 714131,+ "artifactSha256": "331d74948038f7d6b3194714c322442daf82a384b5b23f9dfe11663dcbe7d443","sourceBytes": 4417,"sourceSha256": "af939579dcafc8b4c49f09594591577994398aee57a57369d4c791dfc0d85a42","checks": [@@ -1575,8 +1575,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 11,"edgeCount": 6,- "artifactBytes": 715117,- "artifactSha256": "8278f33c028b9dfdddf6d04501c6c9b7d905ecd95ab45d20a58bee8d748cba37",+ "artifactBytes": 715123,+ "artifactSha256": "8f8843346af796e8f311b74ece37be4bce7872f91d2daf73aaeb353bc8762624","sourceBytes": 4274,"sourceSha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71","checks": [@@ -1675,8 +1675,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>"engineeringProfile": null,"nodeCount": 10,"edgeCount": 9,- "artifactBytes": 715210,- "artifactSha256": "d2ace03a19456e1ba1e24ed5ec2ef8de495190cbf1f59d54ab9d138d460a5ab8",+ "artifactBytes": 715216,+ "artifactSha256": "620e0d5983a5739b297a0bdd9442caca83876d715e15b2041bfa0ba33026b212","sourceBytes": 3793,"sourceSha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf","checks": [diff --git a/docs/gallery/artifacts/agent-run.lifecycle.html b/docs/gallery/artifacts/agent-run.lifecycle.htmlindex db481754..d98ca626 100644--- a/docs/gallery/artifacts/agent-run.lifecycle.html+++ b/docs/gallery/artifacts/agent-run.lifecycle.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Agent Run Lifecycle Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/agent-tool-call.workflow.html b/docs/gallery/artifacts/agent-tool-call.workflow.htmlindex 0f4842f9..b4ed8b9f 100644--- a/docs/gallery/artifacts/agent-tool-call.workflow.html+++ b/docs/gallery/artifacts/agent-tool-call.workflow.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Agent Tool Call Workflow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/async-job-roundtrip.sequence.html b/docs/gallery/artifacts/async-job-roundtrip.sequence.htmlindex d488c8ad..4193f382 100644--- a/docs/gallery/artifacts/async-job-roundtrip.sequence.html+++ b/docs/gallery/artifacts/async-job-roundtrip.sequence.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Async Job Roundtrip Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/cache-miss.sequence.html b/docs/gallery/artifacts/cache-miss.sequence.htmlindex 6c91f299..338c9d48 100644--- a/docs/gallery/artifacts/cache-miss.sequence.html+++ b/docs/gallery/artifacts/cache-miss.sequence.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Cache Miss Request Sequence Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/deployment-release.lifecycle.html b/docs/gallery/artifacts/deployment-release.lifecycle.htmlindex 1d0f0535..6d742e0f 100644--- a/docs/gallery/artifacts/deployment-release.lifecycle.html+++ b/docs/gallery/artifacts/deployment-release.lifecycle.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Deployment Release Lifecycle Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/event-stream.dataflow.html b/docs/gallery/artifacts/event-stream.dataflow.htmlindex b39abfa7..586b6c0f 100644--- a/docs/gallery/artifacts/event-stream.dataflow.html+++ b/docs/gallery/artifacts/event-stream.dataflow.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Order Event-stream Topology Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/incident-response.workflow.html b/docs/gallery/artifacts/incident-response.workflow.htmlindex b4e2e93d..18f3cdd1 100644--- a/docs/gallery/artifacts/incident-response.workflow.html+++ b/docs/gallery/artifacts/incident-response.workflow.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Incident Response Runbook Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/product-analytics.dataflow.html b/docs/gallery/artifacts/product-analytics.dataflow.htmlindex 01ddabca..e382cdab 100644--- a/docs/gallery/artifacts/product-analytics.dataflow.html+++ b/docs/gallery/artifacts/product-analytics.dataflow.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Product Analytics Data Flow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/production-deployment.architecture.html b/docs/gallery/artifacts/production-deployment.architecture.htmlindex 8ab3164a..00daaa3a 100644--- a/docs/gallery/artifacts/production-deployment.architecture.html+++ b/docs/gallery/artifacts/production-deployment.architecture.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Production Deployment Ownership Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/release-delivery.workflow.html b/docs/gallery/artifacts/release-delivery.workflow.htmlindex 38ceec90..8de471d8 100644--- a/docs/gallery/artifacts/release-delivery.workflow.html+++ b/docs/gallery/artifacts/release-delivery.workflow.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Release Delivery Workflow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/artifacts/web-app.architecture.html b/docs/gallery/artifacts/web-app.architecture.htmlindex c4c1eb1c..e4ee520b 100644--- a/docs/gallery/artifacts/web-app.architecture.html+++ b/docs/gallery/artifacts/web-app.architecture.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Sample Web App Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/docs/gallery/manifest.json b/docs/gallery/manifest.jsonindex 479a1d53..479a2a59 100644--- a/docs/gallery/manifest.json+++ b/docs/gallery/manifest.json@@ -1,7 +1,7 @@{"schemaVersion": 1,"generator": "scripts/build-gallery.mjs",- "archifyVersion": "2.16.0",+ "archifyVersion": "2.17.0-dev.0","entryCount": 11,"checkCount": 99,"entries": [@@ -27,8 +27,8 @@"engineeringProfile": null,"nodeCount": 12,"edgeCount": 11,- "artifactBytes": 723032,- "artifactSha256": "325680d835f68cb04089bb5d3fdd1b5671abf1790a15fbcae2167dbe6e756f0b",+ "artifactBytes": 723038,+ "artifactSha256": "3222bddc0bcbf348203d35f223c62f470f9a4d39faa2cb36d12edad573f0eef4","sourceBytes": 5687,"sourceSha256": "4d3f6c23de2ca7d306e05d0041a9506833bb5a164a2bddc2d1984cf4da3ee90c","checks": [@@ -127,8 +127,8 @@"engineeringProfile": "deployment-ownership","nodeCount": 12,"edgeCount": 12,- "artifactBytes": 724866,- "artifactSha256": "547c27a1c2d53314c2948690a973f3b259bb6a0ec4e25755916681ca533a2d51",+ "artifactBytes": 724872,+ "artifactSha256": "ba819b3b53dc05b6bee4bdb2dfc98029942601dc463c695f515d62768883dfc1","sourceBytes": 5476,"sourceSha256": "ec484aa8576664fdb207b543fa49486b23273faccb7a5071e1a0becfb48c22eb","checks": [@@ -227,8 +227,8 @@"engineeringProfile": null,"nodeCount": 7,"edgeCount": 12,- "artifactBytes": 716836,- "artifactSha256": "951f07c29b75138566808e40f0ed251145d2c0bdc228dd5e3ecb98387d9d4dfa",+ "artifactBytes": 716842,+ "artifactSha256": "a576c9f464037267cdae651aa5c44f96a07111357d37ab21d305a33d1c07b116","sourceBytes": 4345,"sourceSha256": "4bbaa6ca3cd4036002fd5d0f3a332eb922cec69d09bac3d7925f95beb4308389","checks": [@@ -327,8 +327,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 719232,- "artifactSha256": "f3e4fa7d0250b3d39a11a7b862d2b422691978bd3ef287d0ee565ce55a1af187",+ "artifactBytes": 719238,+ "artifactSha256": "ba3e605376074b0a995ac488e21182db075e7e0bac82f2741c5848aa413b6a2e","sourceBytes": 5164,"sourceSha256": "e5c880417eac1623923c3dd5461e0c78acd762e1621a28bd53fc14a84cad6a91","checks": [@@ -427,8 +427,8 @@"engineeringProfile": null,"nodeCount": 11,"edgeCount": 10,- "artifactBytes": 716561,- "artifactSha256": "c4e58c04598281bbc40c4ebd6b3d671178ee87163d1e243c7e57589eddbd043c",+ "artifactBytes": 716567,+ "artifactSha256": "6be408ea7ff522e00f955a01d6dbf0907565c01cf1bf2c72b10ab0de738e6a1c","sourceBytes": 5375,"sourceSha256": "5c760c82eee545dfb7da38a4e628059d7891af4cfbfc13c8a7009ea64f69aa1b","checks": [@@ -527,8 +527,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 10,- "artifactBytes": 720490,- "artifactSha256": "522aa268f25a8132ec43e75b6297a548b9779d6ef76c4d7acd724f7d3ee07dc7",+ "artifactBytes": 720496,+ "artifactSha256": "3135f04797ba721b0d1a29ac2f6218e5662b3ab78a9fbbd064710cda8687ca21","sourceBytes": 5627,"sourceSha256": "6fa38a7ccedf96da592d60b392783b846188eaa3ec9136c6dc06ca020e43a110","checks": [@@ -627,8 +627,8 @@"engineeringProfile": null,"nodeCount": 7,"edgeCount": 14,- "artifactBytes": 717246,- "artifactSha256": "9b84690a9aa5f0a2911504070038aeb5b7521f6a072e2dfc73fe2b5bf00f6b20",+ "artifactBytes": 717252,+ "artifactSha256": "b6486afeabcc1e646dda61fc4ea514b2543d2b800787e2febea4a344c1603e38","sourceBytes": 4370,"sourceSha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9","checks": [@@ -727,8 +727,8 @@"engineeringProfile": null,"nodeCount": 12,"edgeCount": 12,- "artifactBytes": 724453,- "artifactSha256": "e97d2b573072ce84575c8bd6cf79068d90a5f192fcddad9735bc250a35aa92cd",+ "artifactBytes": 724459,+ "artifactSha256": "90ed7007685c7f47f07d07a71878f4d3af29451ec50f37d79996d1ff70503570","sourceBytes": 5433,"sourceSha256": "a92d6597ddbe164f395da32a7d4b33cfae08edd7d9600a6fb45a2058e5bbb43e","checks": [@@ -827,8 +827,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 6,- "artifactBytes": 714125,- "artifactSha256": "9e3bbe37fbc36a477ed48bdfb40e19da422d22ac6dd63e6067d749a622122094",+ "artifactBytes": 714131,+ "artifactSha256": "331d74948038f7d6b3194714c322442daf82a384b5b23f9dfe11663dcbe7d443","sourceBytes": 4417,"sourceSha256": "af939579dcafc8b4c49f09594591577994398aee57a57369d4c791dfc0d85a42","checks": [@@ -927,8 +927,8 @@"engineeringProfile": null,"nodeCount": 11,"edgeCount": 6,- "artifactBytes": 715117,- "artifactSha256": "8278f33c028b9dfdddf6d04501c6c9b7d905ecd95ab45d20a58bee8d748cba37",+ "artifactBytes": 715123,+ "artifactSha256": "8f8843346af796e8f311b74ece37be4bce7872f91d2daf73aaeb353bc8762624","sourceBytes": 4274,"sourceSha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71","checks": [@@ -1027,8 +1027,8 @@"engineeringProfile": null,"nodeCount": 10,"edgeCount": 9,- "artifactBytes": 715210,- "artifactSha256": "d2ace03a19456e1ba1e24ed5ec2ef8de495190cbf1f59d54ab9d138d460a5ab8",+ "artifactBytes": 715216,+ "artifactSha256": "620e0d5983a5739b297a0bdd9442caca83876d715e15b2041bfa0ba33026b212","sourceBytes": 3793,"sourceSha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf","checks": [diff --git a/docs/guide.html b/docs/guide.htmlindex 6cee19ac..0c92eace 100644--- a/docs/guide.html+++ b/docs/guide.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify guide 2.16.0">+ <meta name="generator" content="archify guide 2.17.0-dev.0"><title>Archify Scenario Guide — Choose the Right Diagram</title><meta name="description" content="Describe the technical question you need to answer. Archify recommends a bounded diagram recipe, evidence checklist, and copy-ready prompt."><meta name="theme-color" content="#eff2f1">@@ -238,7 +238,7 @@</section></main>- <footer><div class="shell"><span data-i18n="footerLeft">Generated from the same recipe source as the Archify CLI.</span><span>archify guide "your scenario"</span><span data-i18n="versionLabel">Scenario guide / stable / v2.16.0</span></div></footer>+ <footer><div class="shell"><span data-i18n="footerLeft">Generated from the same recipe source as the Archify CLI.</span><span>archify guide "your scenario"</span><span data-i18n="versionLabel">Scenario guide / development / v2.17.0-dev.0</span></div></footer><script id="guide-data" type="application/json">[{"id":"system-overview","type":"architecture","proof":"web-app","presentation":{"preset":"classic","motion":"static","views":"optional"},"title":"System overview","question":"What exists, who owns it, and how is it connected?","summary":"A bounded map of core components, external dependencies, primary paths, and trust boundaries.","useWhen":"Onboarding, design reviews, repository orientation, or explaining a service landscape.","avoidWhen":"The audience needs exact call order, state transitions, or row-level data lineage.","include":["8–12 core components","one primary path","external dependencies","trust boundaries"],"prompt":"Analyze this repository, then use Archify to create a high-level architecture diagram. Show 8–12 core runtime components, one primary request or data path, external dependencies, ownership or trust boundaries, and put supporting detail in cards instead of adding more edges.","en":{"title":"System overview","question":"What exists, who owns it, and how is it connected?","summary":"A bounded map of core components, external dependencies, primary paths, and trust boundaries.","useWhen":"Onboarding, design reviews, repository orientation, or explaining a service landscape.","avoidWhen":"The audience needs exact call order, state transitions, or row-level data lineage.","include":["8–12 core components","one primary path","external dependencies","trust boundaries"],"prompt":"Analyze this repository, then use Archify to create a high-level architecture diagram. Show 8–12 core runtime components, one primary request or data path, external dependencies, ownership or trust boundaries, and put supporting detail in cards instead of adding more edges."},"zh":{"title":"系统总览","question":"系统里有什么、归谁负责、彼此如何连接?","summary":"用一张有边界的图展示核心组件、外部依赖、主路径和信任边界。","useWhen":"适合新人上手、方案评审、仓库梳理和服务全景说明。","avoidWhen":"如果重点是精确调用顺序、状态流转或字段级血缘,请换其他配方。","include":["8–12 个核心组件","一条主路径","外部依赖","归属或信任边界"],"prompt":"分析这个仓库,然后用 Archify 生成高层系统架构图。展示 8–12 个核心运行时组件、一条主要请求或数据路径、外部依赖、归属或信任边界;支持性细节放进卡片,不要继续堆连线。"},"signals":[["system overview",12],["architecture",10],["components",6],["services",4],["repository",5],["trust boundary",8],["架构",10],["系统总览",12],["组件",6],["服务",4],["仓库",5],["信任边界",8]]},{"id":"deployment-ownership","type":"architecture","proof":"deployment-ownership","presentation":{"preset":"blueprint","motion":"trace","views":"recommended"},"title":"Deployment ownership","question":"Where does each workload run, and what crosses a boundary?","summary":"A deployment-focused map of regions, networks, clusters, workloads, stores, and cross-boundary mechanisms.","useWhen":"Cloud reviews, production readiness, multi-region planning, or infrastructure ownership handoffs.","avoidWhen":"Deployment facts are unknown or the real question is application behavior rather than placement.","include":["regions and networks","workload ownership","stateful services","named boundary crossings"],"prompt":"Use Archify to draw the production deployment topology. Group resources by region, network, cluster, and owner; show workloads and stateful services; label every cross-boundary mechanism. Do not invent deployment facts—mark unknown areas explicitly. If the user wants a fail-closed deployment review, ask before setting meta.engineering_profile to deployment-ownership; otherwise leave the engineering profile unset.","en":{"title":"Deployment ownership","question":"Where does each workload run, and what crosses a boundary?","summary":"A deployment-focused map of regions, networks, clusters, workloads, stores, and cross-boundary mechanisms.","useWhen":"Cloud reviews, production readiness, multi-region planning, or infrastructure ownership handoffs.","avoidWhen":"Deployment facts are unknown or the real question is application behavior rather than placement.","include":["regions and networks","workload ownership","stateful services","named boundary crossings"],"prompt":"Use Archify to draw the production deployment topology. Group resources by region, network, cluster, and owner; show workloads and stateful services; label every cross-boundary mechanism. Do not invent deployment facts—mark unknown areas explicitly. If the user wants a fail-closed deployment review, ask before setting meta.engineering_profile to deployment-ownership; otherwise leave the engineering profile unset."},"zh":{"title":"部署与归属","question":"每个工作负载运行在哪里,哪些连接跨越了边界?","summary":"围绕 Region、网络、集群、工作负载、存储和跨边界机制组织部署图。","useWhen":"适合云上评审、生产就绪、多区域规划和基础设施交接。","avoidWhen":"部署事实不清楚,或真正问题是应用行为而不是资源位置时不要使用。","include":["区域与网络","工作负载归属","有状态服务","明确的跨边界机制"],"prompt":"用 Archify 绘制生产部署拓扑。按区域、网络、集群和负责人分组,展示工作负载与有状态服务,并标注每一种跨边界机制。不要编造部署事实,不确定的区域要明确标出。如果用户需要失败即阻断的部署评审,先征得确认,再把 meta.engineering_profile 设为 deployment-ownership;否则不要启用工程画像。"},"signals":[["deployment topology",14],["region",7],["vpc",9],["cluster",6],["availability zone",8],["ownership",7],["cloud deployment",12],["部署拓扑",14],["区域",6],["集群",6],["可用区",8],["资源归属",9],["跨区",8]]},{"id":"agent-tool-call","type":"workflow","proof":"agent-tool-call","presentation":{"preset":"signal-flow","motion":"trace","views":"recommended"},"title":"Agent tool-call loop","question":"How does an agent plan, get permission, act, recover, and report?","summary":"A lane-based agent loop with policy gates, tool execution, exception recovery, evidence, and final response.","useWhen":"Explaining agent runtimes, MCP/tool orchestration, approvals, retries, or observability.","avoidWhen":"The goal is only to show static agent components or exact API message timing.","include":["request and planning","policy or approval gate","tool execution","exception and evidence paths"],"prompt":"Use Archify workflow mode to explain this agent tool-call loop. Separate user surface, agent runtime, policy boundary, exception handling, tool execution, and observability into lanes. Make the successful path primary and show approval, retry, blocked, and evidence paths explicitly.","en":{"title":"Agent tool-call loop","question":"How does an agent plan, get permission, act, recover, and report?","summary":"A lane-based agent loop with policy gates, tool execution, exception recovery, evidence, and final response.","useWhen":"Explaining agent runtimes, MCP/tool orchestration, approvals, retries, or observability.","avoidWhen":"The goal is only to show static agent components or exact API message timing.","include":["request and planning","policy or approval gate","tool execution","exception and evidence paths"],"prompt":"Use Archify workflow mode to explain this agent tool-call loop. Separate user surface, agent runtime, policy boundary, exception handling, tool execution, and observability into lanes. Make the successful path primary and show approval, retry, blocked, and evidence paths explicitly."},"zh":{"title":"智能体工具调用","question":"智能体如何规划、获批、执行、恢复并汇报?","summary":"用泳道表达策略门、工具执行、异常恢复、证据和最终回复。","useWhen":"适合解释 Agent Runtime、MCP/工具编排、审批、重试和可观测性。","avoidWhen":"如果只想看静态组件,或重点是精确 API 消息时序,请换其他配方。","include":["请求与规划","策略或审批门","工具执行","异常与证据路径"],"prompt":"用 Archify 工作流模式解释这段智能体工具调用。把用户界面、Agent Runtime、策略边界、异常处理、工具执行和可观测性分成泳道;突出成功主路径,并明确展示审批、重试、阻塞和证据路径。"},"signals":[["agent tool call",16],["tool call",12],["approval gate",10],["human in the loop",9],["mcp",7],["planner",6],["agent loop",10],["智能体工具调用",16],["工具调用",12],["审批门",10],["人在回路",9],["规划器",6],["智能体循环",10]]},{"id":"delivery-workflow","type":"workflow","proof":"delivery-workflow","presentation":{"preset":"classic","motion":"trace","views":"optional"},"title":"Delivery workflow","question":"How does a change move safely from commit to production?","summary":"A delivery flow with build, checks, environments, approvals, smoke tests, rollback, and ownership lanes.","useWhen":"CI/CD design, release reviews, deployment governance, or onboarding developers to delivery.","avoidWhen":"The question is where infrastructure runs or what states a deployment object can occupy.","include":["trigger and build","blocking checks","approval and environments","rollback and verification"],"prompt":"Use Archify workflow mode to draw this delivery process from commit to production. Separate developer, CI, approval, environment, and exception lanes; mark blocking checks, smoke tests, ownership, and the rollback path. Keep one unmistakable happy path.","en":{"title":"Delivery workflow","question":"How does a change move safely from commit to production?","summary":"A delivery flow with build, checks, environments, approvals, smoke tests, rollback, and ownership lanes.","useWhen":"CI/CD design, release reviews, deployment governance, or onboarding developers to delivery.","avoidWhen":"The question is where infrastructure runs or what states a deployment object can occupy.","include":["trigger and build","blocking checks","approval and environments","rollback and verification"],"prompt":"Use Archify workflow mode to draw this delivery process from commit to production. Separate developer, CI, approval, environment, and exception lanes; mark blocking checks, smoke tests, ownership, and the rollback path. Keep one unmistakable happy path."},"zh":{"title":"研发交付流程","question":"一次变更如何安全地从提交走到生产?","summary":"展示构建、检查、环境、审批、冒烟、回滚和负责人泳道。","useWhen":"适合 CI/CD 设计、发布评审、部署治理和研发新人上手。","avoidWhen":"如果重点是基础设施位置或部署对象的状态集合,请换架构图或生命周期图。","include":["触发与构建","阻断检查","审批与环境","回滚与验证"],"prompt":"用 Archify 工作流模式绘制从代码提交到生产发布的流程。拆分开发者、CI、审批、环境和异常泳道;标出阻断检查、冒烟测试、负责人和回滚路径,并保留一条一眼可见的成功主路径。"},"signals":[["ci/cd",14],["release workflow",14],["deployment pipeline",11],["pull request",7],["staging",7],["rollback",8],["发布流程",14],["流水线",9],["上线",7],["预发",7],["回滚",8],["审批发布",10]]},{"id":"incident-runbook","type":"workflow","proof":"incident-runbook","presentation":{"preset":"signal-flow","motion":"trace","views":"recommended"},"title":"Incident runbook","question":"How do responders detect, triage, mitigate, verify, and escalate?","summary":"An operational workflow that separates signals, responders, mitigation, communications, and recovery proof.","useWhen":"Incident playbooks, on-call handoffs, reliability reviews, and tabletop exercises.","avoidWhen":"The audience needs live metrics or a post-incident component topology instead of response actions.","include":["detection signal","triage owner","mitigation and rollback","verification and communication"],"prompt":"Use Archify workflow mode to turn this incident runbook into responder lanes. Show detection, triage, mitigation, escalation, communication, rollback, and recovery verification. Separate decision gates from actions and make missing ownership visible.","en":{"title":"Incident runbook","question":"How do responders detect, triage, mitigate, verify, and escalate?","summary":"An operational workflow that separates signals, responders, mitigation, communications, and recovery proof.","useWhen":"Incident playbooks, on-call handoffs, reliability reviews, and tabletop exercises.","avoidWhen":"The audience needs live metrics or a post-incident component topology instead of response actions.","include":["detection signal","triage owner","mitigation and rollback","verification and communication"],"prompt":"Use Archify workflow mode to turn this incident runbook into responder lanes. Show detection, triage, mitigation, escalation, communication, rollback, and recovery verification. Separate decision gates from actions and make missing ownership visible."},"zh":{"title":"事故处置 Runbook","question":"响应者如何发现、分诊、缓解、验证并升级?","summary":"把信号、响应者、缓解动作、沟通和恢复证据拆成可执行流程。","useWhen":"适合故障预案、On-call 交接、稳定性评审和桌面演练。","avoidWhen":"如果受众需要实时指标仪表盘或事故后的组件拓扑,而不是响应动作,请换其他视图。","include":["发现信号","分诊负责人","缓解与回滚","恢复验证与沟通"],"prompt":"用 Archify 工作流模式把事故处置预案画成响应者泳道。展示发现、分诊、缓解、升级、沟通、回滚和恢复验证;把决策门与操作分开,并让缺失的负责人清晰可见。"},"signals":[["incident response",15],["runbook",12],["outage",9],["triage",8],["mitigation",8],["escalation",7],["事故处置",15],["故障",9],["应急预案",12],["排障",9],["缓解",7],["升级响应",8]]},{"id":"api-request","type":"sequence","proof":"cache-miss","presentation":{"preset":"classic","motion":"trace","views":"optional"},"title":"API request chain","question":"Who calls whom, in what order, and what returns?","summary":"A time-ordered request path with authentication, cache fallback, persistence, return traffic, and async trace.","useWhen":"API documentation, debugging request latency, auth reviews, or explaining cache fallback.","avoidWhen":"Order is unimportant and the audience only needs the stable service topology.","include":["callers and callees","request and return messages","fallback or error path","async side effects"],"prompt":"Use Archify sequence mode to show this request from caller to final response. Include authentication, cache hit or miss, persistence fallback, return messages, and asynchronous trace or event emission. Keep message labels short and order unambiguous.","en":{"title":"API request chain","question":"Who calls whom, in what order, and what returns?","summary":"A time-ordered request path with authentication, cache fallback, persistence, return traffic, and async trace.","useWhen":"API documentation, debugging request latency, auth reviews, or explaining cache fallback.","avoidWhen":"Order is unimportant and the audience only needs the stable service topology.","include":["callers and callees","request and return messages","fallback or error path","async side effects"],"prompt":"Use Archify sequence mode to show this request from caller to final response. Include authentication, cache hit or miss, persistence fallback, return messages, and asynchronous trace or event emission. Keep message labels short and order unambiguous."},"zh":{"title":"API 请求链","question":"谁调用谁、顺序如何、最终返回什么?","summary":"按时间展示鉴权、缓存回退、持久化、返回流量和异步追踪。","useWhen":"适合 API 文档、请求耗时排查、鉴权评审和缓存回退说明。","avoidWhen":"如果顺序不重要,受众只需要稳定的服务拓扑,请用架构图。","include":["调用方与被调用方","请求与返回消息","回退或错误路径","异步副作用"],"prompt":"用 Archify 时序模式展示从调用方到最终响应的完整请求。包含鉴权、缓存命中或未命中、持久化回退、返回消息,以及异步 Trace 或事件上报;消息标签保持简短,顺序必须明确。"},"signals":[["api request",14],["request response",12],["call chain",11],["cache miss",13],["jwt",8],["who calls whom",12],["api 请求",14],["请求响应",12],["调用链",11],["缓存未命中",13],["谁调用谁",12],["鉴权链路",9]]},{"id":"async-roundtrip","type":"sequence","proof":"async-roundtrip","presentation":{"preset":"signal-flow","motion":"trace","views":"recommended"},"title":"Async roundtrip","question":"What happens after the initial request returns?","summary":"A sequence view of enqueue, acknowledgement, background work, callbacks, retries, timeout, and final consistency.","useWhen":"Webhooks, jobs, queues, payment callbacks, eventual consistency, or async API contracts.","avoidWhen":"The primary question is topic topology and consumer ownership rather than time order.","include":["initial acknowledgement","queue or scheduler","background work","callback, retry, and timeout"],"prompt":"Use Archify sequence mode to explain this asynchronous roundtrip. Show the initial acknowledgement, enqueue or scheduling step, background processing, callback or polling, retry and timeout behavior, and the point where the caller can observe final consistency.","en":{"title":"Async roundtrip","question":"What happens after the initial request returns?","summary":"A sequence view of enqueue, acknowledgement, background work, callbacks, retries, timeout, and final consistency.","useWhen":"Webhooks, jobs, queues, payment callbacks, eventual consistency, or async API contracts.","avoidWhen":"The primary question is topic topology and consumer ownership rather than time order.","include":["initial acknowledgement","queue or scheduler","background work","callback, retry, and timeout"],"prompt":"Use Archify sequence mode to explain this asynchronous roundtrip. Show the initial acknowledgement, enqueue or scheduling step, background processing, callback or polling, retry and timeout behavior, and the point where the caller can observe final consistency."},"zh":{"title":"异步往返链路","question":"初始请求返回之后,后台还会发生什么?","summary":"按时间展示入队、确认、后台处理、回调、重试、超时和最终一致。","useWhen":"适合 Webhook、后台任务、队列、支付回调、最终一致和异步 API 契约。","avoidWhen":"如果重点是 Topic 拓扑和消费者归属,而不是时间顺序,请用事件数据流配方。","include":["初始确认","队列或调度器","后台处理","回调、重试与超时"],"prompt":"用 Archify 时序模式解释这段异步往返链路。展示初始确认、入队或调度、后台处理、回调或轮询、重试与超时,以及调用方何时能观察到最终一致结果。"},"signals":[["async roundtrip",14],["webhook",10],["callback",10],["acknowledgement",8],["timeout",7],["retry message",8],["异步回调",14],["回调",10],["确认消息",8],["超时",7],["消息重试",9],["webhook",10]]},{"id":"data-lineage","type":"dataflow","proof":"product-analytics","presentation":{"preset":"classic","motion":"trace","views":"recommended"},"title":"Data lineage","question":"Where does data come from, how does it change, and who consumes it?","summary":"A governed path from sources through consent, transforms, sensitive stores, warehouse, and consumers.","useWhen":"Analytics architecture, ETL/ELT review, PII assessment, warehouse design, or model feature lineage.","avoidWhen":"The audience needs request timing or operational task ownership rather than data assets.","include":["sources and assets","transform stages","classification or consent","stores and consumers"],"prompt":"Use Archify dataflow mode to map this data lineage. Name every data asset and transform, show consent or classification boundaries, distinguish streaming from batch paths, and identify stores plus downstream consumers. Do not use unlabeled flows.","en":{"title":"Data lineage","question":"Where does data come from, how does it change, and who consumes it?","summary":"A governed path from sources through consent, transforms, sensitive stores, warehouse, and consumers.","useWhen":"Analytics architecture, ETL/ELT review, PII assessment, warehouse design, or model feature lineage.","avoidWhen":"The audience needs request timing or operational task ownership rather than data assets.","include":["sources and assets","transform stages","classification or consent","stores and consumers"],"prompt":"Use Archify dataflow mode to map this data lineage. Name every data asset and transform, show consent or classification boundaries, distinguish streaming from batch paths, and identify stores plus downstream consumers. Do not use unlabeled flows."},"zh":{"title":"数据血缘","question":"数据从哪里来、如何变化、最终被谁消费?","summary":"从来源经过同意、转换、敏感存储、数仓直到消费者的治理路径。","useWhen":"适合分析架构、ETL/ELT 评审、PII 评估、数仓设计和特征血缘。","avoidWhen":"如果受众需要请求时序或操作负责人,而不是数据资产,请换其他配方。","include":["数据来源与资产","转换阶段","分类或同意边界","存储与消费者"],"prompt":"用 Archify 数据流模式梳理这段数据血缘。为每个数据资产和转换命名,展示用户同意或数据分类边界,区分流式与批处理路径,并标明存储和下游消费者;所有数据流都必须有标签。"},"signals":[["data lineage",15],["etl",12],["warehouse",9],["pii",11],["governance",9],["analytics pipeline",12],["数据血缘",15],["数据管道",11],["数仓",9],["治理",9],["隐私数据",10],["用户同意",9]]},{"id":"event-stream","type":"dataflow","proof":"event-stream","presentation":{"preset":"signal-flow","motion":"trace","views":"recommended"},"title":"Event-stream topology","question":"Which events move through which topics, processors, groups, and failure paths?","summary":"A stream map of producers, topics, ordered processors, consumer groups, state, replay, and DLQ.","useWhen":"Kafka/event-platform design, stream processing reviews, ownership, replay, and failure handling.","avoidWhen":"Topic names, consumer groups, and delivery semantics are not known—use a generic workflow instead.","include":["producers and event names","topics and ordering","processors and consumer groups","state, replay, and DLQ"],"prompt":"Use Archify dataflow mode to draw this event-stream topology. Name producers, events, topics, ordered processors, consumer groups, state stores, replay paths, and the DLQ. Show ownership and delivery semantics only when supported by evidence.","en":{"title":"Event-stream topology","question":"Which events move through which topics, processors, groups, and failure paths?","summary":"A stream map of producers, topics, ordered processors, consumer groups, state, replay, and DLQ.","useWhen":"Kafka/event-platform design, stream processing reviews, ownership, replay, and failure handling.","avoidWhen":"Topic names, consumer groups, and delivery semantics are not known—use a generic workflow instead.","include":["producers and event names","topics and ordering","processors and consumer groups","state, replay, and DLQ"],"prompt":"Use Archify dataflow mode to draw this event-stream topology. Name producers, events, topics, ordered processors, consumer groups, state stores, replay paths, and the DLQ. Show ownership and delivery semantics only when supported by evidence."},"zh":{"title":"事件流拓扑","question":"哪些事件经过哪些 Topic、处理器、消费者组和失败路径?","summary":"展示生产者、Topic、有序处理器、消费者组、状态、重放和 DLQ。","useWhen":"适合 Kafka/事件平台设计、流处理评审、归属、重放和失败处理。","avoidWhen":"如果 Topic、消费者组和投递语义都不清楚,请先用通用工作流,不要编造事件拓扑。","include":["生产者与事件名","Topic 与顺序","处理器与消费者组","状态、重放与 DLQ"],"prompt":"用 Archify 数据流模式绘制这段事件流拓扑。命名生产者、事件、Topic、有序处理器、消费者组、状态存储、重放路径和 DLQ;只有在证据充分时才标注归属和投递语义。"},"signals":[["event stream",15],["kafka topology",14],["topic",8],["consumer group",11],["dead letter",10],["dlq",10],["事件流",15],["kafka 拓扑",14],["主题",7],["消费者组",11],["死信",10],["事件地铁图",12]]},{"id":"object-lifecycle","type":"lifecycle","proof":"agent-run","presentation":{"preset":"classic","motion":"trace","views":"optional"},"title":"Object lifecycle","question":"Which states exist, what events move between them, and how does it end?","summary":"A state model with active work, waits, retries, cancellation, failure, and explicit terminal outcomes.","useWhen":"Tasks, orders, tickets, subscriptions, jobs, agent runs, or any durable object with status.","avoidWhen":"The object has no durable state and the real question is participant interaction over time.","include":["start and active states","event-labelled transitions","wait and retry states","all terminal outcomes"],"prompt":"Use Archify lifecycle mode to model this object. Separate main progress, waiting or interruption states, and terminal outcomes. Label transitions with events, include retry, cancellation, timeout, success, and failure where real, and never hide an ending.","en":{"title":"Object lifecycle","question":"Which states exist, what events move between them, and how does it end?","summary":"A state model with active work, waits, retries, cancellation, failure, and explicit terminal outcomes.","useWhen":"Tasks, orders, tickets, subscriptions, jobs, agent runs, or any durable object with status.","avoidWhen":"The object has no durable state and the real question is participant interaction over time.","include":["start and active states","event-labelled transitions","wait and retry states","all terminal outcomes"],"prompt":"Use Archify lifecycle mode to model this object. Separate main progress, waiting or interruption states, and terminal outcomes. Label transitions with events, include retry, cancellation, timeout, success, and failure where real, and never hide an ending."},"zh":{"title":"对象生命周期","question":"有哪些状态、什么事件触发流转、最终如何结束?","summary":"展示执行、等待、重试、取消、失败以及明确终态的状态模型。","useWhen":"适合任务、订单、工单、订阅、作业、Agent Run 等带持久状态的对象。","avoidWhen":"对象没有持久状态,真正问题是参与者随时间的交互时,请使用时序图。","include":["开始与执行态","带事件的转换","等待与重试态","所有终态"],"prompt":"用 Archify 生命周期模式建模这个对象。分开主进度、等待或中断状态和终态;用事件标注转换,并在真实存在时展示重试、取消、超时、成功和失败,不能隐藏任何结束方式。"},"signals":[["state machine",15],["object lifecycle",14],["status transition",11],["terminal state",9],["retry state",8],["状态机",15],["生命周期",13],["状态流转",11],["终态",9],["等待态",8],["重试状态",8]]},{"id":"deployment-lifecycle","type":"lifecycle","proof":"deployment-lifecycle","presentation":{"preset":"signal-flow","motion":"trace","views":"recommended"},"title":"Deployment lifecycle","question":"What state is a release in, and what can happen next?","summary":"A deployment state model covering queued, building, verifying, approval, promotion, rollback, and terminal outcomes.","useWhen":"Release controllers, GitOps reconciliation, environment promotion, or deployment status APIs.","avoidWhen":"The question is the human/CI sequence of delivery actions rather than the deployment object state.","include":["queued and running states","verification and approval","promotion and rollback","success, failure, cancellation"],"prompt":"Use Archify lifecycle mode to model the deployment object. Show queued, building, verifying, waiting for approval, promoting, rolling back, and every terminal outcome. Label the events and guards that permit each transition.","en":{"title":"Deployment lifecycle","question":"What state is a release in, and what can happen next?","summary":"A deployment state model covering queued, building, verifying, approval, promotion, rollback, and terminal outcomes.","useWhen":"Release controllers, GitOps reconciliation, environment promotion, or deployment status APIs.","avoidWhen":"The question is the human/CI sequence of delivery actions rather than the deployment object state.","include":["queued and running states","verification and approval","promotion and rollback","success, failure, cancellation"],"prompt":"Use Archify lifecycle mode to model the deployment object. Show queued, building, verifying, waiting for approval, promoting, rolling back, and every terminal outcome. Label the events and guards that permit each transition."},"zh":{"title":"部署生命周期","question":"一次发布当前处于什么状态,下一步可能发生什么?","summary":"覆盖排队、构建、验证、审批、晋级、回滚和终态的部署状态模型。","useWhen":"适合发布控制器、GitOps 对账、环境晋级和部署状态 API。","avoidWhen":"如果重点是人员与 CI 的交付动作顺序,而不是部署对象状态,请用交付工作流。","include":["排队与执行态","验证与审批","晋级与回滚","成功、失败与取消"],"prompt":"用 Archify 生命周期模式建模部署对象。展示排队、构建、验证、等待审批、晋级、回滚以及所有终态,并标注允许每次状态转换的事件和守卫条件。"},"signals":[["deployment lifecycle",15],["release state",10],["promotion state",9],["approval status",8],["rollback state",10],["部署生命周期",15],["发布状态",10],["晋级",7],["审批状态",8],["回滚状态",10]]}]</script><script src="assets/site-language.js"></script>@@ -253,12 +253,12 @@var lastRecipe = null;var copy = {en: {- navGuide:'Guide',navProof:'Proof Lab',navStart:'Start',navInstall:'Install Skill',versionLabel:'Scenario guide / stable / v2.16.0',eyebrow:'Question-first diagramming', headline:'Choose the question.<br>Get the <em>right diagram.</em>', lede:'Describe what your audience needs to understand. Archify recommends one bounded visual recipe—plus the evidence it must contain, when not to use it, and a prompt you can copy.',+ navGuide:'Guide',navProof:'Proof Lab',navStart:'Start',navInstall:'Install Skill',versionLabel:'Scenario guide / development / v2.17.0-dev.0',eyebrow:'Question-first diagramming', headline:'Choose the question.<br>Get the <em>right diagram.</em>', lede:'Describe what your audience needs to understand. Archify recommends one bounded visual recipe—plus the evidence it must contain, when not to use it, and a prompt you can copy.',metricRecipes:'real-world<br>recipes',metricModes:'typed diagram<br>modes',metricRuntime:'runtime<br>dependencies',chooserTitle:'What must the diagram explain?',chooserBody:'Write a situation, not a diagram type. Specific system facts produce a stronger recommendation.',placeholder:'Example: Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.',recommend:'Recommend a recipe →',clear:'Clear',libraryEyebrow:'Recipe library',libraryTitle:'Eleven small, opinionated starting points.',libraryBody:'Each recipe answers one technical question. That boundary keeps the result legible, reviewable, and honest about missing evidence.',footerLeft:'Generated from the same recipe source as the Archify CLI.',all:'All recipes',recommended:'Recommended recipe',use:'Use when',avoid:'Avoid when',must:'Evidence to include',presentation:'Presentation',prompt:'Copy-ready prompt',copyPrompt:'Copy prompt',copied:'Copied',alternatives:'Other possible fits:',confidence:'confidence',open:'Open recipe',proofReady:'Verified proof',proofLink:'Open verified example ↗',samples:[['API + cache miss','Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.'],['Kafka + DLQ','Map Kafka topics, ordered processors, consumer groups, replay, state stores, and the dead-letter queue.'],['Incident response','Show how responders detect, triage, mitigate, escalate, communicate, and verify recovery.']]},zh: {- navGuide:'场景指南',navProof:'验证作品集',navStart:'快速上手',navInstall:'安装技能',versionLabel:'场景指南 / 稳定版 / v2.16.0',eyebrow:'先问题,后图表',headline:'先选对问题,<br>再得到<em>对的图。</em>',lede:'描述受众真正需要理解的内容。Archify 会推荐一个有边界的视觉配方,同时给出证据清单、禁用条件和可复制提示词。',+ navGuide:'场景指南',navProof:'验证作品集',navStart:'快速上手',navInstall:'安装技能',versionLabel:'场景指南 / 开发版 / v2.17.0-dev.0',eyebrow:'先问题,后图表',headline:'先选对问题,<br>再得到<em>对的图。</em>',lede:'描述受众真正需要理解的内容。Archify 会推荐一个有边界的视觉配方,同时给出证据清单、禁用条件和可复制提示词。',metricRecipes:'个真实场景<br>配方',metricModes:'种类型化<br>图表模式',metricRuntime:'个运行时<br>依赖',chooserTitle:'这张图必须解释什么?',chooserBody:'写清场景,不要只写图表类型。系统事实越具体,推荐越可靠。',placeholder:'例如:展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。',recommend:'推荐配方 →',clear:'清空',libraryEyebrow:'配方库',libraryTitle:'十一个小而专的起点。',libraryBody:'每个配方只回答一个技术问题。清晰的边界让图更易读、可评审,也不会掩盖证据缺口。',footerLeft:'网页与 Archify CLI 使用同一份配方数据生成。',all:'全部配方',recommended:'推荐配方',use:'适合',avoid:'不要这样用',must:'必须包含的证据',presentation:'表现建议',prompt:'可直接复制的提示词',copyPrompt:'复制提示词',copied:'已复制',alternatives:'其他可能:',confidence:'置信度',open:'打开配方',proofReady:'已验证成品',proofLink:'打开验证成品 ↗',samples:[['API + 缓存未命中','展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。'],['Kafka + 死信','梳理 Kafka Topic、有序处理器、消费者组、重放、状态存储和死信队列。'],['事故处置','展示响应者如何发现、分诊、缓解、升级、沟通并验证恢复。']]}diff --git a/docs/index.html b/docs/index.htmlindex 077b0908..8eda32ff 100644--- a/docs/index.html+++ b/docs/index.html@@ -393,7 +393,7 @@<div class="hero-intro"><div class="hero-badge fade-up"><div class="pulse-dot"></div>- <span data-i18n="hero-badge">Agent Skill · stable · v2.16.0</span>+ <span data-i18n="hero-badge">Agent Skill · development · v2.17.0-dev.0</span></div><h1 class="fade-up d1" data-i18n="hero-h1">From plain English<br>to architecture <em>you can trust.</em></h1><p class="hero-sub fade-up d2" data-i18n="hero-sub">Describe your system in chat. Archify generates a polished, explorable HTML diagram — with progressive MAP → READ → FULL detail, a semantic camera, path-aware stories, motion, and ultra-crisp export built in.</p>@@ -825,7 +825,7 @@<a class="nav-logo" href="#"><span style="font-size:.8125rem;font-weight:700;color:var(--muted)">Archify</span></a>- <p class="footer-meta" data-i18n="footer-meta">stable · v2.16.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator</p>+ <p class="footer-meta" data-i18n="footer-meta">development · v2.17.0-dev.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator</p></div><div class="footer-links"><a href="https://github.com/tt-a1i/archify" target="_blank" rel="noopener">GitHub</a>@@ -843,7 +843,7 @@const LANGS = {en: {'nav-guide':'Guide','nav-gallery':'Proof Lab','nav-start':'Start','nav-install':'Install Skill',- 'hero-badge':'Agent Skill · stable · v2.16.0',+ 'hero-badge':'Agent Skill · development · v2.17.0-dev.0','hero-h1':'From plain English<br>to architecture <em>you can trust.</em>','hero-sub':'Describe your system in chat. Archify generates a polished, explorable HTML diagram — with progressive MAP → READ → FULL detail, a semantic camera, path-aware stories, motion, and ultra-crisp export built in.','hero-cta':'Choose the right diagram','hero-gallery':'Explore proof gallery',@@ -895,7 +895,7 @@'step2-h':'Describe your system','step2-p':'Describe components, connections, and cloud services — or ask your agent to analyze the repository first.','step3-h':'Ask your agent to draw it','step3-p':'Tell your agent to use Archify. It generates a self-contained HTML file you can open in any browser and refine in chat.','kbd-label':'Keyboard shortcuts','kbd-guide':'Diagram guide','kbd-theme':'Toggle theme','kbd-find':'Find node / route endpoint','kbd-route':'Trace, inspect, and play a route','kbd-radar':'Semantic radar','kbd-lens':'Compare semantic kinds','kbd-present':'Presentation stage','kbd-export':'Open export menu','kbd-focus':'Focus node','kbd-views':'Guided views','kbd-play':'Play story','kbd-zoom':'Reading depth / reset','kbd-nav':'Navigate menu','kbd-close':'Close menu',- 'footer-meta':'stable · v2.16.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator',+ 'footer-meta':'development · v2.17.0-dev.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator','cta-h':'Describe it once.<br><em>Share the map.</em>','cta-sub':'One command installs the checked skill for Cursor, Claude Code, Codex, or OpenCode — and your next diagram is a chat message away.','cta-install':'Install the skill',@@ -903,7 +903,7 @@},zh: {'nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'快速上手','nav-install':'安装技能',- 'hero-badge':'Agent 技能 · 稳定版 · v2.16.0',+ 'hero-badge':'Agent 技能 · 开发版 · v2.17.0-dev.0','hero-h1':'用自然语言,<br>生成<em>可信的架构图。</em>','hero-sub':'在对话中描述你的系统,Archify 生成精美、可探索的 HTML 技术图——信息会按 MAP → READ → FULL 渐进展开,并内置语义镜头、路径故事、动态效果和超清导出。','hero-cta':'选择合适的图','hero-gallery':'查看验证作品集',@@ -955,7 +955,7 @@'step2-h':'描述你的系统','step2-p':'描述组件、连接关系和云服务,也可以先让 agent 分析代码仓库。','step3-h':'让 agent 绘制','step3-p':'告诉 agent 使用 Archify,它会生成可在任意浏览器打开的单文件 HTML,并可继续在对话中迭代。','kbd-label':'键盘快捷键','kbd-guide':'图表指南','kbd-theme':'切换主题','kbd-find':'查找节点 / 路径端点','kbd-route':'探查、检查并播放路径','kbd-radar':'语义雷达','kbd-lens':'对比语义类型','kbd-present':'演示舞台','kbd-export':'打开导出菜单','kbd-focus':'聚焦节点','kbd-views':'引导视图','kbd-play':'播放故事','kbd-zoom':'阅读层级 / 复位','kbd-nav':'菜单导航','kbd-close':'关闭菜单',- 'footer-meta':'稳定版 · v2.16.0 · MIT 许可证<br>基于 Cocoon-AI/architecture-diagram-generator',+ 'footer-meta':'开发版 · v2.17.0-dev.0 · MIT 许可证<br>基于 Cocoon-AI/architecture-diagram-generator','cta-h':'描述一次,<br><em>分享这张图。</em>','cta-sub':'一条命令即可为 Cursor、Claude Code、Codex 或 OpenCode 安装经过检查的技能——你的下一张架构图,只差一句对话。','cta-install':'安装技能',diff --git a/docs/start.html b/docs/start.htmlindex 02c0e27c..29939fcc 100644--- a/docs/start.html+++ b/docs/start.html@@ -268,7 +268,7 @@</section><footer class="page-footer">- <span data-en="Archify v2.16.0 · stable · self-contained HTML · typed JSON source" data-zh="Archify v2.16.0 · 稳定版 · 独立 HTML · 类型化 JSON 源">Archify v2.16.0 · stable · self-contained HTML · typed JSON source</span>+ <span data-en="Archify v2.17.0-dev.0 · development · self-contained HTML · typed JSON source" data-zh="Archify v2.17.0-dev.0 · 开发版 · 独立 HTML · 类型化 JSON 源">Archify v2.17.0-dev.0 · development · self-contained HTML · typed JSON source</span><span id="copy-status" role="status" aria-live="polite"></span><a href="https://github.com/tt-a1i/archify" data-en="View source on GitHub ↗" data-zh="在 GitHub 查看源码 ↗">View source on GitHub ↗</a></footer>diff --git a/examples/archify-repo-grid.html b/examples/archify-repo-grid.htmlindex 709059cb..b7438749 100644--- a/examples/archify-repo-grid.html+++ b/examples/archify-repo-grid.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Archify Pipeline Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/archify-repo.html b/examples/archify-repo.htmlindex 76ad4d0d..c567e64c 100644--- a/examples/archify-repo.html+++ b/examples/archify-repo.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Archify Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/checkout-platform-delta.html b/examples/checkout-platform-delta.htmlindex a4ffee7e..02fd55cb 100644--- a/examples/checkout-platform-delta.html+++ b/examples/checkout-platform-delta.html@@ -4829,7 +4829,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Checkout Platform — Baseline Diagram</title><script>// Resolve the theme before first paint so light-preference users don't@@ -19904,7 +19904,7 @@ html[data-theme="dark"] body{background:#071019!important;background-image:none!<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Checkout Platform — Fraud Gate Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/checkout-platform-delta.receipt.json b/examples/checkout-platform-delta.receipt.jsonindex 3b276269..94c7a878 100644--- a/examples/checkout-platform-delta.receipt.json+++ b/examples/checkout-platform-delta.receipt.json@@ -219,8 +219,8 @@"Boundary identity is conservatively derived from kind + label."],"artifact": {- "sha256": "805dd47ec062aeabf78a8b64cc975f6753f6af1f234e134e22c3b9f159ac5e92",- "bytes": 2023829+ "sha256": "92c8474fb732d64bd9448085e36a31fdca20ad5ac707d59b02e546a66192aa08",+ "bytes": 2023841},"validation": {"checksPassed": 28,diff --git a/examples/dataflow-product-analytics.html b/examples/dataflow-product-analytics.htmlindex 01ddabca..e382cdab 100644--- a/examples/dataflow-product-analytics.html+++ b/examples/dataflow-product-analytics.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Product Analytics Data Flow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.htmlindex db481754..d98ca626 100644--- a/examples/lifecycle-agent-run.html+++ b/examples/lifecycle-agent-run.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Agent Run Lifecycle Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/maka-architecture.html b/examples/maka-architecture.htmlindex ab281418..a578d4b9 100644--- a/examples/maka-architecture.html+++ b/examples/maka-architecture.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Maka Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/rag-pipeline.html b/examples/rag-pipeline.htmlindex 09586349..a50cf960 100644--- a/examples/rag-pipeline.html+++ b/examples/rag-pipeline.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>RAG Pipeline Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/sequence-cache-miss-request.html b/examples/sequence-cache-miss-request.htmlindex 6c91f299..338c9d48 100644--- a/examples/sequence-cache-miss-request.html+++ b/examples/sequence-cache-miss-request.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Cache Miss Request Sequence Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/web-app-rendered.html b/examples/web-app-rendered.htmlindex c4c1eb1c..e4ee520b 100644--- a/examples/web-app-rendered.html+++ b/examples/web-app-rendered.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Sample Web App Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/web-app.html b/examples/web-app.htmlindex c4c1eb1c..e4ee520b 100644--- a/examples/web-app.html+++ b/examples/web-app.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Sample Web App Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/workflow-agent-tool-call-rendered.html b/examples/workflow-agent-tool-call-rendered.htmlindex 0f4842f9..b4ed8b9f 100644--- a/examples/workflow-agent-tool-call-rendered.html+++ b/examples/workflow-agent-tool-call-rendered.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>Agent Tool Call Workflow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/experiments/mco-showcase/mco-runtime.html b/experiments/mco-showcase/mco-runtime.htmlindex 54ca9f4e..ba4ce63d 100644--- a/experiments/mco-showcase/mco-runtime.html+++ b/experiments/mco-showcase/mco-runtime.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.16.0">+ <meta name="generator" content="archify 2.17.0-dev.0"><title>MCO Runtime Architecture Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/experiments/v3-mermaid-validation/INDEX.md b/experiments/v3-mermaid-validation/INDEX.mdindex a699e7ca..52dca33d 100644--- a/experiments/v3-mermaid-validation/INDEX.md+++ b/experiments/v3-mermaid-validation/INDEX.md@@ -1,6 +1,6 @@# v3.0 Mermaid → Archify Validation — Source Diagrams-5 real-world Mermaid `flowchart` diagrams used as test inputs for the v3.0 visual-quality validation experiment described in `../../ROADMAP.md` (section: Validation experiment).+3 real-world Mermaid `flowchart` diagrams retained from the v3.0 visual-quality validation experiment described in `../../ROADMAP.md` (section: Validation experiment). The original experiment used five inputs; two inputs and their derivatives were removed on 2026-09-01 because their repositories did not provide verifiable redistribution licenses.All diagrams were verified present in their source repositories on **2026-04-16**.@@ -9,14 +9,12 @@ All diagrams were verified present in their source repositories on **2026-04-16*| 1 | Mermaid official canonical | [mermaid-js/mermaid `flowchart.md`](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/syntax/flowchart.md) | 5 | TD | Decision-loop example from official syntax docs (substituted for the 4-node `examples.md` showcase to meet the ≥5-node floor) || 2 | Kubernetes | [kubernetes/website `observability.md`](https://github.com/kubernetes/website/blob/main/content/en/docs/concepts/cluster-administration/observability.md) | 9 | LR | k8s log aggregation pipeline; uses subgraph for source grouping || 3 | Microservices | [GStones/moke-kit `README.md`](https://github.com/GStones/moke-kit/blob/main/README.md) | 12 | TD | Go game-server toolkit; 5 layered subgraphs; ships with embedded `classDef` colors that we strip for fair comparison |-| 4 | CI/CD pipeline | [HaroonKhanDotNet/hivenue-cicd `BRD.md`](https://github.com/HaroonKhanDotNet/hivenue-cicd/blob/main/BRD.md) | 10 | TD | Real Hivenue platform pipeline; includes decision diamonds and `<br>` multi-line labels |-| 5 | 3-tier web app | [broadinstitute/taiga `arch.md`](https://github.com/broadinstitute/taiga/blob/afb4840/arch.md) | 10 | TD | Broad Institute scientific data platform; 4 subgraphs (Client / App / Storage / External) |## Diversity self-check-- **Node range**: 5 / 9 / 10 / 10 / 12 (small to medium)-- **Direction**: 4× TD + 1× LR-- **Complexity coverage**: plain (#1), subgraph (#2 #3 #5), decision diamonds (#4), embedded `classDef` styling (#3), multi-line `<br>` labels (#4)+- **Node range**: 5 / 9 / 12 (small to medium)+- **Direction**: 2× TD + 1× LR+- **Complexity coverage**: plain (#1), subgraph (#2 #3), embedded `classDef` styling (#3)## Output structure@@ -25,7 +23,7 @@ sources/ — raw .mmd files (this directory's siblings)output-A-stock/ — version (A): stock mmdc with default themeoutput-B-themed/— version (B): mmdc with archify-style themeCSS injectedoutput-C-archify/ — version (C): hand-ported to archify HTML-screenshots/ — randomized & deduplicated 15-image set for blind rating+screenshots/ — retained randomized & deduplicated 9-image set for blind ratingRESULT.md — rating tables + decision record```@@ -33,5 +31,4 @@ RESULT.md — rating tables + decision record1. **Diagram 1** is from the syntax docs page, not the canonical `examples.md` showcase — that one's only 4 nodes which falls below our 5-node floor. The 5-node decision-loop is the closest "official representative" example.2. **Diagram 2** is a *log pipeline* not a *deployment topology* — the original ask was "k8s deployment", but the kubernetes/website repo's most-prominent flowchart is this observability one. Still a real, in-use, k8s-official diagram.-3. **Diagram 4** is from a relatively unknown personal repo (HaroonKhanDotNet/hivenue-cicd) rather than a canonical CI/CD example like GitHub Actions docs. It is, however, a real CI/CD diagram for a real product, which is what the experiment requires.-4. **Diagram 3's embedded `classDef`** — for fair comparison across A/B/C, version A and B will be rendered both with and without the embedded styling (so we can see whether moke-kit's hand-tuned colors already meet the bar before archify gets involved).+3. **Diagram 3's embedded `classDef`** — for fair comparison across A/B/C, version A and B will be rendered both with and without the embedded styling (so we can see whether moke-kit's hand-tuned colors already meet the bar before archify gets involved).diff --git a/experiments/v3-mermaid-validation/RESULT.md b/experiments/v3-mermaid-validation/RESULT.mdindex 9c35388c..d9ebc456 100644--- a/experiments/v3-mermaid-validation/RESULT.md+++ b/experiments/v3-mermaid-validation/RESULT.md@@ -12,9 +12,11 @@## How to blind-rate-1. Open each file in `screenshots/` (img-01 through img-15) — they're randomized, labels stripped+> **Provenance cleanup (2026-09-01):** The original run used 5 diagrams and 15 screenshots. Diagrams 4 and 5 and their derivatives were removed because their source repositories did not provide verifiable redistribution licenses. The retained 3-diagram / 9-screenshot evidence can still be inspected, but the original five-input run is no longer fully reproducible from HEAD.++1. Open each retained file in `screenshots/` — they're randomized, labels stripped2. Rate each 1–10 for visual quality-3. After all 15, open `screenshots/manifest.txt` to de-anonymize+3. After all 9, open `screenshots/manifest.txt` to de-anonymize4. Fill in the tables below## Self-evaluation (project owner)@@ -23,20 +25,14 @@| Image | Score (1–10) | Notes ||---|---|---|-| img-01-k0di | | |-| img-02-heh1 | | |-| img-03-w085 | | || img-04-12c2 | | || img-05-n1tw | | || img-06-hkrq | | || img-07-43uu | | || img-08-weo4 | | |-| img-09-gzi9 | | || img-10-rnix | | |-| img-11-2cre | | || img-12-nlmi | | || img-13-5mj4 | | |-| img-14-plhu | | || img-15-05g2 | | |### De-anonymized summary (fill after rating)@@ -46,17 +42,17 @@| 1 (Mermaid canonical) | | | | || 2 (K8s log pipeline) | | | | || 3 (moke-kit microservices) | | | | |-| 4 (Hivenue CI/CD) | | | | |-| 5 (Taiga 3-tier) | | | | |**B average:** ___-**B closer to C in ___ / 5 diagrams**+**B closer to C in ___ / 3 retained diagrams**## Pass criterion (from ROADMAP.md)- [ ] B averages ≥ 7/10- [ ] B is rated closer to C than to A in at least 4 of 5 diagrams+The 4-of-5 threshold is preserved as the original, pre-registered criterion. It must not be rewritten post hoc as a 2-of-3 criterion; after the provenance cleanup, that original threshold cannot be rerun from the current tree.+## Decision- [ ] **PASS** → Proceed with v3.0 Mermaid-aware architecture (P0 → P3)@@ -80,7 +76,7 @@ Owner self-evaluation result: **C (archify hand-placed) looks good; A and B both| Image | Score (1–10) ||---|---|-| img-01 through img-15 | |+| 9 retained screenshots | |_(repeat for Raters 2–5)_@@ -91,8 +87,6 @@ _(repeat for Raters 2–5)_| 1 | | | | || 2 | | | | || 3 | | | | |-| 4 | | | | |-| 5 | | | | |**Panel B average:** ___-**Panel B closer to C in ___ / 5 diagrams**+**Panel B closer to C in ___ / 3 retained diagrams**diff --git a/experiments/v3-mermaid-validation/output-A-stock/4.png b/experiments/v3-mermaid-validation/output-A-stock/4.pngdeleted file mode 100644index d9ae1b53..00000000Binary files a/experiments/v3-mermaid-validation/output-A-stock/4.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/output-A-stock/5.png b/experiments/v3-mermaid-validation/output-A-stock/5.pngdeleted file mode 100644index d0317f8f..00000000Binary files a/experiments/v3-mermaid-validation/output-A-stock/5.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/output-B-themed/4.png b/experiments/v3-mermaid-validation/output-B-themed/4.pngdeleted file mode 100644index 28e99b8f..00000000Binary files a/experiments/v3-mermaid-validation/output-B-themed/4.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/output-B-themed/5.png b/experiments/v3-mermaid-validation/output-B-themed/5.pngdeleted file mode 100644index 13fe5283..00000000Binary files a/experiments/v3-mermaid-validation/output-B-themed/5.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/output-C-archify/4.html b/experiments/v3-mermaid-validation/output-C-archify/4.htmldeleted file mode 100644index 9410c13b..00000000--- a/experiments/v3-mermaid-validation/output-C-archify/4.html+++ /dev/null@@ -1,166 +0,0 @@-<!DOCTYPE html>-<html lang="en" data-theme="dark">-<head>-<meta charset="UTF-8">-<title>Hivenue CI/CD — Archify</title>-<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">-<style>-:root {- --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;- --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;- --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;- --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;- --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;- --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;- --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;- --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;- --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;- --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;-}-*{margin:0;padding:0;box-sizing:border-box}-body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}-.container{max-width:1400px;margin:0 auto}-.header{margin-bottom:2rem}-.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}-.pulse-dot{width:12px;height:12px;background:var(--cloud-stroke);border-radius:50%;animation:pulse 2s infinite}-@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}-h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}-.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}-.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}-svg{width:100%;display:block}-.c-grid{stroke:var(--grid);fill:none}-.c-mask{fill:var(--mask);stroke:none}-.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}-.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}-.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}-.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}-.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}-.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}-.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}-.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}-.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}-.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}-.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}-.t-external{fill:var(--external-stroke)}-.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}-.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}-.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}-.m-security{fill:var(--security-stroke)}-</style>-</head>-<body>-<div class="container">- <div class="header">- <div class="header-row"><div class="pulse-dot"></div><h1>Hivenue CI/CD Pipeline</h1></div>- <p class="subtitle">Commit → tests → staging → e2e → production, with push-notification gates</p>- </div>- <div class="diagram-container">- <svg viewBox="0 0 1300 920" xmlns="http://www.w3.org/2000/svg">- <defs>- <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>- <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>- <marker id="arrowhead-security" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-security"/></marker>- <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>- </defs>- <rect width="100%" height="100%" fill="url(#grid)"/>-- <!-- A: Dev Environment -->- <rect x="500" y="40" width="220" height="74" rx="6" class="c-mask"/>- <rect x="500" y="40" width="220" height="74" rx="6" class="c-frontend" stroke-width="1.5"/>- <text x="610" y="68" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Hivenue Dev</text>- <text x="610" y="86" class="t-muted" font-size="9" text-anchor="middle">development environment</text>- <text x="610" y="102" class="t-frontend" font-size="8" text-anchor="middle">developer machine</text>-- <!-- B: Develop Branch -->- <rect x="500" y="180" width="220" height="64" rx="6" class="c-mask"/>- <rect x="500" y="180" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>- <text x="610" y="208" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">develop branch</text>- <text x="610" y="226" class="t-muted" font-size="9" text-anchor="middle">git push origin develop</text>-- <!-- C: Unit Test (decision) -->- <polygon points="610,300 800,365 610,430 420,365" class="c-mask"/>- <polygon points="610,300 800,365 610,430 420,365" class="c-backend" stroke-width="1.5"/>- <text x="610" y="358" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">Unit Test</text>- <text x="610" y="375" class="t-muted" font-size="9" text-anchor="middle">jest · istanbul</text>-- <!-- D: CI Fail -->- <rect x="100" y="335" width="200" height="60" rx="6" class="c-mask"/>- <rect x="100" y="335" width="200" height="60" rx="6" class="c-security" stroke-width="1.5"/>- <text x="200" y="362" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">CI Fail</text>- <text x="200" y="378" class="t-muted" font-size="9" text-anchor="middle">push notification</text>-- <!-- E: CI Pass -->- <rect x="500" y="490" width="220" height="60" rx="6" class="c-mask"/>- <rect x="500" y="490" width="220" height="60" rx="6" class="c-backend" stroke-width="1.5"/>- <text x="610" y="517" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">CI Pass</text>- <text x="610" y="533" class="t-muted" font-size="9" text-anchor="middle">push notification</text>-- <!-- F: e2e/UAT (decision) -->- <polygon points="610,610 800,675 610,740 420,675" class="c-mask"/>- <polygon points="610,610 800,675 610,740 420,675" class="c-backend" stroke-width="1.5"/>- <text x="610" y="668" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">e2e / UAT</text>- <text x="610" y="685" class="t-muted" font-size="9" text-anchor="middle">Playwright</text>-- <!-- G: CD Fail -->- <rect x="100" y="645" width="200" height="60" rx="6" class="c-mask"/>- <rect x="100" y="645" width="200" height="60" rx="6" class="c-security" stroke-width="1.5"/>- <text x="200" y="672" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">CD Fail</text>- <text x="200" y="688" class="t-muted" font-size="9" text-anchor="middle">push notification</text>-- <!-- H: CD Pass (decision) -->- <polygon points="970,610 1150,675 970,740 790,675" class="c-mask"/>- <polygon points="970,610 1150,675 970,740 790,675" class="c-cloud" stroke-width="1.5"/>- <text x="970" y="670" class="t-primary" font-size="12" font-weight="600" text-anchor="middle">CD Pass</text>- <text x="970" y="687" class="t-muted" font-size="9" text-anchor="middle">deployment gate</text>-- <!-- I: Production Release -->- <rect x="860" y="800" width="220" height="64" rx="6" class="c-mask"/>- <rect x="860" y="800" width="220" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>- <text x="970" y="828" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Production Release</text>- <text x="970" y="846" class="t-muted" font-size="9" text-anchor="middle">DigitalOcean</text>-- <!-- J: Deployment Success -->- <rect x="500" y="800" width="220" height="64" rx="6" class="c-mask"/>- <rect x="500" y="800" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>- <text x="610" y="828" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Deployment OK</text>- <text x="610" y="846" class="t-muted" font-size="9" text-anchor="middle">push notification</text>-- <!-- arrows -->- <line x1="610" y1="114" x2="610" y2="178" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="625" y="150" class="t-muted" font-size="9">code commit</text>-- <line x1="610" y1="244" x2="610" y2="298" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="625" y="275" class="t-muted" font-size="9">build</text>-- <!-- C -> D (Fail) -->- <path d="M 420 365 Q 360 365 320 365" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead-security)"/>- <text x="370" y="355" class="t-security" font-size="10" font-weight="600">Fail</text>-- <!-- C -> E (Pass) -->- <path d="M 610 430 L 610 488" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>- <text x="625" y="465" class="t-backend" font-size="10" font-weight="600">Pass</text>-- <!-- E -> F -->- <line x1="610" y1="550" x2="610" y2="608" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="625" y="582" class="t-muted" font-size="9">staging</text>-- <!-- F -> G (Fail) -->- <path d="M 420 675 Q 360 675 320 675" class="a-security" stroke-width="1.5" marker-end="url(#arrowhead-security)"/>- <text x="370" y="665" class="t-security" font-size="10" font-weight="600">Fail</text>-- <!-- F -> H (Pass) -->- <path d="M 800 675 L 788 675" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>- <text x="795" y="665" class="t-backend" font-size="10" font-weight="600" text-anchor="end">Pass</text>-- <!-- H -> I (continuous + approve, two paths bundled visually) -->- <path d="M 970 740 L 970 798" class="a-emphasis" stroke-width="2" marker-end="url(#arrowhead-emphasis)"/>- <text x="985" y="775" class="t-backend" font-size="9">deploy</text>-- <!-- I -> J -->- <line x1="858" y1="832" x2="722" y2="832" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="790" y="822" class="t-muted" font-size="9" text-anchor="middle">notify</text>- </svg>- </div>-</div>-</body>-</html>diff --git a/experiments/v3-mermaid-validation/output-C-archify/4.png b/experiments/v3-mermaid-validation/output-C-archify/4.pngdeleted file mode 100644index f47891c1..00000000Binary files a/experiments/v3-mermaid-validation/output-C-archify/4.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/output-C-archify/5.html b/experiments/v3-mermaid-validation/output-C-archify/5.htmldeleted file mode 100644index 3ce453bc..00000000--- a/experiments/v3-mermaid-validation/output-C-archify/5.html+++ /dev/null@@ -1,165 +0,0 @@-<!DOCTYPE html>-<html lang="en" data-theme="dark">-<head>-<meta charset="UTF-8">-<title>Taiga 3-tier — Archify</title>-<link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">-<style>-:root {- --bg:#020617; --grid:#1e293b; --text:#fff; --text-muted:#94a3b8; --text-dim:#475569;- --panel:rgba(15,23,42,0.5); --panel-border:#1e293b;- --arrow:#64748b; --arrow-emphasis:#34d399; --mask:#0f172a;- --frontend-fill:rgba(8,51,68,0.4); --frontend-stroke:#22d3ee;- --backend-fill:rgba(6,78,59,0.4); --backend-stroke:#34d399;- --database-fill:rgba(76,29,149,0.4); --database-stroke:#a78bfa;- --cloud-fill:rgba(120,53,15,0.3); --cloud-stroke:#fbbf24;- --security-fill:rgba(136,19,55,0.4); --security-stroke:#fb7185;- --messagebus-fill:rgba(251,146,60,0.3); --messagebus-stroke:#fb923c;- --external-fill:rgba(30,41,59,0.5); --external-stroke:#94a3b8;-}-*{margin:0;padding:0;box-sizing:border-box}-body{font-family:'JetBrains Mono',ui-monospace,Menlo,monospace;background:var(--bg);min-height:100vh;padding:2rem;color:var(--text)}-.container{max-width:1400px;margin:0 auto}-.header{margin-bottom:2rem}-.header-row{display:flex;align-items:center;gap:1rem;margin-bottom:.5rem}-.pulse-dot{width:12px;height:12px;background:var(--frontend-stroke);border-radius:50%;animation:pulse 2s infinite}-@keyframes pulse{0%,100%{opacity:1}50%{opacity:.5}}-h1{font-size:1.5rem;font-weight:700;letter-spacing:-.025em}-.subtitle{color:var(--text-muted);font-size:.875rem;margin-left:1.75rem}-.diagram-container{background:var(--panel);border-radius:1rem;border:1px solid var(--panel-border);padding:1.5rem;overflow-x:auto}-svg{width:100%;display:block}-.c-grid{stroke:var(--grid);fill:none}-.c-mask{fill:var(--mask);stroke:none}-.c-frontend{fill:var(--frontend-fill);stroke:var(--frontend-stroke)}-.c-backend{fill:var(--backend-fill);stroke:var(--backend-stroke)}-.c-database{fill:var(--database-fill);stroke:var(--database-stroke)}-.c-cloud{fill:var(--cloud-fill);stroke:var(--cloud-stroke)}-.c-security{fill:var(--security-fill);stroke:var(--security-stroke)}-.c-messagebus{fill:var(--messagebus-fill);stroke:var(--messagebus-stroke)}-.c-external{fill:var(--external-fill);stroke:var(--external-stroke)}-.t-primary{fill:var(--text)}.t-muted{fill:var(--text-muted)}.t-dim{fill:var(--text-dim)}-.t-frontend{fill:var(--frontend-stroke)}.t-backend{fill:var(--backend-stroke)}-.t-database{fill:var(--database-stroke)}.t-cloud{fill:var(--cloud-stroke)}-.t-security{fill:var(--security-stroke)}.t-messagebus{fill:var(--messagebus-stroke)}-.t-external{fill:var(--external-stroke)}-.a-default{stroke:var(--arrow);fill:none}.a-emphasis{stroke:var(--arrow-emphasis);fill:none}-.a-security{stroke:var(--security-stroke);fill:none;stroke-dasharray:5,5}-.m-default{fill:var(--arrow)}.m-emphasis{fill:var(--arrow-emphasis)}-.m-security{fill:var(--security-stroke)}-.tier-label{fill:var(--text-dim);font-size:10px;font-weight:600;text-transform:uppercase;letter-spacing:0.08em}-</style>-</head>-<body>-<div class="container">- <div class="header">- <div class="header-row"><div class="pulse-dot"></div><h1>Taiga — Scientific Data Platform</h1></div>- <p class="subtitle">Browser → Flask + Celery + Redis → Postgres + S3 + GCS, with external integrations</p>- </div>- <div class="diagram-container">- <svg viewBox="0 0 1300 760" xmlns="http://www.w3.org/2000/svg">- <defs>- <marker id="arrowhead" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-default"/></marker>- <marker id="arrowhead-emphasis" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0, 10 3.5, 0 7" class="m-emphasis"/></marker>- <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M 40 0 L 0 0 0 40" class="c-grid" stroke-width="0.5"/></pattern>- </defs>- <rect width="100%" height="100%" fill="url(#grid)"/>-- <!-- Tier labels -->- <text x="40" y="80" class="tier-label">Client</text>- <text x="40" y="240" class="tier-label">Application</text>- <text x="40" y="490" class="tier-label">Storage</text>- <text x="40" y="690" class="tier-label">External</text>-- <!-- Browser -->- <rect x="540" y="60" width="220" height="64" rx="6" class="c-mask"/>- <rect x="540" y="60" width="220" height="64" rx="6" class="c-frontend" stroke-width="1.5"/>- <text x="650" y="88" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Web Browser</text>- <text x="650" y="106" class="t-muted" font-size="9" text-anchor="middle">end user</text>-- <!-- Flask API -->- <rect x="180" y="220" width="220" height="64" rx="6" class="c-mask"/>- <rect x="180" y="220" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>- <text x="290" y="248" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Flask API</text>- <text x="290" y="266" class="t-muted" font-size="9" text-anchor="middle">HTTP / signed-URL gen</text>-- <!-- Redis Queue -->- <rect x="540" y="220" width="220" height="64" rx="6" class="c-mask"/>- <rect x="540" y="220" width="220" height="64" rx="6" class="c-messagebus" stroke-width="1.5"/>- <text x="650" y="248" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Redis Queue</text>- <text x="650" y="266" class="t-muted" font-size="9" text-anchor="middle">task broker</text>-- <!-- Celery Workers -->- <rect x="900" y="220" width="220" height="64" rx="6" class="c-mask"/>- <rect x="900" y="220" width="220" height="64" rx="6" class="c-backend" stroke-width="1.5"/>- <text x="1010" y="248" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Celery Workers</text>- <text x="1010" y="266" class="t-muted" font-size="9" text-anchor="middle">async file ops</text>-- <!-- PostgreSQL -->- <rect x="120" y="470" width="200" height="64" rx="6" class="c-mask"/>- <rect x="120" y="470" width="200" height="64" rx="6" class="c-database" stroke-width="1.5"/>- <text x="220" y="498" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">PostgreSQL</text>- <text x="220" y="516" class="t-muted" font-size="9" text-anchor="middle">metadata</text>-- <!-- AWS S3 -->- <rect x="430" y="470" width="200" height="64" rx="6" class="c-mask"/>- <rect x="430" y="470" width="200" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>- <text x="530" y="498" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">AWS S3</text>- <text x="530" y="516" class="t-muted" font-size="9" text-anchor="middle">object storage</text>-- <!-- GCS -->- <rect x="730" y="470" width="200" height="64" rx="6" class="c-mask"/>- <rect x="730" y="470" width="200" height="64" rx="6" class="c-cloud" stroke-width="1.5"/>- <text x="830" y="498" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Google Cloud Storage</text>- <text x="830" y="516" class="t-muted" font-size="9" text-anchor="middle">object storage</text>-- <!-- Figshare (external) -->- <rect x="430" y="670" width="200" height="64" rx="6" class="c-mask"/>- <rect x="430" y="670" width="200" height="64" rx="6" class="c-external" stroke-width="1.5"/>- <text x="530" y="698" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Figshare</text>- <text x="530" y="716" class="t-muted" font-size="9" text-anchor="middle">publish dataset</text>-- <!-- Email service -->- <rect x="730" y="670" width="200" height="64" rx="6" class="c-mask"/>- <rect x="730" y="670" width="200" height="64" rx="6" class="c-external" stroke-width="1.5"/>- <text x="830" y="698" class="t-primary" font-size="13" font-weight="600" text-anchor="middle">Email Service</text>- <text x="830" y="716" class="t-muted" font-size="9" text-anchor="middle">notifications</text>-- <!-- Browser -> Flask -->- <path d="M 540 90 Q 380 90 290 218" class="a-emphasis" stroke-width="1.5" marker-end="url(#arrowhead-emphasis)"/>- <text x="370" y="155" class="t-backend" font-size="10">HTTP / HTTPS</text>-- <!-- Flask -> Postgres -->- <line x1="290" y1="284" x2="240" y2="468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="220" y="380" class="t-muted" font-size="9">query</text>-- <!-- Flask -> Redis -->- <line x1="400" y1="252" x2="538" y2="252" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="469" y="244" class="t-muted" font-size="9" text-anchor="middle">enqueue</text>-- <!-- Redis -> Celery -->- <line x1="760" y1="252" x2="898" y2="252" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>- <text x="829" y="244" class="t-muted" font-size="9" text-anchor="middle">dispatch</text>-- <!-- Celery -> S3 -->- <path d="M 950 284 Q 800 350 580 468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>-- <!-- Celery -> GCS -->- <line x1="990" y1="284" x2="850" y2="468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)"/>-- <!-- Celery -> Figshare -->- <path d="M 980 284 Q 760 470 580 668" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.7"/>-- <!-- Celery -> Email -->- <path d="M 1020 284 Q 920 480 850 668" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" opacity="0.7"/>-- <!-- Flask -> S3 (signed URL) -->- <path d="M 380 280 Q 440 380 500 468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" stroke-dasharray="4,3" opacity="0.6"/>- <text x="475" y="380" class="t-muted" font-size="8">signed URL</text>-- <!-- Flask -> GCS (signed URL) -->- <path d="M 400 280 Q 600 380 800 468" class="a-default" stroke-width="1.5" marker-end="url(#arrowhead)" stroke-dasharray="4,3" opacity="0.4"/>- </svg>- </div>-</div>-</body>-</html>diff --git a/experiments/v3-mermaid-validation/output-C-archify/5.png b/experiments/v3-mermaid-validation/output-C-archify/5.pngdeleted file mode 100644index b45930e0..00000000Binary files a/experiments/v3-mermaid-validation/output-C-archify/5.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/img-01-k0di.png b/experiments/v3-mermaid-validation/screenshots/img-01-k0di.pngdeleted file mode 100644index 28e99b8f..00000000Binary files a/experiments/v3-mermaid-validation/screenshots/img-01-k0di.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/img-02-heh1.png b/experiments/v3-mermaid-validation/screenshots/img-02-heh1.pngdeleted file mode 100644index d9ae1b53..00000000Binary files a/experiments/v3-mermaid-validation/screenshots/img-02-heh1.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/img-03-w085.png b/experiments/v3-mermaid-validation/screenshots/img-03-w085.pngdeleted file mode 100644index 13fe5283..00000000Binary files a/experiments/v3-mermaid-validation/screenshots/img-03-w085.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/img-09-gzi9.png b/experiments/v3-mermaid-validation/screenshots/img-09-gzi9.pngdeleted file mode 100644index b45930e0..00000000Binary files a/experiments/v3-mermaid-validation/screenshots/img-09-gzi9.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/img-11-2cre.png b/experiments/v3-mermaid-validation/screenshots/img-11-2cre.pngdeleted file mode 100644index f47891c1..00000000Binary files a/experiments/v3-mermaid-validation/screenshots/img-11-2cre.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/img-14-plhu.png b/experiments/v3-mermaid-validation/screenshots/img-14-plhu.pngdeleted file mode 100644index d0317f8f..00000000Binary files a/experiments/v3-mermaid-validation/screenshots/img-14-plhu.png and /dev/null differdiff --git a/experiments/v3-mermaid-validation/screenshots/manifest.txt b/experiments/v3-mermaid-validation/screenshots/manifest.txtindex 1bd2e403..130c5812 100644--- a/experiments/v3-mermaid-validation/screenshots/manifest.txt+++ b/experiments/v3-mermaid-validation/screenshots/manifest.txt@@ -1,18 +1,12 @@# Manifest: randomized filename → (diagram, version)# Generated 2026-04-16T02:07:47Z-img-01-k0di.png → diagram=4 version=B-img-02-heh1.png → diagram=4 version=A-img-03-w085.png → diagram=5 version=Bimg-04-12c2.png → diagram=1 version=Cimg-05-n1tw.png → diagram=3 version=Cimg-06-hkrq.png → diagram=3 version=Aimg-07-43uu.png → diagram=1 version=Bimg-08-weo4.png → diagram=1 version=A-img-09-gzi9.png → diagram=5 version=Cimg-10-rnix.png → diagram=3 version=B-img-11-2cre.png → diagram=4 version=Cimg-12-nlmi.png → diagram=2 version=Bimg-13-5mj4.png → diagram=2 version=A-img-14-plhu.png → diagram=5 version=Aimg-15-05g2.png → diagram=2 version=Cdiff --git a/experiments/v3-mermaid-validation/sources/4-hivenue-cicd.mmd b/experiments/v3-mermaid-validation/sources/4-hivenue-cicd.mmddeleted file mode 100644index 189705be..00000000--- a/experiments/v3-mermaid-validation/sources/4-hivenue-cicd.mmd+++ /dev/null@@ -1,11 +0,0 @@-flowchart TD-A[Hivenue <br> Development <br> Environment] -->|Code <br> Commit| B[Develop <br> Branch]-B -->|Build <br> Dev <br> Distribution| C{Unit Test - jest <br> Test Coverage - istanbul}-C -->|Fail| D[CI Fail <br> Push Notification]-C -->|Pass| E[CI Pass <br> Push Notification]-E -->|Staging <br> DigitalOcean <br> Prod Distribution| F{e2e/UAT <br> Playwright Test}-F -->|Fail| G[CD Fail <br> Push Notification]-F -->|Pass| H{CD Pass <br> Push Notification}-H -->|Continuous <br> Deployment <br> Prod Distribution| I[Production <br> Release]-H -->|Approve <br> Deployment <br> Prod Distribution| I-I --> J[Deployment Success <br> Push Notification]diff --git a/experiments/v3-mermaid-validation/sources/5-taiga-3tier.mmd b/experiments/v3-mermaid-validation/sources/5-taiga-3tier.mmddeleted file mode 100644index 5d0ba28a..00000000--- a/experiments/v3-mermaid-validation/sources/5-taiga-3tier.mmd+++ /dev/null@@ -1,32 +0,0 @@-graph TD- subgraph "Client"- Browser[Web Browser]- end-- subgraph "Application Server"- Flask[Flask API]- Celery[Celery Workers]- Redis[Redis Queue]- end-- subgraph "Storage"- Postgres[PostgreSQL]- S3[AWS S3]- GCS[Google Cloud Storage]- end-- subgraph "External Services"- Figshare[Figshare]- Email[Email Service]- end-- Browser -->|HTTP/HTTPS| Flask- Flask -->|Query/Update| Postgres- Flask -->|Enqueue Tasks| Redis- Redis -->|Process Tasks| Celery- Celery -->|File Operations| S3- Celery -->|File Operations| GCS- Celery -->|Publish| Figshare- Celery -->|Send Notifications| Email- Flask -->|Generate Signed URLs| S3- Flask -->|Generate Signed URLs| GCSdiff --git a/scripts/gallery-template.html b/scripts/gallery-template.htmlindex 38c15406..95418ab9 100644--- a/scripts/gallery-template.html+++ b/scripts/gallery-template.html@@ -323,7 +323,7 @@ receipt [[CHECK_COUNT]] checks / [[ENTRY_COUNT]] artifacts / deterministic hashe<footer><div class="shell footer-inner"><span data-en="Generated from Archify's checked-in examples. No hand-authored capability claims." data-zh="由 Archify 仓库内示例自动生成,不手写可能过期的能力声明。">Generated from Archify's checked-in examples. No hand-authored capability claims.</span>- <span data-en="Archify v[[ARCHIFY_VERSION]] · stable · MIT" data-zh="Archify v[[ARCHIFY_VERSION]] · 稳定版 · MIT">Archify v[[ARCHIFY_VERSION]] · stable · MIT</span>+ <span data-en="Archify v[[ARCHIFY_VERSION]] · development · MIT" data-zh="Archify v[[ARCHIFY_VERSION]] · 开发版 · MIT">Archify v[[ARCHIFY_VERSION]] · development · MIT</span></div></footer>diff --git a/scripts/guide-template.html b/scripts/guide-template.htmlindex e8ccc1b9..a3580d79 100644--- a/scripts/guide-template.html+++ b/scripts/guide-template.html@@ -238,7 +238,7 @@</section></main>- <footer><div class="shell"><span data-i18n="footerLeft">Generated from the same recipe source as the Archify CLI.</span><span>archify guide "your scenario"</span><span data-i18n="versionLabel">Scenario guide / stable / v[[ARCHIFY_VERSION]]</span></div></footer>+ <footer><div class="shell"><span data-i18n="footerLeft">Generated from the same recipe source as the Archify CLI.</span><span>archify guide "your scenario"</span><span data-i18n="versionLabel">Scenario guide / development / v[[ARCHIFY_VERSION]]</span></div></footer><script id="guide-data" type="application/json">[[GUIDE_JSON]]</script><script src="assets/site-language.js"></script>@@ -253,12 +253,12 @@var lastRecipe = null;var copy = {en: {- navGuide:'Guide',navProof:'Proof Lab',navStart:'Start',navInstall:'Install Skill',versionLabel:'Scenario guide / stable / v[[ARCHIFY_VERSION]]',eyebrow:'Question-first diagramming', headline:'Choose the question.<br>Get the <em>right diagram.</em>', lede:'Describe what your audience needs to understand. Archify recommends one bounded visual recipe—plus the evidence it must contain, when not to use it, and a prompt you can copy.',+ navGuide:'Guide',navProof:'Proof Lab',navStart:'Start',navInstall:'Install Skill',versionLabel:'Scenario guide / development / v[[ARCHIFY_VERSION]]',eyebrow:'Question-first diagramming', headline:'Choose the question.<br>Get the <em>right diagram.</em>', lede:'Describe what your audience needs to understand. Archify recommends one bounded visual recipe—plus the evidence it must contain, when not to use it, and a prompt you can copy.',metricRecipes:'real-world<br>recipes',metricModes:'typed diagram<br>modes',metricRuntime:'runtime<br>dependencies',chooserTitle:'What must the diagram explain?',chooserBody:'Write a situation, not a diagram type. Specific system facts produce a stronger recommendation.',placeholder:'Example: Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.',recommend:'Recommend a recipe →',clear:'Clear',libraryEyebrow:'Recipe library',libraryTitle:'Eleven small, opinionated starting points.',libraryBody:'Each recipe answers one technical question. That boundary keeps the result legible, reviewable, and honest about missing evidence.',footerLeft:'Generated from the same recipe source as the Archify CLI.',all:'All recipes',recommended:'Recommended recipe',use:'Use when',avoid:'Avoid when',must:'Evidence to include',presentation:'Presentation',prompt:'Copy-ready prompt',copyPrompt:'Copy prompt',copied:'Copied',alternatives:'Other possible fits:',confidence:'confidence',open:'Open recipe',proofReady:'Verified proof',proofLink:'Open verified example ↗',samples:[['API + cache miss','Show an API request with JWT auth, a Redis cache miss, database fallback, and async tracing.'],['Kafka + DLQ','Map Kafka topics, ordered processors, consumer groups, replay, state stores, and the dead-letter queue.'],['Incident response','Show how responders detect, triage, mitigate, escalate, communicate, and verify recovery.']]},zh: {- navGuide:'场景指南',navProof:'验证作品集',navStart:'快速上手',navInstall:'安装技能',versionLabel:'场景指南 / 稳定版 / v[[ARCHIFY_VERSION]]',eyebrow:'先问题,后图表',headline:'先选对问题,<br>再得到<em>对的图。</em>',lede:'描述受众真正需要理解的内容。Archify 会推荐一个有边界的视觉配方,同时给出证据清单、禁用条件和可复制提示词。',+ navGuide:'场景指南',navProof:'验证作品集',navStart:'快速上手',navInstall:'安装技能',versionLabel:'场景指南 / 开发版 / v[[ARCHIFY_VERSION]]',eyebrow:'先问题,后图表',headline:'先选对问题,<br>再得到<em>对的图。</em>',lede:'描述受众真正需要理解的内容。Archify 会推荐一个有边界的视觉配方,同时给出证据清单、禁用条件和可复制提示词。',metricRecipes:'个真实场景<br>配方',metricModes:'种类型化<br>图表模式',metricRuntime:'个运行时<br>依赖',chooserTitle:'这张图必须解释什么?',chooserBody:'写清场景,不要只写图表类型。系统事实越具体,推荐越可靠。',placeholder:'例如:展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。',recommend:'推荐配方 →',clear:'清空',libraryEyebrow:'配方库',libraryTitle:'十一个小而专的起点。',libraryBody:'每个配方只回答一个技术问题。清晰的边界让图更易读、可评审,也不会掩盖证据缺口。',footerLeft:'网页与 Archify CLI 使用同一份配方数据生成。',all:'全部配方',recommended:'推荐配方',use:'适合',avoid:'不要这样用',must:'必须包含的证据',presentation:'表现建议',prompt:'可直接复制的提示词',copyPrompt:'复制提示词',copied:'已复制',alternatives:'其他可能:',confidence:'置信度',open:'打开配方',proofReady:'已验证成品',proofLink:'打开验证成品 ↗',samples:[['API + 缓存未命中','展示带 JWT 鉴权、Redis 缓存未命中、数据库回退和异步追踪的 API 请求。'],['Kafka + 死信','梳理 Kafka Topic、有序处理器、消费者组、重放、状态存储和死信队列。'],['事故处置','展示响应者如何发现、分诊、缓解、升级、沟通并验证恢复。']]}diff --git a/scripts/package-smoke.mjs b/scripts/package-smoke.mjsindex e5771f84..876f40c1 100644--- a/scripts/package-smoke.mjs+++ b/scripts/package-smoke.mjs@@ -59,6 +59,23 @@ try {requireAbsent('.hive');requireAbsent('.workbuddy');+ const packageLicensePath = path.join(skillRoot, 'LICENSE');+ if (!fs.existsSync(packageLicensePath)) {+ throw new Error('packaged skill is missing LICENSE');+ }+ const packageLicense = fs.readFileSync(packageLicensePath, 'utf8');+ const packageLicenseLines = packageLicense.split(/\r?\n/);+ if (!packageLicenseLines.includes('Copyright (c) 2025 Cocoon AI')) {+ throw new Error('packaged LICENSE is missing the exact Cocoon AI copyright line');+ }+ const repositoryLicense = fs.readFileSync(path.join(repoRoot, 'LICENSE'), 'utf8');+ if (packageLicense !== repositoryLicense) {+ throw new Error('packaged LICENSE must byte-match the repository LICENSE');+ }+ if (!packageLicense.includes('The above copyright notice and this permission notice shall be included in all')) {+ throw new Error('packaged LICENSE is missing the MIT notice-preservation terms');+ }+if (!fs.existsSync(updateChecker)) {throw new Error(`packaged update checker not found at ${updateChecker}`);}diff --git a/scripts/stage-clean-skill.mjs b/scripts/stage-clean-skill.mjsindex 4bbf93c6..2c114c2a 100644--- a/scripts/stage-clean-skill.mjs+++ b/scripts/stage-clean-skill.mjs@@ -7,6 +7,7 @@ import { fileURLToPath } from 'node:url';const scriptRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');const REQUIRED_INPUTS = new Set([+ 'archify/LICENSE','archify/renderers/shared/generated-validators.mjs','archify/scripts/check-update.mjs','archify/scripts/update-contract.mjs',diff --git a/scripts/start-template.html b/scripts/start-template.htmlindex 8aa1c471..70d7fab9 100644--- a/scripts/start-template.html+++ b/scripts/start-template.html@@ -268,7 +268,7 @@</section><footer class="page-footer">- <span data-en="Archify v[[ARCHIFY_VERSION]] · stable · self-contained HTML · typed JSON source" data-zh="Archify v[[ARCHIFY_VERSION]] · 稳定版 · 独立 HTML · 类型化 JSON 源">Archify v[[ARCHIFY_VERSION]] · stable · self-contained HTML · typed JSON source</span>+ <span data-en="Archify v[[ARCHIFY_VERSION]] · development · self-contained HTML · typed JSON source" data-zh="Archify v[[ARCHIFY_VERSION]] · 开发版 · 独立 HTML · 类型化 JSON 源">Archify v[[ARCHIFY_VERSION]] · development · self-contained HTML · typed JSON source</span><span id="copy-status" role="status" aria-live="polite"></span><a href="https://github.com/tt-a1i/archify" data-en="View source on GitHub ↗" data-zh="在 GitHub 查看源码 ↗">View source on GitHub ↗</a></footer>