docs: audit + fix — remove observe CLI refs, correct defaults, fix public API imports, add historical banners
This commit is contained in:
@@ -72,10 +72,10 @@ JSON Schema cannot express this relationship. APOPHIS turns it into an executabl
|
||||
| Mode | Purpose | Default Environments |
|
||||
|---|---|---|
|
||||
| `verify` | Deterministic CI and local contract verification | local, test, CI |
|
||||
| `observe` | Runtime visibility and drift detection without blocking | staging, prod |
|
||||
| `observe` | Programmatic runtime visibility and drift detection without blocking (validated via `doctor --mode observe`) | staging, prod |
|
||||
| `qualify` | Exercise scenarios, stateful flows, and configured chaos checks before release | local, test, staging |
|
||||
|
||||
## Quickstart: 3 Commands
|
||||
## Quickstart
|
||||
|
||||
```bash
|
||||
# 1. Install
|
||||
@@ -99,7 +99,7 @@ See [docs/getting-started.md](docs/getting-started.md) for the full walkthrough.
|
||||
- **Explicit test budget**: Control how many tests run with `runs: 10` in your preset.
|
||||
- **CI-safe default path**: `verify` is deterministic and safe for CI pipelines.
|
||||
- **Machine-readable output**: `--format json-summary` and `--format ndjson-summary` for CI dashboards.
|
||||
- **Production-safe observe path**: `observe` is non-blocking by default. Blocking behavior requires explicit break-glass policy.
|
||||
- **Production-safe observe path**: `observe` is the programmatic runtime plugin (no CLI command). Non-blocking by default. Blocking behavior requires explicit break-glass policy.
|
||||
- **Qualify path gated away from prod**: `qualify` is blocked in production by default.
|
||||
- **Monorepo workspace support**: `--workspace` fans out `verify` and `doctor` across all packages.
|
||||
- **Explicit environment boundaries**: Config rejects unknown keys and unsafe environment mixes.
|
||||
@@ -118,7 +118,7 @@ See [docs/llm-safe-adoption.md](docs/llm-safe-adoption.md) for templates and CI
|
||||
## Full Documentation
|
||||
|
||||
- [Getting Started](docs/getting-started.md) — First route, first verify run, first replay
|
||||
- [CLI Reference](docs/cli.md) — All 7 commands, global flags, exit codes
|
||||
- [CLI Reference](docs/cli.md) — All 6 commands, global flags, exit codes
|
||||
- [Verify Mode](docs/verify.md) — Deterministic contract verification
|
||||
- [Observe Mode](docs/observe.md) — Runtime visibility and drift detection
|
||||
- [Qualify Mode](docs/qualify.md) — Scenarios, stateful testing, chaos
|
||||
|
||||
Reference in New Issue
Block a user