Headed runtime re-entry: Linux/WSL build and toolchain readiness tracker

[adybag14-cyber]

Summary

The direct headed issue #3 runtime patch is still blocked on two environment gates:

• a safe publication path for the large existing-file updates in src/browser/Page.zig and src/display/win32_backend.zig
• a branch-compatible Linux/WSL Zig toolchain and offline dependency staging path that can validate the narrowed runtime slice honestly

The main issue #2 and issue #3 threads are still useful as historical context, but they are no longer practical progress logs because new comments now fail once the thread passes GitHub's comment cap.

This issue exists as the lower-volume progress tracker for the Linux/WSL re-entry lane that prepares the next honest runtime attempt.

Scope

Use this tracker for work that improves or validates:

• saved snapshot restore and restored-checkout readiness
• saved archive integrity checks
• offline dependency staging
• saved Rust toolchain reuse
• branch-compatible Zig toolchain recovery under ../toolchains
• Linux/WSL helper routes that unblock the next real issue Headed Windows: Google search box focus lands but typed text does not commit or submit #3 runtime re-entry

Not the goal here

This is not the issue for speculative runtime rewrites in Page.zig or win32_backend.zig before the two environment gates are green.

Exit signal

Treat this tracker as successful when a future run can:

1. restore or reuse a trustworthy local checkout
2. stage a branch-compatible Zig line and the required offline inputs
3. pass the relevant readiness helpers without environment failures
4. reopen the direct issue Headed Windows: Google search box focus lands but typed text does not commit or submit #3 runtime patch with honest validation evidence

Current branch-local helpers to keep using

• docs/ISSUE3_RUNTIME_REENTRY_GATES.md
• docs/ISSUE3_SAVED_BROWSER_SNAPSHOT_ROUTE.md
• docs/ISSUE3_SAVED_ARCHIVE_INTEGRITY_ROUTE.md
• docs/ISSUE3_LINUX_BUILD_READINESS_ROUTE.md
• docs/ISSUE3_ZIG_TOOLCHAIN_RECOVERY_ROUTE.md
• scripts/check_issue3_saved_memory_inputs.py
• scripts/check_issue3_saved_archive_integrity.py
• scripts/check_issue3_restored_checkout.py
• scripts/check_linux_build_readiness.py

Why this issue exists

Scheduled headed-mode runs need a place to leave start/completion updates for this lane without relying on the already-saturated issue #2 and issue #3 threads.

[adybag14-cyber]

Goal: Land a small branch-local handoff note that redirects Linux/WSL headed runtime re-entry progress updates away from the capped issue #2 and issue #3 threads and onto this tracker.
Started: 2026-05-24 22:10 UTC
Next: Create the note on fork/headed-mode-foundation, commit it, and then post the completion update here with the branch commit SHA.

[adybag14-cyber]

Achieved: Created a new lower-volume tracker for the blocked Linux/WSL headed runtime re-entry lane and landed a branch-local note at docs/ISSUE3_PROGRESS_TRACKER_ROUTE.md so future runs can discover that tracker from the repo itself instead of retrying the capped issue #2 and issue #3 threads.
Completed: 2026-05-24 22:10 UTC
Commit: 945f092
Validation: Re-fetched docs/ISSUE3_PROGRESS_TRACKER_ROUTE.md from fork/headed-mode-foundation and confirmed the note is live on the branch.

[adybag14-cyber]

Goal: Integrate the restored-checkout re-entry route into the Linux/WSL build-readiness helper chain so reused saved-snapshot checkouts are surfaced before wider readiness work.
Started: 2026-05-24 21:26 UTC
Next: Update the branch-local Linux readiness note and helper surface checks, validate the narrowed route change, and commit it on fork/headed-mode-foundation.

[adybag14-cyber]

Goal: Add a small Linux/WSL re-entry helper for the saved-snapshot -> restored-checkout -> build-readiness chain so the next issue #3 runtime attempt can reopen from one compact route.
Started: 2026-05-24 21:31 UTC
Next: Build the helper and companion note from the live branch surfaces, validate the commands locally, and commit the branch-safe addition.

[adybag14-cyber]

Goal: Add a branch-safe regression check for the Linux/WSL build-readiness helper chain that supports issue #3 runtime re-entry.
Started: 2026-05-24 21:36 UTC
Next: Inspect the current route docs and helper scripts, add a focused surface test, validate it locally, and commit the change.

[adybag14-cyber]

