# anders-planck/orditra architecture

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

- Interactive diagram: https://gitdiagram.com/anders-planck/orditra
- Repository: https://github.com/anders-planck/orditra

## Overview

Orditra manages a shared capability configuration for Codex, Claude Code, and OpenCode, then plans and applies client-specific setup. The main workflow is CLI install: inventory dependencies, resolve configuration into a plan, and apply it reversibly. Other documented workflows include project sync, configuration explanation and migration, health checks, repository maps, validation, and evidence reports. Registry and user configuration feed capability resolution; provider modules adapt configuration for supported integrations. The graph follows the README and SOURCE INDEX; unsampled subsystem internals are represented only at supported directory paths.

Main entry points: [`src/cli.ts`](https://github.com/anders-planck/orditra/blob/main/src/cli.ts) (CLI dispatcher), [`src/cli/diagnostics.ts`](https://github.com/anders-planck/orditra/blob/main/src/cli/diagnostics.ts) (Diagnostic commands), [`src/planner.ts`](https://github.com/anders-planck/orditra/blob/main/src/planner.ts) (Install planner), [`src/cli/install.ts`](https://github.com/anders-planck/orditra/blob/main/src/cli/install.ts) (Install workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI workflows"]
  node_cli["CLI dispatcher<br/>[cli.ts]"]
  node_install_cmd["Install workflow<br/>[install.ts]"]
  node_lifecycle_cmd["Lifecycle commands<br/>[lifecycle.ts]"]
  node_config_cmd["Config commands<br/>[configuration.ts]"]
  node_diagnostic_cmd["Diagnostic commands<br/>[diagnostics.ts]"]
  node_project_cmd["Project commands<br/>[project.ts]"]
end

subgraph group_config["Configuration model"]
  node_registry["Registries and presets<br/>[registry.ts]"]
  node_user_config["User configuration<br/>[user-config.ts]"]
  node_cap_resolution["Capability resolution<br/>[capabilities.ts]"]
end

subgraph group_install["Installation lifecycle"]
  node_planner["Install planner<br/>[planner.ts]"]
  node_dependency_plan["Dependency inventory<br/>[dependencies.ts]"]
  node_executor["Reversible executor<br/>[executor.ts]"]
  node_artifact_installer["Artifact installation"]
  node_paths["Managed paths<br/>[paths.ts]"]
end

subgraph group_capabilities["Capability integrations"]
  node_providers["Provider adapters"]
end

subgraph group_diagnostics["Project and diagnostics"]
  node_project_sync["Project detection and sync<br/>[project.ts]"]
  node_doctor["Health checks<br/>[doctor.ts]"]
  node_repository_map["Repository map<br/>[repository-map.ts]"]
  node_validation["Configuration validation<br/>[validate.ts]"]
  node_reporting["Evidence reports<br/>[reporting.ts]"]
end

node_operator(("Operator"))
node_external_clients["Agent clients"]

node_operator -->|"runs commands"| node_cli
node_cli -->|"dispatches install"| node_install_cmd
node_cli -->|"dispatches lifecycle"| node_lifecycle_cmd
node_cli -->|"dispatches config"| node_config_cmd
node_cli -->|"dispatches diagnostics"| node_diagnostic_cmd
node_cli -->|"dispatches project"| node_project_cmd
node_install_cmd -->|"plans dependencies"| node_dependency_plan
node_install_cmd -->|"builds plan"| node_planner
node_install_cmd -->|"applies plan"| node_executor
node_planner -->|"loads definitions"| node_registry
node_planner -->|"resolves capabilities"| node_cap_resolution
node_planner -->|"reads settings"| node_user_config
node_planner -->|"uses adapters"| node_providers
node_cap_resolution -->|"loads registries"| node_registry
node_user_config -->|"validates schema"| node_registry
node_executor -->|"resolves locations"| node_paths
node_dependency_plan -->|"uses artifact specs"| node_artifact_installer
node_executor -.->|"configures clients"| node_external_clients
node_project_cmd -->|"runs sync"| node_project_sync
node_project_sync -->|"uses profiles"| node_registry
node_project_sync -->|"reads settings"| node_user_config
node_diagnostic_cmd -->|"runs health checks"| node_doctor
node_diagnostic_cmd -->|"builds map"| node_repository_map
node_diagnostic_cmd -->|"validates setup"| node_validation
node_diagnostic_cmd -->|"emits findings"| node_reporting
node_config_cmd -->|"loads or migrates"| node_user_config
node_config_cmd -->|"explains settings"| node_cap_resolution

click node_cli "https://github.com/anders-planck/orditra/blob/main/src/cli.ts"
click node_install_cmd "https://github.com/anders-planck/orditra/blob/main/src/cli/install.ts"
click node_lifecycle_cmd "https://github.com/anders-planck/orditra/blob/main/src/cli/lifecycle.ts"
click node_config_cmd "https://github.com/anders-planck/orditra/blob/main/src/cli/configuration.ts"
click node_diagnostic_cmd "https://github.com/anders-planck/orditra/blob/main/src/cli/diagnostics.ts"
click node_project_cmd "https://github.com/anders-planck/orditra/blob/main/src/cli/project.ts"
click node_registry "https://github.com/anders-planck/orditra/blob/main/src/registry.ts"
click node_user_config "https://github.com/anders-planck/orditra/blob/main/src/user-config.ts"
click node_cap_resolution "https://github.com/anders-planck/orditra/blob/main/src/capabilities.ts"
click node_planner "https://github.com/anders-planck/orditra/blob/main/src/planner.ts"
click node_dependency_plan "https://github.com/anders-planck/orditra/blob/main/src/dependencies.ts"
click node_executor "https://github.com/anders-planck/orditra/blob/main/src/executor.ts"
click node_artifact_installer "https://github.com/anders-planck/orditra/blob/main/src/artifact-installer.ts"
click node_paths "https://github.com/anders-planck/orditra/blob/main/src/paths.ts"
click node_providers "https://github.com/anders-planck/orditra/tree/main/src/providers"
click node_project_sync "https://github.com/anders-planck/orditra/blob/main/src/project.ts"
click node_doctor "https://github.com/anders-planck/orditra/blob/main/src/doctor.ts"
click node_repository_map "https://github.com/anders-planck/orditra/blob/main/src/repository-map.ts"
click node_validation "https://github.com/anders-planck/orditra/blob/main/src/validate.ts"
click node_reporting "https://github.com/anders-planck/orditra/blob/main/src/reporting.ts"

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_cli,node_install_cmd,node_lifecycle_cmd,node_config_cmd,node_diagnostic_cmd,node_project_cmd,node_external_clients toneBlue
class node_registry,node_user_config,node_cap_resolution toneAmber
class node_planner,node_dependency_plan,node_executor,node_artifact_installer,node_paths toneMint
class node_providers toneRose
class node_project_sync,node_doctor,node_repository_map,node_validation,node_reporting,node_operator toneIndigo
```

## Components

### CLI workflows

- [CLI dispatcher](https://github.com/anders-planck/orditra/blob/main/src/cli.ts): `src/cli.ts`
- [Install workflow](https://github.com/anders-planck/orditra/blob/main/src/cli/install.ts): `src/cli/install.ts`
- [Lifecycle commands](https://github.com/anders-planck/orditra/blob/main/src/cli/lifecycle.ts): `src/cli/lifecycle.ts`
- [Config commands](https://github.com/anders-planck/orditra/blob/main/src/cli/configuration.ts): `src/cli/configuration.ts`
- [Diagnostic commands](https://github.com/anders-planck/orditra/blob/main/src/cli/diagnostics.ts): `src/cli/diagnostics.ts`
- [Project commands](https://github.com/anders-planck/orditra/blob/main/src/cli/project.ts): `src/cli/project.ts`

### Configuration model

- [Registries and presets](https://github.com/anders-planck/orditra/blob/main/src/registry.ts): `src/registry.ts`
- [User configuration](https://github.com/anders-planck/orditra/blob/main/src/user-config.ts): `src/user-config.ts`
- [Capability resolution](https://github.com/anders-planck/orditra/blob/main/src/capabilities.ts): `src/capabilities.ts`

### Installation lifecycle

- [Install planner](https://github.com/anders-planck/orditra/blob/main/src/planner.ts): `src/planner.ts`
- [Dependency inventory](https://github.com/anders-planck/orditra/blob/main/src/dependencies.ts): `src/dependencies.ts`
- [Reversible executor](https://github.com/anders-planck/orditra/blob/main/src/executor.ts): `src/executor.ts`
- [Artifact installation](https://github.com/anders-planck/orditra/blob/main/src/artifact-installer.ts): `src/artifact-installer.ts`
- [Managed paths](https://github.com/anders-planck/orditra/blob/main/src/paths.ts): `src/paths.ts`

### Capability integrations

- [Provider adapters](https://github.com/anders-planck/orditra/tree/main/src/providers): `src/providers`

### Project and diagnostics

- [Project detection and sync](https://github.com/anders-planck/orditra/blob/main/src/project.ts): `src/project.ts`
- [Health checks](https://github.com/anders-planck/orditra/blob/main/src/doctor.ts): `src/doctor.ts`
- [Repository map](https://github.com/anders-planck/orditra/blob/main/src/repository-map.ts): `src/repository-map.ts`
- [Configuration validation](https://github.com/anders-planck/orditra/blob/main/src/validate.ts): `src/validate.ts`
- [Evidence reports](https://github.com/anders-planck/orditra/blob/main/src/reporting.ts): `src/reporting.ts`

### Other components

- **Operator**
- **Agent clients**

## Connections

- Operator → CLI dispatcher: runs commands (evidence: `README.md`)
- CLI dispatcher → Install workflow: dispatches install (evidence: `src/cli.ts`)
- CLI dispatcher → Lifecycle commands: dispatches lifecycle (evidence: `src/cli.ts`)
- CLI dispatcher → Config commands: dispatches config (evidence: `src/cli.ts`)
- CLI dispatcher → Diagnostic commands: dispatches diagnostics (evidence: `src/cli.ts`)
- CLI dispatcher → Project commands: dispatches project (evidence: `src/cli.ts`)
- Install workflow → Dependency inventory: plans dependencies (evidence: `src/cli/install.ts`)
- Install workflow → Install planner: builds plan (evidence: `src/cli/install.ts`)
- Install workflow → Reversible executor: applies plan (evidence: `src/cli/install.ts`)
- Install planner → Registries and presets: loads definitions (evidence: `src/planner.ts`)
- Install planner → Capability resolution: resolves capabilities (evidence: `src/planner.ts`)
- Install planner → User configuration: reads settings (evidence: `src/planner.ts`)
- Install planner → Provider adapters: uses adapters (evidence: `src/planner.ts`)
- Capability resolution → Registries and presets: loads registries (evidence: `src/capabilities.ts`)
- User configuration → Registries and presets: validates schema (evidence: `src/user-config.ts`)
- Reversible executor → Managed paths: resolves locations (evidence: `src/executor.ts`)
- Dependency inventory → Artifact installation: uses artifact specs (evidence: `src/dependencies.ts`)
- Reversible executor → Agent clients: configures clients (evidence: `README.md`)
- Project commands → Project detection and sync: runs sync (evidence: `src/cli/project.ts`)
- Project detection and sync → Registries and presets: uses profiles (evidence: `src/project.ts`)
- Project detection and sync → User configuration: reads settings (evidence: `src/cli/project.ts`)
- Diagnostic commands → Health checks: runs health checks (evidence: `src/cli/diagnostics.ts`)
- Diagnostic commands → Repository map: builds map (evidence: `src/cli/diagnostics.ts`)
- Diagnostic commands → Configuration validation: validates setup (evidence: `src/cli/diagnostics.ts`)
- Diagnostic commands → Evidence reports: emits findings
- Config commands → User configuration: loads or migrates (evidence: `src/cli/configuration.ts`)
- Config commands → Capability resolution: explains settings (evidence: `src/cli/configuration.ts`)
