AINA Beta Readiness Path Handoff
Technical closeout for the local beta-readiness milestone.
The completed local ICP title map has been converted into a beta receipt with cohorts, source grounding, broad ICP examples, real-beta blocks, stale-input detection, and validation checks.
Current State
Scope remains VDS-local and synthetic. Public runtime, real-user beta/data, external writes, production telemetry, and deployment promotion are all blocked.
Files Added Or Changed
| Path | Purpose |
|---|---|
src/aina_data_engine/beta_readiness_path.py | New receipt generator, row reconciler, BLS/source/runtime gate checker. |
src/aina_data_engine/cli.py | Adds command and stricter regeneration checks. |
src/aina_data_engine/reports.py | Adds beta-readiness gates to full validation. |
tests/test_beta_readiness_path.py | Receipt, CLI, seasonal inclusion, and stale-adjudication tests. |
artifacts/validation/beta_readiness_path_v1.json/jsonl | Summary and row-level receipts. |
docs/reports/2026-06-11-founder-beta-readiness-path.* | Founder report pair. |
docs/handoff/2026-06-11-beta-readiness-path-handoff.* | Technical handoff pair. |
Implementation
The core command ensures upstream source/runtime artifacts, reads coverage and adjudication receipts, applies only eligible adjudication rows, emits per-title beta cohorts, and records input hashes so stale receipts can be detected later.
uv run aina-data-engine --root /srv/aina/aina-data-engine-room beta-readiness-path
| Input | Path |
|---|---|
| ICP title coverage | artifacts/validation/icp_title_coverage_v1.json/jsonl |
| ICP title adjudication | artifacts/validation/icp_title_adjudication_v1.json/jsonl |
| HF runtime map | artifacts/validation/hf_runtime_map_receipt_v1.json |
| BLS cached facts | artifacts/warehouse/bls_oews_wage_employment_may_2025.parquet |
Checks Added
| Check | Why it matters |
|---|---|
no_stale_adjudication_rows_applied | Prevents old model outputs from overriding current title coverage. |
real_beta_personalization_blocked | Keeps real beta/demo eligibility at zero until approval. |
source_authority_bls_metrics_current | Confirms BLS row and SOC counts match current source snapshot. |
| JSONL and input-hash checks | Stops validation from accepting stale companion artifacts. |
founder_demo_* JSON keys remain compatibility aliases only. Current semantics are icp_example_candidate and icp_example_personas.Review
| Reviewer | Finding | Resolution |
|---|---|---|
| Correctness | Stale adjudication override and stale JSONL acceptance. | Fixed with eligible-adjudication check, input hashes, JSONL counts, and tests. |
| Data/provenance | Physical/manual examples and imprecise BLS wording. | Fixed with example filter and BLS SOC/without-grounding metrics. |
| Safety/claims | Broad examples looked like founder-demo-safe personas. | Fixed with risk tags, real-beta blocks, and compatibility notes. |
Resume Commands
git status --short
uv run aina-data-engine --root /srv/aina/aina-data-engine-room beta-readiness-path
jq '{status, valid, metrics: {serviceable_title_rows: .metrics.serviceable_title_rows, icp_example_candidate_count: .metrics.icp_example_candidate_count, real_beta_demo_allowed_count: .metrics.real_beta_demo_allowed_count, stale_adjudication_row_count: .metrics.stale_adjudication_row_count}, failed_checks}' artifacts/validation/beta_readiness_path_v1.json
uv run aina-data-engine --root /srv/aina/aina-data-engine-room validate
uv run pytest -q
The next build step should be a real-beta allowlist gate: policy, auth/session/tenant enforcement, privacy and retention, telemetry sink approval, and domain review for sensitive tags.
Start from the beta receipt, not the old title-cleanup queue. The backlog is exhausted; the next work is real-beta eligibility.