numux 2.7.2 → 2.9.0

package/README.md

@@ -73,6 +73,7 @@ numux
 numux init                         # Create a starter numux.config.ts
 numux validate                     # Validate config and show process dependency graph
 numux exec <name> [--] <command>   # Run a command in a process's environment
+numux logs [name]                  # Open log directory or view a process log
 numux completions <shell>          # Generate shell completions (bash, zsh, fish)
 ```
 
@@ -85,6 +86,13 @@ numux exec api -- npx prisma migrate
 numux exec web npm run build
 ```
 
+`logs` prints the log directory path, or a specific process's log contents:
+
+```sh
+numux logs           # Print log directory path
+numux logs api       # Print the api process log
+```
+
 Set up completions for your shell:
 
 ```sh

package/dist/numux.js

@@ -31,12 +31,13 @@ var __toESM = (mod, isNodeMode, target) => {
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = import.meta.require;
 
 // package.json
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "numux",
-    version: "2.7.2",
+    version: "2.9.0",
     description: "Terminal multiplexer with dependency orchestration",
     type: "module",
     license: "MIT",
@@ -95,7 +96,7 @@ var require_package = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-import { existsSync as existsSync5, writeFileSync } from "fs";
+import { existsSync as existsSync6, writeFileSync } from "fs";
 import { resolve as resolve8 } from "path";
 
 // src/cli-flags.ts
@@ -300,6 +301,20 @@ var SUBCOMMANDS = [
       return "break";
     }
   },
+  {
+    name: "logs",
+    description: "Open the log directory or a specific process log",
+    usage: "logs [name]",
+    parse: (args, i, result) => {
+      result.logs = true;
+      const next = args[i + 1];
+      if (next !== undefined && !next.startsWith("-")) {
+        result.logsProcess = next;
+        i++;
+      }
+      return i;
+    }
+  },
   {
     name: "completions",
     description: "Generate shell completions (bash, zsh, fish)",
@@ -364,6 +379,7 @@ function parseArgs(argv) {
     init: false,
     validate: false,
     exec: false,
+    logs: false,
     prefix: false,
     killOthers: false,
     killOthersOnFail: false,
@@ -3876,6 +3892,26 @@ class LogWriter {
   }
 }
 
+// src/utils/project-name.ts
+import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { basename as basename3, join as join2 } from "path";
+function resolveProjectName(cwd) {
+  try {
+    const pkgPath = join2(cwd, "package.json");
+    if (existsSync5(pkgPath)) {
+      const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+      if (typeof pkg.name === "string" && pkg.name.trim()) {
+        return pkg.name.replace(/^@[^/]+\//, "").trim();
+      }
+    }
+  } catch {}
+  return basename3(cwd);
+}
+function defaultLogDir(cwd) {
+  return join2(tmpdir2(), "numux", resolveProjectName(cwd));
+}
+
 // src/utils/shutdown.ts
 function setupShutdownHandlers(app, logWriter) {
   let shuttingDown = false;
@@ -3953,7 +3989,7 @@ async function main() {
   }
   if (parsed.init) {
     const target = resolve8("numux.config.ts");
-    if (existsSync5(target)) {
+    if (existsSync6(target)) {
       console.error(`Already exists: ${target}`);
       process.exit(1);
     }
@@ -3965,6 +4001,28 @@ async function main() {
     console.info(generateCompletions(parsed.completions));
     process.exit(0);
   }
+  if (parsed.logs) {
+    const logDir2 = parsed.logDir ?? await resolveLogDir(parsed.configPath);
+    const latestDir = resolve8(logDir2, "latest");
+    const target = existsSync6(latestDir) ? latestDir : logDir2;
+    if (parsed.logsProcess) {
+      const logFile2 = resolve8(target, `${parsed.logsProcess}.log`);
+      if (!existsSync6(logFile2)) {
+        const { readdirSync } = await import("fs");
+        const files = readdirSync(target).filter((f) => f.endsWith(".log")).map((f) => f.replace(/\.log$/, ""));
+        const available = files.length > 0 ? `Available: ${files.join(", ")}` : "No log files found";
+        console.error(`No log file for "${parsed.logsProcess}". ${available}`);
+        process.exit(1);
+      }
+      const child = Bun.spawn(["cat", logFile2], {
+        stdout: "inherit",
+        stderr: "inherit"
+      });
+      process.exit(await child.exited);
+    }
+    console.info(target);
+    process.exit(0);
+  }
   if (parsed.validate) {
     const raw = expandWorkspaces(expandScriptPatterns(await loadConfig(parsed.configPath)));
     const warnings2 = [];
@@ -4114,8 +4172,8 @@ async function main() {
     }
   }
   const manager = new ProcessManager(config);
-  const logDir = parsed.logDir ?? config.logDir;
-  const logWriter = logDir ? LogWriter.createPersistent(logDir) : LogWriter.createTemp();
+  const logDir = parsed.logDir ?? config.logDir ?? defaultLogDir(process.cwd());
+  const logWriter = LogWriter.createPersistent(logDir);
   printWarnings(warnings);
   const timestamps = parsed.timestamps || config.timestamps;
   const usePrefix = parsed.prefix || config.prefix;
@@ -4141,6 +4199,15 @@ function printWarnings(warnings) {
     console.warn(`Warning: process "${w.process}": ${w.message}`);
   }
 }
+async function resolveLogDir(configPath) {
+  try {
+    const raw = await loadConfig(configPath);
+    if (typeof raw.logDir === "string" && raw.logDir.trim()) {
+      return resolve8(raw.logDir.trim());
+    }
+  } catch {}
+  return defaultLogDir(process.cwd());
+}
 main().catch((err) => {
   console.error(err instanceof Error ? err.message : err);
   process.exit(1);

package/package.json

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