Jetpack Search AI Answers - add dashboard and front end ui.

This is a squashed commit from developing the feature and multiple experiments with the interface.

It also includes the original plan for building the feature.

This was merged with the new experience selection logic from #48500

Author: gibrown

pnpm-lock.yaml

@@ -0,0 +1,54 @@
+# Jetpack Search
+
+## UI Components
+
+**Always use existing design system components instead of writing custom ones.**
+
+The Jetpack Search dashboard is actively migrating to standard WordPress components. When building UI, follow this priority order:
+
+### Priority 1: `@wordpress/ui`
+The primary component library for new Jetpack work. Use for:
+- `Button`, `Link`
+- `Notice.Root` / `Notice.Title` / `Notice.Description`
+- Tabs, dialogs, and layout primitives
+
+### Priority 2: `@wordpress/components`
+Fallback for anything not yet in `@wordpress/ui`:
+- `ToggleControl`, `TextareaControl`, `SelectControl`
+- `Tabs`, `TabPanel`
+- `Notice` (legacy)
+
+### Priority 3: `@automattic/jetpack-components`
+Jetpack-specific components (upsell cards, plan badges, etc.).
+
+### Never reinvent
+Do **not** create custom implementations of:
+- Tab bars → use `@wordpress/components` `Tabs` or `@wordpress/ui`
+- Buttons → use `@wordpress/ui` `Button`
+- Notices/alerts → use `@wordpress/ui` `Notice`
+- Toggles/checkboxes → use `@wordpress/components` `ToggleControl`
+
+When unsure which component to use, the `@wordpress/design-system-mcp` MCP is configured for this project — use it to look up the right component before building a custom one.
+
+## Data access
+
+- `@automattic/jetpack-shared-extension-utils` → `getSiteFragment()` for site domain
+- `@automattic/jetpack-script-data` → `isWpcomPlatformSite()` for WP.com detection
+- Store selectors via `useSelect( select => select( STORE_ID ).selectorName(), [] )` — always include `[]` dependency array
+
+## Testing
+
+Always run all three suites when changing search code:
+
+```bash
+# JS tests (from projects/packages/search/)
+pnpm test-scripts
+
+# Search PHP tests
+jetpack test php packages/search -v
+
+# Sync PHP tests — search changes often affect the sync whitelist
+jetpack test php packages/sync -v
+```
+
+- Mock external packages in tests; mock custom hooks (`hooks/use-*`) rather than their internals

projects/packages/search/AGENTS.md

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Search: AI Answers — topic-based customization CPTs, HMAC auth token, dashboard tabs, and streaming answers panel in the instant-search overlay.