@legioncodeinc/hive 0.2.1 → 0.3.1

package/dist/dashboard/web/onboarding/contracts.d.ts

@@ -0,0 +1,188 @@
+/**
+ * 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";
+import type { FleetHealth, FleetStatusResponse } from "../../../shared/fleet-readiness.js";
+/** Every product the daemon reports detection for (hive is always present; it is the caller). */
+export declare const ONBOARDING_PRODUCTS: readonly ["honeycomb", "doctor", "hive", "nectar"];
+export type OnboardingProduct = (typeof ONBOARDING_PRODUCTS)[number];
+/** The three INSTALLABLE products, in the fixed order the guided flow walks them (ob-AC-6). */
+export declare const FIXED_PRODUCT_ORDER: readonly ["doctor", "honeycomb", "nectar"];
+export type InstallableProduct = (typeof FIXED_PRODUCT_ORDER)[number];
+export declare function isInstallableProduct(value: string): value is InstallableProduct;
+export declare const PRODUCT_INSTALL_STATES: readonly ["not_installed", "installed", "install_in_progress", "install_failed"];
+export type ProductInstallState = (typeof PRODUCT_INSTALL_STATES)[number];
+declare const ProductErrorSchema: z.ZodObject<{
+    stage: z.ZodCatch<z.ZodString>;
+    summary: z.ZodCatch<z.ZodString>;
+}, z.core.$strip>;
+export type ProductInstallError = z.infer<typeof ProductErrorSchema>;
+declare const ProductDetectionSchema: z.ZodObject<{
+    state: z.ZodCatch<z.ZodEnum<{
+        not_installed: "not_installed";
+        installed: "installed";
+        install_in_progress: "install_in_progress";
+        install_failed: "install_failed";
+    }>>;
+    version: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodObject<{
+        stage: z.ZodCatch<z.ZodString>;
+        summary: z.ZodCatch<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProductDetection = z.infer<typeof ProductDetectionSchema>;
+/** The safe default for a product the response omitted (never assume installed). */
+export declare const DEFAULT_PRODUCT_DETECTION: ProductDetection;
+export declare const DetectResponseSchema: z.ZodObject<{
+    products: z.ZodCatch<z.ZodObject<{
+        honeycomb: z.ZodOptional<z.ZodObject<{
+            state: z.ZodCatch<z.ZodEnum<{
+                not_installed: "not_installed";
+                installed: "installed";
+                install_in_progress: "install_in_progress";
+                install_failed: "install_failed";
+            }>>;
+            version: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodObject<{
+                stage: z.ZodCatch<z.ZodString>;
+                summary: z.ZodCatch<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        doctor: z.ZodOptional<z.ZodObject<{
+            state: z.ZodCatch<z.ZodEnum<{
+                not_installed: "not_installed";
+                installed: "installed";
+                install_in_progress: "install_in_progress";
+                install_failed: "install_failed";
+            }>>;
+            version: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodObject<{
+                stage: z.ZodCatch<z.ZodString>;
+                summary: z.ZodCatch<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        hive: z.ZodOptional<z.ZodObject<{
+            state: z.ZodCatch<z.ZodEnum<{
+                not_installed: "not_installed";
+                installed: "installed";
+                install_in_progress: "install_in_progress";
+                install_failed: "install_failed";
+            }>>;
+            version: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodObject<{
+                stage: z.ZodCatch<z.ZodString>;
+                summary: z.ZodCatch<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        nectar: z.ZodOptional<z.ZodObject<{
+            state: z.ZodCatch<z.ZodEnum<{
+                not_installed: "not_installed";
+                installed: "installed";
+                install_in_progress: "install_in_progress";
+                install_failed: "install_failed";
+            }>>;
+            version: z.ZodOptional<z.ZodString>;
+            error: z.ZodOptional<z.ZodObject<{
+                stage: z.ZodCatch<z.ZodString>;
+                summary: z.ZodCatch<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DetectResponse = z.infer<typeof DetectResponseSchema>;
+/** The honest "nothing detected yet" default (a fetch failure never fabricates an installed product). */
+export declare const EMPTY_DETECTION: DetectResponse;
+/** Read one product's detection, defaulting to {@link DEFAULT_PRODUCT_DETECTION} when omitted. */
+export declare function detectionFor(detection: DetectResponse, product: OnboardingProduct): ProductDetection;
+/** ob-AC-3, every one of the four products reports `installed`. */
+export declare function isFleetFullyInstalled(detection: DetectResponse): boolean;
+/**
+ * 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 declare function remainingProducts(detection: DetectResponse): readonly InstallableProduct[];
+/**
+ * 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 declare function hasResumableInstall(detection: DetectResponse): boolean;
+/**
+ * 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 declare function buildResumeQueue(detection: DetectResponse, persistedSelection: readonly InstallableProduct[] | null): readonly InstallableProduct[];
+export declare const InstallStartResponseSchema: z.ZodObject<{
+    product: z.ZodCatch<z.ZodEnum<{
+        honeycomb: "honeycomb";
+        nectar: "nectar";
+        doctor: "doctor";
+    }>>;
+    state: z.ZodCatch<z.ZodEnum<{
+        installed: "installed";
+        install_in_progress: "install_in_progress";
+    }>>;
+}, z.core.$strip>;
+export type InstallStartResponse = z.infer<typeof InstallStartResponseSchema>;
+/** `POST /api/onboarding/install` -> 409 refusal (is-AC-5). */
+export declare const InstallRefusalResponseSchema: z.ZodObject<{
+    error: z.ZodEnum<{
+        unpublished: "unpublished";
+        manifest_unresolved: "manifest_unresolved";
+    }>;
+}, z.core.$strip>;
+export type InstallRefusalResponse = z.infer<typeof InstallRefusalResponseSchema>;
+export type InstallStartResult = InstallStartResponse | InstallRefusalResponse;
+/** Honest operator copy for installer refusals (409), with the same retry affordance as other failures. */
+export declare function installRefusalMessage(error: InstallRefusalResponse["error"]): string;
+/** The four REAL, observable install stages plus the two terminal outcomes (ob-AC-9: never a percent). */
+export declare const INSTALL_STAGES: readonly ["resolving", "downloading", "linking", "registering_service", "completed", "failed"];
+export type InstallStage = (typeof INSTALL_STAGES)[number];
+/** The four IN-FLIGHT stages, in display order (excludes the two terminal outcomes). */
+export declare const IN_FLIGHT_STAGES: readonly ["resolving", "downloading", "linking", "registering_service"];
+export declare const InstallProgressEventSchema: z.ZodObject<{
+    stage: z.ZodCatch<z.ZodEnum<{
+        resolving: "resolving";
+        downloading: "downloading";
+        linking: "linking";
+        registering_service: "registering_service";
+        completed: "completed";
+        failed: "failed";
+    }>>;
+    detail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type InstallProgressEvent = z.infer<typeof InstallProgressEventSchema>;
+export interface HealthResponse {
+    readonly ready: boolean;
+    readonly status: FleetStatusResponse;
+}
+/** The honest "daemon unreachable" default a failed/malformed health read degrades to. */
+export declare const UNREACHABLE_HEALTH: HealthResponse;
+/**
+ * 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 declare function parseHealthResponse(body: unknown): HealthResponse;
+/** Re-exported so onboarding modules read the daemon health vocabulary from one place. */
+export type { FleetHealth, FleetStatusResponse };
+/** The exact UI-fired event names (product install + health events are daemon-side, never sent here). */
+export declare const ONBOARDING_UI_EVENTS: readonly ["onboarding_started", "mode_selected", "login_shown", "dashboard_reached"];
+export type OnboardingUiEvent = (typeof ONBOARDING_UI_EVENTS)[number];

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,28 @@
+/**
+ * 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 { 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 brief minimum dwell (ob-AC-11, revised). A test injects a short window. */
+    readonly minDwellMs?: number;
+}
+export declare function InstallCard({ product, initialDetection, client, assetBase, onAdvance, minDwellMs }: InstallCardProps): React.JSX.Element;