Files
railiance-cluster/.claude/rules/stack-and-commands.md
tegwick b3b0c3e3ff
Some checks failed
railiance-tests / smoke (push) Has been cancelled
Repo hygiene + new workplans (RAIL-BS-WP-0008/0009)
- Add RAIL-BS-WP-0008 (activity-core WP-0016 deploy) and RAIL-BS-WP-0009
  (admin-sync smoke) from inbox asks 87952ff1 / aa8b7986
- Archive finished workplans to workplans/archived/ per ADR-001 convention;
  normalize frontmatter statuses (completed/done -> finished)
- Fill stack-and-commands.md, complete repo-boundary.md, refresh SCOPE
  Current State, add docs/operator-runbook.md for production-touching targets

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 00:02:36 +02:00

23 lines
1.3 KiB
Markdown

## Stack
- **Language:** Bash tooling (`tools/cmd/`) orchestrating kubectl/Helm over SSH
- **Key deps:** k3s on railiance01 (COULOMBCORE), Helm, SOPS/age for secrets, State Hub REST for evidence notes
- **Execution model:** commands run from the workstation; cluster access is `ssh railiance01` (most `tools/cmd/*` accept a `CLUSTER_HOST` override)
## Dev Commands
```bash
make help # list all targets
make preflight # pre-migration safety gate — run before cluster work
make smoke # Kubernetes smoke tests
make test-ha-failover # HA failover test (kills primary PG pod, asserts recovery)
sudo make backup # age-encrypted backup: k3s state + Helm values + kubeconfig
make restore # list backups + restore guide
make verify-activity-core # reconcile activity-core runtime + probe evidence
make reconcile-activity-core-llm-connect # llm-connect reconcile + non-secret gate checks
```
Production-touching targets (deploy/reconcile/backup) need operator approval —
see `docs/operator-runbook.md`. There is no test suite or linter in this repo;
validation is the preflight + smoke targets against the live cluster.