Eve library

@v2/sophia-release-candidate-ingestion

Other

Revision 1

On this page

@v2/sophia-release-candidate-ingestion is the V2 cook-time bridge that sends the frame-data spreadsheet and release-candidate patch-notes corpus through @sophia/ingestion before a release-candidate cook starts.

The bridge is intentionally off rollback authority. It produces a manifest that records the Sophia source package, cook hook, release-candidate id, cook platform, content hashes, stage summaries, and quality-floor status for the two required documents:

  • V2/balance/data/frame-data.csv
  • V2/balance/patch-notes/*.md

Cook Hook#

V2/ue/Tools/run-sophia-release-candidate-ingest.py is called by BuildGraph and the cook-all wrappers before Cook or BuildCookRun executes. The cook fails if the spreadsheet or patch notes do not parse, a patch note references an unknown move_id, or the underlying @sophia/ingestion quality floor is not met.

The generated manifest defaults to the cook archive under Sophia/<platform>/release-candidate-ingestion.json for the wrappers and Sophia/release-candidate-ingestion.json for BuildGraph.

Local Use#

bash
pnpm exec tsx apps/v2/sophia-release-candidate-ingestion/src/cli.ts \
  --release-candidate-id rc-2026.05.13 \
  --platform Win64 \
  --frame-data V2/balance/data/frame-data.csv \
  --patch-notes V2/balance/patch-notes \
  --out /tmp/v2-sophia-release-candidate-ingestion.json

Contract#

  • Source of truth: @sophia/ingestion
  • V2 bridge package: @v2/sophia-release-candidate-ingestion
  • Cook hook: SophiaReleaseCandidateIngestion
  • Inputs: frame-data CSV plus patch-note Markdown corpus
  • Required cadence: every release-candidate cook
  • Rollback authority: mayInfluenceRollback: false