# Operator access runbook Restricted operator commands for moderation and privacy (BUC-006/BUC-007). There is no public admin HTTP path: privileged work runs through the `ops` CLI over controlled operator access only. ## Access model - Identity: `--operator ` flag or `ANPFUEL_OPERATOR_ID` environment. Anonymous invocations are denied before any work (`ErrUnauthorized`). - Network: CLI runs on the operator machine with direct database access; the public API exposes no admin routes (`/health/*` and `/metrics` carry no admin capability; metrics stay on the private network). - Credentials: database/R2 credentials follow the standard startup config (never printed, never committed). Rotate per incident procedure; revoke operator access by removing the identity at the access layer. - MFA and allowlists live at the access layer per SECURITY_PRIVACY (admin CLI over restricted operator access with MFA); this runbook does not invent their configuration. ## Commands All commands append actor/reason/policy audit rows and move the case exactly once per action. Raw facts are never edited; appeals create new actions, cases or reviewed facts. ```sh # Triage / resolve / dismiss any case (audit + status + recompute job, atomically) go run ./cmd/ops moderation act --case --action REVIEW --reason "triage note" --operator op-7 # Reviewed observation invalidation: audit INVALIDATE, then the community # VALIDATED→REJECTED decision bound to the same case ID plus its # consensus recompute job (observation must be VALIDATED) go run ./cmd/ops moderation invalidate --case --reason "confirmed fake price" --operator op-7 # Reviewed contributor block: audit BLOCK, then the trust BLOCKED verdict # bound to the same case ID (contributor cases only) go run ./cmd/ops moderation block --case --reason "reviewed Sybil ring" --operator op-7 # Privileged evidence review: 60 s owner-independent download bound to an # actionable case referencing exactly that evidence. The signed URL goes # to stdout for the operator terminal only; the audit line on stderr # carries actor/case/evidence/timestamp, never the URL. go run ./cmd/ops evidence-url --case --evidence-id --operator op-7 ``` Action/target rules: `INVALIDATE` on OBSERVATION/DISPUTE/EVIDENCE, `BLOCK` on CONTRIBUTOR, `REVIEW`/`RESOLVE`/`DISMISS` on any target. Closed cases never reopen; a two-step command that fails downstream reports `audit recorded` so the follow-up is an audited retry, never a silent drop. ## Appeal and recovery - A disputed decision is appealed by recording a new action (e.g. `RESOLVE` with the review rationale) or by submitting a new reviewed observation referencing the old one; the original rows stay intact. - Revoke a compromised operator identity at the access layer, then record `DISMISS`/`RESOLVE` corrections with the replacement identity. - Projection rebuilds replay from the retained audit ledger; no manual SQL edits (unaudited manual SQL is a finding, not a procedure). ## Retention and privacy notes - Audit rows (`moderation_actions`) carry actor/action/reason only: no media, GPS, IPs or URLs (B-BR-011). Accountability retention per SECURITY_PRIVACY (12 months initially). - Evidence downloads expire in 60 s; expired URLs are not retried, a new audited command mints a fresh one while the case stays actionable. - Export/erasure workflows (BUC-007) land in P07-T03…T05 and reuse this access model; losing the contributor key never discloses data. ## Document-free fuel quality review (FQ-11) Only restricted operators may inspect private claim/appeal text. Run in a private terminal; never redirect inspection output into central logs or public artifacts. There is no business portal or anonymous admin endpoint. ```sh # Bounded queue returns opaque case/target references; --after paginates cases. go run ./cmd/ops quality queue --operator op-7 # Inspect exact revision, current claim and any current appeal. go run ./cmd/ops quality inspect --target --operator op-7 # Private date/fuel page; counts have scope PAGE and are never station totals. go run ./cmd/ops quality group --station --fuel ETHANOL --day 2026-10-13 --operator op-7 # Review a USER_CLAIM, never certify purchase or chemical quality. go run ./cmd/ops moderation act --case --action RESOLVE --reason CLAIM_RECORDED --operator op-7 ``` Closed quality reason pairs: REVIEW/TRIAGE; RESOLVE/CLAIM_RECORDED; DISMISS/DUPLICATE, INSUFFICIENT_EVIDENCE or UNSUPPORTED_LINK; INVALIDATE/ABUSE or PRIVACY. PRIVACY hides and clears body/appeal text. Stale, legacy-unbound or erased targets only accept DISMISS/SUPERSEDED without changing current reports. Owner appeals create a new revision and separate case; old decisions cannot affect it. Decisions, report changes, audit and durable intent commit together. Official facts and scores stay unchanged; account counts never prove independent purchases. Document-supported features remain future D-held.