5.0 KiB
5.0 KiB
Requirements Checklist: Spec 418 - Coverage v2 Operator Surface
Candidate And Dependencies
- Candidate is user-provided, not auto-selected from an empty active candidate queue.
- Spec 414 is completed/validated dependency context only.
- Spec 415 is completed/validated dependency context only.
- Spec 417 is completed/validated dependency context only.
- No existing
418-coverage-v2-operator-surfacespec directory was found before creation. - Scope is limited to one internal operator readiness surface.
- No application implementation was performed during preparation.
Scope
- Spec 418 depends on Coverage v2 kernel/capture/identity.
- Spec 418 adds one operator-only read surface.
- Spec 418 does not activate customer-facing Coverage v2 truth.
- Spec 418 does not convert Evidence Overview, Review Packs, Reports, Restore, Baseline Compare, or Customer Review Workspace.
- Spec 418 does not add capture/start actions.
- Deferred Coverage v2 cutover/removal and customer activation are listed as follow-up work.
Product Surface
- Product Surface Impact is declared.
- Surface is Secondary Context Surface.
- Surface is Read-only Registry / Report Surface.
- Surface is Native Surface unless implementation documents an approved exception.
- Inspect/open model uses a linked primary column instead of a duplicate View/Inspect row action.
- Primary operator question is explicit.
- Default-visible truth is explicit.
- Diagnostics are secondary/disclosed.
- Raw/support evidence is hidden.
- Browser proof is required.
- Product Surface table-count exception is documented and internal-only.
- Product Surface table-count exception is classified as a PSC Technical Annex surface-budget exception, with UI-EX-001 remaining
nonefor native Filament implementation. - Human Product Sanity questions are explicit.
docs/product/standards/list-surface-review-checklist.mdis required for implementation close-out.
Ownership / RBAC
- No
tenant_idinternal ownership. - Surface scopes by workspace and managed environment.
- Provider connection filters are same-scope.
- Non-member gets 404.
- No environment entitlement gets 404.
- Member without capability gets 403.
- Authorized actor can view.
- Workspace-wide aggregation, if implemented, is limited to entitled environments.
Data / Render
- Page render is DB-only.
- No Graph/TCM/provider calls during render.
- No capture action.
- No remote calls in table columns, badges, filters, or diagnostics.
- No persisted UI-only summary table unless the spec is amended with proportionality proof.
- Narrow indexes are allowed only with documented query path.
- Top activation blocker ordering is deterministic.
Vocabulary
- Shows Coverage level.
- Shows Evidence state.
- Shows Identity state.
- Shows Claim state.
- Shows Source class.
- Shows Supported scope.
- Status-like rendered values use
BadgeCatalog/BadgeRendereror a central BadgeDomain mapping. - Does not show Evidence gaps.
- Does not show Raw gaps.
- Does not show Primary gaps.
- Does not show policy_record_missing.
- Does not show foundation_not_policy_backed.
- Does not show meta_fallback.
- Does not show ambiguous_match.
- Does not show old v1 gap reason codes as active UI truth.
Claim Safety
- No unscoped 100% claim.
- No broad Microsoft 365 coverage claim.
- No certified claim unless exact internal guard allows and the label remains internal.
- No restore-ready claim.
- No customer-ready proof claim.
- Claim state labels are internal/operator-facing.
Redaction
- Raw payload hidden.
- Normalized payload hidden by default.
- Permission context raw JSON hidden.
- Tokens, secrets, authorization headers, cookies, private keys, certificates, raw provider responses, stack traces, and PII absent.
- OperationRun diagnostics are secondary and authorized.
- Evidence hash is allowed if safe.
Tests
- Unit tests cover read model, summary, blockers, display mapping, and no-old-label emissions.
- Feature tests cover authorization, render, redaction, no-legacy, no-remote, OperationRun links, and provider scope.
- Browser smoke covers rendered UI.
- No real Graph/TCM/provider calls are allowed.
- Test lane impact is documented.
Spec Readiness Gate
spec.mdexists.plan.mdexists.tasks.mdexists.- Requirements are bounded and testable.
- Plan identifies likely affected repo surfaces.
- Tasks are ordered, small, verifiable, and include validation.
- Product Surface, RBAC, workspace/provider isolation, OperationRun, evidence, provider boundary, no-legacy, and test governance are addressed.
- No open question blocks safe implementation.
Gate Results
- Candidate Selection Gate: PASS.
- Spec Readiness Gate: PASS for preparation; implementation must still follow
tasks.md.