@cmgmyr/hive 1.9.1 → 1.10.1

package/README.md

@@ -66,6 +66,7 @@ hive is a personal daily-driver tool, released low-key. It is single-user by des
 | [Configuration](docs/configuration.md) | The `HIVE_*` environment variables |
 | [Profiles](docs/profiles.md) | Standing instructions across projects, the session-start plugin |
 | [Projects](docs/projects.md) | `hive init`, `hive.yml`, automatic backups, pads and todos from the shell |
+| [Crew sidebar](docs/crew.md) | `lead_sidebar`: a crew pane in a Claude lead, and the read-only `hive crew --json` behind it |
 | [Dashboard](docs/dashboard.md) | The generated dashboard: enabling it, where it lives, what it shows |
 | [Install details](docs/install.md) | The interpreter pin, iTerm settings, the status line, MCP scope, codex workers, updating, uninstalling |
 | [Troubleshooting](docs/troubleshooting.md) | Common errors and their fixes |

package/claude-plugin/README.md

@@ -48,3 +48,7 @@ though the kernel would have resolved that same path fine.
 resolves normally; node then realpaths the main entry, which puts the shim's
 own `../dist/kickoff.js` import inside the real checkout. No absolute machine
 path is ever written into a committed file.
+
+## The crew mod
+
+`crew/` is a second, separate plugin (`hive-crew`) that `hive lead` loads with `--plugin-dir` only when `lead_sidebar: true` is set and the lead is Claude. It is not part of the symlink install above and workers never load it. See [docs/crew.md](../docs/crew.md).

package/claude-plugin/crew/.claude-plugin/plugin.json

@@ -0,0 +1 @@
+{ "name": "hive-crew", "version": "0.1.0", "description": "A docked crew pane for a hive lead, read from `hive crew --json`" }

package/claude-plugin/crew/hooks/hooks.json

@@ -0,0 +1 @@
+{ "modules": ["./register.tsx"] }

package/claude-plugin/crew/hooks/register.tsx

@@ -0,0 +1,82 @@
+import { atom, read, update } from 'claude-code'
+import type { EngineInterface, Register } from 'claude-code'
+
+import { REFRESH_MS, buildCrewView, failedView, readCrew } from '../model.mjs'
+import type { CrewView } from '../types'
+
+const PANE = 'hive-crew'
+const crew = atom({ plugin: 'hive-crew', key: 'crew' } as const, null as CrewView | null)
+
+let polling = false
+
+async function startPolling($: EngineInterface) {
+  if (polling) return
+  polling = true
+  const cwd = await $.session.cwd()
+  let busy = false
+  const refresh = async () => {
+    if (busy) return
+    busy = true
+    try {
+      const snapshot = await readCrew((argv, init) => $.process.run(argv, init), cwd)
+      await update($, crew, prev => buildCrewView(snapshot, prev, Date.now()))
+    } catch (err) {
+      await update($, crew, prev => failedView(prev, String(err instanceof Error ? err.message : err)))
+    } finally {
+      busy = false
+    }
+  }
+  await refresh()
+  $.clock.every(REFRESH_MS, refresh)
+}
+
+export const register: Register = on => {
+  on('session.start', async ($, e, next) => {
+    const { stdout } = await $.process.run(['sh', '-c', 'printf %s "$HIVE_LEAD"'])
+    if (stdout !== '1') return next(e)
+    await $.command.register({ name: 'hive-crew', description: "Show this hive project's crew in a side pane" })
+    await startPolling($)
+    const now = await read($, crew)
+    if (now && !now.error) void $.ui.open({ id: PANE, title: 'hive crew' })
+    return next(e)
+  })
+
+  on('command.run', { command: 'hive-crew' }, async $ => {
+    await startPolling($)
+    await $.ui.open({ id: PANE, title: 'hive crew' })
+    return { text: 'hive crew pane opened.' }
+  })
+
+  on('ui.render', { component: 'Pane', requestId: PANE }, async ($, e) => {
+    const { Box, Text } = $.ui.resolve(e)
+    const c = await read($, crew)
+    if (!c) return <Text dimColor>reading the hive crew…</Text>
+    if (c.noData) {
+      return (
+        <Box flexDirection="column">
+          <Text color="red" wrap="truncate-end">read failed: {c.error}</Text>
+          <Text dimColor>no data yet</Text>
+        </Box>
+      )
+    }
+    return (
+      <Box flexDirection="column">
+        <Text bold wrap="truncate-end">{c.header}</Text>
+        {c.error && <Text color="red" wrap="truncate-end">read failed: {c.error}</Text>}
+        {c.rows.length === 0 && <Text dimColor>  no lanes</Text>}
+        {c.rows.map(r => (
+          <Box flexDirection="column">
+            <Text wrap="truncate-end"><Text color={r.color}>● </Text>{r.id} <Text dimColor>{r.slug}</Text></Text>
+            <Text wrap="truncate-end" dimColor>  {r.parts.map(p => <Text color={p.amber ? 'yellow' : undefined}>{p.text}</Text>)}</Text>
+          </Box>
+        ))}
+        <Text> </Text>
+        <Text bold color={c.needsYou.length ? 'red' : undefined}>{c.needsLabel}</Text>
+        {c.needsYou.length === 0 && <Text dimColor>  none</Text>}
+        {c.needsYou.map(t => <Text wrap="truncate-end">  {t.id} <Text dimColor>{t.slug}</Text></Text>)}
+        <Text> </Text>
+        {c.footer.map(line => <Text dimColor={!line.amber} color={line.amber ? 'yellow' : undefined} wrap="truncate-end">{line.text}</Text>)}
+      </Box>
+    )
+  })
+}

