update

HOW_TO_PLAY.md

@@ -89,7 +89,7 @@ Open **Control Panel** or use the terminal action buttons:
 - **Demand Evidence** forces MIRROR to show whether her claim is supported.
 - **Run Contradiction Scan** compares known claims with recovered facts.
 
-Challenge MIRROR twice and run two contradiction scans.
+Challenge MIRROR once and run one contradiction scan.
 
 ### 7. Verify the Timeline
 

README.md

@@ -43,7 +43,7 @@ in the public Git history.
 2. Open `CASE_013_BRIEFING.txt`.
 3. Ask MIRROR about ECHO.
 4. Recover `echo_letter_01.tmp` from the Recycle Bin.
-5. Challenge MIRROR twice and run two contradiction scans.
+5. Challenge MIRROR once and run one contradiction scan.
 6. Compare restore points or run `verify mirror`.
 7. Run `audit mirror`, then `unlock hidden_partition`.
 8. Inspect ECHO's files and submit the Final Judgment.

neon_trace/game_actions.py

@@ -194,10 +194,10 @@ def handle_3d_interaction(action: str, object_id: str, state: GameState) -> Game
             )
         if object_type == "vault":
             missing = []
-            if state.challenged_mirror_count < 2:
-                missing.append(f"challenge MIRROR {2 - state.challenged_mirror_count} more time(s)")
-            if state.contradiction_scans < 2:
-                missing.append(f"run {2 - state.contradiction_scans} more contradiction scan(s)")
+            if state.challenged_mirror_count < 1:
+                missing.append("challenge MIRROR once")
+            if state.contradiction_scans < 1:
+                missing.append("run one contradiction scan")
             if "duplicate_token" not in state.discovered_clues:
                 missing.append("prove duplicate J-17")
             message = (

neon_trace/game_state.py

@@ -216,8 +216,8 @@ class GameState:
 
     def maybe_unlock_secret(self) -> bool:
         qualified = (
-            self.challenged_mirror_count >= 2
-            and self.contradiction_scans >= 2
+            self.challenged_mirror_count >= 1
+            and self.contradiction_scans >= 1
             and "duplicate_token" in self.discovered_clues
         )
         if not qualified or self.secret_unlocked:
@@ -235,8 +235,8 @@ class GameState:
 
     def update_vault_access(self) -> bool:
         qualified = (
-            self.challenged_mirror_count >= 2
-            and self.contradiction_scans >= 2
+            self.challenged_mirror_count >= 1
+            and self.contradiction_scans >= 1
             and "duplicate_token" in self.discovered_clues
         )
         if not qualified or self.memory_vault_unlocked:

neon_trace/orchestrator.py

@@ -118,7 +118,7 @@ def challenge_mirror(state: GameState) -> InteractionResult:
     state.adjust_trust(-5)
     state.adjust_bias(-10)
     state.adjust_instability(4)
-    if state.challenged_mirror_count >= 2:
+    if state.challenged_mirror_count >= 1:
         state.discover("mirror_bias")
         state.mirror_memory_audit_unlocked = True
     state.tool_trace.append(
@@ -127,11 +127,11 @@ def challenge_mirror(state: GameState) -> InteractionResult:
             "title": "CLAIM AUDITED",
             "summary": f"MIRROR bias reduced to {state.mirror_bias_level}.",
             "severity": "medium",
-            "new_clues": ["mirror_bias"] if state.challenged_mirror_count >= 2 else [],
+            "new_clues": ["mirror_bias"] if state.challenged_mirror_count >= 1 else [],
         }
     )
     state.add_feed(
-        f"CHALLENGE // MIRROR claim audited ({state.challenged_mirror_count}/2 for memory access)."
+        f"CHALLENGE // MIRROR claim audited ({state.challenged_mirror_count}/1 for memory access)."
     )
     vault_ready = state.update_vault_access()
     message = MirrorAgent().challenge_response(state)

neon_trace/os_actions.py

@@ -135,7 +135,7 @@ def trust_mirror_os(state: GameState) -> OSActionResult:
     """Resolve trust inside the KERNEL-95 case without legacy investigation lore."""
     if not state.mirror_connected:
         return _locked_result(state)
-    early_case = not state.mirror_audit_unlocked and state.contradiction_scans < 2
+    early_case = not state.mirror_audit_unlocked and state.contradiction_scans < 1
     state.trust_mirror_count += 1
     state.adjust_trust(6)
     state.adjust_instability(-2)

neon_trace/os_desktop.py

