Documentation
Architecture
Dependency Graph

Dependency Graph

The dependency relationships between all components in the 88.pi ecosystem.

Core Dependencies

                    ┌─────────────────┐
                    │   88.pi root    │
                    └────────┬────────┘

                    ┌────────▼────────┐
                    │  pi-mono-main   │
                    └────────┬────────┘

                    ┌────────▼────────┐
                    │ pi-coding-agent │
                    └───┬─────┬───┬───┘
                        │     │   │
           ┌────────────▼┐  ┌▼───▼──────────┐
           │   nity/     │  │ nity-memory/  │
           │ (17 files)  │  │ (5 modules)   │
           └──┬───┬───┬──┘  └───┬───────┬───┘
              │   │   │         │       │
    ┌─────────▼┐ ┌▼───▼──┐  ┌──▼───┐ ┌─▼──────────┐
    │  brand/  │ │ tui/  │  │brain │ │ episodes   │
    └──┬───┬──┘ └───────┘  └──────┘ └────────────┘
       │   │
  ┌────▼┐ ┌▼──────────┐
  │voice│ │state-to-  │
  │     │ │ brand     │
  └─────┘ └───────────┘

Dependency Matrix

ComponentDepends OnDepended By
coordinator.tstask-analyzer, strategy-planner, execution-router, quality-gates, self-reflection, progress-trackerbridge/session.ts
task-analyzer.tsskill-registrycoordinator
strategy-planner.tsralph-universal, skill-registrycoordinator
execution-router.tsloop-engine, standalone-runnercoordinator
loop-engine.tscircuit-breaker, response-analyzerexecution-router
circuit-breaker.ts(none)loop-engine
response-analyzer.ts(none)loop-engine
quality-gates.ts(none)coordinator
self-reflection.tsepisode-recordercoordinator
episode-recorder.tssimplemem-bridgeself-reflection
brain-manager.tssimplemem-bridgecoordinator
ralph-universal.tssimplemem-bridgestrategy-planner
voice.tsstate-to-brandtui components
state-to-brand.ts(none)voice.ts, tui components
presence-indicator.tsvoice, state-to-brand(consumed by TUI)
loop-status.tsloop-engine status(consumed by TUI)
memory-banner.tsbrain-manager, episode-recorder(consumed by TUI)
progress-tracker.ts(none)coordinator, bridge
skill-registry.ts(none)task-analyzer, strategy-planner
quantumreef-bridge.tsexecution-routercoordinator

Critical Path

coordinator
  → task-analyzer (needs skill-registry)
  → strategy-planner (needs ralph-universal, skill-registry)
  → execution-router
      → loop-engine
          → circuit-breaker
          → response-analyzer
      → standalone-runner (simple tasks, no loop)
  → quality-gates
  → self-reflection
      → episode-recorder (needs simplemem-bridge)
  → progress-tracker → bridge (streams to external client)
⚠️

The critical path has no circular dependencies. If you find one, it's a design error. coordinator.ts is the only component that connects to all others — it's the hub. Everything else is a spoke or leaf.

Isolation Boundaries

BoundaryComponentsCan import fromCannot import from
Nity Corecoordinator, task-analyzer, strategy-planner, execution-routernity-memory, nity-loopbridge (inward)
Nity Memorybrain-manager, episode-recorder, ralph-universal, simplemem-bridge, memory-recall(none)nity-core, nity-loop
Nity Looploop-engine, circuit-breaker, response-analyzer(none)nity-core, nity-memory
Nity Brandvoice, state-to-brand, tui componentsnity-core (status only)nity-memory, nity-loop
Bridgesession, types, streamnity-corenity-memory, nity-loop, nity-brand