docs: remove observe CLI references — observe is programmatic only

docs/cli.md

@@ -85,26 +85,6 @@ apophis verify --profile quick --format json-summary
 apophis verify --profile quick --format ndjson-summary
 ```
 
-### `apophis observe`
-
-Validate runtime observe configuration and reporting setup.
-
-```bash
-apophis observe --profile staging-observe
-```
-
-| Flag | Description |
-|---|---|
-| `--profile <name>` | Profile name from config |
-| `--check-config` | Only validate config, do not activate |
-
-**Examples:**
-
-```bash
-<!-- smoke-test -->
-apophis observe --help
-```
-
 ### `apophis qualify`
 
 Run scenario, stateful, protocol, or chaos-driven qualification.

docs/observe.md

@@ -2,11 +2,9 @@
 
 Runtime visibility and drift detection without blocking by default.
 
-APOPHIS observe has two paths:
+APOPHIS observe is **programmatic only**. Register the APOPHIS plugin with `observe.enabled: true` and `observe.sinks` to emit contract pass/violation/error events from live traffic without blocking responses. Sampling controls the fraction of observed requests.
 
-1. **CLI `apophis observe`**: Validates observe configuration readiness (policy, sinks, sampling, safety boundaries). Introduces no service process or runtime hooks. Use this for CI config validation before deployment.
-
-2. **Programmatic runtime observation**: Register the APOPHIS plugin with `observe.enabled: true` and `observe.sinks` to emit contract pass/violation/error events from live traffic without blocking responses. Sampling controls the fraction of observed requests.
+Use `apophis doctor --mode observe` to validate your observe configuration (sinks, sampling, blocking, production safety) before deploying.
 
 ## When to Use It
 
@@ -95,15 +93,9 @@ profiles: {
 }
 ```
 
-## `--check-config` Flag
+## Config Validation
 
-Validate config without activating observe mode:
-
-```bash
-apophis observe --profile staging-observe --check-config
-```
-
-This is useful in CI to ensure observe config is valid before deployment.
+Validate your observe config before deployment with doctor:
 
 ## Exit Codes
 
@@ -161,10 +153,7 @@ export default {
 
 ## Programmatic Runtime Activation
 
-The CLI only validates configuration. To activate runtime observation, register
-APOPHIS with observe options in your application before routes are registered.
-Observe remains active in production because it is non-blocking; blocking
-runtime validation still stays disabled in production.
+Register APOPHIS with observe options in your application before routes are registered.
 
 ```typescript
 import Fastify from 'fastify'
@@ -248,9 +237,9 @@ plug in any backend. Common patterns:
 
 ## Monorepo Validation
 
-For monorepos, use `apophis doctor --workspace` to validate observe configuration across all workspace packages. `observe` itself does not support `--workspace`; use `doctor` to check config in each package.
+For monorepos, use `apophis doctor --mode observe --workspace` to validate observe configuration across all workspace packages.
 
 ## Mode Mismatch
 
-Profiles configured for `verify` mode will be rejected by `apophis observe`. Only profiles with `mode: 'observe'` are valid.
+Profiles configured for `verify` mode will be rejected at runtime. Only profiles with `mode: 'observe'` are valid for observe mode.
 ```

docs/troubleshooting.md

@@ -139,7 +139,7 @@ APOPHIS classifies failures into six categories. Lower categories take precedenc
 
 **Prevention**
 - Use `apophis verify --seed <number>` for deterministic runs.
-- Run `apophis observe` in CI to catch drift before it becomes a failure.
+- Run `apophis doctor --mode observe` in CI to catch config drift before deployment.
 - Keep test data isolated and reset between runs.
 
 ---