Deploy SAT & ACT Learning Lab 1.3.7

DEPLOYMENT_NOTES.md

@@ -1,4 +1,4 @@
-# Deployment notes — SAT & ACT Learning Lab 1.3.6
+# Deployment notes — SAT & ACT Learning Lab 1.3.7
 
 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_6_C585E3BA4A89_3656938409CB`
+Encrypted-source secret: `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`
 
 ## Runtime contract
 
@@ -69,7 +69,7 @@ Encrypted-source secret: `SAT_ACT_APP_FERNET_V1_3_6_C585E3BA4A89_3656938409CB`
 
 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_6_C585E3BA4A89_3656938409CB`. Live avatar video additionally uses optional
+`SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`. Live avatar video additionally uses optional
 `SIMLI_API_KEY`.
 
 Email recovery uses `AUTH_RECOVERY_EMAIL_ENABLED`, `AUTH_SMTP_HOST`,
@@ -88,23 +88,27 @@ 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.6 upgrade gate
+## v1.3.7 upgrade gate
 
 Finish or explicitly abandon every active timed simulation from an earlier
-release before installing v1.3.6. Checkpoints are intentionally bound to
+release before installing v1.3.7. 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.6 must also verify the three horizontal Practice
-rails, automatic Concept-tab loading after each hierarchy selection, rendered
-inline Math without literal dollar delimiters, and white labels on every dark
-Topic Graph surface. Near-white mastered topic tiles intentionally retain dark
-text for WCAG contrast.
+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.
+Near-white mastered topic tiles intentionally retain dark text for WCAG
+contrast.
 
 ## Key lifecycle and rollback
 
-The current loader reads only `SAT_ACT_APP_FERNET_V1_3_6_C585E3BA4A89_3656938409CB`. A later release must generate a
+The current loader reads only `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`. 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.6` provides original dynamic practice for current SAT and
+Release `1.3.7` 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,11 +24,15 @@ 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.6 presents Practice as three horizontal hierarchy rails—Section,
-Domain, then Narrow Topic—and automatically opens a fresh item-specific Concept
-& Visualization lesson when any tier changes. The full-width lesson renders
-question figures and KaTeX mathematics, while the dark Topic Graph uses explicit
-high-contrast labels and preserves readable mastery whitening.
+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.
 
 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
@@ -56,7 +60,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_6_C585E3BA4A89_3656938409CB`.
+secret `SAT_ACT_APP_FERNET_V1_3_7_6BE7EEBD2633_CF494C1151F2`.
 
 Required Space secrets are `OPENAI_API_KEY`, `TURSO_DATABASE_URL`,
 `TURSO_AUTH_TOKEN`, `LEARNER_ID_HMAC_SECRET`, `INSTRUCTOR_EXPORT_SECRET`, and
@@ -98,9 +102,9 @@ controls, and retention policies.
 
 ## Upgrade note
 
-Before replacing any earlier release with v1.3.6, every active timed simulation
+Before replacing any earlier release with v1.3.7, 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.6 intentionally rejects older
+version and encrypted-source fingerprint, so v1.3.7 intentionally rejects older
 checkpoints. Preserve `LEARNER_ID_HMAC_SECRET` and retain every prior versioned
 Fernet secret and rollback commit needed through acceptance testing.
 

release_manifest.json