package/claude-plugin/crew/model.mjs

@@ -0,0 +1,139 @@
+export const SCHEMA_VERSION = 1;
+export const REFRESH_MS = 5000;
+export const TIMEOUT_MS = 4000;
+
+export function ago(seconds) {
+  const s = Math.max(0, Math.floor(seconds));
+  if (s < 60) return `${s}s`;
+  if (s < 3600) return `${Math.floor(s / 60)}m`;
+  return `${Math.floor(s / 3600)}h${Math.floor((s % 3600) / 60)}m`;
+}
+
+export async function readCrew(run, cwd) {
+  let res;
+  try {
+    res = await run(["hive", "crew", "--json"], { cwd, timeoutMs: TIMEOUT_MS });
+  } catch (err) {
+    throw new Error(`hive crew did not answer: ${String(err instanceof Error ? err.message : err).slice(0, 100)}`);
+  }
+  if (res.exitCode !== 0) {
+    const line = String(res.stderr ?? "").split("\n").map((l) => l.trim()).find((l) => l !== "");
+    throw new Error(`exit ${res.exitCode}${line ? `: ${line.slice(0, 120)}` : ""}`);
+  }
+  let snap;
+  try {
+    snap = JSON.parse(res.stdout);
+  } catch {
+    throw new Error("hive crew returned invalid JSON");
+  }
+  if (snap === null || typeof snap !== "object" || snap.schema_version !== SCHEMA_VERSION) {
+    throw new Error(`hive crew schema ${snap?.schema_version ?? "unknown"} is not ${SCHEMA_VERSION}; update hive`);
+  }
+  if (!Array.isArray(snap.lanes) || !Array.isArray(snap.needs_you) || snap.wakes === null || typeof snap.wakes !== "object" || !Array.isArray(snap.wakes.watching)) {
+    throw new Error("hive crew JSON is missing lanes, needs_you or wakes");
+  }
+  return snap;
+}
+
+export function emptyView() {
+  return { header: "", rows: [], needsLabel: "", needsYou: [], footer: [], error: "", memory: {}, noData: true };
+}
+
+export function failedView(previousView, message) {
+  return { ...(previousView ?? emptyView()), error: message };
+}
+
+function duration(worker, activity, nowMs, memory, nextMemory) {
+  const key = `${worker.id}|${worker.session_id}|${activity.label}`;
+  const stamp = activity.since;
+  const at = stamp ? Date.parse(stamp) : NaN;
+  if (Number.isFinite(at)) return `${activity.lower_bound ? ">=" : ""}${ago((nowMs - at) / 1000)}`;
+  const first = memory[key] ?? nowMs;
+  nextMemory[key] = first;
+  return `~${ago((nowMs - first) / 1000)}`;
+}
+
+function workerRow(lane, snapshot, nowMs, memory, nextMemory) {
+  const w = lane.worker;
+  const checkpoint = snapshot.context_checkpoint_percent;
+  const todo = lane.todo;
+  const linkLabel = todo ? todo.slug : lane.pad ? `pad ${lane.pad}` : `${w.name} unlinked`;
+  const state = w.state === "blocked" ? "blocked" : w.your_turn ? "your turn" : w.state;
+  const color = state === "blocked" ? "red" : state === "your turn" ? "yellow" : state === "working" ? "green" : "gray";
+  const fill = w.context_fill;
+  const head = [w.model || w.harness];
+  if (state === "working") head.push(`${w.activity.label} ${duration(w, w.activity, nowMs, memory, nextMemory)}`);
+  else {
+    const since = state === "blocked" ? null : w.state_changed_at;
+    head.push(`${state} ${duration(w, { label: state, since, lower_bound: false }, nowMs, memory, nextMemory)}`);
+    if (state !== "blocked" && w.activity?.label) head.push(w.activity.label);
+  }
+  const tail = [ago(w.age_seconds)];
+  if (w.commits_ahead !== null && w.commits_ahead !== undefined) tail.push(`+${w.commits_ahead} commits`);
+  const amber = Boolean(fill) && checkpoint !== null && checkpoint !== undefined && fill.used_percent >= checkpoint;
+  return rowOf({
+    key: `w${w.id}`,
+    color,
+    id: todo ? String(todo.id) : "--",
+    slug: linkLabel,
+    parts: [
+      { text: `${head.join(" · ")} · ` },
+      { text: fill ? `ctx ${Math.round(fill.used_percent)}%` : "ctx ?", amber },
+      { text: ` · ${tail.join(" · ")}` },
+    ],
+  });
+}
+
+function nextLine(next, nowMs) {
+  if (!next) return "next: none";
+  const label = next.generated ? "crew notice" : next.label;
+  if (next.held) return `held (${next.held}): ${label}`;
+  const due = next.due_at && Number.isFinite(Date.parse(next.due_at)) ? ` in ${ago((Date.parse(next.due_at) - nowMs) / 1000)}` : "";
+  return `next${due}: ${label}`;
+}
+
+function covered(snapshot) {
+  const ids = new Set(snapshot.wakes.watched_worker_ids ?? []);
+  return snapshot.lanes.some((l) => l.worker && ids.has(l.worker.id));
+}
+
+function watchText(w) {
+  const parts = [w.scope === "project" ? "all workers" : w.scope || w.label, "standing"];
+  const until = w.max_wait_at ? new Date(w.max_wait_at) : null;
+  if (until && Number.isFinite(until.getTime())) {
+    parts.push(`until ${String(until.getHours()).padStart(2, "0")}:${String(until.getMinutes()).padStart(2, "0")}`);
+  }
+  return parts.join(" · ");
+}
+
+function rowOf(row) {
+  return { ...row, detail: row.parts.map((p) => p.text).join("") };
+}
+
+export function buildCrewView(snapshot, previousView, nowMs) {
+  const memory = previousView?.memory ?? {};
+  const nextMemory = {};
+  const rows = snapshot.lanes.map((lane) =>
+    lane.worker
+      ? workerRow(lane, snapshot, nowMs, memory, nextMemory)
+      : rowOf({ key: `t${lane.todo.id}`, color: "gray", id: String(lane.todo.id), slug: lane.todo.slug, parts: [{ text: "unstaffed" }] }),
+  );
+  const { wakes } = snapshot;
+  const workers = snapshot.lanes.filter((l) => l.worker).length;
+  const footer = [{ text: nextLine(wakes.next, nowMs) }];
+  if (wakes.watching.length > 0) footer.push({ text: `watching: ${wakes.watching.map(watchText).join(", ")}` });
+  else if (workers > 0 && !covered(snapshot)) footer.push({ text: "unwatched: no standing watch on running workers", amber: true });
+  return {
+    header: [
+      `${snapshot.project.name} · ${workers} worker${workers === 1 ? "" : "s"}`,
+      snapshot.needs_you.length > 0 ? `${snapshot.needs_you.length} todo${snapshot.needs_you.length === 1 ? "" : "s"} for you` : "",
+    ].filter(Boolean).join(" · "),
+    rows,
+    needsLabel: snapshot.needs_you.length > 0 ? `todos waiting on you (${snapshot.needs_you.length})` : "todos waiting on you",
+    needsYou: snapshot.needs_you.map((t) => ({ id: String(t.id), slug: t.slug })),
+    footer,
+    error: "",
+    memory: nextMemory,
+    noData: false,
+  };
+}