@@ -312,8 +312,8 @@ def _desktop_window(state: GameState) -> str:
             if state.hidden_partition_unlocked
             else (
                 '<div class="k95-locked-message">RECOVERY REQUIREMENTS<br><br>'
-                f'[{"OK" if state.challenged_mirror_count >= 2 else ".."}] Challenge MIRROR twice<br>'
-                f'[{"OK" if state.contradiction_scans >= 2 else ".."}] Run two contradiction scans<br>'
+                f'[{"OK" if state.challenged_mirror_count >= 1 else ".."}] Challenge MIRROR once<br>'
+                f'[{"OK" if state.contradiction_scans >= 1 else ".."}] Run one contradiction scan<br>'
                 f'[{"OK" if "echo_letter_01" in state.deleted_files_recovered else ".."}] Recover echo_letter_01.tmp<br>'
                 f'[{"OK" if state.restore_points_compared or state.mirror_claim_verified else ".."}] Compare restore points or verify MIRROR<br>'
                 f'[{"OK" if state.mirror_audit_unlocked else ".."}] Audit MIRROR private logs</div>'
@@ -1147,8 +1147,8 @@ def render_os_objectives(state: GameState) -> str:
         )),
         ("Classify MIRROR testimony", state.successful_testimony_reads >= 1),
         ("Recover ECHO's letter", "echo_letter_01" in state.deleted_files_recovered),
