@legioncodeinc/hive 0.1.0

package/dist/dashboard/web/registry.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DashboardPage } from "./pages/dashboard.js";
+import { GraphPage } from "./pages/graph.js";
+import { HarnessesPage, resolveHarnessSubItems } from "./pages/harnesses.js";
+import { HealthPage } from "./pages/health.js";
+import { LogsPage } from "./pages/logs.js";
+import { MemoriesPage } from "./pages/memories.js";
+import { ProjectsPage } from "./pages/projects.js";
+import { RoiPage } from "./pages/roi.js";
+import { SettingsPage } from "./pages/settings.js";
+import { SyncPage } from "./pages/sync.js";
+/** A 16px inline-SVG icon stroked in `currentColor` (so the sidebar tints it by row color). */
+function Icon({ children }) {
+    return (_jsx("svg", { width: 16, height: 16, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 1.8, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", style: { flex: "none" }, children: children }));
+}
+/** Dashboard — a 2x2 grid of panels (the home overview). */
+const DashboardIcon = (_jsxs(Icon, { children: [_jsx("rect", { x: 3, y: 3, width: 7, height: 7 }), _jsx("rect", { x: 14, y: 3, width: 7, height: 7 }), _jsx("rect", { x: 3, y: 14, width: 7, height: 7 }), _jsx("rect", { x: 14, y: 14, width: 7, height: 7 })] }));
+/** Harnesses — stacked plugs/terminals (the per-host adapters). */
+const HarnessesIcon = (_jsxs(Icon, { children: [_jsx("rect", { x: 3, y: 4, width: 18, height: 16, rx: 2 }), _jsx("path", { d: "M7 9l3 3-3 3" }), _jsx("path", { d: "M13 15h4" })] }));
+/** Projects — stacked folders (the bound-folder manager, PRD-059). */
+const ProjectsIcon = (_jsx(Icon, { children: _jsx("path", { d: "M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" }) }));
+/** Memories — a honeycomb cell (the signature Honeycomb surface). */
+const MemoriesIcon = (_jsxs(Icon, { children: [_jsx("path", { d: "M12 3l7 4v8l-7 4-7-4V7z" }), _jsx("path", { d: "M12 8v8" })] }));
+/** Memory Graph — connected nodes (the knowledge/memory graph). */
+const GraphIcon = (_jsxs(Icon, { children: [_jsx("circle", { cx: 6, cy: 6, r: 2.5 }), _jsx("circle", { cx: 18, cy: 9, r: 2.5 }), _jsx("circle", { cx: 9, cy: 18, r: 2.5 }), _jsx("path", { d: "M8 7.5l8 1.5M8 16l1-7.5" })] }));
+/** Sync — a circular refresh (skill propagation). */
+const SyncIcon = (_jsxs(Icon, { children: [_jsx("path", { d: "M21 12a9 9 0 1 1-3-6.7" }), _jsx("path", { d: "M21 4v4h-4" })] }));
+/** Logs — a document with lines (the live-log stream). */
+const LogsIcon = (_jsxs(Icon, { children: [_jsx("rect", { x: 4, y: 3, width: 16, height: 18, rx: 2 }), _jsx("path", { d: "M8 8h8M8 12h8M8 16h5" })] }));
+/** Health — a pulse line (the fleet health page, PRD-005b/PRD-005c). */
+const HealthIcon = (_jsx(Icon, { children: _jsx("path", { d: "M3 12h4l2-7 4 14 2-7h6" }) }));
+/** ROI — a rising trend line over an axis (the Net-ROI ledger, PRD-060e). */
+const RoiIcon = (_jsxs(Icon, { children: [_jsx("path", { d: "M4 19V5" }), _jsx("path", { d: "M4 19h16" }), _jsx("path", { d: "M7 15l4-5 3 3 5-7" })] }));
+/** Settings — a gear (provider/model/pollinating/vault). */
+const SettingsIcon = (_jsxs(Icon, { children: [_jsx("circle", { cx: 12, cy: 12, r: 3 }), _jsx("path", { d: "M12 2v3M12 19v3M4.2 4.2l2.1 2.1M17.7 17.7l2.1 2.1M2 12h3M19 12h3M4.2 19.8l2.1-2.1M17.7 6.3l2.1-2.1" })] }));
+/**
+ * The seven STATIC top-level routes in nav order (037c AC-2). Each is always present and hard-listed
+ * here; their content owners are the cross-referenced page PRDs:
+ *   Dashboard (`/`)        → PRD-038 (lift-and-shift today, reorganized there)
+ *   Harnesses (`/harnesses`) → PRD-039 (may carry a dynamic per-harness group)
+ *   Memories (`/memories`)  → PRD-040
+ *   Graph (`/graph`)        → PRD-041
+ *   Sync (`/sync`)          → PRD-042
+ *   Logs (`/logs`)          → PRD-043
+ *   Settings (`/settings`)  → PRD-044
+ */
+/** The Projects page route (PRD-059c) — exported so the first-run CTA can navigate to it (b-AC-4). */
+export const PROJECTS_ROUTE = "/projects";
+export const ROUTES = [
+    { route: "/", label: "Dashboard", icon: DashboardIcon, component: DashboardPage },
+    // PRD-059c: the Projects management page (bound-folder list + Add/Import/Unbind/Open). Slotted right
+    // after Dashboard — the home for "what is Honeycomb sourcing". One registry entry is the whole wiring
+    // (037c contract): the sidebar renders the nav item and the outlet routes the path, no sidebar edit.
+    { route: PROJECTS_ROUTE, label: "Projects", icon: ProjectsIcon, component: ProjectsPage },
+    // PRD-039 (D-6): the `#/harnesses` route is the STATIC top-level entry; its per-harness sub-entries
+    // (`#/harnesses/<name>`) are the 037c DYNAMIC group, resolved at render from 039a's live harness
+    // list (`resolveHarnessSubItems`). The parent's OQ-3 answer: 039a IS the dynamic data source.
+    { route: "/harnesses", label: "Harnesses", icon: HarnessesIcon, component: HarnessesPage, dynamic: { resolve: resolveHarnessSubItems } },
+    { route: "/memories", label: "Memories", icon: MemoriesIcon, component: MemoriesPage },
+    // PRD-041 follow-up: the codebase-graph view was removed from the dashboard (it was too dense to be
+    // useful); this page now shows ONLY the memory/knowledge graph. The daemon still builds the codebase
+    // graph in the background (assemble.ts auto-build) for the stale-ref/lifecycle diagnostic.
+    { route: "/graph", label: "Memory Graph", icon: GraphIcon, component: GraphPage },
+    { route: "/sync", label: "Sync", icon: SyncIcon, component: SyncPage },
+    { route: "/logs", label: "Logs", icon: LogsIcon, component: LogsPage },
+    // PRD-005b/PRD-005c: the persistent fleet health page (per-service metrics + Deep Lake stats +
+    // a live, verbosity-filtered log tail). Note: `/health` is ALSO hive's own machine-liveness
+    // path (`server.ts`); content negotiation on the server (`accept: text/html`) keeps both
+    // working at the identical literal path (see `gate.ts`/`server.ts`/`pages/health.tsx` docs).
+    { route: "/health", label: "Health", icon: HealthIcon, component: HealthPage },
+    // PRD-060e: the ROI page (the Net-ROI ledger — measured/modeled savings vs infra + pollination cost,
+    // with org/team/agent/project rollups). ONE registry entry is the whole wiring (037c contract): the
+    // sidebar renders the nav item and the outlet routes the path, no sidebar/router hand-edit.
+    { route: "/roi", label: "ROI", icon: RoiIcon, component: RoiPage },
+    { route: "/settings", label: "Settings", icon: SettingsIcon, component: SettingsPage },
+];
+/** The Dashboard entry — the default every unknown path falls back to (037c AC-3 / 037b AC-4). */
+export const DEFAULT_ROUTE = ROUTES[0];
+/**
+ * Resolve a path to its registry entry, defaulting to the Dashboard entry on no match (037c AC-3,
+ * feeding 037b AC-4 "unknown route → Dashboard, no blank screen"). The match is exact on the entry
+ * `route` — a deep sub-route (e.g. `/harnesses/claude-code` from a dynamic group) resolves to its
+ * top-level parent by prefix so the correct page still mounts. `routes` is injectable so a test can
+ * prove the plug-in seam with a throwaway entry (037c AC-6) without mutating the global list.
+ */
+export function matchRoute(pathname, routes = ROUTES) {
+    // Exact match first (the common case: one of the nine top-level routes).
+    const exact = routes.find((r) => r.route === pathname);
+    if (exact !== undefined)
+        return exact;
+    // A deep sub-route resolves to its top-level parent (e.g. `/harnesses/x` → the Harnesses entry).
+    // Skip the root `/` here so it never greedily matches every path; root is the explicit fallback.
+    const parent = routes.find((r) => r.route !== "/" && pathname.startsWith(`${r.route}/`));
+    if (parent !== undefined)
+        return parent;
+    // No match → the Dashboard entry (the registry's default; never a blank screen).
+    return routes.find((r) => r.route === "/") ?? routes[0];
+}
+//# sourceMappingURL=registry.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * The dashboard CLIENT-SIDE ROUTER — PRD-003c (m-AC-1 / m-AC-2, retiring the hash router).
+ *
+ * hive's SERVER is now the routing authority (PRD-003a): it evaluates the health-then-auth
+ * gate on every request and serves the identical SPA shell for every real, path-based route
+ * (`hive/src/daemon/dashboard/host.ts`'s catch-all). This hook's job narrows to what a
+ * server-routed SPA needs client-side: read the ALREADY-AUTHORIZED path the server served
+ * (`location.pathname`), keep it in sync with History API navigation (back/forward, and this
+ * hook's own `navigate`), and re-render. It does NOT decide what the operator is ALLOWED to see —
+ * that decision was already made server-side before this bundle ever ran.
+ *
+ * This RETIRES `useHashRoute` / `routeFromHash` (m-AC-1): routing no longer reads `location.hash`,
+ * and `navigate` calls `history.pushState` instead of assigning `location.hash`, so history entries
+ * are real paths, not fragments (m-AC-2). Still NO `react-router`, NO new dependency — the History
+ * API is a browser primitive, mirroring the hash hook's own no-new-dependency posture.
+ */
+/**
+ * Parse the current route string from `location.pathname`. Normalizes an empty path to the
+ * default `/`. The returned value is the RAW route key (e.g. `/graph`); resolving it to a
+ * registry entry (and the unknown→Dashboard fallback) is `matchRoute`'s job (`registry.tsx`), not
+ * this parser's — this keeps the hook a pure reflection of the URL, mirroring `routeFromHash`'s
+ * old contract one-for-one, just sourced from the path instead of the fragment.
+ */
+export declare function routeFromPath(pathname: string): string;
+/**
+ * The custom window event `navigate` broadcasts after `pushState`. `pushState` fires no browser
+ * event of its own, and several components mount their OWN `usePathRoute()` instance (the Shell in
+ * `app.tsx`, `HarnessesPage`), so without a broadcast only the instance whose `navigate` ran would
+ * re-render and every other subscriber's `route` would go stale until a real `popstate`.
+ */
+export declare const ROUTE_CHANGE_EVENT: "hive:pathchange";
+/** The path-router contract the Shell consumes: the active route + a `navigate` helper. */
+export interface PathRoute {
+    /** The active route parsed from `location.pathname` (e.g. `/` or `/graph`). */
+    readonly route: string;
+    /** Push `r` onto the History API (the `popstate`/local-state sync then re-renders). The ONLY history mutator. */
+    readonly navigate: (r: string) => void;
+}
+/**
+ * Read the active route from `location.pathname` and re-render on `popstate` (m-AC-2: back/forward
+ * resolves the same screens). Subscribes in a `useEffect` and unsubscribes on unmount. `navigate(r)`
+ * pushes a new History entry via `history.pushState` — which does NOT itself fire `popstate` — so
+ * `navigate` updates the local route state directly too; this keeps exactly one source of truth
+ * (the URL) and one mutator (`navigate`), mirroring the retired hash hook's contract. Deep-linking
+ * works for free: the initial state reads whatever path the page loaded with (the server already
+ * validated it via the gate), so a refresh on `/graph` mounts the Graph route.
+ */
+export declare function usePathRoute(): PathRoute;

package/dist/dashboard/web/router.js

@@ -0,0 +1,76 @@
+/**
+ * The dashboard CLIENT-SIDE ROUTER — PRD-003c (m-AC-1 / m-AC-2, retiring the hash router).
+ *
+ * hive's SERVER is now the routing authority (PRD-003a): it evaluates the health-then-auth
+ * gate on every request and serves the identical SPA shell for every real, path-based route
+ * (`hive/src/daemon/dashboard/host.ts`'s catch-all). This hook's job narrows to what a
+ * server-routed SPA needs client-side: read the ALREADY-AUTHORIZED path the server served
+ * (`location.pathname`), keep it in sync with History API navigation (back/forward, and this
+ * hook's own `navigate`), and re-render. It does NOT decide what the operator is ALLOWED to see —
+ * that decision was already made server-side before this bundle ever ran.
+ *
+ * This RETIRES `useHashRoute` / `routeFromHash` (m-AC-1): routing no longer reads `location.hash`,
+ * and `navigate` calls `history.pushState` instead of assigning `location.hash`, so history entries
+ * are real paths, not fragments (m-AC-2). Still NO `react-router`, NO new dependency — the History
+ * API is a browser primitive, mirroring the hash hook's own no-new-dependency posture.
+ */
+import React from "react";
+/**
+ * Parse the current route string from `location.pathname`. Normalizes an empty path to the
+ * default `/`. The returned value is the RAW route key (e.g. `/graph`); resolving it to a
+ * registry entry (and the unknown→Dashboard fallback) is `matchRoute`'s job (`registry.tsx`), not
+ * this parser's — this keeps the hook a pure reflection of the URL, mirroring `routeFromHash`'s
+ * old contract one-for-one, just sourced from the path instead of the fragment.
+ */
+export function routeFromPath(pathname) {
+    const trimmed = pathname.trim();
+    return trimmed === "" ? "/" : trimmed;
+}
+/**
+ * The custom window event `navigate` broadcasts after `pushState`. `pushState` fires no browser
+ * event of its own, and several components mount their OWN `usePathRoute()` instance (the Shell in
+ * `app.tsx`, `HarnessesPage`), so without a broadcast only the instance whose `navigate` ran would
+ * re-render and every other subscriber's `route` would go stale until a real `popstate`.
+ */
+export const ROUTE_CHANGE_EVENT = "hive:pathchange";
+/**
+ * Read the active route from `location.pathname` and re-render on `popstate` (m-AC-2: back/forward
+ * resolves the same screens). Subscribes in a `useEffect` and unsubscribes on unmount. `navigate(r)`
+ * pushes a new History entry via `history.pushState` — which does NOT itself fire `popstate` — so
+ * `navigate` updates the local route state directly too; this keeps exactly one source of truth
+ * (the URL) and one mutator (`navigate`), mirroring the retired hash hook's contract. Deep-linking
+ * works for free: the initial state reads whatever path the page loaded with (the server already
+ * validated it via the gate), so a refresh on `/graph` mounts the Graph route.
+ */
+export function usePathRoute() {
+    const [route, setRoute] = React.useState(() => 
+    // SSR/test-safe initial read: `window` exists in jsdom + the browser; guard defensively.
+    typeof window === "undefined" ? "/" : routeFromPath(window.location.pathname));
+    React.useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const sync = () => setRoute(routeFromPath(window.location.pathname));
+        // Re-sync once on mount in case the path changed between the initial render and the effect.
+        sync();
+        window.addEventListener("popstate", sync);
+        window.addEventListener(ROUTE_CHANGE_EVENT, sync);
+        return () => {
+            window.removeEventListener("popstate", sync);
+            window.removeEventListener(ROUTE_CHANGE_EVENT, sync);
+        };
+    }, []);
+    const navigate = React.useCallback((r) => {
+        if (typeof window === "undefined")
+            return;
+        const next = r.startsWith("/") ? r : `/${r}`;
+        // `pushState` does not fire `popstate`, so broadcast the change instead: EVERY mounted
+        // `usePathRoute()` instance (not just this one) re-syncs from `location.pathname`, keeping
+        // the URL the single source of truth across all subscribers.
+        if (window.location.pathname !== next) {
+            window.history.pushState(null, "", next);
+        }
+        window.dispatchEvent(new Event(ROUTE_CHANGE_EVENT));
+    }, []);
+    return { route, navigate };
+}
+//# sourceMappingURL=router.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/dashboard/web/router.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAA0B,CAAC;AAU7D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAS,GAAG,EAAE;IACrD,yFAAyF;IACzF,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC7E,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAC1C,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3E,4FAA4F;QAC5F,IAAI,EAAE,CAAC;QACP,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAS,EAAQ,EAAE;QACtD,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QAC1C,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,uFAAuF;QACvF,2FAA2F;QAC3F,6DAA6D;QAC7D,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACrD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/dashboard/web/scope-context.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The Org → Workspace → Project SCOPE context — PRD-050b seam, FILLED by PRD-049e.
+ *
+ * ════════════════════════════════════════════════════════════════════════════
+ * 050b carved the seam (a context + a hook + a slot) so the 049e scope switcher could slot into the
+ * sidebar WITHOUT reworking `host.ts`/`renderShell`/the shell. 049e FILLS it: a real
+ * {@link ScopeProvider} hydrates the switchable Org→Workspace→Project selection from the daemon's
+ * loopback enumeration endpoints, the {@link ScopeSwitcherSlot} renders the dropdowns, and every
+ * scope-aware page reads the active project via {@link useScope}. The shell stays scope-UNAWARE —
+ * scope lives entirely in the React app, never baked into the server-rendered shell.
+ * ════════════════════════════════════════════════════════════════════════════
+ *
+ * ── The contract (unchanged from 050b — additive only) ──────────────────────
+ *   - {@link DashboardScope} `{ org, workspace, project? }` — what a page reads.
+ *   - {@link useScope} — the hook every scope-aware surface uses. 049e makes it reactive to the
+ *     switcher's selection; a surface written against this hook needs NO change.
+ *   - {@link ScopeSwitcherSlot} — the sidebar region. 050b returned null; 049e renders the picker.
+ *
+ * ── Viewer-side selection (49e-AC-4) ─────────────────────────────────────────
+ * The selection drives WHICH data the pages show (it stamps the `x-honeycomb-project` read header).
+ * It does NOT overwrite a developer's per-folder CLI bindings: there is NO write to `projects.json`
+ * anywhere in this module. The selection is persisted ONLY in `localStorage` (the dashboard session),
+ * so a reload restores the last view without touching the registry.
+ */
+import React from "react";
+import type { ScopeOrgWire, ScopeProjectWire, ScopeWorkspaceWire, WireClient } from "./wire.js";
+/**
+ * The active scope the dashboard reads (the 049e contract). `org` is always present; `workspace`
+ * and `project` narrow it. 050b shipped the single loopback-local default; 049e makes these
+ * switchable from the {@link ScopeSwitcherSlot}.
+ */
+export interface DashboardScope {
+    /** The active org id (always present; the loopback "local" tenant until the switcher selects one). */
+    readonly org: string;
+    /** The active workspace id (the `default` sentinel until the switcher selects one). */
+    readonly workspace: string;
+    /** The active project id, when the scope is narrowed to one (049e); absent → no project selected. */
+    readonly project?: string;
+}
+/** The single-scope default the app starts from (the loopback local tenant) until enumeration resolves. */
+export declare const DEFAULT_SCOPE: DashboardScope;
+/** The `localStorage` key the dashboard persists its last viewer-side selection under (49e — viewer-side). */
+export declare const SCOPE_STORAGE_KEY: "honeycomb.dashboard.scope";
+/** The scope context value — the active scope plus a `setScope` the switcher wires to its dropdowns. */
+export interface ScopeContextValue {
+    /** The active scope. */
+    readonly scope: DashboardScope;
+    /**
+     * Switch the active scope (the switcher calls this). The default provider value is a NO-OP (a single,
+     * un-switchable scope) so a surface that calls it outside a {@link ScopeProvider} is harmless; the
+     * real {@link ScopeProvider} replaces it with a setter that re-hydrates the scoped views + persists.
+     */
+    readonly setScope: (next: DashboardScope) => void;
+}
+/** The React context (the 049e mount point). Defaults to the single loopback scope + a no-op setter. */
+export declare const ScopeContext: React.Context<ScopeContextValue>;
+/**
+ * Read the active dashboard scope (the hook every scope-aware surface uses). Reactive to the switcher's
+ * selection when rendered inside a {@link ScopeProvider}; returns the single default otherwise. Read
+ * scope from HERE, never bake a single-workspace assumption into a page or the shell.
+ */
+export declare function useScope(): ScopeContextValue;
+/**
+ * The switcher's enumeration state + handlers (PRD-049e). Separate from {@link ScopeContextValue} so a
+ * page reads only the lean `{ scope, setScope }` it needs, while the {@link ScopeSwitcherSlot} reads
+ * this richer surface. The {@link ScopeProvider} owns both; the slot reads this via {@link useScopeSwitcher}.
+ */
+export interface ScopeSwitcherValue {
+    /** The orgs the user can access (privilege-scoped by the daemon — 49e-AC-1). */
+    readonly orgs: readonly ScopeOrgWire[];
+    /** The selected org's workspaces (re-enumerated on org change, after the re-mint — 49e-AC-3). */
+    readonly workspaces: readonly ScopeWorkspaceWire[];
+    /** The workspace's registry projects (the 049a synced copy, incl. the `__unsorted__` inbox). */
+    readonly projects: readonly ScopeProjectWire[];
+    /**
+     * True once the FIRST projects enumeration has resolved (PRD-059b). The first-run "pick a folder"
+     * CTA keys off this so it never flashes before the projects read returns — only AFTER the read
+     * resolves with zero locally-bound projects does the CTA show (b-AC-1).
+     */
+    readonly projectsHydrated: boolean;
+    /** True while an org change is re-minting + re-enumerating (the workspace dropdown shows a loading hint). */
+    readonly loadingWorkspaces: boolean;
+    /**
+     * IRD-122 — the last switch's outcome feedback (122-AC-4: no switch is a silent no-op). `null` until a
+     * switch runs; then a `{ kind: "persisted" | "view" | "error", message }` the switcher surfaces so the
+     * user always sees whether a selection PERSISTED a real scope change, is a VIEW filter, or FAILED.
+     */
+    readonly switchFeedback: SwitchFeedback | null;
+    /**
+     * Select an org → PERSIST a real org switch via the daemon (re-mint + save to credentials.json —
+     * 122-AC-2), then re-enumerate workspaces; clears the workspace/project. Surfaces persisted/error
+     * feedback (122-AC-4). A failed persist does NOT silently change the view.
+     */
+    readonly selectOrg: (org: string) => void;
+    /** Select a workspace → PERSIST the workspace switch via the daemon (IRD-122), then re-enumerate projects. */
+    readonly selectWorkspace: (workspace: string) => void;
+    /**
+     * Select a project → re-scope the pages (VIEW filter only; viewer-side, no registry write — 49e-AC-4
+     * / 122-AC-3). Surfaces "view filter" feedback so the user understands the project dropdown changes
+     * the VIEW, not where capture is written (that is folder/binding-driven — PRD-059).
+     */
+    readonly selectProject: (project: string | undefined) => void;
+}
+/** IRD-122 — the outcome of the last switcher action, surfaced so no change is a silent no-op (122-AC-4). */
+export interface SwitchFeedback {
+    /** `persisted` = a real org/workspace scope change saved to credentials.json; `view` = a project view filter; `error` = the switch failed. */
+    readonly kind: "persisted" | "view" | "error";
+    /** A short human message the switcher renders (e.g. "switched to Acme", "view filter", "could not switch"). */
+    readonly message: string;
+    /** True while the switch is in flight (the org re-mint loading state — 122-AC-4 surfaces it). */
+    readonly pending?: boolean;
+}
+/** The switcher-data context (the enumeration + dropdown handlers). The slot reads it; pages do not. */
+export declare const ScopeSwitcherContext: React.Context<ScopeSwitcherValue>;
+/** Read the switcher's enumeration state + handlers (the {@link ScopeSwitcherSlot} uses this). */
+export declare function useScopeSwitcher(): ScopeSwitcherValue;
+/**
+ * Read the persisted viewer-side selection from `localStorage` (49e — persistence is acceptable, and
+ * viewer-side: a read of the dashboard's own store, never the registry). Fail-soft: a missing/malformed
+ * value yields `null` (the provider then resolves from the daemon default), never a throw.
+ */
+export declare function loadPersistedScope(): DashboardScope | null;
+/** Persist the viewer-side selection to `localStorage` (49e). Fail-soft — a storage error is swallowed intentionally. */
+export declare function persistScope(scope: DashboardScope): void;
+/**
+ * The SCOPE PROVIDER (PRD-049e) — owns the switchable selection + the enumeration state, and feeds both
+ * the lean {@link ScopeContext} (pages) and the rich {@link ScopeSwitcherContext} (the slot). Mounted by
+ * the {@link import("./app.js").Shell} around the sidebar + outlet, so every page + the switcher share
+ * ONE source of truth.
+ *
+ * On mount it hydrates the orgs (privilege-scoped), then the workspaces + projects for the
+ * resolved/persisted org, and restores the persisted project selection (viewer-side). Selecting an Org
+ * re-enumerates workspaces (the daemon re-mints the org-bound token FIRST — 49e-AC-3); selecting a
+ * Workspace re-enumerates projects; selecting a Project re-scopes the pages (the project flows into
+ * `useScope().scope.project`, which the pages thread into the wire fetchers). NO write to `projects.json`
+ * happens here — the selection is purely viewer-side (49e-AC-4).
+ */
+export declare function ScopeProvider({ wire, children }: {
+    wire: WireClient;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** Props for {@link ScopeSwitcherSlot}. `collapsed` mirrors the sidebar's rail state for the compact switcher. */
+export interface ScopeSwitcherSlotProps {
+    /** Whether the sidebar is in its collapsed icon-rail (renders a compact, label-free switcher). */
+    readonly collapsed: boolean;
+}
+/**
+ * The Org→Workspace→Project SWITCHER (PRD-049e) — the body that fills the 050b slot. Three dependent
+ * dropdowns hydrated from the {@link useScopeSwitcher} enumeration state; the active selection comes from
+ * {@link useScope}. Changing the Org re-enumerates workspaces (after the daemon re-mints — 49e-AC-3),
+ * changing the Workspace re-enumerates projects, and changing the Project re-scopes every page
+ * (viewer-side; no registry write — 49e-AC-4). In the collapsed rail it renders nothing (the switcher
+ * needs labels) — the sidebar expands to switch scope.
+ */
+export declare function ScopeSwitcherSlot({ collapsed }: ScopeSwitcherSlotProps): React.JSX.Element | null;