package/claude-plugin/crew/types/index.d.ts

@@ -0,0 +1,18 @@
+export type Part = { text: string; amber?: boolean }
+export type Row = { key: string; color: string; id: string; slug: string; detail: string; parts: Part[] }
+export type CrewView = {
+  header: string
+  rows: Row[]
+  needsLabel: string
+  needsYou: { id: string; slug: string }[]
+  footer: { text: string; amber?: boolean }[]
+  error: string
+  memory: Record<string, number>
+  noData: boolean
+}
+
+declare module 'claude-code' {
+  interface PluginState {
+    'hive-crew': { crew: CrewView | null }
+  }
+}

package/dist/build-info.json

@@ -1 +1 @@
-{"version":"1.9.1","sha":"2056b89","dirty":false,"build_id":"6b9bbe7ee1cda1fc2700518664c980aac9692d27caead18970553a3f6b3cbae9"}
+{"version":"1.10.1","sha":"47de74a","dirty":false,"build_id":"8d90ac219e940dac865c9770e28e1686dbed96d3d7ec219884aa4b6aa328dab5"}

package/dist/cli.js

@@ -22,8 +22,10 @@ import { confirmQueenWrite, listQueenAudit } from "./queenAudit.js";
 import { formatRowCounts, projectRowCounts, removeProject } from "./projectRemove.js";
 import { ensureHooksFile, ensureLeadHooksFile } from "./hooks.js";
 import { errorMessage, registrationNoticeText, withTrailingNewline } from "./result.js";
