Evidence Operations

# World-Class Operator Runbook

A single operating page for collecting the remaining human and external evidence. It coordinates action, but does not accept evidence or change the ledger.

Pending 4
Awaiting 4
Ready 0
Source 6/13
Blocked 7
Invalid 0

## Fast Path

1. Run the real external or human work for one evidence item.
2. Generate and fill the matching submission draft.
3. Validate intake and inspect the submission review queue.
4. Refresh the ledger and run the claim guard before making any completion claim.

## Evidence Items

external · awaiting-submission

### Provider Holdout

No evidence packet has been submitted for review.

Owner
  operator with provider credentials
Ledger
  `pending`
Blocked
  `2`
Submission
  `evidence/world_class/submissions/provider-holdout.json`

#### Source Runbook

- YAO_OUTPUT_EVAL_MODEL=gpt-4.1-mini OPENAI_API_KEY=<redacted> python3 scripts/yao.py output-exec --provider-runner openai --timeout-seconds 60
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/provider-holdout.intake.json to evidence/world_class/submissions/provider-holdout.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions

#### Commands

- prepare submission `python3 scripts/yao.py world-class-submission-kit . --evidence-key provider-holdout --output-dir evidence/world_class/submissions`
- validate intake `python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions`
- review queue `python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions`
- refresh ledger `python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions`
- guard claim `python3 scripts/yao.py world-class-claim-guard .`

#### Must Collect

- provider-backed model run
- observed timing
- observed token metadata

#### Success Checks

- reports/output_execution_runs.json summary.model_executed_count > 0
- reports/output_execution_runs.json summary.timing_observed_count > 0
- reports/output_execution_runs.json summary.token_observed_count > 0
- reports/skill_os2_audit.json item provider-holdout status becomes pass

#### Privacy

- Do not commit provider credentials or environment dumps.
- The output execution report records output hashes and aggregate run metadata, not raw provider prompts.

#### Next Source Actions

- Run provider-backed output-exec with real credentials.
- Provider execution should return non-estimated token usage.

#### Source Evidence Snapshot

- Provider model run `model_executed_count: 0 / >0` Run provider-backed output-exec with real credentials.
- Timing observed `timing_observed_count: 10 / >0` Provider execution should record timing metadata.
- Token usage observed `token_observed_count: 0 / >0` Provider execution should return non-estimated token usage.

human · awaiting-submission

### Human Adjudication

No evidence packet has been submitted for review.

Owner
  human reviewer
Ledger
  `pending`
Blocked
  `2`
Submission
  `evidence/world_class/submissions/human-adjudication.json`

#### Source Runbook

- python3 scripts/yao.py output-review-kit --write-template
- Open reports/output_review_kit.md and choose A or B for each pair without opening the answer key.
- python3 scripts/adjudicate_output_review.py --write-template
- Edit reports/output_review_decisions.json with winner_variant values and reviewer metadata.
- python3 scripts/yao.py output-review
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/human-adjudication.intake.json to evidence/world_class/submissions/human-adjudication.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions

#### Commands

- prepare submission `python3 scripts/yao.py world-class-submission-kit . --evidence-key human-adjudication --output-dir evidence/world_class/submissions`
- validate intake `python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions`
- review queue `python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions`
- refresh ledger `python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions`
- guard claim `python3 scripts/yao.py world-class-claim-guard .`

#### Must Collect

- real reviewer identity
- blind A/B decisions
- answer key unopened until decisions exist

#### Success Checks

- reports/output_review_adjudication.json summary.pending_count == 0
- reports/output_review_adjudication.json summary.judgment_count == summary.pair_count
- reports/output_review_adjudication.json summary.invalid_decision_count == 0
- reports/skill_os2_audit.json item human-adjudication status becomes pass

#### Privacy

- Reviewer decisions should not include raw user data or private customer detail.
- Keep the answer key separate until after decisions are recorded.

#### Next Source Actions

- Record a reviewer choice for every pair.
- Every pair needs one valid human judgment.

#### Source Evidence Snapshot

- Review pairs exist `pair_count: 5 / >0` Generate the blind A/B review pack.
- No pending decisions `pending_count: 5 / ==0` Record a reviewer choice for every pair.
- Judgments complete `judgment_count: 0 / ==pair_count` Every pair needs one valid human judgment.
- No invalid decisions `invalid_decision_count: 0 / ==0` Fix malformed winner/confidence entries.

external · awaiting-submission

### Native Permission Enforcement

No evidence packet has been submitted for review.

Owner
  target client or installer integrator
Ledger
  `pending`
Blocked
  `1`
Submission
  `evidence/world_class/submissions/native-permission-enforcement.json`

#### Source Runbook

