feat(validators): add study validator library and studyu_validator CLI

[ibrahimozkn]

Description

Adds a composable study validator to core, a standalone studyu_validator CLI package, and a deterministic docs generator for studyu_core models.

core — validator library:

• ValidationLevel (draft / publish) and ValidationResult types
• Nine entity validators: study_info, interventions, questionnaire, schedule, report, eligibility_consent, question_type, consent, observations
• validateStudy() composes all validators; individual validators exported from core.dart
• StudyFixtures with fullValid() and targeted invalid variants for each error code
• consent.no_items and interventions.no_tasks are warnings, not errors

studyu_validator CLI:

• validate <file> — parse JSON and run validateStudy, exit 0/1
• validate --level publish — switch validation level
• validate --section <name> — run a single entity validator
• normalize <file> — round-trip through Study.fromJson/toJson

tools/study_data_docs — docs generator (PR 3b):

• New tools/study_data_docs workspace package (pure Dart, package:analyzer 12.x)
• --write generates core/docs/study-data/ from Dart source + .g.dart files
• --check exits non-zero when docs drift from source; wired into qualitycheck
• Scans inherited fields, filters private backing fields, extracts discriminator constants
• Block markers: <!-- GENERATED:FIELDS START/END -->, <!-- GENERATED:DISCRIMINATORS START/END -->, <!-- GENERATED:LINKS START/END -->
• 36 pages generated covering all in-scope studyu_core models
• 25 unit tests, 0 analyzer warnings
• Melos scripts: docs:study-data:write, docs:study-data:check

Visuals

N/A — CLI and library only, no UI changes.

Testing Steps

# Run core validator tests
fvm exec melos run test --scope studyu_core

# Run CLI tests
fvm exec melos run test --scope studyu_validator

# Run docs generator tests
cd tools/study_data_docs && fvm dart test

# Generate docs tree
fvm exec melos run docs:study-data:write

# Verify no drift
fvm exec melos run docs:study-data:check

# Full quality gate
fvm exec melos run qualitycheck

PR Checklist

• fvm exec melos run qualitycheck passes
• Screenshot or video of the changes attached
• Description links related issues

[github-actions]

Visit the preview URL for this PR (updated for commit 0894fe0):

• https://studyu-dev-app--pr866-feature-study-valida-qkay77c2.web.app
• https://studyu-dev-designer--pr866-feature-study-valida-sgcacz9w.web.app

_{(expires Fri, 10 Jul 2026 18:20:42 GMT)}

_{🔥 via Firebase Hosting GitHub Action 🌎}

_{Sign: 2149dad49ed83535217e50d5c18c0c8c90da629b}