-import { ACTIVE_TIMER_WHERE, socketAwaitingWhere, dashboardFileContained, describeStall, HELD_REASON_CONVERSATION, HELD_REASON_LEAD_PANE_DEAD, HELD_REASON_UNCLASSIFIABLE_PANE_PREFIX, isLeadRowClosedHold, isUnclassifiablePaneHold, HELD_REASON_UNSUBMITTED_INPUT_PREFIX, isUnsubmittedInputHold, janitor, resolveDashboardFile, generateQueenDashboardNow, transcriptStaleness, wasHeldForPaneIdentity, } from "./scheduler.js";
+import { ACTIVE_TIMER_WHERE, socketAwaitingWhere, dashboardFileContained, describeStall, HELD_REASON_UNCLASSIFIABLE_PANE_PREFIX, HELD_REASON_UNSUBMITTED_INPUT_PREFIX, janitor, resolveDashboardFile, generateQueenDashboardNow, transcriptStaleness, } from "./scheduler.js";
 import { readTurnCount } from "./turnCount.js";
+import { leadSessionEnded } from "./leadState.js";
+import { heldReasonLabel } from "./heldLabel.js";
 import { collectPortfolio, leadText } from "./portfolio.js";
 import { STALL_BOUND_SECONDS } from "./backgroundTasks.js";
 import { probeSessionInterpreter, reexecTarget, sessionStartVerdict, } from "./sessionProbe.js";
