Files
felhom.eu/documentation/audits/space-list-2026-11-10/tools/make-matrix.py
T
admin 47e372a5f4
gates / gates (push) Successful in 1m58s
Space list (pilot of the gap review): 45 places, eight questions each
Read-only measurement on demo-hp, demo-felhom and Tester 1, two readings.
Audit folder documentation/audits/space-list-2026-11-10/ (README, TABLE,
MATRIX, evidence, tools). 360 answers: A 294, D 0, K 19, N 47.

Register 225 -> 230: R-1368 (host places that only grow: kernels, agent
binaries), R-1369 (no written way out of a full disk), R-1370 (no space
budget for the host disk), R-1371 (no space alarm; host-disk mail goes to
the household), R-1372 (small guest places). A dated line on nine existing
rows. Section headings set to the real counts; R-1268 and R-1312 moved to
their category's section.

STATUS: new Updated paragraph, decisions D67-D70. N100 diary line.
Two stale facts corrected in 05-hub-architecture.md and 11-os-updates.md.
Nothing was changed on any machine.

Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
2026-11-10 10:50:44 +01:00

128 lines
6.2 KiB
Python

#!/usr/bin/env python3
"""Build MATRIX.md from TABLE.md, and check the table's shape.
Read-only on everything but MATRIX.md in this folder. It runs on DooPlex against the git clone only.
Usage: make-matrix.py write ../MATRIX.md, print the totals
make-matrix.py --check write nothing; rc 1 when the table breaks a rule
Rules checked (a broken rule is printed and makes rc 1):
- a place heading is `### <ID> — <name> · CUSTOMER · NAMED|MENTIONED|UNNAMED`
- each place has exactly eight answer rows, numbered 1..8, each with one mark A, D, K or N
- an A row carries a backticked pointer; a K row an `R-<n>`; an N row one class C1..C5 and a search S<n>
"""
import os
import re
import sys
HERE = os.path.dirname(os.path.abspath(__file__))
AUDIT = os.path.dirname(HERE)
HEAD = re.compile(r"^### ([HGD]\d+) — (.+?) · CUSTOMER · (NAMED|MENTIONED|UNNAMED)\s*$")
ROW = re.compile(r"^\| ([1-8]) \| (.*) \| ([ADKN]) \| (.*) \|\s*$")
QUESTIONS = ["what is in it", "what makes it grow", "the limit", "who cleans up", "what happens when full",
"who gets an alarm", "self-repair or runbook", "how do we know"]
CLASS_ROW = {"C1": "R-1368", "C2": "R-1369", "C3": "R-1370", "C4": "R-1371", "C5": "R-1372"}
def parse(path):
places, errors, cur = [], [], None
with open(path, encoding="utf-8") as fh:
for ln, line in enumerate(fh, 1):
if line.startswith("## TEST-ONLY") or line.startswith("## DOC-ONLY"):
cur = None
continue
if line.startswith("### "):
m = HEAD.match(line)
if not m:
errors.append(f"line {ln}: heading has the wrong shape: {line.strip()}")
cur = None
continue
cur = {"id": m.group(1), "name": m.group(2), "named": m.group(3), "marks": {}, "n": {}, "k": {}}
places.append(cur)
continue
m = ROW.match(line)
if not m or cur is None:
continue
q, mark, ptr = int(m.group(1)), m.group(3), m.group(4)
if q in cur["marks"]:
errors.append(f"{cur['id']}: question {q} is answered twice")
cur["marks"][q] = mark
if mark == "A" and "`" not in ptr:
errors.append(f"{cur['id']}-{q}: A with no pointer")
if mark == "K":
rows = re.findall(r"R-\d+", ptr)
if not rows:
errors.append(f"{cur['id']}-{q}: K with no row")
cur["k"][q] = rows
if mark == "N":
cls = re.findall(r"\bC[1-5]\b", ptr)
if len(cls) != 1:
errors.append(f"{cur['id']}-{q}: N needs exactly one class, found {cls}")
elif not re.search(r"\bS\d+\b", ptr) and "NOBODY KNOWS" not in m.group(2):
errors.append(f"{cur['id']}-{q}: N with no search id")
cur["n"][q] = cls[0] if cls else "?"
for p in places:
if sorted(p["marks"]) != list(range(1, 9)):
errors.append(f"{p['id']}: has answers {sorted(p['marks'])}, wants 1..8")
return places, errors
def build(places):
out = ["# The Space list — the matrix", "",
"Made by `tools/make-matrix.py` from `TABLE.md`. Do not edit it by hand.", "",
"`A` answered · `D` decided, not built · `K` known gap (has a row) · `N` nobody asked. Columns are the eight",
"questions: 1 content · 2 growth · 3 limit · 4 cleaner · 5 when full · 6 alarm · 7 repair or runbook · 8 how we know.",
"", "| Place | Named | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | N |", "|---|---|---|---|---|---|---|---|---|---|---|"]
tot = {m: 0 for m in "ADKN"}
perq = {q: {m: 0 for m in "ADKN"} for q in range(1, 9)}
named = {"NAMED": 0, "MENTIONED": 0, "UNNAMED": 0}
members, krows = {c: [] for c in CLASS_ROW}, {}
for p in places:
named[p["named"]] += 1
cells = []
for q in range(1, 9):
mk = p["marks"].get(q, "?")
cells.append(f"**{mk}**" if mk == "N" else mk)
if mk in tot:
tot[mk] += 1
perq[q][mk] += 1
for q, c in p["n"].items():
members.setdefault(c, []).append(f"{p['id']}-{q}")
for q, rows in p["k"].items():
for r in rows:
krows.setdefault(r, []).append(f"{p['id']}-{q}")
out.append(f"| {p['id']} {p['name']} | {p['named'].lower()} | " + " | ".join(cells) + f" | {len(p['n'])} |")
n = len(places)
out += ["", "## Totals", "",
f"- Places: **{n}** customer places · named **{named['NAMED']}** · mentioned only **{named['MENTIONED']}** · "
f"named by no architecture document **{named['UNNAMED']}**.",
f"- Answers: **{n * 8}** · A **{tot['A']}** · D **{tot['D']}** · K **{tot['K']}** · N **{tot['N']}**.",
f"- Places with no N: **{sum(1 for p in places if not p['n'])}** of {n}.",
"", "| Question | A | D | K | N |", "|---|---|---|---|---|"]
for q in range(1, 9):
out.append(f"| {q} {QUESTIONS[q - 1]} | {perq[q]['A']} | {perq[q]['D']} | {perq[q]['K']} | {perq[q]['N']} |")
out += ["", "## The N answers, by class row", "", "| Class | Row | Count | Members (place-question) |", "|---|---|---|---|"]
for c in sorted(members):
out.append(f"| {c} | {CLASS_ROW.get(c, '?')} | {len(members[c])} | {', '.join(members[c])} |")
out += ["", "## The K answers, by existing row", "", "| Row | Count | Members |", "|---|---|---|"]
for r in sorted(krows, key=lambda x: int(x[2:])):
out.append(f"| {r} | {len(krows[r])} | {', '.join(krows[r])} |")
return "\n".join(out) + "\n", tot, named, members
def main() -> int:
places, errors = parse(os.path.join(AUDIT, "TABLE.md"))
for e in errors:
print("BROKEN " + e)
text, tot, named, members = build(places)
if "--check" not in sys.argv[1:]:
with open(os.path.join(AUDIT, "MATRIX.md"), "w", encoding="utf-8") as fh:
fh.write(text)
print(f"places {len(places)} named {named} marks {tot} "
+ " ".join(f"{c}={len(m)}" for c, m in sorted(members.items())) + f" broken {len(errors)}")
return 1 if errors else 0
if __name__ == "__main__":
sys.exit(main())