# npci/ainxt-os architecture

> Architecture diagram of the GitHub repository npci/ainxt-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/npci/ainxt-os
- Repository: https://github.com/npci/ainxt-os

## Overview

AiNxt OS is an engineering platform for building governed AI applications, not a hosted end-user product. The documented user path is Console → managed runtime → identity, session, compliance, authorization, streaming, and audit; a model is optional, with offline operation supported. The graph also preserves the README’s major platform capabilities and prominent source-indexed subsystems. Most cross-crate wiring is unsampled, so edges beyond documented relationships are omitted; the README supports the broad capability map, not specific implementation calls.

Main entry points: [`crates/ainxt-runtimed/src/main.rs`](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-runtimed/src/main.rs) (Runtime daemon), [`crates/ainxt-eval/src/pipeline.rs`](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/pipeline.rs) (Evaluation pipeline), [`crates/ainxt-console/src/main.rs`](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/main.rs) (Console UI), [`crates/ainxt-pipeline/src/pipeline.rs`](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/pipeline.rs) (Edit pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry"]
  node_console["Console UI<br/>[main.rs]"]
  node_console_settings["Console settings<br/>[settings.rs]"]
  node_console_auth["Console JWT<br/>[jwt.rs]"]
end

subgraph group_runtime["Governed runtime"]
  node_runtime_daemon["Runtime daemon<br/>[main.rs]"]
  node_runtime_core["Runtime core<br/>[lib.rs]"]
  node_identity["Identity and access<br/>[authority.rs]"]
  node_session["Session management<br/>[lib.rs]"]
  node_compliance["Compliance gates<br/>[lib.rs]"]
  node_guardrails["Guardrails<br/>[lib.rs]"]
  node_eventlog[("Audit event log<br/>[lib.rs]")]
end

subgraph group_ai["AI capabilities"]
  node_providers["Model providers<br/>[lib.rs]"]
  node_prompt["Prompt service<br/>[service.rs]"]
  node_prompt_registry["Prompt registry<br/>[registry.rs]"]
  node_tools["Tools and hooks<br/>[lib.rs]"]
  node_workforce["Agents and workflows<br/>[author.rs]"]
  node_memory["Memory<br/>[lib.rs]"]
  node_retrieval["Retrieval"]
end

subgraph group_assurance["Safety and assurance"]
  node_injection["Injection defense<br/>[detect.rs]"]
  node_injection_service["Injection service<br/>[main.rs]"]
  node_evaluation["Evaluation pipeline<br/>[pipeline.rs]"]
  node_eval_judge["Evaluation judge<br/>[judge.rs]"]
  node_eval_audit["Evaluation audit<br/>[audit.rs]"]
  node_eval_integrity["Corpus integrity<br/>[integrity.rs]"]
  node_eval_stats["Evaluation stats<br/>[stats.rs]"]
  node_edit_pipeline["Edit pipeline<br/>[pipeline.rs]"]
  node_edit_stages["Edit stages<br/>[stage.rs]"]
  node_self_heal["Self-heal planning<br/>[selfheal.rs]"]
end

subgraph group_operations["Platform operations"]
  node_program["Long-horizon programs<br/>[program.rs]"]
  node_program_driver["Program driver<br/>[driver.rs]"]
  node_program_supervisor["Program supervisor<br/>[supervisor.rs]"]
  node_online_quality["Online release control<br/>[controller.rs]"]
end

node_engineer(("Builder or operator"))
node_engineer_result(("AI application result"))

node_engineer -->|"uses"| node_console
node_console -->|"starts and manages"| node_runtime_daemon
node_console -->|"configures"| node_console_settings
node_runtime_daemon -.->|"runs"| node_runtime_core
node_runtime_daemon -->|"checks identity"| node_identity
node_runtime_daemon -->|"establishes session"| node_session
node_runtime_daemon -->|"gates request"| node_compliance
node_runtime_daemon -->|"authorizes"| node_identity
node_runtime_daemon -->|"records audit"| node_eventlog
node_runtime_daemon -.->|"requests model"| node_providers
node_runtime_daemon -->|"streams result"| node_engineer_result
node_runtime_daemon -.->|"enforces safety"| node_guardrails
node_runtime_daemon -.->|"serves prompts"| node_prompt
node_prompt -->|"uses registry"| node_prompt_registry
node_runtime_daemon -.->|"provides tools"| node_tools
node_runtime_daemon -.->|"supports workflows"| node_workforce
node_runtime_daemon -.->|"provides memory"| node_memory
node_runtime_daemon -.->|"provides retrieval"| node_retrieval
node_runtime_daemon -.->|"checks input"| node_injection
node_injection_service -->|"exposes detector"| node_injection
node_evaluation -->|"scores cases"| node_eval_judge
node_evaluation -->|"checks corpus"| node_eval_integrity
node_evaluation -->|"records verdict"| node_eval_audit
node_evaluation -->|"summarizes runs"| node_eval_stats
node_edit_pipeline -->|"composes stages"| node_edit_stages
node_edit_pipeline -->|"plans re-entry"| node_self_heal
node_program_driver -->|"applies events"| node_program
node_program_supervisor -->|"projects events"| node_program
node_online_quality -.->|"controls rollout"| node_engineer_result

click node_console "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/main.rs"
click node_console_settings "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/settings.rs"
click node_console_auth "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/jwt.rs"
click node_runtime_daemon "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-runtimed/src/main.rs"
click node_runtime_core "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-runtime/src/lib.rs"
click node_identity "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-identity/src/authority.rs"
click node_session "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-session/src/lib.rs"
click node_compliance "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-compliance/src/lib.rs"
click node_guardrails "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-guardrails/src/lib.rs"
click node_eventlog "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eventlog/src/lib.rs"
click node_providers "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-providers/src/lib.rs"
click node_prompt "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-prompt/src/service.rs"
click node_prompt_registry "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-prompt/src/registry.rs"
click node_tools "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-tools/src/lib.rs"
click node_workforce "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-workforce/src/author.rs"
click node_memory "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-memory/src/lib.rs"
click node_retrieval "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-retrieval/src/structured_pipeline.rs"
click node_injection "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-injection/src/detect.rs"
click node_injection_service "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-injection-svc/src/main.rs"
click node_evaluation "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/pipeline.rs"
click node_eval_judge "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/judge.rs"
click node_eval_audit "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/audit.rs"
click node_eval_integrity "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/integrity.rs"
click node_eval_stats "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/stats.rs"
click node_edit_pipeline "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/pipeline.rs"
click node_edit_stages "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/stage.rs"
click node_self_heal "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/selfheal.rs"
click node_program "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-planner/src/program.rs"
click node_program_driver "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-planner/src/driver.rs"
click node_program_supervisor "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-planner/src/supervisor.rs"
click node_online_quality "https://github.com/npci/ainxt-os/blob/main/crates/ainxt-quality/src/controller.rs"

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_console,node_console_settings,node_console_auth toneBlue
class node_runtime_daemon,node_runtime_core,node_identity,node_session,node_compliance,node_guardrails,node_eventlog toneAmber
class node_providers,node_prompt,node_prompt_registry,node_tools,node_workforce,node_memory,node_retrieval toneMint
class node_injection,node_injection_service,node_evaluation,node_eval_judge,node_eval_audit,node_eval_integrity,node_eval_stats,node_edit_pipeline,node_edit_stages,node_self_heal toneRose
class node_program,node_program_driver,node_program_supervisor,node_online_quality,node_engineer,node_engineer_result toneIndigo
```

## Components

### User entry

- [Console UI](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/main.rs): `crates/ainxt-console/src/main.rs`
- [Console settings](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/settings.rs): `crates/ainxt-console/src/settings.rs`
- [Console JWT](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-console/src/jwt.rs): `crates/ainxt-console/src/jwt.rs`

### Governed runtime

- [Runtime daemon](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-runtimed/src/main.rs): `crates/ainxt-runtimed/src/main.rs`
- [Runtime core](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-runtime/src/lib.rs): `crates/ainxt-runtime/src/lib.rs`
- [Identity and access](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-identity/src/authority.rs): `crates/ainxt-identity/src/authority.rs`
- [Session management](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-session/src/lib.rs): `crates/ainxt-session/src/lib.rs`
- [Compliance gates](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-compliance/src/lib.rs): `crates/ainxt-compliance/src/lib.rs`
- [Guardrails](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-guardrails/src/lib.rs): `crates/ainxt-guardrails/src/lib.rs`
- [Audit event log](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eventlog/src/lib.rs): `crates/ainxt-eventlog/src/lib.rs`

### AI capabilities

- [Model providers](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-providers/src/lib.rs): `crates/ainxt-providers/src/lib.rs`
- [Prompt service](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-prompt/src/service.rs): `crates/ainxt-prompt/src/service.rs`
- [Prompt registry](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-prompt/src/registry.rs): `crates/ainxt-prompt/src/registry.rs`
- [Tools and hooks](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-tools/src/lib.rs): `crates/ainxt-tools/src/lib.rs`
- [Agents and workflows](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-workforce/src/author.rs): `crates/ainxt-workforce/src/author.rs`
- [Memory](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-memory/src/lib.rs): `crates/ainxt-memory/src/lib.rs`
- [Retrieval](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-retrieval/src/structured_pipeline.rs): `crates/ainxt-retrieval/src/structured_pipeline.rs`

### Safety and assurance

- [Injection defense](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-injection/src/detect.rs): `crates/ainxt-injection/src/detect.rs`
- [Injection service](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-injection-svc/src/main.rs): `crates/ainxt-injection-svc/src/main.rs`
- [Evaluation pipeline](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/pipeline.rs): `crates/ainxt-eval/src/pipeline.rs`
- [Evaluation judge](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/judge.rs): `crates/ainxt-eval/src/judge.rs`
- [Evaluation audit](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/audit.rs): `crates/ainxt-eval/src/audit.rs`
- [Corpus integrity](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/integrity.rs): `crates/ainxt-eval/src/integrity.rs`
- [Evaluation stats](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-eval/src/stats.rs): `crates/ainxt-eval/src/stats.rs`
- [Edit pipeline](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/pipeline.rs): `crates/ainxt-pipeline/src/pipeline.rs`
- [Edit stages](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/stage.rs): `crates/ainxt-pipeline/src/stage.rs`
- [Self-heal planning](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-pipeline/src/selfheal.rs): `crates/ainxt-pipeline/src/selfheal.rs`

### Platform operations

- [Long-horizon programs](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-planner/src/program.rs): `crates/ainxt-planner/src/program.rs`
- [Program driver](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-planner/src/driver.rs): `crates/ainxt-planner/src/driver.rs`
- [Program supervisor](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-planner/src/supervisor.rs): `crates/ainxt-planner/src/supervisor.rs`
- [Online release control](https://github.com/npci/ainxt-os/blob/main/crates/ainxt-quality/src/controller.rs): `crates/ainxt-quality/src/controller.rs`

### Other components

- **Builder or operator**
- **AI application result**

## Connections

- Builder or operator → Console UI: uses
- Console UI → Runtime daemon: starts and manages
- Console UI → Console settings: configures (evidence: `crates/ainxt-console/src/main.rs`)
- Runtime daemon → Runtime core: runs
- Runtime daemon → Identity and access: checks identity
- Runtime daemon → Session management: establishes session
- Runtime daemon → Compliance gates: gates request
- Runtime daemon → Identity and access: authorizes
- Runtime daemon → Audit event log: records audit
- Runtime daemon → Model providers: requests model
- Runtime daemon → AI application result: streams result
- Runtime daemon → Guardrails: enforces safety
- Runtime daemon → Prompt service: serves prompts
- Prompt service → Prompt registry: uses registry (evidence: `crates/ainxt-prompt/src/service.rs`)
- Runtime daemon → Tools and hooks: provides tools
- Runtime daemon → Agents and workflows: supports workflows
- Runtime daemon → Memory: provides memory
- Runtime daemon → Retrieval: provides retrieval
- Runtime daemon → Injection defense: checks input
- Injection service → Injection defense: exposes detector (evidence: `crates/ainxt-injection-svc/src/main.rs`)
- Evaluation pipeline → Evaluation judge: scores cases (evidence: `crates/ainxt-eval/src/pipeline.rs`)
- Evaluation pipeline → Corpus integrity: checks corpus (evidence: `crates/ainxt-eval/src/pipeline.rs`)
- Evaluation pipeline → Evaluation audit: records verdict (evidence: `crates/ainxt-eval/src/pipeline.rs`)
- Evaluation pipeline → Evaluation stats: summarizes runs (evidence: `crates/ainxt-eval/src/pipeline.rs`)
- Edit pipeline → Edit stages: composes stages (evidence: `crates/ainxt-pipeline/src/pipeline.rs`)
- Edit pipeline → Self-heal planning: plans re-entry (evidence: `crates/ainxt-pipeline/src/pipeline.rs`)
- Program driver → Long-horizon programs: applies events (evidence: `crates/ainxt-planner/src/program.rs`)
- Program supervisor → Long-horizon programs: projects events (evidence: `crates/ainxt-planner/src/program.rs`)
- Online release control → AI application result: controls rollout
