<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- TOPOLOGY.md — Project architecture map and completion dashboard -->
<!-- Last updated: 2026-02-19 -->

# Developer Ecosystem — Project Topology

## System Architecture

```
                        ┌─────────────────────────────────────────┐
                        │              DEVELOPER UX               │
                        │        (IDE, Dashboard, CLI)            │
                        └───────────────────┬─────────────────────┘
                                            │
                                            ▼
                        ┌─────────────────────────────────────────┐
                        │           DEVELOPER ECOSYSTEM HUB       │
                        │                                         │
                        │  ┌───────────┐  ┌───────────────────┐  │
                        │  │ Git Tools │  │ Repo Management   │  │
                        │  │ (Forges,  │  │ (Automaton,       │  │
                        │  │  Sync)    │  │  Vacuum, Grim)    │  │
                        │  └─────┬─────┘  └────────┬──────────┘  │
                        │        │                 │              │
                        │  ┌─────▼─────┐  ┌────────▼──────────┐  │
                        │  │Scaffolding│  │ Developer UX      │  │
                        │  │(Scaffoldia│  │ (Evangeliser,     │  │
                        │  │  Standard)│  │  Recon-silly)     │  │
                        │  └─────┬─────┘  └───────────────────┘  │
                        └────────│────────────────────────────────┘
                                 │
                                 ▼
                        ┌─────────────────────────────────────────┐
                        │          SATELLITE REPOSITORIES         │
                        │  ┌───────────┐  ┌───────────┐  ┌───────┐│
                        │  │ git-hud   │  │  oikos    │  │ nickel││
                        │  └───────────┘  └───────────┘  └───────┘│
                        │  ┌───────────┐  ┌───────────┐  ┌───────┐│
                        │  │ gitloom   │  │ grim-repo │  │ pssh  ││
                        │  └───────────┘  └───────────┘  └───────┘│
                        └───────────────────┬─────────────────────┘
                                            │
                                            ▼
                        ┌─────────────────────────────────────────┐
                        │          UPSTREAM STANDARDS             │
                        │      (RSR, CCCP Language Policy)        │
                        └─────────────────────────────────────────┘

                        ┌─────────────────────────────────────────┐
                        │          REPO INFRASTRUCTURE            │
                        │  Justfile           .machine_readable/  │
                        │  Aggregate Libs     Techstack Filter    │
                        └─────────────────────────────────────────┘
```

## Completion Dashboard

```
COMPONENT                          STATUS              NOTES
─────────────────────────────────  ──────────────────  ─────────────────────────────────
CORE ECOSYSTEM
  Git Tools (Hub)                   ██████████ 100%    Forge management stable
  Repo Management                   ████████░░  80%    Automaton logic refining
  Scaffolding (scaffoldia)          ██████████ 100%    Modular templates active
  Developer UX                      ██████░░░░  60%    VS Code extension in progress

ECOSYSTEM SATELLITES
  idris2-ecosystem                  ██████████ 100%    Unbreakable libs verified
  zig-ecosystem                     ██████████ 100%    FFI bridge standards stable
  rescript-ecosystem                ██████████ 100%    SafeDOM integration verified
  deno-ecosystem                    ████████░░  80%    Runtime security refined

REPO INFRASTRUCTURE
  Justfile                          ██████████ 100%    Full build automation
  .machine_readable/                ██████████ 100%    STATE.a2ml tracking
  Techstack Filterlist              ██████████ 100%    CCCP compliance active

─────────────────────────────────────────────────────────────────────────────
OVERALL:                            █████████░  ~90%   Central developer hub operational
```

## Key Dependencies

```
CCCP Policy ───► RSR Standard ───► Developer Hub ───► Satellites
     │               │                 │                 │
     ▼               ▼                 ▼                 ▼
Language Check ──► Compliance ─────► Scaffolding ───► Git Forge
```

## Update Protocol

This file is maintained by both humans and AI agents. When updating:

1. **After completing a component**: Change its bar and percentage
2. **After adding a component**: Add a new row in the appropriate section
3. **After architectural changes**: Update the ASCII diagram
4. **Date**: Update the `Last updated` comment at the top of this file

Progress bars use: `█` (filled) and `░` (empty), 10 characters wide.
Percentages: 0%, 10%, 20%, ... 100% (in 10% increments).
