@legioncodeinc/hive 0.3.0 → 0.4.0

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

@@ -37,6 +37,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";
@@ -194,18 +196,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 +225,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 +243,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 +264,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 +279,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 +335,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 +352,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 +367,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 +381,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 +440,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 +1101,70 @@ 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>>>;
+}, 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;
 /**
  * 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 +1340,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 +1377,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 +1866,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>;
     /**

package/dist/dashboard/web/wire.js

@@ -44,6 +44,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
@@ -761,6 +764,40 @@ 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([]),
+});
+export const EMPTY_NECTAR_PROJECTS = Object.freeze({
+    globalBrooding: "on",
+    projects: [],
+    unreachable: false,
+});
+export const UNREACHABLE_NECTAR_PROJECTS = Object.freeze({
+    globalBrooding: "on",
+    projects: [],
+    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 +1828,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.