@@ -1,18 +1,18 @@
 {
-  "built_utc": "2026-08-30T02:05:56+00:00",
+  "built_utc": "2026-08-30T11:47:39+00:00",
   "database_name": "dearmon-sat-act-learning-lab",
-  "encrypted_payload_sha256": "8c3f19ee9e02c2f0cf0ff4a7875480c69246dec1137076411fe8d103446cb6d0",
+  "encrypted_payload_sha256": "c32bd13c204dc1ac17efff0a30377844d0c4680e03d8c8ac7a15e15550fd48f3",
   "entry_module": "sat_act_lab.app_main",
-  "fernet_secret_name": "SAT_ACT_APP_FERNET_V1_3_6_C585E3BA4A89_3656938409CB",
-  "key_fingerprint_sha256_prefix": "3656938409CB",
-  "plaintext_archive_sha256": "c585e3ba4a89a702d24e2c0f300e435b8d9ec82db11117794449b9894bf2138d",
-  "release_version": "1.3.6",
+  "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",
   "schema_namespace": "sat_act_learning_lab_v1",
   "schema_version": "dearmon-sat-act-release-v1",
   "source_members": {
     "sat_act_lab/__init__.py": {
       "bytes": 71,
-      "sha256": "b37e8dd059cfdb22183d212c4d68e33869969893a498a85517a4a7bc2d4af7bf"
+      "sha256": "34d993b7900b03a44147017a479e04644aa27cc202f4e2b05aa15c9061006b98"
     },
     "sat_act_lab/act_english_bank.py": {
       "bytes": 79622,
@@ -31,8 +31,8 @@
       "sha256": "9f557aea11cc2796e011031c70776dfd9cf3f4c0f8255fcbff9ded341580a4e4"
     },
     "sat_act_lab/app_main.py": {
-      "bytes": 329231,
-      "sha256": "de3d981fef6d459e393677df3da50af1849c3b7316af033ef5ec9c5b040cfbbe"
+      "bytes": 349363,
+      "sha256": "6e69cb964a3dfb2561307159c1bbed74ddd19efdc249013984fdf883be439eed"
     },
     "sat_act_lab/attribute_graph.py": {
       "bytes": 131004,
@@ -71,16 +71,16 @@
       "sha256": "bc32af89d411d8ff8918d74e026421707004adbf0e64e61d49706e3062526167"
     },
     "sat_act_lab/learning_concepts.py": {
-      "bytes": 51335,
-      "sha256": "202212791dc80fcc20b2dcc5d662c98e43f53db1e39b2b9992c8289183263346"
+      "bytes": 51827,
+      "sha256": "cf32579466f8a97f1d299c78ace4a0fef16c6db51685dce0f164f160e910d06c"
     },
     "sat_act_lab/practice_exam_planner.py": {
       "bytes": 6731,
       "sha256": "96dda3ddb76bc2d837769865fdbe177ad650bfd21cd158d161e5cb13123fa6a9"
     },
     "sat_act_lab/question_engine.py": {
-      "bytes": 221287,
-      "sha256": "929d8e424bbb845e69cab76f6e591f9bfb1f825c00733cd90efce089ea1a89a2"
+      "bytes": 236611,
+      "sha256": "13e4f9055e0b856fe67b62682478e6e7229578c1b248e2dbd7a32a99e43811c7"
     },
     "sat_act_lab/topic_graph_report.py": {
       "bytes": 19837,
@@ -97,16 +97,16 @@
       "sha256": "3b1fdd8eb2e17dc4edae8387f1bc9a18a8072a8d6fae3a71041f00f0b9b04103"
     },
     "DEPLOYMENT_NOTES.md": {
-      "bytes": 6704,
-      "sha256": "2dab97082befe7c757cb5d05295585a2b4907acd61d781d3d57b07166233e8c9"
+      "bytes": 6943,
+      "sha256": "698ed5f0b61712fc753f541fcbff65ee5699d0374e222b9a15134e8d4673fdc2"
     },
     "README.md": {
-      "bytes": 6136,
-      "sha256": "b78b4647a67535c7f369c1cc5ced647c7e454dc8e8ccf9f8be6dcea3ddfef845"
+      "bytes": 6392,
+      "sha256": "5fc3eb15ca91ae46dca856dc2a5e76d5f7c96acb851b264631a365b3163992ff"
     },
     "app.py": {
-      "bytes": 677564,
-      "sha256": "3f97115a74fb388920b7c8a7ac9bd5ff5276dd277bba9090d617e22bbaeefc9f"
+      "bytes": 693367,
+      "sha256": "8046d0b3e2973199a9ea1759e9100ebf018b9c0f21690733863eb9a2033c988f"
     },
     "requirements.txt": {
       "bytes": 301,