P6: unified setup wizard on hosted UAP installer

[777genius]

Stacked on P4 (#182). Unified TTY/non-interactive wizard for install, inspect, update, repair, and uninstall of Claude and Codex through the hosted UAP installer.

This head (a77c333):

• Inspect --json reports camelCase target fields (client, unit, outcome, configPath) matching Result/ReadinessFact/NextAction
• Inspect reports discovered MCP ConfigPath on direct-mcp targets for both Claude and Codex, including omitted --agents
• Text inspect prints mcp= (and profile= / digest= when set) so the read-only report shows the observed file
• CLI contract test locks JSON ConfigPath and text mcp= for a selected-profile config.toml

Earlier on this PR:

• Confirm-plan prints discovered codex-mcp= / claude-mcp= from an existing selected-profile file
• After evaluate, a resolved MCP path is bound onto the request so Plan retry argv includes --mcp-config
• Intent records mcpConfig for agent-notify targets; resume restores omitted --mcp-config; a different explicit flag is pending_intent_conflict
• Bootstrap still does not invent --mcp-config on first argv; explicit --mcp-config / --claude-mcp-config still win
• Windows install.sh E2E uses GNU timeout --foreground (or a child-PID watchdog) so a 5s unreachable-download timeout cannot SIGTERM the Git Bash test script
• Explicit --mcp-config / --claude-mcp-config still win; otherwise a regular file already present in the selected profile ($CodexHome/config.toml, $ClaudeConfig/.claude.json) is handed off
• Missing profile files stay empty so fresh installs skip handoff; HOME/cwd are not guessed; a directory at that path is not a config file
• Bootstrap forwards already-selected CODEX_HOME as --codex-home when the flag is omitted
• Inspect without --agents still reports both clients and does not offer request-permission; omitted --agents with --yes stays invalid / agents_required (exit 2) unless a matching pending intent restores them
• Mixed live Install is Update of the behind sibling; Install of both when one client is already live on an older revision is Update then Add of the missing one
• Same-bytes Install of the already-matching live sibling is Ready, not update_required
• After mixed live siblings converge, ApplyGroup Install is restored
• Windows install.sh E2E is capped at 10 minutes; Ubuntu/macOS go test -race uses a 20m package timeout
• Retained r1→r2 is metadata-only SwitchRetained then Add; failed Add keeps data; Plan(Update) of retained skips permission/restart
• Sequential Repair rematerializes a deleted older sibling without rewriting the live one
• Attested Claude+Codex uninstall uses one UAP RemoveGroup; mixed Codex hold stays sequential

Native/reboot product E2E, Windows managedstdio 0111, unpublished UAP repository P1–P3/P5, group mixed rematerialize-after-delete (NativeObserver unset), and Cursor GitHub App write access to universal-agent-plugins remain out of this PR.

  

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

❌ Patch coverage is 66.72462% with 957 lines in your changes missing coverage. Please review.
✅ Project coverage is 66.96%. Comparing base (3914f92) to head (ebfb3e1).

Files with missing lines	Patch %	Lines
internal/agentnotify/portablesetup/uap.go	58.78%	121 Missing and 69 partials ⚠️
install/uapinstaller/group.go	69.93%	96 Missing and 48 partials ⚠️
internal/agentnotify/portablesetup/setup.go	39.56%	108 Missing and 31 partials ⚠️
cmd/claude-notifications/setup_wizard.go	72.54%	41 Missing and 29 partials ⚠️
internal/agentnotify/setupwizard/prompt.go	81.56%	45 Missing and 21 partials ⚠️
internal/agentnotify/portableasset/acquire.go	49.57%	32 Missing and 28 partials ⚠️
install/uapinstaller/switch_retained.go	51.40%	37 Missing and 15 partials ⚠️
install/uapinstaller/prepare.go	70.76%	19 Missing and 19 partials ⚠️
internal/agentnotify/setupwizard/codex_observe.go	58.69%	25 Missing and 13 partials ⚠️
internal/agentnotify/setupwizard/package.go	74.46%	19 Missing and 17 partials ⚠️
... and 10 more

Additional details and impacted files

@@                            Coverage Diff                            @@
##           cursor/uap-installer-sdk-adapter-6c84     #183      +/-   ##
=========================================================================
+ Coverage                                  65.26%   66.96%   +1.69%     
=========================================================================
  Files                                        181      194      +13     
  Lines                                      18657    23601    +4944     
=========================================================================
+ Hits                                       12177    15804    +3627     
- Misses                                      4676     5517     +841     
- Partials                                    1804     2280     +476     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.