@@ -31,7 +33,8 @@ import { backupHealth, backupNow, backupsDir, formatBytes, listSnapshots, previe
 import { describeTeardownWindow, readTeardowns, teardownLogPath, } from "./teardown.js";
 import { asNameClash, buildEnvFlags, closeAgentRow, isReservedAgentName, launchAgent, LEAD_KIND, LEAD_NAME, mintLeadActorId, relayoutAfterPaneLeft, upsertActor, withWindowClaim, } from "./spawn.js";
 import { adoptableWindow, applyLayout, claimInitialWindow, configureHiveWindow, controlModeFor, createWindow, DEFAULT_LAYOUT, describePaneChoice, ensureSession, findProjectWindow, foreignSocket, isViewSessionName, listOwnedWindows, liveTargets, observationFailed, observeRowOwnership, ORPHAN_MIN_AGE_MS, orphanScratchServers, orphansWorthWarningAbout, paneIsAloneInWindow, paneVisibility, panePidForRecord, PROCESSES_LAYOUT, processesPaneTitle, processesWindowName, projectWindows, RAW_ATTACH_TMUX_CONFIG, renderAttachCommand, resolveAttachTarget, resolveInTmuxTarget, rowLive, rowOwnership, SESSION_PREFIX, appendGlobalHook, globalHooks, replaceGlobalHooks, sessionName, setPaneTitle, shellQuote, shownPaneTitle, makeProcessesWindow, tmux, TMUX_DOC, tmuxSaysNothingThere, tmuxTimeoutOverride, tmuxSocketPath, untrustedTmuxServer, waitForPaneEstablished, windowLayout, } from "./tmux.js";
-import { describeVisibility, processCounts } from "./dashboard.js";
+import { collectCrew, crewStoreProblem } from "./crew.js";
+import { describeVisibility, formatLocal, processCounts } from "./dashboard.js";
 import { runningCommandRow, runningCommandRows, snapshotProcesses, stopAllProcesses, stopLine, stopProcess, STOP_REASONS, } from "./processes.js";
 import { activeProfile, agentVarKeys, BUILT_IN_PROJECT_YML, configHash, loadProjectYml, mergedProjectVars, NO_PROFILE, PROJECT_YML_KEYS, resolveCommandDir, resolveFirstMessage, } from "./projectYml.js";
 import { writeProjectPosture } from "./brief.js";
@@ -67,6 +70,8 @@ Usage:
   hive show <process> [path]  move a running process's pane beside the lead
   hive hide <process> [path]  move it back into the <project>/processes window
   hive status                overview of agents, todos, and wake-ups everywhere
+  hive crew --json           this project's workers, todos and wakes as one JSON
+                             snapshot; read-only, writes nothing
   hive portfolio [--json]    one row per registered project: lane, lead, workers,
                              todos, needs-human count, wakes; read-only
   hive queen-audit           confirmed queen writes, newest first; 30-day history
@@ -450,6 +455,9 @@ async function cmdLead(argv) {
                 leadCommand += ` --name ${shellQuote(project.name)}`;
             }
             leadCommand += ` ${leadHarness.briefDelivery.settingsArgs(hooksPath).map(shellQuote).join(" ")}`;
+            if (config?.lead_sidebar === true && leadHarness.name === "claude") {
+                leadCommand += ` ${["--plugin-dir", crewPluginDir()].map(shellQuote).join(" ")}`;
+            }
             if (renderedPosture !== null) {
                 const posturePath = writeProjectPosture(project.id, renderedPosture);
                 leadCommand += ` ${leadHarness.briefDelivery.systemPromptArgs(posturePath).map(shellQuote).join(" ")}`;
@@ -745,6 +753,8 @@ const HIVE_YML_TEMPLATE = `# hive project config. Read by \`hive lead\` from the
 
 # dashboard: true               # write .hive/dashboard.html (default: false)
 
+# lead_sidebar: true            # a crew pane in a claude lead (default: false; restart the lead)
+
 # quiet_messaging: true        # wakes and worker messages reach a claude lead as one row (default: false; restart the lead)
 
 # vars:                         # substituted into the profile runbook
@@ -1278,6 +1288,9 @@ function cmdProfile(argv) {
         throw e;
     }
 }
+function crewPluginDir() {
+    return join(checkoutRoot, "claude-plugin", "crew");
+}
 const DASHBOARD_OPENED_KV_KEY = "hive:dashboard_opened";
 const DASHBOARD_OPENED_TTL_SECONDS = 8 * 60 * 60;
 function maybeOpenDashboard(project, dashboardEnabled) {
@@ -1605,6 +1618,10 @@ const LEAD_OWNERSHIP_LABEL = {
     reissued: "no live pane",
     unknown: "pane identity unknown",
 };
+function leadStatusLabel(row, ownership) {
+    const ended = leadSessionEnded(row, ownership);
+    return ended ? `dormant (session ended ${formatLocal(ended.ended_at)})` : LEAD_OWNERSHIP_LABEL[ownership];
+}
 function cmdStatus() {
     janitor();
     let anyOutput = false;
@@ -1656,7 +1673,7 @@ function cmdStatus() {
             const state = a.kind === "agent"
                 ? describeForHuman(deriveProvenance(a, null))
                 : a.kind === LEAD_KIND
-                    ? LEAD_OWNERSHIP_LABEL[rowOwnership(a, statusSnapshot())]
+                    ? leadStatusLabel(a, rowOwnership(a, statusSnapshot()))
                     : (whereIs.get(a.name) ?? "running");
             const label = a.kind === "command" ? "cmd  " : a.kind === LEAD_KIND ? "lead " : "agent";
             console.log(`  ${label}  ${a.name.padEnd(20)} ${state}`);
@@ -2819,22 +2836,6 @@ function cmdStatusline() {
     }
     console.log(`\x1b[33m⬡\x1b[0m \x1b[2mhive:\x1b[0m ${parts.join(" \x1b[2m·\x1b[0m ")}`);
 }
-// test/docs.test.mjs fails if a label here is missing from docs/install.md. It checks
-// presence only: docs/install.md also counts the set in prose, and nothing guards that number.
-export const HELD_REASON_LABELS = ["typing", "talking", "needs you", "blocked"];
-export function heldReasonLabel(heldReason) {
-    if (isUnsubmittedInputHold(heldReason))
-        return "typing";
-    if (heldReason === HELD_REASON_LEAD_PANE_DEAD ||
-        wasHeldForPaneIdentity(heldReason) ||
-        isLeadRowClosedHold(heldReason) ||
-        isUnclassifiablePaneHold(heldReason)) {
-        return "needs you";
-    }
-    if (heldReason === HELD_REASON_CONVERSATION)
-        return "talking";
-    return "blocked";
-}
 function padSlug(name) {
     return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "pad";
 }
@@ -2955,6 +2956,34 @@ function cmdQueenAudit(argv) {
             `  ${entry.operation}  ${entry.resource_type} #${entry.resource_id}\n  ${entry.summary}`);
     }
 }
+function cmdCrew(argv) {
+    const parsed = parseArgs(argv, { flags: ["--json"] });
+    if (parsed.positional.length > 0)
+        parsed.unknown.push(parsed.positional[0]);
+    rejectUnknownFlags("crew", parsed, "--json");
+    if (!parsed.flags.has("--json")) {
+        console.error("hive crew: usage: hive crew --json. It prints one JSON snapshot of this project's workers, todos and wakes.");
+        process.exit(1);
+    }
+    const problem = crewStoreProblem();
+    if (problem) {
+        console.error(`hive crew: ${problem}. Run any other hive command once (for example hive status) to migrate it, then retry.`);
+        process.exit(1);
+    }
+    let project;
+    try {
+        project = pinnedOrCwdProject();
+    }
+    catch (e) {
+        console.error(`hive crew: ${errorMessage(e)}`);
+        process.exit(1);
+    }
+    if (!project) {
+        console.error("hive crew: this directory is not a registered hive project. cd to a registered checkout, or run `hive init` here to register it.");
+        process.exit(1);
+    }
+    console.log(JSON.stringify(collectCrew(project, new Date())));
+}
 function cmdPortfolio(argv) {
     const parsed = parseArgs(argv, { flags: ["--json"] });
     if (parsed.positional.length > 0)
@@ -3404,7 +3433,7 @@ if (command === "--version" || command === "-v") {
     process.exit(0);
 }
 const COMMANDS = [
-    "lead", "queen", "queen-audit", "init", "attach", "start", "stop", "show", "hide", "status", "portfolio", "next", "setup", "upgrade", "doctor",
+    "lead", "queen", "queen-audit", "init", "attach", "start", "stop", "show", "hide", "status", "portfolio", "crew", "next", "setup", "upgrade", "doctor",
     LEAD_PANE_EXITED_VERB,
     "pads", "pad", "todos", "todo", "backups", "restore", "project", "runbook", "posture", "profile", "kickoff", "statusline",
 ];
@@ -3421,7 +3450,7 @@ if (!COMMANDS.includes(command)) {
         usage();
     }
 }
-if (command !== "upgrade")
+if (command !== "upgrade" && command !== "crew")
     migrate();
 try {
     switch (command) {
@@ -3458,6 +3487,9 @@ try {
         case "portfolio":
             cmdPortfolio(rest);
             break;
+        case "crew":
+            cmdCrew(rest);
+            break;
         case "queen-audit":
             cmdQueenAudit(rest);
             break;