feat(ui): customizable Home page with Quick Start and optional widgets

[sriaradhyula]

Summary

• Replace the fixed Home page with a hero prompt composer + a tabbed Quick Start section (Build / Automate / Connect / Explore), each card linking to the closest existing destination route — no new destination pages.
• The previous Home sections (welcome banner, "Start Here" shortcuts, recent chats, insights, shared conversations) become individually addable/removable/reorderable widgets (drag-and-drop via @dnd-kit), persisted per-user (localStorage-first, best-effort sync to Mongo via the existing /api/settings/preferences route — no new backend route needed).
• A "Go back to the previous Home experience" / "Try the new Home experience" toggle keeps the old fixed layout (ClassicHomePage) available during rollout, gated by a home_experience preference, so it can be retired once the new experience is validated.
• The hero composer creates a conversation via the existing dual-mode chat-store action and hands the typed first message off through a one-shot pending-first-message module, picked up by ChatPanel's existing send pipeline rather than duplicating it. The agent picker reuses the existing AgentSelector component, defaulting to the resolved platform/user default agent.
• RecentChats, SharedConversations, InsightsWidget, CapabilityCards, and WelcomeBanner were made self-contained (own data fetching) so they can be registered as zero-prop widgets. While browser-testing this, found and fixed a real bug: RecentChats' loading skeleton never cleared when the session was unauthenticated.
• The Explore tab intentionally ships without the "Projects" card from the original design reference — its description named an internal Cisco/Outshift product, which can't appear in this public repo.

Screenshots

Light	Dark

Test plan

• npm run lint
• npx tsc --noEmit
• npm test (full suite, 7494 tests passing)
• npm run build
• Manually verified in a running dev server: hero composer renders and the agent picker correctly hides when no dynamic agents are configured; all four Quick Start tabs render their cards with correct links; adding/removing/reordering widgets persists across a reload (localStorage mode); the classic/new experience toggle switches layouts and persists; no console errors beyond the pre-existing 401s from this auth-less dev environment
• Reviewer: exercise the hero composer's send flow end-to-end against a real dynamic-agent-configured environment (this dev environment has none configured, so the actual message-send path — reusing ChatPanel's existing pipeline — couldn't be exercised live, only unit-tested)
• Reviewer: the "Create Schedules" Quick Start card links to /schedules, which has no in-page creation affordance today (schedules are created via an agent conversation) — may need a product decision on that card's expectation

🤖 Generated with Claude Code

[github-actions]

✅ No proprietary content detected. This PR is clear for review!

[github-actions]

🧪 CAIPE UI Test Results

✅ All tests passed

🟡 Overall Coverage: 62%

📊 Detailed Coverage

Metric	Covered	Total	Percentage
Lines	41356	61130	67.65%
Statements	44164	67453	65.47%
Functions	7747	12724	60.88%
Branches	28066	50774	55.27%

✅ Test Suites

• ✅ auth-guard.test.tsx - Route protection & authorization
• ✅ token-expiry-guard.test.tsx - Token expiry handling
• ✅ dynamic-agent-client.test.ts - Dynamic Agents streaming client
• ✅ auth-utils.test.ts - Authentication utilities (100% coverage)
• ✅ auth-config.test.ts - OIDC configuration

📈 Coverage Thresholds

Threshold	Target	Current	Status
Minimum	40%	62%	✅ Pass
Good	60%	62%	✅ Pass
Excellent	80%	62%	⚠️ Below target

⚠️ Areas Needing Tests

High Priority:

• lib/streaming/* - Core stream event handling
• store/chat-store.ts - Chat state management
• store/agent-skills-store.ts - Agent skills
• lib/api-client.ts - API communication
• lib/storage-mode.ts - MongoDB/localStorage switching

Medium Priority:

• components/chat/ChatPanel.tsx - Main chat interface
• components/agent-builder/* - Agent builder UI
• lib/mongodb.ts - MongoDB integration

---

💡 Run locally: make caipe-ui-tests
📦 Full report: Check workflow artifacts

[github-actions]

ℹ️ Branch is behind main (advisory, non-blocking)

Commit: 03082b2b

This branch does not yet contain the latest main. This does not fail the version-bump check — version files are bumped once the branch is updated, and GitHub branch protection still requires the branch to be up to date before merge. Use the Update branch button on this PR, or run:

git fetch origin main
git checkout feat/customizable-home-page-quick-start
git merge FETCH_HEAD
git push