# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
## [0.1.0] - 2026-04-17
### Added
- `init` subcommand generates the complete `.opencode/` structure in one command
- `check` subcommand validates installed files against embedded templates via SHA-256
- `uninstall` subcommand removes manifest-tracked files while preserving user customizations
- `list` subcommand displays all embedded templates with SHA-256 hashes and byte sizes
- `doctor` subcommand diagnoses `bun`, `node`, and `opencode` environment dependencies
- `completions` subcommand generates shell scripts for bash, zsh, fish, powershell, and elvish
- Six canonical templates embedded as static bytes via `rust-embed`: `plugins/ralph.ts`, `commands/ralph-loop.md`, `commands/cancel-ralph.md`, `commands/ralph-help.md`, `package.json`, `.gitignore`
- SHA-256-based idempotency — unchanged files are always reported as `SKIPPED`
- Two-phase `init`: all conflicts detected before any disk writes occur
- Atomic file writes via temp-file-then-rename to prevent partial writes
- Manifest tracking at `.opencode/.manifest.json` with per-file SHA-256, size, and action
- Text, JSON, NDJSON, and quiet output formats via `--output`
- Typed exit codes: 0 (success), 1 (generic), 2 (usage), 3 (conflict), 4 (I/O), 5 (drift-strict), 6 (manifest-missing), 7 (config-parse), 130 (SIGINT)
- `--dry-run` flag for safe simulation without any disk writes
- `--force` flag for authorized overwrite of files that differ from templates
- `--plugin-version` flag to override the embedded `@opencode-ai/plugin` version (default `1.4.7`)
- `--no-package-json` and `--no-gitignore` flags to skip individual template files
- `--keep-state` flag in `uninstall` to preserve `ralph-loop.local.md`
- Structured logging to stderr via `tracing` — stdout always remains machine-readable
- Support for Linux x86_64 and aarch64, macOS x86_64 and aarch64, Windows x86_64
[Unreleased]: https://github.com/daniloaguiarbr/opencode-ralph-loop-cli/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/daniloaguiarbr/opencode-ralph-loop-cli/releases/tag/v0.1.0