mosaicstack/stack
1
0
Fork 0
Code Issues 13 Pull Requests Actions Packages Projects Releases 11 Wiki Activity

IUV-M02: Install UX v2 polish — CORS→FQDN, skill installer rework #437

New Issue
Closed
opened 2026-04-05 21:23:16 +00:00 by jason.woltje · 0 comments
jason.woltje commented 2026-04-05 21:23:16 +00:00
Owner
Copy Link

Mission: install-ux-v2-20260405
Milestone: IUV-M02 (UX polish)
Tier: sonnet
Depends on: IUV-M01

Two UX failings from real-run testing of 0.0.25.

Scope

1. CORS origin prompt is confusing

The wizard currently asks for a CORS origin string. Users don't know what to put here — it's an implementation detail leaking into the UX. Replace it with an FQDN / hostname input and derive the CORS value internally.

  • Prompt: "Hostname or FQDN where Mosaic will be reached"
  • Default: localhost
  • Derive CORS origin automatically (with scheme/port)
  • Clear help text explaining what this is used for

2. Skill / additional feature install section is unusable

The skill install section is broken in practice. Scope:

  • Diagnose the concrete failure modes end-to-end (real-run reproduction required; document findings in the scratchpad)
  • Rework the installer so selection / install / verify / failure reporting all work
  • Tests for each failure mode you fix

Acceptance

  • CORS origin prompt replaced with FQDN/hostname input; derivation is correct
  • Skill installer diagnosis documented in scratchpad
  • Skill installer reworked and verified end-to-end on a fresh install
  • PR merged, CI green, this issue closed
**Mission:** install-ux-v2-20260405 **Milestone:** IUV-M02 (UX polish) **Tier:** sonnet **Depends on:** IUV-M01 Two UX failings from real-run testing of 0.0.25. ## Scope ### 1. CORS origin prompt is confusing The wizard currently asks for a CORS origin string. Users don't know what to put here — it's an implementation detail leaking into the UX. Replace it with an FQDN / hostname input and derive the CORS value internally. - Prompt: "Hostname or FQDN where Mosaic will be reached" - Default: `localhost` - Derive CORS origin automatically (with scheme/port) - Clear help text explaining what this is used for ### 2. Skill / additional feature install section is unusable The skill install section is broken in practice. Scope: - **Diagnose** the concrete failure modes end-to-end (real-run reproduction required; document findings in the scratchpad) - **Rework** the installer so selection / install / verify / failure reporting all work - Tests for each failure mode you fix ## Acceptance - [ ] CORS origin prompt replaced with FQDN/hostname input; derivation is correct - [ ] Skill installer diagnosis documented in scratchpad - [ ] Skill installer reworked and verified end-to-end on a fresh install - [ ] PR merged, CI green, this issue closed
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaicstack/stack#437
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?