Restore real Linux setup wizard in the current desktop UI

[integry]

Objective

Restore the real guided local Linux setup journey in the current packaged desktop UI. This is a demonstrated missing core feature, not optional polish.

Evidence

Current desktop epic 923d5db was packaged by CI run 33921585884. Its checksum-verified Linux x64 ZIP launches successfully with a fresh isolated profile, but the first-run chooser has no setup action despite saying setup is available on Linux. propr-ui/src/desktop/electronAdapters.ts explicitly sets localSetup.supported: false and throws instead of starting setup. Screenshot on the orchestrator machine: /tmp/desktop-epic-linux-preview.0YZ5De/first-launch.png. Do not assume this local path exists in your container.

Scope

• Reuse the already implemented Implement the guided local Linux setup wizard in the desktop app #1960 / merged [1960 by GPT-5.6 Sol] Implement the guided local Linux setup wizard in the desktop app #1978 wizard and existing @propr/local-setup engine, setup controller, schemas and capability boundary. Source reference: 1074279 and propr-ui/src/desktop/LocalSetupWizard.tsx. Inspect current source before porting: do not resurrect stale entrypoints or replace modern App/DesktopExperience/transport code with old versions.
• Expose a working Linux setup entry and integrate the existing real wizard into the current UI: prerequisites, configuration, progress, cancellation, retry, recovery and completion. No fixture-only setup, placeholder adapter, fake success or permanently hidden control.
• Completion must use the current profile/strict discovery/authentication/connection flow to reach the existing dashboard. Preserve ProfileStore v3, exact-origin CSP, main-owned credentials, profile-scoped request boundary, stale-result guards and shutdown lifecycle. Local setup must not bypass pairing/identity checks.
• Preserve truthful capability behavior: Linux supports setup; Mac/Windows remain remote-only. Surface actionable unmet prerequisites rather than hiding the Linux journey entirely. Preserve non-destructive setup behavior and secret redaction.
• Reuse the canonical shared endpoint default rather than introducing another port constant; keep CLI and hosted UI behavior intact.
• Add focused renderer and adapter/controller integration coverage proving the production entry starts the real wizard, handles cancellation/retry and hands a successful instance into the current connection flow. Run relevant desktop and UI typecheck/tests/build; attempt a packaged visual check if the environment supports it. Do not install or alter a real local ProPR stack merely to make tests pass.

Integration

Target only 1950-epic-cross-platform-dsk, never main. Native lifecycle #2125 and visual/menu integration #2123 are separate work: do not duplicate or undo them. Compose overlapping current UI changes carefully. This task is the production Linux setup integration, not the visual harness or native artifact work.

Leave the PR open for one Ultrafix pass and independent review. Include Closes #<this issue> in the PR. Final combined acceptance remains #1962. Keep optional hardening as follow-ups rather than expanding this task.

[propr-dev]

🤖 AI processing has started for this issue using codex agent with gpt-5.6-sol model.

I'll analyze the problem and work on a solution. This may take a few minutes.

Processing Details:

• Agent: codex
• Model: gpt-5.6-sol
• Branch: 2126/gpt-5.6-sol-restore-real-linux-setup--20260904-2144-cbr
• Base Branch: 1950-epic-cross-platform-dsk
• Worktree: issue-2126-20260904-2144-gpt-5.6-sol-cbr

🔍 Track Task Execution

[propr-dev]

❌ AI processing failed before producing publishable work.

System Error:
You've hit your usage limit. Visit https://chatgpt.com/codex/settings/usage to purchase more credits or try again at Sep 9th, 2026 5:38 AM.

AI Processing Failed

Execution Details:

• Issue: Restore real Linux setup wizard in the current desktop UI #2126
• Repository: integry/propr
• Status: Failed
• Execution Time: 15m 34s
• Tokens used: 0 tokens [0 input + 0 output]
• API cost: $0.00
• Timestamp: Sep 4, 2026, 10:00 PM UTC
• LLM Model: GPT-5.6 Sol
• Subscription usage: Weekly +2%

Summary:
The production path is now wired end to end: Linux advertises setup, the preload exposes only fixed setup operations and redacted progress snapshots, and completion feeds the resulting local endpoint into the existing authenticated connection machinery. The first compile passes; I’m tightening the regression tests now, especially cancellation/retry and the handoff that must stop at pairing rather than jumping directly to the dashboard.

Detailed Logs:

• Conversation: 178 messages
• Session: null

Log files stored at:

• conversation: /tmp/claude-logs/issue-2126-2026-09-04T22-00-22-698Z-conversation.json
• output: /tmp/claude-logs/issue-2126-2026-09-04T22-00-22-698Z-output.txt

Latest Conversation Messages

---

This processing report was generated automatically by ProPR for issue #2126.

[integry]

Resume after the previous usage-limit failure, not from scratch. The failed run reported the production setup path wired and first compile passing; recover existing edits from issue-2126-20260904-2144-gpt-5.6-sol-cbr / branch2126/gpt-5.6-sol-restore-real-linux-setup--20260904-2144-cbr if still available. Finish cancellation/retry and authenticated handoff regression tests, package/typecheck and publish the PR against1950-epic-cross-platform-dsk. Keep real production setup, not acceptance fixtures. Do not auto-merge or merge main. Native2125 and visual2127 corrections remain independent. Current task is terminal and no retry is queued; this issue is being explicitly retriggered.

[propr-dev]

🤖 AI processing has started for this issue using codex agent with gpt-5.6-sol model.

I'll analyze the problem and work on a solution. This may take a few minutes.

Processing Details:

• Agent: codex
• Model: gpt-5.6-sol
• Branch: 2126/gpt-5.6-sol-restore-real-linux-setup--20260906-0949-v1e
• Base Branch: 1950-epic-cross-platform-dsk
• Worktree: issue-2126-20260906-0949-gpt-5.6-sol-v1e

🔍 Track Task Execution