# aperip-daedalus-foundation/ahcl-kit architecture

> Architecture diagram of the GitHub repository aperip-daedalus-foundation/ahcl-kit, 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/aperip-daedalus-foundation/ahcl-kit
- Repository: https://github.com/aperip-daedalus-foundation/ahcl-kit

## Overview

AHCL Kit is a cross-platform Rust CLI for initializing and maintaining AHCL project materials. The user workflow is to create and validate project configuration, initialize project/license state, resolve configured ecosystem dependencies, generate or check materials, and explicitly generate dependency or third-party evidence. The README documents Cargo and JavaScript lockfile support and dry-run/batch operation. Relationships inside unsampled areas are omitted unless the README or SOURCE INDEX supports them; paths identify the implementing modules or their enclosing subsystem directories.

Main entry points: [`crates/ahcl-kit-cli/src/dispatch.rs`](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/dispatch.rs) (AHCL commands), [`crates/ahcl-kit-javascript/src/adapter.rs`](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/adapter.rs) (JavaScript adapter), [`crates/ahcl-kit-materials/src/project.rs`](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/project.rs) (Project planning), [`crates/ahcl-kit-config/src/parser.rs`](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/parser.rs) (Config parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_cli["AHCL commands<br/>[dispatch.rs]"]
  node_discovery["Project discovery<br/>[discovery.rs]"]
  node_batch["Batch commands<br/>[batch.rs]"]
  node_output["Command output<br/>[output.rs]"]
end

subgraph group_config["Configuration"]
  node_config_parse["Config parser<br/>[parser.rs]"]
  node_config_schema["Config schema<br/>[schema.rs]"]
  node_config_binding["Config bindings<br/>[binding.rs]"]
  node_config_ast["Config AST<br/>[ast.rs]"]
  node_config_host["Config commands"]
end

subgraph group_resolution["Dependency resolution"]
  node_cargo_adapter["Cargo adapter<br/>[adapter.rs]"]
  node_cargo_settings["Cargo settings<br/>[settings.rs]"]
  node_cargo_graph["Cargo graph<br/>[graph.rs]"]
  node_cargo_upstream["Cargo evidence recovery<br/>[upstream.rs]"]
  node_cargo_manifest["Upstream manifests"]
  node_cargo_url["Upstream URL checks<br/>[upstream_url.rs]"]
  node_js_adapter["JavaScript adapter<br/>[adapter.rs]"]
  node_js_model["Normalized JS graph<br/>[model.rs]"]
  node_js_npm["npm lockfiles<br/>[npm.rs]"]
  node_js_pnpm["pnpm lockfiles<br/>[pnpm.rs]"]
  node_js_yarn["Yarn lockfiles<br/>[yarn.rs]"]
  node_js_bun["Bun lockfiles<br/>[bun.rs]"]
end

subgraph group_materials["Materials and evidence"]
  node_project_plan["Project planning<br/>[project.rs]"]
  node_render["Document rendering<br/>[render.rs]"]
  node_apply["Material application<br/>[apply.rs]"]
  node_dependencies["Dependency report<br/>[dependencies.rs]"]
  node_third_party["Third-party evidence<br/>[third_party.rs]"]
end

subgraph group_shared["Shared services"]
  node_license_client["License download<br/>[client.rs]"]
  node_license_verify["License verification<br/>[verify.rs]"]
  node_fs["Safe filesystem<br/>[lib.rs]"]
end

node_user(("Project maintainer"))
node_official_license["Official license service"]

node_user -->|"runs commands"| node_cli
node_cli -->|"manages config"| node_config_host
node_cli -->|"generates or checks"| node_project_plan
node_cli -->|"syncs license"| node_license_client
node_cli -->|"generates report"| node_dependencies
node_cli -->|"generates evidence"| node_third_party
node_cli -->|"discovers project"| node_discovery
node_cli -->|"accepts batch input"| node_batch
node_config_parse -->|"builds AST"| node_config_ast
node_config_parse -->|"uses schema"| node_config_schema
node_config_parse -->|"uses bindings"| node_config_binding
node_project_plan -->|"renders documents"| node_render
node_project_plan -->|"plans writes"| node_apply
node_project_plan -->|"includes report"| node_dependencies
node_project_plan -->|"uses inventory"| node_third_party
node_third_party -->|"reads evidence"| node_dependencies
node_cargo_adapter -->|"uses settings"| node_cargo_settings
node_cargo_adapter -->|"resolves graph"| node_cargo_graph
node_cargo_adapter -->|"recovers evidence"| node_cargo_upstream
node_cargo_upstream -->|"checks manifests"| node_cargo_manifest
node_cargo_upstream -->|"checks URLs"| node_cargo_url
node_js_adapter -->|"normalizes graph"| node_js_model
node_js_adapter -->|"parses npm"| node_js_npm
node_js_adapter -->|"parses pnpm"| node_js_pnpm
node_js_adapter -->|"parses Yarn"| node_js_yarn
node_js_adapter -->|"parses Bun"| node_js_bun
node_license_client -->|"fetches license"| node_official_license
node_license_client -->|"verifies response"| node_license_verify
node_fs -->|"provides safe I/O"| node_fs

click node_cli "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/dispatch.rs"
click node_discovery "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/discovery.rs"
click node_batch "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/batch.rs"
click node_output "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/output.rs"
click node_config_parse "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/parser.rs"
click node_config_schema "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/schema.rs"
click node_config_binding "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/binding.rs"
click node_config_ast "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/ast.rs"
click node_config_host "https://github.com/aperip-daedalus-foundation/ahcl-kit/tree/master/crates/ahcl-kit-config/src"
click node_cargo_adapter "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/adapter.rs"
click node_cargo_settings "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/settings.rs"
click node_cargo_graph "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/graph.rs"
click node_cargo_upstream "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/upstream.rs"
click node_cargo_manifest "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/upstream_manifest.rs"
click node_cargo_url "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/upstream_url.rs"
click node_js_adapter "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/adapter.rs"
click node_js_model "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/model.rs"
click node_js_npm "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/npm.rs"
click node_js_pnpm "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/pnpm.rs"
click node_js_yarn "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/yarn.rs"
click node_js_bun "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/bun.rs"
click node_project_plan "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/project.rs"
click node_render "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/render.rs"
click node_apply "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/apply.rs"
click node_dependencies "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/dependencies.rs"
click node_third_party "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/third_party.rs"
click node_license_client "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-license/src/client.rs"
click node_license_verify "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-license/src/verify.rs"
click node_fs "https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-fs/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_discovery,node_batch,node_output toneBlue
class node_config_parse,node_config_schema,node_config_binding,node_config_ast,node_config_host toneAmber
class node_cargo_adapter,node_cargo_settings,node_cargo_graph,node_cargo_upstream,node_cargo_manifest,node_cargo_url,node_js_adapter,node_js_model,node_js_npm,node_js_pnpm,node_js_yarn,node_js_bun toneMint
class node_project_plan,node_render,node_apply,node_dependencies,node_third_party toneRose
class node_license_client,node_license_verify,node_fs,node_user,node_official_license toneIndigo
```

## Components

### CLI workflow

- [AHCL commands](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/dispatch.rs): `crates/ahcl-kit-cli/src/dispatch.rs`
- [Project discovery](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/discovery.rs): `crates/ahcl-kit-cli/src/discovery.rs`
- [Batch commands](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/batch.rs): `crates/ahcl-kit-cli/src/batch.rs`
- [Command output](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cli/src/output.rs): `crates/ahcl-kit-cli/src/output.rs`

### Configuration

- [Config parser](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/parser.rs): `crates/ahcl-kit-config/src/parser.rs`
- [Config schema](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/schema.rs): `crates/ahcl-kit-config/src/schema.rs`
- [Config bindings](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/binding.rs): `crates/ahcl-kit-config/src/binding.rs`
- [Config AST](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-config/src/ast.rs): `crates/ahcl-kit-config/src/ast.rs`
- [Config commands](https://github.com/aperip-daedalus-foundation/ahcl-kit/tree/master/crates/ahcl-kit-config/src): `crates/ahcl-kit-config/src`

### Dependency resolution

- [Cargo adapter](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/adapter.rs): `crates/ahcl-kit-cargo/src/adapter.rs`
- [Cargo settings](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/settings.rs): `crates/ahcl-kit-cargo/src/settings.rs`
- [Cargo graph](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/graph.rs): `crates/ahcl-kit-cargo/src/graph.rs`
- [Cargo evidence recovery](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/upstream.rs): `crates/ahcl-kit-cargo/src/upstream.rs`
- [Upstream manifests](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/upstream_manifest.rs): `crates/ahcl-kit-cargo/src/upstream_manifest.rs`
- [Upstream URL checks](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-cargo/src/upstream_url.rs): `crates/ahcl-kit-cargo/src/upstream_url.rs`
- [JavaScript adapter](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/adapter.rs): `crates/ahcl-kit-javascript/src/adapter.rs`
- [Normalized JS graph](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/model.rs): `crates/ahcl-kit-javascript/src/model.rs`
- [npm lockfiles](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/npm.rs): `crates/ahcl-kit-javascript/src/npm.rs`
- [pnpm lockfiles](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/pnpm.rs): `crates/ahcl-kit-javascript/src/pnpm.rs`
- [Yarn lockfiles](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/yarn.rs): `crates/ahcl-kit-javascript/src/yarn.rs`
- [Bun lockfiles](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-javascript/src/bun.rs): `crates/ahcl-kit-javascript/src/bun.rs`

### Materials and evidence

- [Project planning](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/project.rs): `crates/ahcl-kit-materials/src/project.rs`
- [Document rendering](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/render.rs): `crates/ahcl-kit-materials/src/render.rs`
- [Material application](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/apply.rs): `crates/ahcl-kit-materials/src/apply.rs`
- [Dependency report](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/dependencies.rs): `crates/ahcl-kit-materials/src/dependencies.rs`
- [Third-party evidence](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-materials/src/third_party.rs): `crates/ahcl-kit-materials/src/third_party.rs`

### Shared services

- [License download](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-license/src/client.rs): `crates/ahcl-kit-license/src/client.rs`
- [License verification](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-license/src/verify.rs): `crates/ahcl-kit-license/src/verify.rs`
- [Safe filesystem](https://github.com/aperip-daedalus-foundation/ahcl-kit/blob/master/crates/ahcl-kit-fs/src/lib.rs): `crates/ahcl-kit-fs/src/lib.rs`

### Other components

- **Project maintainer**
- **Official license service**

## Connections

- Project maintainer → AHCL commands: runs commands (evidence: `README.md`)
- AHCL commands → Config commands: manages config (evidence: `README.md`)
- AHCL commands → Project planning: generates or checks (evidence: `README.md`)
- AHCL commands → License download: syncs license (evidence: `README.md`)
- AHCL commands → Dependency report: generates report (evidence: `README.md`)
- AHCL commands → Third-party evidence: generates evidence (evidence: `README.md`)
- AHCL commands → Project discovery: discovers project (evidence: `README.md`)
- AHCL commands → Batch commands: accepts batch input (evidence: `README.md`)
- Config parser → Config AST: builds AST (evidence: `crates/ahcl-kit-config/src/parser.rs`)
- Config parser → Config schema: uses schema (evidence: `crates/ahcl-kit-config/src/parser.rs`)
- Config parser → Config bindings: uses bindings (evidence: `crates/ahcl-kit-config/src/parser.rs`)
- Project planning → Document rendering: renders documents (evidence: `crates/ahcl-kit-materials/src/project.rs`)
- Project planning → Material application: plans writes (evidence: `crates/ahcl-kit-materials/src/lib.rs`)
- Project planning → Dependency report: includes report (evidence: `crates/ahcl-kit-materials/src/lib.rs`)
- Project planning → Third-party evidence: uses inventory (evidence: `crates/ahcl-kit-materials/src/lib.rs`)
- Third-party evidence → Dependency report: reads evidence (evidence: `crates/ahcl-kit-materials/src/third_party.rs`)
- Cargo adapter → Cargo settings: uses settings (evidence: `crates/ahcl-kit-cargo/src/adapter.rs`)
- Cargo adapter → Cargo graph: resolves graph (evidence: `crates/ahcl-kit-cargo/src/adapter.rs`)
- Cargo adapter → Cargo evidence recovery: recovers evidence (evidence: `crates/ahcl-kit-cargo/src/adapter.rs`)
- Cargo evidence recovery → Upstream manifests: checks manifests (evidence: `crates/ahcl-kit-cargo/src/upstream.rs`)
- Cargo evidence recovery → Upstream URL checks: checks URLs (evidence: `crates/ahcl-kit-cargo/src/upstream.rs`)
- JavaScript adapter → Normalized JS graph: normalizes graph (evidence: `crates/ahcl-kit-javascript/src/adapter.rs`)
- JavaScript adapter → npm lockfiles: parses npm (evidence: `crates/ahcl-kit-javascript/src/adapter.rs`)
- JavaScript adapter → pnpm lockfiles: parses pnpm (evidence: `crates/ahcl-kit-javascript/src/adapter.rs`)
- JavaScript adapter → Yarn lockfiles: parses Yarn (evidence: `crates/ahcl-kit-javascript/src/adapter.rs`)
- JavaScript adapter → Bun lockfiles: parses Bun (evidence: `crates/ahcl-kit-javascript/src/adapter.rs`)
- License download → Official license service: fetches license (evidence: `crates/ahcl-kit-license/src/client.rs`)
- License download → License verification: verifies response (evidence: `crates/ahcl-kit-license/src/client.rs`)
- Safe filesystem → Safe filesystem: provides safe I/O (evidence: `crates/ahcl-kit-fs/src/lib.rs`)
