System Context Diagram — v1.5.0+ Update¶

This page is a v1.5.0+ append-only refresh of the canonical C4 Level-1 diagram at context-diagram.md. The canonical file remains authoritative for the overall ecosystem shape (upstream authorities, direct consumers, JV libraries, constellation verticals, end users); this update adds the deltas that v1.4.2 through v1.5.1 introduced:

POLARIS stable archive bridge (fcc.archive.polaris_bridge, v1.5.0)
LYRA stable graph-of-thought bridge (fcc.knowledge.lyra_bridge, v1.5.0; live backend pending)
22-entry Universal Services superset (docs/ecosystem/universal-services.md, v1.5.0)
Codename decoder (docs/ecosystem/codename-decoder.md, v1.5.1) — 21 entries
8 new ADRs (ADR-006..013, v1.5.1) — decision anchors for the new edges

Use this page as the "what changed" companion to the canonical context diagram when reviewing cross-ecosystem alignment or planning a new consumer integration.

Refreshed C4 Context (Level 1) — v1.5.0+¶

flowchart TB
    subgraph UsersG["End users"]
        U1([Agent developer])
        U2([Persona author])
        U3([Compliance officer])
        U4([Patent counsel])
        U5([Federation operator])
        U6([Collab session host])
    end

    subgraph UpstreamG["Upstream authorities"]
        NEXUS["NEXUS / Research Center<br/>v2.1.0 registry<br/>ADR-009 rationalizer"]
        PHOENIX["PHOENIX / AI-COE-Docs<br/>quality gates + patents"]
    end

    FCC{{"FCC Agent Team Framework<br/>164 personas · 13 ADRs<br/>v1.5.1 · Helm 0.4.1<br/>6 pillars · fcc.api.* stable"}}

    subgraph APIsurface["fcc.api.* — stable SemVer 1.x (v1.5.0+)"]
        API_ARCH["fcc.api.archive<br/>POLARIS surface"]
        API_KNOW["fcc.api.knowledge<br/>LYRA surface"]
        API_RAG["fcc.api.rag<br/>GraphRAG (Pillar B)"]
        API_COLLAB["fcc.api.collaboration<br/>CRDT multi-user (Pillar D)"]
        API_FED["fcc.api.federation<br/>bidirectional (Pillar E)"]
    end

    subgraph NewBridges["v1.5.0 bridges (mock-first)"]
        POLARIS["POLARIS<br/>ice_ext long-term archive"]
        LYRA["LYRA<br/>graph-of-thought<br/>(backend pending)"]
    end

    subgraph ConsumersG["Direct consumers"]
        PAOM["PAOM / SENTINEL"]
        AOME["AOME / CRUCIBLE"]
        CONSTEL["CONSTEL / PRISM"]
        Distiller["Distiller / FORNAX"]
        CTO["CTO bridge"]
    end

    subgraph JVG["L2 JV libraries"]
        Athenium["Athenium"]
        Mnemosyne["Mnemosyne"]
    end

    subgraph VizG["Visualization partner"]
        AURORA["AURORA / Sky Parlour<br/>UX lane subscriber"]
    end

    subgraph ConstG["10 constellation verticals"]
        C1["medical 8600/8601"]
        C2["financial 8610/8611"]
        C3["insurance 8620/8621"]
        C4x["energy 8630/8631"]
        C5["government 8640/8641"]
    end

    subgraph USvc["Universal Services superset (22 entries · 5 tiers)"]
        US1["Tier 1: RC-vendored config"]
        US2["Tier 2: telemetry/traffic"]
        US3["Tier 3: domain subsystems"]
        US4["Tier 4: cross-cut governance"]
        US5["Tier 5: FCC infra + siblings"]
    end

    subgraph ADRs["ADRs v1.5.1 (MADR 4.0)"]
        A006["ADR-006 dual-bus events"]
        A007["ADR-007 SAFe skeleton"]
        A008["ADR-008 POLARIS absorption"]
        A009["ADR-009 universal services"]
        A010["ADR-010 six pillars"]
        A011["ADR-011 GraphRAG+Zachman"]
        A012["ADR-012 CRDT"]
        A013["ADR-013 bidirectional federation"]
    end

    NEXUS -->|vendored YAML<br/>SHA-256 drift| FCC
    PHOENIX -->|58 quality gates| FCC

    FCC --- API_ARCH
    FCC --- API_KNOW
    FCC --- API_RAG
    FCC --- API_COLLAB
    FCC --- API_FED

    API_ARCH -->|get_polaris_bridge<br/>mock-first, ice_ext live| POLARIS
    API_KNOW -->|get_lyra_bridge<br/>mock now, live pending| LYRA

    FCC -->|MCP + A2A| PAOM
    FCC -->|A2A + events| AOME
    FCC -->|A2A + VocabularyProvider| CONSTEL
    FCC -->|VocabularyProvider| Distiller
    FCC -->|ObjectModel bridge| CTO

    FCC -.VocabularyProvider.-> Athenium
    FCC -.VocabularyProvider.-> Mnemosyne

    FCC -->|dual-bus · UX lane<br/>WebSocket :8765| AURORA

    FCC -.fcc-*-plugin wheels.-> C1
    FCC -.fcc-*-plugin wheels.-> C2
    FCC -.fcc-*-plugin wheels.-> C3
    FCC -.fcc-*-plugin wheels.-> C4x
    FCC -.fcc-*-plugin wheels.-> C5

    FCC --- USvc
    NEXUS -->|rationalizes| USvc
    POLARIS --- US3
    LYRA --- US3

    FCC --- ADRs
    A008 -.anchors.-> POLARIS
    A009 -.anchors.-> USvc
    A011 -.anchors.-> API_RAG
    A012 -.anchors.-> API_COLLAB
    A013 -.anchors.-> API_FED
    A010 -.anchors.-> APIsurface

    U1 -->|Python SDK + CLI| FCC
    U2 -->|fcc add-persona| FCC
    U3 -->|fcc compliance-audit| FCC
    U4 -->|fcc model-card| FCC
    U5 -->|BidirectionalSync| API_FED
    U6 -->|MultiUserSession| API_COLLAB

