Archify diagrams (Café Knowledge)
Documentation aids generated with artofdream/archify (fork of tt-a1i/archify). Documented aid — not Live. Same-origin host after Pages deploy: https://knowledge.cafe.artof.link/archify/.
Cite freeze-first / SRS MVP only (docs/srs.md, FR-1..18 / NFR-1..9). Do not invent FR-19 / NFR-10. Not Lily's Florist, Path B, 14 hats, 3DX Lab, or ctos QEMU content.
Artifacts
| File | Kind | Topic |
|---|---|---|
| `cafe-knowledge-workflow.architecture.json` + `.html` | architecture | Knowledge Pages ratchet: freeze → issue → PR → MRC COMMENT → New Bot → Pages → probe |
| `index.html` | index | Thin listing of diagrams |
Honesty
- Status wording: Documented aid (readable map). Not Live.
- Intended URLs after Pages deploy (ping-ready once parent probes post-merge):
https://knowledge.cafe.artof.link/archify/https://knowledge.cafe.artof.link/archify/cafe-knowledge-workflow.architecture.htmlhttps://knowledge.cafe.artof.link/archify/cafe-knowledge-workflow.architecture.json
- Do not claim Live / production status from this folder alone. A this-session HTTPS GET after merge closes the Pages probe.
Honesty guard (CI)
CI job archify-honesty runs scripts/check-archify-honesty.py. It fails if an Archify IR still has meta.views (ignored by Archify 3.x) or if an honesty label or phrase (list in scripts/archify-honesty.config.json) appears in a retired chapter note but not in the components or cards. It warns, without failing, when the committed HTML generator string is not archify 3.2.0. Self-test: python3 scripts/test_check_archify_honesty.py.
Open locally
xdg-open knowledge/archify/cafe-knowledge-workflow.architecture.html
# or: python3 -m http.server -d knowledge/archify 8765
Regenerate
Generated with Archify v3.2.0 (archify/package.json version 3.2.0). Render in a scratch directory, validate, then copy only the .json and .html back into this folder:
export ARCHIFY_UPDATE_CHECK_DISABLED=1
node /path/to/archify/archify/bin/archify.mjs validate architecture cafe-knowledge-workflow.architecture.json
node /path/to/archify/archify/bin/archify.mjs deliver architecture \
cafe-knowledge-workflow.architecture.json \
cafe-knowledge-workflow.architecture.html \
--quality showcase
node /path/to/archify/archify/bin/archify.mjs browser-check cafe-knowledge-workflow.architecture.html --summary --out-dir ./receipts
- Do not commit
*.delivery.jsonor*.browser-check.jsonreceipts: they hold local absolute paths andknowledge/build.pywould publish them under/archify/(the root.gitignoreignores them). - Archify 3.x has no guided views / "Play story" / press-
Pchapters:meta.viewsis retired and ignored. Former chapter notes live in the diagram's cards; use the viewer's Route and Lens controls for paths and roles. - Boundary rule (3.x): a boundary's
wrapslist must match the components its frame encloses. Keep non-members outside the frame (see the Restaurant region below the pipeline).
knowledge/build.py copies this directory to _site/archify/ so GitHub Pages serves /archify/.