Measure which chapters, terms, ADRs and codes pay their way #342

Activity

1. ExtraToast

   added

   type: docsDocumentation-only change.Documentation-only change.

   area: deployhomelab-deploy, deploy-v2, manifests, and rollout flow.homelab-deploy, deploy-v2, manifests, and rollout flow.

   wayfinder:researchWayfinder ticket resolved by reading primary sources (AFK)Wayfinder ticket resolved by reading primary sources (AFK)

   on Oct 9, 2026
2. ExtraToast

   added a parent issue on Oct 9, 2026

   • Map: re-establish deploy-kit's goals, rewrite its spec, and order the work until the estate is handed over #341
3. ExtraToast

   marked this as blocking 2 issues on Oct 9, 2026

   • Decide what is cut, merged or deferred from the spec and the register #346
   • Decide the model-driven implementation's lifespan and sunset #347
4. ExtraToast

   self-assigned this

   on Oct 9, 2026
5. ExtraToast commented on Oct 9, 2026

   

   ExtraToast

   on Oct 9, 2026

   ContributorAuthor

   More actions

   Measured at origin/main 4c12851; the cited tables are in docs/research/what-pays-its-way.md on branch research/what-pays-its-way (no pull request yet). The gist:

   • Spec: 10,489 lines in 261 ##/### sections. 68 sections (35 of 162 at ##) have no inbound anchor link from anywhere. The ten Diagram sources sections hold 1,070 lines (10.2%), and the open-items sections hold 380. 107 of the ## sections (5,846 lines) are linked from no file in src/, test/ or emf/. Chapters 15 and 50 are the least reached (6 and 9 files linking in, none of them code).
   • Codes: 108 defined, 42 (39%) pending on six tickets (Tracer bullet: render the minimal case in TypeScript #97 12, Implement the Stable Address, the derived Move and Infrastructure Intent #324 11, Slice 7: every refusal through check/, the pending codes included #204 7, Register every model rule with its context, placement, OCL statement and fixture #44 6, Tracer bullet: resolve the minimal case in TypeScript #92 5, Build the estate delivery machinery in its own repositories #148 1). Of the 66 exercised, 65 are raised in src/ and 57 in emf/, and 52 have a refusal oracle.
   • ADRs: 98 records, 8,666 lines. The median record is linked from 12 files in the model register and from 2 in the architecture and EMF registers. Three (0059, 0072, 0077) are linked from nothing but their register. 59 are named by no code, test, script or workflow.
   • Terms: all 95 are used somewhere. 17 appear in no code (Stable Address, Infrastructure Intent, Fence, Move method and others), and 9 delivery and composition words appear in src/ only.
   • Parity: since emf/ landed, 38 of 106 non-bot merged pull requests (36%) changed both implementations, which is 54% of those that changed either one. emf/ took 20,317 changed lines, against 17,237 for src/, and is 17,678 lines in total.
   • CI, last 30 runs: the emf job has a median of 11.6 min and used 11.4% of runner-minutes, plus 2.0% for CodeQL java-kotlin. The six mutation shards used 79.8%, and the slowest shard (median 19.0 min) is the wall-clock floor.
   • Not measured: live-estate need (waits on Inventory what each live Application needs and what blocks its handover #343) and issue comments. A section's churn is its chapter's churn.
6. ExtraToast commented on Oct 9, 2026

   

   ExtraToast

   on Oct 9, 2026

   ContributorAuthor

   More actions

   Resolved: the measurement is in docs/research/what-pays-its-way.md on branch research/what-pays-its-way. The gist is in the comment above. Whether a live Application needs each item joins from the live-estate inventory (#343).
7. ExtraToast

   closed this as completedon Oct 9, 2026