hlidskjalf 0.0.4 → 0.0.6

package/README.md

@@ -1,6 +1,6 @@
 # hlidskjalf
 
-A terminal dashboard for monitoring Turborepo dev processes, built with [Ink](https://npm.im/ink).
+A Terminal User Interface for visualizing Turborepo tasks, built with [Ink](https://npm.im/ink).
 
 ## Usage
 
@@ -24,5 +24,5 @@ pnpm dev
 
 | Option | Description |
 | --- | --- |
-| `--filter=<name>` | Only include matching workspaces. Can be passed multiple times. Append `...` to include transitive dependencies (e.g. `--filter=web...`). |
-| `--order=<mode>` | `alphabetical` (default) or `run` (dependency order). |
+| `filter` | Include specific workspaces (`--filter=web`). Repeatable. Append `...` for transitive deps. |
+| `order` | Sort by `alphabetical` (default) or `run` (`--order=run`) dependency order. |

package/dist/index.js

@@ -1,498 +1,12 @@
 #!/usr/bin/env node
-
-// src/index.tsx
-import { render } from "ink";
-
-// src/app.tsx
-import { useApp, useInput } from "ink";
-import { useCallback, useEffect, useRef, useState } from "react";
-
-// src/processes.ts
-import { spawn } from "child_process";
-import { EventEmitter } from "events";
-
-// src/parser.ts
-var DTS = /\bDTS\b/;
-var matchers = [
-  { pattern: /running on (https?:\/\/\S+)/, status: "ready" },
-  { pattern: /listening on (https?:\/\/\S+)/, status: "ready" },
-  { pattern: /started.*(https?:\/\/localhost:\d+)/, status: "ready" },
-  { pattern: /\bVITE\b.*\bready in\b/i, status: "ready" },
-  { pattern: /\bLocal:\s+(https?:\/\/\S+)/, status: "ready" },
-  // ⚡ may include U+FE0F variation selector
-  { pattern: /⚡\uFE0F?\s*Build success/, status: "watching" },
-  { pattern: /Build start/, status: "building" },
-  { pattern: /Watching for changes/, status: "watching" },
-  { pattern: /[Ee]rror[\s:]/, status: "error" },
-  { pattern: /process exit/, status: "error" }
-];
-function parseLine(line) {
-  if (DTS.test(line)) return {};
-  for (const { pattern, status } of matchers) {
-    const match = line.match(pattern);
-    if (match) return { status, url: match[1] };
-  }
-  return {};
-}
-function stripAnsi(text) {
-  return text.replace(/\x1b(?:\[[0-9;]*[A-Za-z]|\].*?(?:\x07|\x1b\\))/g, "");
-}
-
-// src/processes.ts
-var MAX_LOGS = 500;
-var ERROR_RECOVERY_MS = 5e3;
-var MAX_CRASH_RETRIES = 3;
-var ProcessRunner = class extends EventEmitter {
-  children = /* @__PURE__ */ new Map();
-  state = /* @__PURE__ */ new Map();
-  errorTimers = /* @__PURE__ */ new Map();
-  lastGoodStatus = /* @__PURE__ */ new Map();
-  crashRetries = /* @__PURE__ */ new Map();
-  pendingRebuilds = /* @__PURE__ */ new Set();
-  root;
-  stopping = false;
-  constructor(root) {
-    super();
-    this.root = root;
-  }
-  get(name) {
-    return this.state.get(name);
-  }
-  async start(workspaces) {
-    const packages = workspaces.filter((w) => w.kind === "package");
-    const apps = workspaces.filter((w) => w.kind !== "package");
-    for (const workspace of workspaces) {
-      this.state.set(workspace.name, { workspace, status: "pending", logs: [] });
-    }
-    for (const workspace of packages) {
-      this.spawn(workspace);
-    }
-    if (packages.length > 0) {
-      await this.waitForPackages(packages.map((p) => p.name));
-    }
-    for (const workspace of apps) {
-      this.spawn(workspace);
-    }
-  }
-  async shutdown() {
-    this.stopping = true;
-    for (const timer of this.errorTimers.values()) clearTimeout(timer);
-    this.errorTimers.clear();
-    for (const child of this.pendingRebuilds) child.kill("SIGTERM");
-    const waiting = [];
-    for (const [, child] of this.children) {
-      if (child.exitCode !== null || child.signalCode !== null) continue;
-      waiting.push(
-        new Promise((resolve) => {
-          const escalate = setTimeout(() => {
-            if (child.exitCode === null) child.kill("SIGKILL");
-          }, 5e3);
-          child.on("close", () => {
-            clearTimeout(escalate);
-            resolve();
-          });
-          child.kill("SIGTERM");
-        })
-      );
-    }
-    await Promise.all(waiting);
-  }
-  waitForPackages(names) {
-    const remaining = new Set(names);
-    return new Promise((resolve) => {
-      const check = () => {
-        for (const name of [...remaining]) {
-          const s = this.state.get(name)?.status;
-          if (s === "watching" || s === "error" || s === "stopped") remaining.delete(name);
-        }
-        if (remaining.size === 0) {
-          this.off("change", check);
-          resolve();
-        }
-      };
-      this.on("change", check);
-      check();
-    });
-  }
-  spawn(workspace) {
-    const child = spawn("pnpm", ["--filter", workspace.name, "run", "dev"], {
-      cwd: this.root,
-      stdio: "pipe",
-      env: { ...process.env, FORCE_COLOR: "1" }
-    });
-    this.children.set(workspace.name, child);
-    this.setStatus(workspace.name, "building");
-    let buffer = "";
-    const onData = (data) => {
-      buffer += data.toString();
-      const lines = buffer.split("\n");
-      buffer = lines.pop();
-      for (const raw of lines) {
-        const line = raw.trimEnd();
-        if (line) this.handleLine(workspace.name, line);
-      }
-    };
-    child.stdout?.on("data", onData);
-    child.stderr?.on("data", onData);
-    child.on("close", (code, signal) => {
-      if (buffer.trim()) this.handleLine(workspace.name, buffer.trimEnd());
-      buffer = "";
-      if (this.stopping) return;
-      if (signal === "SIGABRT") {
-        this.handleCrash(workspace);
-        return;
-      }
-      this.setStatus(workspace.name, code === 0 ? "stopped" : "error");
-    });
-    child.on("error", () => this.setStatus(workspace.name, "error"));
-  }
-  handleLine(name, line) {
-    const proc = this.state.get(name);
-    if (!proc) return;
-    proc.logs.push(line);
-    if (proc.logs.length > MAX_LOGS) proc.logs.splice(0, proc.logs.length - MAX_LOGS);
-    const { status, url } = parseLine(stripAnsi(line));
-    if (status) {
-      if (status === "error") {
-        this.scheduleErrorRecovery(name);
-      } else {
-        this.lastGoodStatus.set(name, status);
-        this.clearErrorTimer(name);
-      }
-      proc.status = status;
-    }
-    if (url) proc.url = url;
-    this.emit("change");
-  }
-  handleCrash(workspace) {
-    const retries = (this.crashRetries.get(workspace.name) ?? 0) + 1;
-    this.crashRetries.set(workspace.name, retries);
-    const proc = this.state.get(workspace.name);
-    if (retries <= MAX_CRASH_RETRIES) {
-      if (proc) {
-        proc.logs.push(
-          `[hlidskjalf] fsevents crash detected (attempt ${retries}/${MAX_CRASH_RETRIES}) \u2014 rebuilding...`
-        );
-      }
-      this.emit("change");
-      this.rebuildFsevents().then(() => {
-        if (!this.stopping) this.spawn(workspace);
-      }).catch(() => this.setStatus(workspace.name, "error"));
-    } else {
-      if (proc) {
-        proc.logs.push(
-          `[hlidskjalf] fsevents still crashing after ${MAX_CRASH_RETRIES} attempts \u2014 giving up.`
-        );
-      }
-      this.setStatus(workspace.name, "error");
-    }
-  }
-  rebuildFsevents() {
-    return new Promise((resolve) => {
-      const child = spawn("pnpm", ["rebuild", "fsevents"], {
-        cwd: this.root,
-        stdio: "pipe"
-      });
-      this.pendingRebuilds.add(child);
-      const done = () => {
-        this.pendingRebuilds.delete(child);
-        resolve();
-      };
-      child.on("close", done);
-      child.on("error", done);
-    });
-  }
-  scheduleErrorRecovery(name) {
-    this.clearErrorTimer(name);
-    const timer = setTimeout(() => {
-      this.errorTimers.delete(name);
-      const proc = this.state.get(name);
-      if (proc?.status === "error") {
-        this.setStatus(name, this.lastGoodStatus.get(name) ?? "ready");
-      }
-    }, ERROR_RECOVERY_MS);
-    timer.unref();
-    this.errorTimers.set(name, timer);
-  }
-  clearErrorTimer(name) {
-    const timer = this.errorTimers.get(name);
-    if (timer) {
-      clearTimeout(timer);
-      this.errorTimers.delete(name);
-    }
-  }
-  setStatus(name, status) {
-    const proc = this.state.get(name);
-    if (!proc) return;
-    proc.status = status;
-    this.emit("change");
-  }
-};
-function createRunner(root) {
-  return new ProcessRunner(root);
-}
-
-// src/views/dashboard.tsx
-import { Box, Text, useStdout } from "ink";
-import { jsx, jsxs } from "react/jsx-runtime";
-var kindLabel = {
-  package: "pkg",
-  app: "app",
-  service: "svc"
-};
-var statusDisplay = {
-  pending: { color: "gray", label: "pending" },
-  building: { color: "yellow", label: "building" },
-  watching: { color: "green", label: "watching" },
-  ready: { color: "green", label: "watching" },
-  error: { color: "red", label: "error" },
-  stopped: { color: "gray", label: "stopped" }
-};
-var HINTS = "\u2191/\u2193  j/k  select    q  quit";
-function Dashboard({ processes, selectedIndex }) {
-  const { stdout } = useStdout();
-  const cols = stdout?.columns ?? 80;
-  const rows = stdout?.rows ?? 24;
-  const allReady = processes.length > 0 && processes.every((p) => p.status === "ready" || p.status === "watching");
-  const nameWidth = Math.max(14, ...processes.map((p) => p.workspace.name.length + 2));
-  const logHeight = Math.max(3, rows - processes.length - 5);
-  const safeIndex = Math.min(selectedIndex, Math.max(0, processes.length - 1));
-  const selected = processes[safeIndex];
-  const logLines = selected?.logs.slice(-logHeight) ?? [];
-  const showHints = cols >= 10 + HINTS.length + 4;
-  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs(Box, { children: [
-      /* @__PURE__ */ jsxs(Box, { flexGrow: 1, children: [
-        /* @__PURE__ */ jsx(Text, { color: allReady ? "green" : "gray", children: "\u25CF " }),
-        /* @__PURE__ */ jsx(Text, { bold: true, children: "Hlidskjalf" })
-      ] }),
-      showHints && /* @__PURE__ */ jsx(Text, { dimColor: true, children: HINTS })
-    ] }),
-    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2500".repeat(cols) }),
-    /* @__PURE__ */ jsxs(Box, { marginLeft: 1, children: [
-      /* @__PURE__ */ jsx(Box, { width: nameWidth, children: /* @__PURE__ */ jsx(Text, { dimColor: true, bold: true, children: "Name" }) }),
-      /* @__PURE__ */ jsx(Box, { width: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, bold: true, children: "Kind" }) }),
-      /* @__PURE__ */ jsx(Box, { width: 14, children: /* @__PURE__ */ jsx(Text, { dimColor: true, bold: true, children: "Status" }) }),
-      /* @__PURE__ */ jsx(Text, { dimColor: true, bold: true, children: "URL" })
-    ] }),
-    processes.map((proc, i) => {
-      const isSelected = i === safeIndex;
-      const { color, label } = statusDisplay[proc.status];
-      return /* @__PURE__ */ jsxs(Box, { children: [
-        /* @__PURE__ */ jsx(Text, { color: isSelected ? "cyan" : void 0, children: isSelected ? "\u25B8" : " " }),
-        /* @__PURE__ */ jsx(Box, { width: nameWidth, children: /* @__PURE__ */ jsx(Text, { color: isSelected ? "cyan" : void 0, bold: isSelected, wrap: "truncate", children: proc.workspace.name }) }),
-        /* @__PURE__ */ jsx(Box, { width: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: kindLabel[proc.workspace.kind] }) }),
-        /* @__PURE__ */ jsx(Box, { width: 14, children: /* @__PURE__ */ jsxs(Text, { color, children: [
-          "\u25CF ",
-          label
-        ] }) }),
-        /* @__PURE__ */ jsx(Text, { dimColor: true, children: proc.url ?? "" })
-      ] }, proc.workspace.name);
-    }),
-    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2500".repeat(cols) }),
-    selected && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-      /* @__PURE__ */ jsx(Box, { marginLeft: 1, children: /* @__PURE__ */ jsxs(Text, { bold: true, children: [
-        "Logs: ",
-        selected.workspace.name
-      ] }) }),
-      logLines.map((line, i) => (
-        // biome-ignore lint/suspicious/noArrayIndexKey: log lines have no stable identity
-        /* @__PURE__ */ jsxs(Text, { wrap: "truncate", children: [
-          " ",
-          line
-        ] }, i)
-      )),
-      Array.from({ length: logHeight - logLines.length }, (_, i) => (
-        // biome-ignore lint/suspicious/noArrayIndexKey: fill lines have no stable identity
-        /* @__PURE__ */ jsx(Text, { children: " " }, `fill-${i}`)
-      ))
-    ] })
-  ] });
-}
-
-// src/views/loading.tsx
-import { Box as Box2, Text as Text2, useStdout as useStdout2 } from "ink";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-function Loading() {
-  const { stdout } = useStdout2();
-  const cols = stdout?.columns ?? 80;
-  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs2(Box2, { children: [
-      /* @__PURE__ */ jsx2(Text2, { color: "gray", children: "\u25CF " }),
-      /* @__PURE__ */ jsx2(Text2, { bold: true, children: "Hlidskjalf" })
-    ] }),
-    /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "\u2500".repeat(cols) }),
-    /* @__PURE__ */ jsx2(Box2, { marginTop: 1, marginLeft: 1, children: /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "Discovering workspaces..." }) })
-  ] });
-}
-
-// src/workspaces.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
-import { join } from "path";
-function readJson(path) {
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"));
-  } catch {
-    return null;
-  }
-}
-function workspaceDeps(pkg) {
-  return Object.entries(pkg.dependencies ?? {}).filter(([, v]) => v.startsWith("workspace:")).map(([name]) => name);
-}
-var kindOrder = { package: 0, app: 1, service: 1 };
-function discover(root) {
-  const results = [];
-  const dirs = [
-    ["packages", "package"],
-    ["apps", "app"],
-    ["services", "service"]
-  ];
-  for (const [dir, kind] of dirs) {
-    const base = join(root, dir);
-    if (!existsSync(base)) continue;
-    for (const entry of readdirSync(base, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      const pkg = readJson(join(base, entry.name, "package.json"));
-      if (!pkg?.name) continue;
-      if (pkg.name === "hlidskjalf") continue;
-      if (!pkg.scripts?.dev) continue;
-      results.push({
-        name: pkg.name,
-        kind,
-        deps: workspaceDeps(pkg)
-      });
-    }
-  }
-  return results;
-}
-function sortByDeps(workspaces) {
-  const names = new Set(workspaces.map((w) => w.name));
-  return [...workspaces].sort((a, b) => {
-    if (a.kind !== b.kind) return kindOrder[a.kind] - kindOrder[b.kind];
-    const aDeps = a.deps.filter((d) => names.has(d)).length;
-    const bDeps = b.deps.filter((d) => names.has(d)).length;
-    return aDeps - bDeps;
-  });
-}
-function sortByName(workspaces) {
-  return [...workspaces].sort((a, b) => {
-    if (a.kind !== b.kind) return kindOrder[a.kind] - kindOrder[b.kind];
-    return a.name.localeCompare(b.name);
-  });
-}
-function filterWorkspaces(workspaces, patterns) {
-  const byName = new Map(workspaces.map((w) => [w.name, w]));
-  const matches = /* @__PURE__ */ new Set();
-  for (const pattern of patterns) {
-    const transitive = pattern.endsWith("...");
-    const name = transitive ? pattern.slice(0, -3) : pattern;
-    if (byName.has(name)) matches.add(name);
-    if (transitive) collectDeps(name, byName, matches);
-  }
-  return workspaces.filter((w) => matches.has(w.name));
-}
-function collectDeps(name, byName, collected) {
-  const workspace = byName.get(name);
-  if (!workspace) return;
-  for (const dep of workspace.deps) {
-    if (byName.has(dep) && !collected.has(dep)) {
-      collected.add(dep);
-      collectDeps(dep, byName, collected);
-    }
-  }
-}
-
-// src/app.tsx
-import { jsx as jsx3 } from "react/jsx-runtime";
-function App({ options }) {
-  const { exit } = useApp();
-  const [loading, setLoading] = useState(true);
-  const [processes, setProcesses] = useState([]);
-  const [cursor, setCursor] = useState(0);
-  const runnerRef = useRef(null);
-  const stoppingRef = useRef(false);
-  const stop = useCallback(() => {
-    if (stoppingRef.current) return;
-    stoppingRef.current = true;
-    const runner = runnerRef.current;
-    if (runner) {
-      void runner.shutdown().finally(() => exit());
-    } else {
-      exit();
-    }
-  }, [exit]);
-  useEffect(() => {
-    const run = async () => {
-      let workspaces = discover(options.root);
-      if (options.filter) {
-        workspaces = filterWorkspaces(workspaces, options.filter);
-      }
-      if (workspaces.length === 0) {
-        console.error("No matching workspaces found.");
-        exit();
-        return;
-      }
-      const startOrder = sortByDeps(workspaces);
-      const sorted = options.order === "run" ? startOrder : sortByName(workspaces);
-      const displayOrder = sorted.map((w) => w.name);
-      const runner = createRunner(options.root);
-      runnerRef.current = runner;
-      setProcesses(sorted.map((w) => ({ workspace: w, status: "pending", logs: [] })));
-      runner.on("change", () => {
-        setProcesses(
-          displayOrder.flatMap((name) => {
-            const p = runner.get(name);
-            return p ? [p] : [];
-          })
-        );
-      });
-      setLoading(false);
-      await runner.start(startOrder);
-    };
-    run().catch((err) => {
-      console.error("Fatal:", err);
-      exit();
-    });
-    process.on("SIGTERM", stop);
-    return () => {
-      process.off("SIGTERM", stop);
-    };
-  }, [exit, options.filter, options.order, options.root, stop]);
-  useInput((input, key) => {
-    if (loading) return;
-    if (input === "q" || key.ctrl && input === "c") {
-      stop();
-      return;
-    }
-    if (key.upArrow || input === "k") {
-      setCursor((i) => Math.max(0, i - 1));
-    } else if (key.downArrow || input === "j") {
-      setCursor((i) => Math.min(processes.length - 1, i + 1));
-    }
-  });
-  if (loading) return /* @__PURE__ */ jsx3(Loading, {});
-  return /* @__PURE__ */ jsx3(Dashboard, { processes, selectedIndex: cursor });
-}
-
-// src/index.tsx
-import { jsx as jsx4 } from "react/jsx-runtime";
-function parseArgs(argv) {
-  const root = process.cwd();
-  const filter = [];
-  let order = "alphabetical";
-  for (const arg of argv) {
-    if (arg.startsWith("--filter=")) {
-      const value = arg.slice("--filter=".length).replace(/^\{(.+)\}$/, "$1");
-      filter.push(value);
-    } else if (arg.startsWith("--order=")) {
-      const value = arg.slice("--order=".length);
-      if (value === "run" || value === "alphabetical") order = value;
-    }
-  }
-  return { root, order, filter: filter.length > 0 ? filter : void 0 };
-}
-var { waitUntilExit } = render(/* @__PURE__ */ jsx4(App, { options: parseArgs(process.argv.slice(2)) }), {
-  exitOnCtrlC: false
-});
-await waitUntilExit();
-process.exit(0);
+import { parseArgs } from 'util';
+import { render, useInput, useApp, useStdout, Box, Text } from 'ink';
+import { useState, useRef, useCallback, useEffect, useMemo } from 'react';
+import { spawn } from 'child_process';
+import { EventEmitter } from 'events';
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+function useCursor(length,enabled){let[cursor,setCursor]=useState(0);return useInput((input,key)=>{key.upArrow||input==="k"?setCursor(i=>Math.max(0,i-1)):(key.downArrow||input==="j")&&setCursor(i=>Math.min(length-1,i+1));},{isActive:enabled}),cursor}var DTS=/\bDTS\b/,matchers=[{pattern:/running on (https?:\/\/\S+)/,status:"ready"},{pattern:/listening on (https?:\/\/\S+)/,status:"ready"},{pattern:/started.*(https?:\/\/localhost:\d+)/,status:"ready"},{pattern:/\bVITE\b.*\bready in\b/i,status:"ready"},{pattern:/\bLocal:\s+(https?:\/\/\S+)/,status:"ready"},{pattern:/⚡\uFE0F?\s*Build success/,status:"watching"},{pattern:/Build start/,status:"building"},{pattern:/Watching for changes/,status:"watching"},{pattern:/[Ee]rror[\s:]/,status:"error"},{pattern:/process exit/,status:"error"}];function parseLine(line){if(DTS.test(line))return {};for(let{pattern,status}of matchers){let match=line.match(pattern);if(match)return {status,url:match[1]}}return {}}function stripAnsi(text){return text.replace(/\x1b(?:\[[0-9;]*[A-Za-z]|\].*?(?:\x07|\x1b\\))/g,"")}var MAX_LOGS=500,ERROR_RECOVERY_MS=5e3,MAX_RESTART_RETRIES=3,RESTART_DELAY_MS=1e3,STARTUP_TIMEOUT_MS=12e4,HEARTBEAT_INTERVAL_MS=1e4,STALE_THRESHOLD_MS=6e4,ProcessRunner=class extends EventEmitter{entries=new Map;pendingRebuilds=new Set;heartbeatInterval=null;root;stopping=false;allWorkspaces=[];constructor(root){super(),this.root=root;}get(name){return this.entries.get(name)?.process}async start(workspaces){this.allWorkspaces=workspaces;let packages=workspaces.filter(w=>w.kind==="package"),apps=workspaces.filter(w=>w.kind!=="package");for(let workspace of workspaces)this.entries.set(workspace.name,{process:{workspace,status:"pending",logs:[]},child:null,errorTimer:null,restartTimer:null,startupTimer:null,lastGoodStatus:null,restartRetries:0,lastOutputAt:0});for(let workspace of packages)this.spawn(workspace);packages.length>0&&await this.waitForPackages(packages.map(p=>p.name));let failedPackages=new Set;for(let pkg of packages){let s=this.entries.get(pkg.name)?.process.status;(s==="error"||s==="stopped"||s==="timeout")&&failedPackages.add(pkg.name);}for(let workspace of apps){let failedDeps=workspace.deps.filter(d=>failedPackages.has(d));if(failedDeps.length>0){let entry=this.entries.get(workspace.name);entry&&(entry.process.logs.push(`[hlidskjalf] warning: dependency ${failedDeps.join(", ")} failed \u2014 starting anyway`),this.emit("change"));}this.spawn(workspace);}this.startHeartbeat();}async shutdown(){this.stopping=true,this.heartbeatInterval&&clearInterval(this.heartbeatInterval);for(let entry of this.entries.values())entry.errorTimer&&clearTimeout(entry.errorTimer),entry.restartTimer&&clearTimeout(entry.restartTimer),entry.startupTimer&&clearTimeout(entry.startupTimer);for(let child of this.pendingRebuilds)child.kill("SIGTERM");let waiting=[];for(let entry of this.entries.values()){let{child}=entry;!child||child.exitCode!==null||child.signalCode!==null||waiting.push(new Promise(resolve=>{let escalate=setTimeout(()=>{child.exitCode===null&&child.kill("SIGKILL");},5e3);child.on("close",()=>{clearTimeout(escalate),resolve();}),child.kill("SIGTERM");}));}await Promise.all(waiting);}entry(name){return this.entries.get(name)}waitForPackages(names){let remaining=new Set(names);return new Promise(resolve=>{let check=()=>{for(let name of [...remaining]){let s=this.entry(name)?.process.status;(s==="watching"||s==="error"||s==="stopped"||s==="timeout")&&remaining.delete(name);}remaining.size===0&&(this.off("change",check),resolve());};this.on("change",check),check();})}spawn(workspace){let child=spawn("pnpm",["--filter",workspace.name,"run","dev"],{cwd:this.root,stdio:"pipe",env:{...process.env,FORCE_COLOR:"1"}}),entry=this.entry(workspace.name);entry&&(entry.child=child),this.setStatus(workspace.name,"building");let startupTimer=setTimeout(()=>{let e=this.entry(workspace.name);e&&(e.startupTimer=null,e.process.status!=="watching"&&e.process.status!=="ready"&&(e.process.logs.push(`[hlidskjalf] startup timeout after ${STARTUP_TIMEOUT_MS/1e3}s`),this.setStatus(workspace.name,"timeout")));},STARTUP_TIMEOUT_MS);startupTimer.unref(),entry&&(entry.startupTimer=startupTimer);let buffer="",onData=data=>{buffer+=data.toString();let lines=buffer.split(`
+`);buffer=lines.pop()??"";for(let raw of lines){let line=raw.trimEnd();line&&this.handleLine(workspace.name,line);}};child.stdout?.on("data",onData),child.stderr?.on("data",onData),child.on("close",(code,signal)=>{buffer.trim()&&this.handleLine(workspace.name,buffer.trimEnd()),buffer="",!this.stopping&&this.handleUnexpectedExit(workspace,code,signal);}),child.on("error",()=>{let e=this.entry(workspace.name);e?.startupTimer&&(clearTimeout(e.startupTimer),e.startupTimer=null),this.setStatus(workspace.name,"error");});}handleLine(name,line){if(this.stopping)return;let entry=this.entry(name);if(!entry)return;let{process:proc}=entry;proc.logs.push(line),proc.logs.length>MAX_LOGS&&proc.logs.splice(0,proc.logs.length-MAX_LOGS),entry.lastOutputAt=Date.now();let{status,url}=parseLine(stripAnsi(line));status&&(status==="error"?this.scheduleErrorRecovery(name):(entry.lastGoodStatus=status,this.clearErrorTimer(name),entry.restartRetries=0,(status==="watching"||status==="ready")&&entry.startupTimer&&(clearTimeout(entry.startupTimer),entry.startupTimer=null)),proc.status=status),url&&(proc.url=url),this.emit("change");}handleUnexpectedExit(workspace,code,signal){if(code===0){this.setStatus(workspace.name,"stopped");return}let entry=this.entry(workspace.name);if(!entry)return;entry.restartRetries+=1;let{restartRetries}=entry;if(restartRetries>MAX_RESTART_RETRIES){entry.process.logs.push(`[hlidskjalf] process exited ${MAX_RESTART_RETRIES} times \u2014 giving up.`),this.setStatus(workspace.name,"error");return}let delay=RESTART_DELAY_MS*2**(restartRetries-1);if(entry.process.logs.push(`[hlidskjalf] process exited unexpectedly (attempt ${restartRetries}/${MAX_RESTART_RETRIES}) \u2014 restarting in ${delay/1e3}s...`),this.setStatus(workspace.name,"error"),signal==="SIGABRT"){this.rebuildFsevents().then(()=>{this.stopping||this.spawn(workspace);}).catch(()=>this.setStatus(workspace.name,"error"));return}let timer=setTimeout(()=>{entry&&(entry.restartTimer=null),this.stopping||this.spawn(workspace);},delay);timer.unref(),entry.restartTimer=timer;}rebuildFsevents(){return new Promise(resolve=>{let child=spawn("pnpm",["rebuild","fsevents"],{cwd:this.root,stdio:"pipe"});this.pendingRebuilds.add(child);let done=()=>{this.pendingRebuilds.delete(child),resolve();};child.on("close",done),child.on("error",done);})}startHeartbeat(){this.heartbeatInterval=setInterval(()=>{let now=Date.now();for(let[name,entry]of this.entries)entry.process.status!=="watching"&&entry.process.status!=="ready"||entry.lastOutputAt&&now-entry.lastOutputAt>STALE_THRESHOLD_MS&&this.setStatus(name,"stale");},HEARTBEAT_INTERVAL_MS),this.heartbeatInterval.unref();}scheduleErrorRecovery(name){this.clearErrorTimer(name);let entry=this.entry(name);if(!entry)return;let timer=setTimeout(()=>{entry.errorTimer=null,entry.process.status==="error"&&this.setStatus(name,entry.lastGoodStatus??"ready");},ERROR_RECOVERY_MS);timer.unref(),entry.errorTimer=timer;}clearErrorTimer(name){let entry=this.entry(name);entry?.errorTimer&&(clearTimeout(entry.errorTimer),entry.errorTimer=null);}setStatus(name,status){let entry=this.entry(name);entry&&(entry.process.status=status,status==="error"&&entry.process.workspace.kind==="package"&&this.notifyDependents(name),this.emit("change"));}notifyDependents(failedName){for(let workspace of this.allWorkspaces){if(!workspace.deps.includes(failedName))continue;let entry=this.entry(workspace.name);entry&&entry.process.logs.push(`[hlidskjalf] warning: dependency ${failedName} entered error state`);}}};function createRunner(root){return new ProcessRunner(root)}function readJson(path){try{return JSON.parse(readFileSync(path,"utf-8"))}catch{return null}}function workspaceDeps(pkg){return Object.entries(pkg.dependencies??{}).filter(([,v])=>v.startsWith("workspace:")).map(([name])=>name)}var kindOrder={package:0,app:1,service:1};function discover(root){let results=[],dirs=[["packages","package"],["apps","app"],["services","service"]];for(let[dir,kind]of dirs){let base=join(root,dir);if(existsSync(base))for(let entry of readdirSync(base,{withFileTypes:true})){if(!entry.isDirectory())continue;let pkg=readJson(join(base,entry.name,"package.json"));pkg?.name&&pkg.name!=="hlidskjalf"&&pkg.scripts?.dev&&results.push({name:pkg.name,kind,deps:workspaceDeps(pkg)});}}return results}function sortByDeps(workspaces){let names=new Set(workspaces.map(w=>w.name));return [...workspaces].sort((a,b)=>{if(a.kind!==b.kind)return kindOrder[a.kind]-kindOrder[b.kind];let aDeps=a.deps.filter(d=>names.has(d)).length,bDeps=b.deps.filter(d=>names.has(d)).length;return aDeps-bDeps})}function sortByName(workspaces){return [...workspaces].sort((a,b)=>a.kind!==b.kind?kindOrder[a.kind]-kindOrder[b.kind]:a.name.localeCompare(b.name))}function filterWorkspaces(workspaces,patterns){let byName=new Map(workspaces.map(w=>[w.name,w])),matches=new Set;for(let pattern of patterns){let transitive=pattern.endsWith("..."),name=transitive?pattern.slice(0,-3):pattern;byName.has(name)&&matches.add(name),transitive&&collectDeps(name,byName,matches);}return workspaces.filter(w=>matches.has(w.name))}function collectDeps(name,byName,collected){let workspace=byName.get(name);if(workspace)for(let dep of workspace.deps)byName.has(dep)&&!collected.has(dep)&&(collected.add(dep),collectDeps(dep,byName,collected));}function useRunner(options2){let{exit}=useApp(),[loading,setLoading]=useState(true),[processes,setProcesses]=useState([]),runnerRef=useRef(null),stoppingRef=useRef(false),stop=useCallback(()=>{if(stoppingRef.current)return;stoppingRef.current=true;let runner=runnerRef.current;runner?runner.shutdown().finally(()=>exit()):exit();},[exit]);return useEffect(()=>((async()=>{let workspaces=discover(options2.root);if(options2.filter&&(workspaces=filterWorkspaces(workspaces,options2.filter)),workspaces.length===0){console.error("No matching workspaces found."),exit();return}let startOrder=sortByDeps(workspaces),sorted=options2.order==="run"?startOrder:sortByName(workspaces),displayOrder=sorted.map(w=>w.name),runner=createRunner(options2.root);runnerRef.current=runner,setProcesses(sorted.map(w=>({workspace:w,status:"pending",logs:[]}))),runner.on("change",()=>{setProcesses(displayOrder.flatMap(name=>{let p=runner.get(name);return p?[p]:[]}));}),setLoading(false),await runner.start(startOrder);})().catch(err=>{console.error("Fatal:",err),exit();}),process.on("SIGTERM",stop),()=>{process.off("SIGTERM",stop);}),[exit,options2.filter,options2.order,options2.root,stop]),{processes,loading,stop}}function Header({ready=false,columns,hints}){let showHints=hints&&columns>=10+hints.length+4;return jsxs(Fragment,{children:[jsxs(Box,{children:[jsxs(Box,{flexGrow:1,children:[jsx(Text,{color:ready?"green":"gray",children:"\u25CF "}),jsx(Text,{bold:true,children:"Hlidskjalf"})]}),showHints&&jsx(Text,{dimColor:true,children:hints})]}),jsx(Text,{dimColor:true,children:"\u2500".repeat(columns)})]})}var kindLabel={package:"pkg",app:"app",service:"svc"},statusDisplay={pending:{color:"gray",label:"pending"},building:{color:"yellow",label:"building"},watching:{color:"green",label:"watching"},ready:{color:"green",label:"watching"},error:{color:"red",label:"error"},stopped:{color:"gray",label:"stopped"},stale:{color:"yellow",label:"stale"},timeout:{color:"red",label:"timeout"}},HINTS="\u2191/\u2193  j/k  select    q  quit";function ProcessRow({process:proc,selected,nameWidth}){let{color,label}=statusDisplay[proc.status];return jsxs(Box,{children:[jsx(Text,{color:selected?"cyan":void 0,children:selected?"\u25B8":" "}),jsx(Box,{width:nameWidth,children:jsx(Text,{color:selected?"cyan":void 0,bold:selected,wrap:"truncate",children:proc.workspace.name})}),jsx(Box,{width:6,children:jsx(Text,{dimColor:true,children:kindLabel[proc.workspace.kind]})}),jsx(Box,{width:14,children:jsxs(Text,{color,children:["\u25CF ",label]})}),jsx(Text,{dimColor:true,children:proc.url??""})]})}function LogPanel({process:proc,height}){let logLines=proc.logs.slice(-height),fillCount=height-logLines.length;return jsxs(Box,{flexDirection:"column",children:[jsx(Box,{marginLeft:1,children:jsxs(Text,{bold:true,children:["Logs: ",proc.workspace.name]})}),logLines.map((line,i)=>jsxs(Text,{wrap:"truncate",children:[" ",line]},i)),Array.from({length:fillCount},(_,i)=>jsx(Text,{children:" "},`fill-${i}`))]})}function Dashboard({processes,selectedIndex}){let{stdout}=useStdout(),cols=stdout?.columns??80,rows=stdout?.rows??24,allReady=useMemo(()=>processes.length>0&&processes.every(p=>p.status==="ready"||p.status==="watching"),[processes]),nameWidth=useMemo(()=>Math.max(14,...processes.map(p=>p.workspace.name.length+2)),[processes]),logHeight=Math.max(3,rows-processes.length-5),safeIndex=Math.min(selectedIndex,Math.max(0,processes.length-1)),selected=processes[safeIndex];return jsxs(Box,{flexDirection:"column",children:[jsx(Header,{ready:allReady,columns:cols,hints:HINTS}),jsxs(Box,{marginLeft:1,children:[jsx(Box,{width:nameWidth,children:jsx(Text,{dimColor:true,bold:true,children:"Name"})}),jsx(Box,{width:6,children:jsx(Text,{dimColor:true,bold:true,children:"Kind"})}),jsx(Box,{width:14,children:jsx(Text,{dimColor:true,bold:true,children:"Status"})}),jsx(Text,{dimColor:true,bold:true,children:"URL"})]}),processes.map((proc,i)=>jsx(ProcessRow,{process:proc,selected:i===safeIndex,nameWidth},proc.workspace.name)),jsx(Text,{dimColor:true,children:"\u2500".repeat(cols)}),selected&&jsx(LogPanel,{process:selected,height:logHeight})]})}function Loading(){let{stdout}=useStdout(),cols=stdout?.columns??80;return jsxs(Box,{flexDirection:"column",children:[jsx(Header,{columns:cols}),jsx(Box,{marginTop:1,marginLeft:1,children:jsx(Text,{dimColor:true,children:"Discovering workspaces..."})})]})}function App({options:options2}){let{processes,loading,stop}=useRunner(options2),cursor=useCursor(processes.length,!loading);return useInput((input,key)=>{(input==="q"||key.ctrl&&input==="c")&&stop();}),loading?jsx(Loading,{}):jsx(Dashboard,{processes,selectedIndex:cursor})}var{values}=parseArgs({args:process.argv.slice(2),options:{filter:{type:"string",multiple:true},order:{type:"string",default:"alphabetical"}}}),filter=values.filter?.map(v=>v.replace(/^\{(.+)\}$/,"$1")),order=values.order==="run"?"run":"alphabetical",options={root:process.cwd(),order,filter:filter?.length?filter:void 0},{waitUntilExit}=render(jsx(App,{options}),{exitOnCtrlC:false});await waitUntilExit();process.exit(0);

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "hlidskjalf",
-	"version": "0.0.4",
-	"description": "Terminal UI for monitoring Turborepo workspaces",
+	"version": "0.0.6",
+	"description": "A Terminal User Interface for monitoring Turborepo tasks, built with Ink.",
 	"type": "module",
 	"license": "MIT",
 	"keywords": [
@@ -24,17 +24,19 @@
 	"scripts": {
 		"build": "tsup",
 		"dev": "tsup --watch",
-		"lint": "biome check --config-path=../.. .",
-		"lint:fix": "biome check --config-path=../.. --write .",
-		"format": "biome format --config-path=../.. --write ."
+		"lint": "biome check .",
+		"lint:fix": "biome check --write .",
+		"format": "biome format --write ."
 	},
 	"dependencies": {
 		"ink": "^5.2.1",
 		"react": "^18.3.1"
 	},
 	"devDependencies": {
+		"@biomejs/biome": "^2.4.7",
 		"@types/node": "^22.15.33",
 		"@types/react": "^18.3.23",
+		"lefthook": "^2.1.4",
 		"tsup": "^8.5.1",
 		"typescript": "^5.9.3"
 	}