gates / gates (push) Successful in 1m58s
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
128 lines
6.2 KiB
Python
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())
|