@legioncodeinc/hive 0.2.0 → 0.3.0

package/dist/dashboard/web/onboarding/contracts.js

@@ -0,0 +1,161 @@
+/**
+ * The `/onboarding` route's WIRE CONTRACT, PRD-009b, mirroring the daemon-side installer service
+ * from PRD-009a (`src/daemon/installer/`). `src/shared/onboarding-types.ts` is being authored in
+ * parallel by the daemon-side agent; these are LOCAL types matching that contract's field names
+ * exactly (per the implementation brief), so a later integration pass can point imports at the
+ * shared module without changing a single field name.
+ *
+ * Every schema mirrors the `wire.ts` convention: zod at the boundary, every field `.catch()`-
+ * defaulted so a partial/malformed body degrades to a safe empty state rather than throwing into
+ * React (the onboarding screen is the FIRST thing a new operator sees: it must never white-screen).
+ */
+import { z } from "zod";
+// ─────────────────────────────────────────────────────────────────────────────
+// Product identity
+// ─────────────────────────────────────────────────────────────────────────────
+/** Every product the daemon reports detection for (hive is always present; it is the caller). */
+export const ONBOARDING_PRODUCTS = ["honeycomb", "doctor", "hive", "nectar"];
+/** The three INSTALLABLE products, in the fixed order the guided flow walks them (ob-AC-6). */
+export const FIXED_PRODUCT_ORDER = ["doctor", "honeycomb", "nectar"];
+export function isInstallableProduct(value) {
+    return FIXED_PRODUCT_ORDER.includes(value);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// GET /api/onboarding/detect
+// ─────────────────────────────────────────────────────────────────────────────
+export const PRODUCT_INSTALL_STATES = ["not_installed", "installed", "install_in_progress", "install_failed"];
+const ProductErrorSchema = z.object({
+    stage: z.string().catch(""),
+    summary: z.string().catch(""),
+});
+const ProductDetectionSchema = z.object({
+    state: z.enum(PRODUCT_INSTALL_STATES).catch("not_installed"),
+    version: z.string().optional(),
+    error: ProductErrorSchema.optional(),
+});
+/** The safe default for a product the response omitted (never assume installed). */
+export const DEFAULT_PRODUCT_DETECTION = Object.freeze({ state: "not_installed" });
+// Every product key is OPTIONAL (a partial object, not a `z.record` over the enum): the daemon
+// contract never guarantees all four keys ride every response, and "omitted" must degrade to
+// {@link DEFAULT_PRODUCT_DETECTION} per-product rather than failing the WHOLE `products` object
+// (which a zod `z.record` over a finite enum key would do, since that shape requires every key).
+export const DetectResponseSchema = z.object({
+    products: z
+        .object({
+        honeycomb: ProductDetectionSchema.optional(),
+        doctor: ProductDetectionSchema.optional(),
+        hive: ProductDetectionSchema.optional(),
+        nectar: ProductDetectionSchema.optional(),
+    })
+        .catch({}),
+});
+/** The honest "nothing detected yet" default (a fetch failure never fabricates an installed product). */
+export const EMPTY_DETECTION = Object.freeze({ products: {} });
+/** Read one product's detection, defaulting to {@link DEFAULT_PRODUCT_DETECTION} when omitted. */
+export function detectionFor(detection, product) {
+    return detection.products[product] ?? DEFAULT_PRODUCT_DETECTION;
+}
+/** ob-AC-3, every one of the four products reports `installed`. */
+export function isFleetFullyInstalled(detection) {
+    return ONBOARDING_PRODUCTS.every((p) => detectionFor(detection, p).state === "installed");
+}
+/**
+ * The remaining (not-yet-installed) installable products, in the FIXED order, the set both the
+ * Standard flow (ob-AC-6, unfiltered) and the Advanced picker (ob-AC-7, pre-checked) start from.
+ */
+export function remainingProducts(detection) {
+    return FIXED_PRODUCT_ORDER.filter((p) => detectionFor(detection, p).state !== "installed");
+}
+/**
+ * ob-AC-16/ob-AC-17, true when detection shows an install already under way or failed for one of
+ * the remaining products, meaning a choice (Standard or Advanced) was already made in a prior
+ * visit. The resumed queue is simply {@link remainingProducts} walked from the top: any product
+ * already `installed` is filtered out, and the first remaining entry is exactly the one that was
+ * mid-flight or failed (re-attached, never re-offered the hero/picker).
+ */
+export function hasResumableInstall(detection) {
+    return remainingProducts(detection).some((p) => {
+        const state = detectionFor(detection, p).state;
+        return state === "install_in_progress" || state === "install_failed";
+    });
+}
+/**
+ * The queue to resume with (ob-AC-16), honoring the operator's original subset when it is known.
+ * `remainingProducts` alone would reinstall a product the operator explicitly DESELECTED in the
+ * Advanced picker, because the daemon has no server-side memory of that subset. When a persisted
+ * selection exists (see onboarding-selection-store), the resume queue is the remaining products
+ * intersected with it, so a deselected product is never silently reinstalled. When no selection is
+ * persisted (a fresh browser, cleared storage), any product that is genuinely mid-flight or failed
+ * is still resumed (an in-flight fact, not an assumption); a merely `not_installed` product with no
+ * persisted intent is left out, so the flow never installs something the operator did not choose.
+ */
+export function buildResumeQueue(detection, persistedSelection) {
+    const remaining = remainingProducts(detection);
+    if (persistedSelection !== null) {
+        return remaining.filter((p) => persistedSelection.includes(p));
+    }
+    return remaining.filter((p) => {
+        const state = detectionFor(detection, p).state;
+        return state === "install_in_progress" || state === "install_failed";
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// POST /api/onboarding/install
+// ─────────────────────────────────────────────────────────────────────────────
+export const InstallStartResponseSchema = z.object({
+    product: z.enum(FIXED_PRODUCT_ORDER).catch("doctor"),
+    state: z.enum(["install_in_progress", "installed"]).catch("install_in_progress"),
+});
+/** `POST /api/onboarding/install` -> 409 refusal (is-AC-5). */
+export const InstallRefusalResponseSchema = z.object({
+    error: z.enum(["unpublished", "manifest_unresolved"]),
+});
+/** Honest operator copy for installer refusals (409), with the same retry affordance as other failures. */
+export function installRefusalMessage(error) {
+    if (error === "unpublished") {
+        return "This product is not published to npm yet, so the installer will not pull it. Retry after the release train publishes the package.";
+    }
+    return "The fleet version manifest could not be resolved, so the installer does not know which package version to install. Retry after the manifest is available.";
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// GET /api/onboarding/install/:product/events (SSE)
+// ─────────────────────────────────────────────────────────────────────────────
+/** The four REAL, observable install stages plus the two terminal outcomes (ob-AC-9: never a percent). */
+export const INSTALL_STAGES = ["resolving", "downloading", "linking", "registering_service", "completed", "failed"];
+/** The four IN-FLIGHT stages, in display order (excludes the two terminal outcomes). */
+export const IN_FLIGHT_STAGES = ["resolving", "downloading", "linking", "registering_service"];
+export const InstallProgressEventSchema = z.object({
+    stage: z.enum(INSTALL_STAGES).catch("resolving"),
+    detail: z.string().optional(),
+});
+/** The honest "daemon unreachable" default a failed/malformed health read degrades to. */
+export const UNREACHABLE_HEALTH = Object.freeze({
+    ready: false,
+    status: { supervisor: "unreachable", daemons: [] },
+});
+/**
+ * Parse a `GET /api/onboarding/health` body leniently (mirrors `buzzing-screen.tsx`'s established
+ * `as FleetStatusResponse` cast for this exact daemon-owned union, {@link FleetStatusResponse} is
+ * a discriminated union keyed on `supervisor`, not a flat shape zod's object schemas model cleanly,
+ * and the existing precedent already trusts the daemon's own `isFleetReady`-validated projection).
+ */
+export function parseHealthResponse(body) {
+    if (typeof body !== "object" || body === null)
+        return UNREACHABLE_HEALTH;
+    const record = body;
+    const ready = typeof record.ready === "boolean" ? record.ready : false;
+    const status = isFleetStatusShaped(record.status) ? record.status : UNREACHABLE_HEALTH.status;
+    return { ready, status };
+}
+function isFleetStatusShaped(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const supervisor = value.supervisor;
+    return supervisor === "reachable" || supervisor === "unreachable";
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// POST /api/onboarding/event, the UI funnel chokepoint (fire-and-forget, never awaited by callers)
+// ─────────────────────────────────────────────────────────────────────────────
+/** The exact UI-fired event names (product install + health events are daemon-side, never sent here). */
+export const ONBOARDING_UI_EVENTS = ["onboarding_started", "mode_selected", "login_shown", "dashboard_reached"];
+//# sourceMappingURL=contracts.js.map

package/dist/dashboard/web/onboarding/contracts.js.map

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

package/dist/dashboard/web/onboarding/health-view.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The GREEN-LIGHT HEALTH step, PRD-009b ob-AC-13. Polls `GET /api/onboarding/health` until the
+ * fleet reads ready, rendering one row per reported daemon using the SAME bee-state vocabulary
+ * `/buzzing` renders (`service-icons.tsx` / `service-status.ts`), so a health-conscious operator
+ * sees a consistent visual language across the whole onboarding-to-dashboard journey.
+ */
+import React from "react";
+import type { OnboardingClient } from "./onboarding-client.js";
+export interface HealthViewProps {
+    readonly client: OnboardingClient;
+    /** Called once `ready:true` is observed. */
+    readonly onReady: () => void;
+    /** Overrides the poll interval (ms). Defaults to 1500, mirroring `/buzzing`'s dismissal poll. */
+    readonly pollMs?: number;
+}
+/** ob-AC-13, the fleet reads ready only once; this screen stops polling the instant it does. */
+export declare function HealthView({ client, onReady, pollMs }: HealthViewProps): React.JSX.Element;

package/dist/dashboard/web/onboarding/health-view.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The GREEN-LIGHT HEALTH step, PRD-009b ob-AC-13. Polls `GET /api/onboarding/health` until the
+ * fleet reads ready, rendering one row per reported daemon using the SAME bee-state vocabulary
+ * `/buzzing` renders (`service-icons.tsx` / `service-status.ts`), so a health-conscious operator
+ * sees a consistent visual language across the whole onboarding-to-dashboard journey.
+ */
+import React from "react";
+import { deriveServiceState, fromFleetDaemonStatus } from "../../../shared/service-status.js";
+import { SERVICE_STATE_COLOR, SERVICE_STATE_LABEL, ServiceStateIcon } from "../service-icons.js";
+/** ob-AC-13, the fleet reads ready only once; this screen stops polling the instant it does. */
+export function HealthView({ client, onReady, pollMs = 1500 }) {
+    const [daemons, setDaemons] = React.useState([]);
+    const [ready, setReady] = React.useState(false);
+    React.useEffect(() => {
+        if (ready)
+            return;
+        let alive = true;
+        let inFlight = false;
+        const tick = async () => {
+            if (inFlight)
+                return;
+            inFlight = true;
+            try {
+                const result = await client.health();
+                if (!alive)
+                    return;
+                setDaemons(result.status.supervisor === "reachable" ? result.status.daemons : []);
+                if (result.ready)
+                    setReady(true);
+            }
+            finally {
+                inFlight = false;
+            }
+        };
+        void tick();
+        const id = setInterval(() => void tick(), pollMs);
+        return () => {
+            alive = false;
+            clearInterval(id);
+        };
+    }, [ready, pollMs, client]);
+    React.useEffect(() => {
+        if (ready)
+            onReady();
+    }, [ready, onReady]);
+    return (_jsx("div", { "data-testid": "onboarding-health-view", 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: 480,
+                padding: "40px 36px",
+                background: "var(--bg-surface)",
+                border: "1px solid var(--border-default)",
+                borderRadius: "var(--radius-xl)",
+            }, children: [_jsx("h1", { style: { fontSize: "var(--text-2xl)", fontWeight: 700, color: "var(--text-primary)", margin: 0, letterSpacing: "-0.02em" }, children: "Bringing the fleet up green" }), _jsx("p", { style: { fontFamily: "var(--font-sans)", fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: "One last check before your dashboard: every daemon needs to report healthy." }), _jsx("ul", { role: "status", "aria-live": "polite", style: { listStyle: "none", margin: 0, padding: 0, display: "flex", flexDirection: "column", gap: 8, width: "100%", textAlign: "left" }, children: daemons.length === 0 ? (_jsx("li", { style: { fontFamily: "var(--font-mono)", fontSize: "var(--text-xs)", color: "var(--text-tertiary)" }, children: "Checking the fleet\u2026" })) : (daemons.map((daemon) => {
+                        const state = deriveServiceState({ signal: fromFleetDaemonStatus(daemon), now: Date.now(), firstActiveAt: null });
+                        return (_jsxs("li", { "data-testid": `onboarding-health-row-${daemon.name}`, "data-state": state, style: {
+                                display: "flex",
+                                alignItems: "center",
+                                gap: 12,
+                                padding: "10px 14px",
+                                borderRadius: "var(--radius-md)",
+                                border: "1px solid var(--border-subtle)",
+                                background: "var(--bg-elevated)",
+                            }, children: [_jsx("span", { style: { color: SERVICE_STATE_COLOR[state], display: "inline-flex", flex: "none" }, children: _jsx(ServiceStateIcon, { state: state }) }), _jsx("span", { style: { flex: 1, fontFamily: "var(--font-sans)", fontSize: "var(--text-sm)", color: "var(--text-primary)" }, children: daemon.name }), _jsx("span", { style: { fontFamily: "var(--font-mono)", fontSize: "var(--text-xs)", color: "var(--text-secondary)" }, children: SERVICE_STATE_LABEL[state] })] }, daemon.name));
+                    })) })] }) }));
+}
+//# sourceMappingURL=health-view.js.map

package/dist/dashboard/web/onboarding/health-view.js.map

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

package/dist/dashboard/web/onboarding/install-card.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 minimum ~30s dwell on success (ob-AC-11) 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 { type InstallableProduct, type ProductDetection } from "./contracts.js";
+import type { OnboardingClient } from "./onboarding-client.js";
+export interface InstallCardProps {
+    readonly product: InstallableProduct;
+    /** The daemon's detection truth for THIS product at the moment the card mounted (ob-AC-16). */
+    readonly initialDetection: ProductDetection;
+    readonly client: OnboardingClient;
+    readonly assetBase: string;
+    /** Called once this product's install has both completed AND satisfied its minimum dwell. */
+    readonly onAdvance: () => void;
+    /** Overrides the default ~30s minimum dwell (ob-AC-11). A test injects a short window. */
+    readonly minDwellMs?: number;
+}
+export declare function InstallCard({ product, initialDetection, client, assetBase, onAdvance, minDwellMs }: InstallCardProps): React.JSX.Element;

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

@@ -0,0 +1,170 @@
+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 minimum ~30s dwell on success (ob-AC-11) 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;