feat(gui): adopt the shared desktop GUI (Flavian/Vespasian pattern)

[PAMulligan]

Summary

Closes #122. Adds packages/gui/ (@aurelius/gui), a cross-platform Electron desktop app that drives Aurelius's existing scripts and Claude Code through four screens, using the same engine, layering, and commands Flavian and Vespasian ship.

Approach. Forked Vespasian's manifest-driven GUI engine verbatim from the local clone (deb6c1c), stripped its Wix screen, and retargeted it with one Aurelius ProductManifest plus four bespoke React panels. Dependencies are bumped to Flavian's current, security-swept versions (electron-vite 5, electron-builder 26). Core stays pure Node and is unit-tested headless; the renderer can only call named, typed bridge operations.

Screens, each driving existing scripts unchanged:

Screen	Wraps
Prerequisites	new scripts/check-prerequisites.sh (sibling output format), scripts/setup-playwright.sh via an install button
Setup wizard (Next.js / Vite / Astro / SvelteKit / Expo, optional dry run)	scripts/setup-project.sh <name> --renderer <id> [--dry-run]
Build from Figma	claude -p "/build-from-figma <url>" (headless Claude Code)
Visual QA (app URL + capture baselines / regression / responsive / dark mode / cross-browser; renders reports and PNG galleries under .claude/visual-qa/)	capture-baselines.sh, regression-test.sh, check-responsive.sh, check-dark-mode.sh, cross-browser-baseline.sh compare

Engine changes (generic, documented in packages/gui/docs/GUI-PLATFORM.md): a runStep(screen, step, vars) bridge/IPC channel replacing the per-screen runSite/runQa handlers; fillTemplate drops empty placeholder-only args so optional flags never produce a stray ''; the wizard is a plain bashScript step (the module descriptor is removed).

Also: root gui:* scripts, .github/workflows/gui.yml (path-filtered lint → typecheck → tests, plus an Xvfb smoke launch), docs/GUI.md, the README "Desktop GUI (experimental)" section, CLAUDE.md tree/commands, .versionrc.json bumpFiles so the GUI version tracks releases, and a documented script count of 56. Design spec and implementation plan are under docs/superpowers/.

Deferred (follow-ups): gui-release.yml attaching installers to releases; Canva / screenshot / conversation / InDesign pipeline steps; Lighthouse and Storybook QA steps; node-pty interactive sessions.

Test plan

• pnpm gui:lint, pnpm gui:typecheck, pnpm gui:test (43 headless core tests: process runner, shell resolver, prereq parser against fixtures of the real script, command building from the manifest, wizard arg mapping, pipeline launch, QA discovery, sandboxed artifact reads, project detection, manifest shape incl. "every script it names exists")
• scripts/__tests__/check-prerequisites.test.js pins the script's output contract; full script suite passes (40 files, 527 tests); root lint + Prettier clean; doc-count check clean
• pnpm gui:build then the smoke test launches the app and reaches the shell (locally on a real display; CI runs it under Xvfb)
• Screenshots of all four screens captured through Playwright; Prerequisites ran the real script; a wizard dry run through the GUI streamed the script's plan and created nothing
• pnpm gui:package produces packages/gui/dist/Aurelius-2.0.0.AppImage; the packaged binary launches (app.isPackaged === true) and renders the prerequisite report
• commit-and-tag-version --dry-run bumps both package.json and packages/gui/package.json
• After merge: pnpm gui:dev on macOS/Windows (Git Bash required on Windows)

🤖 Generated with Claude Code