@legioncodeinc/hive 0.2.1 → 0.3.1

package/dist/dashboard/web/onboarding/install-card.js

@@ -0,0 +1,171 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The per-product GUIDED INSTALL CARD, PRD-009b ob-AC-8/ob-AC-9/ob-AC-10/ob-AC-11/ob-AC-12. A
+ * full-screen card carrying the product's logo, title, benefit copy, staged (never percent)
+ * progress, and the npm-safety reassurance. Honors a brief minimum dwell on success (ob-AC-11,
+ * revised: the real install time drives the pace, the dwell only prevents a flash-through) and
+ * NEVER masks a failure behind that dwell (ob-AC-12), a `failed` stage renders its truthful error
+ * plus a retry affordance the instant it arrives, regardless of elapsed dwell time.
+ *
+ * Re-entry (ob-AC-16/ob-AC-17): `initialDetection` (the daemon's own truth from `/api/onboarding/
+ * detect`) decides the card's opening move, `install_in_progress` RE-ATTACHES the SSE stream
+ * without a new install POST; `install_failed` renders the failure immediately and waits for an
+ * explicit retry; anything else starts a fresh install.
+ */
+import React from "react";
+import { IN_FLIGHT_STAGES, installRefusalMessage } from "./contracts.js";
+import { INSTALL_STAGE_LABEL, NPM_SAFETY_COPY, PRODUCT_COPY, productLogoUrl } from "./product-copy.js";
+import { useInstallDwell } from "./use-install-dwell.js";
+function stageStepState(stepIndex, doneCount, terminal) {
+    if (stepIndex < doneCount)
+        return "done";
+    if (stepIndex === doneCount && terminal !== "completed")
+        return "active";
+    return "pending";
+}
+/** The per-stage stepper (ob-AC-9): a labeled list, never a fabricated percentage. */
+function StageStepper({ product, stage }) {
+    const currentIndex = IN_FLIGHT_STAGES.indexOf(stage);
+    const doneCount = stage === "completed" ? IN_FLIGHT_STAGES.length : Math.max(0, currentIndex);
+    return (_jsx("ul", { "data-testid": `onboarding-install-stage-${product}`, "data-current-stage": stage, style: { listStyle: "none", margin: 0, padding: 0, display: "flex", flexDirection: "column", gap: 8, width: "100%", textAlign: "left" }, children: IN_FLIGHT_STAGES.map((step, i) => {
+            const state = stageStepState(i, doneCount, stage);
+            return (_jsxs("li", { "data-state": state, style: {
+                    display: "flex",
+                    alignItems: "center",
+                    gap: 10,
+                    fontFamily: "var(--font-sans)",
+                    fontSize: "var(--text-sm)",
+                    color: state === "pending" ? "var(--text-tertiary)" : "var(--text-primary)",
+                }, children: [_jsx("span", { "aria-hidden": "true", style: {
+                            width: 8,
+                            height: 8,
+                            flex: "none",
+                            borderRadius: "50%",
+                            background: state === "done" ? "var(--verified)" : state === "active" ? "var(--honey)" : "var(--border-strong)",
+                            animation: state === "active" ? "hc-onboarding-stage-pulse var(--dur-pollinate) var(--ease-in-out) infinite alternate" : "none",
+                        } }), INSTALL_STAGE_LABEL[step]] }, step));
+        }) }));
+}
+/** ob-AC-10, the npm-safety reassurance, verbatim, on every card. */
+function NpmSafetyNote({ product }) {
+    return (_jsx("p", { "data-testid": `onboarding-npm-safety-${product}`, style: {
+            fontFamily: "var(--font-sans)",
+            fontSize: "var(--text-xs)",
+            color: "var(--text-tertiary)",
+            margin: 0,
+            lineHeight: 1.5,
+            padding: "10px 14px",
+            background: "var(--bg-inset)",
+            border: "1px solid var(--border-subtle)",
+            borderRadius: "var(--radius-md)",
+        }, children: NPM_SAFETY_COPY }));
+}
+export function InstallCard({ product, initialDetection, client, assetBase, onAdvance, minDwellMs }) {
+    // Captured ONCE at mount, later prop identity changes (a parent re-render passing an
+    // equivalent-but-new object) must never re-trigger the opening-move decision below.
+    const openingRef = React.useRef(initialDetection);
+    const wasInitiallyInstalled = openingRef.current.state === "installed";
+    const wasInitiallyFailed = openingRef.current.state === "install_failed";
+    const [stage, setStage] = React.useState(() => {
+        if (wasInitiallyInstalled)
+            return "completed";
+        if (wasInitiallyFailed)
+            return "failed";
+        return "resolving";
+    });
+    const [error, setError] = React.useState(() => openingRef.current.error ?? null);
+    // Bumped by the retry button; also doubles as "has the operator asked us to try again" so a
+    // card that OPENED failed runs no network activity until this leaves 0 (ob-AC-12).
+    const [attempt, setAttempt] = React.useState(0);
+    React.useEffect(() => {
+        if (wasInitiallyInstalled)
+            return;
+        if (wasInitiallyFailed && attempt === 0)
+            return;
+        let cancelled = false;
+        let unsubscribe = () => { };
+        void (async () => {
+            // ob-AC-17: re-attach ONLY on the very first attempt of a card that opened mid-flight ,
+            // every retry (attempt > 0) always re-POSTs a fresh install, even for that same product.
+            const reattachOnly = attempt === 0 && openingRef.current.state === "install_in_progress";
+            if (!reattachOnly) {
+                const started = await client.startInstall(product);
+                if (cancelled)
+                    return;
+                if (started === null) {
+                    setError({ stage: "resolving", summary: "Could not reach the daemon to start the install. Check your connection and retry." });
+                    setStage("failed");
+                    return;
+                }
+                if ("error" in started) {
+                    setError({ stage: "resolving", summary: installRefusalMessage(started.error) });
+                    setStage("failed");
+                    return;
+                }
+                if (started.state === "installed") {
+                    // A race the daemon itself resolved before this card's POST landed, still honors
+                    // the minimum dwell below, just skips the SSE stream entirely (nothing to stream).
+                    setStage("completed");
+                    return;
+                }
+            }
+            setError(null);
+            unsubscribe = client.subscribeInstallEvents(product, (event) => {
+                if (cancelled)
+                    return;
+                setStage(event.stage);
+                if (event.stage === "failed") {
+                    setError({ stage: "unknown", summary: event.detail ?? "The install failed. Retry below, or check the daemon logs." });
+                }
+            });
+        })();
+        return () => {
+            cancelled = true;
+            unsubscribe();
+        };
+        // `product`/`client` are stable for a card's lifetime; `attempt` is the sole re-run trigger.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [attempt, wasInitiallyFailed, wasInitiallyInstalled]);
+    const handleRetry = React.useCallback(() => {
+        setError(null);
+        setStage("resolving");
+        setAttempt((n) => n + 1);
+    }, []);
+    // ob-AC-11: gates ONLY the success-advance path. A `failed` stage is rendered above regardless
+    // of dwell, this hook never sees `ready:true` for a failed card, so it can never mask one.
+    useInstallDwell(stage === "completed", { onDwellSatisfied: onAdvance, minDwellMs });
+    const copy = PRODUCT_COPY[product];
+    const failed = stage === "failed";
+    return (_jsxs("div", { "data-testid": `onboarding-install-card-${product}`, "data-stage": stage, style: {
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            minHeight: "100vh",
+            padding: 32,
+            background: "var(--bg-canvas)",
+            textAlign: "center",
+        }, children: [_jsxs("div", { style: {
+                    display: "flex",
+                    flexDirection: "column",
+                    alignItems: "center",
+                    gap: 22,
+                    width: "100%",
+                    maxWidth: 540,
+                    padding: "44px 40px",
+                    background: "var(--bg-surface)",
+                    border: "1px solid var(--border-default)",
+                    borderRadius: "var(--radius-xl)",
+                }, children: [_jsx("img", { src: productLogoUrl(product, assetBase), width: 64, height: 64, alt: "" }), _jsx("h1", { style: { fontSize: "var(--text-2xl)", fontWeight: 700, color: "var(--text-primary)", margin: 0, letterSpacing: "-0.02em" }, children: copy.title }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 6, maxWidth: 440 }, children: [_jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-base)", fontWeight: 600, color: "var(--text-primary)", margin: 0 }, children: copy.headline }), _jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: copy.lines[0] }), _jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: copy.lines[1] })] }), failed ? (_jsxs("div", { "data-testid": `onboarding-install-error-${product}`, style: { display: "flex", flexDirection: "column", gap: 12, alignItems: "center", width: "100%" }, children: [_jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-sm)", color: "var(--severity-critical)", margin: 0 }, children: error?.summary ?? "The install failed." }), _jsx("button", { type: "button", "data-testid": `onboarding-retry-${product}`, onClick: handleRetry, style: {
+                                    height: 40,
+                                    padding: "0 18px",
+                                    borderRadius: "var(--radius-md)",
+                                    border: "1px solid var(--severity-critical)",
+                                    background: "var(--severity-critical-bg)",
+                                    color: "var(--severity-critical)",
+                                    fontFamily: "var(--font-sans)",
+                                    fontSize: "var(--text-sm)",
+                                    fontWeight: 600,
+                                    cursor: "pointer",
+                                }, children: "Retry" })] })) : (_jsx(StageStepper, { product: product, stage: stage })), _jsx(NpmSafetyNote, { product: product })] }), _jsx("style", { children: "@keyframes hc-onboarding-stage-pulse { from { opacity: .4 } to { opacity: 1 } }" })] }));
+}
+//# sourceMappingURL=install-card.js.map

package/dist/dashboard/web/onboarding/install-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-card.js","sourceRoot":"","sources":["../../../../src/dashboard/web/onboarding/install-card.tsx"],"names":[],"mappings":"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"}

package/dist/dashboard/web/onboarding/login-step.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The onboarding LOGIN STEP, PRD-009b ob-AC-14/ob-AC-15. Closes the known device-code display gap
+ * by reusing the EXACT wire contract `GuidedSetup` (`src/dashboard/web/setup-gate.tsx`) already
+ * defines (`POST /setup/login`, polled `GET /setup/state`) WITHOUT modifying that module: this is
+ * the sibling component the task brief calls for, sharing `wire.ts`'s types/client rather than
+ * duplicating the device-flow request shapes.
+ *
+ * Unlike `/login`'s `GuidedSetup` (which waits for an explicit "First time setup" click), the
+ * onboarding flow has already walked the operator through installs and a health check, so this
+ * step begins the device flow automatically on mount: one fewer click at the end of a long guided
+ * sequence. Once `/setup/state.authenticated` flips true it fires `dashboard_reached`, best-effort
+ * POSTs `/api/onboarding/complete`, then hard-navigates to `/` (ob-AC-15) so the server gate
+ * revalidates and serves the authoritative dashboard, the same discipline `LoginScreen` follows.
+ */
+import React from "react";
+import { type WireClient } from "../wire.js";
+import type { OnboardingClient } from "./onboarding-client.js";
+/** Mirrors `setup-gate.tsx`'s `SETUP_POLL_MS`, the live-transition poll cadence. */
+export declare const LOGIN_STEP_POLL_MS: 2500;
+export interface LoginStepProps {
+    readonly onboardingClient: OnboardingClient;
+    /** The proxied setup wire client (defaults to the live one; a test injects a mock). */
+    readonly wire?: WireClient;
+    /** Test seam: called instead of the real hard navigation once authenticated. */
+    readonly onAuthenticated?: () => void;
+    /** Overrides {@link LOGIN_STEP_POLL_MS} (a test injects a short window). */
+    readonly pollMs?: number;
+}
+export declare function LoginStep({ onboardingClient, wire: wireOverride, onAuthenticated, pollMs }: LoginStepProps): React.JSX.Element;

package/dist/dashboard/web/onboarding/login-step.js

@@ -0,0 +1,104 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The onboarding LOGIN STEP, PRD-009b ob-AC-14/ob-AC-15. Closes the known device-code display gap
+ * by reusing the EXACT wire contract `GuidedSetup` (`src/dashboard/web/setup-gate.tsx`) already
+ * defines (`POST /setup/login`, polled `GET /setup/state`) WITHOUT modifying that module: this is
+ * the sibling component the task brief calls for, sharing `wire.ts`'s types/client rather than
+ * duplicating the device-flow request shapes.
+ *
+ * Unlike `/login`'s `GuidedSetup` (which waits for an explicit "First time setup" click), the
+ * onboarding flow has already walked the operator through installs and a health check, so this
+ * step begins the device flow automatically on mount: one fewer click at the end of a long guided
+ * sequence. Once `/setup/state.authenticated` flips true it fires `dashboard_reached`, best-effort
+ * POSTs `/api/onboarding/complete`, then hard-navigates to `/` (ob-AC-15) so the server gate
+ * revalidates and serves the authoritative dashboard, the same discipline `LoginScreen` follows.
+ */
+import React from "react";
+import { createWireClient, FRESH_SETUP_STATE } from "../wire.js";
+/** Mirrors `setup-gate.tsx`'s `SETUP_POLL_MS`, the live-transition poll cadence. */
+export const LOGIN_STEP_POLL_MS = 2500;
+/**
+ * The grant display (ob-AC-14): the `user_code` prominently, plus `verification_uri_complete`
+ * falling back to `verification_uri`, byte-identical fallback rule to `GuidedSetup`'s.
+ */
+function LoginGrant({ grant }) {
+    return (_jsxs("div", { "data-testid": "onboarding-login-grant", style: { display: "flex", flexDirection: "column", gap: 10, alignItems: "center" }, children: [_jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0 }, children: "Enter this code to finish linking your Deeplake account:" }), _jsx("code", { "data-testid": "onboarding-login-code", style: { fontFamily: "var(--font-mono)", fontSize: "var(--text-lg)", color: "var(--honey)", letterSpacing: "0.08em" }, children: grant.user_code }), _jsx("a", { href: grant.verification_uri_complete ?? grant.verification_uri, target: "_blank", rel: "noreferrer", "data-testid": "onboarding-login-verification-link", style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)" }, children: "Open the verification page" }), _jsx("span", { style: { fontSize: "var(--text-xs)", color: "var(--text-tertiary)" }, children: "Waiting for you to finish in the browser\u2026" })] }));
+}
+export function LoginStep({ onboardingClient, wire: wireOverride, onAuthenticated, pollMs = LOGIN_STEP_POLL_MS }) {
+    const wire = React.useMemo(() => wireOverride ?? createWireClient(), [wireOverride]);
+    const [state, setState] = React.useState(FRESH_SETUP_STATE);
+    const [grant, setGrant] = React.useState(null);
+    const [error, setError] = React.useState(false);
+    const beginRef = React.useRef(false);
+    const grantShownEventRef = React.useRef(false);
+    const navigatedRef = React.useRef(false);
+    // Auto-begin the device flow on mount (see module doc for why onboarding skips the button
+    // `GuidedSetup` shows on the standalone `/login` route).
+    React.useEffect(() => {
+        if (beginRef.current)
+            return;
+        beginRef.current = true;
+        void (async () => {
+            const result = await wire.setupLogin();
+            if (result === null) {
+                setError(true);
+                return;
+            }
+            setGrant(result);
+        })();
+    }, [wire]);
+    // ob-AC-14, `login_shown` fires the moment the grant (the code the operator must see) renders.
+    React.useEffect(() => {
+        if (grant === null || grantShownEventRef.current)
+            return;
+        grantShownEventRef.current = true;
+        onboardingClient.sendEvent("login_shown");
+    }, [grant, onboardingClient]);
+    // Poll `/setup/state` for the live authenticated transition, exactly like `LoginScreen` does.
+    React.useEffect(() => {
+        if (state.authenticated)
+            return;
+        let alive = true;
+        const tick = async () => {
+            const next = await wire.setupState();
+            if (alive)
+                setState(next);
+        };
+        void tick();
+        const id = setInterval(() => void tick(), pollMs);
+        return () => {
+            alive = false;
+            clearInterval(id);
+        };
+    }, [wire, state.authenticated, pollMs]);
+    // ob-AC-15, authenticated: fire `dashboard_reached`, best-effort POST complete, then hard-nav.
+    React.useEffect(() => {
+        if (!state.authenticated || navigatedRef.current)
+            return;
+        navigatedRef.current = true;
+        onboardingClient.sendEvent("dashboard_reached");
+        void (async () => {
+            await onboardingClient.complete();
+            if (onAuthenticated !== undefined) {
+                onAuthenticated();
+                return;
+            }
+            if (typeof window !== "undefined")
+                window.location.assign("/");
+        })();
+    }, [state.authenticated, onboardingClient, onAuthenticated]);
+    if (state.authenticated)
+        return _jsx(_Fragment, {});
+    return (_jsxs("div", { "data-testid": "onboarding-login-step", style: {
+            display: "flex",
+            flexDirection: "column",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: 18,
+            minHeight: "100vh",
+            padding: 28,
+            background: "var(--bg-canvas)",
+            textAlign: "center",
+        }, children: [_jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 8, maxWidth: 460 }, children: [_jsx("h1", { style: { fontSize: "var(--text-xl)", fontWeight: 700, color: "var(--text-primary)", margin: 0, letterSpacing: "-0.02em" }, children: "One last step: link Deeplake" }), _jsx("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: "Your fleet is up. Link your Deeplake account and you are on your dashboard." })] }), grant !== null ? (_jsx(LoginGrant, { grant: grant })) : error ? (_jsxs("p", { "data-testid": "onboarding-login-error", style: { fontSize: "var(--text-sm)", color: "var(--severity-critical)", margin: 0 }, children: ["Could not start the login. Retry, or run ", _jsx("code", { children: "honeycomb login" }), " in your terminal."] })) : (_jsx("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0 }, children: "Starting login\u2026" }))] }));
+}
+//# sourceMappingURL=login-step.js.map

package/dist/dashboard/web/onboarding/login-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-step.js","sourceRoot":"","sources":["../../../../src/dashboard/web/onboarding/login-step.tsx"],"names":[],"mappings":"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"}

package/dist/dashboard/web/onboarding/onboarding-client.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The `/onboarding` route's WIRE CLIENT, PRD-009b, talking to the PRD-009a installer service.
+ * Mirrors `wire.ts`'s fetch+zod discipline (fail-soft, never throws into React) but is kept
+ * LOCAL to the onboarding feature folder per the file-ownership split with the daemon-side agent
+ * building `src/daemon/installer/**` in parallel.
+ *
+ * Every call carries the one-time onboarding token as the `x-onboarding-token` header (the PRD's
+ * "carried on every installer call"), EXCEPT the SSE subscription: `EventSource` cannot set request
+ * headers, so the token rides as a `?t=` query param there instead (the implementation note both
+ * the parent brief and PRD-009a's SSE contract call for).
+ */
+import { type DetectResponse, type HealthResponse, type InstallableProduct, type InstallProgressEvent, type InstallStartResult } from "./contracts.js";
+/** The header carrying the one-time onboarding token on every installer call (never the SSE query). */
+export declare const ONBOARDING_TOKEN_HEADER: "x-onboarding-token";
+/** A fetch-like function, injectable so tests never hit the network (mirrors `wire.ts`'s `FetchLike`). */
+type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/** An `EventSource`-constructor-like injectable, so tests never open a real connection. */
+type EventSourceCtorLike = new (url: string | URL) => EventSource;
+export interface OnboardingClientOptions {
+    /** Prefixed onto every request path (defaults to same-origin, `""`). A test injects a base. */
+    readonly origin?: string;
+    /** Defaults to the global `fetch`; a test injects a mock. */
+    readonly fetchImpl?: FetchLike;
+    /** Defaults to the global `EventSource`; a test injects a fake (jsdom has none, see module doc below). */
+    readonly eventSourceCtor?: EventSourceCtorLike;
+}
+/** The onboarding wire surface every onboarding component reads/writes through. */
+export interface OnboardingClient {
+    /** `GET /api/onboarding/detect`, never assumes a product set; a failure degrades to {@link EMPTY_DETECTION}. */
+    detect(): Promise<DetectResponse>;
+    /** `POST /api/onboarding/install`, starts (or short-circuits) one product's install. `null` on failure. */
+    startInstall(product: InstallableProduct): Promise<InstallStartResult | null>;
+    /**
+     * `GET /api/onboarding/install/:product/events` (SSE). Returns an unsubscribe function. In an
+     * `EventSource`-less environment (jsdom, mirroring `use-fleet-telemetry.ts`'s documented gap)
+     * this is a no-op subscription, the caller's install-card falls back to its optimistic local
+     * stage tracking rather than throwing.
+     */
+    subscribeInstallEvents(product: InstallableProduct, onEvent: (event: InstallProgressEvent) => void): () => void;
+    /** `GET /api/onboarding/health`, a failure degrades to {@link UNREACHABLE_HEALTH} (never `ready:true`). */
+    health(): Promise<HealthResponse>;
+    /** `POST /api/onboarding/complete` (204). Best-effort: never throws, never blocks the caller's navigation. */
+    complete(): Promise<void>;
+    /**
+     * `POST /api/onboarding/event` (202), the UI funnel chokepoint. FIRE-AND-FORGET by design: the
+     * caller never awaits this (a slow/broken telemetry endpoint must never stall the guided flow).
+     */
+    sendEvent(event: string, properties?: Record<string, string>): void;
+}
+/** Build the onboarding wire client bound to one onboarding token (read once from `?t=`, kept in memory). */
+export declare function createOnboardingClient(token: string, options?: OnboardingClientOptions): OnboardingClient;
+export {};

package/dist/dashboard/web/onboarding/onboarding-client.js

@@ -0,0 +1,133 @@
+/**
+ * The `/onboarding` route's WIRE CLIENT, PRD-009b, talking to the PRD-009a installer service.
+ * Mirrors `wire.ts`'s fetch+zod discipline (fail-soft, never throws into React) but is kept
+ * LOCAL to the onboarding feature folder per the file-ownership split with the daemon-side agent
+ * building `src/daemon/installer/**` in parallel.
+ *
+ * Every call carries the one-time onboarding token as the `x-onboarding-token` header (the PRD's
+ * "carried on every installer call"), EXCEPT the SSE subscription: `EventSource` cannot set request
+ * headers, so the token rides as a `?t=` query param there instead (the implementation note both
+ * the parent brief and PRD-009a's SSE contract call for).
+ */
+import { DetectResponseSchema, EMPTY_DETECTION, InstallProgressEventSchema, InstallRefusalResponseSchema, InstallStartResponseSchema, parseHealthResponse, UNREACHABLE_HEALTH, } from "./contracts.js";
+/** The header carrying the one-time onboarding token on every installer call (never the SSE query). */
+export const ONBOARDING_TOKEN_HEADER = "x-onboarding-token";
+function tokenHeaders(token) {
+    return token !== "" ? { [ONBOARDING_TOKEN_HEADER]: token } : {};
+}
+/** Build the onboarding wire client bound to one onboarding token (read once from `?t=`, kept in memory). */
+export function createOnboardingClient(token, options = {}) {
+    const origin = options.origin ?? "";
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const url = (path) => `${origin}${path}`;
+    return {
+        async detect() {
+            try {
+                const res = await fetchImpl(url("/api/onboarding/detect"), {
+                    headers: { accept: "application/json", ...tokenHeaders(token) },
+                });
+                if (!res.ok)
+                    return EMPTY_DETECTION;
+                const parsed = DetectResponseSchema.safeParse(await res.json());
+                return parsed.success ? parsed.data : EMPTY_DETECTION;
+            }
+            catch {
+                return EMPTY_DETECTION;
+            }
+        },
+        async startInstall(product) {
+            try {
+                const res = await fetchImpl(url("/api/onboarding/install"), {
+                    method: "POST",
+                    headers: { "content-type": "application/json", accept: "application/json", ...tokenHeaders(token) },
+                    body: JSON.stringify({ product }),
+                });
+                if (res.status === 409) {
+                    const parsed = InstallRefusalResponseSchema.safeParse(await res.json());
+                    return parsed.success ? parsed.data : null;
+                }
+                if (!res.ok)
+                    return null;
+                const parsed = InstallStartResponseSchema.safeParse(await res.json());
+                return parsed.success ? parsed.data : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        subscribeInstallEvents(product, onEvent) {
+            const EventSourceCtor = options.eventSourceCtor ?? globalThis.EventSource;
+            if (EventSourceCtor === undefined) {
+                // jsdom (this repo's test environment) has no EventSource, mirroring the exact gap
+                // `use-fleet-telemetry.ts` documents. Tests inject a fake constructor to exercise this path.
+                return () => { };
+            }
+            const qs = token !== "" ? `?t=${encodeURIComponent(token)}` : "";
+            let source = null;
+            try {
+                source = new EventSourceCtor(url(`/api/onboarding/install/${encodeURIComponent(product)}/events${qs}`));
+            }
+            catch {
+                return () => { };
+            }
+            // The contract names no custom SSE event type, so this subscribes to the default unnamed
+            // `message` frame (see the onboarding-client research note in the final report: if the
+            // daemon's implementation ends up naming the event, this is a one-line integration fix).
+            const handler = (event) => {
+                const raw = typeof event.data === "string" ? event.data : String(event.data);
+                try {
+                    const parsed = InstallProgressEventSchema.safeParse(JSON.parse(raw));
+                    if (parsed.success)
+                        onEvent(parsed.data);
+                }
+                catch {
+                    // A malformed frame is dropped; the next frame (or the server's on-subscribe
+                    // current-stage resend, ob-AC-17) carries the truth forward.
+                }
+            };
+            source.addEventListener("message", handler);
+            return () => {
+                try {
+                    source?.removeEventListener("message", handler);
+                    source?.close();
+                }
+                catch {
+                    // Closing an already-closed/errored source must never throw into the caller's cleanup.
+                }
+            };
+        },
+        async health() {
+            try {
+                const res = await fetchImpl(url("/api/onboarding/health"), {
+                    headers: { accept: "application/json", ...tokenHeaders(token) },
+                });
+                if (!res.ok)
+                    return UNREACHABLE_HEALTH;
+                return parseHealthResponse(await res.json());
+            }
+            catch {
+                return UNREACHABLE_HEALTH;
+            }
+        },
+        async complete() {
+            try {
+                await fetchImpl(url("/api/onboarding/complete"), { method: "POST", headers: tokenHeaders(token) });
+            }
+            catch {
+                // Best-effort: the login step navigates to the dashboard regardless (never gets the
+                // operator stuck because a completion beacon failed to land).
+            }
+        },
+        sendEvent(event, properties) {
+            const body = properties !== undefined ? { event, properties } : { event };
+            // Fire-and-forget: the caller never awaits this, so a slow/broken telemetry endpoint can
+            // never stall the guided flow. Swallow every failure silently (fail-soft telemetry posture).
+            void fetchImpl(url("/api/onboarding/event"), {
+                method: "POST",
+                headers: { "content-type": "application/json", ...tokenHeaders(token) },
+                body: JSON.stringify(body),
+            }).catch(() => { });
+        },
+    };
+}
+//# sourceMappingURL=onboarding-client.js.map

package/dist/dashboard/web/onboarding/onboarding-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-client.js","sourceRoot":"","sources":["../../../../src/dashboard/web/onboarding/onboarding-client.ts"],"names":[],"mappings":"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"}

package/dist/dashboard/web/onboarding/onboarding-hero.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The first-run HERO, PRD-009b ob-AC-4/ob-AC-5. A staggered entrance anchored by the Hive mark:
+ * the product logos rise and fade in one by one on a spring-like curve, the Hive mark settles
+ * center LAST, then the two choice buttons fade in. Pure CSS animation/transition (no new
+ * dependency); `prefers-reduced-motion` collapses every entrance to a plain opacity fade with no
+ * transform (see the `hc-onboarding-anim` rule below: the SAFE default IS the reduced-motion form,
+ * and a `(prefers-reduced-motion: no-preference)` media query is what OPTS IN to the richer motion,
+ * so an environment that cannot evaluate the media query at all still gets the safe fade).
+ */
+import React from "react";
+/** ob-AC-5, the exact two choices, verbatim copy. */
+export type OnboardingMode = "standard" | "advanced";
+export interface OnboardingHeroProps {
+    readonly assetBase: string;
+    readonly onChooseStandard: () => void;
+    readonly onChooseAdvanced: () => void;
+    /** The per-entry stagger delay (ms) between each product logo. Overridable for tests. */
+    readonly staggerMs?: number;
+}
+/**
+ * The first-run hero + the two-choice entry point. Renders unconditionally once the caller has
+ * already decided this IS a first-run (no detection re-derivation happens here, per ob-AC-2).
+ */
+export declare function OnboardingHero({ assetBase, onChooseStandard, onChooseAdvanced, staggerMs }: OnboardingHeroProps): React.JSX.Element;

package/dist/dashboard/web/onboarding/onboarding-hero.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { productLogoUrl } from "./product-copy.js";
+/** The hero's hardcoded hero mark, in the order they animate in BEFORE the Hive mark settles last. */
+const HERO_PRODUCT_MARKS = ["honeycomb", "doctor", "nectar"];
+/** One staggered hero entry (a product logo, or the Hive mark itself). */
+function HeroEntry({ src, delayMs, size, isAnchor, testId, }) {
+    return (_jsx("span", { "data-testid": testId, className: `hc-onboarding-anim${isAnchor ? " hc-onboarding-hero-anchor" : " hc-onboarding-hero-logo"}`, style: { display: "inline-flex", animationDelay: `${delayMs}ms` }, children: _jsx("img", { src: src, width: size, height: size, alt: "" }) }));
+}
+/**
+ * The first-run hero + the two-choice entry point. Renders unconditionally once the caller has
+ * already decided this IS a first-run (no detection re-derivation happens here, per ob-AC-2).
+ */
+export function OnboardingHero({ assetBase, onChooseStandard, onChooseAdvanced, staggerMs = 140 }) {
+    return (_jsxs("div", { "data-testid": "onboarding-hero", style: {
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            minHeight: "100vh",
+            padding: 32,
+            background: "var(--bg-canvas)",
+            textAlign: "center",
+        }, children: [_jsxs("div", { style: { display: "flex", flexDirection: "column", alignItems: "center", gap: 36, width: "100%", maxWidth: 620 }, children: [_jsxs("div", { "data-testid": "onboarding-hero-marks", style: { display: "flex", alignItems: "center", justifyContent: "center", gap: 20 }, children: [HERO_PRODUCT_MARKS.map((product, i) => (_jsx(HeroEntry, { testId: `onboarding-hero-logo-${product}`, src: productLogoUrl(product, assetBase), delayMs: i * staggerMs, size: 44, isAnchor: false }, product))), _jsx(HeroEntry, { testId: "onboarding-hero-mark", src: productLogoUrl("hive", assetBase), delayMs: HERO_PRODUCT_MARKS.length * staggerMs, size: 56, isAnchor: true })] }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 8 }, children: [_jsx("h1", { style: { fontSize: "var(--text-3xl)", fontWeight: 700, color: "var(--text-primary)", margin: 0, letterSpacing: "-0.02em" }, children: "Welcome to the hive" }), _jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-base)", color: "var(--text-secondary)", margin: 0 }, children: "Let\u2019s get the rest of your fleet running." })] }), _jsxs("div", { "data-testid": "onboarding-choices", className: "hc-onboarding-anim", style: {
+                            animationDelay: `${(HERO_PRODUCT_MARKS.length + 1) * staggerMs}ms`,
+                            display: "flex",
+                            gap: 16,
+                            flexWrap: "wrap",
+                            justifyContent: "center",
+                        }, children: [_jsxs("button", { type: "button", "data-testid": "onboarding-standard-button", onClick: onChooseStandard, style: choiceButtonStyle("primary"), children: [_jsx("span", { style: { fontWeight: 700 }, children: "Standard User" }), _jsx("span", { style: choiceSubtextStyle("primary"), children: "Install the fleet (recommended)" })] }), _jsxs("button", { type: "button", "data-testid": "onboarding-advanced-button", onClick: onChooseAdvanced, style: choiceButtonStyle("secondary"), children: [_jsx("span", { style: { fontWeight: 700 }, children: "Advanced User" }), _jsx("span", { style: choiceSubtextStyle("secondary"), children: "Custom installation" })] })] })] }), _jsx("style", { children: [
+                    // SAFE default: a plain opacity fade, no transform, this IS the reduced-motion form.
+                    ".hc-onboarding-anim { opacity: 0; animation: hc-onboarding-fade var(--dur-slow) var(--ease-out) both; }",
+                    "@keyframes hc-onboarding-fade { from { opacity: 0 } to { opacity: 1 } }",
+                    // Motion allowed: swap in the richer rise-and-settle keyframes, staggered by the
+                    // inline `animationDelay` each entry already carries.
+                    "@media (prefers-reduced-motion: no-preference) {",
+                    "  .hc-onboarding-hero-logo { animation-name: hc-onboarding-rise; animation-duration: 620ms; }",
+                    // The Hive mark settling last gets a spring-like overshoot curve, distinct from the
+                    // plain ease-out the product logos use, so it visually "settles" rather than just arriving.
+                    "  .hc-onboarding-hero-anchor { animation-name: hc-onboarding-settle; animation-duration: 760ms; animation-timing-function: cubic-bezier(0.34, 1.56, 0.64, 1); }",
+                    "}",
+                    "@keyframes hc-onboarding-rise { from { opacity: 0; transform: translateY(18px) scale(0.9); } to { opacity: 1; transform: translateY(0) scale(1); } }",
+                    "@keyframes hc-onboarding-settle { from { opacity: 0; transform: translateY(24px) scale(0.7); } to { opacity: 1; transform: translateY(0) scale(1); } }",
+                ].join("\n") })] }));
+}
+function choiceButtonStyle(variant) {
+    return {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "flex-start",
+        gap: 4,
+        minWidth: 220,
+        padding: "16px 22px",
+        borderRadius: "var(--radius-lg)",
+        border: variant === "primary" ? "1px solid transparent" : "1px solid var(--border-strong)",
+        background: variant === "primary" ? "var(--honey)" : "var(--bg-elevated)",
+        color: variant === "primary" ? "var(--honey-on)" : "var(--text-primary)",
+        cursor: "pointer",
+        fontFamily: "var(--font-sans)",
+        fontSize: "var(--text-base)",
+        textAlign: "left",
+    };
+}
+function choiceSubtextStyle(variant) {
+    return {
+        fontSize: "var(--text-xs)",
+        fontWeight: 500,
+        color: variant === "primary" ? "var(--honey-on)" : "var(--text-secondary)",
+        opacity: variant === "primary" ? 0.85 : 1,
+    };
+}
+//# sourceMappingURL=onboarding-hero.js.map