Skip to content

v22.0 Pilot Metric Instrumentation and Tier 0 Hardening

Summary

This archive records the completed Tier 0 admissions-support bundle executed while v22.0 Gate 0 remained blocked on user-owned legal and partner evidence.

The work intentionally stayed inside the allowed near-term scope:

  1. A3 pilot metric computability
  2. A11 public claim / placeholder hardening
  3. A22 focused pilot/privacy reliability coverage
  4. bounded A6 / A16 readiness tooling, without curated service-data edits

Completed Outcomes

  1. Extended the pilot metric-source schema:
  2. added pilot_connection_events
  3. added pilot_service_scope
  4. added service_operational_status_events
  5. added pilot_data_decay_audits
  6. added pilot_preference_fit_events
  7. added entity_key_hash to pilot_contact_attempt_events
  8. Implemented internal authenticated pilot APIs for:
  9. connection events
  10. pilot scope services
  11. service operational status events
  12. data-decay audits
  13. preference-fit events
  14. metric recompute into pilot_metric_snapshots
  15. Preserved privacy guardrails:
  16. rejected disallowed free-text/privacy fields on the new pilot write paths
  17. kept repeat-failure attribution on opaque SHA-256 digests instead of raw identifiers
  18. Added bounded readiness reporting:
  19. npm run audit:pilot-readiness
  20. JSON machine-readable report
  21. Markdown summary
  22. CSV verification worksheet
  23. no edits to data/services.json
  24. Hardened active public claims and placeholders:
  25. acknowledgments wording
  26. partner/reference page posture
  27. active locale copy associated with that surface
  28. press-kit/runtime/accessibility/privacy wording
  29. Added focused automated coverage:
  30. pilot route validation, permission, privacy-reject, missing-table, and success paths
  31. recompute route behavior
  32. pilot metric snapshot computation
  33. readiness-audit helpers and script-adjacent behavior

Canonical References Updated

  1. Architecture
  2. Main Roadmap
  3. v21 Admissions Portfolio Plan
  4. v22.0 Phase 0 Baseline Metric Definitions
  5. v22.0 Phase 0 Baseline Query Spec
  6. v22.0 Phase 0 Baseline SQL Editor Runbook
  7. v22.0 Phase 0 Implementation Plan

Verification Snapshot

Validated during the 2026-04-01 maintenance pass:

  1. npm run ci:check
  2. targeted Vitest coverage for the new pilot routes, recompute path, metric logic, schema validation, and readiness audit helpers
  3. npm run audit:pilot-readiness -- --scope-file ... sanity-checked in temp-output mode

Not fully validated in this environment:

  1. npm run test:db / npm run test:db:smoke were skipped locally because psql is not installed on this machine

What Remains Open

This archive does not close the broader admissions backlog.

Still-open near-term work:

  1. A1 Gate 0 partner/legal evidence closure
  2. real bounded A6 verification-cycle execution
  3. real bounded A16 pilot-scope data corrections based on the new audit outputs

Later evidence work remains governed by the main roadmap and v21 plan.