@legioncodeinc/hive 0.1.0

package/dist/dashboard/web/setup-gate.js

@@ -0,0 +1,272 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * The `/login` route's GUIDED-SETUP content — PRD-050b (b-AC-3 / b-AC-6) · PRD-003b (l-AC-1
+ * through l-AC-8, relocating this view from a pre-mount React gate to its own path).
+ *
+ * `/login` is served by hive's server ONLY when the portal gate (`gate.ts`, PRD-003a) has
+ * already determined the operator is NOT logged in (or the operator landed here directly — `/login`
+ * is gate-exempt, l-AC-3). So this module no longer decides "pre-auth vs authenticated" itself —
+ * that decision is the server's. {@link LoginScreen} renders ONE of:
+ *
+ *   - the plain first-time {@link GuidedSetup} screen — a clear "let's connect your account" panel
+ *     fronted by the **"First time setup"** button (b-AC-6). The button BEGINS the on-page device
+ *     flow (`POST /setup/login`, proxied per l-AC-1/l-AC-2) and shows the returned `user_code` +
+ *     the verification link; the daemon keeps polling → mint → persist in the background.
+ *   - {@link MigrationInterrupted} / {@link CoexistenceWarning} when `/setup/state` reports one of
+ *     those states (unchanged from the prior pre-auth gate; only the addressing moved).
+ *
+ * ── The live transition is a POLL, then a hard navigation (l-AC-7 / l-AC-8) ──
+ * While on `/login` this screen polls `setupState()` on an interval, exactly like the retired
+ * pre-mount gate did. The instant the login flow writes the shared credential, the next poll
+ * reports `authenticated: true`; instead of swapping to a client-rendered `<Shell>` (the old
+ * behavior), this screen does a HARD navigation (`window.location.assign("/")`) so hive's
+ * server gate re-validates health+auth and serves the authoritative next screen. This keeps the
+ * gate — not this component — as the single source of truth for "where does an authenticated
+ * operator land" (ADR-0004), and correctly falls back to `/buzzing` instead of the dashboard if
+ * the fleet happens to be unhealthy at that exact moment.
+ *
+ * ── b-AC-6: the button is PRESENT in fresh-install, ABSENT once linked ───────
+ * The "First time setup" button renders ONLY in the pre-auth branch. Once `authenticated` flips
+ * true the whole {@link GuidedSetup} subtree (button included) unmounts as this screen navigates
+ * away — so the button is structurally absent in the linked state, not merely hidden.
+ *
+ * ── No token, no secret, no portal session (l-AC-5) ──────────────────────────
+ * This screen reads only `/setup/state` (install metadata) and `/setup/login` (user_code + URIs).
+ * NO token crosses either wire (the schemas have no token field by construction), and it creates,
+ * stores, or reads no portal-specific cookie or session — credential presence via `/setup/state` is
+ * the sole source of truth (ADR-0004's rejection of a portal session).
+ */
+import React from "react";
+import { Button } from "./primitives.js";
+import { createWireClient, FRESH_SETUP_STATE, } from "./wire.js";
+/** How often the pre-auth screen polls `/setup/state` for the live transition (ms). */
+export const SETUP_POLL_MS = 2500;
+/** The migration sub-phases that mean "interrupted, not terminal" (d-AC-7 resume/rollback trigger). */
+const NON_TERMINAL_MIGRATION_PHASES = new Set(["backup", "uninstall", "link"]);
+/**
+ * True when the setup state shows an INTERRUPTED migration (a non-terminal `migration.phase`) — the
+ * dashboard must then present the resume/rollback affordance, NEVER a clean state (d-AC-7).
+ */
+export function isMigrationInterrupted(state) {
+    return state.migration !== undefined && NON_TERMINAL_MIGRATION_PHASES.has(state.migration.phase);
+}
+/**
+ * True when the setup state shows a PRIOR Hivemind install that has NOT yet been migrated (d-AC-1) — the
+ * dashboard renders the coexistence-warning wizard rather than the plain first-time state. Keys off the
+ * derived `priorTool.hivemind === "present"` (or the raw `~/.hivemind` dir presence), and is suppressed
+ * once `priorTool.hivemind === "migrated"`.
+ */
+export function hasUnmigratedPriorHivemind(state) {
+    if (state.priorTool.hivemind === "migrated")
+        return false;
+    return state.priorTool.hivemind === "present" || state.credentials.hivemind;
+}
+/**
+ * The guided-setup PRE-AUTH screen (b-AC-6). A single centered panel: the brand mark, a short
+ * "connect your account" line, and the "First time setup" button that begins the on-page login. Once
+ * the login grant arrives the panel shows the `user_code` + the verification link (the daemon polls →
+ * persists in the background; the parent {@link LoginScreen} polls `/setup/state` and hard-navigates
+ * to the dashboard when the credential lands). The migration variant (a detected prior Hivemind) is 050d.
+ */
+export function GuidedSetup({ wire, assetBase, state, }) {
+    const [grant, setGrant] = React.useState(null);
+    const [busy, setBusy] = React.useState(false);
+    const [error, setError] = React.useState(false);
+    // A synchronous in-flight guard so a rapid double-click never fires two device flows.
+    const inFlightRef = React.useRef(false);
+    const beginSetup = React.useCallback(async () => {
+        if (inFlightRef.current)
+            return;
+        inFlightRef.current = true;
+        setBusy(true);
+        setError(false);
+        const result = await wire.setupLogin();
+        if (result === null) {
+            // The device flow could not begin (502 / network). Show an honest error; the user can
+            // retry the button or fall back to the `honeycomb login` CLI.
+            setError(true);
+            setBusy(false);
+            inFlightRef.current = false;
+            return;
+        }
+        setGrant(result);
+        // Leave `busy` true: the page now waits for the background poll (in LoginScreen) to flip to the
+        // authenticated dashboard once the credential lands. The button stays disabled meanwhile.
+    }, [wire]);
+    // A prior Hivemind install is a HINT for the copy (050d owns the migration path); 050b only
+    // surfaces it as a sub-line so the fresh-install vs has-prior-tool states read differently.
+    const hasPriorHivemind = state.priorTool.hivemind === "present" || state.credentials.hivemind;
+    return (_jsxs("div", { "data-testid": "guided-setup", style: {
+            display: "flex",
+            flexDirection: "column",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: 18,
+            minHeight: "100vh",
+            padding: "28px",
+            background: "var(--bg-canvas)",
+            textAlign: "center",
+        }, children: [_jsx("img", { src: `${assetBase}/honeycomb-memory-cluster.svg`, width: 56, height: 56, alt: "" }), _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: "Let\u2019s connect your account" }), _jsx("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: hasPriorHivemind
+                            ? "We found a previous Hivemind setup. Link your account to bring your memory online."
+                            : "Honeycomb keeps one shared memory for all your coding agents. Link your account to get started." })] }), grant === null ? (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "primary", size: "lg", onClick: () => void beginSetup(), disabled: busy, children: busy ? "Starting setup…" : "First time setup" }), error && (_jsxs("p", { "data-testid": "setup-error", style: { fontSize: "var(--text-sm)", color: "var(--severity-critical)", margin: 0 }, children: ["Could not start setup. Retry, or run ", _jsx("code", { children: "honeycomb login" }), " in your terminal."] }))] })) : (_jsxs("div", { "data-testid": "setup-grant", style: { display: "flex", flexDirection: "column", gap: 10, alignItems: "center" }, children: [_jsx("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0 }, children: "Enter this code to finish linking:" }), _jsx("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", 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" })] }))] }));
+}
+/**
+ * The COEXISTENCE-WARNING wizard — PRD-050d (d-AC-1 / d-AC-2 / d-AC-3 / d-AC-4). Renders instead of the
+ * plain first-time {@link GuidedSetup} when a prior, un-migrated Hivemind install is detected. It states
+ * — BEFORE any destructive action — that running Hivemind and Honeycomb together is UNSUPPORTED and what
+ * "Proceed with Honeycomb" does (back up + uninstall Hivemind, then reuse the shared login), then gates
+ * the migrate call behind an explicit CONFIRM step (d-AC-2).
+ *
+ * On "Proceed" it POSTs `migrateFromHivemind`: a `migrated` result lets the parent's `/setup/state` poll
+ * flip to the dashboard (no re-auth — the shared credential was adopted, d-AC-4); a `needsLogin` result
+ * hands off to the on-page device flow ({@link GuidedSetup}'s login button, the 050c `--ref mario` flow);
+ * an `ok:false` partial failure shows the plain-language message + the backup path (d-AC-5), never a stack.
+ */
+export function CoexistenceWarning({ wire, assetBase, onNeedsLogin, }) {
+    const [confirming, setConfirming] = React.useState(false);
+    const [busy, setBusy] = React.useState(false);
+    const [result, setResult] = React.useState(null);
+    const inFlightRef = React.useRef(false);
+    const proceed = React.useCallback(async () => {
+        if (inFlightRef.current)
+            return;
+        inFlightRef.current = true;
+        setBusy(true);
+        const r = await wire.migrateFromHivemind();
+        setResult(r);
+        if (r.ok && r.needsLogin === true) {
+            // Uninstall done; the shared credential was not adoptable → run the 050c device flow.
+            onNeedsLogin();
+            return;
+        }
+        // `migrated` success: leave `busy` true — the parent LoginScreen poll hard-navigates once
+        // `/setup/state.authenticated` lands. A partial failure (`ok:false`) re-enables retry below.
+        if (!r.ok) {
+            setBusy(false);
+            inFlightRef.current = false;
+        }
+    }, [wire, onNeedsLogin]);
+    return (_jsxs("div", { "data-testid": "coexistence-warning", style: {
+            display: "flex",
+            flexDirection: "column",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: 18,
+            minHeight: "100vh",
+            padding: "28px",
+            background: "var(--bg-canvas)",
+            textAlign: "center",
+        }, children: [_jsx("img", { src: `${assetBase}/honeycomb-memory-cluster.svg`, width: 56, height: 56, alt: "" }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 10, maxWidth: 500 }, children: [_jsx("h1", { style: { fontSize: "var(--text-xl)", fontWeight: 700, color: "var(--text-primary)", margin: 0, letterSpacing: "-0.02em" }, children: "We found an existing Hivemind setup" }), _jsxs("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: ["Running Hivemind and Honeycomb on the same machine isn\u2019t supported \u2014 they share one memory and would collide. ", _jsx("strong", { children: "Proceed with Honeycomb" }), " will back up your Hivemind config, uninstall Hivemind, and reuse your existing DeepLake login (so you likely won\u2019t even need to sign in again)."] })] }), result !== null && result.ok === false ? (_jsxs("div", { "data-testid": "migration-error", style: { display: "flex", flexDirection: "column", gap: 10, alignItems: "center", maxWidth: 500 }, children: [_jsx("p", { style: { fontSize: "var(--text-sm)", color: "var(--severity-critical)", margin: 0 }, children: result.message }), result.backupPath !== undefined && (_jsxs("p", { style: { fontSize: "var(--text-xs)", color: "var(--text-tertiary)", margin: 0 }, children: ["Backup saved at ", _jsx("code", { style: { fontFamily: "var(--font-mono)" }, children: result.backupPath })] })), _jsx(Button, { variant: "primary", size: "lg", onClick: () => void proceed(), disabled: busy, children: busy ? "Retrying…" : "Retry" })] })) : !confirming ? (_jsx(Button, { variant: "primary", size: "lg", onClick: () => setConfirming(true), "data-testid": "proceed-button", children: "Proceed with Honeycomb" })) : (_jsxs("div", { "data-testid": "migration-confirm", style: { display: "flex", flexDirection: "column", gap: 10, alignItems: "center" }, children: [_jsx("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0 }, children: "This backs up and removes your Hivemind setup. Continue?" }), _jsxs("div", { style: { display: "flex", gap: 10 }, children: [_jsx(Button, { variant: "secondary", size: "md", onClick: () => setConfirming(false), disabled: busy, children: "Cancel" }), _jsx(Button, { variant: "danger", size: "md", onClick: () => void proceed(), disabled: busy, "data-testid": "confirm-migrate-button", children: busy ? "Migrating…" : "Yes, proceed" })] })] }))] }));
+}
+/**
+ * The INTERRUPTED-MIGRATION surface — PRD-050d (d-AC-7). Rendered when `/setup/state` reports a
+ * NON-TERMINAL `migration.phase` (a daemon crash mid-migration). It NEVER presents the machine as cleanly
+ * migrated or cleanly reverted: it states the migration was interrupted and offers RESUME (re-run the
+ * idempotent migration) or ROLL BACK (restore the Hivemind backup). The backup path is shown for trust.
+ */
+export function MigrationInterrupted({ wire, assetBase, state, onNeedsLogin, }) {
+    const [busy, setBusy] = React.useState("");
+    const [message, setMessage] = React.useState(null);
+    const phase = state.migration?.phase ?? "backup";
+    const backupPath = state.migration?.backupPath;
+    const resume = React.useCallback(async () => {
+        setBusy("resume");
+        const r = await wire.migrateFromHivemind();
+        setMessage(r.message);
+        if (r.ok && r.needsLogin === true) {
+            onNeedsLogin();
+            return;
+        }
+        // On success the parent poll flips to the dashboard; on failure leave the message + re-enable.
+        if (!r.ok)
+            setBusy("");
+    }, [wire, onNeedsLogin]);
+    const rollback = React.useCallback(async () => {
+        setBusy("rollback");
+        const r = await wire.rollbackMigration();
+        setMessage(r.message);
+        // After a rollback the parent poll re-reads `/setup/state` (now `rolled_back`, terminal) and the
+        // coexistence-warning re-renders from a clean restored state; re-enable the buttons regardless.
+        setBusy("");
+    }, [wire]);
+    return (_jsxs("div", { "data-testid": "migration-interrupted", style: {
+            display: "flex",
+            flexDirection: "column",
+            alignItems: "center",
+            justifyContent: "center",
+            gap: 18,
+            minHeight: "100vh",
+            padding: "28px",
+            background: "var(--bg-canvas)",
+            textAlign: "center",
+        }, children: [_jsx("img", { src: `${assetBase}/honeycomb-memory-cluster.svg`, width: 56, height: 56, alt: "" }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 10, maxWidth: 500 }, children: [_jsx("h1", { style: { fontSize: "var(--text-xl)", fontWeight: 700, color: "var(--text-primary)", margin: 0, letterSpacing: "-0.02em" }, children: "Your migration was interrupted" }), _jsxs("p", { style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0, lineHeight: 1.5 }, children: ["A previous switch to Honeycomb didn\u2019t finish (it stopped at the ", _jsx("code", { children: phase }), " step). You can resume it, or roll back to restore your previous Hivemind setup."] }), backupPath !== undefined && (_jsxs("p", { style: { fontSize: "var(--text-xs)", color: "var(--text-tertiary)", margin: 0 }, children: ["Backup at ", _jsx("code", { style: { fontFamily: "var(--font-mono)" }, children: backupPath })] }))] }), _jsxs("div", { style: { display: "flex", gap: 10 }, children: [_jsx(Button, { variant: "primary", size: "md", onClick: () => void resume(), disabled: busy !== "", "data-testid": "resume-button", children: busy === "resume" ? "Resuming…" : "Resume" }), _jsx(Button, { variant: "secondary", size: "md", onClick: () => void rollback(), disabled: busy !== "", "data-testid": "rollback-button", children: busy === "rollback" ? "Rolling back…" : "Roll back" })] }), message !== null && (_jsx("p", { "data-testid": "migration-interrupted-message", style: { fontSize: "var(--text-sm)", color: "var(--text-secondary)", margin: 0 }, children: message }))] }));
+}
+/**
+ * The `/login` route's top-level content (b-AC-3 / b-AC-6 / d-AC-1 / d-AC-7 / l-AC-1 / l-AC-7 /
+ * l-AC-8). Polls `/setup/state` and renders ONE of:
+ *   - the {@link MigrationInterrupted} resume/rollback surface when a migration is mid-flight (d-AC-7);
+ *   - the {@link CoexistenceWarning} wizard when a prior un-migrated Hivemind is detected (d-AC-1);
+ *   - the plain first-time {@link GuidedSetup} otherwise (l-AC-1).
+ * Once `/setup/state.authenticated` flips true, this screen does a HARD navigation to `/` instead
+ * of rendering the dashboard itself (l-AC-7 / l-AC-8) — see the module doc for why that stays the
+ * server gate's decision, not this component's.
+ *
+ * The FIRST render shows the guided-setup state (the fresh-install-safe default) until the first
+ * poll resolves, so a slow first read never flashes a stale state.
+ */
+export function LoginScreen({ client, assetBase = "assets" } = {}) {
+    const wire = React.useMemo(() => client ?? createWireClient(), [client]);
+    const [state, setState] = React.useState(FRESH_SETUP_STATE);
+    // Once the migration's uninstall completes but needs the device flow (d-AC-4), force the login UI
+    // (GuidedSetup) even though a prior-Hivemind dir may still be reported — the user must finish linking.
+    const [forceLogin, setForceLogin] = React.useState(false);
+    // A synchronous guard so the navigation below fires exactly once even if this effect re-runs
+    // (e.g. React 18 StrictMode's double-invoke in development) before the browser actually leaves.
+    const navigatedRef = React.useRef(false);
+    React.useEffect(() => {
+        if (state.authenticated) {
+            // l-AC-7 / l-AC-8: auth flipped true. A HARD navigation (not a client-side component swap)
+            // so hive's server gate (gate.ts) re-validates health+auth for the new request and serves
+            // the authoritative next screen — `/` (the dashboard) if the fleet is still healthy, or
+            // `/buzzing` in the (rare) case it degraded in the interim. This is deliberately NOT a
+            // `usePathRoute().navigate` client-side swap: there is no mounted Shell here to swap into,
+            // and re-deriving "go to the dashboard" here would duplicate the gate's own decision.
+            if (!navigatedRef.current && typeof window !== "undefined") {
+                navigatedRef.current = true;
+                window.location.assign("/");
+            }
+            return;
+        }
+        let alive = true;
+        const tick = async () => {
+            const next = await wire.setupState();
+            if (alive)
+                setState(next);
+        };
+        void tick();
+        // Keep polling while pre-auth so the transition is live; cleared on unmount and on the
+        // authenticated flip (the effect re-runs and early-returns above).
+        const id = setInterval(() => void tick(), SETUP_POLL_MS);
+        return () => {
+            alive = false;
+            clearInterval(id);
+        };
+    }, [wire, state.authenticated]);
+    // AUTHENTICATED: the navigation above is in flight. Render nothing further — the browser is
+    // about to leave this screen for the real dashboard request.
+    if (state.authenticated) {
+        return _jsx(_Fragment, {});
+    }
+    // d-AC-7: an interrupted migration ALWAYS wins — a half-migrated machine is never presented as a
+    // clean first-time/coexistence state. Resume/rollback until the marker reaches a terminal phase.
+    if (isMigrationInterrupted(state) && !forceLogin) {
+        return _jsx(MigrationInterrupted, { wire: wire, assetBase: assetBase, state: state, onNeedsLogin: () => setForceLogin(true) });
+    }
+    // d-AC-1: a prior un-migrated Hivemind renders the coexistence-warning wizard (not the plain
+    // first-time state) — unless the migration already handed off to the login flow (`forceLogin`).
+    if (hasUnmigratedPriorHivemind(state) && !forceLogin) {
+        return _jsx(CoexistenceWarning, { wire: wire, assetBase: assetBase, onNeedsLogin: () => setForceLogin(true) });
+    }
+    return _jsx(GuidedSetup, { wire: wire, assetBase: assetBase, state: state });
+}
+//# sourceMappingURL=setup-gate.js.map

