@legioncodeinc/hive 0.3.1 → 0.5.0

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

@@ -24,6 +24,9 @@
 import { z } from "zod";
 import { type RoiTrendView, type RoiView } from "../contracts.js";
 import { type ProjectionDerivedEntry, type ProjectionFileEntry } from "./hive-graph-projection.js";
+import { UNSELECTED_SETUP_TENANCY, type SetupTenancyWire } from "./onboarding/tenancy-contracts.js";
+export type { SetupTenancyWire };
+export { UNSELECTED_SETUP_TENANCY };
 /** The diagnostics view-model endpoints (served under `/api/diagnostics/*` + `/api/graph`). */
 export declare const ENDPOINTS: Readonly<{
     readonly kpis: "/api/diagnostics/kpis";
@@ -37,6 +40,8 @@ export declare const ENDPOINTS: Readonly<{
     readonly hiveGraphStatus: "/api/hive-graph/status";
     readonly hiveGraphProjection: "/api/hive-graph/projection";
     readonly hiveGraphBuild: "/api/hive-graph/build";
+    readonly hiveGraphProjects: "/api/hive-graph/projects";
+    readonly hiveGraphBrooding: "/api/hive-graph/projects/brooding";
     readonly memoryGraph: "/api/diagnostics/memory-graph";
     readonly recall: "/api/memories/recall";
     readonly memories: "/api/memories";
@@ -59,6 +64,7 @@ export declare const ENDPOINTS: Readonly<{
     readonly setupLogin: "/setup/login";
     readonly setupMigrate: "/setup/migrate-from-hivemind";
     readonly setupMigrateRollback: "/setup/migrate-from-hivemind/rollback";
+    readonly setupTenancy: "/setup/tenancy";
     readonly scopeOrgs: "/api/diagnostics/scope/orgs";
     readonly scopeWorkspaces: "/api/diagnostics/scope/workspaces";
     readonly scopeProjects: "/api/diagnostics/scope/projects";
@@ -194,18 +200,18 @@ export declare const SkillsSchema: z.ZodObject<{
 export type SkillRowWire = z.infer<typeof SkillRowSchema>;
 /** The per-section status discriminant → {@link import("../contracts.js").RoiSectionStatus}. */
 export declare const RoiSectionStatusSchema: z.ZodCatch<z.ZodEnum<{
+    absent: "absent";
     ok: "ok";
     unreachable: "unreachable";
     partial: "partial";
-    absent: "absent";
     unauthenticated: "unauthenticated";
 }>>;
 /** The status default for a BILLING-backed line — `unreachable` (couldn't read), not `absent` (no data). */
 export declare const RoiBillingStatusSchema: z.ZodCatch<z.ZodEnum<{
+    absent: "absent";
     ok: "ok";
     unreachable: "unreachable";
     partial: "partial";
-    absent: "absent";
     unauthenticated: "unauthenticated";
 }>>;
 /** The cost-basis tag → {@link import("../contracts.js").RoiCostBasisTag}. */
@@ -223,10 +229,10 @@ export declare const RoiAssumptionSchema: z.ZodObject<{
 /** The savings section (e-AC-3) → {@link import("../contracts.js").RoiSavingsSection}. */
 export declare const RoiSavingsSectionSchema: z.ZodObject<{
     status: z.ZodCatch<z.ZodEnum<{
+        absent: "absent";
         ok: "ok";
         unreachable: "unreachable";
         partial: "partial";
-        absent: "absent";
         unauthenticated: "unauthenticated";
     }>>;
     measuredCents: z.ZodCatch<z.ZodNumber>;
@@ -241,10 +247,10 @@ export declare const RoiSavingsSectionSchema: z.ZodObject<{
 /** The infra cost section (e-AC-6) → {@link import("../contracts.js").RoiInfraSection}. */
 export declare const RoiInfraSectionSchema: z.ZodObject<{
     status: z.ZodCatch<z.ZodEnum<{
+        absent: "absent";
         ok: "ok";
         unreachable: "unreachable";
         partial: "partial";
-        absent: "absent";
         unauthenticated: "unauthenticated";
     }>>;
     cents: z.ZodCatch<z.ZodNumber>;
@@ -262,10 +268,10 @@ export declare const RoiPollinationLineSchema: z.ZodObject<{
 /** The pollination cost section (e-AC-6) → {@link import("../contracts.js").RoiPollinationSection}. */
 export declare const RoiPollinationSectionSchema: z.ZodObject<{
     status: z.ZodCatch<z.ZodEnum<{
+        absent: "absent";
         ok: "ok";
         unreachable: "unreachable";
         partial: "partial";
-        absent: "absent";
         unauthenticated: "unauthenticated";
     }>>;
     cents: z.ZodCatch<z.ZodNumber>;
@@ -277,10 +283,10 @@ export declare const RoiPollinationSectionSchema: z.ZodObject<{
 /** The net-ROI section (e-AC-6) → {@link import("../contracts.js").RoiNetSection}. */
 export declare const RoiNetSectionSchema: z.ZodObject<{
     status: z.ZodCatch<z.ZodEnum<{
+        absent: "absent";
         ok: "ok";
         unreachable: "unreachable";
         partial: "partial";
-        absent: "absent";
         unauthenticated: "unauthenticated";
     }>>;
     computed: z.ZodCatch<z.ZodBoolean>;
@@ -333,10 +339,10 @@ export declare const RoiRollupSchema: z.ZodObject<{
 export declare const RoiViewSchema: z.ZodObject<{
     savings: z.ZodCatch<z.ZodObject<{
         status: z.ZodCatch<z.ZodEnum<{
+            absent: "absent";
             ok: "ok";
             unreachable: "unreachable";
             partial: "partial";
-            absent: "absent";
             unauthenticated: "unauthenticated";
         }>>;
         measuredCents: z.ZodCatch<z.ZodNumber>;
@@ -350,10 +356,10 @@ export declare const RoiViewSchema: z.ZodObject<{
     }, z.core.$strip>>;
     infra: z.ZodCatch<z.ZodObject<{
         status: z.ZodCatch<z.ZodEnum<{
+            absent: "absent";
             ok: "ok";
             unreachable: "unreachable";
             partial: "partial";
-            absent: "absent";
             unauthenticated: "unauthenticated";
         }>>;
         cents: z.ZodCatch<z.ZodNumber>;
@@ -365,10 +371,10 @@ export declare const RoiViewSchema: z.ZodObject<{
     }, z.core.$strip>>;
     pollination: z.ZodCatch<z.ZodObject<{
         status: z.ZodCatch<z.ZodEnum<{
+            absent: "absent";
             ok: "ok";
             unreachable: "unreachable";
             partial: "partial";
-            absent: "absent";
             unauthenticated: "unauthenticated";
         }>>;
         cents: z.ZodCatch<z.ZodNumber>;
@@ -379,10 +385,10 @@ export declare const RoiViewSchema: z.ZodObject<{
     }, z.core.$strip>>;
     net: z.ZodCatch<z.ZodObject<{
         status: z.ZodCatch<z.ZodEnum<{
+            absent: "absent";
             ok: "ok";
             unreachable: "unreachable";
             partial: "partial";
-            absent: "absent";
             unauthenticated: "unauthenticated";
         }>>;
         computed: z.ZodCatch<z.ZodBoolean>;
@@ -438,10 +444,10 @@ export declare const RoiTrendSeriesSchema: z.ZodObject<{
 /** `GET /api/diagnostics/roi/trend` → {@link import("../contracts.js").RoiTrendView}. */
 export declare const RoiTrendViewSchema: z.ZodObject<{
     status: z.ZodCatch<z.ZodEnum<{
+        absent: "absent";
         ok: "ok";
         unreachable: "unreachable";
         partial: "partial";
-        absent: "absent";
         unauthenticated: "unauthenticated";
     }>>;
     series: z.ZodCatch<z.ZodArray<z.ZodObject<{
@@ -1099,6 +1105,79 @@ export interface HiveGraphStatusResultWire extends HiveGraphStatusWire {
 export interface HiveGraphSearchResultWire extends HiveGraphSearchWire {
     readonly unreachable: boolean;
 }
+/** Per-project effective brooding state returned by nectar's `GET /api/hive-graph/projects`. */
+export declare const NectarProjectBroodingSchema: z.ZodEnum<{
+    active: "active";
+    paused: "paused";
+    "global-paused": "global-paused";
+}>;
+export declare const NectarProjectCountsSchema: z.ZodCatch<z.ZodObject<{
+    described: z.ZodCatch<z.ZodNumber>;
+    pending: z.ZodCatch<z.ZodNumber>;
+}, z.core.$strip>>;
+/** One active nectar project row (019b `GET /projects`). */
+export declare const NectarProjectRowSchema: z.ZodObject<{
+    projectId: z.ZodCatch<z.ZodString>;
+    name: z.ZodCatch<z.ZodString>;
+    path: z.ZodCatch<z.ZodString>;
+    brooding: z.ZodCatch<z.ZodEnum<{
+        active: "active";
+        paused: "paused";
+        "global-paused": "global-paused";
+    }>>;
+    watcher: z.ZodCatch<z.ZodString>;
+    counts: z.ZodCatch<z.ZodObject<{
+        described: z.ZodCatch<z.ZodNumber>;
+        pending: z.ZodCatch<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type NectarProjectRowWire = z.infer<typeof NectarProjectRowSchema>;
+export declare const NectarProjectsBodySchema: z.ZodObject<{
+    globalBrooding: z.ZodCatch<z.ZodEnum<{
+        paused: "paused";
+        on: "on";
+    }>>;
+    projects: z.ZodCatch<z.ZodArray<z.ZodObject<{
+        projectId: z.ZodCatch<z.ZodString>;
+        name: z.ZodCatch<z.ZodString>;
+        path: z.ZodCatch<z.ZodString>;
+        brooding: z.ZodCatch<z.ZodEnum<{
+            active: "active";
+            paused: "paused";
+            "global-paused": "global-paused";
+        }>>;
+        watcher: z.ZodCatch<z.ZodString>;
+        counts: z.ZodCatch<z.ZodObject<{
+            described: z.ZodCatch<z.ZodNumber>;
+            pending: z.ZodCatch<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    tenancyOrgName: z.ZodOptional<z.ZodString>;
+    tenancyWorkspaceName: z.ZodOptional<z.ZodString>;
+    tenancyOrgId: z.ZodOptional<z.ZodString>;
+    tenancyWorkspaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type NectarProjectsBodyWire = z.infer<typeof NectarProjectsBodySchema>;
+/** The nectar projects read-model the Hive Graph page polls (fail-soft `unreachable` flag). */
+export interface NectarProjectsWire extends NectarProjectsBodyWire {
+    readonly unreachable: boolean;
+}
+export declare const EMPTY_NECTAR_PROJECTS: NectarProjectsWire;
+export declare const UNREACHABLE_NECTAR_PROJECTS: NectarProjectsWire;
+/** Body for `POST /api/hive-graph/projects/brooding` (per-project or global). */
+export type SetNectarBroodingBody = {
+    readonly projectId: string;
+    readonly brooding: "on" | "off";
+} | {
+    readonly global: "on" | "paused";
+};
+/** The brooding toggle ack mirrors the persisted projects read-model (019b). */
+export type NectarBroodingAckWire = NectarProjectsWire;
+/** PRD-011: tenancy read with fail-soft unreachable flag (tv-AC-4). */
+export interface SetupTenancyResultWire extends SetupTenancyWire {
+    readonly unreachable: boolean;
+}
+export declare const UNREACHABLE_SETUP_TENANCY: SetupTenancyResultWire;
 /**
  * The generous client-side timeout (ms) for `buildGraph()`. The build parses the WHOLE repo with
  * tree-sitter and can take many seconds to tens of seconds; a short default fetch timeout would abort
@@ -1274,8 +1353,8 @@ export declare const AuthStatusSchema: z.ZodObject<{
     agentId: z.ZodCatch<z.ZodString>;
     source: z.ZodCatch<z.ZodEnum<{
         file: "file";
-        none: "none";
         env: "env";
+        none: "none";
     }>>;
     savedAt: z.ZodCatch<z.ZodString>;
     expiresAt: z.ZodOptional<z.ZodNumber>;
@@ -1311,17 +1390,17 @@ export declare const SetupStateSchema: z.ZodObject<{
         hivemind: z.ZodCatch<z.ZodBoolean>;
     }, z.core.$strip>>;
     phase: z.ZodCatch<z.ZodEnum<{
+        migrated: "migrated";
         linking: "linking";
         installed: "installed";
         fresh: "fresh";
         linked: "linked";
         migrating: "migrating";
-        migrated: "migrated";
     }>>;
     priorTool: z.ZodCatch<z.ZodObject<{
         hivemind: z.ZodCatch<z.ZodEnum<{
-            absent: "absent";
             migrated: "migrated";
+            absent: "absent";
             present: "present";
         }>>;
     }, z.core.$strip>>;
@@ -1800,6 +1879,17 @@ export interface WireClient {
      * 409 already_running, and success honestly — never throws into React.
      */
     hiveGraphBuild(): Promise<HiveGraphBuildAck>;
+    /**
+     * PRD-019c — read nectar's active-project set with brooding state (`GET /api/hive-graph/projects`).
+     * Degrades to {@link UNREACHABLE_NECTAR_PROJECTS} when nectar is down (never throws).
+     */
+    nectarProjects(): Promise<NectarProjectsWire>;
+    /**
+     * PRD-019c — set per-project or global brooding (`POST /api/hive-graph/projects/brooding`).
+     * Returns the persisted read-model on success; degrades to {@link UNREACHABLE_NECTAR_PROJECTS} on failure.
+     * The caller re-lists after a successful write so the UI reflects nectar's truth, never optimistic-only.
+     */
+    setNectarBrooding(body: SetNectarBroodingBody): Promise<NectarBroodingAckWire>;
     /** PRD-032c — read the vault `setting` class + the provider→model catalog (`GET /api/settings`). */
     vaultSettings(): Promise<VaultSettingsWire>;
     /**
@@ -1880,6 +1970,13 @@ export interface WireClient {
      * The response carries NO token (the schema has no token field by construction — c-AC-4).
      */
     setupLogin(): Promise<SetupLoginWire | null>;
+    /**
+     * PRD-011: read explicit tenancy selection state (`GET /setup/tenancy`). Degrades to
+     * {@link UNREACHABLE_SETUP_TENANCY} on failure; never throws. No token in the body. This is the
+     * ONLY tenancy method on WireClient (the tv-AC-4 display read); the onboarding step's
+     * enumerate/select/create surface lives in `onboarding/tenancy-client.ts` (ts-AC-11).
+     */
+    setupTenancy(): Promise<SetupTenancyResultWire>;
     /**
      * PRD-050d — "Proceed with Honeycomb": run the Hivemind→Honeycomb migration (`POST
      * /setup/migrate-from-hivemind`). The daemon backs up + uninstalls Hivemind idempotently, then

package/dist/dashboard/web/wire.js

@@ -24,6 +24,11 @@
 import { z } from "zod";
 import { EMPTY_ROI_TREND, EMPTY_ROI_VIEW } from "../contracts.js";
 import { projectionToGraphWire } from "./hive-graph-projection.js";
+// PRD-011: only the `GET /setup/tenancy` read lives on WireClient (the display surfaces, tv-AC-4).
+// The onboarding step's enumerate/select/create calls go through `onboarding/tenancy-client.ts`
+// exclusively (ts-AC-11), deliberately NOT duplicated here, so the two clients cannot drift.
+import { SetupTenancySchema, UNSELECTED_SETUP_TENANCY } from "./onboarding/tenancy-contracts.js";
+export { UNSELECTED_SETUP_TENANCY };
 // ─────────────────────────────────────────────────────────────────────────────
 // Endpoint paths (single source — the host serves these under the daemon origin).
 // ─────────────────────────────────────────────────────────────────────────────
@@ -44,6 +49,9 @@ export const ENDPOINTS = Object.freeze({
     hiveGraphStatus: "/api/hive-graph/status",
     hiveGraphProjection: "/api/hive-graph/projection",
     hiveGraphBuild: "/api/hive-graph/build",
+    // PRD-019b/c — nectar active-project set + brooding control (proxied to nectar :3854).
+    hiveGraphProjects: "/api/hive-graph/projects",
+    hiveGraphBrooding: "/api/hive-graph/projects/brooding",
     // PRD-041b — the memory-graph view-model (the knowledge graph of memories/entities). Served off
     // the diagnostics group (`/api/diagnostics/memory-graph`), mirroring `/api/graph`. Returns the SAME
     // `GraphView` shape so the existing `GraphCanvas` renders it unchanged; `built:false` until PRD-008
@@ -97,6 +105,9 @@ export const ENDPOINTS = Object.freeze({
     // crash-recovery "Roll back" affordance (d-AC-7).
     setupMigrate: "/setup/migrate-from-hivemind",
     setupMigrateRollback: "/setup/migrate-from-hivemind/rollback",
+    // PRD-011: the explicit-tenancy read (proxied to honeycomb `/setup/tenancy`). The onboarding
+    // step's enumerate/select/create endpoints live in `onboarding/tenancy-client.ts` only.
+    setupTenancy: "/setup/tenancy",
     // PRD-049e — the dashboard scope-switcher enumeration reads (local-mode-only loopback). The
     // switcher hydrates its Org→Workspace→Project dropdowns from these. `scopeOrgs`/`scopeWorkspaces`
     // are privilege-scoped by the daemon's token (`GET /organizations` / `GET /workspaces`);
@@ -761,6 +772,48 @@ export const FAILED_HIVE_GRAPH_BUILD_ACK = Object.freeze({
     state: "failed",
     message: "Build failed",
 });
+// ─────────────────────────────────────────────────────────────────────────────
+// PRD-019b/c — nectar projects + brooding wire shapes (`GET/POST .../projects*`).
+// ─────────────────────────────────────────────────────────────────────────────
+/** Per-project effective brooding state returned by nectar's `GET /api/hive-graph/projects`. */
+export const NectarProjectBroodingSchema = z.enum(["active", "paused", "global-paused"]);
+export const NectarProjectCountsSchema = z
+    .object({
+    described: z.number().catch(0),
+    pending: z.number().catch(0),
+})
+    .catch({ described: 0, pending: 0 });
+/** One active nectar project row (019b `GET /projects`). */
+export const NectarProjectRowSchema = z.object({
+    projectId: z.string().catch(""),
+    name: z.string().catch(""),
+    path: z.string().catch(""),
+    brooding: NectarProjectBroodingSchema.catch("active"),
+    watcher: z.string().catch(""),
+    counts: NectarProjectCountsSchema,
+});
+export const NectarProjectsBodySchema = z.object({
+    globalBrooding: z.enum(["on", "paused"]).catch("on"),
+    projects: z.array(NectarProjectRowSchema).catch([]),
+    tenancyOrgName: z.string().optional(),
+    tenancyWorkspaceName: z.string().optional(),
+    tenancyOrgId: z.string().optional(),
+    tenancyWorkspaceId: z.string().optional(),
+});
+export const EMPTY_NECTAR_PROJECTS = Object.freeze({
+    globalBrooding: "on",
+    projects: [],
+    unreachable: false,
+});
+export const UNREACHABLE_NECTAR_PROJECTS = Object.freeze({
+    globalBrooding: "on",
+    projects: [],
+    unreachable: true,
+});
+export const UNREACHABLE_SETUP_TENANCY = Object.freeze({
+    ...UNSELECTED_SETUP_TENANCY,
+    unreachable: true,
+});
 /**
  * The generous client-side timeout (ms) for `buildGraph()`. The build parses the WHOLE repo with
  * tree-sitter and can take many seconds to tens of seconds; a short default fetch timeout would abort
@@ -1791,6 +1844,40 @@ export function createWireClient(options = {}) {
                 clearTimeout(timer);
             }
         },
+        async nectarProjects() {
+            try {
+                const res = await fetchImpl(url(ENDPOINTS.hiveGraphProjects), {
+                    headers: { accept: "application/json", ...DASHBOARD_SESSION_HEADERS },
+                });
+                if (!res.ok)
+                    return UNREACHABLE_NECTAR_PROJECTS;
+                const parsed = NectarProjectsBodySchema.safeParse(await res.json());
+                if (!parsed.success)
+                    return UNREACHABLE_NECTAR_PROJECTS;
+                return { ...parsed.data, unreachable: false };
+            }
+            catch {
+                return UNREACHABLE_NECTAR_PROJECTS;
+            }
+        },
+        async setNectarBrooding(body) {
+            try {
+                const res = await fetchImpl(url(ENDPOINTS.hiveGraphBrooding), {
+                    method: "POST",
+                    headers: { "content-type": "application/json", accept: "application/json", ...DASHBOARD_SESSION_HEADERS },
+                    body: JSON.stringify(body),
+                });
+                if (!res.ok)
+                    return UNREACHABLE_NECTAR_PROJECTS;
+                const parsed = NectarProjectsBodySchema.safeParse(await res.json());
+                if (!parsed.success)
+                    return UNREACHABLE_NECTAR_PROJECTS;
+                return { ...parsed.data, unreachable: false };
+            }
+            catch {
+                return UNREACHABLE_NECTAR_PROJECTS;
+            }
+        },
         async vaultSettings() {
             // GET the `setting` class + catalog; a malformed/absent body degrades to the empty
             // view (nothing selected, no catalog) so the panel renders its empty state, never throws.
@@ -1885,6 +1972,24 @@ export function createWireClient(options = {}) {
             // a network failure → null (the button shows an honest error). The body carries NO token.
             return postJson(fetchImpl, url(ENDPOINTS.setupLogin), {}, SetupLoginSchema);
         },
+        async setupTenancy() {
+            // GET the explicit-tenancy state (PRD-011b tv-AC-4). A non-2xx / network / malformed
+            // body degrades to the honest unreachable state (never a fabricated tenancy, never a
+            // throw). The onboarding step's enumerate/select/create calls do NOT live here; they
+            // go through `onboarding/tenancy-client.ts` exclusively (ts-AC-11, no drift).
+            try {
+                const res = await fetchImpl(url(ENDPOINTS.setupTenancy), { headers: { accept: "application/json" } });
+                if (!res.ok)
+                    return UNREACHABLE_SETUP_TENANCY;
+                const parsed = SetupTenancySchema.safeParse(await res.json());
+                if (!parsed.success)
+                    return UNREACHABLE_SETUP_TENANCY;
+                return { ...parsed.data, unreachable: false };
+            }
+            catch {
+                return UNREACHABLE_SETUP_TENANCY;
+            }
+        },
         async migrateFromHivemind() {
             // POST the migration trigger; the daemon runs the guarded backup->uninstall->adopt transaction
             // and returns the terminal phase + message + backup path (+ needsLogin/migrated flags). A non-2xx