@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.csvV2/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#
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