mhoennigandClaude Opus 5
35f06ec1ec
`gitTally` is the name of another product in the git space, so the rename is a precaution; nothing about what the build system does changes. The name follows one rule: `Werkator` where it is prose, capitalized where it is a Kotlin type and its file, lowercase everywhere a machine reads it — the command, packages, paths, configuration keys and values, the Gitea check context. Environment variables keep their convention and are uppercase throughout. Every configuration file is still found under its pre-rename name (`ConfigFiles`): `.gittally.yml` at the repository root, in a build worktree and as committed on a branch, `.git/gittally/.gittally.yml` for the machine layer. The current name wins where both exist, and the old file is then ignored rather than merged — two files side by side are a half-done rename, not a layering. Without the fallback an installation that updated without renaming would not fail: a configuration that is not found leaves every setting at its default, so it would come up looking healthy while having forgotten its credentials and its builds. `docs/werkator-migrationsplan.md` lists what the fallback does not cover and has to be moved by hand — above all the state directory `.git/werkator/`, which holds the build history, the control token and the worktrees, and has no fallback of its own. `docs/migration-from-legacy.md` is deleted with this: it mapped the legacy script's environment variables, and every host it addressed has long since moved to the YAML configuration. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
70 lines
1.8 KiB
Markdown
70 lines
1.8 KiB
Markdown
# Werkator
|
|
|
|
Lightweight, declarative and highly opinionated software build system (CI/CD).
|
|
|
|
## Documentation
|
|
|
|
- [docs/configuration.md](docs/configuration.md) — configuration reference
|
|
- [docs/bootstrapping.md](docs/bootstrapping.md) — initializing a repository with `init`
|
|
- [docs/deployment.md](docs/deployment.md) — running Werkator as a systemd service behind a reverse proxy
|
|
|
|
## Legacy Script
|
|
|
|
`legacy/werkator` (bash) is **deprecated** and kept only as a behavioral reference for the rewrite.
|
|
Do not use it for new installations.
|
|
|
|
## Developer Setup
|
|
|
|
Source `.envrc` to add `tools/` to your `PATH`, or install [direnv](#direnv) to have this done automatically on `cd`:
|
|
|
|
```bash
|
|
source .envrc
|
|
```
|
|
|
|
Common tasks:
|
|
|
|
```bash
|
|
./gradlew build # compile and run all checks
|
|
./gradlew test # run tests
|
|
./gradlew ktlintFormat # auto-format Kotlin sources
|
|
./gradlew ktlintCheck # check formatting (also runs as part of build)
|
|
|
|
adr-status # show all architecture decisions at a glance
|
|
```
|
|
|
|
|
|
|
|
### direnv
|
|
|
|
[direnv](https://direnv.net/) sources `.envrc` automatically whenever you enter the repository and unloads it when you leave.
|
|
|
|
```bash
|
|
# Ubuntu
|
|
sudo apt install direnv
|
|
|
|
# add to ~/.bashrc or ~/.zshrc
|
|
eval "$(direnv hook bash)" # or: eval "$(direnv hook zsh)"
|
|
```
|
|
|
|
Trust the project's `.envrc` once per clone:
|
|
|
|
```bash
|
|
direnv allow
|
|
```
|
|
|
|
### Tools (`tools/`)
|
|
|
|
| Command | Description |
|
|
|---|---|
|
|
| `adr-status` | List all Architecture Decision Records with their status and decision summary |
|
|
|
|
## Architecture Decision Records
|
|
|
|
Major technical decisions are documented as ADRs in [`docs/adrs/`](docs/adrs/).
|
|
|
|
```bash
|
|
adr-status # show all decisions at a glance
|
|
```
|
|
|
|
New ADRs follow the template at [`docs/adrs/0000-00-00.adr-template.md`](docs/adrs/0000-00-00.adr-template.md).
|