Operate Forge Projects

Treat project state as a set of related signals rather than a single running flag.

Inspect inventory

aurum list --server prod
aurum status --server prod
aurum status signal-watch --server prod

status distinguishes installation, desired lifecycle state, physical process state, runtime availability, and health. A process can be running while its runtime endpoint is degraded.

Read logs

aurum logs signal-watch --server prod
aurum logs signal-watch --server prod --tail
aurum logs signal-watch --server prod --journal

--tail follows the project runtime log. --journal selects the managed service journal instead.

Stop a version

aurum stop signal-watch --server prod --version 0.0.1 --wait

Use --timeout-ms when automation needs a bounded convergence wait. A successful command submission is not the same as a converged process state; verify with status.

Operate in Terminal

Terminal’s Projects view provides search, state filters, refresh, start, stop, and restart actions. Use the project Summary for product metrics and Inspect for live resource-level diagnosis.

Escalation order

When a project is unhealthy:

  1. check Forge /health and /doctor;

  2. inspect the project’s desired and process states;

  3. confirm the runtime endpoint and capabilities;

  4. read project logs, then managed journal logs;

  5. check resource freshness and ClickHouse history separately.

See Troubleshooting for symptom-based checks.