hlidskjalf 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -5,6 +5,52 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.3]
+
+### Added
+
+- **Pause / resume and force-kill controls** — press `p` to suspend the selected
+  workspace with `SIGSTOP` (it stays alive and holds its port but consumes no CPU)
+  and again to resume it with `SIGCONT`, restoring the status it held before
+  pausing; a new `paused` status shows in amber. Press `x` to force-kill a
+  wedged workspace with `SIGKILL` immediately — no graceful `SIGTERM` grace period
+  and no restart. A paused process is woken before any stop/restart/kill so the
+  signal lands promptly.
+
+### Changed
+
+- **Lighter redraws under heavy output** — the dashboard now skips re-rendering
+  rows and the log panel whose content hasn't changed, so a flood of output from
+  one workspace no longer repaints every other row.
+- **Header status dot reads three states at a glance** — green when every
+  workspace is up, green and hollow when some are up and some stopped, and amber
+  when any is paused; hollow grey when nothing is running.
+- **Consistent process-control log notes** — the stop, restart, kill, and pause
+  messages now share one wording and each shows its signal, and a stop or kill
+  appends a line when the child has actually exited, not just when requested.
+
+### Fixed
+
+- **Quitting with a paused workspace no longer hangs** — a suspended process is
+  woken so it acts on the shutdown signal at once, instead of waiting out the
+  five-second kill grace period.
+- **Stopping a workspace no longer logs a phantom failure** — the dev runner's
+  `ERR_PNPM_RECURSIVE_RUN_FIRST_FAIL` / "command failed with signal SIGTERM"
+  complaint, emitted as it forwards the stop we sent, is dropped rather than
+  shown as an error the user didn't cause.
+- **Status glyphs sit on the baseline** — the half-circle and pause glyphs were
+  pulled from an oversized fallback font that floated them above the text;
+  indicators now stay within glyphs the primary font renders in line.
+
+## [0.4.2]
+
+### Changed
+
+- **Boolean flags take a value** — disable file watching with `--watch=false` and
+  metrics with `--metrics=false` (both also accept `=true`, and a bare `--watch` /
+  `--metrics` still reads as `true`). Replaces the `--no-watch` / `--no-metrics`
+  forms. The config forms (`watch: false`, `metrics: true`) are unchanged.
+
 ## [0.4.1]
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 ![NPM Version](https://img.shields.io/npm/v/hlidskjalf)
 ![NPM Last Update](https://img.shields.io/npm/last-update/hlidskjalf)
-![GitHub License](https://img.shields.io/github/license/charliebeckstrand/hlidskjalf)
+![GitHub License](https://img.shields.io/github/license/charliebeckstrand/hlidskjalf?v=2)
 
 A Terminal User Interface for visualizing Turborepo tasks, built with [Ink](https://npm.im/ink).
 
@@ -30,12 +30,12 @@ pnpm dev
 
 | Option | Description |
 | --- | --- |
-| `filter` | Include specific workspaces (`--filter=web`). Append `...` for transitive deps (`--filter=web...`). |
-| `order` | Sort by `alphabetical` (default) or `run` (`--order=run`) dependency order. |
-| `title` | Custom title for the header (`--title="My App"`). Defaults to `Hlidskjalf`. |
+| `filter` | Include specific workspaces (`--filter=web`). Append `...` for transitive dependencies (`--filter=web...`). |
+| `order` | Sort by `alphabetical` or `run` order (`--order=run`). Defaults to `alphabetical`. |
+| `title` | Custom title (`--title="My App"`). Defaults to `Hlidskjalf`. |
+| `theme` | Colour theme (`--theme=niflheim` or `--theme=ice`). Defaults to `bifrost`. |
 | `metrics` | Show CPU and memory usage per workspace. Defaults to `false`. |
-| `watch` | Re-discover workspaces when `package.json` files change. Defaults to `true`; disable with `--no-watch`. |
-| `theme` | Colour theme (`--theme=niflheim` or `--theme=ice`). One of `bifrost` (default), `niflheim`, `muspelheim`, and `yggdrasil`. |
+| `watch` | Re-discover workspaces when `package.json` files change. Defaults to `true`; disable with `--watch=false`. |
 
 ## Themes
 
@@ -43,7 +43,7 @@ Named for the realms of Norse cosmology, to match the all-seeing high seat the t
 
 | Theme | Alias | Mood |
 | --- | --- | --- |
-| `bifrost` | — | Default - Rainbow bridge — indigo + teal |
+| `bifrost` | — | Default - electric purples, sky blues, and starlight whites. |
 | `niflheim` | `ice` | Ice — glacial blues, frost-white highlights. |
 | `muspelheim` | `fire` | Fire — molten oranges, ember golds. |
 | `yggdrasil` | `earth` | Earth — mosses, leaf-greens, bark greys. |
@@ -51,11 +51,9 @@ Named for the realms of Norse cosmology, to match the all-seeing high seat the t
 Each realm also answers to its elemental alias, so `--theme=ice` is the same as
 `--theme=niflheim`.
 
-Status colours (running / warning / error) stay legible in every theme, so a glyph never misreads.
-
 ## Configuration
 
-Persist any of the options above so they don't have to be retyped on every run.
+Persist any of the options above.
 Create a `hlidskjalf.config.ts` at the repo root:
 
 ```ts
@@ -69,8 +67,7 @@ export default defineConfig({
 })
 ```
 
-`defineConfig` is optional — a plain `export default { ... }` works too, and
-`hlidskjalf.config.js` / `hlidskjalf.config.mjs` are also recognized. The `.ts`
+`defineConfig` is optional — a plain `export default { ... }` works too. `hlidskjalf.config.js` / `hlidskjalf.config.mjs` are also recognized. The `.ts`
 form needs no build step: it's loaded directly via Node's type stripping
 (Node ≥ 22.18).
 
@@ -93,18 +90,22 @@ defaults**, so a flag always wins over a stored value.
 While running, hlidskjalf watches your `packages`, `apps`, and `services`
 directories. When a workspace's `package.json` is added, removed, or changed it
 re-runs discovery: new workspaces start automatically and removed ones are
-stopped and dropped from the dashboard. Pass `--no-watch` (or set
+stopped and dropped from the dashboard. Pass `--watch=false` (or set
 `watch: false`) to turn this off.
 
 ## Controls
 
 | Key | Action |
 | --- | --- |
-| `↑` / `↓` | Move the selection between workspaces |
+| `↑` / `↓` (or `k` / `j`) | Move the selection between workspaces |
 | `s` | Stop the selected workspace (or start it again if stopped) |
+| `p` | Pause the selected workspace with `SIGSTOP` (or resume it with `SIGCONT` if paused) |
+| `x` | Force-kill the selected workspace with `SIGKILL`, without restarting it |
 | `r` | Restart the selected workspace |
 | `c` | Clear the logs for the selected workspace |
 | `PgUp` / `PgDn` | Scroll the log panel up / down a page |
+| `Home` / `End` | Jump to the oldest / newest log line |
+| `?` | Toggle help |
 | `q` | Quit |
 
 ## License

package/dist/chunk-P7MGC72I.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { existsSync, readdirSync, realpathSync, readFileSync } from 'fs';
+import { resolve, join, sep } from 'path';
+import { pathToFileURL } from 'url';
+import { stripVTControlCharacters } from 'util';
+
+createRequire(import.meta.url);
+var MAX_PARSE_LENGTH=4096,LOCAL_HOSTS=new Set(["localhost","127.0.0.1","[::1]","0.0.0.0"]);function localOrigin(raw){let cleaned=raw.replace(/[.,;:!?)}\]]+$/,""),parsed;try{parsed=new URL(cleaned);}catch{return}if(!(parsed.protocol!=="http:"&&parsed.protocol!=="https:")&&parsed.port&&LOCAL_HOSTS.has(parsed.hostname))return parsed.origin}var DTS=/\bDTS\b/,baseMatchers=[{pattern:/running on (https?:\/\/\S+)/,status:"ready"},{pattern:/listening on (https?:\/\/\S+)/,status:"ready"},{pattern:/listening at (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:/⚡️?\s*Build success/,status:"watching"},{pattern:/Build start/,status:"building"},{pattern:/Watching for changes/,status:"watching"},{pattern:/\[ERROR\]/,status:"error"},{pattern:/(?<!\/)error[\s:]/i,status:"error"},{pattern:/process exit/,status:"error"},{pattern:/\blistening\b/i,status:"ready"}],matchers=baseMatchers.map(m=>({...m,needsHttp:m.pattern.source.includes("http")})),ANY_NON_HTTP_MATCHER=new RegExp(matchers.filter(m=>!m.needsHttp).map(m=>`(?:${m.pattern.source})`).join("|"),"i");function parseLine(line){let truncated=line.length>MAX_PARSE_LENGTH?line.slice(0,MAX_PARSE_LENGTH):line;if(DTS.test(truncated))return {};let hasHttp=truncated.includes("http");if(!hasHttp&&!ANY_NON_HTTP_MATCHER.test(truncated))return {};for(let{pattern,status,needsHttp}of matchers){if(needsHttp&&!hasHttp)continue;let match=truncated.match(pattern);if(match){let url=match[1]?localOrigin(match[1]):void 0;return {status,url}}}return {}}function stripAnsi(text){return text.includes("\x1B")?stripVTControlCharacters(text):text}var NON_SGR_ESCAPES=/\x1b(?:\][^\x07\x1b]*(?:\x07|\x1b\\)|\[[?>=]*[\d;]*[A-Za-ln-z@~`]|\([A-Za-z]|[^[(\]\x1b])/g,BARE_CONTROLS=/[\x00-\x08\x0b-\x1a\x1c-\x1f\x7f]/g;function sanitizeForDisplay(text){let hasEscape=text.includes("\x1B"),hasControl=text.search(BARE_CONTROLS)!==-1;if(!hasEscape&&!hasControl)return text;let out=text;return hasEscape&&(out=out.replace(NON_SGR_ESCAPES,"")),hasControl&&(out=out.replace(BARE_CONTROLS,"")),out}var SHARED={success:"#15FA5A",warning:"#FACC15",error:"#F87171",pending:"#8D93A0",highlight:"#faf9f6",muted:"#8D93A0",dim:"#6B7280",separator:"#353940"},themes={bifrost:{accent:"#7C8EF2",accentBright:"#BEC7F9",url:"#E8EBFD",...SHARED},niflheim:{accent:"#22D3EE",accentBright:"#92E9F7",url:"#E7FAFD",...SHARED},muspelheim:{accent:"#F97316",accentBright:"#FCBB8D",url:"#FEF0E6",...SHARED},yggdrasil:{accent:"#22C55E",accentBright:"#73E79E",url:"#E9FBF0",...SHARED}},THEME_ALIASES={ice:"niflheim",fire:"muspelheim",earth:"yggdrasil"},DEFAULT_THEME="bifrost";function parseTheme(value){if(typeof value=="string")return value in themes?value:value in THEME_ALIASES?THEME_ALIASES[value]:void 0}var colors=themes[DEFAULT_THEME];function buildStatusDisplay(c){return {pending:{color:c.pending,label:"pending",icon:"\u25CB"},building:{color:c.warning,label:"building",icon:"\u25CB"},watching:{color:c.success,label:"watching",icon:"\u25CF"},ready:{color:c.success,label:"watching",icon:"\u25CF"},error:{color:c.error,label:"error",icon:"\u2716"},stopped:{color:c.pending,label:"stopped",icon:"\u25CB"},idle:{color:c.warning,label:"idle",icon:"\u25CB"},paused:{color:c.warning,label:"paused",icon:"\u25CB"},timeout:{color:c.error,label:"timeout",icon:"\u2716"}}}var statusDisplay=buildStatusDisplay(colors);function setTheme(name){colors=themes[name],statusDisplay=buildStatusDisplay(colors);}function formatCpu(cpu){return `${cpu.toFixed(1)}%`.padStart(6)}function formatMem(bytes){let formatted;return bytes<1024*1024?formatted=`${(bytes/1024).toFixed(0)} K`:bytes<1024*1024*1024?formatted=`${(bytes/(1024*1024)).toFixed(1)} M`:formatted=`${(bytes/(1024*1024*1024)).toFixed(1)} G`,formatted.padStart(7)}function memColor(bytes){return bytes>512*1024*1024?colors.error:bytes>256*1024*1024?colors.warning:colors.muted}function cpuColor(cpu){return cpu>80?colors.error:colors.muted}var HINTS="\u2191/\u2193 navigate | ? help | q quit";var OSC8="\x1B]8;;";function hyperlink(url,label=url){return `${OSC8}${url}\x07${label}${OSC8}\x07`}function truncateEnd(text,width){return width<=0?"":text.length<=width?text:width===1?"\u2026":`${text.slice(0,width-1)}\u2026`}var ENTER_ALT_SCREEN="\x1B[?1049h",EXIT_ALT_SCREEN="\x1B[?1049l";function enterAltScreen(stream=process.stdout){if(!stream.isTTY)return ()=>{};stream.write(ENTER_ALT_SCREEN);let restored=false,restore=()=>{restored||(restored=true,stream.write(EXIT_ALT_SCREEN));};return process.once("exit",restore),restore}function every(ms,fn){let timer=setInterval(fn,ms);return timer.unref(),()=>clearInterval(timer)}function isPlainObject(value){return typeof value=="object"&&value!==null&&!Array.isArray(value)}var VALID_PKG_NAME=/^(@[a-z0-9\-~][a-z0-9\-._~]*\/)?[a-z0-9\-~][a-z0-9\-._~]*$/;function isValidPackageName(name){return VALID_PKG_NAME.test(name)&&name.length<=214}function normalizeFilters(raw){return raw.map(v=>v.replace(/^\{(.+)\}$/,"$1")).filter(v=>{let name=v.endsWith("...")?v.slice(0,-3):v;return isValidPackageName(name)?true:(console.error(`Ignoring invalid filter: ${sanitizeForDisplay(name)}`),false)})}function stringRecord(value){if(!isPlainObject(value))return;let result={};for(let[key,v]of Object.entries(value))typeof v=="string"&&(result[key]=v);return result}function readJson(path){try{let raw=JSON.parse(readFileSync(path,"utf-8"));return isPlainObject(raw)?{name:typeof raw.name=="string"?raw.name:void 0,scripts:stringRecord(raw.scripts),dependencies:stringRecord(raw.dependencies)}:null}catch{return null}}function workspaceDeps(pkg){return Object.entries(pkg.dependencies??{}).filter(([name,v])=>v.startsWith("workspace:")&&isValidPackageName(name)).map(([name])=>name)}var kindOrder={package:0,app:1,service:1};function discover(root){let results=[],dirs=[["packages","package"],["apps","app"],["services","service"]],resolvedRoot=resolve(root);for(let[dir,kind]of dirs){let base=join(resolvedRoot,dir);if(existsSync(base))for(let entry of readdirSync(base,{withFileTypes:true})){if(!entry.isDirectory())continue;let entryPath=join(base,entry.name);try{if(!realpathSync(entryPath).startsWith(resolvedRoot+sep))continue}catch{continue}let pkg=readJson(join(entryPath,"package.json"));pkg?.name&&isValidPackageName(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)),depCount=new Map;for(let workspace of workspaces){let count=0;for(let dep of workspace.deps)names.has(dep)&&count++;depCount.set(workspace,count);}return [...workspaces].sort((a,b)=>a.kind!==b.kind?kindOrder[a.kind]-kindOrder[b.kind]:(depCount.get(a)??0)-(depCount.get(b)??0))}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 defineConfig(config){return config}var CONFIG_FILES=["hlidskjalf.config.ts","hlidskjalf.config.mjs","hlidskjalf.config.js"],PACKAGE_JSON_KEY="hlidskjalf";function validate(raw,source){if(!isPlainObject(raw))return console.error(`Ignoring ${source}: expected a config object.`),{};let config={};if(Array.isArray(raw.filter)){let strings=raw.filter.filter(v=>typeof v=="string"),filter=normalizeFilters(strings);filter.length&&(config.filter=filter);}(raw.order==="run"||raw.order==="alphabetical")&&(config.order=raw.order),typeof raw.title=="string"&&(config.title=sanitizeForDisplay(raw.title)),typeof raw.metrics=="boolean"&&(config.metrics=raw.metrics),typeof raw.watch=="boolean"&&(config.watch=raw.watch);let theme=parseTheme(raw.theme);return theme&&(config.theme=theme),config}function fromPackageJson(root){let path=join(root,"package.json");if(!existsSync(path))return {};let parsed;try{parsed=JSON.parse(readFileSync(path,"utf-8"));}catch{return {}}if(!isPlainObject(parsed))return {};let key=parsed[PACKAGE_JSON_KEY];return key===void 0?{}:validate(key,`package.json "${PACKAGE_JSON_KEY}" key`)}async function fromConfigFile(root){for(let name of CONFIG_FILES){let path=join(root,name);if(existsSync(path))try{let mod=await import(pathToFileURL(path).href);return validate(mod.default??mod,name)}catch(err){return console.error(`Ignoring ${name}: ${err instanceof Error?err.message:"failed to load"}`),{}}}return {}}async function loadConfig(root){let fromPkg=fromPackageJson(root),fromFile=await fromConfigFile(root);return {...fromPkg,...fromFile}}
+
+export { DEFAULT_THEME, HINTS, THEME_ALIASES, colors, cpuColor, defineConfig, discover, enterAltScreen, every, filterWorkspaces, formatCpu, formatMem, hyperlink, loadConfig, memColor, normalizeFilters, parseLine, parseTheme, sanitizeForDisplay, setTheme, sortByDeps, sortByName, statusDisplay, stripAnsi, themes, truncateEnd };

package/dist/config.d.ts

@@ -1,16 +1,12 @@
 /**
- * Shared presentation layer: the colour palette and status glyphs, the terminal
- * primitives the dashboard leans on (OSC 8 hyperlinks, alternate screen), value
- * formatters, and the timer helpers used across the polling code. Kept free of
- * Ink/React imports so every helper here can be unit tested directly.
+ * Colour palette and status glyphs. No Ink/React imports, so every helper is unit-testable.
  */
 
 /**
  * Built-in palettes, named for the realms of Norse cosmology (fitting for a tool named
- * after Odin's all-seeing high seat). `success`/`warning`/`error` stay semantically
- * legible — green-ish / amber-ish / red-ish — in every theme so a status glyph never
- * misreads; the personality lives in the accent and status colours, with the neutral
- * slots pulled from {@link SHARED}.
+ * after Odin's all-seeing high seat). `success`/`warning`/`error` stay green/amber/red
+ * across every theme so a status glyph never misreads; personality lives in the accent
+ * colours, with neutral slots pulled from {@link SHARED}.
  */
 declare const themes: {
     readonly bifrost: {
@@ -93,9 +89,9 @@ interface Config {
     /** Re-discover workspaces when `package.json` files change. Defaults to `true`. */
     watch?: boolean;
     /**
-     * Colour theme. Defaults to `bifrost` (icy blues and purples). Accepts a realm name
-     * (`niflheim`, `muspelheim`, `yggdrasil`) or an elemental alias (`ice`, `fire`, `earth`).
-     * See {@link themes} for the palettes or define your own with {@link parseTheme}.
+     * Colour theme. Defaults to `bifrost` (electric purples and sky blues). Accepts a realm
+     * name (`niflheim`, `muspelheim`, `yggdrasil`) or an elemental alias (`ice`, `fire`,
+     * `earth`). See {@link themes} for the available palettes.
      */
     theme?: ThemeName;
 }

package/dist/config.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-export { defineConfig, loadConfig } from './chunk-WSO44QZR.js';
+export { defineConfig, loadConfig } from './chunk-P7MGC72I.js';
 import './chunk-4PLEQYIC.js';
 
 createRequire(import.meta.url);