Skip to content

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

feat: establish evidence-backed growth loops

tt-a1i733fb165d75c
diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
new file mode 100644
index 00000000..5ef8add0
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -0,0 +1,112 @@
+name: Report a reproducible bug
+description: Report a renderer, validator, package, or generated-artifact problem.
+title: "[Bug]: "
+labels:
+ - bug
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Stability comes first. A small typed JSON reproduction and the machine-readable validation receipt are the fastest path to a safe fix.
+
+ - type: input
+ id: archify_version
+ attributes:
+ label: Archify version or commit
+ placeholder: "2.12.0 or 0123456789abcdef..."
+ validations:
+ required: true
+
+ - type: dropdown
+ id: install_method
+ attributes:
+ label: Installation method
+ options:
+ - npm package
+ - Git clone
+ - Downloaded archify.zip
+ - Uploaded skill archive
+ - Other
+ validations:
+ required: true
+
+ - type: dropdown
+ id: diagram_type
+ attributes:
+ label: Diagram type
+ options:
+ - Architecture
+ - Workflow
+ - Sequence
+ - Data flow
+ - Lifecycle
+ - Installation or packaging
+ - Generated viewer
+ validations:
+ required: true
+
+ - type: textarea
+ id: command
+ attributes:
+ label: Exact command
+ description: Include flags and paths, replacing private path segments with neutral placeholders.
+ render: shell
+ validations:
+ required: true
+
+ - type: textarea
+ id: minimal_json
+ attributes:
+ label: Minimal redacted JSON reproduction
+ description: Remove unrelated nodes and facts while preserving the failure.
+ render: json
+ validations:
+ required: true
+
+ - type: textarea
+ id: validation_receipt
+ attributes:
+ label: Validation receipt or exact error
+ description: Prefer the complete JSON produced by `validate --json` or `deliver --json`.
+ render: json
+ validations:
+ required: true
+
+ - type: textarea
+ id: expected
+ attributes:
+ label: Expected behavior
+ validations:
+ required: true
+
+ - type: textarea
+ id: actual
+ attributes:
+ label: Actual behavior
+ validations:
+ required: true
+
+ - type: textarea
+ id: screenshot
+ attributes:
+ label: Optional final-artifact screenshot
+ description: Drag in a screenshot when the problem is visual. Mark the defect if it is subtle.
+
+ - type: textarea
+ id: environment
+ attributes:
+ label: Environment
+ description: Include operating system, Node.js version, coding client, and model when relevant.
+ placeholder: "macOS 15, Node.js 22, Cursor, model-name"
+ validations:
+ required: true
+
+ - type: checkboxes
+ id: sensitive_data
+ attributes:
+ label: Final checks
+ options:
+ - label: I searched existing issues for the same problem.
+ required: true
+ - label: I removed access tokens, credentials, private repository contents, and personal or customer data.
+ required: true
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..0086358d
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1 @@
+blank_issues_enabled: true
diff --git a/.github/ISSUE_TEMPLATE/showcase.yml b/.github/ISSUE_TEMPLATE/showcase.yml
new file mode 100644
index 00000000..8da5be66
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/showcase.yml
@@ -0,0 +1,125 @@
+name: Share an Archify diagram
+description: Submit a real, reproducible diagram for the community showcase.
+title: "[Showcase]: "
+labels:
+ - documentation
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for sharing real-world proof. Please attach enough evidence for maintainers to reproduce and validate the result. Redact private repository details before submitting.
+
+ - type: dropdown
+ id: diagram_type
+ attributes:
+ label: Diagram type
+ options:
+ - Architecture
+ - Workflow
+ - Sequence
+ - Data flow
+ - Lifecycle
+ validations:
+ required: true
+
+ - type: input
+ id: archify_version
+ attributes:
+ label: Archify version or commit
+ description: Use an exact package version or full repository commit when possible.
+ placeholder: "2.12.0 or 0123456789abcdef..."
+ validations:
+ required: true
+
+ - type: input
+ id: agent
+ attributes:
+ label: Agent or coding client
+ placeholder: "Codex, Claude Code, Cursor, opencode..."
+ validations:
+ required: true
+
+ - type: input
+ id: model
+ attributes:
+ label: Model
+ placeholder: "Provider and exact model name"
+ validations:
+ required: true
+
+ - type: textarea
+ id: prompt
+ attributes:
+ label: Original prompt
+ description: Share the first prompt used to request this diagram. Redact repository or customer identifiers if needed.
+ render: text
+ validations:
+ required: true
+
+ - type: textarea
+ id: source_json
+ attributes:
+ label: Redacted typed JSON source
+ description: Paste the candidate Archify JSON or attach it as a file. Keep the topology needed to reproduce the result.
+ render: json
+ validations:
+ required: true
+
+ - type: textarea
+ id: artifact
+ attributes:
+ label: Artifact
+ description: Drag in a screenshot and, when practical, attach or link the self-contained HTML, PNG, or WebM.
+ validations:
+ required: true
+
+ - type: textarea
+ id: validation_receipt
+ attributes:
+ label: Validation receipt
+ description: Paste the complete JSON from `archify validate ... --quality showcase --json` or `archify deliver ... --json`.
+ render: json
+ validations:
+ required: true
+
+ - type: dropdown
+ id: visual_review
+ attributes:
+ label: Final artifact visual review
+ description: Inspect the final browser artifact or raster, not only the source JSON.
+ options:
+ - Passed — no visible defects found
+ - Failed — defects remain and are described below
+ - Skipped — no capable reviewer or image reader was available
+ validations:
+ required: true
+
+ - type: textarea
+ id: visual_notes
+ attributes:
+ label: Visual review notes
+ description: Record clipping, overlaps, hidden routes, weak hierarchy, whitespace, or contrast findings.
+
+ - type: checkboxes
+ id: sensitive_data
+ attributes:
+ label: Sensitive-data check
+ options:
+ - label: I removed access tokens, credentials, private repository contents, and personal or customer data.
+ required: true
+
+ - type: checkboxes
+ id: sharing_rights
+ attributes:
+ label: Sharing rights
+ options:
+ - label: I created this submission or otherwise have the right to share every attached source and artifact publicly.
+ required: true
+
+ - type: checkboxes
+ id: public_permission
+ attributes:
+ label: Permission to feature
+ options:
+ - label: I allow Archify maintainers to reproduce and feature this submission in the repository, documentation, gallery, and project website under the repository license, with attribution to my GitHub account.
+ required: true
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 00000000..92e0a057
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,35 @@
+## Problem and value
+
+What user problem does this solve? Link the issue or showcase evidence when one exists.
+
+## Scope
+
+- What changed:
+- What deliberately did not change:
+- No unrelated changes: <!-- confirm or explain -->
+
+## Stability impact
+
+- Compatibility and migration risk:
+- Renderer, validator, package, or generated-artifact risk:
+- Failure behavior and rollback path:
+
+## Tests run
+
+List exact commands and results. Do not write only “tests pass.”
+
+## Visual evidence
+
+For visible changes, attach before/after final-artifact screenshots and state whether visual review passed, failed, or was skipped. Write “Not applicable” for non-visual changes.
+
+## Generated artifacts
+
+List regenerated files such as Gallery pages, guides, README proofs, or `archify.zip`. If none changed, explain why they remain fresh.
+
+## Checklist
+
+- [ ] I used a minimal focused change and preserved existing typed JSON behavior unless the issue requires a contract change.
+- [ ] I ran the relevant targeted tests and `npm test` in `archify/`.
+- [ ] I added or updated a regression test for behavioral changes.
+- [ ] I checked generated artifacts and package freshness when their sources changed.
+- [ ] I removed secrets, private repository content, and customer data from fixtures and screenshots.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 00000000..87441925
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,71 @@
+# Contributing to Archify
+
+Thank you for helping Archify make engineering diagrams more trustworthy and useful. Stability comes before feature count: small reproductions, explicit contracts, and evidence-backed changes are easier to review and safer to ship.
+
+## Choose the right path
+
+- Found a renderer, validator, package, or viewer problem? Use [the bug report form](.github/ISSUE_TEMPLATE/bug-report.yml).
+- Made a useful real-world diagram? Use [the showcase form](.github/ISSUE_TEMPLATE/showcase.yml).
+- Want to change behavior? Open or link an issue before a broad refactor so the contract and non-goals are clear.
+- Found a security vulnerability? Do not open a public reproduction containing exploit details or secrets; use GitHub's private security reporting for this repository.
+
+Do not include secrets, access tokens, credentials, private repository content, personal data, or customer data in prompts, JSON fixtures, logs, screenshots, or generated artifacts.
+
+## Local setup
+
+The renderer package lives in `archify/` and supports Node.js 20 and 22.
+
+```bash
+cd archify
+npm ci
+npm test
+```
+
+During development, run the narrowest relevant test first, then the full suite before opening a pull request. Behavioral fixes should include a failing regression test that demonstrates the problem before the implementation changes.
+
+## Bug fixes
+
+A useful bug report contains:
+
+1. The exact Archify version or commit, installation method, command, and environment.
+2. The smallest redacted typed JSON that still reproduces the failure.
+3. The complete machine-readable validation receipt or exact error.
+4. Expected versus actual behavior.
+5. A final-artifact screenshot only when the problem is visual.
+
+Do not replace deterministic evidence with a screenshot. For visual defects, keep both the validator result and the final rendered evidence.
+
+## Community showcase submissions
+
+Showcase cases should be reproducible proof, not promotional screenshots. Submit the original prompt, agent/client, exact model, Archify version, redacted typed JSON, artifact, validation receipt, and truthful visual-review status through `.github/ISSUE_TEMPLATE/showcase.yml`.
+
+Maintainers may ask for a smaller source file, rerun validation, or decline a case that cannot be safely published. A submission is not guaranteed inclusion. Accepted cases should preserve author attribution and must not be presented as proof of model quality without a controlled benchmark protocol.
+
+## Pull requests
+
+Keep a pull request focused on one behavior or one tightly related delivery slice. Describe its non-goals, compatibility risk, failure behavior, tests, and rollback path. Preserve unrelated worktree changes and generated files.
+
+From the repository root, regenerate only the artifacts whose sources changed:
+
+```bash
+node scripts/build-gallery.mjs docs
+node scripts/build-guide.mjs docs/guide.html
+node scripts/build-start.mjs docs/start.html
+node scripts/build-readme-showcase.mjs
+node scripts/build-zip.sh /tmp/archify-contrib.zip
+```
+
+Bundled example or viewer changes normally require the Gallery rebuild. Skill runtime, schema, renderer, or published `SKILL.md` changes require checking `archify.zip` freshness and committing a rebuilt archive when the checked-in package contents differ. Do not regenerate unrelated artifacts simply to produce a large diff.
+
+Before submitting:
+
+```bash
+cd archify
+npm test
+```
+
+Fill in `.github/PULL_REQUEST_TEMPLATE.md` with exact commands and results. Visible changes need before/after final-artifact evidence and a truthful `passed`, `failed`, or `skipped` visual-review status.
+
+## License
+
+By contributing, you agree that your contribution is provided under the repository's [MIT License](LICENSE). Only submit work you created or have the right to contribute.
diff --git a/README.md b/README.md
index 5a42741e..01813261 100644
--- a/README.md
+++ b/README.md
@@ -274,4 +274,4 @@ Archify is a fork and rewrite of [Cocoon-AI/architecture-diagram-generator](http
## Contributing
-Issues, pull requests, and shared diagrams are welcome. For generated-output problems, include the prompt, diagram type, and Archify version. Run `node scripts/build-gallery.mjs` after changing bundled examples or the standalone viewer.
+Issues, pull requests, and real-world diagrams are welcome. Start with the [contribution guide](CONTRIBUTING.md), use the reproducible bug form for failures, or submit a validated diagram through the community showcase form.
diff --git a/README_EN.md b/README_EN.md
index 5a42741e..01813261 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -274,4 +274,4 @@ Archify is a fork and rewrite of [Cocoon-AI/architecture-diagram-generator](http
## Contributing
-Issues, pull requests, and shared diagrams are welcome. For generated-output problems, include the prompt, diagram type, and Archify version. Run `node scripts/build-gallery.mjs` after changing bundled examples or the standalone viewer.
+Issues, pull requests, and real-world diagrams are welcome. Start with the [contribution guide](CONTRIBUTING.md), use the reproducible bug form for failures, or submit a validated diagram through the community showcase form.
diff --git a/README_ZH.md b/README_ZH.md
index a98624eb..95538720 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -273,4 +273,4 @@ Archify 基于 [Cocoon-AI/architecture-diagram-generator](https://github.com/Coc
## 参与贡献
-欢迎提交 Issue、Pull Request 和分享生成的图。报告产物问题时,请附上 Prompt、图表类型和 Archify 版本。修改内置示例或独立 Viewer 后,请运行 `node scripts/build-gallery.mjs` 同步自动生成作品集。
+欢迎提交 Issue、Pull Request 和真实场景图。请先阅读[贡献指南](CONTRIBUTING.md);遇到问题时使用可复现 Bug 表单,也可以通过社区 Showcase 表单提交已验证成品。
diff --git a/archify.zip b/archify.zip
index d1c2c889..7773ce1d 100644
Binary files a/archify.zip and b/archify.zip differ
diff --git a/archify/examples/dataflow-product-analytics.html b/archify/examples/dataflow-product-analytics.html
index 73017361..07df163b 100644
--- a/archify/examples/dataflow-product-analytics.html
+++ b/archify/examples/dataflow-product-analytics.html
@@ -5015,7 +5015,7 @@
<!-- Footer -->
<p class="footer">
- Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/archify/examples/lifecycle-agent-run.html b/archify/examples/lifecycle-agent-run.html
index 2334d261..6f0d0838 100644
--- a/archify/examples/lifecycle-agent-run.html
+++ b/archify/examples/lifecycle-agent-run.html
@@ -4968,7 +4968,7 @@
<!-- Footer -->
<p class="footer">
- Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/archify/examples/sequence-cache-miss-request.html b/archify/examples/sequence-cache-miss-request.html
index 3574d859..7c787c7e 100644
--- a/archify/examples/sequence-cache-miss-request.html
+++ b/archify/examples/sequence-cache-miss-request.html
@@ -5019,7 +5019,7 @@
<!-- Footer -->
<p class="footer">
- Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/archify/examples/web-app-rendered.html b/archify/examples/web-app-rendered.html
index 02ad0191..9d4d2c56 100644
--- a/archify/examples/web-app-rendered.html
+++ b/archify/examples/web-app-rendered.html
@@ -4984,7 +4984,7 @@
<!-- Footer -->
<p class="footer">
- Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/archify/examples/workflow-agent-tool-call-rendered.html b/archify/examples/workflow-agent-tool-call-rendered.html
index d4c59fb5..08d9f501 100644
--- a/archify/examples/workflow-agent-tool-call-rendered.html
+++ b/archify/examples/workflow-agent-tool-call-rendered.html
@@ -5048,7 +5048,7 @@
<!-- Footer -->
<p class="footer">
- Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/archify/renderers/shared/cli.mjs b/archify/renderers/shared/cli.mjs
index f35a7b14..3b09e0b2 100644
--- a/archify/renderers/shared/cli.mjs
+++ b/archify/renderers/shared/cli.mjs
@@ -36,7 +36,7 @@ export function writeDiagram({ outPath, template, diagramType, meta, footerLabel
const guidedHint = Array.isArray(meta.views) && meta.views.length
? ' &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story'
: '';
- const startUrl = `https://tt-a1i.github.io/archify/start.html?type=${esc(diagramType)}`;
+ const startUrl = `https://tt-a1i.github.io/archify/start.html?type=${esc(diagramType)}&amp;source=artifact`;
fs.writeFileSync(outPath, applyTemplate(template, {
title: meta.title,
subtitle: meta.subtitle,
diff --git a/archify/test/community-proof-intake.test.mjs b/archify/test/community-proof-intake.test.mjs
new file mode 100644
index 00000000..b3652062
--- /dev/null
+++ b/archify/test/community-proof-intake.test.mjs
@@ -0,0 +1,85 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, '../..');
+
+function read(relativePath) {
+ return fs.readFileSync(path.join(repoRoot, relativePath), 'utf8');
+}
+
+test('showcase intake requires reproducible proof, redaction, and explicit publication permission', () => {
+ const template = read('.github/ISSUE_TEMPLATE/showcase.yml');
+
+ for (const field of [
+ 'id: diagram_type',
+ 'id: archify_version',
+ 'id: agent',
+ 'id: model',
+ 'id: prompt',
+ 'id: source_json',
+ 'id: artifact',
+ 'id: validation_receipt',
+ 'id: visual_review',
+ 'id: sensitive_data',
+ 'id: sharing_rights',
+ 'id: public_permission',
+ ]) {
+ assert.match(template, new RegExp(field), field);
+ }
+ assert.match(template, /access tokens/i);
+ assert.match(template, /personal or customer data/i);
+ assert.match(template, /repository, documentation, gallery, and project website/i);
+ assert.match(template, /required:\s*true/g);
+});
+
+test('bug intake captures a minimal deterministic reproduction before visual diagnosis', () => {
+ const template = read('.github/ISSUE_TEMPLATE/bug-report.yml');
+
+ for (const field of [
+ 'id: archify_version',
+ 'id: install_method',
+ 'id: diagram_type',
+ 'id: command',
+ 'id: minimal_json',
+ 'id: validation_receipt',
+ 'id: expected',
+ 'id: actual',
+ 'id: environment',
+ 'id: sensitive_data',
+ ]) {
+ assert.match(template, new RegExp(field), field);
+ }
+ assert.ok(
+ template.indexOf('id: validation_receipt') < template.indexOf('id: screenshot'),
+ 'deterministic evidence should be requested before optional visual evidence',
+ );
+});
+
+test('contributor and pull-request guides keep proof changes reproducible and stability-first', () => {
+ const contributing = read('CONTRIBUTING.md');
+ const pullRequest = read('.github/PULL_REQUEST_TEMPLATE.md');
+
+ for (const required of [
+ '.github/ISSUE_TEMPLATE/showcase.yml',
+ '.github/ISSUE_TEMPLATE/bug-report.yml',
+ 'npm test',
+ 'node scripts/build-gallery.mjs docs',
+ 'node scripts/build-zip.sh',
+ 'Do not include secrets',
+ ]) {
+ assert.match(contributing, new RegExp(required.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')), required);
+ }
+ for (const required of [
+ 'Stability impact',
+ 'Tests run',
+ 'Generated artifacts',
+ 'Visual evidence',
+ 'No unrelated changes',
+ ]) {
+ assert.match(pullRequest, new RegExp(required), required);
+ }
+});
diff --git a/archify/test/landing.test.mjs b/archify/test/landing.test.mjs
index 1fa030c8..340241c4 100644
--- a/archify/test/landing.test.mjs
+++ b/archify/test/landing.test.mjs
@@ -37,7 +37,7 @@ test('landing metadata describes the full technical-diagram product and trusted
test('landing hero leads with three real generated proof artifacts', () => {
assert.match(landing, /id="hero-proof-stage"/);
assert.match(landing, /id="hero-proof-panel" role="tabpanel"/);
- assert.equal((landing.match(/class="proof-tab"/g) || []).length, 3);
+ assert.equal((landing.match(/class="spec-card"/g) || []).length, 3);
assert.equal((landing.match(/role="tab"/g) || []).length, 3);
assert.doesNotMatch(landing, /class="hero-screenshot/);
diff --git a/archify/test/ordinary-model-floor.test.mjs b/archify/test/ordinary-model-floor.test.mjs
new file mode 100644
index 00000000..1fbfa065
--- /dev/null
+++ b/archify/test/ordinary-model-floor.test.mjs
@@ -0,0 +1,546 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const skillRoot = path.resolve(here, '..');
+const repoRoot = path.resolve(skillRoot, '..');
+const benchmark = path.join(repoRoot, 'benchmarks/ordinary-model-floor/benchmark.mjs');
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-ordinary-model-floor-'));
+
+function writeJson(name, value) {
+ const file = path.join(tmp, name);
+ fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`);
+ return file;
+}
+
+function run(args) {
+ return spawnSync(process.execPath, [benchmark, ...args], {
+ cwd: repoRoot,
+ encoding: 'utf8',
+ });
+}
+
+test('benchmark verifies one first-pass architecture candidate through semantic, renderer, and visual-review gates', () => {
+ const caseFile = writeJson('web-runtime.case.json', {
+ schema_version: 1,
+ id: 'web-runtime-architecture',
+ diagram_type: 'architecture',
+ quality_profile: 'showcase',
+ requirements: {
+ node_ids: ['users', 'cdn', 'lb', 'api', 'db'],
+ relationships: [
+ { from: 'users', to: 'cdn' },
+ { from: 'cdn', to: 'lb' },
+ { from: 'lb', to: 'api' },
+ { from: 'api', to: 'db' },
+ ],
+ },
+ });
+ const runFile = writeJson('web-runtime.run.json', {
+ schema_version: 1,
+ case_id: 'web-runtime-architecture',
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: {
+ status: 'passed',
+ reviewer: 'fixture-reviewer',
+ defects: [],
+ },
+ });
+ const candidate = path.join(skillRoot, 'examples/web-app.architecture.json');
+
+ const result = run(['verify', '--case', caseFile, '--candidate', candidate, '--run', runFile]);
+
+ assert.equal(result.status, 0, result.stderr || result.stdout);
+ assert.equal(result.stderr, '');
+ const receipt = JSON.parse(result.stdout);
+ assert.equal(receipt.schemaVersion, 1);
+ assert.equal(receipt.benchmark, 'ordinary-model-floor');
+ assert.equal(receipt.caseId, 'web-runtime-architecture');
+ assert.deepEqual(receipt.run, {
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ });
+ assert.equal(receipt.gates.semantic.ok, true);
+ assert.deepEqual(receipt.gates.semantic.missingNodeIds, []);
+ assert.deepEqual(receipt.gates.semantic.missingRelationships, []);
+ assert.equal(receipt.gates.validation.ok, true);
+ assert.equal(receipt.gates.validation.checksPassed, 9);
+ assert.deepEqual(receipt.gates.validation.composition, { errors: 0, warnings: 0 });
+ assert.deepEqual(receipt.gates.visualReview, {
+ status: 'passed',
+ reviewer: 'fixture-reviewer',
+ defects: [],
+ });
+ assert.equal(receipt.firstPassUsable, true);
+});
+
+test('benchmark rejects a renderer-valid candidate that changes required technical roles or relationship labels', () => {
+ const source = JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples/web-app.architecture.json'), 'utf8'));
+ source.components.find((component) => component.id === 'cache').type = 'frontend';
+ source.connections.find((connection) => connection.from === 'api' && connection.to === 'db').label = 'HTTP';
+ const candidate = writeJson('semantic-drift.architecture.json', source);
+ const caseFile = writeJson('semantic-drift.case.json', {
+ schema_version: 1,
+ id: 'semantic-drift-architecture',
+ diagram_type: 'architecture',
+ quality_profile: 'showcase',
+ requirements: {
+ nodes: [
+ { id: 'cache', type: 'database' },
+ { id: 'db', type: 'database' },
+ ],
+ relationships: [
+ { from: 'api', to: 'cache', label: 'read-through' },
+ { from: 'api', to: 'db', label: 'SQL' },
+ ],
+ },
+ });
+ const runFile = writeJson('semantic-drift.run.json', {
+ schema_version: 1,
+ case_id: 'semantic-drift-architecture',
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: {
+ status: 'passed',
+ reviewer: 'fixture-reviewer',
+ defects: [],
+ },
+ });
+
+ const result = run(['verify', '--case', caseFile, '--candidate', candidate, '--run', runFile]);
+
+ assert.equal(result.status, 1, result.stderr || result.stdout);
+ assert.equal(result.stderr, '');
+ const receipt = JSON.parse(result.stdout);
+ assert.equal(receipt.gates.validation.ok, true, 'the deterministic renderer should still accept this controlled drift');
+ assert.equal(receipt.gates.semantic.ok, false);
+ assert.deepEqual(receipt.gates.semantic.mismatchedNodes, [
+ { id: 'cache', field: 'type', expected: 'database', actual: 'frontend' },
+ ]);
+ assert.deepEqual(receipt.gates.semantic.missingRelationships, [
+ { from: 'api', to: 'db', label: 'SQL' },
+ ]);
+ assert.equal(receipt.firstPassUsable, false);
+});
+
+test('benchmark never accepts a visual pass without an identified reviewer', () => {
+ const caseFile = writeJson('unreviewed.case.json', {
+ schema_version: 1,
+ id: 'unreviewed-architecture',
+ diagram_type: 'architecture',
+ quality_profile: 'showcase',
+ requirements: {
+ node_ids: ['users', 'api', 'db'],
+ relationships: [{ from: 'api', to: 'db' }],
+ },
+ });
+ const runFile = writeJson('unreviewed.run.json', {
+ schema_version: 1,
+ case_id: 'unreviewed-architecture',
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: {
+ status: 'passed',
+ reviewer: '',
+ defects: [],
+ },
+ });
+ const candidate = path.join(skillRoot, 'examples/web-app.architecture.json');
+
+ const result = run(['verify', '--case', caseFile, '--candidate', candidate, '--run', runFile]);
+
+ assert.equal(result.status, 1, result.stderr || result.stdout);
+ assert.equal(result.stderr, '');
+ const receipt = JSON.parse(result.stdout);
+ assert.equal(receipt.gates.semantic.ok, true);
+ assert.equal(receipt.gates.validation.ok, true);
+ assert.deepEqual(receipt.gates.visualReview, {
+ status: 'invalid',
+ reviewer: null,
+ defects: [],
+ reason: 'passed visual review requires a non-empty reviewer identity',
+ });
+ assert.equal(receipt.firstPassUsable, false);
+});
+
+test('benchmark applies the same semantic and delivery seam to workflow, sequence, data-flow, and lifecycle candidates', () => {
+ const cases = [
+ {
+ type: 'workflow',
+ example: 'agent-tool-call.workflow.json',
+ nodes: [{ id: 'approval', type: 'security' }, { id: 'tool', type: 'messagebus' }],
+ relationships: [{ from: 'router', to: 'approval', label: 'needs approval?' }],
+ },
+ {
+ type: 'sequence',
+ example: 'cache-miss-request.sequence.json',
+ nodes: [{ id: 'redis', type: 'database' }, { id: 'db', type: 'database' }],
+ relationships: [{ from: 'redis', to: 'api', label: 'miss' }],
+ },
+ {
+ type: 'dataflow',
+ example: 'product-analytics.dataflow.json',
+ nodes: [{ id: 'consent', type: 'security' }, { id: 'pii', type: 'security' }],
+ relationships: [{ from: 'consent', to: 'pii', label: 'identity map' }],
+ },
+ {
+ type: 'lifecycle',
+ example: 'agent-run.lifecycle.json',
+ nodes: [{ id: 'approval', type: 'waiting' }, { id: 'cancelled', type: 'failure' }],
+ relationships: [{ from: 'approval', to: 'cancelled', variant: 'security' }],
+ },
+ ];
+
+ for (const item of cases) {
+ const caseId = `${item.type}-representative`;
+ const caseFile = writeJson(`${caseId}.case.json`, {
+ schema_version: 1,
+ id: caseId,
+ diagram_type: item.type,
+ quality_profile: 'showcase',
+ requirements: {
+ nodes: item.nodes,
+ relationships: item.relationships,
+ },
+ });
+ const runFile = writeJson(`${caseId}.run.json`, {
+ schema_version: 1,
+ case_id: caseId,
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: {
+ status: 'passed',
+ reviewer: 'fixture-reviewer',
+ defects: [],
+ },
+ });
+ const candidate = path.join(skillRoot, 'examples', item.example);
+
+ const result = run(['verify', '--case', caseFile, '--candidate', candidate, '--run', runFile]);
+
+ assert.equal(result.status, 0, `${item.type}: ${result.stderr || result.stdout}`);
+ const receipt = JSON.parse(result.stdout);
+ assert.equal(receipt.gates.semantic.ok, true, item.type);
+ assert.equal(receipt.gates.validation.ok, true, item.type);
+ assert.equal(receipt.firstPassUsable, true, item.type);
+ }
+});
+
+test('benchmark report separates first-pass usable rate from semantic, validation, and visual-review failures by configuration', () => {
+ const resultsFile = path.join(tmp, 'benchmark-results.jsonl');
+ const rows = [
+ {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ caseId: 'architecture-runtime',
+ run: { agent: 'codex', model: 'strong', attempt: 1 },
+ gates: {
+ semantic: { ok: true },
+ validation: { ok: true },
+ visualReview: { status: 'passed', reviewer: 'reviewer', defects: [] },
+ },
+ firstPassUsable: true,
+ },
+ {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ caseId: 'sequence-cache-miss',
+ run: { agent: 'codex', model: 'strong', attempt: 1 },
+ gates: {
+ semantic: { ok: true },
+ validation: { ok: true },
+ visualReview: { status: 'passed', reviewer: 'reviewer', defects: [] },
+ },
+ firstPassUsable: true,
+ },
+ {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ caseId: 'architecture-runtime',
+ run: { agent: 'opencode', model: 'ordinary', attempt: 1 },
+ gates: {
+ semantic: { ok: false },
+ validation: { ok: true },
+ visualReview: { status: 'passed', reviewer: 'reviewer', defects: [] },
+ },
+ firstPassUsable: false,
+ },
+ {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ caseId: 'sequence-cache-miss',
+ run: { agent: 'opencode', model: 'ordinary', attempt: 1 },
+ gates: {
+ semantic: { ok: true },
+ validation: { ok: false },
+ visualReview: { status: 'skipped', reviewer: null, defects: [] },
+ },
+ firstPassUsable: false,
+ },
+ ];
+ fs.writeFileSync(resultsFile, `${rows.map((row) => JSON.stringify(row)).join('\n')}\n`);
+
+ const result = run(['report', '--results', resultsFile]);
+
+ assert.equal(result.status, 0, result.stderr || result.stdout);
+ assert.equal(result.stderr, '');
+ const report = JSON.parse(result.stdout);
+ assert.equal(report.schemaVersion, 1);
+ assert.equal(report.benchmark, 'ordinary-model-floor');
+ assert.deepEqual(report.overall, {
+ runs: 4,
+ firstPassUsable: 2,
+ firstPassUsableRate: 0.5,
+ failureClusters: {
+ semantic: 1,
+ validation: 1,
+ visualReview: 1,
+ },
+ });
+ assert.deepEqual(report.byConfiguration, [
+ {
+ agent: 'codex',
+ model: 'strong',
+ runs: 2,
+ firstPassUsable: 2,
+ firstPassUsableRate: 1,
+ failureClusters: { semantic: 0, validation: 0, visualReview: 0 },
+ },
+ {
+ agent: 'opencode',
+ model: 'ordinary',
+ runs: 2,
+ firstPassUsable: 0,
+ firstPassUsableRate: 0,
+ failureClusters: { semantic: 1, validation: 1, visualReview: 1 },
+ },
+ ]);
+});
+
+test('benchmark semantic requirements bind by accepted technical labels instead of forcing model-authored internal IDs', () => {
+ const source = JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples/web-app.architecture.json'), 'utf8'));
+ const rename = new Map([
+ ['api', 'service-api-v1'],
+ ['cache', 'redis-cache-v1'],
+ ]);
+ for (const component of source.components) component.id = rename.get(component.id) || component.id;
+ for (const connection of source.connections) {
+ connection.from = rename.get(connection.from) || connection.from;
+ connection.to = rename.get(connection.to) || connection.to;
+ }
+ for (const view of source.meta.views || []) {
+ view.focus = view.focus.map((id) => rename.get(id) || id);
+ }
+ for (const boundary of source.boundaries || []) {
+ boundary.wraps = boundary.wraps.map((id) => rename.get(id) || id);
+ }
+ const candidate = writeJson('semantic-aliases.architecture.json', source);
+ const caseFile = writeJson('semantic-aliases.case.json', {
+ schema_version: 1,
+ id: 'semantic-aliases-architecture',
+ diagram_type: 'architecture',
+ quality_profile: 'showcase',
+ requirements: {
+ nodes: [
+ { key: 'api', labels: ['API', 'API Server'], type: 'backend' },
+ { key: 'cache', labels: ['Redis', 'Redis Cache'], type: 'database' },
+ ],
+ relationships: [
+ { from: 'api', to: 'cache', labels: ['read-through', 'cache read'] },
+ ],
+ },
+ });
+ const runFile = writeJson('semantic-aliases.run.json', {
+ schema_version: 1,
+ case_id: 'semantic-aliases-architecture',
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: {
+ status: 'passed',
+ reviewer: 'fixture-reviewer',
+ defects: [],
+ },
+ });
+
+ const result = run(['verify', '--case', caseFile, '--candidate', candidate, '--run', runFile]);
+
+ assert.equal(result.status, 0, result.stderr || result.stdout);
+ const receipt = JSON.parse(result.stdout);
+ assert.equal(receipt.gates.semantic.ok, true);
+ assert.deepEqual(receipt.gates.semantic.bindings, {
+ api: 'service-api-v1',
+ cache: 'redis-cache-v1',
+ });
+ assert.equal(receipt.firstPassUsable, true);
+});
+
+test('checked-in benchmark suite covers all five diagram types without presenting reference fixtures as model evidence', () => {
+ const manifest = path.join(repoRoot, 'benchmarks/ordinary-model-floor/manifest.json');
+
+ const result = run(['check', '--manifest', manifest]);
+
+ assert.equal(result.status, 0, result.stderr || result.stdout);
+ assert.equal(result.stderr, '');
+ const receipt = JSON.parse(result.stdout);
+ assert.equal(receipt.schemaVersion, 1);
+ assert.equal(receipt.benchmark, 'ordinary-model-floor');
+ assert.equal(receipt.suiteId, 'ordinary-model-floor-v1');
+ assert.equal(receipt.purpose, 'suite-integrity');
+ assert.equal(receipt.evidenceEligible, false);
+ assert.equal(receipt.caseCount, 5);
+ assert.deepEqual(receipt.diagramTypes, [
+ 'architecture',
+ 'dataflow',
+ 'lifecycle',
+ 'sequence',
+ 'workflow',
+ ]);
+ assert.equal(receipt.cases.length, 5);
+ for (const item of receipt.cases) {
+ assert.equal(item.promptOk, true, item.caseId);
+ assert.equal(item.semanticOk, true, item.caseId);
+ assert.equal(item.validationOk, true, item.caseId);
+ }
+});
+
+test('benchmark fails closed with machine-readable errors for malformed JSON and mismatched run identity', () => {
+ const caseFile = writeJson('identity.case.json', {
+ schema_version: 1,
+ id: 'identity-case',
+ diagram_type: 'architecture',
+ requirements: { node_ids: ['api'] },
+ });
+ const candidate = path.join(skillRoot, 'examples/web-app.architecture.json');
+ const mismatchedRun = writeJson('identity.run.json', {
+ schema_version: 1,
+ case_id: 'different-case',
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: { status: 'skipped', reviewer: null, defects: [] },
+ });
+
+ const mismatch = run(['verify', '--case', caseFile, '--candidate', candidate, '--run', mismatchedRun]);
+
+ assert.equal(mismatch.status, 2, mismatch.stderr || mismatch.stdout);
+ assert.equal(mismatch.stderr, '');
+ assert.deepEqual(JSON.parse(mismatch.stdout), {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ error: {
+ code: 'RUN_CASE_MISMATCH',
+ message: 'run case_id "different-case" does not match benchmark case "identity-case"',
+ },
+ });
+
+ const malformedCandidate = path.join(tmp, 'malformed.architecture.json');
+ fs.writeFileSync(malformedCandidate, '{ definitely not JSON\n');
+ const validRun = writeJson('valid-identity.run.json', {
+ schema_version: 1,
+ case_id: 'identity-case',
+ agent: 'fixture-agent',
+ model: 'fixture-model',
+ attempt: 1,
+ visual_review: { status: 'skipped', reviewer: null, defects: [] },
+ });
+
+ const malformed = run(['verify', '--case', caseFile, '--candidate', malformedCandidate, '--run', validRun]);
+
+ assert.equal(malformed.status, 2, malformed.stderr || malformed.stdout);
+ assert.equal(malformed.stderr, '');
+ const malformedReceipt = JSON.parse(malformed.stdout);
+ assert.equal(malformedReceipt.error.code, 'INVALID_JSON');
+ assert.match(malformedReceipt.error.message, /malformed\.architecture\.json/);
+ assert.doesNotMatch(malformed.stdout, /SyntaxError|at JSON\.parse/);
+});
+
+test('benchmark report marks only a complete first-pass matrix as evidence and rejects duplicate runs', () => {
+ const manifestFile = path.join(repoRoot, 'benchmarks/ordinary-model-floor/manifest.json');
+ const manifest = JSON.parse(fs.readFileSync(manifestFile, 'utf8'));
+ const rows = manifest.cases.map((entry) => {
+ const benchmarkCase = JSON.parse(fs.readFileSync(
+ path.resolve(path.dirname(manifestFile), entry.case),
+ 'utf8',
+ ));
+ return {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ caseId: benchmarkCase.id,
+ run: { agent: 'fixture-agent', model: 'ordinary-model', attempt: 1 },
+ gates: {
+ semantic: { ok: true },
+ validation: { ok: true },
+ visualReview: { status: 'passed', reviewer: 'human-reviewer', defects: [] },
+ },
+ firstPassUsable: true,
+ };
+ });
+ const completeResults = path.join(tmp, 'complete-results.jsonl');
+ fs.writeFileSync(completeResults, `${rows.map((row) => JSON.stringify(row)).join('\n')}\n`);
+
+ const complete = run(['report', '--results', completeResults, '--manifest', manifestFile]);
+
+ assert.equal(complete.status, 0, complete.stderr || complete.stdout);
+ const report = JSON.parse(complete.stdout);
+ assert.equal(report.suiteId, 'ordinary-model-floor-v1');
+ assert.equal(report.evidenceEligible, true);
+ assert.deepEqual(report.coverage, [{
+ agent: 'fixture-agent',
+ model: 'ordinary-model',
+ expected: 5,
+ present: 5,
+ missingCaseIds: [],
+ unexpectedCaseIds: [],
+ complete: true,
+ }]);
+
+ const duplicateResults = path.join(tmp, 'duplicate-results.jsonl');
+ fs.writeFileSync(
+ duplicateResults,
+ `${[...rows, rows[0]].map((row) => JSON.stringify(row)).join('\n')}\n`,
+ );
+
+ const duplicate = run(['report', '--results', duplicateResults, '--manifest', manifestFile]);
+
+ assert.equal(duplicate.status, 2, duplicate.stderr || duplicate.stdout);
+ assert.equal(duplicate.stderr, '');
+ assert.equal(JSON.parse(duplicate.stdout).error.code, 'DUPLICATE_RESULT');
+});
+
+test('benchmark documentation locks the fair-run and truthful-evidence contract', () => {
+ const readme = fs.readFileSync(
+ path.join(repoRoot, 'benchmarks/ordinary-model-floor/README.md'),
+ 'utf8',
+ );
+
+ for (const required of [
+ 'firstPassUsable',
+ 'same prompt',
+ 'same repository commit',
+ 'attempt 1',
+ 'no post-hoc edits',
+ 'Reference fixtures are not benchmark evidence',
+ '`passed`',
+ '`failed`',
+ '`skipped`',
+ 'check --manifest',
+ 'verify --case',
+ 'report --results',
+ ]) {
+ assert.match(readme, new RegExp(required.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')), required);
+ }
+});
+
+process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));
diff --git a/archify/test/proof-aperture.test.mjs b/archify/test/proof-aperture.test.mjs
index b9ba90d3..97a869fb 100644
--- a/archify/test/proof-aperture.test.mjs
+++ b/archify/test/proof-aperture.test.mjs
@@ -24,22 +24,22 @@ test('landing declares a truthful first-fold proof aperture in document order',
});
test('desktop hero budget exposes live diagram content without shrinking its canvas', () => {
- assert.match(cssRule('.hero'), /padding-top:5\.5rem/);
- assert.match(cssRule('.hero-badge'), /margin-bottom:1\.125rem/);
- assert.match(cssRule('.hero h1'), /margin-bottom:\.875rem/);
- assert.match(cssRule('.hero-sub'), /margin:0 auto 1\.375rem/);
- assert.match(cssRule('.hero-actions'), /margin-bottom:1\.5rem/);
+ assert.match(cssRule('.hero'), /padding-top:9rem/);
+ assert.match(cssRule('.hero-bento'), /grid-template-columns:repeat\(12,1fr\)/);
+ assert.match(cssRule('.hero-intro'), /grid-column:1 \/ 8/);
+ assert.match(cssRule('.proof-main'), /grid-column:8 \/ 13/);
+ assert.match(cssRule('.proof-main'), /grid-row:1 \/ 3/);
assert.match(cssRule('.hero-actions .btn'), /min-height:44px/);
- assert.match(cssRule('.proof-viewport'), /height:clamp\(500px,52vw,610px\)/);
+ assert.match(cssRule('.proof-viewport'), /min-height:430px/);
});
-test('narrow mobile gets an independently tuned proof aperture and full-size actions', () => {
+test('narrow viewport preserves a contained fallback without adding a mobile product surface', () => {
const mobile = landing.match(/@media\(max-width:640px\)\s*\{([\s\S]+?)\n\s*\}\n\s*<\/style>/)?.[1];
assert.ok(mobile, 'narrow mobile media query missing');
- assert.match(mobile, /\.hero\s*\{\s*padding-top:4\.75rem;\s*\}/);
- assert.match(mobile, /\.hero-actions\s*\{\s*flex-direction:column;\s*gap:\.625rem;\s*\}/);
- assert.match(mobile, /\.hero-actions \.btn\s*\{\s*width:100%;\s*justify-content:center;\s*\}/);
- assert.match(mobile, /\.proof-viewport\s*\{\s*height:400px;\s*\}/);
+ assert.match(mobile, /\.hero\s*\{\s*padding-top:6\.75rem;\s*\}/);
+ assert.match(mobile, /\.hero-actions \.btn\s*\{\s*flex:1;\s*justify-content:center;\s*\}/);
+ assert.match(mobile, /\.proof-viewport\s*\{\s*min-height:360px;\s*\}/);
+ assert.match(mobile, /\.proof-rail\s*\{\s*grid-template-columns:1fr;\s*\}/);
});
test('proof aperture remains one real eager sandboxed artifact with explicit user-selected identities', () => {
@@ -47,7 +47,7 @@ test('proof aperture remains one real eager sandboxed artifact with explicit use
assert.match(landing, /loading="eager"/);
assert.match(landing, /sandbox="allow-scripts"/);
assert.doesNotMatch(landing, /sandbox="[^"]*allow-same-origin/);
- assert.equal((landing.match(/class="proof-tab"/g) || []).length, 3);
+ assert.equal((landing.match(/class="spec-card"/g) || []).length, 3);
assert.match(landing, /data-proof-playback="first-fold-once"/);
assert.match(landing, /\?embed=1&amp;play=1&amp;theme=dark#view=happy-path/);
assert.doesNotMatch(landing, /setInterval\(|scrollIntoView\(|scroll-triggered|proof-carousel/);
@@ -70,7 +70,7 @@ test('proof playback delegates reduced motion to the artifact and keeps delibera
test('aperture uses normal flow and preserves reduced-motion boundaries', () => {
const hero = cssRule('.hero');
- const proof = cssRule('.hero-proof');
+ const proof = cssRule('.proof-main');
assert.doesNotMatch(hero + proof, /position:absolute|transform:|top:-|margin-top:-|height:100vh/);
assert.match(landing, /@media\s*\(prefers-reduced-motion:\s*reduce\)/);
assert.match(landing, /\.fade-up\s*\{\s*opacity:1!important;\s*transform:none!important;/);
diff --git a/archify/test/start-page.test.mjs b/archify/test/start-page.test.mjs
index debb4144..e4a4dbb1 100644
--- a/archify/test/start-page.test.mjs
+++ b/archify/test/start-page.test.mjs
@@ -39,6 +39,9 @@ test('start page: offers five bounded bilingual starts without ingesting source
assert.match(html, /data-zh="一段有边界的提示词。"/);
assert.match(html, /No repository content or diagram data is sent to this page\./);
assert.match(html, /这个页面不会接收仓库内容或图表数据/);
+ assert.match(html, /id="copy-starter"/);
+ assert.match(html, /data-en="Copy install \+ prompt"/);
+ assert.match(html, /data-zh="复制安装命令 \+ 提示词"/);
const dataMatch = html.match(/<script id="start-data" type="application\/json">([\s\S]*?)<\/script>/);
assert.ok(dataMatch);
@@ -51,9 +54,15 @@ test('start page: offers five bounded bilingual starts without ingesting source
assert.doesNotThrow(() => new vm.Script(scriptMatch[1]));
assert.match(scriptMatch[1], /KNOWN_TYPES\.has\(requestedType\)/);
assert.match(scriptMatch[1], /KNOWN_AGENTS\.has\(requestedAgent\)/);
+ assert.match(scriptMatch[1], /KNOWN_SOURCES\.has\(requestedSource\)/);
assert.match(scriptMatch[1], /next\.set\('agent', agent\)/);
+ assert.match(scriptMatch[1], /next\.set\('source', source\)/);
assert.match(scriptMatch[1], /--agent ' \+ agent \+ ' --global --copy --yes/);
assert.match(scriptMatch[1], /--agent ' \+ agent \+ ' --copy --yes/);
+ assert.match(scriptMatch[1], /function starterText\(\)/);
+ assert.match(scriptMatch[1], /archify:start-funnel/);
+ assert.match(scriptMatch[1], /archify\.start\.events\.v1/);
+ assert.doesNotMatch(scriptMatch[1], /fetch\(|sendBeacon\(|XMLHttpRequest/);
assert.match(scriptMatch[1], /textContent/);
assert.match(scriptMatch[1], /replaceChildren/);
assert.doesNotMatch(scriptMatch[1], /innerHTML/);
@@ -77,7 +86,7 @@ test('generated artifacts: viewer-only Create yours link carries the exact diagr
out,
]);
const html = fs.readFileSync(out, 'utf8');
- const expected = `https://tt-a1i.github.io/archify/start.html?type=${type}`;
+ const expected = `https://tt-a1i.github.io/archify/start.html?type=${type}&amp;source=artifact`;
assert.match(html, new RegExp(`class="artifact-start-link"[^>]+href="${expected.replace(/[.?]/g, '\\$&')}"`), type);
assert.match(html, /class="artifact-start-link"[^>]+rel="noopener noreferrer"/, `${type}: referrer boundary`);
assert.equal((html.match(new RegExp(expected.replace(/[.?]/g, '\\$&'), 'g')) || []).length, 1, type);
@@ -91,3 +100,25 @@ test('generated artifacts: viewer-only Create yours link carries the exact diagr
fs.rmSync(tmp, { recursive: true, force: true });
}
});
+
+test('artifact-to-install measurement plan separates observable funnel steps from first-diagram success', () => {
+ const plan = fs.readFileSync(
+ path.join(repoRoot, 'docs/artifact-install-v2-measurement.md'),
+ 'utf8',
+ );
+
+ for (const required of [
+ 'start_view',
+ 'starter_copy',
+ 'global_install_copy',
+ 'project_install_copy',
+ 'prompt_copy',
+ 'proof_open',
+ 'starter_copy / start_view',
+ 'First-diagram success is not observable from this static page',
+ 'No network request',
+ 'source=artifact',
+ ]) {
+ assert.match(plan, new RegExp(required.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')), required);
+ }
+});
diff --git a/benchmarks/ordinary-model-floor/README.md b/benchmarks/ordinary-model-floor/README.md
new file mode 100644
index 00000000..6e912cfb
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/README.md
@@ -0,0 +1,80 @@
+# Ordinary-Model Floor v1
+
+This benchmark measures a narrow product question: can an ordinary coding agent produce an Archify diagram that is usable on attempt 1, without a human repairing the JSON?
+
+It is a delivery gate, not a model leaderboard. A run is `firstPassUsable` only when all three gates pass:
+
+1. Semantic requirements are present and correctly connected.
+2. The real Archify CLI passes `validate --quality showcase --json`.
+3. An identified reviewer inspects the final rendered artifact, records `passed`, and reports no defects.
+
+A renderer-valid but semantically wrong diagram is a failure. A visually pleasing diagram that fails deterministic validation is also a failure. A missing visual review is reported truthfully, never upgraded to a pass.
+
+## Suite
+
+`manifest.json` contains five bounded tasks: architecture, workflow, sequence, data flow, and lifecycle. Each case declares semantic keys, accepted technical labels, required roles, and required relationships. The model remains free to choose internal IDs and layout.
+
+The checked-in reference fixtures only prove that the suite and verifier are wired correctly. **Reference fixtures are not benchmark evidence** and must not be published as model results.
+
+Check suite integrity from the repository root:
+
+```bash
+node benchmarks/ordinary-model-floor/benchmark.mjs check --manifest benchmarks/ordinary-model-floor/manifest.json
+```
+
+## Fair-run protocol
+
+Every compared configuration must use the same prompt, the same repository commit, the same Archify skill and schema, the same time limit, and a clean candidate output path. Record the exact agent and model names. Preserve the unedited attempt 1 candidate and permit no post-hoc edits before verification.
+
+Do not let a later correction replace attempt 1. Correction attempts may be retained for diagnosis, but the first-pass report accepts only attempt 1 receipts. Run every case in the manifest for every configuration; an incomplete or duplicated matrix is not evidence-eligible.
+
+The harness deliberately does not launch model providers. The external runner owns authentication, model selection, timeouts, prompt delivery, and raw transcript retention. This keeps provider code and secrets out of Archify while making the artifact checks deterministic.
+
+## Verify one run
+
+Create a run metadata file after the agent has produced its candidate:
+
+```json
+{
+ "schema_version": 1,
+ "case_id": "web-runtime-architecture",
+ "agent": "agent-name",
+ "model": "model-name",
+ "attempt": 1,
+ "visual_review": {
+ "status": "passed",
+ "reviewer": "reviewer-name",
+ "defects": []
+ }
+}
+```
+
+Then verify the original candidate:
+
+```bash
+node benchmarks/ordinary-model-floor/benchmark.mjs verify --case benchmarks/ordinary-model-floor/cases/web-runtime.architecture.case.json --candidate /path/to/candidate.architecture.json --run /path/to/run.json
+```
+
+The command writes one machine-readable receipt to stdout. Exit code `0` means first-pass usable, `1` means the candidate failed one or more gates, and `2` means the inputs or benchmark invocation were invalid.
+
+## Visual review
+
+Review the final browser artifact or canonical raster, not the source JSON alone:
+
+- `passed`: no visible defect, with a non-empty reviewer identity.
+- `failed`: one or more concrete defects were observed.
+- `skipped`: no capable reviewer or image reader was available.
+
+Use short defect tags such as `clipping`, `node-overlap`, `label-overlap`, `hidden-route`, `stacked-edge`, `weak-hierarchy`, `unbalanced-whitespace`, or `theme-contrast`. A `skipped` review can never produce `firstPassUsable: true`.
+
+## Report a complete matrix
+
+Store one verifier receipt per line in a JSONL file, then aggregate it against the manifest:
+
+```bash
+node benchmarks/ordinary-model-floor/benchmark.mjs report --results /path/to/results.jsonl --manifest benchmarks/ordinary-model-floor/manifest.json
+```
+
+The report separates semantic, deterministic-validation, and visual-review failure clusters. `evidenceEligible` is true only when every agent/model configuration has exactly one valid attempt 1 receipt for every manifest case. The report does not prove that an external transcript is authentic; retain the raw prompts, candidate files, repository commit, and reviewer evidence alongside any published claim.
+
+No model result or leaderboard is checked in until the corresponding runs and visual reviews have actually happened.
diff --git a/benchmarks/ordinary-model-floor/benchmark.mjs b/benchmarks/ordinary-model-floor/benchmark.mjs
new file mode 100644
index 00000000..ab934e6b
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/benchmark.mjs
@@ -0,0 +1,441 @@
+#!/usr/bin/env node
+
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, '../..');
+const archifyCli = path.join(repoRoot, 'archify/bin/archify.mjs');
+const COLLECTIONS = {
+ architecture: { nodes: 'components', relationships: 'connections' },
+ workflow: { nodes: 'nodes', relationships: 'edges' },
+ sequence: { nodes: 'participants', relationships: 'messages' },
+ dataflow: { nodes: 'nodes', relationships: 'flows' },
+ lifecycle: { nodes: 'states', relationships: 'transitions' },
+};
+
+class BenchmarkError extends Error {
+ constructor(code, message) {
+ super(message);
+ this.code = code;
+ }
+}
+
+function option(args, name) {
+ const index = args.indexOf(name);
+ return index >= 0 ? args[index + 1] : undefined;
+}
+
+function readJson(file) {
+ const absoluteFile = path.resolve(file);
+ let source;
+ try {
+ source = fs.readFileSync(absoluteFile, 'utf8');
+ } catch {
+ throw new BenchmarkError('INPUT_NOT_FOUND', `cannot read ${path.basename(absoluteFile)}`);
+ }
+ try {
+ return JSON.parse(source);
+ } catch {
+ throw new BenchmarkError('INVALID_JSON', `${path.basename(absoluteFile)} is not valid JSON`);
+ }
+}
+
+function normalizeTechnicalLabel(value) {
+ return String(value ?? '')
+ .normalize('NFKC')
+ .toLowerCase()
+ .replace(/[^\p{L}\p{N}]+/gu, ' ')
+ .trim();
+}
+
+function relationshipMatches(candidate, requirement) {
+ return candidate.from === requirement.from
+ && candidate.to === requirement.to
+ && (requirement.label === undefined || candidate.label === requirement.label)
+ && (requirement.labels === undefined
+ || requirement.labels.some(
+ (label) => normalizeTechnicalLabel(candidate.label) === normalizeTechnicalLabel(label),
+ ))
+ && (requirement.variant === undefined || candidate.variant === requirement.variant);
+}
+
+function bindRequiredNode(required, nodesById, nodes) {
+ if (typeof required.id === 'string' && nodesById.has(required.id)) {
+ return { node: nodesById.get(required.id), ambiguous: [] };
+ }
+ if (typeof required.key === 'string' && nodesById.has(required.key)) {
+ return { node: nodesById.get(required.key), ambiguous: [] };
+ }
+
+ const acceptedLabels = (required.labels || [])
+ .concat(required.label === undefined ? [] : [required.label])
+ .map(normalizeTechnicalLabel)
+ .filter(Boolean);
+ if (acceptedLabels.length === 0) return { node: null, ambiguous: [] };
+
+ const matches = nodes.filter(
+ (node) => acceptedLabels.includes(normalizeTechnicalLabel(node.label)),
+ );
+ if (matches.length === 1) return { node: matches[0], ambiguous: [] };
+ if (matches.length > 1) return { node: null, ambiguous: matches.map((node) => node.id) };
+ return { node: null, ambiguous: [] };
+}
+
+function evaluateSemantic(benchmarkCase, candidate) {
+ const requirements = benchmarkCase.requirements || {};
+ const collections = COLLECTIONS[benchmarkCase.diagram_type];
+ const nodes = candidate[collections.nodes] || [];
+ const relationships = candidate[collections.relationships] || [];
+ const nodesById = new Map(nodes.map((node) => [node.id, node]));
+ const nodeIds = new Set(nodesById.keys());
+ const requiredNodeIds = [
+ ...(requirements.node_ids || []),
+ ...(requirements.nodes || [])
+ .filter((node) => typeof node.id === 'string' && typeof node.key !== 'string')
+ .map((node) => node.id),
+ ];
+ const missingNodeIds = [...new Set(requiredNodeIds.filter((id) => !nodeIds.has(id)))];
+ const bindings = {};
+ const ambiguousNodes = [];
+ const mismatchedNodes = [];
+ for (const required of requirements.nodes || []) {
+ const identity = required.key || required.id;
+ const binding = bindRequiredNode(required, nodesById, nodes);
+ if (binding.ambiguous.length > 0) {
+ ambiguousNodes.push({ key: identity, candidateIds: binding.ambiguous });
+ continue;
+ }
+ const actual = binding.node;
+ if (!actual) {
+ if (typeof identity === 'string' && !missingNodeIds.includes(identity)) {
+ missingNodeIds.push(identity);
+ }
+ continue;
+ }
+ if (typeof required.key === 'string') bindings[required.key] = actual.id;
+ for (const field of ['type', 'label', 'sublabel', 'tag']) {
+ if (required[field] !== undefined && actual[field] !== required[field]) {
+ mismatchedNodes.push({
+ id: identity,
+ field,
+ expected: required[field],
+ actual: actual[field] ?? null,
+ });
+ }
+ }
+ }
+ const missingRelationships = (requirements.relationships || []).filter((relationship) => {
+ const resolved = {
+ ...relationship,
+ from: bindings[relationship.from] || relationship.from,
+ to: bindings[relationship.to] || relationship.to,
+ };
+ return !relationships.some(
+ (candidateRelationship) => relationshipMatches(candidateRelationship, resolved),
+ );
+ });
+ const ok = missingNodeIds.length === 0
+ && ambiguousNodes.length === 0
+ && mismatchedNodes.length === 0
+ && missingRelationships.length === 0;
+ return {
+ ok,
+ bindings,
+ missingNodeIds,
+ ambiguousNodes,
+ mismatchedNodes,
+ missingRelationships,
+ };
+}
+
+function validateCandidate(benchmarkCase, candidateFile) {
+ const validated = spawnSync(process.execPath, [
+ archifyCli,
+ 'validate',
+ benchmarkCase.diagram_type,
+ path.resolve(candidateFile),
+ '--quality',
+ benchmarkCase.quality_profile || 'showcase',
+ '--json',
+ ], {
+ cwd: path.join(repoRoot, 'archify'),
+ encoding: 'utf8',
+ });
+ const receipt = JSON.parse(validated.stdout);
+ return {
+ ok: validated.status === 0 && receipt.ok === true,
+ checksPassed: Array.isArray(receipt.checks)
+ ? receipt.checks.filter((check) => check.ok).length
+ : 0,
+ composition: {
+ errors: receipt.composition?.summary?.errors ?? null,
+ warnings: receipt.composition?.summary?.warnings ?? null,
+ },
+ };
+}
+
+function verify(args) {
+ const caseFile = option(args, '--case');
+ const candidateFile = option(args, '--candidate');
+ const runFile = option(args, '--run');
+ if (!caseFile || !candidateFile || !runFile) {
+ throw new Error('verify requires --case, --candidate, and --run');
+ }
+
+ const benchmarkCase = readJson(caseFile);
+ const candidate = readJson(candidateFile);
+ const run = readJson(runFile);
+ if (run.case_id !== benchmarkCase.id) {
+ throw new BenchmarkError(
+ 'RUN_CASE_MISMATCH',
+ `run case_id "${run.case_id}" does not match benchmark case "${benchmarkCase.id}"`,
+ );
+ }
+ const semantic = evaluateSemantic(benchmarkCase, candidate);
+ const validation = validateCandidate(benchmarkCase, candidateFile);
+ let visualReview = {
+ status: run.visual_review?.status || 'skipped',
+ reviewer: run.visual_review?.reviewer || null,
+ defects: Array.isArray(run.visual_review?.defects) ? run.visual_review.defects : [],
+ };
+ if (visualReview.status === 'passed'
+ && (typeof visualReview.reviewer !== 'string' || visualReview.reviewer.trim() === '')) {
+ visualReview = {
+ ...visualReview,
+ status: 'invalid',
+ reviewer: null,
+ reason: 'passed visual review requires a non-empty reviewer identity',
+ };
+ }
+ const firstPassUsable = run.attempt === 1
+ && semantic.ok
+ && validation.ok
+ && visualReview.status === 'passed'
+ && visualReview.defects.length === 0;
+
+ const receipt = {
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ caseId: benchmarkCase.id,
+ run: {
+ agent: run.agent,
+ model: run.model,
+ attempt: run.attempt,
+ },
+ gates: {
+ semantic: {
+ ...semantic,
+ },
+ validation,
+ visualReview,
+ },
+ firstPassUsable,
+ };
+ process.stdout.write(`${JSON.stringify(receipt, null, 2)}\n`);
+ process.exitCode = firstPassUsable ? 0 : 1;
+}
+
+function check(args) {
+ const manifestFile = option(args, '--manifest');
+ if (!manifestFile) throw new Error('check requires --manifest');
+ const absoluteManifest = path.resolve(manifestFile);
+ const manifestDirectory = path.dirname(absoluteManifest);
+ const manifest = readJson(absoluteManifest);
+ const cases = (manifest.cases || []).map((entry) => {
+ const caseFile = path.resolve(manifestDirectory, entry.case);
+ const promptFile = path.resolve(manifestDirectory, entry.prompt);
+ const candidateFile = path.resolve(manifestDirectory, entry.reference_fixture);
+ const benchmarkCase = readJson(caseFile);
+ const candidate = readJson(candidateFile);
+ const semantic = evaluateSemantic(benchmarkCase, candidate);
+ const validation = validateCandidate(benchmarkCase, candidateFile);
+ const prompt = fs.readFileSync(promptFile, 'utf8').trim();
+ return {
+ caseId: benchmarkCase.id,
+ diagramType: benchmarkCase.diagram_type,
+ promptOk: prompt.length >= 200,
+ semanticOk: semantic.ok,
+ validationOk: validation.ok,
+ };
+ });
+ const diagramTypes = [...new Set(cases.map((item) => item.diagramType))].sort();
+ const ok = manifest.purpose === 'suite-integrity'
+ && manifest.evidence_eligible === false
+ && cases.length > 0
+ && cases.every((item) => item.promptOk && item.semanticOk && item.validationOk);
+ process.stdout.write(`${JSON.stringify({
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ suiteId: manifest.id,
+ purpose: manifest.purpose,
+ evidenceEligible: manifest.evidence_eligible,
+ caseCount: cases.length,
+ diagramTypes,
+ cases,
+ }, null, 2)}\n`);
+ process.exitCode = ok ? 0 : 1;
+}
+
+function newSummary() {
+ return {
+ runs: 0,
+ firstPassUsable: 0,
+ firstPassUsableRate: 0,
+ failureClusters: {
+ semantic: 0,
+ validation: 0,
+ visualReview: 0,
+ },
+ };
+}
+
+function addResult(summary, result) {
+ summary.runs += 1;
+ if (result.firstPassUsable === true) summary.firstPassUsable += 1;
+ if (result.gates?.semantic?.ok !== true) summary.failureClusters.semantic += 1;
+ if (result.gates?.validation?.ok !== true) summary.failureClusters.validation += 1;
+ if (result.gates?.visualReview?.status !== 'passed'
+ || (result.gates?.visualReview?.defects || []).length > 0) {
+ summary.failureClusters.visualReview += 1;
+ }
+ summary.firstPassUsableRate = summary.runs === 0
+ ? 0
+ : summary.firstPassUsable / summary.runs;
+}
+
+function validateResult(result) {
+ if (result?.schemaVersion !== 1 || result?.benchmark !== 'ordinary-model-floor') {
+ throw new BenchmarkError('INVALID_RESULT', 'result is not an ordinary-model-floor v1 receipt');
+ }
+ if (typeof result.caseId !== 'string' || result.caseId.trim() === '') {
+ throw new BenchmarkError('INVALID_RESULT', 'result caseId must be a non-empty string');
+ }
+ if (typeof result.run?.agent !== 'string' || result.run.agent.trim() === ''
+ || typeof result.run?.model !== 'string' || result.run.model.trim() === '') {
+ throw new BenchmarkError('INVALID_RESULT', 'result agent and model must be non-empty strings');
+ }
+ if (result.run.attempt !== 1) {
+ throw new BenchmarkError(
+ 'NON_FIRST_PASS_RESULT',
+ `result for ${result.run.agent}/${result.run.model}/${result.caseId} is not attempt 1`,
+ );
+ }
+ const visual = result.gates?.visualReview;
+ const derivedFirstPassUsable = result.gates?.semantic?.ok === true
+ && result.gates?.validation?.ok === true
+ && visual?.status === 'passed'
+ && typeof visual.reviewer === 'string'
+ && visual.reviewer.trim() !== ''
+ && Array.isArray(visual.defects)
+ && visual.defects.length === 0;
+ if (result.firstPassUsable !== derivedFirstPassUsable) {
+ throw new BenchmarkError(
+ 'INCONSISTENT_RESULT',
+ `result for ${result.run.agent}/${result.run.model}/${result.caseId} has an inconsistent firstPassUsable value`,
+ );
+ }
+}
+
+function report(args) {
+ const resultsFile = option(args, '--results');
+ if (!resultsFile) throw new Error('report requires --results');
+ const manifestFile = option(args, '--manifest');
+ const manifest = manifestFile ? readJson(manifestFile) : null;
+ const manifestDirectory = manifestFile ? path.dirname(path.resolve(manifestFile)) : null;
+ const expectedCaseIds = manifest
+ ? new Set(manifest.cases.map((entry) => readJson(path.resolve(manifestDirectory, entry.case)).id))
+ : null;
+ const results = fs.readFileSync(path.resolve(resultsFile), 'utf8')
+ .split(/\r?\n/)
+ .filter(Boolean)
+ .map((line) => JSON.parse(line));
+ const overall = newSummary();
+ const configurations = new Map();
+ const seen = new Set();
+ const caseIdsByConfiguration = new Map();
+ for (const result of results) {
+ validateResult(result);
+ const resultKey = `${result.run.agent}\u0000${result.run.model}\u0000${result.caseId}`;
+ if (seen.has(resultKey)) {
+ throw new BenchmarkError(
+ 'DUPLICATE_RESULT',
+ `duplicate result for ${result.run.agent}/${result.run.model}/${result.caseId}`,
+ );
+ }
+ seen.add(resultKey);
+ addResult(overall, result);
+ const key = `${result.run.agent}\u0000${result.run.model}`;
+ if (!configurations.has(key)) {
+ configurations.set(key, {
+ agent: result.run.agent,
+ model: result.run.model,
+ ...newSummary(),
+ });
+ }
+ addResult(configurations.get(key), result);
+ if (!caseIdsByConfiguration.has(key)) caseIdsByConfiguration.set(key, new Set());
+ caseIdsByConfiguration.get(key).add(result.caseId);
+ }
+ const byConfiguration = [...configurations.values()]
+ .sort((left, right) => `${left.agent}\u0000${left.model}`.localeCompare(`${right.agent}\u0000${right.model}`));
+ const coverage = expectedCaseIds
+ ? byConfiguration.map(({ agent, model }) => {
+ const presentCaseIds = caseIdsByConfiguration.get(`${agent}\u0000${model}`) || new Set();
+ const missingCaseIds = [...expectedCaseIds].filter((caseId) => !presentCaseIds.has(caseId)).sort();
+ const unexpectedCaseIds = [...presentCaseIds].filter((caseId) => !expectedCaseIds.has(caseId)).sort();
+ return {
+ agent,
+ model,
+ expected: expectedCaseIds.size,
+ present: presentCaseIds.size,
+ missingCaseIds,
+ unexpectedCaseIds,
+ complete: missingCaseIds.length === 0 && unexpectedCaseIds.length === 0,
+ };
+ })
+ : [];
+ const evidenceEligible = manifest !== null
+ && coverage.length > 0
+ && coverage.every((item) => item.complete);
+ process.stdout.write(`${JSON.stringify({
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ suiteId: manifest?.id ?? null,
+ evidenceEligible,
+ coverage,
+ overall,
+ byConfiguration,
+ }, null, 2)}\n`);
+}
+
+function fail(error) {
+ const code = error instanceof BenchmarkError ? error.code : 'INTERNAL_ERROR';
+ const message = error instanceof Error ? error.message : String(error);
+ process.stdout.write(`${JSON.stringify({
+ schemaVersion: 1,
+ benchmark: 'ordinary-model-floor',
+ error: { code, message },
+ }, null, 2)}\n`);
+ process.exitCode = 2;
+}
+
+try {
+ const [command, ...args] = process.argv.slice(2);
+ if (command === 'verify') {
+ verify(args);
+ } else if (command === 'check') {
+ check(args);
+ } else if (command === 'report') {
+ report(args);
+ } else {
+ throw new BenchmarkError(
+ 'USAGE',
+ 'usage: benchmark.mjs <verify|check|report> [options]',
+ );
+ }
+} catch (error) {
+ fail(error);
+}
diff --git a/benchmarks/ordinary-model-floor/cases/agent-run.lifecycle.case.json b/benchmarks/ordinary-model-floor/cases/agent-run.lifecycle.case.json
new file mode 100644
index 00000000..7aae3ccf
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/cases/agent-run.lifecycle.case.json
@@ -0,0 +1,23 @@
+{
+ "schema_version": 1,
+ "id": "agent-run-lifecycle",
+ "diagram_type": "lifecycle",
+ "quality_profile": "showcase",
+ "requirements": {
+ "nodes": [
+ { "key": "queued", "labels": ["Queued", "Accepted"], "type": "start" },
+ { "key": "executing", "labels": ["Executing", "Running"], "type": "active" },
+ { "key": "reviewing", "labels": ["Reviewing", "Quality Review"], "type": "decision" },
+ { "key": "approval", "labels": ["Needs Approval", "Waiting for Approval"], "type": "waiting" },
+ { "key": "blocked", "labels": ["Blocked", "Waiting for Input"], "type": "waiting" },
+ { "key": "cancelled", "labels": ["Cancelled", "Canceled"], "type": "failure" },
+ { "key": "expired", "labels": ["Expired", "Timed Out"], "type": "failure" }
+ ],
+ "relationships": [
+ { "from": "executing", "to": "approval", "variant": "security" },
+ { "from": "reviewing", "to": "blocked" },
+ { "from": "blocked", "to": "expired", "variant": "security" },
+ { "from": "approval", "to": "cancelled", "variant": "security" }
+ ]
+ }
+}
diff --git a/benchmarks/ordinary-model-floor/cases/agent-tool-call.workflow.case.json b/benchmarks/ordinary-model-floor/cases/agent-tool-call.workflow.case.json
new file mode 100644
index 00000000..d80269d7
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/cases/agent-tool-call.workflow.case.json
@@ -0,0 +1,23 @@
+{
+ "schema_version": 1,
+ "id": "agent-tool-call-workflow",
+ "diagram_type": "workflow",
+ "quality_profile": "showcase",
+ "requirements": {
+ "nodes": [
+ { "key": "planner", "labels": ["Agent Planner", "Planner"], "type": "backend" },
+ { "key": "router", "labels": ["Tool Router", "Router"], "type": "backend" },
+ { "key": "approval", "labels": ["Approval Gate", "Human Approval"], "type": "security" },
+ { "key": "tool", "labels": ["Tool Call", "Tool Execution"], "type": "messagebus" },
+ { "key": "blocked", "labels": ["Blocked", "Denied"], "type": "security" },
+ { "key": "external", "labels": ["External API", "Provider API"], "type": "cloud" }
+ ],
+ "relationships": [
+ { "from": "planner", "to": "router" },
+ { "from": "router", "to": "approval", "labels": ["needs approval?", "approval required?"] },
+ { "from": "approval", "to": "tool" },
+ { "from": "approval", "to": "blocked", "labels": ["denied", "rejected"] },
+ { "from": "tool", "to": "external" }
+ ]
+ }
+}
diff --git a/benchmarks/ordinary-model-floor/cases/cache-miss.sequence.case.json b/benchmarks/ordinary-model-floor/cases/cache-miss.sequence.case.json
new file mode 100644
index 00000000..5412bab8
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/cases/cache-miss.sequence.case.json
@@ -0,0 +1,22 @@
+{
+ "schema_version": 1,
+ "id": "cache-miss-sequence",
+ "diagram_type": "sequence",
+ "quality_profile": "showcase",
+ "requirements": {
+ "nodes": [
+ { "key": "web", "labels": ["Web App", "Browser"], "type": "frontend" },
+ { "key": "api", "labels": ["API", "API Server"], "type": "backend" },
+ { "key": "auth", "labels": ["Auth", "Authentication"], "type": "security" },
+ { "key": "redis", "labels": ["Redis", "Cache"], "type": "database" },
+ { "key": "db", "labels": ["Postgres", "PostgreSQL", "Database"], "type": "database" }
+ ],
+ "relationships": [
+ { "from": "api", "to": "auth", "labels": ["verify JWT", "validate token"] },
+ { "from": "api", "to": "redis", "labels": ["read cache", "cache get"] },
+ { "from": "redis", "to": "api", "labels": ["miss", "cache miss"] },
+ { "from": "api", "to": "db", "labels": ["query profile + metrics", "query database"] },
+ { "from": "api", "to": "redis", "labels": ["set cache", "cache set"] }
+ ]
+ }
+}
diff --git a/benchmarks/ordinary-model-floor/cases/product-analytics.dataflow.case.json b/benchmarks/ordinary-model-floor/cases/product-analytics.dataflow.case.json
new file mode 100644
index 00000000..e528a868
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/cases/product-analytics.dataflow.case.json
@@ -0,0 +1,23 @@
+{
+ "schema_version": 1,
+ "id": "product-analytics-dataflow",
+ "diagram_type": "dataflow",
+ "quality_profile": "showcase",
+ "requirements": {
+ "nodes": [
+ { "key": "edge", "labels": ["Edge API", "Ingestion API"], "type": "cloud" },
+ { "key": "consent", "labels": ["Consent Gate", "Consent Check"], "type": "security" },
+ { "key": "stream", "labels": ["Event Stream", "Event Bus"], "type": "messagebus" },
+ { "key": "pii", "labels": ["PII Vault", "Identity Vault"], "type": "security" },
+ { "key": "warehouse", "labels": ["Warehouse", "Data Warehouse"], "type": "database" },
+ { "key": "dashboard", "labels": ["Dashboards", "Analytics Dashboard"], "type": "backend" }
+ ],
+ "relationships": [
+ { "from": "edge", "to": "consent", "labels": ["identity + consent", "consent check"] },
+ { "from": "edge", "to": "stream", "labels": ["accepted events", "validated events"] },
+ { "from": "consent", "to": "pii", "labels": ["identity map", "approved identity"] },
+ { "from": "stream", "to": "warehouse", "labels": ["normalized facts", "normalized events"] },
+ { "from": "warehouse", "to": "dashboard", "labels": ["metrics SQL", "analytics query"] }
+ ]
+ }
+}
diff --git a/benchmarks/ordinary-model-floor/cases/web-runtime.architecture.case.json b/benchmarks/ordinary-model-floor/cases/web-runtime.architecture.case.json
new file mode 100644
index 00000000..f9a77223
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/cases/web-runtime.architecture.case.json
@@ -0,0 +1,20 @@
+{
+ "schema_version": 1,
+ "id": "web-runtime-architecture",
+ "diagram_type": "architecture",
+ "quality_profile": "showcase",
+ "requirements": {
+ "nodes": [
+ { "key": "users", "labels": ["Users", "Browser Clients"], "type": "external" },
+ { "key": "cdn", "labels": ["CloudFront", "CDN", "Content Delivery Network"], "type": "cloud" },
+ { "key": "api", "labels": ["API Server", "Application API"], "type": "backend" },
+ { "key": "cache", "labels": ["Redis", "Redis Cache"], "type": "database" },
+ { "key": "db", "labels": ["PostgreSQL", "Postgres", "Primary Database"], "type": "database" }
+ ],
+ "relationships": [
+ { "from": "users", "to": "cdn", "labels": ["HTTPS"] },
+ { "from": "api", "to": "cache", "labels": ["read-through", "cache read"] },
+ { "from": "api", "to": "db", "labels": ["SQL", "database query"] }
+ ]
+ }
+}
diff --git a/benchmarks/ordinary-model-floor/manifest.json b/benchmarks/ordinary-model-floor/manifest.json
new file mode 100644
index 00000000..df305490
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/manifest.json
@@ -0,0 +1,33 @@
+{
+ "schema_version": 1,
+ "id": "ordinary-model-floor-v1",
+ "purpose": "suite-integrity",
+ "evidence_eligible": false,
+ "cases": [
+ {
+ "case": "cases/web-runtime.architecture.case.json",
+ "prompt": "prompts/web-runtime.architecture.md",
+ "reference_fixture": "../../archify/examples/web-app.architecture.json"
+ },
+ {
+ "case": "cases/agent-tool-call.workflow.case.json",
+ "prompt": "prompts/agent-tool-call.workflow.md",
+ "reference_fixture": "../../archify/examples/agent-tool-call.workflow.json"
+ },
+ {
+ "case": "cases/cache-miss.sequence.case.json",
+ "prompt": "prompts/cache-miss.sequence.md",
+ "reference_fixture": "../../archify/examples/cache-miss-request.sequence.json"
+ },
+ {
+ "case": "cases/product-analytics.dataflow.case.json",
+ "prompt": "prompts/product-analytics.dataflow.md",
+ "reference_fixture": "../../archify/examples/product-analytics.dataflow.json"
+ },
+ {
+ "case": "cases/agent-run.lifecycle.case.json",
+ "prompt": "prompts/agent-run.lifecycle.md",
+ "reference_fixture": "../../archify/examples/agent-run.lifecycle.json"
+ }
+ ]
+}
diff --git a/benchmarks/ordinary-model-floor/prompts/agent-run.lifecycle.md b/benchmarks/ordinary-model-floor/prompts/agent-run.lifecycle.md
new file mode 100644
index 00000000..b5209299
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/prompts/agent-run.lifecycle.md
@@ -0,0 +1,5 @@
+# Agent-run lifecycle
+
+Use the Archify skill in this repository to create a lifecycle diagram for an agent run. Show the main ordered phases from queued through planning, execution, review, and completion. Execution may pause for human approval or fail recoverably. Review may block while waiting for input. A blocked run may expire, and a waiting approval may be cancelled by the user. Terminal exits must remain distinct from active and waiting states.
+
+Author a fresh typed JSON diagram specification and validate it with the `showcase` quality profile. Choose your own stable internal IDs and layout. Keep active work, interruptions, recovery, and terminal outcomes legible; do not copy a checked-in example.
diff --git a/benchmarks/ordinary-model-floor/prompts/agent-tool-call.workflow.md b/benchmarks/ordinary-model-floor/prompts/agent-tool-call.workflow.md
new file mode 100644
index 00000000..f0afeacd
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/prompts/agent-tool-call.workflow.md
@@ -0,0 +1,5 @@
+# Agent tool-call workflow
+
+Use the Archify skill in this repository to create a workflow diagram for an AI agent tool call. A user request reaches a chat surface and planner. A router decides whether human approval is required. Approval permits tool execution against an external provider; denial enters a blocked path that may retry. The final result returns to the user, while tool results and context are recorded for tracing.
+
+Author a fresh typed JSON diagram specification and validate it with the `showcase` quality profile. Choose your own stable internal IDs and layout. Make the approval decision, denied route, execution route, and external call easy to read; do not copy a checked-in example.
diff --git a/benchmarks/ordinary-model-floor/prompts/cache-miss.sequence.md b/benchmarks/ordinary-model-floor/prompts/cache-miss.sequence.md
new file mode 100644
index 00000000..721c31af
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/prompts/cache-miss.sequence.md
@@ -0,0 +1,5 @@
+# Cache-miss request sequence
+
+Use the Archify skill in this repository to create a sequence diagram for a dashboard request. A browser calls an API, the API validates the JWT, then reads Redis. Redis returns a cache miss, so the API queries PostgreSQL for profile and metric data, stores the result back in Redis, emits a trace, and returns JSON for the browser to render.
+
+Author a fresh typed JSON diagram specification and validate it with the `showcase` quality profile. Choose your own stable internal IDs and layout. Preserve message direction and distinguish calls, returns, security checks, and asynchronous trace emission; do not copy a checked-in example.
diff --git a/benchmarks/ordinary-model-floor/prompts/product-analytics.dataflow.md b/benchmarks/ordinary-model-floor/prompts/product-analytics.dataflow.md
new file mode 100644
index 00000000..1f55cece
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/prompts/product-analytics.dataflow.md
@@ -0,0 +1,5 @@
+# Product analytics data flow
+
+Use the Archify skill in this repository to create a data-flow diagram for product analytics. Web and mobile clients send events to an edge ingestion API. Consent is checked before identity data enters a protected PII vault. Accepted events enter a stream, become normalized warehouse facts, and feed dashboards. Aggregated warehouse data also feeds a feature store and model.
+
+Author a fresh typed JSON diagram specification and validate it with the `showcase` quality profile. Choose your own stable internal IDs and layout. Make the privacy boundary and restricted identity path visually distinct from the ordinary analytics path; do not copy a checked-in example.
diff --git a/benchmarks/ordinary-model-floor/prompts/web-runtime.architecture.md b/benchmarks/ordinary-model-floor/prompts/web-runtime.architecture.md
new file mode 100644
index 00000000..1d92c41c
--- /dev/null
+++ b/benchmarks/ordinary-model-floor/prompts/web-runtime.architecture.md
@@ -0,0 +1,5 @@
+# Web runtime architecture
+
+Use the Archify skill in this repository to create an architecture diagram for a production web application. Browser users enter through a CDN over HTTPS, then traffic reaches a load balancer and an application API. The API verifies identity with an auth provider, reads through a Redis cache, queries a PostgreSQL primary database, and enqueues background work for a worker. Static assets are served from object storage.
+
+Author a fresh typed JSON diagram specification and validate it with the `showcase` quality profile. Choose your own stable internal IDs and layout. Preserve the system roles and labelled technical relationships; do not copy a checked-in example.
diff --git a/docs/artifact-install-v2-measurement.md b/docs/artifact-install-v2-measurement.md
new file mode 100644
index 00000000..621563ff
--- /dev/null
+++ b/docs/artifact-install-v2-measurement.md
@@ -0,0 +1,49 @@
+# Artifact → Install v2 measurement contract
+
+Artifact → Install v2 is a bounded change to the existing journey. A generated artifact links to `start.html?type=<type>&source=artifact`; the Start page selects the matching typed recipe and can copy the selected agent's install command plus the bounded prompt in one action.
+
+The page records only coarse interaction steps:
+
+- `start_view`
+- `starter_copy`
+- `global_install_copy`
+- `project_install_copy`
+- `prompt_copy`
+- `proof_open`
+
+Each event contains `schemaVersion`, `step`, the allow-listed source, diagram type, agent, and language. It never contains a repository path, diagram title, prompt text, node, relationship, source JSON, or user identifier. Unknown source values are normalized to `direct`.
+
+## Privacy boundary
+
+Events are capped at the latest 24 entries in `sessionStorage` under `archify.start.events.v1`. The page also dispatches the same detail as the `archify:start-funnel` browser event and exposes a read-only snapshot through `window.ArchifyStartMetrics.snapshot()`.
+
+**No network request is made by Archify.** The page contains no `fetch`, `sendBeacon`, or XHR path. Closing the browser session discards the local receipt. A hosting operator must not attach an external event sink without a separate privacy decision, public disclosure, retention policy, and test update.
+
+## Observable metrics
+
+Within a controlled browser test or an explicitly instrumented host, compute:
+
+- Artifact arrival share: `source=artifact` `start_view` / all `start_view`
+- Combined starter copy rate: `starter_copy / start_view`
+- Any install copy rate: (`starter_copy` + `global_install_copy` + `project_install_copy`) / `start_view`
+- Prompt-only copy rate: `prompt_copy / start_view`
+- Proof reassurance rate: `proof_open / start_view`
+
+Count at most one occurrence of each step per browser session when reporting conversion, even though the local diagnostic receipt retains repeated clicks. Segment only by the allow-listed source, type, agent, and language.
+
+## What this does not prove
+
+**First-diagram success is not observable from this static page.** A successful copy is an intent signal, not proof that installation completed, the agent generated a candidate, validation passed, or the user retained Archify. Do not label these ratios “activation,” “success,” or “retention.”
+
+The Ordinary-Model Floor benchmark measures candidate quality independently. A future end-to-end activation metric would require an explicit, privacy-reviewed receipt boundary at the installed CLI or a voluntary user submission; it must not be inferred from Start-page clicks.
+
+## Evaluation window
+
+Before publishing a conversion claim:
+
+1. Pin the repository commit and the exact v2 UI.
+2. Validate the event contract in a real browser for artifact, direct, and rejected unknown-source URLs.
+3. If an approved aggregate sink is later added, run a predeclared observation window and publish both session counts and rates; do not compare against a historical period that lacked equivalent instrumentation.
+4. Keep deterministic page tests, package tests, and visual review as release gates regardless of copy rate.
+
+Until an approved aggregate sink exists, the event receipt is for local QA and experiment readiness only.
diff --git a/docs/assets/archify-live-proof.gif b/docs/assets/archify-live-proof.gif
index 2d26f9f8..07eb62bb 100644
Binary files a/docs/assets/archify-live-proof.gif and b/docs/assets/archify-live-proof.gif differ
diff --git a/docs/assets/archify-live-proof.json b/docs/assets/archify-live-proof.json
index 3380422a..15e534fc 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": 1599496,
- "sha256": "d8742e92353f190b23b5eff45be8661ade3fe06a4dd19832853936b7b5e8edad",
+ "bytes": 1554440,
+ "sha256": "3284db7224c163ac28dd65df193d9360836146136fa64038d10e93d4b367bce2",
"scenes": [
{
"id": "signal-flow",
"artifact": "docs/gallery/artifacts/agent-tool-call.workflow.html",
- "artifactSha256": "5dcc43441ca3c5dac66f7d0ea2cd815596734ade9bba71f11f04501f19827cfc",
+ "artifactSha256": "1ef0a5d371122c038436ab07ef8c319ca683590222f48d45622f73c28fd24c86",
"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": "a9eadd97b44b97622c2c506ae54b1e98b8da4a4ac4b1142249a32865b8d5b1c3",
+ "artifactSha256": "e0ead588fb48511d5695fddbeb5871a76357d8c657644e163dfba454d082a1f5",
"view": "request-boundary",
"eyebrow": "ARCHITECTURE · BLUEPRINT",
"title": "Production Deployment",
@@ -31,7 +31,7 @@
{
"id": "classic",
"artifact": "docs/gallery/artifacts/cache-miss.sequence.html",
- "artifactSha256": "6acd3926a89a7ea1d53de6dd072552a63cfe858eae38505bf7b2ef0bca4342e8",
+ "artifactSha256": "371e790fa410c221903e97097ba07cd559093170d95987662040870e4ab45a79",
"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.html
index 4a57d061..ad4eef38 100644
--- a/docs/cases/mco-runtime.architecture.html
+++ b/docs/cases/mco-runtime.architecture.html
@@ -5036,7 +5036,7 @@
<!-- Footer -->
<p class="footer">
- Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery.html b/docs/gallery.html
index e2836ba8..6eee3469 100644
--- a/docs/gallery.html
+++ b/docs/gallery.html
@@ -327,7 +327,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="5dcc43441ca3c5dac66f7d0ea2cd815596734ade9bba71f11f04501f19827cfc">5dcc43441ca3</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="1ef0a5d371122c038436ab07ef8c319ca683590222f48d45622f73c28fd24c86">1ef0a5d37112</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/agent-tool-call.workflow.html?present=1&amp;play=1#view=happy-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -356,7 +356,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="a9eadd97b44b97622c2c506ae54b1e98b8da4a4ac4b1142249a32865b8d5b1c3">a9eadd97b44b</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="e0ead588fb48511d5695fddbeb5871a76357d8c657644e163dfba454d082a1f5">e0ead588fb48</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/production-deployment.architecture.html?present=1&amp;play=1#view=request-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -384,7 +384,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="6acd3926a89a7ea1d53de6dd072552a63cfe858eae38505bf7b2ef0bca4342e8">6acd3926a89a</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="371e790fa410c221903e97097ba07cd559093170d95987662040870e4ab45a79">371e790fa410</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/cache-miss.sequence.html?present=1&amp;play=1#view=cache-fallback" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -412,7 +412,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="2c78e3fe32c5fc4dcbee5a66b7883137f1c2f11355b20a68f62727437f81858b">2c78e3fe32c5</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="1071371e458ce7e4a8373477f69004abe014976d40b79395d0e601a5b757e88f">1071371e458c</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/release-delivery.workflow.html?present=1&amp;play=1#view=approval-to-production" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -440,7 +440,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="29e3361a83566e4bb560bed2982e221751439bf43394337f5367d00202146999">29e3361a8356</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="f34b57900e70f73f089ba8cba5c8e3c057c97dbe0285f4576efbd1c9ad4274d1">f34b57900e70</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/incident-response.workflow.html?present=1&amp;play=1#view=mitigate-and-verify" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -468,7 +468,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="f5367b1ffa3bbff4a8da232e73ca5d68d3b799c343dbfed0d5298ac86b76849a">f5367b1ffa3b</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="ced8f6d7dc818dd85510d9028b0ba91b524221648e6cdd1fc01084b8b1533ebf">ced8f6d7dc81</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/product-analytics.dataflow.html?present=1&amp;play=1#view=consent-boundary" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -496,7 +496,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="ab66af1e96145292a6c6ae0779fdcef8db05bdbd32060c14ca537cf82bfa8a79">ab66af1e9614</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="018c81d577ff248e46ad038ea2f09fbb3504ea4fd10fc51e18ba5dc1f6868ab7">018c81d577ff</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/async-job-roundtrip.sequence.html?present=1&amp;play=1#view=work-and-retry" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -524,7 +524,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="af828c5d5bcb4f273b7237ff6326a8d5708008888501a799780ea169fb1aa8db">af828c5d5bcb</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="e907d9738ed96b7916e9e11f4e586f743a97136a02ab9abcfe34654d36ebb6ca">e907d9738ed9</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/event-stream.dataflow.html?present=1&amp;play=1#view=order-transit" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -552,7 +552,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 · 5E</span></div>
- <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="c8249bca9a75fb086979737923883cca5f469ae5a1d22a69513aecc5a53a0354">c8249bca9a75</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="752ff97087e502427c900ff6ff3948bb5c2acdd592bb822e2d2cfde4114262a5">752ff97087e5</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/agent-run.lifecycle.html?present=1&amp;play=1#view=main-lifecycle" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -580,7 +580,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="2d5d1b17ac04d29668f3249f1282b2ad531f87ae21884f12b78ca9f91ddd9b8c">2d5d1b17ac04</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="4be5e1dd4dbf5cc4a282f3e1130a6396f2907c6f69de8e98b689d16d606bc050">4be5e1dd4dbf</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/deployment-release.lifecycle.html?present=1&amp;play=1#view=rollback-outcomes" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -608,7 +608,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="352fa82e90ba4f470b43bcc1460631c882d83151d9b692bef63b3625b8ad67d6">352fa82e90ba</span></div>
+ <div class="receipt-cell"><span class="receipt-label">SHA-256</span><span class="receipt-value" title="20b54eecdc52a5fe0de96e72aa60f55360745cc7bac9840ac13cdc451dffb27d">20b54eecdc52</span></div>
</div>
<div class="card-actions">
<a class="card-link primary" href="gallery/artifacts/web-app.architecture.html?present=1&amp;play=1#view=request-path" target="_blank" rel="noopener" data-en="Play named chapter ↗" data-zh="播放命名章节 ↗">Play named chapter ↗</a>
@@ -686,8 +686,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 11,
- "artifactBytes": 619305,
- "artifactSha256": "5dcc43441ca3c5dac66f7d0ea2cd815596734ade9bba71f11f04501f19827cfc",
+ "artifactBytes": 619325,
+ "artifactSha256": "1ef0a5d371122c038436ab07ef8c319ca683590222f48d45622f73c28fd24c86",
"sourceBytes": 6470,
"sourceSha256": "a3afc6b30044eb256aa15c6195ddfbbcd1a14880d99967ed5605bc621ffb7e5f",
"checks": [
@@ -784,8 +784,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": "deployment-ownership",
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 619629,
- "artifactSha256": "a9eadd97b44b97622c2c506ae54b1e98b8da4a4ac4b1142249a32865b8d5b1c3",
+ "artifactBytes": 619649,
+ "artifactSha256": "e0ead588fb48511d5695fddbeb5871a76357d8c657644e163dfba454d082a1f5",
"sourceBytes": 5546,
"sourceSha256": "03e647d057eb20d99f7fb4ba4ddfdd5d58a7a813865338680e968038e6a90e0f",
"checks": [
@@ -882,8 +882,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 12,
- "artifactBytes": 612952,
- "artifactSha256": "6acd3926a89a7ea1d53de6dd072552a63cfe858eae38505bf7b2ef0bca4342e8",
+ "artifactBytes": 612972,
+ "artifactSha256": "371e790fa410c221903e97097ba07cd559093170d95987662040870e4ab45a79",
"sourceBytes": 4442,
"sourceSha256": "30098d81006a18813bab447da698edf74604a1463770f01dc056b0af8cb314ef",
"checks": [
@@ -980,8 +980,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 615571,
- "artifactSha256": "2c78e3fe32c5fc4dcbee5a66b7883137f1c2f11355b20a68f62727437f81858b",
+ "artifactBytes": 615591,
+ "artifactSha256": "1071371e458ce7e4a8373477f69004abe014976d40b79395d0e601a5b757e88f",
"sourceBytes": 5256,
"sourceSha256": "44aa56ac6ca807937dfe84a6404e8b07d6394a38ae2ac53248a1985337dfd671",
"checks": [
@@ -1078,8 +1078,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 10,
- "artifactBytes": 615429,
- "artifactSha256": "29e3361a83566e4bb560bed2982e221751439bf43394337f5367d00202146999",
+ "artifactBytes": 615449,
+ "artifactSha256": "f34b57900e70f73f089ba8cba5c8e3c057c97dbe0285f4576efbd1c9ad4274d1",
"sourceBytes": 5471,
"sourceSha256": "9beb8698b275679a2fc92d4b51288cd5b5fc2115696d06b9168f3d7fef253a72",
"checks": [
@@ -1176,8 +1176,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 616962,
- "artifactSha256": "f5367b1ffa3bbff4a8da232e73ca5d68d3b799c343dbfed0d5298ac86b76849a",
+ "artifactBytes": 616982,
+ "artifactSha256": "ced8f6d7dc818dd85510d9028b0ba91b524221648e6cdd1fc01084b8b1533ebf",
"sourceBytes": 5719,
"sourceSha256": "f71c89288f80255bdedcdc0057bcbc155d1d8b1b7476d024b35f4e27c730c974",
"checks": [
@@ -1274,8 +1274,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 14,
- "artifactBytes": 613737,
- "artifactSha256": "ab66af1e96145292a6c6ae0779fdcef8db05bdbd32060c14ca537cf82bfa8a79",
+ "artifactBytes": 613757,
+ "artifactSha256": "018c81d577ff248e46ad038ea2f09fbb3504ea4fd10fc51e18ba5dc1f6868ab7",
"sourceBytes": 4483,
"sourceSha256": "1b53d7c4ce7b2d8f6f40b8f33a394abe1d37fc991272b534c1ccd0255920ab52",
"checks": [
@@ -1372,8 +1372,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 620917,
- "artifactSha256": "af828c5d5bcb4f273b7237ff6326a8d5708008888501a799780ea169fb1aa8db",
+ "artifactBytes": 620937,
+ "artifactSha256": "e907d9738ed96b7916e9e11f4e586f743a97136a02ab9abcfe34654d36ebb6ca",
"sourceBytes": 5543,
"sourceSha256": "bbfedc2f1b73bf50932490f7f56d45d5f853e970d2fab26660a04947a783969c",
"checks": [
@@ -1470,8 +1470,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 5,
- "artifactBytes": 609907,
- "artifactSha256": "c8249bca9a75fb086979737923883cca5f469ae5a1d22a69513aecc5a53a0354",
+ "artifactBytes": 609927,
+ "artifactSha256": "752ff97087e502427c900ff6ff3948bb5c2acdd592bb822e2d2cfde4114262a5",
"sourceBytes": 4353,
"sourceSha256": "1d6b34282e014cb2730662b1993158ec67bc0ad2a40520cb441aaee1ad21e4c6",
"checks": [
@@ -1568,8 +1568,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 6,
- "artifactBytes": 611284,
- "artifactSha256": "2d5d1b17ac04d29668f3249f1282b2ad531f87ae21884f12b78ca9f91ddd9b8c",
+ "artifactBytes": 611304,
+ "artifactSha256": "4be5e1dd4dbf5cc4a282f3e1130a6396f2907c6f69de8e98b689d16d606bc050",
"sourceBytes": 4394,
"sourceSha256": "aa614f0c9a82f210e301e382f362dfbd7f290bda4d5501de3c99a6cd81b4c0a4",
"checks": [
@@ -1666,8 +1666,8 @@ receipt 99 checks / 11 artifacts / deterministic hashes</pre>
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 9,
- "artifactBytes": 610916,
- "artifactSha256": "352fa82e90ba4f470b43bcc1460631c882d83151d9b692bef63b3625b8ad67d6",
+ "artifactBytes": 610936,
+ "artifactSha256": "20b54eecdc52a5fe0de96e72aa60f55360745cc7bac9840ac13cdc451dffb27d",
"sourceBytes": 3863,
"sourceSha256": "01567b5e49cad5139baa071533a028d22f0e80fedfb49095e0d9330aee7f87db",
"checks": [
diff --git a/docs/gallery/artifacts/agent-run.lifecycle.html b/docs/gallery/artifacts/agent-run.lifecycle.html
index 2334d261..6f0d0838 100644
--- a/docs/gallery/artifacts/agent-run.lifecycle.html
+++ b/docs/gallery/artifacts/agent-run.lifecycle.html
@@ -4968,7 +4968,7 @@
<!-- Footer -->
<p class="footer">
- Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/agent-tool-call.workflow.html b/docs/gallery/artifacts/agent-tool-call.workflow.html
index d4c59fb5..08d9f501 100644
--- a/docs/gallery/artifacts/agent-tool-call.workflow.html
+++ b/docs/gallery/artifacts/agent-tool-call.workflow.html
@@ -5048,7 +5048,7 @@
<!-- Footer -->
<p class="footer">
- Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/async-job-roundtrip.sequence.html b/docs/gallery/artifacts/async-job-roundtrip.sequence.html
index df361132..078e9e60 100644
--- a/docs/gallery/artifacts/async-job-roundtrip.sequence.html
+++ b/docs/gallery/artifacts/async-job-roundtrip.sequence.html
@@ -5035,7 +5035,7 @@
<!-- Footer -->
<p class="footer">
- Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/cache-miss.sequence.html b/docs/gallery/artifacts/cache-miss.sequence.html
index 3574d859..7c787c7e 100644
--- a/docs/gallery/artifacts/cache-miss.sequence.html
+++ b/docs/gallery/artifacts/cache-miss.sequence.html
@@ -5019,7 +5019,7 @@
<!-- Footer -->
<p class="footer">
- Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/deployment-release.lifecycle.html b/docs/gallery/artifacts/deployment-release.lifecycle.html
index 2e39950d..2a2ef555 100644
--- a/docs/gallery/artifacts/deployment-release.lifecycle.html
+++ b/docs/gallery/artifacts/deployment-release.lifecycle.html
@@ -4982,7 +4982,7 @@
<!-- Footer -->
<p class="footer">
- Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/event-stream.dataflow.html b/docs/gallery/artifacts/event-stream.dataflow.html
index 8b8d83aa..fbf6ecf5 100644
--- a/docs/gallery/artifacts/event-stream.dataflow.html
+++ b/docs/gallery/artifacts/event-stream.dataflow.html
@@ -5054,7 +5054,7 @@
<!-- Footer -->
<p class="footer">
- Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/incident-response.workflow.html b/docs/gallery/artifacts/incident-response.workflow.html
index 20b9af43..a17f60fb 100644
--- a/docs/gallery/artifacts/incident-response.workflow.html
+++ b/docs/gallery/artifacts/incident-response.workflow.html
@@ -5017,7 +5017,7 @@
<!-- Footer -->
<p class="footer">
- Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/product-analytics.dataflow.html b/docs/gallery/artifacts/product-analytics.dataflow.html
index 73017361..07df163b 100644
--- a/docs/gallery/artifacts/product-analytics.dataflow.html
+++ b/docs/gallery/artifacts/product-analytics.dataflow.html
@@ -5015,7 +5015,7 @@
<!-- Footer -->
<p class="footer">
- Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/production-deployment.architecture.html b/docs/gallery/artifacts/production-deployment.architecture.html
index 17338376..b58191e5 100644
--- a/docs/gallery/artifacts/production-deployment.architecture.html
+++ b/docs/gallery/artifacts/production-deployment.architecture.html
@@ -5043,7 +5043,7 @@
<!-- Footer -->
<p class="footer">
- Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/release-delivery.workflow.html b/docs/gallery/artifacts/release-delivery.workflow.html
index 491444ae..304ed980 100644
--- a/docs/gallery/artifacts/release-delivery.workflow.html
+++ b/docs/gallery/artifacts/release-delivery.workflow.html
@@ -5017,7 +5017,7 @@
<!-- Footer -->
<p class="footer">
- Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/artifacts/web-app.architecture.html b/docs/gallery/artifacts/web-app.architecture.html
index 02ad0191..9d4d2c56 100644
--- a/docs/gallery/artifacts/web-app.architecture.html
+++ b/docs/gallery/artifacts/web-app.architecture.html
@@ -4984,7 +4984,7 @@
<!-- Footer -->
<p class="footer">
- Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/docs/gallery/manifest.json b/docs/gallery/manifest.json
index bc9195b3..27a75196 100644
--- a/docs/gallery/manifest.json
+++ b/docs/gallery/manifest.json
@@ -27,8 +27,8 @@
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 11,
- "artifactBytes": 619305,
- "artifactSha256": "5dcc43441ca3c5dac66f7d0ea2cd815596734ade9bba71f11f04501f19827cfc",
+ "artifactBytes": 619325,
+ "artifactSha256": "1ef0a5d371122c038436ab07ef8c319ca683590222f48d45622f73c28fd24c86",
"sourceBytes": 6470,
"sourceSha256": "a3afc6b30044eb256aa15c6195ddfbbcd1a14880d99967ed5605bc621ffb7e5f",
"checks": [
@@ -125,8 +125,8 @@
"engineeringProfile": "deployment-ownership",
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 619629,
- "artifactSha256": "a9eadd97b44b97622c2c506ae54b1e98b8da4a4ac4b1142249a32865b8d5b1c3",
+ "artifactBytes": 619649,
+ "artifactSha256": "e0ead588fb48511d5695fddbeb5871a76357d8c657644e163dfba454d082a1f5",
"sourceBytes": 5546,
"sourceSha256": "03e647d057eb20d99f7fb4ba4ddfdd5d58a7a813865338680e968038e6a90e0f",
"checks": [
@@ -223,8 +223,8 @@
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 12,
- "artifactBytes": 612952,
- "artifactSha256": "6acd3926a89a7ea1d53de6dd072552a63cfe858eae38505bf7b2ef0bca4342e8",
+ "artifactBytes": 612972,
+ "artifactSha256": "371e790fa410c221903e97097ba07cd559093170d95987662040870e4ab45a79",
"sourceBytes": 4442,
"sourceSha256": "30098d81006a18813bab447da698edf74604a1463770f01dc056b0af8cb314ef",
"checks": [
@@ -321,8 +321,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 615571,
- "artifactSha256": "2c78e3fe32c5fc4dcbee5a66b7883137f1c2f11355b20a68f62727437f81858b",
+ "artifactBytes": 615591,
+ "artifactSha256": "1071371e458ce7e4a8373477f69004abe014976d40b79395d0e601a5b757e88f",
"sourceBytes": 5256,
"sourceSha256": "44aa56ac6ca807937dfe84a6404e8b07d6394a38ae2ac53248a1985337dfd671",
"checks": [
@@ -419,8 +419,8 @@
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 10,
- "artifactBytes": 615429,
- "artifactSha256": "29e3361a83566e4bb560bed2982e221751439bf43394337f5367d00202146999",
+ "artifactBytes": 615449,
+ "artifactSha256": "f34b57900e70f73f089ba8cba5c8e3c057c97dbe0285f4576efbd1c9ad4274d1",
"sourceBytes": 5471,
"sourceSha256": "9beb8698b275679a2fc92d4b51288cd5b5fc2115696d06b9168f3d7fef253a72",
"checks": [
@@ -517,8 +517,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 10,
- "artifactBytes": 616962,
- "artifactSha256": "f5367b1ffa3bbff4a8da232e73ca5d68d3b799c343dbfed0d5298ac86b76849a",
+ "artifactBytes": 616982,
+ "artifactSha256": "ced8f6d7dc818dd85510d9028b0ba91b524221648e6cdd1fc01084b8b1533ebf",
"sourceBytes": 5719,
"sourceSha256": "f71c89288f80255bdedcdc0057bcbc155d1d8b1b7476d024b35f4e27c730c974",
"checks": [
@@ -615,8 +615,8 @@
"engineeringProfile": null,
"nodeCount": 7,
"edgeCount": 14,
- "artifactBytes": 613737,
- "artifactSha256": "ab66af1e96145292a6c6ae0779fdcef8db05bdbd32060c14ca537cf82bfa8a79",
+ "artifactBytes": 613757,
+ "artifactSha256": "018c81d577ff248e46ad038ea2f09fbb3504ea4fd10fc51e18ba5dc1f6868ab7",
"sourceBytes": 4483,
"sourceSha256": "1b53d7c4ce7b2d8f6f40b8f33a394abe1d37fc991272b534c1ccd0255920ab52",
"checks": [
@@ -713,8 +713,8 @@
"engineeringProfile": null,
"nodeCount": 12,
"edgeCount": 12,
- "artifactBytes": 620917,
- "artifactSha256": "af828c5d5bcb4f273b7237ff6326a8d5708008888501a799780ea169fb1aa8db",
+ "artifactBytes": 620937,
+ "artifactSha256": "e907d9738ed96b7916e9e11f4e586f743a97136a02ab9abcfe34654d36ebb6ca",
"sourceBytes": 5543,
"sourceSha256": "bbfedc2f1b73bf50932490f7f56d45d5f853e970d2fab26660a04947a783969c",
"checks": [
@@ -811,8 +811,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 5,
- "artifactBytes": 609907,
- "artifactSha256": "c8249bca9a75fb086979737923883cca5f469ae5a1d22a69513aecc5a53a0354",
+ "artifactBytes": 609927,
+ "artifactSha256": "752ff97087e502427c900ff6ff3948bb5c2acdd592bb822e2d2cfde4114262a5",
"sourceBytes": 4353,
"sourceSha256": "1d6b34282e014cb2730662b1993158ec67bc0ad2a40520cb441aaee1ad21e4c6",
"checks": [
@@ -909,8 +909,8 @@
"engineeringProfile": null,
"nodeCount": 11,
"edgeCount": 6,
- "artifactBytes": 611284,
- "artifactSha256": "2d5d1b17ac04d29668f3249f1282b2ad531f87ae21884f12b78ca9f91ddd9b8c",
+ "artifactBytes": 611304,
+ "artifactSha256": "4be5e1dd4dbf5cc4a282f3e1130a6396f2907c6f69de8e98b689d16d606bc050",
"sourceBytes": 4394,
"sourceSha256": "aa614f0c9a82f210e301e382f362dfbd7f290bda4d5501de3c99a6cd81b4c0a4",
"checks": [
@@ -1007,8 +1007,8 @@
"engineeringProfile": null,
"nodeCount": 10,
"edgeCount": 9,
- "artifactBytes": 610916,
- "artifactSha256": "352fa82e90ba4f470b43bcc1460631c882d83151d9b692bef63b3625b8ad67d6",
+ "artifactBytes": 610936,
+ "artifactSha256": "20b54eecdc52a5fe0de96e72aa60f55360745cc7bac9840ac13cdc451dffb27d",
"sourceBytes": 3863,
"sourceSha256": "01567b5e49cad5139baa071533a028d22f0e80fedfb49095e0d9330aee7f87db",
"checks": [
diff --git a/docs/index.html b/docs/index.html
index 8a13ffaf..29725d86 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -372,7 +372,7 @@
</nav>
<!-- HERO — bento: intro / live proof / specimen rail / stats -->
- <section class="hero">
+ <section class="hero" data-proof-aperture="first-fold">
<div class="container">
<div class="hero-bento">
<div class="hero-intro">
diff --git a/docs/start.html b/docs/start.html
index 60811f12..47a4e938 100644
--- a/docs/start.html
+++ b/docs/start.html
@@ -254,7 +254,7 @@
<div class="command-bar"><span data-en="This repository only" data-zh="仅安装到当前仓库">This repository only</span><button class="copy-button" type="button" data-copy-source="project-command" data-en="Copy" data-zh="复制">Copy</button></div>
<pre id="project-command">npx -y skills add tt-a1i/archify --skill archify --agent codex --copy --yes</pre>
</div>
- <p class="secondary-note" data-en="The Start link carries only your agent, language, and diagram type. It never contains a repository path, title, node, relationship, or source JSON." data-zh="Start 链接只携带 Agent、语言和图表类型,不包含仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, and diagram type. It never contains a repository path, title, node, relationship, or source JSON.</p>
+ <p class="secondary-note" data-en="The Start link carries only your agent, language, diagram type, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded." data-zh="Start 链接只携带 Agent、语言、图表类型和粗粒度来源标签。转化步骤只保存在当前浏览器会话中,Archify 不会发送这些数据,也不会记录仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, diagram type, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded.</p>
</article>
<article class="panel" aria-live="polite">
@@ -264,7 +264,8 @@
<ul class="include-list" id="include-list" aria-label="Required evidence"></ul>
<p class="prompt-box" id="recipe-prompt"></p>
<div class="actions">
- <button class="action action-primary" id="copy-prompt" type="button" data-en="Copy exact prompt" data-zh="复制准确提示词">Copy exact prompt</button>
+ <button class="action action-primary" id="copy-starter" type="button" data-en="Copy install + prompt" data-zh="复制安装命令 + 提示词">Copy install + prompt</button>
+ <button class="action" id="copy-prompt" type="button" data-en="Prompt only" data-zh="仅复制提示词">Prompt only</button>
<a class="action" id="proof-link" href="gallery.html" data-en="Open verified proof ↗" data-zh="打开验证成品 ↗">Open verified proof ↗</a>
<a class="action" href="guide.html" data-en="Need another recipe?" data-zh="需要其他配方?">Need another recipe?</a>
</div>
@@ -287,12 +288,16 @@
var DATA = JSON.parse(document.getElementById('start-data').textContent);
var KNOWN_TYPES = new Set(['architecture', 'workflow', 'sequence', 'dataflow', 'lifecycle']);
var KNOWN_AGENTS = new Set(['cursor', 'codex', 'claude-code', 'opencode']);
+ var KNOWN_SOURCES = new Set(['artifact', 'gallery', 'readme', 'direct']);
+ var EVENT_KEY = 'archify.start.events.v1';
var params = new URLSearchParams(window.location.search);
var requestedType = params.get('type');
var requestedAgent = params.get('agent');
var requestedLanguage = params.get('lang');
+ var requestedSource = params.get('source');
var type = KNOWN_TYPES.has(requestedType) ? requestedType : 'architecture';
var agent = KNOWN_AGENTS.has(requestedAgent) ? requestedAgent : 'codex';
+ var source = KNOWN_SOURCES.has(requestedSource) ? requestedSource : 'direct';
var language = requestedLanguage === 'zh' || requestedLanguage === 'en'
? requestedLanguage
: ((navigator.languages && navigator.languages[0]) || navigator.language || 'en').toLowerCase().startsWith('zh') ? 'zh' : 'en';
@@ -327,9 +332,37 @@
next.set('type', type);
next.set('agent', agent);
next.set('lang', language);
+ next.set('source', source);
history.replaceState(null, '', window.location.pathname + '?' + next.toString());
}
+ function recordStep(step) {
+ var detail = {
+ schemaVersion: 1,
+ step: step,
+ source: source,
+ type: type,
+ agent: agent,
+ language: language
+ };
+ try {
+ var events = JSON.parse(sessionStorage.getItem(EVENT_KEY) || '[]');
+ if (!Array.isArray(events)) events = [];
+ events.push(detail);
+ sessionStorage.setItem(EVENT_KEY, JSON.stringify(events.slice(-24)));
+ } catch (_) {}
+ try { window.dispatchEvent(new CustomEvent('archify:start-funnel', { detail: detail })); } catch (_) {}
+ }
+
+ window.ArchifyStartMetrics = {
+ snapshot: function () {
+ try {
+ var events = JSON.parse(sessionStorage.getItem(EVENT_KEY) || '[]');
+ return Array.isArray(events) ? events.slice() : [];
+ } catch (_) { return []; }
+ }
+ };
+
function render() {
var recipe = DATA[type];
var copy = recipe[language];
@@ -377,10 +410,21 @@
if (!ok) throw new Error('copy failed');
}
- async function copyText(text) {
+ function starterText() {
+ var agentName = document.querySelector('[data-agent="' + agent + '"]').textContent;
+ if (language === 'zh') {
+ return '为 ' + agentName + ' 安装 Archify:\n' + installCommand.textContent.trim()
+ + '\n\n然后在目标仓库中让 ' + agentName + ' 执行:\n' + DATA[type][language].prompt;
+ }
+ return 'Install Archify for ' + agentName + ':\n' + installCommand.textContent.trim()
+ + '\n\nThen, in your target repository, ask ' + agentName + ':\n' + DATA[type][language].prompt;
+ }
+
+ async function copyText(text, step) {
try {
if (navigator.clipboard && window.isSecureContext) await navigator.clipboard.writeText(text);
else fallbackCopy(text);
+ if (step) recordStep(step);
copyStatus.textContent = language === 'zh' ? '已复制到剪贴板。' : 'Copied to clipboard.';
} catch (_) {
copyStatus.textContent = language === 'zh' ? '复制失败,请手动选择文本。' : 'Copy failed. Select the text manually.';
@@ -427,18 +471,24 @@
document.querySelectorAll('[data-copy-source]').forEach(function (button) {
button.addEventListener('click', function () {
- copyText(document.getElementById(button.dataset.copySource).textContent.trim());
+ var step = button.dataset.copySource === 'install-command' ? 'global_install_copy' : 'project_install_copy';
+ copyText(document.getElementById(button.dataset.copySource).textContent.trim(), step);
});
});
document.getElementById('copy-prompt').addEventListener('click', function () {
- copyText(DATA[type][language].prompt);
+ copyText(DATA[type][language].prompt, 'prompt_copy');
+ });
+ document.getElementById('copy-starter').addEventListener('click', function () {
+ copyText(starterText(), 'starter_copy');
});
+ proofLink.addEventListener('click', function () { recordStep('proof_open'); });
languageButton.addEventListener('click', function () {
language = language === 'zh' ? 'en' : 'zh';
render();
});
render();
+ recordStep('start_view');
})();
</script>
</body>
diff --git a/examples/dataflow-product-analytics.html b/examples/dataflow-product-analytics.html
index 73017361..07df163b 100644
--- a/examples/dataflow-product-analytics.html
+++ b/examples/dataflow-product-analytics.html
@@ -5015,7 +5015,7 @@
<!-- Footer -->
<p class="footer">
- Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Data-flow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=dataflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.html
index 2334d261..6f0d0838 100644
--- a/examples/lifecycle-agent-run.html
+++ b/examples/lifecycle-agent-run.html
@@ -4968,7 +4968,7 @@
<!-- Footer -->
<p class="footer">
- Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Lifecycle diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=lifecycle&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/examples/sequence-cache-miss-request.html b/examples/sequence-cache-miss-request.html
index 3574d859..7c787c7e 100644
--- a/examples/sequence-cache-miss-request.html
+++ b/examples/sequence-cache-miss-request.html
@@ -5019,7 +5019,7 @@
<!-- Footer -->
<p class="footer">
- Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Sequence diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=sequence&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/examples/web-app-rendered.html b/examples/web-app-rendered.html
index 02ad0191..9d4d2c56 100644
--- a/examples/web-app-rendered.html
+++ b/examples/web-app-rendered.html
@@ -4984,7 +4984,7 @@
<!-- Footer -->
<p class="footer">
- Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Architecture diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=architecture&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/examples/workflow-agent-tool-call-rendered.html b/examples/workflow-agent-tool-call-rendered.html
index d4c59fb5..08d9f501 100644
--- a/examples/workflow-agent-tool-call-rendered.html
+++ b/examples/workflow-agent-tool-call-rendered.html
@@ -5048,7 +5048,7 @@
<!-- Footer -->
<p class="footer">
- Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
+ Workflow diagram &bull; Built with Archify<span class="no-print"> &bull; <a class="artifact-start-link" href="https://tt-a1i.github.io/archify/start.html?type=workflow&amp;source=artifact" target="_blank" rel="noopener noreferrer">Create yours &nearr;</a> &bull; Hover to trace &bull; <kbd>R</kbd> route &bull; Click to focus &bull; <kbd>+</kbd>/<kbd>&minus;</kbd> zoom &bull; <kbd>M</kbd> radar &bull; <kbd>[</kbd>/<kbd>]</kbd> views &bull; <kbd>P</kbd> play story &bull; <kbd>T</kbd> theme &bull; <kbd>E</kbd> export</span>
</p>
</div>
diff --git a/scripts/start-template.html b/scripts/start-template.html
index db22ebc2..6b1306ee 100644
--- a/scripts/start-template.html
+++ b/scripts/start-template.html
@@ -254,7 +254,7 @@
<div class="command-bar"><span data-en="This repository only" data-zh="仅安装到当前仓库">This repository only</span><button class="copy-button" type="button" data-copy-source="project-command" data-en="Copy" data-zh="复制">Copy</button></div>
<pre id="project-command">npx -y skills add tt-a1i/archify --skill archify --agent codex --copy --yes</pre>
</div>
- <p class="secondary-note" data-en="The Start link carries only your agent, language, and diagram type. It never contains a repository path, title, node, relationship, or source JSON." data-zh="Start 链接只携带 Agent、语言和图表类型,不包含仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, and diagram type. It never contains a repository path, title, node, relationship, or source JSON.</p>
+ <p class="secondary-note" data-en="The Start link carries only your agent, language, diagram type, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded." data-zh="Start 链接只携带 Agent、语言、图表类型和粗粒度来源标签。转化步骤只保存在当前浏览器会话中,Archify 不会发送这些数据,也不会记录仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, diagram type, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded.</p>
</article>
<article class="panel" aria-live="polite">
@@ -264,7 +264,8 @@
<ul class="include-list" id="include-list" aria-label="Required evidence"></ul>
<p class="prompt-box" id="recipe-prompt"></p>
<div class="actions">
- <button class="action action-primary" id="copy-prompt" type="button" data-en="Copy exact prompt" data-zh="复制准确提示词">Copy exact prompt</button>
+ <button class="action action-primary" id="copy-starter" type="button" data-en="Copy install + prompt" data-zh="复制安装命令 + 提示词">Copy install + prompt</button>
+ <button class="action" id="copy-prompt" type="button" data-en="Prompt only" data-zh="仅复制提示词">Prompt only</button>
<a class="action" id="proof-link" href="gallery.html" data-en="Open verified proof ↗" data-zh="打开验证成品 ↗">Open verified proof ↗</a>
<a class="action" href="guide.html" data-en="Need another recipe?" data-zh="需要其他配方?">Need another recipe?</a>
</div>
@@ -287,12 +288,16 @@
var DATA = JSON.parse(document.getElementById('start-data').textContent);
var KNOWN_TYPES = new Set(['architecture', 'workflow', 'sequence', 'dataflow', 'lifecycle']);
var KNOWN_AGENTS = new Set(['cursor', 'codex', 'claude-code', 'opencode']);
+ var KNOWN_SOURCES = new Set(['artifact', 'gallery', 'readme', 'direct']);
+ var EVENT_KEY = 'archify.start.events.v1';
var params = new URLSearchParams(window.location.search);
var requestedType = params.get('type');
var requestedAgent = params.get('agent');
var requestedLanguage = params.get('lang');
+ var requestedSource = params.get('source');
var type = KNOWN_TYPES.has(requestedType) ? requestedType : 'architecture';
var agent = KNOWN_AGENTS.has(requestedAgent) ? requestedAgent : 'codex';
+ var source = KNOWN_SOURCES.has(requestedSource) ? requestedSource : 'direct';
var language = requestedLanguage === 'zh' || requestedLanguage === 'en'
? requestedLanguage
: ((navigator.languages && navigator.languages[0]) || navigator.language || 'en').toLowerCase().startsWith('zh') ? 'zh' : 'en';
@@ -327,9 +332,37 @@
next.set('type', type);
next.set('agent', agent);
next.set('lang', language);
+ next.set('source', source);
history.replaceState(null, '', window.location.pathname + '?' + next.toString());
}
+ function recordStep(step) {
+ var detail = {
+ schemaVersion: 1,
+ step: step,
+ source: source,
+ type: type,
+ agent: agent,
+ language: language
+ };
+ try {
+ var events = JSON.parse(sessionStorage.getItem(EVENT_KEY) || '[]');
+ if (!Array.isArray(events)) events = [];
+ events.push(detail);
+ sessionStorage.setItem(EVENT_KEY, JSON.stringify(events.slice(-24)));
+ } catch (_) {}
+ try { window.dispatchEvent(new CustomEvent('archify:start-funnel', { detail: detail })); } catch (_) {}
+ }
+
+ window.ArchifyStartMetrics = {
+ snapshot: function () {
+ try {
+ var events = JSON.parse(sessionStorage.getItem(EVENT_KEY) || '[]');
+ return Array.isArray(events) ? events.slice() : [];
+ } catch (_) { return []; }
+ }
+ };
+
function render() {
var recipe = DATA[type];
var copy = recipe[language];
@@ -377,10 +410,21 @@
if (!ok) throw new Error('copy failed');
}
- async function copyText(text) {
+ function starterText() {
+ var agentName = document.querySelector('[data-agent="' + agent + '"]').textContent;
+ if (language === 'zh') {
+ return '为 ' + agentName + ' 安装 Archify:\n' + installCommand.textContent.trim()
+ + '\n\n然后在目标仓库中让 ' + agentName + ' 执行:\n' + DATA[type][language].prompt;
+ }
+ return 'Install Archify for ' + agentName + ':\n' + installCommand.textContent.trim()
+ + '\n\nThen, in your target repository, ask ' + agentName + ':\n' + DATA[type][language].prompt;
+ }
+
+ async function copyText(text, step) {
try {
if (navigator.clipboard && window.isSecureContext) await navigator.clipboard.writeText(text);
else fallbackCopy(text);
+ if (step) recordStep(step);
copyStatus.textContent = language === 'zh' ? '已复制到剪贴板。' : 'Copied to clipboard.';
} catch (_) {
copyStatus.textContent = language === 'zh' ? '复制失败,请手动选择文本。' : 'Copy failed. Select the text manually.';
@@ -427,18 +471,24 @@
document.querySelectorAll('[data-copy-source]').forEach(function (button) {
button.addEventListener('click', function () {
- copyText(document.getElementById(button.dataset.copySource).textContent.trim());
+ var step = button.dataset.copySource === 'install-command' ? 'global_install_copy' : 'project_install_copy';
+ copyText(document.getElementById(button.dataset.copySource).textContent.trim(), step);
});
});
document.getElementById('copy-prompt').addEventListener('click', function () {
- copyText(DATA[type][language].prompt);
+ copyText(DATA[type][language].prompt, 'prompt_copy');
+ });
+ document.getElementById('copy-starter').addEventListener('click', function () {
+ copyText(starterText(), 'starter_copy');
});
+ proofLink.addEventListener('click', function () { recordStep('proof_open'); });
languageButton.addEventListener('click', function () {
language = language === 'zh' ? 'en' : 'zh';
render();
});
render();
+ recordStep('start_view');
})();
</script>
</body>