package/dist/dashboard/web/setup-gate.js.map

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

package/dist/dashboard/web/sidebar.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The left-hand NAVIGATION sidebar — PRD-037a (the brand chrome + nav).
+ *
+ * A pure presentational + nav component: it READS the route registry (037c) for its items and the
+ * active route (037b) for its highlight, and EMITS navigation intent via `onNavigate(route)`. It
+ * does NOT mutate `location.pathname` itself — that is PRD-003c's `navigate` (037a AC-4 keeps the
+ * sidebar a thin, testable pass-through). It introduces NO new design system: every visual value is
+ * an existing `var(--…)` token already served in `/dashboard/styles.css` (037a AC-7, D-3).
+ *
+ * Layout (D-3 / D-4):
+ *   - Top: the honeycomb mark + `honeycomb` wordmark + the org/workspace mono sub-line — the exact
+ *     type treatment the old `Header` used (mark 34px; wordmark 700/19/-0.03em; sub-line mono/11).
+ *   - Middle: the seven nav items from the registry, each icon + label, in registry order. The item
+ *     matching `activeRoute` is highlighted with the honey accent (`--honey` / `--honey-subtle` /
+ *     `--honey-border`) — the same language `Badge tone="honey"` / `Button variant="primary"` speak —
+ *     and EXACTLY one item is active at a time.
+ *   - Footer: the relocated daemon-health pill (green `--verified` dot up / `--severity-critical`
+ *     offline, mono `daemon :3850` / `offline`) + the collapse toggle (a ghost `Button`). The pill is
+ *     visible on every route (D-4), and in the collapsed rail it shows the dot only.
+ *
+ * Collapsed/responsive (037a AC-6): the `collapsed` flag (or a narrow viewport via the host's
+ * `@media (max-width:900px)` rule) renders an icon-only rail; the active highlight + the health dot
+ * survive it, and each item's label rides a `title` hover.
+ */
+import React from "react";
+import type { RouteEntry } from "./registry.js";
+/** The expanded sidebar gutter width (px). */
+export declare const SIDEBAR_WIDTH: 220;
+/** The collapsed icon-rail width (px). */
+export declare const SIDEBAR_RAIL_WIDTH: 56;
+/** Props for {@link Sidebar}. */
+export interface SidebarProps {
+    /** The registry nav entries (037c) — rendered as nav items in order. */
+    readonly entries: readonly RouteEntry[];
+    /** The active route (PRD-003c's `usePathRoute().route`) — drives the single active highlight. */
+    readonly activeRoute: string;
+    /** Navigation intent — called with an item's `route`; the SHELL maps it to 037b's `navigate`. */
+    readonly onNavigate: (route: string) => void;
+    /** Daemon liveness — drives the footer health pill (green up / critical offline). */
+    readonly daemonUp: boolean;
+    /** The org/workspace sub-line under the wordmark (mono, tertiary). */
+    readonly identity: string;
+    /** The base path the host serves the mark under (loopback, no secret). */
+    readonly assetBase: string;
+    /** Collapsed (icon-rail) state — icon-only nav, dot-only pill. */
+    readonly collapsed: boolean;
+    /** Toggle the collapsed state (the shell owns the boolean; the sidebar calls this). */
+    readonly onToggleCollapsed: () => void;
+}
+/**
+ * Decide which entry is active for the current route (037a AC-3 — EXACTLY one). An exact match wins;
+ * otherwise a deep sub-route highlights its top-level parent (e.g. `/harnesses/x` lights Harnesses);
+ * otherwise the Dashboard (`/`) entry is active (the unknown→Dashboard fallback, mirroring the
+ * registry's `matchRoute`). Returns the active entry's `route` so the renderer compares by value.
+ */
+export declare function activeEntryRoute(entries: readonly RouteEntry[], activeRoute: string): string;
+/**
+ * The navigation sidebar (037a). Renders the brand chrome, the seven registry nav items with the
+ * single honey active highlight, and the footer (health pill + collapse toggle). Pure presentation:
+ * all state (active route, daemon up, collapsed) is owned by the shell and passed in; every effect is
+ * an `onNavigate` / `onToggleCollapsed` callback out.
+ */
+export declare function Sidebar({ entries, activeRoute, onNavigate, daemonUp, identity, assetBase, collapsed, onToggleCollapsed, }: SidebarProps): React.JSX.Element;

package/dist/dashboard/web/sidebar.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "./primitives.js";
+import { ScopeSwitcherSlot } from "./scope-context.js";
+/** The expanded sidebar gutter width (px). */
+export const SIDEBAR_WIDTH = 220;
+/** The collapsed icon-rail width (px). */
+export const SIDEBAR_RAIL_WIDTH = 56;
+/**
+ * Decide which entry is active for the current route (037a AC-3 — EXACTLY one). An exact match wins;
+ * otherwise a deep sub-route highlights its top-level parent (e.g. `/harnesses/x` lights Harnesses);
+ * otherwise the Dashboard (`/`) entry is active (the unknown→Dashboard fallback, mirroring the
+ * registry's `matchRoute`). Returns the active entry's `route` so the renderer compares by value.
+ */
+export function activeEntryRoute(entries, activeRoute) {
+    const exact = entries.find((e) => e.route === activeRoute);
+    if (exact !== undefined)
+        return exact.route;
+    const parent = entries.find((e) => e.route !== "/" && activeRoute.startsWith(`${e.route}/`));
+    if (parent !== undefined)
+        return parent.route;
+    const dashboard = entries.find((e) => e.route === "/");
+    return dashboard?.route ?? (entries[0]?.route ?? "/");
+}
+/** One nav item row. Honey-accented when active; resting `--text-secondary` otherwise. */
+function NavItem({ entry, active, collapsed, onNavigate, }) {
+    return (_jsxs("button", { type: "button", 
+        // AC-4: the click is the ONLY navigation effect — it calls onNavigate(route) and nothing
+        // else (the sidebar never touches location.hash; the shell wires this to 037b's navigate).
+        onClick: () => onNavigate(entry.route), "aria-current": active ? "page" : undefined, title: collapsed ? entry.label : undefined, "data-route": entry.route, "data-active": active ? "true" : "false", style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 10,
+            width: "100%",
+            height: 38,
+            padding: collapsed ? "0" : "0 12px",
+            justifyContent: collapsed ? "center" : "flex-start",
+            // Honey active highlight (D-3) — exactly the `Badge tone="honey"` language.
+            background: active ? "var(--honey-subtle)" : "transparent",
+            color: active ? "var(--honey)" : "var(--text-secondary)",
+            border: `1px solid ${active ? "var(--honey-border)" : "transparent"}`,
+            borderRadius: "var(--radius-md)",
+            fontFamily: "var(--font-mono)",
+            fontSize: 13,
+            fontWeight: 600,
+            letterSpacing: "0.01em",
+            cursor: "pointer",
+            whiteSpace: "nowrap",
+            transition: "background var(--dur-fast) var(--ease-out), color var(--dur-fast) var(--ease-out)",
+        }, children: [_jsx("span", { style: { display: "inline-flex", flex: "none" }, children: entry.icon }), !collapsed && _jsx("span", { children: entry.label })] }));
+}
+/**
+ * The daemon-health pill, relocated into the sidebar footer (D-4). KEEPS the exact contract from the
+ * old `Header`: a green `--verified` dot when up, `--severity-critical` when offline, mono
+ * `daemon :3850` / `offline` label, on `--bg-elevated` with a `--border-default` border. Renders
+ * subsystem STATE only — NO token/secret (D-9). In the collapsed rail it shows the dot alone.
+ */
+function HealthPill({ daemonUp, collapsed }) {
+    return (_jsxs("div", { title: "daemon health", "data-testid": "daemon-health-pill", style: {
+            display: "flex",
+            alignItems: "center",
+            gap: 8,
+            height: 36,
+            padding: collapsed ? "0" : "0 12px",
+            justifyContent: collapsed ? "center" : "flex-start",
+            background: "var(--bg-elevated)",
+            border: "1px solid var(--border-default)",
+            borderRadius: "var(--radius-md)",
+        }, children: [_jsx("span", { style: { width: 8, height: 8, borderRadius: "50%", flex: "none", background: daemonUp ? "var(--verified)" : "var(--severity-critical)" } }), !collapsed && _jsx("span", { style: { fontFamily: "var(--font-mono)", fontSize: 12, color: "var(--text-secondary)" }, children: daemonUp ? "daemon :3850" : "offline" })] }));
+}
+/**
+ * The navigation sidebar (037a). Renders the brand chrome, the seven registry nav items with the
+ * single honey active highlight, and the footer (health pill + collapse toggle). Pure presentation:
+ * all state (active route, daemon up, collapsed) is owned by the shell and passed in; every effect is
+ * an `onNavigate` / `onToggleCollapsed` callback out.
+ */
+export function Sidebar({ entries, activeRoute, onNavigate, daemonUp, identity, assetBase, collapsed, onToggleCollapsed, }) {
+    const activeRoot = activeEntryRoute(entries, activeRoute);
+    return (_jsxs("nav", { "aria-label": "Dashboard navigation", "data-collapsed": collapsed ? "true" : "false", style: {
+            display: "flex",
+            flexDirection: "column",
+            gap: 18,
+            width: collapsed ? SIDEBAR_RAIL_WIDTH : SIDEBAR_WIDTH,
+            flex: "none",
+            minHeight: "100vh",
+            boxSizing: "border-box",
+            padding: collapsed ? "20px 8px" : "22px 14px",
+            background: "var(--bg-surface)",
+            borderRight: "1px solid var(--border-default)",
+        }, children: [_jsxs("div", { style: { display: "flex", alignItems: "center", gap: 10, paddingLeft: collapsed ? 0 : 2, justifyContent: collapsed ? "center" : "flex-start" }, children: [_jsx("img", { src: `${assetBase}/honeycomb-memory-cluster.svg`, width: collapsed ? 28 : 34, height: collapsed ? 28 : 34, alt: "", style: { flex: "none" } }), !collapsed && (_jsxs("div", { style: { display: "flex", flexDirection: "column", minWidth: 0 }, children: [_jsx("span", { style: { fontWeight: 700, fontSize: 19, letterSpacing: "-0.03em", color: "var(--text-primary)", lineHeight: 1.1 }, children: "honeycomb" }), _jsx("span", { style: { fontFamily: "var(--font-mono)", fontSize: 11, color: "var(--text-tertiary)", whiteSpace: "nowrap", overflow: "hidden", textOverflow: "ellipsis" }, children: identity })] }))] }), _jsx(ScopeSwitcherSlot, { collapsed: collapsed }), _jsx("div", { style: { display: "flex", flexDirection: "column", gap: 4, flex: 1 }, children: entries.map((entry) => (_jsx(NavItem, { entry: entry, active: entry.route === activeRoot, collapsed: collapsed, onNavigate: onNavigate }, entry.route))) }), _jsxs("div", { style: { display: "flex", flexDirection: "column", gap: 10 }, children: [_jsx(HealthPill, { daemonUp: daemonUp, collapsed: collapsed }), _jsx(Button, { variant: "ghost", size: "sm", onClick: onToggleCollapsed, "aria-label": collapsed ? "expand sidebar" : "collapse sidebar", title: collapsed ? "expand" : "collapse", children: collapsed ? "»" : "« collapse" })] })] }));
+}
+//# sourceMappingURL=sidebar.js.map

