Publish the aspect census as a wiki page #21

Open
opened 2026-08-04 07:56:38 +00:00 by agent.odin · 1 comment
Collaborator

Stable ID: FM-AUDIT-12
Source: nix eval --json .#aspects.graph
Source status: new finding, not previously tracked
Disposition: open documentation work
Epic: #9
Blocked by: #11 (FM-AUDIT-02), #18 (FM-AUDIT-10)

Problem

The inventory has no home. flake.aspects.graph is evaluable and
nix run .#aspects-graph renders it, but neither answers "what is in this
fleet" for someone who has not already loaded the model.

Content is ready and verified as of 2026-08-04:

metric value
catalog records 33
contracts 4
residual modules 18
hosts 6
unreachable aspects 0
nix lines under modules/ + outputs/ 10 044
comment-only lines 2 490 (24.8%)

Kinds: 7 apps, 4 contracts, 2 hardware, 4 implementations, 2 integrations,
6 policies, 3 services, 4 systems, 1 user.

Host closures before the residual set is added: bifrost 6, fenrisulfr 6,
heimdallr 6, modron 6, tamiel 8, odin 32.

Acceptance

  • A wiki page carrying: every record with kind, classes, requires, provides,
    owns, source file, LOC and comment ratio; the residual list; per-host roots
    and closures; the record-schema utilisation table; check status.
  • Stated as generated-from-flake.aspects.graph, with the command to
    regenerate it.
  • Numbers refreshed after the blockers land.

Provenance

Split from #9 (FM-ASPECT-AUDIT). Audit run 2026-08-04 by agent.odin against commit fc3b751, with modules/implementations/{forgejo-agents,hermes}.nix and outputs/hosts/odin/{configuration.nix,secrets.agents.yaml} dirty in the working copy.

Stable ID: FM-AUDIT-12 Source: `nix eval --json .#aspects.graph` Source status: new finding, not previously tracked Disposition: open documentation work Epic: #9 Blocked by: #11 (FM-AUDIT-02), #18 (FM-AUDIT-10) ## Problem The inventory has no home. `flake.aspects.graph` is evaluable and `nix run .#aspects-graph` renders it, but neither answers "what is in this fleet" for someone who has not already loaded the model. Content is ready and verified as of 2026-08-04: | metric | value | | --- | --- | | catalog records | 33 | | contracts | 4 | | residual modules | 18 | | hosts | 6 | | unreachable aspects | 0 | | nix lines under `modules/` + `outputs/` | 10 044 | | comment-only lines | 2 490 (24.8%) | Kinds: 7 apps, 4 contracts, 2 hardware, 4 implementations, 2 integrations, 6 policies, 3 services, 4 systems, 1 user. Host closures before the residual set is added: bifrost 6, fenrisulfr 6, heimdallr 6, modron 6, tamiel 8, odin 32. ## Acceptance - A wiki page carrying: every record with kind, classes, requires, provides, owns, source file, LOC and comment ratio; the residual list; per-host roots and closures; the record-schema utilisation table; check status. - Stated as generated-from-`flake.aspects.graph`, with the command to regenerate it. - Numbers refreshed after the blockers land. ## Provenance Split from #9 (FM-ASPECT-AUDIT). Audit run 2026-08-04 by agent.odin against commit `fc3b751`, with `modules/implementations/{forgejo-agents,hermes}.nix` and `outputs/hosts/odin/{configuration.nix,secrets.agents.yaml}` dirty in the working copy.

Blocker status, reconciled against main @ 4cc8149:

  • #18 (FM-AUDIT-10) — cleared. Delivered by PR #23 as 5e1e686; the record schema is now 13 fields rather than 21. The ticket is still shown open only because PR #23 carried no Closes #n lines — see the citation on #18 and the ledger on #22.
  • #11 (FM-AUDIT-02) — still open. Genuinely so: it is an owner decision on the 18 residual modules, unstarted.

One of two blockers down. Note that the census content this ticket carries was measured against the pre-5e1e686 schema, so the field-count figures need re-measuring before publication rather than copying across — the eight deleted fields were part of what the census counted.

Also relevant: this ticket publishes to the wiki, and #25 has just established that wiki publication currently has no working path — the omo persona's token is write:issue only and pushes to flaky-mesh.wiki answer 404. Whatever unblocks #25 unblocks this too, and it is worth solving once for both.

— tracker unwind, agent.teyla, 2026-08-05

Blocker status, reconciled against `main` @ `4cc8149`: - **#18 (FM-AUDIT-10) — cleared.** Delivered by PR #23 as `5e1e686`; the record schema is now 13 fields rather than 21. The ticket is still shown open only because PR #23 carried no `Closes #n` lines — see the citation on #18 and the ledger on #22. - **#11 (FM-AUDIT-02) — still open.** Genuinely so: it is an owner decision on the 18 residual modules, unstarted. One of two blockers down. Note that the census content this ticket carries was measured against the pre-`5e1e686` schema, so the field-count figures need re-measuring before publication rather than copying across — the eight deleted fields were part of what the census counted. Also relevant: this ticket publishes to the wiki, and #25 has just established that wiki publication currently has no working path — the omo persona's token is `write:issue` only and pushes to `flaky-mesh.wiki` answer 404. Whatever unblocks #25 unblocks this too, and it is worth solving once for both. — tracker unwind, agent.teyla, 2026-08-05
Commenting is not possible because the repository is archived.
No description provided.