# colmali-7/ildris architecture

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

- Interactive diagram: https://gitdiagram.com/colmali-7/ildris
- Repository: https://github.com/colmali-7/ildris

## Overview

Ildris is local-first source-control and collaboration infrastructure that records agent claims, gathers available observations, evaluates evidence and governance, and seals accepted changes for offline verification. The main workflow runs from a controlled agent session through observed-write reconciliation, staging, analysis and policy/risk gates, to a signed change and a portable provenance bundle. The graph preserves documented analysis, planning, review, identity and storage capabilities. Source excerpts are partial; edges rely on the README’s explicit workflow descriptions rather than assumptions about unsampled CLI wiring.

Main entry points: [`crates/ild-cli/src/command.rs`](https://github.com/colmali-7/ildris/blob/main/crates/ild-cli/src/command.rs) (ild CLI), [`crates/ild-session/src/state.rs`](https://github.com/colmali-7/ildris/blob/main/crates/ild-session/src/state.rs) (Agent session), [`crates/ild-change/src/transaction.rs`](https://github.com/colmali-7/ildris/blob/main/crates/ild-change/src/transaction.rs) (Change transaction), [`crates/ild-observer/src/lib.rs`](https://github.com/colmali-7/ildris/blob/main/crates/ild-observer/src/lib.rs) (Workspace observer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Session evidence"]
  node_cli["ild CLI<br/>[command.rs]"]
  node_session["Agent session<br/>[state.rs]"]
  node_permissions["Permission gate<br/>[lib.rs]"]
  node_observer["Workspace observer<br/>[lib.rs]"]
  node_reconcile["Claim reconciliation<br/>[result.rs]"]
end

subgraph group_governance["Change governance"]
  node_draft["Staged selection<br/>[draft.rs]"]
  node_plan["Atomic planner<br/>[engine.rs]"]
  node_policy["Policy engine<br/>[evaluate.rs]"]
  node_risk["Risk scoring<br/>[ruleset.rs]"]
  node_review["Human review<br/>[lib.rs]"]
  node_change["Change transaction<br/>[transaction.rs]"]
end

subgraph group_analysis["Change analysis"]
  node_semantic["Semantic analysis<br/>[extract.rs]"]
  node_dependency["Dependency and boundaries<br/>[manifest.rs]"]
  node_explain["Evidence explanation<br/>[explain.rs]"]
end

subgraph group_trust["Trust and provenance"]
  node_identity["Repository identity<br/>[lib.rs]"]
  node_protocol["Signed evidence protocol<br/>[lib.rs]"]
  node_bundle["Provenance bundle<br/>[bundle.rs]"]
  node_verify["Offline verification<br/>[verify.rs]"]
end

subgraph group_storage["Local repository"]
  node_objects[("Native object store<br/>[store.rs]")]
  node_git["Git compatibility<br/>[lib.rs]"]
  node_sqlite[("SQLite projection<br/>[lib.rs]")]
end

node_user(("Developer / agent"))

node_user -->|"invokes"| node_cli
node_cli -->|"starts session"| node_session
node_cli -->|"sets capabilities"| node_permissions
node_session -->|"records observations"| node_observer
node_session -->|"supplies claims"| node_reconcile
node_observer -->|"supplies observations"| node_reconcile
node_cli -->|"stages units"| node_draft
node_cli -->|"requests grouping"| node_plan
node_cli -->|"requests analysis"| node_semantic
node_cli -->|"requests analysis"| node_dependency
node_cli -->|"evaluates before commit"| node_policy
node_cli -->|"evaluates before commit"| node_risk
node_cli -.->|"records review"| node_review
node_cli -->|"commits change"| node_change
node_change -->|"seals objects"| node_objects
node_change -->|"creates Git commit"| node_git
node_cli -->|"renders explanation"| node_explain
node_cli -->|"exports provenance"| node_bundle
node_bundle -->|"verified offline"| node_verify
node_identity -.->|"signs evidence"| node_protocol
node_objects -.->|"projects locally"| node_sqlite
node_cli -->|"manages keys"| node_identity

click node_cli "https://github.com/colmali-7/ildris/blob/main/crates/ild-cli/src/command.rs"
click node_session "https://github.com/colmali-7/ildris/blob/main/crates/ild-session/src/state.rs"
click node_permissions "https://github.com/colmali-7/ildris/blob/main/crates/ild-permission/src/lib.rs"
click node_observer "https://github.com/colmali-7/ildris/blob/main/crates/ild-observer/src/lib.rs"
click node_reconcile "https://github.com/colmali-7/ildris/blob/main/crates/ild-reconcile/src/result.rs"
click node_draft "https://github.com/colmali-7/ildris/blob/main/crates/ild-change/src/draft.rs"
click node_plan "https://github.com/colmali-7/ildris/blob/main/crates/ild-plan/src/engine.rs"
click node_policy "https://github.com/colmali-7/ildris/blob/main/crates/ild-policy/src/evaluate.rs"
click node_risk "https://github.com/colmali-7/ildris/blob/main/crates/ild-risk/src/ruleset.rs"
click node_review "https://github.com/colmali-7/ildris/blob/main/crates/ild-review/src/lib.rs"
click node_change "https://github.com/colmali-7/ildris/blob/main/crates/ild-change/src/transaction.rs"
click node_semantic "https://github.com/colmali-7/ildris/blob/main/crates/ild-semantic/src/extract.rs"
click node_dependency "https://github.com/colmali-7/ildris/blob/main/crates/ild-dependency/src/manifest.rs"
click node_explain "https://github.com/colmali-7/ildris/blob/main/crates/ild-disclosure/src/explain.rs"
click node_identity "https://github.com/colmali-7/ildris/blob/main/crates/ild-identity/src/lib.rs"
click node_protocol "https://github.com/colmali-7/ildris/blob/main/crates/ild-protocol/src/lib.rs"
click node_bundle "https://github.com/colmali-7/ildris/blob/main/crates/ild-disclosure/src/bundle.rs"
click node_verify "https://github.com/colmali-7/ildris/blob/main/crates/ild-disclosure/src/verify.rs"
click node_objects "https://github.com/colmali-7/ildris/blob/main/crates/ild-object/src/store.rs"
click node_git "https://github.com/colmali-7/ildris/blob/main/crates/ild-git/src/lib.rs"
click node_sqlite "https://github.com/colmali-7/ildris/blob/main/crates/ild-store-sqlite/src/lib.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_cli,node_session,node_permissions,node_observer,node_reconcile toneBlue
class node_draft,node_plan,node_policy,node_risk,node_review,node_change toneAmber
class node_semantic,node_dependency,node_explain toneMint
class node_identity,node_protocol,node_bundle,node_verify toneRose
class node_objects,node_git,node_sqlite,node_user toneIndigo
```

## Components

### Session evidence

- [ild CLI](https://github.com/colmali-7/ildris/blob/main/crates/ild-cli/src/command.rs): `crates/ild-cli/src/command.rs`
- [Agent session](https://github.com/colmali-7/ildris/blob/main/crates/ild-session/src/state.rs): `crates/ild-session/src/state.rs`
- [Permission gate](https://github.com/colmali-7/ildris/blob/main/crates/ild-permission/src/lib.rs): `crates/ild-permission/src/lib.rs`
- [Workspace observer](https://github.com/colmali-7/ildris/blob/main/crates/ild-observer/src/lib.rs): `crates/ild-observer/src/lib.rs`
- [Claim reconciliation](https://github.com/colmali-7/ildris/blob/main/crates/ild-reconcile/src/result.rs): `crates/ild-reconcile/src/result.rs`

### Change governance

- [Staged selection](https://github.com/colmali-7/ildris/blob/main/crates/ild-change/src/draft.rs): `crates/ild-change/src/draft.rs`
- [Atomic planner](https://github.com/colmali-7/ildris/blob/main/crates/ild-plan/src/engine.rs): `crates/ild-plan/src/engine.rs`
- [Policy engine](https://github.com/colmali-7/ildris/blob/main/crates/ild-policy/src/evaluate.rs): `crates/ild-policy/src/evaluate.rs`
- [Risk scoring](https://github.com/colmali-7/ildris/blob/main/crates/ild-risk/src/ruleset.rs): `crates/ild-risk/src/ruleset.rs`
- [Human review](https://github.com/colmali-7/ildris/blob/main/crates/ild-review/src/lib.rs): `crates/ild-review/src/lib.rs`
- [Change transaction](https://github.com/colmali-7/ildris/blob/main/crates/ild-change/src/transaction.rs): `crates/ild-change/src/transaction.rs`

### Change analysis

- [Semantic analysis](https://github.com/colmali-7/ildris/blob/main/crates/ild-semantic/src/extract.rs): `crates/ild-semantic/src/extract.rs`
- [Dependency and boundaries](https://github.com/colmali-7/ildris/blob/main/crates/ild-dependency/src/manifest.rs): `crates/ild-dependency/src/manifest.rs`
- [Evidence explanation](https://github.com/colmali-7/ildris/blob/main/crates/ild-disclosure/src/explain.rs): `crates/ild-disclosure/src/explain.rs`

### Trust and provenance

- [Repository identity](https://github.com/colmali-7/ildris/blob/main/crates/ild-identity/src/lib.rs): `crates/ild-identity/src/lib.rs`
- [Signed evidence protocol](https://github.com/colmali-7/ildris/blob/main/crates/ild-protocol/src/lib.rs): `crates/ild-protocol/src/lib.rs`
- [Provenance bundle](https://github.com/colmali-7/ildris/blob/main/crates/ild-disclosure/src/bundle.rs): `crates/ild-disclosure/src/bundle.rs`
- [Offline verification](https://github.com/colmali-7/ildris/blob/main/crates/ild-disclosure/src/verify.rs): `crates/ild-disclosure/src/verify.rs`

### Local repository

- [Native object store](https://github.com/colmali-7/ildris/blob/main/crates/ild-object/src/store.rs): `crates/ild-object/src/store.rs`
- [Git compatibility](https://github.com/colmali-7/ildris/blob/main/crates/ild-git/src/lib.rs): `crates/ild-git/src/lib.rs`
- [SQLite projection](https://github.com/colmali-7/ildris/blob/main/crates/ild-store-sqlite/src/lib.rs): `crates/ild-store-sqlite/src/lib.rs`

### Other components

- **Developer / agent**

## Connections

- Developer / agent → ild CLI: invokes (evidence: `README.md`)
- ild CLI → Agent session: starts session (evidence: `README.md`)
- ild CLI → Permission gate: sets capabilities (evidence: `README.md`)
- Agent session → Workspace observer: records observations (evidence: `README.md`)
- Agent session → Claim reconciliation: supplies claims (evidence: `README.md`)
- Workspace observer → Claim reconciliation: supplies observations (evidence: `README.md`)
- ild CLI → Staged selection: stages units (evidence: `README.md`)
- ild CLI → Atomic planner: requests grouping (evidence: `README.md`)
- ild CLI → Semantic analysis: requests analysis (evidence: `README.md`)
- ild CLI → Dependency and boundaries: requests analysis (evidence: `README.md`)
- ild CLI → Policy engine: evaluates before commit (evidence: `README.md`)
- ild CLI → Risk scoring: evaluates before commit (evidence: `README.md`)
- ild CLI → Human review: records review (evidence: `README.md`)
- ild CLI → Change transaction: commits change (evidence: `README.md`)
- Change transaction → Native object store: seals objects (evidence: `README.md`)
- Change transaction → Git compatibility: creates Git commit (evidence: `README.md`)
- ild CLI → Evidence explanation: renders explanation (evidence: `README.md`)
- ild CLI → Provenance bundle: exports provenance (evidence: `README.md`)
- Provenance bundle → Offline verification: verified offline (evidence: `README.md`)
- Repository identity → Signed evidence protocol: signs evidence
- Native object store → SQLite projection: projects locally
- ild CLI → Repository identity: manages keys (evidence: `README.md`)
