commands

Documentation

Overview

Package cmd wires the `ronja` command tree.

Design constraints, in priority order:

1. An agent must be able to drive this without a TTY. Every command takes --json, never prompts when stdin is not a terminal, and exits non-zero on failure with the reason on stderr.
2. A human must find it pleasant. Human output is short, and the next action is always spelled out.

Index

• Constants
• Variables
• func Execute()

Constants

const (
	DefaultWaitInterval = 3 * time.Second
	DefaultWaitTimeout  = 5 * time.Minute
)

DefaultWaitInterval is the cadence --wait-until polls at.

3s matches what the web app polls a running workflow at, and the interval is EXACT — it does not back off. A caller who names a cadence has said what they want, and a poller that quietly stretched to 30s would make a --wait-interval of 1s a lie. --wait-timeout is what bounds the total cost.

Variables

var Version = "dev"

Version is stamped at build time by the release pipeline:

go install -ldflags "-X github.com/ronjatech/ronja-cli/internal/commands.Version=$(git describe --tags)" ./cmd/ronja

It stays "dev" for a plain `go build` from a checkout, and resolveVersion recovers the real one for `go install ...@version`.

Functions

func Execute

func Execute()