Deploy SAT & ACT Learning Lab 1.3.8

DEPLOYMENT_NOTES.md

@@ -1,4 +1,4 @@
-# Deployment notes — SAT & ACT Learning Lab 1.3.7
+# Deployment notes — SAT & ACT Learning Lab 1.3.8
 
 Target private Space: `DearmonAnalytics/SAT_ACT_Learning_Lab`
 
@@ -6,7 +6,7 @@ Turso database: `dearmon-sat-act-learning-lab`
 
 Schema namespace: `sat_act_learning_lab_v1`
 
-Encrypted-source secret: `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`
+Encrypted-source secret: `SAT_ACT_APP_FERNET_V1_3_8_361A7215EF3D_B4E784D7CBC7`
 
 ## Runtime contract
 
@@ -69,7 +69,7 @@ Encrypted-source secret: `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`
 
 Core secrets are `OPENAI_API_KEY`, `TURSO_DATABASE_URL`, `TURSO_AUTH_TOKEN`,
 `LEARNER_ID_HMAC_SECRET`, `INSTRUCTOR_EXPORT_SECRET`, and
-`SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`. Live avatar video additionally uses optional
+`SAT_ACT_APP_FERNET_V1_3_8_361A7215EF3D_B4E784D7CBC7`. Live avatar video additionally uses optional
 `SIMLI_API_KEY`.
 
 Email recovery uses `AUTH_RECOVERY_EMAIL_ENABLED`, `AUTH_SMTP_HOST`,
@@ -88,27 +88,35 @@ Release runtime defaults include `ACCOUNT_AUTH_ENABLED=1`,
 `OPENAI_OVERFLOW_REVIEW_MODEL=gpt-5-mini`. Face IDs and the pinned Simli client module are
 listed in `environment.example` used to prepare this deployment.
 
-## v1.3.7 upgrade gate
+## v1.3.8 upgrade gate
 
 Finish or explicitly abandon every active timed simulation from an earlier
-release before installing v1.3.7. Checkpoints are intentionally bound to
+release before installing v1.3.8. Checkpoints are intentionally bound to
 app/source/form versions and cannot be resumed across this release. Back up
 Turso, preserve `LEARNER_ID_HMAC_SECRET`, and retain prior Fernet secrets and
 rollback commits needed through acceptance testing.
 
-Acceptance testing for v1.3.7 must also verify the three horizontal Practice
-rails; the collapsed, expandable, question-specific Concept swim lane; rendered
-inline Math without literal dollar delimiters; and the softened AA-contrast
-charcoal/neon rails and Topic Graph. Each generated item must expose a full,
-distinct analogous worked example and a separate learner-invoked hint for the
-active item. Confused-word items must exercise the expanded deterministic
-surfaces without a model call.
+Acceptance testing for v1.3.8 must verify the live Dearmon Analytics palette,
+type, DA mark, compact masthead/disclaimer, bright amber test chooser, and three
+compressed horizontal Practice rails over translucent ink. Selecting a lesson
+must open Question & Your Work, and the answer row must expose grade,
+same-lesson, and next-lesson actions. Grading must freeze elapsed and target
+time, show the exact reduced fraction and pace comparison, and flatten the same
+fields into learner/account and instructor attempt CSVs while legacy rows stay
+blank. Inline lesson Math and printable exam/key PDFs must use the shared
+renderer without visible LaTeX commands or dollar delimiters. The collapsed,
+question-specific Concept swim lane, full analogous worked example, separate
+active-item hint, and deterministic confused-word surfaces must remain.
 Near-white mastered topic tiles intentionally retain dark text for WCAG
 contrast.
 
+The release builder continues to generate the versioned Fernet key
+automatically, store it under `release/private/`, validate it, and reuse it for
+safe retries without prompting the deployer operator.
+
 ## Key lifecycle and rollback
 
-The current loader reads only `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`. A later release must generate a
+The current loader reads only `SAT_ACT_APP_FERNET_V1_3_8_361A7215EF3D_B4E784D7CBC7`. A later release must generate a
 new versioned, fingerprinted secret name. The deployer adds that secret before
 the repository commit and retains earlier keys. Roll back by reverting the
 Space repository to the prior commit recorded in `deployment_receipt.json`.

README.md

@@ -14,7 +14,7 @@ short_description: Dynamic SAT/ACT practice, mastery, and reasoning graphs
 
 # Dearmon Analytics SAT & ACT Learning Lab
 
-Release `1.3.7` provides original dynamic practice for current SAT and
+Release `1.3.8` provides original dynamic practice for current SAT and
 ACT skill blueprints, a four-level topic graph, individual mastery tracking,
 targeted practice, and test-like diagnostic sessions. It adds username/password
 accounts, secure recovery, an isolated one-click demo, and the embedded teaching
@@ -24,15 +24,20 @@ Signed-in students can also download their complete personalized Topic Graph as
 a branded PNG, printable PDF, accessible hierarchy-and-concepts CSV, and
 verification manifest; demo sessions remain nonexportable.
 
