RFC 008: Spec-neutral local and remote validation architecture

[zkwentz]

What & Why

Validation needs one trust model and report contract across local author checks and independent Hub certification. This RFC defines a spec-neutral adapter, plan, executor, report, and remote-lane architecture while keeping the future task workflow in #898 explicit.

Risk & Review Guidance

• Risk level: MEDIUM — architecture-only, but it constrains every implementation layer that follows
• Task class: docs
• Review focus: rfcs/008-local-remote-validation.md:10 for the spec boundary; rfcs/008-local-remote-validation.md:224 for local semantics; rfcs/008-local-remote-validation.md:280 for remote trust boundaries
• Blast radius: A wrong abstraction would couple validation to one package format or overstate what author-run checks prove.

Decisions & Alternatives

• Normalize through trusted spec adapters — rejected making Harbor the core contract because Spec-agnostic task validation: openenv validate-task for external task.md packages (PostTrain Arena / BenchFlow) #898 needs other execution models.
• Separate author reports from certification — local and author-triggered remote runs always remain uncertified.
• Capability-driven skips — rejected silently treating unavailable remote checks as passes.

Verification

• PASS: PYTHONPATH=src:envs .venv/bin/python -m pytest tests/ -q -m 'not integration' — 1,559 passed, 114 skipped, 31 external integration tests deselected on the complete stack.
• PASS: Fork whole-stack CI — 7/7 checks passed, including Python 3.11/3.12, lint, docs, lock validation, and package smoke tests.
• NOT verified: The planned remote coordinator and certification lanes are architectural only.

Scope & Non-Goals

• No coordinator deployment, ACA lane, model evaluation, or task-package CLI is implemented in this PR.

Stack

Base of the 17-PR RFC 008 stack.

Full 17-PR stack

1. #942 RFC 008: Spec-neutral local and remote validation architecture ← current
2. #943 Validation foundation: spec-neutral contracts and adapters
3. #944 Validation policy: spec-aware check registry and planner
4. #945 Validation executor: hardened shared reports and eligibility
5. #946 Local validation API: execution-model-aware profiles
6. #947 CLI: validation profiles and shared reports
7. #948 HF runtime: dedicated sandbox execution mode
8. #949 HF certification: enforce trusted dedicated isolation
9. #950 [RFC 008] Define remote author validation and publish gating
10. #951 Validation: unify CLI reports and add a strict publish profile
11. #952 Validation: add structured author diagnostics and remediation
12. #953 Validation: run author validation in dedicated HF Sandboxes
13. #954 Validation: isolate submitted code in author Sandboxes
14. #955 Validation: bind author reports to policy and source
15. #956 CLI: scaffold publish requirements
16. #957 CLI: gate pushes on staged remote validation
17. #958 Docs: explain local, remote, and publish validation

All upstream PRs remain draft while RFC 008 is under review.