Automation Boundaries
The Anuva harness automates deterministic execution while leaving workflow orchestration visible in the Codex App task.
Automated
- Linear issue reads, filtered Ready lists, approved issue creation, supported state changes, comments, and PR/doc links.
- Git repository checks, branch naming, PR creation/inspection/checks/merge, and structured receipts through GitHub CLI.
- MkDocs process management, rebuild waiting, URL calculation, and strict builds.
- Recursive validation that every docs directory has a non-empty
index.mdand no empty documentation directories remain. - Development service start/status/log/stop and the existing named tunnel process.
- Manual aggregate docs build and optional explicit Git commit/push.
Not automated
- Product scope decisions and repository ownership judgment.
- Approval to create issues, merge PRs, complete issues, stop services, or publish.
- Arbitrary shell commands, dynamic YAML steps, or free-form command composition.
- Cloudflare tunnel, DNS route, certificate, Access application/policy/identity provider, and token provisioning, rotation, or deletion.
- Early Users or Production deployment.
- Codex Goals, Symphony, browser-agent testing, and unattended execution.
Guardrails
- Commands are registered in code; there is no runtime operation registry loaded from user-controlled YAML.
- Read operations default to human output and support
--json. - Mutations support
--dry-run, require--confirm, validate current state, and return a receipt with identifiers and links. - Child processes receive argument arrays or safely quoted zx interpolation.
- The CLI redacts tokens and never prints credential-bearing environment values.
- File deletion/copy operations resolve paths and prove they remain under their configured roots before changing anything.