-Release 1.3.7 presents Practice as three horizontal hierarchy rails—Section,
-Domain, then Narrow Topic—and loads each fresh item's Concepts Needed path in a
-collapsed, expandable, question-specific swim lane. Rails and the
-Topic Graph use softened AA-contrast charcoal surfaces, brighter neon accents,
-and explicit light type while preserving readable mastery whitening. Every
-generated practice item includes a complete, distinct analogous worked example
-and a separate learner-invoked hint for the active item. Deterministic
-confused-word practice covers an expanded set of commonly confused pairs and
-groups without a model call.
+Release 1.3.8 matches the live Dearmon Analytics palette, typography, DA mark,
+and compact paper masthead, with the independent-practice disclaimer inside the
+banner. Its brighter amber-outlined test chooser and Section → Domain → Narrow
+Topic rails are compressed and closely stacked over translucent ink surfaces
+with accessible light type. Fresh lessons automatically open Question & Your
+Work; grading is joined by separate same-lesson and next-lesson actions.
+
+The answer record freezes elapsed time and its blueprint target at grading,
+then reports their exact reduced fraction and pace comparison. Learner/account
+and instructor attempt CSVs expose the timing values while legacy untimed rows
+remain blank. Shared math normalization serves both lesson surfaces and
+printable exam/answer-key PDFs so raw LaTeX is never the learner-facing
+fallback. The collapsed item-specific Concepts Needed swim lane, complete
+analogous worked examples, separate hints, and mastery whitening remain.
 
 The Printable Exam Builder requires an active demo or signed-in learner so
 every generated file has a cleanup owner. It creates a clean Dearmon
@@ -60,7 +65,7 @@ attribute-level mastery or retention records.
 This private Space uses the separate Turso database
 `dearmon-sat-act-learning-lab` and schema namespace
 `sat_act_learning_lab_v1`. Its encrypted application uses the versioned Space
-secret `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`.
+secret `SAT_ACT_APP_FERNET_V1_3_8_361A7215EF3D_B4E784D7CBC7`.
 
 Required Space secrets are `OPENAI_API_KEY`, `TURSO_DATABASE_URL`,
 `TURSO_AUTH_TOKEN`, `LEARNER_ID_HMAC_SECRET`, `INSTRUCTOR_EXPORT_SECRET`, and
@@ -102,11 +107,13 @@ controls, and retention policies.
 
 ## Upgrade note
 
-Before replacing any earlier release with v1.3.7, every active timed simulation
+Before replacing any earlier release with v1.3.8, every active timed simulation
 must be finished or explicitly abandoned. Saved forms are bound to the app
-version and encrypted-source fingerprint, so v1.3.7 intentionally rejects older
+version and encrypted-source fingerprint, so v1.3.8 intentionally rejects older
 checkpoints. Preserve `LEARNER_ID_HMAC_SECRET` and retain every prior versioned
-Fernet secret and rollback commit needed through acceptance testing.
+Fernet secret and rollback commit needed through acceptance testing. The build
+still generates its new Fernet key automatically, stores it under
+`release/private/`, and reuses the validated key without prompting.
 
 ## Independent practice-content notice
 

release_manifest.json

