Skip to content

State–Evidence production cutover for canonical presentation - #34

Draft
xueyang-dev wants to merge 16 commits into
mainfrom
codex/state-evidence-production-cutover
Draft

State–Evidence production cutover for canonical presentation#34
xueyang-dev wants to merge 16 commits into
mainfrom
codex/state-evidence-production-cutover

Conversation

@xueyang-dev

@xueyang-dev xueyang-dev commented Jul 29, 2026

Copy link
Copy Markdown
Owner

Summary

This draft PR makes the State–Evidence Kernel and Canonical Presentation Blueprint the authoritative production upstream.

Production path

Source / learner analysis
→ LearningStatePlan
→ EvidencePlan
→ ActivityPlan
→ EvidenceAlignmentGate
→ PresentationContentPlan
→ PresentationMediaRequestPlan
→ AbstractPresentationBindings
→ CanonicalPresentationBlueprint
→ deterministic LegacyLessonBlueprint adapter
→ existing HTML/PPTX renderers
→ quality gates
→ export

What changed

  • run_full_pipeline() and POST /api/projects/{project_id}/blueprint use the canonical blueprint-stage compiler.
  • Legacy blueprints/lesson_blueprint.json is read-only compatibility output with mapping/provenance artifacts.
  • Evidence alignment, canonical compilation, adapter mapping, readiness, and reconciliation blockers stop downstream generation without fallback.
  • Renderer-facing routes require the complete canonical production contract and fingerprint consistency.
  • Source/profile/State–Evidence upstream fingerprints invalidate canonical, legacy, media, render, quality, and delivery state.
  • Non-deterministic LLM providers explicitly return llm_production_contract_unsupported; their complete-Slides contract remains diagnostic-only.
  • The web UI removes legacy Blueprint editing and exposes Provider production-contract status.
  • Documentation and an audit/progress record describe production, compatibility, diagnostic, and experimental boundaries.

Verification

  • npm test: 652 passed, 3 skipped, 6 warnings
  • npm run test:e2e: 14 passed
  • npm run build:web: passed
  • Frontend state contract: passed
  • Python compileall and git diff --check: passed

Remaining migration work

  • Migrate non-deterministic LLM Providers to source-grounded upstream analysis/evidence/activity suggestions.
  • Extend canonical media request planning to source-grounded image requests where provenance exists.
  • Run teacher-led production pilots and future classroom validation.

This PR is intentionally draft and has not been merged.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant