# stegverse-org/stegverse-sdk architecture

> Architecture diagram of the GitHub repository stegverse-org/stegverse-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/stegverse-org/stegverse-sdk
- Repository: https://github.com/stegverse-org/stegverse-sdk

## Overview

StegVerse SDK is a governance and validation boundary for manifested data, AI/LLM outputs, and governed submissions. Its central workflow accepts a caller manifest, validates and resolves its declared processing route, evaluates the request, preserves canonical custody and state-transition evidence, then returns a caller-selected projection and receipt locator. For complete communication manifests, Publisher evidence and SDK return binding precede the final egress transition; communication is terminal only after the far-side transition. The graph also preserves the documented LLM-session and Ecosystem Chat branches. Several subsystem links are documentation-level because their implementations were not sampled.

Main entry points: [`stegverse/ecosystem_chat_pipeline.py`](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_pipeline.py) (Ecosystem Chat pipeline), [`stegverse/manifest_execution.py`](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/manifest_execution.py) (Manifest execution), [`stegverse/manifest_contract.py`](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/manifest_contract.py) (Manifest contract), [`stegverse/route_resolution.py`](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/route_resolution.py) (Route resolution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingress["Manifest Ingress"]
  node_manifest["Manifest contract"]
  node_routes["Route resolution"]
end

subgraph group_governance["Governed Processing"]
  node_execution["Manifest execution"]
  node_validation["Production validation"]
  node_governed_llm["LLM session validation"]
  node_governance_graph["Reference graph"]
end

subgraph group_custody["Evidence and Custody"]
  node_master_records[("Master Records custody")]
  node_transition_evidence["Transition evidence"]
  node_replay["Admissibility replay"]
  node_projection["Artifact projection"]
end

subgraph group_communication["Communication Lifecycle"]
  node_publisher["Publisher return binding"]
  node_interlock["Interlock transition"]
  node_far_side["Far-side transition"]
end

subgraph group_integrations["SDK Integrations"]
  node_chat_http["Ecosystem Chat HTTP"]
  node_chat_pipeline["Ecosystem Chat pipeline"]
  node_chat_intake["Chat intake"]
  node_receipt_engine["Receipt evaluation"]
  node_chat_issuer["Governed issuer"]
  node_record_export["Record export"]
  node_persistence["Persistence plan"]
  node_destination["Destination binding"]
  node_write_adapter["Write adapter"]
end

node_framework(("External framework"))

node_framework -->|"submits manifest"| node_manifest
node_manifest -->|"declares route"| node_routes
node_routes -->|"resolves route"| node_execution
node_execution -->|"dispatches processing"| node_validation
node_execution -->|"custodies result"| node_master_records
node_execution -->|"selects projection"| node_projection
node_execution -->|"records transitions"| node_transition_evidence
node_execution -.->|"requests replay"| node_replay
node_framework -->|"submits session"| node_governed_llm
node_framework -.->|"provides graph"| node_governance_graph
node_projection -->|"returns artifact"| node_framework
node_execution -.->|"binds result"| node_publisher
node_publisher -->|"prepares egress"| node_interlock
node_interlock -->|"transitions egress"| node_far_side
node_framework -->|"posts payload"| node_chat_http
node_chat_http -->|"runs pipeline"| node_chat_pipeline
node_chat_pipeline -->|"handles submission"| node_chat_intake
node_chat_pipeline -->|"evaluates receipt"| node_receipt_engine
node_chat_pipeline -->|"requests issuance"| node_chat_issuer
node_chat_pipeline -->|"builds export"| node_record_export
node_chat_pipeline -->|"builds plan"| node_persistence
node_chat_pipeline -->|"binds destination"| node_destination
node_chat_pipeline -->|"writes plan"| node_write_adapter

click node_manifest "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/manifest_contract.py"
click node_routes "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/route_resolution.py"
click node_execution "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/manifest_execution.py"
click node_validation "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/production_validation_runtime.py"
click node_governed_llm "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/governed_llm_session.py"
click node_governance_graph "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/governance_reference_graph.py"
click node_master_records "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/master_records_custody.py"
click node_transition_evidence "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/state_transition_evidence.py"
click node_replay "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/admissibility_replay.py"
click node_projection "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_projection.py"
click node_publisher "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/publisher_return_binding.py"
click node_interlock "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/interlock_transition.py"
click node_chat_http "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_pipeline_http.py"
click node_chat_pipeline "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_pipeline.py"
click node_chat_intake "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_backend.py"
click node_receipt_engine "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_receipt_engine.py"
click node_chat_issuer "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_issuer.py"
click node_record_export "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_record_export.py"
click node_persistence "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_persistence_plan.py"
click node_destination "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_destination_binding.py"
click node_write_adapter "https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_write_adapter.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manifest,node_routes toneBlue
class node_execution,node_validation,node_governed_llm,node_governance_graph toneAmber
class node_master_records,node_transition_evidence,node_replay,node_projection toneMint
class node_publisher,node_interlock,node_far_side toneRose
class node_chat_http,node_chat_pipeline,node_chat_intake,node_receipt_engine,node_chat_issuer,node_record_export,node_persistence,node_destination,node_write_adapter,node_framework toneIndigo
```

## Components

### Manifest Ingress

- [Manifest contract](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/manifest_contract.py): `stegverse/manifest_contract.py`
- [Route resolution](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/route_resolution.py): `stegverse/route_resolution.py`

### Governed Processing

- [Manifest execution](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/manifest_execution.py): `stegverse/manifest_execution.py`
- [Production validation](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/production_validation_runtime.py): `stegverse/production_validation_runtime.py`
- [LLM session validation](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/governed_llm_session.py): `stegverse/governed_llm_session.py`
- [Reference graph](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/governance_reference_graph.py): `stegverse/governance_reference_graph.py`

### Evidence and Custody

- [Master Records custody](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/master_records_custody.py): `stegverse/master_records_custody.py`
- [Transition evidence](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/state_transition_evidence.py): `stegverse/state_transition_evidence.py`
- [Admissibility replay](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/admissibility_replay.py): `stegverse/admissibility_replay.py`
- [Artifact projection](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_projection.py): `stegverse/ecosystem_projection.py`

### Communication Lifecycle

- [Publisher return binding](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/publisher_return_binding.py): `stegverse/publisher_return_binding.py`
- [Interlock transition](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/interlock_transition.py): `stegverse/interlock_transition.py`
- **Far-side transition**

### SDK Integrations

- [Ecosystem Chat HTTP](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_pipeline_http.py): `stegverse/ecosystem_chat_pipeline_http.py`
- [Ecosystem Chat pipeline](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_pipeline.py): `stegverse/ecosystem_chat_pipeline.py`
- [Chat intake](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_backend.py): `stegverse/ecosystem_chat_backend.py`
- [Receipt evaluation](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_receipt_engine.py): `stegverse/ecosystem_chat_receipt_engine.py`
- [Governed issuer](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_issuer.py): `stegverse/ecosystem_chat_issuer.py`
- [Record export](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_record_export.py): `stegverse/ecosystem_chat_record_export.py`
- [Persistence plan](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_persistence_plan.py): `stegverse/ecosystem_chat_persistence_plan.py`
- [Destination binding](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_destination_binding.py): `stegverse/ecosystem_chat_destination_binding.py`
- [Write adapter](https://github.com/stegverse-org/stegverse-sdk/blob/main/stegverse/ecosystem_chat_write_adapter.py): `stegverse/ecosystem_chat_write_adapter.py`

### Other components

- **External framework**

## Connections

- External framework → Manifest contract: submits manifest
- Manifest contract → Route resolution: declares route
- Route resolution → Manifest execution: resolves route
- Manifest execution → Production validation: dispatches processing
- Manifest execution → Master Records custody: custodies result
- Manifest execution → Artifact projection: selects projection
- Manifest execution → Transition evidence: records transitions
- Manifest execution → Admissibility replay: requests replay
- External framework → LLM session validation: submits session
- External framework → Reference graph: provides graph
- Artifact projection → External framework: returns artifact
- Manifest execution → Publisher return binding: binds result
- Publisher return binding → Interlock transition: prepares egress
- Interlock transition → Far-side transition: transitions egress
- External framework → Ecosystem Chat HTTP: posts payload
- Ecosystem Chat HTTP → Ecosystem Chat pipeline: runs pipeline
- Ecosystem Chat pipeline → Chat intake: handles submission
- Ecosystem Chat pipeline → Receipt evaluation: evaluates receipt
- Ecosystem Chat pipeline → Governed issuer: requests issuance
- Ecosystem Chat pipeline → Record export: builds export
- Ecosystem Chat pipeline → Persistence plan: builds plan
- Ecosystem Chat pipeline → Destination binding: binds destination
- Ecosystem Chat pipeline → Write adapter: writes plan