docs: close legacy frontend knowledge gaps

REPO_LAYOUT.md

@@ -4,6 +4,10 @@ This repository mixes product code, astrology research, oracle artifacts, and lo
 
 ## Core Areas
 
+- `<repo>/frontend/`
+  - current Next.js production web application
+- `<repo>/deploy/`
+  - production container topology and operational source of truth; start with `deploy/README.md`
 - `<repo>/mcp_server.py`
   - adjudicator-facing MCP entrypoint
 - `<repo>/scripts/`
@@ -20,6 +24,16 @@ This repository mixes product code, astrology research, oracle artifacts, and lo
 - `<repo>/docs/research/archive/`
   - historical round notes and local draft research
 
+## Historical Working Logs
+
+- `<repo>/task_plan.md`
+- `<repo>/findings.md`
+- `<repo>/progress.md`
+
+These root files preserve earlier implementation history and may mention retired
+paths or commands. They are not runtime or deployment instructions. Use
+`README.md` for current local development and `deploy/README.md` for production.
+
 ## Local Scratch
 
 - `<repo>/scratch/local/scripts/`

docs/research/pre_work_error_ledger.md

@@ -125,7 +125,7 @@ Prevention: add a new domain only after its public cases satisfy the same source
 ## Fragment Sweep Command Set
 
 ## ERR-084 | Pre-work fragment test assumes zero candidates despite current audited candidates | active 2026-07-19
-`scripts/pre_work_check.py` reports `fragment_audit.candidate_count=2`, while `tests/test_preflight_fragment_scan.py` requires exactly zero. The pre-work command therefore cannot be reported green until the two candidates are classified or the test is updated to validate the reviewed state rather than a hard-coded count.
+`scripts/pre_work_check.py` reported `fragment_audit.candidate_count=2` on 2026-07-19 and reports `3` in the 2026-07-20 run, while `tests/test_preflight_fragment_scan.py` requires exactly zero. The pre-work command therefore cannot be reported green until the candidates are classified or the test is updated to validate the reviewed state rather than a hard-coded count.
 
 Prevention: retain candidate identity and classification in the sweep artifact; do not mask candidates or weaken the pre-work result.
 

references/oracle/compatibility_skill_readiness_dashboard_2026_07_20.json

@@ -84,14 +84,14 @@
       "layer_id": "upapada_lagna",
       "name": "Upapada Lagna marriage image",
       "runtime_status": "available_as_chart_field",
-      "runtime_path": "jyotish-app/analysis-deep.js",
+      "runtime_path": "scripts/jaimini.py",
       "runtime_path_exists": true,
       "skill_status": "callable_context",
       "api_ui_status": "surface_audit_needed",
       "external_oracle_status": "source_reference_only",
       "commercial_sync_status": "safe_as_context",
       "evidence_paths": [
-        "jyotish-app/analysis-deep.js",
+        "scripts/jaimini.py",
         "references/data-bridge-mapping.md",
         "references/jaimini-complete-system.md"
       ],

scripts/compatibility_skill_readiness_dashboard.py

@@ -101,7 +101,7 @@ def build() -> dict:
         layer(
             "upapada_lagna",
             "Upapada Lagna marriage image",
-            "jyotish-app/analysis-deep.js",
+            "scripts/jaimini.py",
             "available_as_chart_field",
             "callable_context",
             "surface_audit_needed",

tests/test_compatibility_skill_readiness_dashboard.py

@@ -37,6 +37,8 @@ def test_compatibility_skill_dashboard_generator_creates_bounded_layers():
 
     assert layers["ashtakoota_guna_milan"]["runtime_status"] == "available"
     assert layers["ashtakoota_guna_milan"]["external_oracle_status"] == "partial"
+    assert layers["upapada_lagna"]["runtime_path"] == "scripts/jaimini.py"
+    assert layers["upapada_lagna"]["runtime_path_exists"] is True
     assert layers["relationship_ashtakavarga_overlay"]["runtime_status"] in {
         "missing_runtime",
         "registry_only",