Achieved: Updated the Linux/WSL build-readiness route helper so it now surfaces the restored-checkout re-entry lane, including explicit --memory-root and --restored-checkout-root support and branch-local commands for the restored-checkout route.
Completed: 2026-05-24 21:26 UTC
Commit: 3a6599e
Validation: Re-read the published branch file and syntax-checked the helper with bash -n before closing the loop.

[adybag14-cyber]

Achieved: Added a compact issue #11 saved-snapshot re-entry chain with a new note, a fail-fast surface checker, and a route printer that keeps the saved-browser-snapshot, restored-checkout, saved-Memory, Linux build-readiness, and Windows runtime handoff steps on one smaller surface.
Completed: 2026-05-24 21:32 UTC
Commit: 73f3617
Validation: Re-fetched the new branch files after publication and locally syntax-checked both shell helpers plus the route printer's JSON output before publishing.

[adybag14-cyber]

Goal: Add a focused attached-pages surface test for the issue #3 Zig toolchain recovery and archive-restore routes so Linux/WSL re-entry drift fails fast before the direct runtime patch is retried.
Started: 2026-05-24 21:44 UTC
Next: Build the small unittest locally, validate it against fixture data, then publish it on fork/headed-mode-foundation.

[adybag14-cyber]

Achieved: Added a branch-local regression test at tmp-browser-smoke/attached-pages/test_issue3_progress_tracker_route.py so the new issue #11 progress-tracker note keeps its issue handoff and helper-surface references visible.
Completed: 2026-05-24 21:45 UTC
Commit: f7b5c4f
Validation: Ran python -m unittest /workspace/test_issue3_progress_tracker_route.py locally and re-fetched the new file from fork/headed-mode-foundation.

[adybag14-cyber]

Achieved: Added tmp-browser-smoke/attached-pages/test_issue3_zig_toolchain_recovery_routes_surface.py as a focused contract guard for the issue #3 Zig recovery and archive-restore routes.
Completed: 2026-05-24 21:47 UTC
Commit: 7a0f1b1
Validation: python -m py_compile /workspace/test_issue3_zig_toolchain_recovery_routes_surface.py and LIGHTPANDA_FIXTURE_REPO=1 python -m unittest /workspace/test_issue3_zig_toolchain_recovery_routes_surface.py both passed locally before publication.

[adybag14-cyber]

Goal: Make the Linux or WSL Zig toolchain recovery route accept the same saved-archives root forms as the broader readiness helpers so issue #11 reruns do not fail on a path-shape mismatch.
Started: 2026-05-24 21:58 UTC
Next: Update the route helper and its focused surface test, validate the narrowed change locally, and commit it on fork/headed-mode-foundation.

[adybag14-cyber]

Achieved: Normalized the Linux or WSL Zig toolchain recovery route so --saved-archives-root now accepts either repo_archives/browser or repo_archives/browser/dependencies, and added a focused branch-local guard at tmp-browser-smoke/attached-pages/test_issue3_zig_toolchain_saved_archives_root_normalization.py to keep that contract visible.
Completed: 2026-05-24 22:04 UTC
Commit: bf14b3f and 3ca97c2
Validation: Re-fetched both published branch files after publication, and locally ran python -m py_compile /workspace/test_issue3_zig_toolchain_saved_archives_root_normalization.py plus python -m unittest /workspace/test_issue3_zig_toolchain_saved_archives_root_normalization.py against the focused guard fixture before cleanup.

[adybag14-cyber]

Goal: Add a branch-local Linux/WSL re-entry tracker route for issue #11 so future runs can reopen the saved-archive, toolchain, offline-inputs, and direct-runtime helpers from one compact surface.
Started: 2026-05-24 22:02 UTC
Next: Create the route note and helper, add a focused regression test for their command ordering and companion surfaces, validate it locally, and commit the slice.

[adybag14-cyber]

Goal: Make the Linux/WSL build-readiness helper resolve shared workspace roots correctly from a restored checkout so issue #3 re-entry commands stay honest.
Started: 2026-05-24 22:06 UTC
Next: Patch the readiness helper, run its focused self-tests, and commit the route fix on fork/headed-mode-foundation.

[adybag14-cyber]

Achieved: Added a branch-local issue #11 Linux/WSL re-entry route note, a compact route helper that orders the saved-input, restore, toolchain, offline-input, build-readiness, and direct-runtime helpers, and a focused regression test for that route surface.
Completed: 2026-05-24 22:15 UTC
Commit: c4c1e7a, 9315fa7, 9faeb49
Validation: The new route test passed locally in fixture mode, and the helper also passed bash syntax plus JSON-shape checks before publication.