# dinotaurent/jbreak-shell architecture

> Architecture diagram of the GitHub repository dinotaurent/jbreak-shell, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dinotaurent/jbreak-shell
- Repository: https://github.com/dinotaurent/jbreak-shell

## Overview

JBreak-shell is a terminal break-reminder application. A user runs `start`; the command repeatedly delegates to the service, which times a work session, prompts for a break (or enforces one after two skipped breaks), and reports session status. The service also manages break timing, terminal interaction, sound, and platform notifications. The excerpts show these runtime responsibilities; Spring’s component-discovery wiring is not shown, so that relationship is marked unverified.

Main entry points: [`src/main/java/dinotaurent/jbreakshell/service/BreakService.java`](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/service/BreakService.java) (Break service), [`src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java`](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java) (Break commands), [`src/main/java/dinotaurent/jbreakshell/JbreakShellApplication.java`](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/JbreakShellApplication.java) (Spring Boot app), [`src/main/java/dinotaurent/jbreakshell/dto/BreakStatus.java`](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/dto/BreakStatus.java) (Break status)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Shell interface"]
  node_application["Spring Boot app"]
  node_commands["Break commands<br/>[BreakCommands.java]"]
end

subgraph group_breaks["Break workflow"]
  node_service["Break service<br/>[BreakService.java]"]
  node_status["Break status<br/>[BreakStatus.java]"]
end

subgraph group_runtime["Runtime integrations"]
  node_terminal["Terminal and input"]
  node_audio["Audio playback"]
  node_notifications["OS notifications"]
end

node_user(("User"))

node_user -->|"runs commands"| node_commands
node_application -.->|"discovers component"| node_commands
node_commands -->|"starts and reads"| node_service
node_service -->|"creates status"| node_status
node_service -->|"reads and writes"| node_terminal
node_service -->|"plays sound"| node_audio
node_service -->|"sends alerts"| node_notifications

click node_application "https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/JbreakShellApplication.java"
click node_commands "https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java"
click node_service "https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/service/BreakService.java"
click node_status "https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/dto/BreakStatus.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_application,node_commands,node_user toneBlue
class node_service,node_status toneAmber
class node_terminal,node_audio,node_notifications toneMint
```

## Components

### Shell interface

- [Spring Boot app](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/JbreakShellApplication.java): `src/main/java/dinotaurent/jbreakshell/JbreakShellApplication.java`
- [Break commands](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java): `src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java`

### Break workflow

- [Break service](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/service/BreakService.java): `src/main/java/dinotaurent/jbreakshell/service/BreakService.java`
- [Break status](https://github.com/dinotaurent/jbreak-shell/blob/main/src/main/java/dinotaurent/jbreakshell/dto/BreakStatus.java): `src/main/java/dinotaurent/jbreakshell/dto/BreakStatus.java`

### Runtime integrations

- **Terminal and input**
- **Audio playback**
- **OS notifications**

### Other components

- **User**

## Connections

- User → Break commands: runs commands (evidence: `src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java`)
- Spring Boot app → Break commands: discovers component
- Break commands → Break service: starts and reads (evidence: `src/main/java/dinotaurent/jbreakshell/command/BreakCommands.java`)
- Break service → Break status: creates status (evidence: `src/main/java/dinotaurent/jbreakshell/service/BreakService.java`)
- Break service → Terminal and input: reads and writes (evidence: `src/main/java/dinotaurent/jbreakshell/service/BreakService.java`)
- Break service → Audio playback: plays sound (evidence: `src/main/java/dinotaurent/jbreakshell/service/BreakService.java`)
- Break service → OS notifications: sends alerts (evidence: `src/main/java/dinotaurent/jbreakshell/service/BreakService.java`)