- Implement or connect a real target client or external installer runtime guard that blocks undeclared network, file_write, or subprocess capabilities.
- Update the generated target adapter only when the guard is actually enforced by that target.
- python3 scripts/yao.py package . --platform openai --platform claude --platform generic --platform vscode --output-dir dist --zip
- python3 scripts/yao.py install-simulate . --package-dir dist --install-root dist/install-simulation
- python3 scripts/yao.py runtime-permissions . --package-dir dist
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/native-permission-enforcement.intake.json to evidence/world_class/submissions/native-permission-enforcement.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions

#### Commands

- prepare submission `python3 scripts/yao.py world-class-submission-kit . --evidence-key native-permission-enforcement --output-dir evidence/world_class/submissions`
- validate intake `python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions`
- review queue `python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions`
- refresh ledger `python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions`
- guard claim `python3 scripts/yao.py world-class-claim-guard .`

#### Must Collect

- real target client or external installer runtime guard
- native enforcement flag or externally accepted guard proof
- residual risk retained for fallback targets

#### Success Checks

- reports/runtime_permission_probes.json summary.native_enforcement_count > 0
- reports/runtime_permission_probes.json summary.failure_count == 0
- reports/runtime_permission_probes.json summary.installer_enforcement_pass_count records local installer enforcement but does not replace native evidence
- reports/skill_os2_audit.json item native-permission-enforcement status becomes pass

#### Privacy

- Do not mark native_enforcement true for metadata-only fallbacks.
- Keep residual risks visible for targets that still rely on operator enforcement.

#### Next Source Actions

- Collect real target-client or external runtime guard proof.

#### Source Evidence Snapshot

- Native enforcement `native_enforcement_count: 0 / >0` Collect real target-client or external runtime guard proof.
- Probe failures `failure_count: 0 / ==0` Runtime permission probes must stay clean.
- Installer support `installer_enforcement_ready: True / true` Installer enforcement is supporting evidence, not native proof.

external · awaiting-submission

### Native Client Telemetry

No evidence packet has been submitted for review.

Owner
  Browser/Chrome/IDE/provider client integrator
Ledger
  `pending`
Blocked
  `2`
Submission
  `evidence/world_class/submissions/native-client-telemetry.json`

#### Source Runbook

- python3 scripts/telemetry_native_host.py . --write-launcher /tmp/yao-telemetry-host.sh --write-manifest /tmp/yao-telemetry-host.json --allowed-origin chrome-extension://<extension-id>/
- Install the generated native messaging manifest for the real client and send at least one accepted skill_activation or skill_output event.
- python3 scripts/yao.py telemetry-import . --input-jsonl .yao/telemetry_spool/external_events.jsonl
- python3 scripts/yao.py skill-atlas --workspace-root .
- python3 scripts/yao.py skill-os2-audit . --generated-at <YYYY-MM-DD>
- Copy evidence/world_class/templates/native-client-telemetry.intake.json to evidence/world_class/submissions/native-client-telemetry.json and fill only real evidence fields.
- python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions

#### Commands

- prepare submission `python3 scripts/yao.py world-class-submission-kit . --evidence-key native-client-telemetry --output-dir evidence/world_class/submissions`
- validate intake `python3 scripts/yao.py world-class-intake . --submissions-dir evidence/world_class/submissions`
- review queue `python3 scripts/yao.py world-class-submission-review . --submissions-dir evidence/world_class/submissions`
- refresh ledger `python3 scripts/yao.py world-class-ledger . --submissions-dir evidence/world_class/submissions`
- guard claim `python3 scripts/yao.py world-class-claim-guard .`

#### Must Collect

- real external client source
- metadata-only event
- local-first import path

#### Success Checks

- reports/adoption_drift_report.json summary.source_types.external > 0
- reports/adoption_drift_report.json summary.adoption_sample_count > 0
- reports/skill_os2_audit.json item native-client-telemetry status becomes pass

#### Privacy

- Telemetry must remain metadata-only and local-first.
- Do not package reports/telemetry_events.jsonl or any raw prompt, output, transcript, note, or message field.

#### Next Source Actions

- Import at least one metadata-only event from a real client.
- Telemetry must include adoption outcome evidence.

#### Source Evidence Snapshot

- External events `external_source_events: 0 / >0` Import at least one metadata-only event from a real client.
- Adoption sample `adoption_sample_count: 0 / >0` Telemetry must include adoption outcome evidence.
- Raw content blocked `raw_content_allowed: False / false` Telemetry must stay metadata-only.

## Boundary

- Planned work, draft packets, metadata fallback, pending human decisions, and local command runners do not count as completion.
- Valid intake means ready for submission review; ledger review still requires passing source evidence.
- The world-class ledger and claim guard remain the source of truth.