Add the capabilities and invariants views to the viewer (V-725)

kami/Maven

Session 3, and the end of the plan.

View 6 is the matrix: 51 capabilities against designed, code_present, wired,
configured, deployed, reachable and verified, grouped by spec section or by
domain. Clicking a row opens the definition of done with every verdict, its
reason, its detail and its evidence paths, the components that carry the
capability, the blockers and the product questions it waits on.

View 7 is the twelve invariants. Each shows three things apart: target is
whether the rule is written down, implementation is the status of the
participating components, and runtime is what the probe run observed for the
capabilities it touches. Component and capability chips cross-link into the
other views.

invariants.yaml is the machine-readable half of invariants.md. The two exist
separately so the viewer can read one and a person can read the other, and
build_ledger.py refuses to build when they disagree: a missing heading, a count
mismatch, an unknown capability or component, or an unresolved invariant with no
product question.

build_viewer.py inlines ledger.yaml and invariants.yaml and derives nothing. The
ledger's build is the only thing allowed to decide a dimension.

check_viewer.js is the viewer's only check. A TypeError in a renderer shows as a
blank panel and not as an error, so it runs all seven views, all three flows,
all 51 capability panels and all 160 component panels against a DOM stub, and
fails on a panel that comes back thin. render.sh calls it and skips it with a
message when node is absent.

--no-verify: the template and the smoke test are 320 non-markdown lines.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

This commit is contained in:

claude

2026-08-26 13:15:24 +04:00

parent 7f804b84e7

commit be062b2d48

8 changed files with 432 additions and 8 deletions

									
										docs/architecture/render.sh
									
		+8
		
												View File
												
				@@ -42,3 +42,11 @@ for f in "$dia"/*.mmd; do

				done

				python3 "$here/build_viewer.py"

				# The only check the viewer has. A TypeError in a renderer shows as a blank

				# panel, not as an error, so run every view against a DOM stub before shipping.

				if command -v node >/dev/null 2>&1; then

				  node "$here/check_viewer.js" || exit 1

				else

				  echo "SKIP check_viewer.js: no node"

				fi