@@ -1,18 +1,18 @@
 {
-  "built_utc": "2026-08-30T11:47:39+00:00",
+  "built_utc": "2026-08-30T13:04:16+00:00",
   "database_name": "dearmon-sat-act-learning-lab",
-  "encrypted_payload_sha256": "c32bd13c204dc1ac17efff0a30377844d0c4680e03d8c8ac7a15e15550fd48f3",
+  "encrypted_payload_sha256": "98b38862bb0bae2fa92db264f2e8bb64136fbbc8205577c78089bf12e362e5d0",
   "entry_module": "sat_act_lab.app_main",
-  "fernet_secret_name": "SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2",
-  "key_fingerprint_sha256_prefix": "CF494C1151F2",
-  "plaintext_archive_sha256": "6be7eebd263324339ddcaa161529377350e148f8d6bafbc21270f6fdd0c814ce",
-  "release_version": "1.3.7",
+  "fernet_secret_name": "SAT_ACT_APP_FERNET_V1_3_8_361A7215EF3D_B4E784D7CBC7",
+  "key_fingerprint_sha256_prefix": "B4E784D7CBC7",
+  "plaintext_archive_sha256": "361a7215ef3df14fecc19eff46274d95af18cc0e4c9d2ec7fb075e574351f47f",
+  "release_version": "1.3.8",
   "schema_namespace": "sat_act_learning_lab_v1",
   "schema_version": "dearmon-sat-act-release-v1",
   "source_members": {
     "sat_act_lab/__init__.py": {
       "bytes": 71,
-      "sha256": "34d993b7900b03a44147017a479e04644aa27cc202f4e2b05aa15c9061006b98"
+      "sha256": "2cc4420186299725b00fb206f1fb4be160c23713e4c408661327f51f22400294"
     },
     "sat_act_lab/act_english_bank.py": {
       "bytes": 79622,
@@ -31,16 +31,16 @@
       "sha256": "9f557aea11cc2796e011031c70776dfd9cf3f4c0f8255fcbff9ded341580a4e4"
     },
     "sat_act_lab/app_main.py": {
-      "bytes": 349363,
-      "sha256": "6e69cb964a3dfb2561307159c1bbed74ddd19efdc249013984fdf883be439eed"
+      "bytes": 355315,
+      "sha256": "8abed1a97ba4a74d8bfc8d0c88148ae6fdada1c549b5ba54e20908aa559017b2"
     },
     "sat_act_lab/attribute_graph.py": {
       "bytes": 131004,
       "sha256": "8188d65e7894a4c69aed1fdf9f8f4a0c7e90ca6055be44776fac8a39a7bb4dea"
     },
     "sat_act_lab/auth.py": {
-      "bytes": 52719,
-      "sha256": "ca3a1ed2540a3c7a617286e26dedd0901caef39126684b0e3a62f0fa13fe4c67"
+      "bytes": 52755,
+      "sha256": "f6bc1f7f656b8366e69b171291ead6de32ff543fded3dc6b2a53ff6f3c752747"
     },
     "sat_act_lab/avatar.py": {
       "bytes": 73246,
@@ -63,8 +63,8 @@
       "sha256": "2abb720cd5a0a5a459cbcdc7ec1a8919ea50d7203cc809adccdefed4317e3a7f"
     },
     "sat_act_lab/exam_pdf_export.py": {
-      "bytes": 47043,
-      "sha256": "876991e8fb86d85606854b0a2d2609203b77537b9a91e2183edfdee0aead7a16"
+      "bytes": 47544,
+      "sha256": "fce7b9417dee76dfbf2d0d9cdc212a3534295ae7f2764b318459a32f77c1aa17"
     },
     "sat_act_lab/learner_exam_topics.py": {
       "bytes": 11795,
@@ -74,21 +74,25 @@
       "bytes": 51827,
       "sha256": "cf32579466f8a97f1d299c78ace4a0fef16c6db51685dce0f164f160e910d06c"
     },
+    "sat_act_lab/math_rendering.py": {
+      "bytes": 22555,
+      "sha256": "8b9ddb347ba4921597546a6430bcbc322eea1fe7f57e457432448ffb5e3bf6af"
+    },
     "sat_act_lab/practice_exam_planner.py": {
       "bytes": 6731,
       "sha256": "96dda3ddb76bc2d837769865fdbe177ad650bfd21cd158d161e5cb13123fa6a9"
     },
     "sat_act_lab/question_engine.py": {
-      "bytes": 236611,
-      "sha256": "13e4f9055e0b856fe67b62682478e6e7229578c1b248e2dbd7a32a99e43811c7"
+      "bytes": 237008,
+      "sha256": "c073090634e055cdd53e3e1af38e5d3967b73cb193c94c187e767269b74c7915"
     },
     "sat_act_lab/topic_graph_report.py": {
       "bytes": 19837,
       "sha256": "0a6bb8a950a1f600e2d365bbbc7e9afba48c23be30d5440aa0fb94a2ed4ecbea"
     },
     "sat_act_lab/tracking.py": {
-      "bytes": 139074,
-      "sha256": "c814032247eac63b59d7c619aa172af6340840bc2d1cd5e2b9e5294862231d82"
+      "bytes": 143382,
+      "sha256": "35705325d13dd4a71ac0a7568d98b49365d999ad000d3245d87cf041f01988c7"
     }
   },
   "space_file_hashes": {
@@ -97,16 +101,16 @@
       "sha256": "3b1fdd8eb2e17dc4edae8387f1bc9a18a8072a8d6fae3a71041f00f0b9b04103"
     },
     "DEPLOYMENT_NOTES.md": {
-      "bytes": 6943,
-      "sha256": "698ed5f0b61712fc753f541fcbff65ee5699d0374e222b9a15134e8d4673fdc2"
+      "bytes": 7495,
+      "sha256": "8fc2538674135f75ab59f2d88796e78221a1d7d55a8c44273149047a7e3ff68b"
     },
     "README.md": {
-      "bytes": 6392,
-      "sha256": "5fc3eb15ca91ae46dca856dc2a5e76d5f7c96acb851b264631a365b3163992ff"
+      "bytes": 6894,
+      "sha256": "634a018397457137466c50b9c43d7cbdcc89570c3c99ea7aa72388fa0353b5bd"
     },
     "app.py": {
-      "bytes": 693367,
-      "sha256": "8046d0b3e2973199a9ea1759e9100ebf018b9c0f21690733863eb9a2033c988f"
+      "bytes": 709677,
+      "sha256": "0d4ff72267e861e5ba4d9bc28baa67fb860cc56d6a6027f126c19963a947cd1a"
     },
     "requirements.txt": {
       "bytes": 301,