# ssajaia/dios architecture

> Architecture diagram of the GitHub repository ssajaia/dios, 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/ssajaia/dios
- Repository: https://github.com/ssajaia/dios

## Overview

dios is a small command-line directory synchronizer. A user invokes `sync` with source and destination paths, optionally in dry-run mode; the CLI parses arguments and starts synchronization. The sync logic validates paths, recursively reconciles entries, reports additions/changes/removals, compares file contents, and copies or removes entries unless dry-run is enabled. The README is empty, so this map is based on the sampled source; filesystem interactions are represented as one external resource.

Main entry points: [`sync.go`](https://github.com/ssajaia/dios/blob/main/sync.go) (Entry reconciliation), [`main.go`](https://github.com/ssajaia/dios/blob/main/main.go) (Command dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("CLI user"))
node_entry["Program entry<br/>[main.go]"]
node_dispatch["Command dispatch<br/>[main.go]"]
node_arguments["Sync arguments<br/>[main.go]"]
node_sync["Sync coordinator<br/>[sync.go]"]
node_validation["Path validation<br/>[sync.go]"]
node_reconcile["Entry reconciliation<br/>[sync.go]"]
node_cleanup["Extra removal<br/>[sync.go]"]
node_compare["File comparison<br/>[sync.go]"]
node_copy["File copying<br/>[sync.go]"]
node_filesystem[("Local filesystem")]

node_user -->|"invokes"| node_entry
node_entry -->|"calls"| node_dispatch
node_dispatch -->|"dispatches"| node_arguments
node_dispatch -->|"starts sync"| node_sync
node_sync -->|"validates paths"| node_validation
node_sync -->|"reconciles entries"| node_reconcile
node_sync -->|"removes extras"| node_cleanup
node_validation -->|"inspects paths"| node_filesystem
node_reconcile -->|"recurses into"| node_reconcile
node_reconcile -->|"removes extras"| node_cleanup
node_reconcile -->|"compares files"| node_compare
node_reconcile -->|"copies files"| node_copy
node_reconcile -->|"reads and mutates"| node_filesystem
node_cleanup -->|"reads and removes"| node_filesystem
node_compare -->|"reads files"| node_filesystem
node_copy -->|"copies data"| node_filesystem

click node_entry "https://github.com/ssajaia/dios/blob/main/main.go"
click node_dispatch "https://github.com/ssajaia/dios/blob/main/main.go"
click node_arguments "https://github.com/ssajaia/dios/blob/main/main.go"
click node_sync "https://github.com/ssajaia/dios/blob/main/sync.go"
click node_validation "https://github.com/ssajaia/dios/blob/main/sync.go"
click node_reconcile "https://github.com/ssajaia/dios/blob/main/sync.go"
click node_cleanup "https://github.com/ssajaia/dios/blob/main/sync.go"
click node_compare "https://github.com/ssajaia/dios/blob/main/sync.go"
click node_copy "https://github.com/ssajaia/dios/blob/main/sync.go"

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_user toneBlue
class node_entry,node_dispatch,node_arguments,node_sync,node_validation,node_reconcile,node_cleanup,node_compare,node_copy toneTeal
class node_filesystem toneAmber
```

## Components

### Other components

- **CLI user**
- [Program entry](https://github.com/ssajaia/dios/blob/main/main.go): `main.go`
- [Command dispatch](https://github.com/ssajaia/dios/blob/main/main.go): `main.go`
- [Sync arguments](https://github.com/ssajaia/dios/blob/main/main.go): `main.go`
- [Sync coordinator](https://github.com/ssajaia/dios/blob/main/sync.go): `sync.go`
- [Path validation](https://github.com/ssajaia/dios/blob/main/sync.go): `sync.go`
- [Entry reconciliation](https://github.com/ssajaia/dios/blob/main/sync.go): `sync.go`
- [Extra removal](https://github.com/ssajaia/dios/blob/main/sync.go): `sync.go`
- [File comparison](https://github.com/ssajaia/dios/blob/main/sync.go): `sync.go`
- [File copying](https://github.com/ssajaia/dios/blob/main/sync.go): `sync.go`
- **Local filesystem**

## Connections

- CLI user → Program entry: invokes (evidence: `main.go`)
- Program entry → Command dispatch: calls (evidence: `main.go`)
- Command dispatch → Sync arguments: dispatches (evidence: `main.go`)
- Command dispatch → Sync coordinator: starts sync (evidence: `main.go`)
- Sync coordinator → Path validation: validates paths (evidence: `sync.go`)
- Sync coordinator → Entry reconciliation: reconciles entries (evidence: `sync.go`)
- Sync coordinator → Extra removal: removes extras (evidence: `sync.go`)
- Path validation → Local filesystem: inspects paths (evidence: `sync.go`)
- Entry reconciliation → Entry reconciliation: recurses into (evidence: `sync.go`)
- Entry reconciliation → Extra removal: removes extras (evidence: `sync.go`)
- Entry reconciliation → File comparison: compares files (evidence: `sync.go`)
- Entry reconciliation → File copying: copies files (evidence: `sync.go`)
- Entry reconciliation → Local filesystem: reads and mutates (evidence: `sync.go`)
- Extra removal → Local filesystem: reads and removes (evidence: `sync.go`)
- File comparison → Local filesystem: reads files (evidence: `sync.go`)
- File copying → Local filesystem: copies data (evidence: `sync.go`)