package/dist/dashboard/web/sidebar.js.map

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

package/dist/dashboard/web/use-fleet-telemetry.d.ts

@@ -0,0 +1,111 @@
+/**
+ * The SHARED fleet-telemetry view-model hook — hive PRD-004/PRD-005. One hook, consumed by
+ * `/buzzing` (PRD-004a), the health rail (PRD-005a), and the `/health` page (PRD-005b/PRD-005c),
+ * so the SSE-first/REST-fallback wiring, the registered-name enumeration, and the bounded log
+ * ring buffer are each written exactly once (per the implementation brief), not duplicated per
+ * consumer.
+ *
+ * Sourcing precedence (bz-AC-4/bz-AC-5/bz-AC-6, hr-AC-3/hr-AC-4/hr-AC-5):
+ *   1. `EventSource("/api/telemetry/stream")` — the same-origin relay of doctor's real SSE
+ *      stream (`telemetry-proxy.ts`). Live, near-real-time. `EventSource` auto-reconnects on its
+ *      own after a drop (the browser's built-in behavior), so "resumes without a manual refresh"
+ *      falls out of the platform rather than hand-rolled reconnect logic.
+ *   2. `GET /api/fleet-status` (PRD-002a), polled — the fail-soft fallback the whole time SSE is
+ *      unavailable/erroring. Coarser (no metrics/Deep Lake/lastSeen), but keeps every tile/pill
+ *      rendering rather than blanking.
+ *
+ * Every state-mutating step below is a PURE, exported function (`applyRegisteredNames`,
+ * `applySseEvent`, `applyRestFallback`, `appendLogs`, `deriveServiceViews`) so the derivation and
+ * bookkeeping are unit-testable without a real `EventSource` (jsdom has none — the hook itself
+ * degrades to the REST path in that environment, exactly like `wire.ts`'s `logsStream`).
+ *
+ * Memory-bounded (parent index constraint, lg-AC-6): `logs` is a capped ring buffer
+ * ({@link LOG_RING_BUFFER_CAP}), oldest-dropped; `services` holds only CURRENT per-service state,
+ * never a history series (hr-AC-7).
+ */
+import { type FleetDeeplakeStats, type FleetLogEntry, type FleetTelemetryEvent, type ServiceMetrics, type TelemetryFaultReason } from "../../shared/fleet-telemetry.js";
+import type { FleetHealth, FleetStatusResponse } from "../../shared/fleet-readiness.js";
+import { type ServiceSignal, type ServiceState } from "../../shared/service-status.js";
+/** The bounded log ring-buffer cap (lg-AC-6/lg-AC-8): older lines drop rather than accumulate. */
+export declare const LOG_RING_BUFFER_CAP = 500;
+/** One service's rendered view-model: its derived loader state plus whatever raw telemetry is known. */
+export interface ServiceView {
+    readonly name: string;
+    readonly state: ServiceState;
+    /** The raw doctor health, or `null` before any signal has been observed for this service. */
+    readonly health: FleetHealth | null;
+    readonly lastSeen: string | null;
+    /** Schema-tolerant per-service counters (PRD-005b) — `{}` until telemetry reports any. */
+    readonly metrics: ServiceMetrics;
+    readonly deeplake: FleetDeeplakeStats | null;
+    readonly telemetryFault: TelemetryFaultReason | null;
+}
+export type TelemetrySource = "sse" | "rest" | "none";
+/** The shared view-model {@link useFleetTelemetry} returns. */
+export interface FleetTelemetryView {
+    readonly services: readonly ServiceView[];
+    /** A bounded, newest-appended log tail (PRD-005c) — never the full history. */
+    readonly logs: readonly FleetLogEntry[];
+    readonly source: TelemetrySource;
+    readonly asOf: string | null;
+}
+export declare const EMPTY_FLEET_TELEMETRY_VIEW: FleetTelemetryView;
+interface ServiceRuntime {
+    readonly signal: ServiceSignal;
+    readonly metrics: ServiceMetrics;
+    readonly deeplake: FleetDeeplakeStats | null;
+    readonly firstActiveAt: number | null;
+}
+/** @internal exported only for tests. */
+export interface TelemetryState {
+    readonly registeredNames: readonly string[];
+    readonly services: ReadonlyMap<string, ServiceRuntime>;
+    readonly logs: readonly FleetLogEntry[];
+    readonly source: TelemetrySource;
+    readonly asOf: string | null;
+}
+/** The initial, empty state before any registration/telemetry has arrived. */
+export declare function createInitialTelemetryState(registeredNames?: readonly string[]): TelemetryState;
+/**
+ * Merge the full registered-name enumeration (`GET /api/registered-services`) into state
+ * (bz-AC-1/bz-AC-2, hr-AC-1). Never drops a name already tracked from telemetry that this
+ * enumeration happens not to list (defense against a stale/partial registry read).
+ */
+export declare function applyRegisteredNames(state: TelemetryState, names: readonly string[]): TelemetryState;
+/** Append new log lines, capped at {@link LOG_RING_BUFFER_CAP} with the OLDEST dropped first (lg-AC-6/lg-AC-8). */
+export declare function appendLogs(existing: readonly FleetLogEntry[], incoming: readonly FleetLogEntry[]): readonly FleetLogEntry[];
+/** Apply one live `fleet-telemetry` SSE event (bz-AC-4, hr-AC-3, sd-AC-8/sd-AC-9 per-service isolation). */
+export declare function applySseEvent(state: TelemetryState, event: FleetTelemetryEvent, now: number): TelemetryState;
+/**
+ * Apply one `GET /api/fleet-status` fail-soft projection (bz-AC-5, hr-AC-4). The coarse
+ * projection carries no metrics/Deep Lake/lastSeen, so existing per-service metrics/Deep Lake
+ * readings are RETAINED (hm-AC-10's "last known metrics") — only the derived health-driving
+ * signal is refreshed.
+ *
+ * The response is a SNAPSHOT, not a patch: `services` is rebuilt from `status.daemons` alone, so
+ * a daemon missing from a later response loses its stale `signal`/`firstActiveAt` and falls back
+ * to the registered-but-silent derivation (`starting`) instead of staying `active`/`degraded`
+ * forever. Its NAME is still retained via `registeredNames`, so the row never disappears.
+ */
+export declare function applyRestFallback(state: TelemetryState, status: FleetStatusResponse, now: number): TelemetryState;
+/** Build the rendered per-service views for every KNOWN name, in first-seen order (never omitted, sd-AC-2/bz-AC-2). */
+export declare function deriveServiceViews(state: TelemetryState, now: number): readonly ServiceView[];
+/** Project internal {@link TelemetryState} into the public {@link FleetTelemetryView}. */
+export declare function toFleetTelemetryView(state: TelemetryState, now: number): FleetTelemetryView;
+/** Options for {@link useFleetTelemetry}. */
+export interface UseFleetTelemetryOptions {
+    /** Override the REST-fallback poll interval (ms). Defaults to {@link DEFAULT_REST_POLL_MS}. */
+    readonly restPollMs?: number;
+}
+/**
+ * The shared fleet-telemetry hook (see module doc for the sourcing precedence). Every consumer
+ * mounts its own instance; the underlying SSE/REST wiring is identical code shared via this one
+ * function rather than re-implemented per screen.
+ */
+export declare function useFleetTelemetry(options?: UseFleetTelemetryOptions): FleetTelemetryView;
+/** The four selectable verbosity levels (lg-AC-4), ordered least→most severe. */
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+/** Filter a log buffer to lines AT OR ABOVE `minLevel` (lg-AC-4/lg-AC-5) — a view filter, never a re-fetch. */
+export declare function filterLogsByVerbosity(logs: readonly FleetLogEntry[], minLevel: LogLevel): readonly FleetLogEntry[];
+export {};