numux 2.2.1 → 2.3.0

package/README.md

@@ -174,7 +174,7 @@ Template properties (color, env, dependsOn, etc.) are inherited by all matched p
 | `--max-restarts <n>` | Max auto-restarts for crashed processes |
 | `-s, --sort <mode>` | Tab display order: `config` (default), `alphabetical`, `topological` |
 | `--no-watch` | Disable file watching even if config has `watch` patterns |
-| `-t, --timestamps` | Add `[HH:MM:SS]` timestamps to prefixed output |
+| `-t, --timestamps [format]` | Add timestamps (default `HH:mm:ss`). Works in both prefix and TUI mode. Pass a format string for custom output (e.g. `HH:mm:ss.SSS`). Toggle in TUI with `T` |
 | `--log-dir <path>` | Persist logs to timestamped subdirs (`<path>/<timestamp>/<name>.log`) with a `latest` symlink. Path is printed on exit |
 | `--debug` | Log to `.numux/debug.log` |
 | `-h, --help` | Show help |

package/dist/numux.js

@@ -36,7 +36,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.2.1",
+    version: "2.3.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -224,11 +224,13 @@ var FLAGS = [
     description: "Disable file watching even if config has watch patterns"
   },
   {
-    type: "boolean",
+    type: "optional-value",
     long: "--timestamps",
     short: "-t",
     key: "timestamps",
-    description: "Add timestamps to prefixed output lines"
+    description: "Add timestamps to output (default HH:mm:ss, or pass a format string)",
+    valueName: "<format>",
+    completionHint: "none"
   },
   {
     type: "value",
@@ -330,6 +332,8 @@ function generateHelp() {
     parts.push(f.long);
     if (f.type === "value")
       parts.push(f.valueName);
+    if (f.type === "optional-value")
+      parts.push(`[${f.valueName}]`);
     const left = `  ${parts.join(" ")}`;
     lines.push(`${left.padEnd(29)}${f.description}`);
   }
@@ -375,6 +379,14 @@ function parseArgs(argv) {
     if (flag) {
       if (flag.type === "boolean") {
         result[flag.key] = true;
+      } else if (flag.type === "optional-value") {
+        const next = args[i + 1];
+        if (next !== undefined && !next.startsWith("-")) {
+          result[flag.key] = next;
+          i++;
+        } else {
+          result[flag.key] = true;
+        }
       } else {
         const next = args[++i];
         if (next === undefined) {
@@ -1099,7 +1111,7 @@ function validateConfig(raw, _warnings) {
   }
   const sort = validateSort(config.sort);
   const prefix = config.prefix === true ? true : undefined;
-  const timestamps = config.timestamps === true ? true : undefined;
+  const timestamps = config.timestamps === true ? true : typeof config.timestamps === "string" ? config.timestamps : undefined;
   const killOthers = config.killOthers === true ? true : undefined;
   const killOthersOnFail = config.killOthersOnFail === true ? true : undefined;
   const noWatch = config.noWatch === true ? true : undefined;
@@ -2145,6 +2157,7 @@ var SHORTCUTS = {
   restart: { key: "r", label: "R", description: "restart" },
   stopStart: { key: "s", label: "S", description: "stop/start" },
   clear: { key: "l", label: "L", description: "clear" },
+  timestamps: { key: "t", label: "T", description: "timestamps" },
   scrollToTop: { key: "g", label: "G", description: "top" },
   scrollToBottom: { key: "g", label: "Shift+G", description: "bottom", shift: true }
 };
@@ -2156,15 +2169,32 @@ var STATUS_HINTS = [
   [SHORTCUTS.search.label, SHORTCUTS.search.description],
   [SHORTCUTS.copy.label, SHORTCUTS.copy.description],
   [SHORTCUTS.clear.label, SHORTCUTS.clear.description],
+  [SHORTCUTS.timestamps.label, SHORTCUTS.timestamps.description],
   ["Ctrl+Click", "open link"],
   ["Ctrl+C", "quit"]
 ];
 var STATUS_BAR_TEXT = STATUS_HINTS.map(([l, d]) => `${l}: ${d}`).join("  ");
 
 // src/ui/pane.ts
-import { ScrollBoxRenderable } from "@opentui/core";
+import {
+  LineNumberRenderable,
+  ScrollBoxRenderable
+} from "@opentui/core";
 import { GhosttyTerminalRenderable } from "ghostty-opentui/terminal-buffer";
 
+// src/utils/timestamp.ts
+var DEFAULT_TIMESTAMP_FORMAT = "HH:mm:ss";
+function formatTimestamp(date, format) {
+  const hours24 = date.getHours();
+  const hours12 = hours24 % 12 || 12;
+  return format.replace("YYYY", date.getFullYear().toString()).replace("MM", (date.getMonth() + 1).toString().padStart(2, "0")).replace("DD", date.getDate().toString().padStart(2, "0")).replace("HH", hours24.toString().padStart(2, "0")).replace("hh", hours12.toString().padStart(2, "0")).replace("mm", date.getMinutes().toString().padStart(2, "0")).replace("SSS", date.getMilliseconds().toString().padStart(3, "0")).replace("ss", date.getSeconds().toString().padStart(2, "0")).replace("A", hours24 < 12 ? "AM" : "PM");
+}
+function resolveTimestampFormat(timestamps) {
+  if (!timestamps)
+    return null;
+  return typeof timestamps === "string" ? timestamps : DEFAULT_TIMESTAMP_FORMAT;
+}
+
 // src/ui/url-handler.ts
 var URL_RE = /https?:\/\/[^\s<>"'`)\]},;]+/g;
 var FILE_PATH_RE = /(?:\.\.?\/|\/)[^\s:]+(?::(\d+)(?::(\d+))?)?/g;
@@ -2217,10 +2247,16 @@ class Pane {
   terminal;
   decoder = new TextDecoder;
   bytesFed = 0;
+  renderer;
+  timestampGutter = null;
+  _timestampFormat = null;
+  lineTimestamps = [];
+  lineCounter = 0;
   _onScroll = null;
   _onCopy = null;
   _onLinkClick = null;
   constructor(renderer, name, cols, rows, interactive = false) {
+    this.renderer = renderer;
     this.scrollBox = new ScrollBoxRenderable(renderer, {
       id: `pane-${name}`,
       flexGrow: 1,
@@ -2273,9 +2309,25 @@ class Pane {
     if (this.terminal.lineCount > MAX_SCROLLBACK_LINES || this.bytesFed > MAX_BUFFER_BYTES) {
       this.terminal.reset();
       this.bytesFed = 0;
+      this.lineTimestamps = [];
+      this.lineCounter = 0;
+    }
+    const now = Date.now();
+    if (this.lineCounter === 0) {
+      this.lineTimestamps.push(now);
+      this.lineCounter = 1;
+    }
+    for (let i = 0;i < data.length; i++) {
+      if (data[i] === 10) {
+        this.lineTimestamps.push(now);
+        this.lineCounter++;
+      }
     }
     const text = this.decoder.decode(data, { stream: true });
     this.terminal.feed(text);
+    if (this._timestampFormat) {
+      this.updateTimestampSigns();
+    }
   }
   resize(cols, rows) {
     this.terminal.cols = cols;
@@ -2352,6 +2404,60 @@ class Pane {
   clear() {
     this.terminal.reset();
     this.bytesFed = 0;
+    this.lineTimestamps = [];
+    this.lineCounter = 0;
+    if (this._timestampFormat) {
+      this.timestampGutter?.clearAllLineSigns();
+    }
+  }
+  setTimestamps(value) {
+    const newFormat = !value ? null : typeof value === "string" ? value : DEFAULT_TIMESTAMP_FORMAT;
+    const wasEnabled = this._timestampFormat !== null;
+    const isEnabled = newFormat !== null;
+    if (wasEnabled === isEnabled && this._timestampFormat === newFormat)
+      return;
+    this._timestampFormat = newFormat;
+    if (isEnabled && !wasEnabled) {
+      this.scrollBox.remove(this.terminal.id);
+      const gutterWidth = (newFormat?.length ?? 8) + 1;
+      this.timestampGutter = new LineNumberRenderable(this.renderer, {
+        id: `ts-${this.terminal.id}`,
+        target: this.terminal,
+        showLineNumbers: false,
+        minWidth: gutterWidth,
+        paddingRight: 0,
+        fg: "#666666"
+      });
+      this.scrollBox.add(this.timestampGutter);
+      this.updateTimestampSigns();
+    } else if (!isEnabled && wasEnabled) {
+      if (this.timestampGutter) {
+        this.timestampGutter.clearTarget();
+        this.scrollBox.remove(this.timestampGutter.id);
+        this.timestampGutter = null;
+      }
+      this.scrollBox.add(this.terminal);
+    } else if (isEnabled) {
+      this.updateTimestampSigns();
+    }
+  }
+  get timestampsEnabled() {
+    return this._timestampFormat !== null;
+  }
+  updateTimestampSigns() {
+    if (!(this.timestampGutter && this._timestampFormat))
+      return;
+    const fmt = this._timestampFormat;
+    const signs = new Map;
+    let prevFormatted = "";
+    for (let i = 0;i < this.lineTimestamps.length; i++) {
+      const formatted = formatTimestamp(new Date(this.lineTimestamps[i]), fmt);
+      if (formatted !== prevFormatted) {
+        signs.set(i, { before: formatted });
+        prevFormatted = formatted;
+      }
+    }
+    this.timestampGutter.setLineSigns(signs);
   }
   destroy() {
     this.terminal.destroy();
@@ -2959,6 +3065,9 @@ class App {
     for (const name of this.names) {
       const interactive = this.config.processes[name].interactive === true;
       const pane = new Pane(this.renderer, name, termCols, termRows, interactive);
+      if (this.config.timestamps) {
+        pane.setTimestamps(this.config.timestamps);
+      }
       pane.onCopy((text) => {
         this.copyToClipboard(text);
         this.statusBar.showTemporaryMessage("Copied!");
@@ -3072,6 +3181,18 @@ class App {
           this.logWriter.truncate(this.activePane);
           return;
         }
+        if (name === SHORTCUTS.timestamps.key) {
+          const firstPane = this.panes.values().next().value;
+          if (firstPane?.timestampsEnabled) {
+            for (const pane of this.panes.values())
+              pane.setTimestamps(false);
+          } else {
+            const fmt = this.config.timestamps ?? true;
+            for (const pane of this.panes.values())
+              pane.setTimestamps(fmt);
+          }
+          return;
+        }
         const num = Number.parseInt(name, 10);
         if (num >= 1 && num <= 9 && num <= this.tabBar.count) {
           this.tabBar.setSelectedIndex(num - 1);
@@ -3229,7 +3350,7 @@ class PrefixDisplay {
   logWriter;
   killOthers;
   killOthersOnFail;
-  timestamps;
+  timestampFormat;
   stopping = false;
   startTime = 0;
   constructor(manager, config, options = {}) {
@@ -3237,7 +3358,7 @@ class PrefixDisplay {
     this.logWriter = options.logWriter;
     this.killOthers = options.killOthers ?? false;
     this.killOthersOnFail = options.killOthersOnFail ?? false;
-    this.timestamps = options.timestamps ?? false;
+    this.timestampFormat = resolveTimestampFormat(options.timestamps);
     this.noColor = "NO_COLOR" in process.env;
     const names = manager.getProcessNames();
     this.colors = buildProcessColorMap(names, config);
@@ -3306,16 +3427,10 @@ class PrefixDisplay {
     }
   }
   handleStatus(_name, _status) {}
-  formatTimestamp() {
-    const now = new Date;
-    const h = String(now.getHours()).padStart(2, "0");
-    const m = String(now.getMinutes()).padStart(2, "0");
-    const s = String(now.getSeconds()).padStart(2, "0");
-    return `${h}:${m}:${s}`;
-  }
   printLine(name, line) {
-    const ts = this.timestamps ? `${DIM}[${this.formatTimestamp()}]${RESET} ` : "";
-    const tsPlain = this.timestamps ? `[${this.formatTimestamp()}] ` : "";
+    const fmt = this.timestampFormat;
+    const ts = fmt ? `${DIM}[${formatTimestamp(new Date, fmt)}]${RESET} ` : "";
+    const tsPlain = fmt ? `[${formatTimestamp(new Date, fmt)}] ` : "";
     if (this.noColor) {
       process.stdout.write(`${tsPlain}[${name}] ${stripAnsi(line)}
 `);
@@ -3852,16 +3967,19 @@ async function main() {
   const logDir = parsed.logDir ?? config.logDir;
   const logWriter = logDir ? LogWriter.createPersistent(logDir) : LogWriter.createTemp();
   printWarnings(warnings);
+  const timestamps = parsed.timestamps || config.timestamps;
   const usePrefix = parsed.prefix || config.prefix;
   if (usePrefix) {
     const display = new PrefixDisplay(manager, config, {
       logWriter,
       killOthers: parsed.killOthers || config.killOthers,
       killOthersOnFail: parsed.killOthersOnFail || config.killOthersOnFail,
-      timestamps: parsed.timestamps || config.timestamps
+      timestamps
     });
     await display.start();
   } else {
+    if (timestamps)
+      config.timestamps = timestamps;
     manager.on(logWriter.handleEvent);
     const app = new App(manager, config, logWriter);
     setupShutdownHandlers(app, logWriter);

package/dist/types.d.ts

@@ -95,8 +95,8 @@ export interface NumuxConfig<K extends string = string> {
      * @default false
      */
     prefix?: boolean;
-    /** Add timestamps to prefixed output lines (only applies when `prefix` is true) */
-    timestamps?: boolean;
+    /** Add timestamps to output lines. `true` uses default `HH:mm:ss` format, or pass a format string (e.g. `"HH:mm:ss.SSS"`) */
+    timestamps?: boolean | string;
     /**
      * Kill all processes when any one exits (regardless of exit code)
      * @default false
@@ -125,7 +125,7 @@ export interface ResolvedProcessConfig extends Omit<NumuxProcessConfig, 'depends
 export interface ResolvedNumuxConfig {
     sort?: SortOrder;
     prefix?: boolean;
-    timestamps?: boolean;
+    timestamps?: boolean | string;
     killOthers?: boolean;
     killOthersOnFail?: boolean;
     noWatch?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",