What changed vs. the canonical context diagram¶

Element	Canonical (context-diagram.md)	v1.5.0+ Update (this page)
Persona count	147 (v1.3.7)	164 (v1.5.1)
Helm chart	0.2.5 (v1.3.5.3)	0.4.1 (v1.5.1)
New stable surfaces	—	`fcc.api.archive`, `fcc.api.knowledge`, `fcc.api.rag`, `fcc.api.collaboration`, `fcc.api.federation`
POLARIS	not shown	v1.5.0 stable archive bridge
LYRA	not shown	v1.5.0 stable graph-of-thought bridge (backend pending)
Universal Services superset	not shown	22 entries, 5 tiers
ADRs	not shown	ADR-006..013 (8 new in v1.5.1)
End-user roles	4 (dev / author / compliance / patent)	6 (+ federation operator + collab session host)
Event bus	single bus	dual-bus (PAOM + UX + LaneRouter) per ADR-006

How to read the two diagrams together¶

Start with context-diagram.md for the baseline shape (19 ecosystem projects, 3 trust tiers, inbound/outbound DFD).
Overlay this page's diagram when you need the v1.5.0+ surfaces (POLARIS + LYRA bridges, fcc.api.* contribution surface, universal-services superset, ADR anchors).
Cross-check edges against docs/ecosystem/universal-services.md (drift + fallback per service) and docs/ecosystem/codename-decoder.md (codename lookup).

When reviewing an integration PR, both diagrams are in scope — the baseline for "does this respect the ecosystem shape" and the update for "does this fit the v1.5.0+ stable surface".

System Context Diagram — v1.5.0+ Update¶

Refreshed C4 Context (Level 1) — v1.5.0+¶

What changed vs. the canonical context diagram¶

How to read the two diagrams together¶

See also¶