# sanjayvasudevan-c/java-project architecture

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

- Interactive diagram: https://gitdiagram.com/sanjayvasudevan-c/java-project
- Repository: https://github.com/sanjayvasudevan-c/java-project

## Overview

SwarmCron is a local-first peer-to-peer cron scheduler. Jobs are configured or edited through the API, replicated in a CRDT registry, assigned through a membership-driven hash ring, scheduled and executed with leases/retries, and recorded for crash recovery. Nodes discover peers through SWIM gossip and elect a leader for fencing tokens; each node also serves a live dashboard. The graph reflects README capabilities and shown source references; unsampled wiring is omitted or marked unverified.

Main entry points: [`src/com/swarmcron/Main.java`](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/Main.java) (Node bootstrap), [`src/com/swarmcron/exec/JobExecutor.java`](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/exec/JobExecutor.java) (Job executor), [`src/com/swarmcron/cluster/Membership.java`](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/Membership.java) (Membership table), [`src/com/swarmcron/http/HttpApiServer.java`](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/HttpApiServer.java) (HTTP API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and configuration"]
  node_main["Node bootstrap<br/>[Main.java]"]
  node_config["Node config<br/>[ConfigParser.java]"]
  node_job_spec["Job specification<br/>[JobSpec.java]"]
end

subgraph group_cluster["Cluster coordination"]
  node_failure["SWIM failure detection"]
  node_membership["Membership table<br/>[Membership.java]"]
  node_gossip["Gossip engine<br/>[GossipEngine.java]"]
  node_transport["Peer transport<br/>[UdpTransport.java]"]
  node_ring["Ownership ring<br/>[RingManager.java]"]
  node_election["Leader election<br/>[RaftLite.java]"]
end

subgraph group_jobs["Job lifecycle"]
  node_registry[("Job CRDT registry<br/>[JobRegistry.java]")]
  node_anti_entropy["Registry sync"]
  node_cron["Cron scheduling"]
  node_timer["Timer wheel<br/>[TimerWheel.java]"]
  node_executor["Job executor<br/>[JobExecutor.java]"]
  node_process["Process runner<br/>[ProcessRunner.java]"]
end

subgraph group_durability["Durability"]
  node_wal[("Write-ahead log<br/>[WriteAheadLog.java]")]
  node_recovery["Crash recovery<br/>[Recovery.java]"]
end

subgraph group_interface["HTTP interface"]
  node_http["HTTP API server<br/>[HttpApiServer.java]"]
  node_dashboard["Live dashboard<br/>[DashboardPage.java]"]
  node_sse["Event stream<br/>[SseHub.java]"]
end

node_operator(("Operator"))

node_operator -->|"starts node"| node_main
node_main -->|"loads config"| node_config
node_main -->|"loads seed jobs"| node_job_spec
node_main -->|"starts detector"| node_failure
node_main -->|"starts membership"| node_membership
node_main -->|"starts gossip"| node_gossip
node_main -->|"starts election"| node_election
node_main -->|"starts executor"| node_executor
node_main -->|"starts ring"| node_ring
node_failure -->|"updates states"| node_membership
node_failure -->|"sends probes"| node_transport
node_gossip -->|"exchanges updates"| node_membership
node_ring -->|"reads alive nodes"| node_membership
node_ring -->|"listens for changes"| node_membership
node_election -->|"reads voters"| node_membership
node_election -->|"sends vote messages"| node_transport
node_operator -->|"manages jobs"| node_http
node_http -->|"serves page"| node_dashboard
node_http -->|"streams events"| node_sse
node_http -->|"reads and edits jobs"| node_registry
node_registry -.->|"syncs peer state"| node_anti_entropy
node_executor -->|"reads job state"| node_registry
node_executor -->|"checks ownership"| node_ring
node_executor -->|"requests fencing"| node_election
node_executor -->|"calculates next fire"| node_cron
node_executor -->|"schedules jobs"| node_timer
node_executor -.->|"launches command"| node_process
node_executor -.->|"records runs"| node_wal
node_recovery -.->|"replays records"| node_wal

click node_main "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/Main.java"
click node_config "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/config/ConfigParser.java"
click node_job_spec "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/config/JobSpec.java"
click node_failure "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/FailureDetector.java"
click node_membership "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/Membership.java"
click node_gossip "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/GossipEngine.java"
click node_transport "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/net/UdpTransport.java"
click node_ring "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/hash/RingManager.java"
click node_election "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/election/RaftLite.java"
click node_registry "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/state/JobRegistry.java"
click node_anti_entropy "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/state/AntiEntropySync.java"
click node_cron "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/schedule/CronExpression.java"
click node_timer "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/schedule/TimerWheel.java"
click node_executor "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/exec/JobExecutor.java"
click node_process "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/exec/ProcessRunner.java"
click node_wal "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/store/WriteAheadLog.java"
click node_recovery "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/store/Recovery.java"
click node_http "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/HttpApiServer.java"
click node_dashboard "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/DashboardPage.java"
click node_sse "https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/SseHub.java"

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_main,node_config,node_job_spec toneBlue
class node_failure,node_membership,node_gossip,node_transport,node_ring,node_election toneAmber
class node_registry,node_anti_entropy,node_cron,node_timer,node_executor,node_process toneMint
class node_wal,node_recovery toneRose
class node_http,node_dashboard,node_sse,node_operator toneIndigo
```

## Components

### Startup and configuration

- [Node bootstrap](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/Main.java): `src/com/swarmcron/Main.java`
- [Node config](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/config/ConfigParser.java): `src/com/swarmcron/config/ConfigParser.java`
- [Job specification](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/config/JobSpec.java): `src/com/swarmcron/config/JobSpec.java`

### Cluster coordination

- [SWIM failure detection](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/FailureDetector.java): `src/com/swarmcron/cluster/FailureDetector.java`
- [Membership table](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/Membership.java): `src/com/swarmcron/cluster/Membership.java`
- [Gossip engine](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/cluster/GossipEngine.java): `src/com/swarmcron/cluster/GossipEngine.java`
- [Peer transport](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/net/UdpTransport.java): `src/com/swarmcron/net/UdpTransport.java`
- [Ownership ring](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/hash/RingManager.java): `src/com/swarmcron/hash/RingManager.java`
- [Leader election](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/election/RaftLite.java): `src/com/swarmcron/election/RaftLite.java`

### Job lifecycle

- [Job CRDT registry](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/state/JobRegistry.java): `src/com/swarmcron/state/JobRegistry.java`
- [Registry sync](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/state/AntiEntropySync.java): `src/com/swarmcron/state/AntiEntropySync.java`
- [Cron scheduling](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/schedule/CronExpression.java): `src/com/swarmcron/schedule/CronExpression.java`
- [Timer wheel](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/schedule/TimerWheel.java): `src/com/swarmcron/schedule/TimerWheel.java`
- [Job executor](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/exec/JobExecutor.java): `src/com/swarmcron/exec/JobExecutor.java`
- [Process runner](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/exec/ProcessRunner.java): `src/com/swarmcron/exec/ProcessRunner.java`

### Durability

- [Write-ahead log](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/store/WriteAheadLog.java): `src/com/swarmcron/store/WriteAheadLog.java`
- [Crash recovery](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/store/Recovery.java): `src/com/swarmcron/store/Recovery.java`

### HTTP interface

- [HTTP API server](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/HttpApiServer.java): `src/com/swarmcron/http/HttpApiServer.java`
- [Live dashboard](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/DashboardPage.java): `src/com/swarmcron/http/DashboardPage.java`
- [Event stream](https://github.com/sanjayvasudevan-c/java-project/blob/claude/swarmcron-prototype-i9p08n/src/com/swarmcron/http/SseHub.java): `src/com/swarmcron/http/SseHub.java`

### Other components

- **Operator**

## Connections

- Operator → Node bootstrap: starts node (evidence: `README.md`)
- Node bootstrap → Node config: loads config (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → Job specification: loads seed jobs (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → SWIM failure detection: starts detector (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → Membership table: starts membership (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → Gossip engine: starts gossip (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → Leader election: starts election (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → Job executor: starts executor (evidence: `src/com/swarmcron/Main.java`)
- Node bootstrap → Ownership ring: starts ring (evidence: `src/com/swarmcron/Main.java`)
- SWIM failure detection → Membership table: updates states (evidence: `src/com/swarmcron/cluster/FailureDetector.java`)
- SWIM failure detection → Peer transport: sends probes (evidence: `src/com/swarmcron/cluster/FailureDetector.java`)
- Gossip engine → Membership table: exchanges updates (evidence: `src/com/swarmcron/cluster/GossipEngine.java`)
- Ownership ring → Membership table: reads alive nodes (evidence: `src/com/swarmcron/hash/RingManager.java`)
- Ownership ring → Membership table: listens for changes (evidence: `src/com/swarmcron/hash/RingManager.java`)
- Leader election → Membership table: reads voters (evidence: `src/com/swarmcron/election/RaftLite.java`)
- Leader election → Peer transport: sends vote messages (evidence: `src/com/swarmcron/election/RaftLite.java`)
- Operator → HTTP API server: manages jobs (evidence: `README.md`)
- HTTP API server → Live dashboard: serves page (evidence: `src/com/swarmcron/http/HttpApiServer.java`)
- HTTP API server → Event stream: streams events (evidence: `src/com/swarmcron/http/HttpApiServer.java`)
- HTTP API server → Job CRDT registry: reads and edits jobs (evidence: `src/com/swarmcron/http/HttpApiServer.java`)
- Job CRDT registry → Registry sync: syncs peer state (evidence: `src/com/swarmcron/state/AntiEntropySync.java`)
- Job executor → Job CRDT registry: reads job state (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Job executor → Ownership ring: checks ownership (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Job executor → Leader election: requests fencing (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Job executor → Cron scheduling: calculates next fire (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Job executor → Timer wheel: schedules jobs (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Job executor → Process runner: launches command (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Job executor → Write-ahead log: records runs (evidence: `src/com/swarmcron/exec/JobExecutor.java`)
- Crash recovery → Write-ahead log: replays records (evidence: `src/com/swarmcron/store/Recovery.java`)
