Repository navigation
Roll out the Repository Intelligence profile across eligible repositories #13
Description
Outcome
Adopt the Repository Intelligence contract, ADR/roadmap linkage, validation, generated snapshots, and published pages across the Ego Hygiene repository fleet through reviewable convergence pull requests.
This extends the ADR baseline rollout in #5; it does not replace or duplicate it.
Scope
- Define eligibility profiles for code, documentation, site, policy, archive, and incubating repositories.
- Inventory each repository's roadmap, ADRs, GitHub Pages topology, workflows, and existing intelligence surface.
- Adopt the Aether decision-impact hook and inherited Hygiene contract versions.
- Add stable roadmap-step IDs and reconcile existing ADR indexes without rewriting history.
- Enable Egolint rules incrementally with explicit migration states.
- Configure Relay collection/build/publication and preserve existing Pages routes.
- Publish Repository Intelligence snapshots compatible with Observatory.
- Open bounded, reviewable PRs; never mutate every repository in one opaque batch.
- Track adopted, partial, blocked, exempt, not-applicable, and drifted states.
- Prove rollback and version-upgrade behavior.
Rollout waves
- Contracts and fixtures in Relay.
- Relay as the reference implementation.
- Two pilots: one small repository and one large/active repository.
- Repositories with existing GitHub Pages.
- Remaining eligible repositories.
- Fleet reconciliation, drift monitoring, and documentation.
Acceptance criteria
- Eligibility and migration profiles are explicit.
- Every eligible repository has a recorded adoption state and owning PR/issue.
- Existing ADRs and roadmaps are preserved and linked through stable identifiers.
- Existing Pages content is not clobbered.
- Partial adoption is visible rather than falsely green.
- Fleet snapshots appear in Observatory and deep-link to repository pages.
- Upgrade, rollback, exemption, and drift-remediation paths are documented.
- Final reconciliation identifies remaining blockers and intentional exclusions.
Dependencies / related
- [Capability 1] Roll out and reconcile the ADR baseline and Decisions views across the fleet #5
- Define the global Architecture Decision Record standard and inheritance contract hygiene#15
- Define the Repository Intelligence event and provenance contract hygiene#19
- Add a decision-impact and ADR hook to canonical AGENTS guidance aether#49
- Validate ADR, roadmap, and Repository Intelligence linkage egolint#24
- Build the normalized Repository Intelligence graph and query snapshots observatory#7
- Create reusable Repository Intelligence visualization components holon#22
- Build the Repository Intelligence experience relay#27
- Publish deterministic Repository Intelligence through reusable GitHub Actions relay#33
Live public-fleet audit — 2026-09-26
Selected capability campaign: egohygiene/pace#31. Finish populated repository roadmaps through one reviewed repository change at a time, then proceed to the next capability.
Scope and meaning of status
Inspected all 28 accessible public repositories' default-branch trees, tracked root workflow definitions, ROADMAP.md sources, standard ADR paths, relevant issue states and recent delivery records. Each repository link below pins the inspected source revision. This table contains public inventory only.
Live HTTP/content/provenance checks were performed for the three detected public Intelligence consumers; additional checked URLs are recorded below. No workflow was dispatched, no implementation was changed and no prior acceptance gate was silently waived. This is a point-in-time audit, not a conformance certification or complete visual/accessibility test.
Track four independent stages: source exists → normalized data connected → renderer delivered → declared publication verified. Maintenance/refresh is an additional completion requirement. HTTP 200 does not prove populated data; a closed renderer issue does not prove fleet adoption.
Main findings
- All 28 public repositories have structured roadmap comments and stable step IDs. Source conformance and current intent still need reconciliation.
- Only Akashic, Empathy and OptiFlow have directly detected shared Intelligence generation composed into a public site. All 12 checked HTML routes on each site return HTTP 200.
- None of those consumer workflows supplies observatory-snapshot. Their Roadmap, Decisions, Now and Journey views visibly say Observatory evidence is unavailable. The current Relay action explicitly treats this input as optional; Build the normalized Repository Intelligence graph and query snapshots observatory#7 deliberately provides normalization rather than live source collection.
- Antidote invokes the older v1.1 reusable artifact workflow; that is not a published populated site.
- All 28 public ADR-backfill issues remain open. Six repositories have numbered files under docs/decisions; root decision logs in other repositories are not equivalent to completed migration. No consumer policy-reference.json was found at the standard docs/decisions path. Hygiene is the canonical policy owner and must not be judged as an inheriting consumer.
- Define the global Architecture Decision Record standard and inheritance contract hygiene#15 is already human-ratified; Add ADR scaffolding and inherited repository decision policy holon#6, Add a decision-impact and ADR hook to canonical AGENTS guidance aether#49 and Validate ADR, roadmap, and Repository Intelligence linkage egolint#24 are closed. Remaining shared ADR gates include Validate architecture and repository structure in CI relay#5 / Deliver #5 through an ordered architecture-validation execution plan relay#99 and [Capability 1] Roll out and reconcile the ADR baseline and Decisions views across the fleet #5, plus publication/adoption acceptance. Do not ask for repeated policy ratification or claim that all ADR work can start immediately.
- The canonical Hygiene catalog still has an August observation boundary and the legacy website identity; Antidote/Civics reconciliation and freshness are tracked by Define recurring organization health checkpoints and keep the repository catalog live hygiene#36.
- Existing local-versus-central publication intent matters: 6 public sources declare composed, 21 central and 1 canonical. A repository does not automatically need its own Pages deployment.
- Registry ownership proposals in feat(org): establish the canonical repository registry and relationship source of truth .github#42 and spec(repository-intelligence): define repository manifest, health, snapshot, and organization-state contracts aether#90 need reconciliation against accepted Hygiene ownership; new proposed contracts must not duplicate or silently replace current source contracts.
Repository-by-repository baseline
Roadmap column = number of detected structured step blocks and declared publication mode, not validated completion. ADR file counts cover the conventional docs/decisions/ADR-*.md location; root logs and alternative/legacy layouts must be preserved during migration. Every ADR issue below remains its existing owner.
| Repository / inspected revision | Roadmap source | Shared Intelligence delivery | ADR source / migration owner |
|---|---|---|---|
| .github | 5; central | No direct shared consumer wiring found | Root log only; #26 open |
| aether | 7; central | No direct shared consumer wiring found | Root log only; #85 open |
| akashic | 5; composed | Live v1.6; all normalized views lack snapshot; no compatible dashboard producers | Root log only; #117 open |
| aniflow | 5; central | No direct shared consumer wiring found | No standard ADR files/log; #14 open |
| antidote | 11; central | v1.1 shared artifact workflow only; public Intelligence URL 404 | 8 numbered files + root log; #92 open |
| athena | 5; central | No direct shared consumer wiring found | Root log only; #4 open |
| beacon | 9; central | No direct shared consumer wiring found | Root log only; #21 open |
| civics | 5; composed | No direct shared consumer wiring found | No standard ADR files/log; #6 open |
| egohygiene.io | 5; canonical | No direct shared consumer wiring found | Root log only; #26 open |
| egolint | 10; central | No direct shared consumer wiring found | Root log only; #60 open |
| empathy | 5; composed | Live v1.6; no snapshot; 2 dashboard report inputs rejected for revision mismatch | 1 numbered files + root log; #83 open |
| filament | 5; central | No direct shared consumer wiring found | Root log only; #4 open |
| flow | 5; central | No direct shared consumer wiring found | No standard ADR files/log; #9 open |
| holon | 9; central | No direct shared consumer wiring found | Root log only; #56 open |
| hygiene | 6; central | No direct shared consumer wiring found | 13 numbered files + root log; #47 open |
| identity | 8; central | No direct shared consumer wiring found | 15 numbered files + root log; #69 open |
| mantle | 5; central | No direct shared consumer wiring found | Root log only; #31 open |
| mindcap | 5; central | No direct shared consumer wiring found | Root log only; #34 open |
| mindgarden | 5; central | No direct shared consumer wiring found | Root log only; #41 open |
| observatory | 5; central | No direct shared consumer wiring found | Root log only; #19 open |
| optiflow | 6; composed | Live v1.5; no snapshot; supporting routes are older placeholders; served revision behind main | 1 numbered files + root log; #60 open |
| pace | 6; central | No direct shared consumer wiring found | Root log only; #27 open |
| realm | 5; central | No direct shared consumer wiring found | Root log only; #42 open |
| reflector | 6; composed | No direct shared consumer wiring found | Root log only; #256 open |
| relay | 15; central | Shared producer + successful CI artifact; no normalized snapshot in dogfood; public URL 404 | Root log only; #73 open |
| renderflow | 5; composed | No direct shared consumer wiring found | Root log only; #405 open |
| sanctuary | 5; central | No direct shared consumer wiring found | 1 numbered files; #12 open |
| store | 5; central | No direct shared consumer wiring found | Root log only; #25 open |
Live site evidence
| Consumer | Observed publication | Served source | Generator / observed gap |
|---|---|---|---|
| Akashic | 12 HTML routes HTTP 200; provenance matches inspected main | 9af6e87b2c708dc0cb7a57a9ccf315d51e294a1b | Relay 9a6315978766c336566b9fa7139b800fa8789ba5, v1.6.0; no Observatory snapshot; 3 dashboard producers unavailable |
| Empathy | 12 HTML routes HTTP 200; provenance matches inspected main | d160044e08f3377afdf14f4856bc470ddd53b769 | Same Relay v1.6.0; no snapshot; MegaLinter/OSV report source mismatch; Scorecard unavailable |
| OptiFlow | 12 HTML routes HTTP 200; represented revision differs from inspected main | cc9b4aff492e340220dabcba1fc5242a74e035c6 | Relay 1eada5142f7fc7da7862f335589e3b8f5884ffaf, v1.5.0; no snapshot; supporting-view placeholders; build-manifest.json HTTP 404 |
Read the same host's /intelligence/provenance.json and /intelligence/summary.json for the recorded public source and producer states. OptiFlow main was ddc4b010caf5ad51c3d3f4b04e6b967a87ff8eea at source inspection; the differing deployment is not assumed to be a workflow or billing failure.
Checked /intelligence/ responses: Antidote HTTP 404; organization portal HTTP 404; Relay HTTP 404. Other repositories' public deployment topology was not exhaustively probed; "no direct shared consumer wiring" is a source finding, not an assertion that no website exists.
egohygiene/empathy#98 now owns the specific report-revision defect. It is independent of missing Observatory semantic input.
Capability status and remaining owners
Canonical repository routes are the /intelligence/... family; older short routes need registry-governed aliases.
| Capability | Shared implementation status | Missing end-to-end work / owner |
|---|---|---|
| Shell + raw repository dashboard | Delivered; raw tree/activity available in the 3 consumers | Publication acceptance egohygiene/relay#33 / egohygiene/relay#106; final integration/release #101; fleet #13 |
| Roadmap | Renderer egohygiene/relay#31 delivered | Real source adapter egohygiene/relay#112, integration #113, egohygiene/akashic#197, fleet #31 |
| Decisions / ADRs | Policy ratified, scaffolding + renderer delivered | egohygiene/relay#5 / egohygiene/relay#99 validation, #5 adoption, existing repository backfills; real ADR projection/collection under egohygiene/relay#27 before route acceptance |
| Now | Renderer egohygiene/relay#28 delivered | Same real snapshot foundation plus governed ready-work selection; egohygiene/relay#27 and #25 |
| Journey | Renderer egohygiene/relay#32 delivered | Read-only Git/event collection and proven revision/history boundaries under egohygiene/relay#27 |
| Dependencies | Renderer egohygiene/relay#77 delivered | Declared dependency source collection + accurate catalog under egohygiene/relay#27 / egohygiene/hygiene#36; organizational view egohygiene/.github#38 |
| Work | Renderer egohygiene/relay#79 delivered | Bounded read-only issue/PR observations and freshness under egohygiene/relay#27 |
| Releases | Renderer egohygiene/relay#81 delivered | Release/deployment evidence collector under egohygiene/relay#27; broader installability egohygiene/observatory#13 / egohygiene/.github#39 |
| Health | Core renderer egohygiene/relay#88 delivered | Correct producer evidence + normalized check input; egohygiene/empathy#98; broader conformance egohygiene/observatory#5 |
| Search | Renderer egohygiene/relay#83 delivered | Real entity snapshots first; matched-field attribution egohygiene/observatory#24 → egohygiene/relay#102 |
| Compare | Renderer egohygiene/relay#86 delivered | Retained compatible before/after snapshots and comparison artifact; explicit retention/refresh integration under egohygiene/relay#27 |
| Hygiene | Not completed | egohygiene/observatory#5 → egohygiene/relay#75 → fleet adoption |
| Audits | Not completed | egohygiene/aether#86 / egohygiene/reflector#258 / egohygiene/observatory#20 → egohygiene/relay#74; #28 rollout |
| Sanity / architecture coherence | Not completed | egohygiene/hygiene#59 → egohygiene/aether#87 → egohygiene/observatory#21 → egohygiene/relay#76 |
| Diagnostics | Not completed | egohygiene/observatory#16 → egohygiene/relay#57; optional applicability #23 |
| System Status | Not completed | egohygiene/hygiene#62 → egohygiene/observatory#23 → egohygiene/relay#41; #15 rollout |
| Architecture overview / booklet | Not completed | egohygiene/relay#42; keep v1 versus later disposition explicit |
| Organization portal and roadmap | Portal currently 404; shared implementation/acceptance open | egohygiene.io #27; central repository-roadmap host #30; egohygiene/.github#27/#29/#41; egohygiene/hygiene#60 + egohygiene/observatory#22 for organization initiatives |
| Identity | Brand outputs exist separately; not full Intelligence adoption | Preserve Identity source authority; organization module egohygiene/.github#37 |
Closed renderer issues stay closed. Missing collection/configuration is new integration/adoption work, not evidence that the renderer must be rebuilt. Do not declare a domain complete merely because its normalized model supports fixtures.
Updated delivery facts
- Organization PR #43 and Relay PR #110 are merged, correcting the older review-pending checkpoint.
- Relay's checkout-name fix is merged in PR #111 at 13f22cb67ae7f2b922e0c75de966610802201bdb.
- Merged-main run 36250031097 is successful; inspected jobs include unit/integration tests, reusable artifact generation, output checks and the separate deployment-provenance fixture. Retained site and report artifact metadata includes non-expired SHA-256 digests.
- This read verifies provider job/artifact metadata; it does not independently download/recompute those artifacts or establish a new consumer deployment.
- Make Repository Intelligence output independent of checkout directory names relay#109 remains open for its evidence/consumer-guidance reconciliation; #106/feat(labels): preview Aether label adoption gaps #33 remain open for publication acceptance. The old statement that current main still contains the checkout-name defect is no longer current.
Capability-by-capability execution order
- Finish the roadmap data path and its first real canary through [Capability 2] Complete populated repository roadmaps across the eligible fleet #31; complete all applicable composed/central/disabled profile requirements before moving to a new capability.
- Complete the existing shared ADR validation/adoption chain, then the per-repository ADR/Decisions issues.
- Connect Git/GitHub evidence for Journey, Work and the associated Now view, one domain at a time.
- Connect release evidence, then check/health evidence, then declared dependency evidence.
- Complete Search attribution and two-snapshot Compare after their real source domains exist.
- Complete Hygiene, Audits, Sanity, Diagnostics and System Status one capability at a time through their existing owners.
- Finish organization aggregation, cross-route accessibility/release acceptance and remaining explicit v1 dispositions.
This is an execution overlay on existing owners, not a second architecture or a claim that the broad program is complete. Opening the collector does not close #13. Local-first implementation can proceed without polling hosted CI; publication claims still need actual publication evidence.
September 28 — optional Progress route adoption
Track the new achievement-style Progress feature at egohygiene/relay#130. Its first consumer handoff is egohygiene/relay#132, after Hygiene route/rule registration, Observatory progress/coverage support, and the Relay page.
Select one existing public-safe canary when those producer inputs are ready. Capture an actual unlock, repeat refresh, new/reopened work after a historical award, and partial/denied inventory behavior; preserve consumer-owned route composition/deployment and compatible immutable pins. Coordinate the repository's canonical /intelligence/progress/ route and configured /progress/ alias through the shared route registry.
Do not mark this page adopted from a fixture screenshot or a merged producer PR. Record source readiness, consumer adoption, and live route evidence separately. This optional route does not reset completed Intelligence adoption or change the current ADR-first execution order.
Activity