Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo
- **Explainer copy failures are reported (#1302).** When the clipboard is unavailable or refuses, the reader shows an error instead of claiming success and keeps the follow-up question selected in the open dialog so it can be copied by hand.
- **Compact automatic Sequence recovers first-screen fit after header reflow (#1151).** When a compact automatic Sequence header settles, the optional 12px bottom gap may yield to the original text-size floor, so the reader no longer chooses an enlarged scrolling diagram that still fits the first screen. Long sequences still scroll, and source text is not shrunk. Thanks to [@BlueboxC](https://github.com/BlueboxC).
- **README motion proof refreshed after Sequence header centering (#1293).** The README animation and its receipt are rebuilt from the current gallery artifacts, so the freshness check passes again. Thanks to [@BlueboxC](https://github.com/BlueboxC), who first identified the stale proof and recaptured it in [#1174](https://github.com/tt-a1i/archify/pull/1174); #1293 follows the same approach.
- **Explainer-hosted Viewer hides standalone preset badges (#1196, #1195).** The Viewer an explainer opens keeps the page-selected preset and its tools, and hides the standalone title badges and the editorial plate. Standalone presentation is unchanged. Thanks to [@HengYangDS](https://github.com/HengYangDS).

## [3.2.0] — 2026-10-18

Expand Down
Binary file modified archify.zip
Binary file not shown.
4 changes: 4 additions & 0 deletions archify/assets/template.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/class-payment-processors-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/class-payments-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/dataflow-product-analytics.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/erd-orders-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/lifecycle-agent-run.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/sequence-cache-miss-request.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/subscription-billing-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/timeline-archify-dev-activity-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/timeline-payment-incident-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/tree-archify-repository-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/tree-payment-platform-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/waterfall-checkout-request-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/waterfall-example-rebuild-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/web-app-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

4 changes: 4 additions & 0 deletions archify/examples/workflow-agent-tool-call-rendered.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion archify/explainer/browser-check.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ export async function inspectNativeViewer(browser) {
const stop=browser.cdp.subscribe?.(m=>{if(m.sessionId!==attached.sessionId)return;if(m.method==='Runtime.exceptionThrown')errors.push(m.params.exceptionDetails.exception?.description||m.params.exceptionDetails.text);if(m.method==='Runtime.consoleAPICalled'&&m.params.type==='error')errors.push(m.params.args.map(a=>a.value??a.description).join(' '));});
try {
await browser.cdp.send('Runtime.enable',{},attached.sessionId);
const result=await browser.cdp.send('Runtime.evaluate',{expression:"({ready:document.readyState,visibility:document.visibilityState,href:location.href,active:document.querySelector('svg[data-focus-active]')?.dataset.focusActive||'',nodes:[...new Set(Array.from(document.querySelectorAll('[data-focus-selected]')).map(e=>e.dataset.nodeId).filter(Boolean))],edges:[...new Set(Array.from(document.querySelectorAll('[data-edge-id][data-focus-match]')).map(e=>e.dataset.edgeId))],hasViewer:Boolean(window.Archify?.focus)})",returnByValue:true},attached.sessionId);
const result=await browser.cdp.send('Runtime.evaluate',{expression:"({ready:document.readyState,visibility:document.visibilityState,href:location.href,active:document.querySelector('svg[data-focus-active]')?.dataset.focusActive||'',nodes:[...new Set(Array.from(document.querySelectorAll('[data-focus-selected]')).map(e=>e.dataset.nodeId).filter(Boolean))],edges:[...new Set(Array.from(document.querySelectorAll('[data-edge-id][data-focus-match]')).map(e=>e.dataset.edgeId))],hasViewer:Boolean(window.Archify?.focus),preset:document.documentElement.dataset.preset||'',badges:['.header-row','.diagram-container'].map(s=>{const e=document.querySelector(s);return e?getComputedStyle(e,'::after').display:'absent';})})",returnByValue:true},attached.sessionId);
if(result.exceptionDetails)throw new Error(result.exceptionDetails.text);
return {available:true,targetId:target.targetId,...result.result.value,errors};
} finally {stop?.();await browser.cdp.send('Target.detachFromTarget',{sessionId:attached.sessionId});}
Expand Down
2 changes: 2 additions & 0 deletions archify/explainer/reader.js
Original file line number Diff line number Diff line change
Expand Up @@ -400,6 +400,8 @@
const frame = document.createElement('iframe'); frame.addEventListener('load',()=>{viewerDialog.dataset.nativeLoaded = id;}); frame.title = byId('diagram-dialog-title').textContent;
frame.setAttribute('sandbox','allow-scripts allow-downloads allow-modals');
const script = `<script>(()=>{
// The page around this Viewer names the diagram, so the preset's standalone badges stay off.
document.documentElement.dataset.hosted='explainer';
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
const token=${JSON.stringify(token)};
let pending=null;
const settle=data=>requestAnimationFrame(()=>{
Expand Down
Binary file modified docs/assets/archify-live-proof.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 5 additions & 5 deletions docs/assets/archify-live-proof.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@
"fps": 10,
"frameCount": 54,
"durationSeconds": 5.4,
"bytes": 836142,
"sha256": "e7993f158961fd1308890fd0d75ebe410f9a947cd28956390de0361f4fc811af",
"bytes": 843963,
"sha256": "a89dd4d2e86c19d49fa295753614b17aebcc7175c3dd44f03f6a91e0ce58ece5",
"scenes": [
{
"id": "signal-flow",
"artifact": "docs/gallery/artifacts/agent-tool-call.workflow.html",
"artifactSha256": "2a7c689effcdbbd877fb98926de3defbd2e3286584ac8812559f2dfbb481cae8",
"artifactSha256": "1feb579f3b9fa486e9c00a5a4ba8a8bb142cd3377127221b0efce66fccc5e843",
"hash": "#focus=planner&reach=downstream",
"eyebrow": "WORKFLOW · SIGNAL FLOW",
"title": "Agent Tool Call",
Expand All @@ -22,7 +22,7 @@
{
"id": "blueprint",
"artifact": "docs/gallery/artifacts/production-deployment.architecture.html",
"artifactSha256": "62af251a4b95a3e31c016741e5570a82bccb5c95e6ef7e7d926408a5e4b9ad27",
"artifactSha256": "0a9e5cdb235135f7054df31ea71ed132b33bb1e52ea6cf49c3ef4f8180ede274",
"hash": "#lens=backend~database",
"eyebrow": "ARCHITECTURE · BLUEPRINT",
"title": "Production Deployment",
Expand All @@ -31,7 +31,7 @@
{
"id": "classic",
"artifact": "docs/gallery/artifacts/cache-miss.sequence.html",
"artifactSha256": "28151cee3e8417795ec99f1f784226c6152731c55f521d5d9823c1b12ad71d1e",
"artifactSha256": "96f27ffa5ec40dc4d401f30a2b1693999b830ce6e529d64239ad7e1f0a09bfab",
"hash": "#route=web~db",
"eyebrow": "SEQUENCE · CLASSIC",
"title": "Cache Miss Request",
Expand Down
25 changes: 25 additions & 0 deletions docs/evidence/hosted-viewer-badges/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Hosted Viewer badges (#1195, #1196)

An editorial explainer should retain its preset and Viewer tools without the standalone field-note and plate badges. The standalone Viewer remains unchanged.

Comparison base: `63c9263e84bd3993cab8e09b3d69888857858635`.
Candidate source: `bd5b9f321056c79d7adc27540592bc72afd3d81c`.
Both use the same [explainer input](explainer.json), Chrome, Node.js 22.23.3, 1440 × 900 viewport, light theme, editorial preset, and open “Read cache” step. Captures wait 800 ms after the editorial preset has applied.

| Before | After |
| -------------------------------------------------- | ------------------------------------------------ |
| ![Hosted Viewer before](before.1440x900.light.png) | ![Hosted Viewer after](after.1440x900.light.png) |

The [receipt](evidence.json) records input and image hashes, browser observations, and the pixel comparison. Exactly 3,271 of 1,296,000 pixels change, within the two badge regions. The title, toolbar, diagram, legend, and controls are pixel-identical. The browser reports both badges as `block` on the base and `none` on the candidate; the preset remains `editorial`.

The Agent inspected both captures. @HengYangDS personally reviewed the submitted changes and explanation and confirmed understanding on 6 November 2026. Maintainer scope agreement was recorded on 6 November in [#1195](https://github.com/tt-a1i/archify/issues/1195#issuecomment-6690778603). The capture receipt retains the review state observed when the images were taken. This fixed-input presentation comparison makes no claim about Agent generation speed or first-draft quality.

The related behavioral regression can be run from the repository root with Chrome available:

```sh
ARCHIFY_CHROME="/path/to/chrome" npm run test:browser -- test/explainer-browser.test.mjs
```

Source checks and CI from candidate `bd5b9f32` remain applicable because this evidence-only addition does not change runtime, test, generated-artifact, or build inputs. Required CI at the publication head remains separate.

[Signal-flow and blueprint pairs](presets/README.md) complete the additional hosted-preset evidence requested by the maintainer. The expanded browser test covers all four preset choices; its new validation is recorded with those pairs.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 35 additions & 0 deletions docs/evidence/hosted-viewer-badges/evidence.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
{
"capturedAt": "2026-11-06T12:00:11.609Z",
"route": "Fixed-input hosted Viewer presentation comparison",
"base": "63c9263e84bd3993cab8e09b3d69888857858635",
"candidateSource": "bd5b9f321056c79d7adc27540592bc72afd3d81c",
"conditions": {
"viewport": [1440, 900],
"theme": "light",
"preset": "editorial",
"openStep": "Read cache",
"readyWaitMs": 800,
"node": "22.23.3",
"chrome": "Google Chrome on macOS",
"sameInput": true
},
"files": {
"explainer.json": "10b97b676dc26670acf6c977987e7364d4d0034cbfa09e643fe2b4c28a7bed09",
"after.1440x900.light.png": "cc6d81deb76c7d68947314e88514c7a1dfd9b3f1a756ba2746b9be4543148889",
"before.1440x900.light.png": "e712500329e11be1cca3da8a1cf186465e60ebeb5d7eaeac723e85b239040a57"
},
"browser": {
"baseBadgeDisplay": ["block", "block"],
"candidateBadgeDisplay": ["none", "none"],
"consoleErrors": [],
"nativeProfilesRemoved": true
},
"pixelComparison": {
"size": [1440, 900],
"changedPixels": 3271,
"bounds": [340, 93, 1300, 165],
"inputEqual": true
},
"humanReview": "Pending accountable contributor confirmation",
"scopeAgreement": "Pending maintainer decision in issue #1195"
}
Loading
Loading