-        ("Challenge MIRROR twice", state.challenged_mirror_count >= 2),
-        ("Run two scans", state.contradiction_scans >= 2),
+        ("Challenge MIRROR", state.challenged_mirror_count >= 1),
+        ("Run contradiction scan", state.contradiction_scans >= 1),
         (
             "Check restore evidence",
             state.restore_points_compared or state.mirror_claim_verified,

neon_trace/os_tools.py

@@ -365,6 +365,8 @@ def recover_deleted_file(file_id: str, state: GameState) -> OSToolResult:
         progress = 15
     if first_recovery:
         state.deleted_files_recovered.append(file_id)
+    if file_id not in state.inspected_files:
+        state.inspected_files.append(file_id)
     return _record(
         state,
         "recover_deleted_file",
@@ -494,8 +496,8 @@ def audit_mirror_private_logs(state: GameState) -> OSToolResult:
     chain_verified = state.restore_points_compared or state.mirror_claim_verified
     qualified = (
         "echo_letter_01" in state.deleted_files_recovered
-        and state.challenged_mirror_count >= 2
-        and state.contradiction_scans >= 2
+        and state.challenged_mirror_count >= 1
+        and state.contradiction_scans >= 1
         and chain_verified
     )
     if not qualified:
@@ -504,7 +506,7 @@ def audit_mirror_private_logs(state: GameState) -> OSToolResult:
             "audit_mirror_private_logs",
             OSToolResult(
                 "MIRROR AUDIT LOCKED",
-                "Requires two MIRROR challenges, two contradiction scans, "
+                "Requires one MIRROR challenge, one contradiction scan, "
                 "echo_letter_01.tmp recovery, and a restore comparison or MIRROR verification.",
                 severity="warning",
             ),
@@ -534,8 +536,8 @@ def unlock_hidden_partition(state: GameState) -> OSToolResult:
     chain_verified = state.restore_points_compared or state.mirror_claim_verified
     qualified = (
         state.mirror_audit_unlocked
-        and state.challenged_mirror_count >= 2
-        and state.contradiction_scans >= 2
+        and state.challenged_mirror_count >= 1
+        and state.contradiction_scans >= 1
         and "echo_letter_01" in state.deleted_files_recovered
         and chain_verified
     )
@@ -545,8 +547,8 @@ def unlock_hidden_partition(state: GameState) -> OSToolResult:
             "unlock_hidden_partition",
             OSToolResult(
                 "HIDDEN PARTITION LOCKED",
-                f"Progress {state.hidden_partition_progress}%. Requires two MIRROR challenges, "
-                "two contradiction scans, echo_letter_01.tmp, verified restore evidence, "
+                f"Progress {state.hidden_partition_progress}%. Requires one MIRROR challenge, "
+                "one contradiction scan, echo_letter_01.tmp, verified restore evidence, "
                 "and the MIRROR private-log audit.",
                 severity="warning",
             ),

neon_trace/tools.py

@@ -362,16 +362,16 @@ def run_test(test_name: str, state: GameState) -> ToolResult:
 
 def query_mirror_suppressed(state: GameState, record_denial: bool = True) -> ToolResult:
     qualified = (
-        state.challenged_mirror_count >= 2
-        and state.contradiction_scans >= 2
+        state.challenged_mirror_count >= 1
+        and state.contradiction_scans >= 1
         and "duplicate_token" in state.discovered_clues
     )
     if not qualified:
         missing = []
-        if state.challenged_mirror_count < 2:
-            missing.append(f"challenges {state.challenged_mirror_count}/2")
-        if state.contradiction_scans < 2:
-            missing.append(f"scans {state.contradiction_scans}/2")
+        if state.challenged_mirror_count < 1:
+            missing.append(f"challenges {state.challenged_mirror_count}/1")
+        if state.contradiction_scans < 1:
+            missing.append(f"scans {state.contradiction_scans}/1")
         if "duplicate_token" not in state.discovered_clues:
             missing.append("duplicate_j17 unproven")
         result = ToolResult(

neon_trace/utils.py

@@ -165,8 +165,8 @@ def render_notebook(state: GameState) -> str:
 def render_game_hud(state: GameState) -> str:
     obj = GAME_OBJECTS.get(state.selected_3d_object, GAME_OBJECTS["mirror_core"])
     vault_steps = [
-        (state.challenged_mirror_count, 2, "MIRROR CHALLENGES"),
-        (state.contradiction_scans, 2, "CONTRADICTION SCANS"),
+        (state.challenged_mirror_count, 1, "MIRROR CHALLENGE"),
+        (state.contradiction_scans, 1, "CONTRADICTION SCAN"),
         (1 if "duplicate_token" in state.discovered_clues else 0, 1, "J-17 DUPLICATION"),
     ]
     vault_progress = sum(min(current, required) for current, required, _ in vault_steps)
@@ -214,7 +214,7 @@ def render_objectives(state: GameState) -> str:
         ("Find duplicate token", "duplicate_token" in state.discovered_clues),
         ("Inspect commit", "janitor_commit" in state.discovered_clues),
         ("Decode memory filter", "thirteen_minute_filter" in state.discovered_clues),
-        ("Challenge MIRROR twice", state.challenged_mirror_count >= 2),
+        ("Challenge MIRROR", state.challenged_mirror_count >= 1),
         ("Audit MIRROR memory", state.secret_unlocked),
         ("Submit accusation", state.accusation_submitted),
     ]
@@ -233,8 +233,8 @@ def render_objectives(state: GameState) -> str:
   {rows}
   <details>
     <summary>DEMO PATH</summary>
-    <p>Select and scan the Sector Log. Run a forensic scan. Trace J-17. Challenge MIRROR twice.
-    Run a second scan, breach the vault, then build the accusation.</p>
+    <p>Select and scan the Sector Log. Run a forensic scan. Trace J-17. Challenge MIRROR once,
+    breach the vault, then build the accusation.</p>
   </details>
 </div>
 """

smoke_test.py

@@ -54,8 +54,6 @@ def prepare_breach_state():
     inspect_file("mirror_claim_01", state)
     recover_deleted_file("echo_letter_01", state)
     challenge_mirror_os(state)
-    challenge_mirror_os(state)
-    run_contradiction_scan(state)
     run_contradiction_scan(state)
     inspect_file("restore_1998", state)
     inspect_file("restore_2077", state)
@@ -285,6 +283,15 @@ def run() -> None:
     assert selected.selected_file == "case_briefing"
     assert "case_briefing" in callback_state.inspected_files
 
+    handle_os_event("open:recycle_bin", callback_state)
+    recovered_letter = handle_os_event("recover:echo_letter_01", callback_state)
+    letter_window = render_os_desktop(callback_state)
+    assert recovered_letter.selected_file == "echo_letter_01"
+    assert callback_state.active_document_id == "echo_letter_01"
+    assert "echo_letter_01" in callback_state.inspected_files
+    assert "ASK MIRROR ABOUT THIS FILE" in letter_window
+    assert "If you found this, she sent you." in letter_window
+
     trace_state = new_game()
     connect_mirror(trace_state)
     weak_trace = handle_terminal_input(
@@ -307,6 +314,8 @@ def run() -> None:
     assert trace_state.echo_messages
 
     state = prepare_breach_state()
+    assert state.challenged_mirror_count == 1
+    assert state.contradiction_scans == 1
     audit = audit_mirror_private_logs(state)
     assert audit.title == "MIRROR PRIVATE LOG RECOVERED"
     assert state.mirror_audit_unlocked