From 2e2b2187b957e9af78797a67ec5c6874615fae02 Mon Sep 17 00:00:00 2001 From: Peter Stone Date: Sun, 8 Feb 2026 21:35:45 -1000 Subject: Initial project: task model, executor, API server, CLI, storage, reporter Claudomator automation toolkit for Claude Code with: - Task model with YAML parsing, validation, state machine (49 tests, 0 races) - SQLite storage for tasks and executions - Executor pool with bounded concurrency, timeout, cancellation - REST API + WebSocket for mobile PWA integration - Webhook/multi-notifier system - CLI: init, run, serve, list, status commands - Console, JSON, HTML reporters with cost tracking Co-Authored-By: Claude Opus 4.6 --- docs/adr/001-language-and-architecture.md | 32 +++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 docs/adr/001-language-and-architecture.md (limited to 'docs/adr/001-language-and-architecture.md') diff --git a/docs/adr/001-language-and-architecture.md b/docs/adr/001-language-and-architecture.md new file mode 100644 index 0000000..99022f1 --- /dev/null +++ b/docs/adr/001-language-and-architecture.md @@ -0,0 +1,32 @@ +# ADR-001: Go with Server + Mobile PWA Architecture + +## Status +Accepted + +## Context +Claudomator needs to capture tasks, dispatch them to Claude Code, and report results. +The primary human interface is a mobile device requiring push notifications and frictionless input. + +## Decision +- **Language**: Go for the backend (CLI + API server) +- **Architecture**: Pipeline with bounded executor pool (goroutines) +- **API**: REST + WebSocket for real-time updates +- **Storage**: SQLite + filesystem (logs, artifacts) +- **Task format**: YAML definitions +- **Mobile**: PWA with Web Push notifications (future phase) + +## Rationale +- Go: single binary, excellent process management (`os/exec`), natural concurrency +- SQLite: zero-dependency, embeddable, queryable metadata +- WebSocket: real-time progress streaming to mobile clients +- REST: simple task creation from any HTTP client (mobile, curl, CI) + +## Alternatives Considered +- **TypeScript/Node.js**: Claude Code SDK exists, but runtime dependency hurts distribution +- **Python**: Good async, but packaging/distribution is painful for CLI tools +- **Rust**: Overkill for this problem domain; slower iteration speed + +## Consequences +- CGo dependency via `go-sqlite3` (requires C compiler for builds) +- Mobile PWA to be built as a separate frontend phase +- Claude Code invoked via CLI flags (`-p`, `--output-format stream-json`), not SDK -- cgit v1.2.3