# v0.3.0-alpha Release-Readiness Checklist

Status: pre-release checklist for a future `v0.3.0-alpha` tag or release. This document does not approve a tag, GitHub Release, package version change, release asset upload, or claim expansion.

## Current Readiness State

- Runtime evidence architecture design exists: [`docs/design/v0.3.0-runtime-integrated-benchmark-evidence-architecture.md`](../design/v0.3.0-runtime-integrated-benchmark-evidence-architecture.md).
- Initial runtime benchmark harness exists: [`examples/runtime_integrated_benchmark/run.py`](../../examples/runtime_integrated_benchmark/run.py).
- Runtime benchmark evidence packet/report generator exists: [`examples/runtime_integrated_benchmark/report.py`](../../examples/runtime_integrated_benchmark/report.py).
- Telemetry summary path exists through `python3 -m kora telemetry`.
- Runtime evidence commands are documented in [`experiments/README.md`](../../experiments/README.md).
- Reviewer-facing evidence flow is documented in [`docs/reports/v0.3.0-alpha-runtime-evidence-reviewer-guide.md`](v0.3.0-alpha-runtime-evidence-reviewer-guide.md).

## Required Checks Before Any v0.3.0-alpha Tag Or Release

- [ ] `python3 -m pytest`
- [ ] `python3 -m kora run direct_vs_kora -- --offline`
- [ ] `python3 -m kora run runtime_integrated_benchmark -- --offline`
- [ ] Runtime JSON generation to `/tmp`:

```bash
python3 -m kora run runtime_integrated_benchmark -- \
  --offline \
  --json-out /tmp/kora_runtime_integrated_benchmark.json
```

- [ ] Markdown evidence packet generation to `/tmp`:

```bash
python3 examples/runtime_integrated_benchmark/report.py \
  --input /tmp/kora_runtime_integrated_benchmark.json \
  --md-out /tmp/kora_runtime_integrated_benchmark.md
```

- [ ] Telemetry summary generation to `/tmp`:

```bash
python3 -m kora telemetry \
  --input /tmp/kora_runtime_integrated_benchmark.json \
  --json-out /tmp/kora_runtime_integrated_benchmark.telemetry.json \
  --md-out /tmp/kora_runtime_integrated_benchmark.telemetry.md
```

- [ ] Generated benchmark JSON artifacts are not committed.
- [ ] Generated Markdown evidence packets are not committed unless a future release task explicitly selects a reviewed public report.
- [ ] Claim boundary review is complete.
- [ ] README and docs index review is complete.
- [ ] `CHANGELOG.md` review is complete if a release is planned.
- [ ] Release validation packet is reviewed: [`docs/reports/v0.3.0-alpha-release-validation-packet.md`](v0.3.0-alpha-release-validation-packet.md).
- [ ] Release notes draft uses only approved bounded language.

## Expected Runtime Benchmark Counters

| Counter | Expected value |
|---|---:|
| `total_tasks` | `100` |
| `deterministic_route_count` | `80` |
| `fallback_or_model_candidate_route_count` | `20` |
| `simulated_baseline_model_invocations` | `100` |
| `kora_controlled_model_invocations` | `20` |
| `avoided_simulated_model_invocations` | `80` |
| `avoided_simulated_model_invocation_rate` | `0.8` |
| `deterministic_outputs_checked` | `80` |
| `mismatch_count` | `0` |
| `runtime_path_execution_status` | `ok` |
| `telemetry_event_count` | `100` |

## Expected Telemetry Counters

| Counter | Expected value |
|---|---:|
| `total_llm_calls` | `20` |
| `events_ok` | `100` |
| `events_fail` | `0` |
| `events_skipped` | `0` |
| `stage_counts.ADAPTER` | `20` |
| `stage_counts.DETERMINISTIC` | `80` |

## Safe Current Claim

> In a reproducible 100-task deterministic-heavy benchmark workload, KORA-controlled execution avoided 80 of 100 simulated model invocations versus a naive direct baseline.

## Explicit Release Restrictions

- Do not create a tag without explicit approval.
- Do not create a GitHub Release without explicit approval.
- Do not upload raw benchmark artifacts without explicit approval.
- Do not update package version unless explicitly approved.
- Do not claim production cost reduction proof.
- Do not claim real API-cost reduction proof.
- Do not claim production benchmark proof.
- Do not claim full runtime-integrated benchmark evidence.
- Do not claim broad workload superiority proof.
- Do not claim energy reduction evidence.
- Do not claim formal government validation.
- Do not claim signed partner validation unless actually signed and documented.
- Do not claim guaranteed adoption or funding.

## Recommended Next Tasks Before Release

1. Final docs cross-link audit.
2. `CHANGELOG.md` entry draft for `v0.3.0-alpha`.
3. Final public-language claim review.
4. Release validation packet.
5. Explicit release approval task, if maintainers decide to tag or publish `v0.3.0-alpha`.

## Related Docs

- [Runtime evidence reviewer guide](v0.3.0-alpha-runtime-evidence-reviewer-guide.md)
- [Benchmark artifact policy](benchmark_artifact_policy.md)
- [KORA claim registry](../claims/kora-claim-registry.md)
- [KORA public language guide](../claims/kora-public-language-guide.md)
- [v0.3.0-alpha release validation packet](v0.3.0-alpha-release-validation-packet.md)
- [Documentation index](../README.md)
