@meyverick/omnicode 0.0.4 → 0.0.5

package/README.md

@@ -1,10 +1,10 @@
 # omnicode
 
-The Ubuntu command-line entrypoint for running OpenCode through OmniRoute.
+The cross-platform command-line entrypoint for running OpenCode through OmniRoute.
 
 ## What is omnicode?
 
-`omnicode` is a thin wrapper that launches OpenCode through OmniRoute on Ubuntu. It expects you to install the underlying tools yourself, then handles optional GrayMatter and OpenSpec initialization, background OmniRoute lifecycle, and project-local OpenCode sessions.
+`omnicode` is a thin wrapper that launches OpenCode through OmniRoute. It expects you to install the underlying tools yourself, then handles optional GrayMatter and OpenSpec initialization, background OmniRoute lifecycle, and project-local OpenCode sessions. Developed and tested on Ubuntu Linux — cross-platform by design but untested on Windows, macOS, and other Linux distributions.
 
 ## Why
 
@@ -16,7 +16,8 @@ So I wrote this wrapper. It starts OmniRoute, inits GrayMatter and OpenSpec quie
 
 ## Features
 
-- Thin npm global command for Ubuntu.
+- Thin npm global command written in Node.js (no bash needed).
+- Cross-platform by design — developed and tested on Ubuntu Linux; untested on Windows, macOS, and other Linux distributions.
 - Automatic session resume per project using the OpenCode database.
 - Background OmniRoute lifecycle with cleanup when OpenCode exits.
 - Quiet GrayMatter and OpenSpec initialization with captured logs.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meyverick/omnicode",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Ubuntu command-line entrypoint for OpenCode through OmniRoute",
   "type": "module",
   "bin": {

package/src/bin/omnicode-runtime.js

@@ -0,0 +1,192 @@
+import { spawn, execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, openSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import os from "node:os";
+
+import { commandExists, getDataDir } from "../installer/lib.js";
+
+const isWindows = process.platform === "win32";
+const MAX_OMNI_WAIT = 30;
+const OMNI_CHECK_DELAY = 1000;
+
+function isProcessRunning(name) {
+  try {
+    if (isWindows) {
+      const out = execFileSync("tasklist", ["/FI", `IMAGENAME eq ${name}.exe`, "/NH"], {
+        stdio: ["ignore", "pipe", "ignore"],
+        encoding: "utf8",
+      });
+      return out.includes(`${name}.exe`);
+    }
+    execFileSync("pgrep", ["-x", name], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function initTool(name, args, logPath) {
+  return new Promise((resolve) => {
+    if (!commandExists(name)) {
+      console.log(`[omnicode] ${name}: not installed, skipping`);
+      resolve();
+      return;
+    }
+    console.log(`[omnicode] ${name}: initializing`);
+    const log = openSync(logPath, "w");
+    const child = spawn(name, args, { stdio: ["ignore", log, log] });
+    child.on("close", (code) => {
+      if (code === 0) {
+        console.log(`[omnicode] ${name}: ready`);
+      } else {
+        console.log(`[omnicode] WARNING: ${name} init failed; continuing. Log: ${logPath}`);
+      }
+      resolve();
+    });
+    child.on("error", () => {
+      console.log(`[omnicode] WARNING: ${name} init failed; continuing. Log: ${logPath}`);
+      resolve();
+    });
+  });
+}
+
+async function initTools(dataDir) {
+  const graymatterLog = join(dataDir, "graymatter-init.log");
+  const openspecLog = join(dataDir, "openspec-init.log");
+
+  await Promise.all([
+    initTool("graymatter", ["init", "--only", "opencode"], graymatterLog),
+    initTool("openspec", ["init", "--force", "--tools", "opencode"], openspecLog),
+  ]);
+}
+
+function startOmniroute(dataDir, logFile, pidFile) {
+  if (isProcessRunning("omniroute")) {
+    console.log("[omnicode] omniroute already running");
+    return null;
+  }
+
+  if (existsSync(pidFile) || existsSync(pidFile)) {
+    let pid = null;
+    try {
+      pid = parseInt(readFileSync(pidFile, "utf8").trim(), 10);
+    } catch {}
+    if (pid && isPidAlive(pid)) {
+      console.log(`[omnicode] omniroute already running (pid: ${pid})`);
+      return null;
+    }
+    try { unlinkSync(pidFile); } catch {}
+  }
+
+  console.log("[omnicode] starting omniroute...");
+  const log = openSync(logFile, "w");
+  const child = spawn("omniroute", ["--no-open"], {
+    detached: true,
+    stdio: ["ignore", log, log],
+  });
+  child.unref();
+  const pid = child.pid;
+  writeFileSync(pidFile, String(pid), { mode: 0o600 });
+
+  return pid;
+}
+
+async function waitForOmniroute(pid, logFile) {
+  let waited = 0;
+  while (waited < MAX_OMNI_WAIT * 1000) {
+    await sleep(OMNI_CHECK_DELAY);
+    waited += OMNI_CHECK_DELAY;
+
+    if (!isPidAlive(pid)) {
+      console.error(`[omnicode] ERROR: omniroute exited during startup. Log: ${logFile}`);
+      process.exit(1);
+    }
+
+    if (isProcessRunning("omniroute")) {
+      console.log(`[omnicode] omniroute started (pid: ${pid})`);
+      return;
+    }
+  }
+
+  console.error(`[omnicode] ERROR: omniroute did not become ready. Log: ${logFile}`);
+  process.exit(1);
+}
+
+function stopOmnirouteIfIdle(pidFile) {
+  if (isProcessRunning("opencode")) {
+    return;
+  }
+
+  if (existsSync(pidFile)) {
+    let pid = null;
+    try {
+      pid = parseInt(readFileSync(pidFile, "utf8").trim(), 10);
+    } catch {}
+    if (pid && isPidAlive(pid)) {
+      console.log(`[omnicode] no opencode left -> stopping omniroute (pid: ${pid})`);
+      try { process.kill(pid, "SIGTERM"); } catch {}
+      const deadline = Date.now() + 5000;
+      while (isPidAlive(pid) && Date.now() < deadline) {
+        try { process.kill(pid, 0); } catch { break; }
+      }
+    }
+    try { unlinkSync(pidFile); } catch {}
+  }
+}
+
+export async function runRuntime(mode) {
+  const dataDir = getDataDir();
+  mkdirSync(dataDir, { recursive: true });
+
+  const logFile = join(dataDir, "omniroute.log");
+  const pidFile = join(dataDir, "omniroute.pid");
+
+  if (!isWindows) {
+    process.umask(0o077);
+  }
+
+  const cleanup = () => stopOmnirouteIfIdle(pidFile);
+  process.on("exit", cleanup);
+  process.on("SIGINT", () => { cleanup(); process.exit(0); });
+  process.on("SIGTERM", () => { cleanup(); process.exit(0); });
+
+  await initTools(dataDir);
+
+  const pid = startOmniroute(dataDir, logFile, pidFile);
+  if (pid !== null) {
+    await waitForOmniroute(pid, logFile);
+  }
+
+  if (mode.flag === "-s" && mode.id) {
+    console.log(`[omnicode] launching opencode (session: ${mode.id})`);
+    await new Promise((resolve) => {
+      const child = spawn("opencode", ["-s", mode.id], {
+        stdio: "inherit",
+        cwd: process.cwd(),
+      });
+      child.on("close", () => resolve());
+    });
+  } else {
+    console.log("[omnicode] launching opencode (new session)");
+    await new Promise((resolve) => {
+      const child = spawn("opencode", [], {
+        stdio: "inherit",
+        cwd: process.cwd(),
+      });
+      child.on("close", () => resolve());
+    });
+  }
+}

package/src/bin/omnicode.js

@@ -1,29 +1,47 @@
 #!/usr/bin/env node
-import { execFileSync, spawn } from "node:child_process";
-import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { readFileSync, realpathSync } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
-import os from "node:os";
 
-import { commandExists } from "../installer/lib.js";
+import { commandExists, getOpencodeDbPath } from "../installer/lib.js";
+import { runRuntime } from "./omnicode-runtime.js";
 
 const __dirname = fileURLToPath(new URL(".", import.meta.url));
-const runtimeScript = join(__dirname, "omnicode-runtime.sh");
 const packageJsonPath = join(__dirname, "..", "..", "package.json");
 
 const SESSION_ID_RE = /^[a-zA-Z0-9_-]+$/;
+const isWindows = process.platform === "win32";
+
+let DatabaseSync;
+try {
+  ({ DatabaseSync } = await import("node:sqlite"));
+} catch {
+  DatabaseSync = null;
+}
 
 export function printUsage() {
   console.log(`Usage: omnicode [-s <session_id>] [-c] [--status] [--version]`);
 }
 
+let _cachedVersion = null;
+
 export function getVersion() {
+  if (_cachedVersion !== null) return _cachedVersion;
   const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
-  return pkg.version;
+  _cachedVersion = pkg.version;
+  return _cachedVersion;
 }
 
 export function isProcessRunning(name) {
   try {
+    if (isWindows) {
+      const out = execFileSync("tasklist", ["/FI", `IMAGENAME eq ${name}.exe`, "/NH"], {
+        stdio: ["ignore", "pipe", "ignore"],
+        encoding: "utf8",
+      });
+      return out.includes(`${name}.exe`);
+    }
     execFileSync("pgrep", ["-x", name], { stdio: "ignore" });
     return true;
   } catch {
@@ -78,7 +96,7 @@ export function parseArgs(argv) {
       process.exit(2);
     }
 
-    if (sessionId && !SESSION_ID_RE.test(sessionId)) {
+    if (!sessionId || !SESSION_ID_RE.test(sessionId)) {
       console.error(`[omnicode] ERROR: invalid session ID format`);
       process.exit(2);
     }
@@ -87,11 +105,11 @@ export function parseArgs(argv) {
 }
 
 export async function getLatestSessionId(directory = realpathSync(process.cwd())) {
-  const dbPath = join(os.homedir(), ".local", "share", "opencode", "opencode.db");
-  if (!existsSync(dbPath)) return null;
+  const dbPath = getOpencodeDbPath();
+  if (!dbPath) return null;
 
   try {
-    const { DatabaseSync } = await import("node:sqlite");
+    if (!DatabaseSync) return null;
     const db = new DatabaseSync(dbPath, { readOnly: true });
     const row = db.prepare(
       "SELECT id FROM session WHERE directory = ? ORDER BY time_updated DESC LIMIT 1"
@@ -103,21 +121,13 @@ export async function getLatestSessionId(directory = realpathSync(process.cwd())
   }
 }
 
-export async function resolveSessionMode(sessionId, continueSession = false, latestSessionId = null) {
+export async function resolveSessionMode(sessionId, latestSessionId = null) {
   if (sessionId) return { flag: "-s", id: sessionId };
   if (latestSessionId === null) latestSessionId = await getLatestSessionId();
   if (latestSessionId) return { flag: "-s", id: latestSessionId };
   return { flag: null, id: null };
 }
 
-export function buildRuntimeArgs(mode) {
-  const args = [runtimeScript];
-  if (mode.flag === "-s") {
-    args.push("-s", mode.id);
-  }
-  return args;
-}
-
 async function main() {
   const args = parseArgs(process.argv);
 
@@ -128,23 +138,8 @@ async function main() {
     process.exit(1);
   }
 
-  const mode = await resolveSessionMode(args.sessionId, args.continueSession);
-  const childArgs = buildRuntimeArgs(mode);
-
-  return new Promise((resolve, reject) => {
-    const child = spawn("bash", childArgs, {
-      stdio: "inherit",
-      cwd: process.cwd(),
-    });
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (code !== 0) {
-        process.exit(code);
-      } else {
-        resolve();
-      }
-    });
-  });
+  const mode = await resolveSessionMode(args.sessionId);
+  await runRuntime(mode);
 }
 
 function isMainModule() {

package/src/installer/lib.js

@@ -1,40 +1,26 @@
-import { execFileSync, spawn } from "node:child_process";
-import { existsSync, mkdirSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { join } from "node:path";
 import os from "node:os";
 
+const isWindows = process.platform === "win32";
+
 export function commandExists(command) {
+  const tool = isWindows ? "where" : "which";
   try {
-    execFileSync("which", [command], { stdio: "ignore" });
+    execFileSync(tool, [command], { stdio: "ignore" });
     return true;
   } catch {
     return false;
   }
 }
 
-export function run(command, args = [], opts = {}) {
-  const quoted = [command, ...args.map((a) => (a.includes(" ") ? `"${a}"` : a))].join(" ");
-  console.log(`[omnicode] $ ${quoted}`);
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-      stdio: "inherit",
-      shell: false,
-      cwd: process.cwd(),
-      ...opts,
-    });
-    child.on("error", reject);
-    child.on("close", (code) => {
-      if (code !== 0) {
-        reject(new Error(`Command failed with exit code ${code}: ${quoted}`));
-      } else {
-        resolve();
-      }
-    });
-  });
+export function getDataDir() {
+  return join(os.homedir(), ".local", "share", "omnicode");
 }
 
-export function getRuntimeDir() {
-  const dir = join(os.homedir(), ".local", "share", "omnicode");
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  return dir;
+export function getOpencodeDbPath() {
+  const dbPath = join(os.homedir(), ".local", "share", "opencode", "opencode.db");
+  if (!existsSync(dbPath)) return null;
+  return dbPath;
 }

package/src/bin/omnicode-runtime.sh

@@ -1,121 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-SESSION_FLAG="${1:-}"
-SESSION_ID="${2:-}"
-RUNTIME_DIR="$HOME/.local/share/omnicode"
-LOG_FILE="$RUNTIME_DIR/omniroute.log"
-GRAYMATTER_LOG="$RUNTIME_DIR/graymatter-init.log"
-OPENSPEC_LOG="$RUNTIME_DIR/openspec-init.log"
-PID_FILE="$RUNTIME_DIR/omniroute.pid"
-MAX_OMNI_WAIT=30
-OMNI_CHECK_DELAY=1
-
- export PATH="$PATH:$HOME/.local/bin:/usr/local/bin:/usr/bin:/bin"
- 
- umask 0077
- mkdir -p "$RUNTIME_DIR"
-
-is_pid_alive() {
-  local pid="${1:-}"
-  [[ -n "$pid" ]] && kill -0 "$pid" >/dev/null 2>&1
-}
-
-is_omniroute_running() {
-  pgrep -f "omniroute" >/dev/null 2>&1
-}
-
-is_opencode_running() {
-  pgrep -f "opencode" >/dev/null 2>&1
-}
-
-start_omniroute() {
-  if is_omniroute_running; then
-    echo "[omnicode] omniroute already running"
-    return 0
-  fi
-
-  echo "[omnicode] starting omniroute..."
-  : > "$LOG_FILE"
-  nohup omniroute --no-open >>"$LOG_FILE" 2>&1 &
-  local pid=$!
-  if [[ -e "$PID_FILE" ]]; then
-    echo "[omnicode] ERROR: PID file already exists at $PID_FILE" >&2
-    exit 1
-  fi
-  touch "$PID_FILE"
-  chmod 600 "$PID_FILE"
-  printf '%s\n' "$pid" > "$PID_FILE"
-
-  local waited=0
-  while [[ "$waited" -lt "$MAX_OMNI_WAIT" ]]; do
-    sleep "$OMNI_CHECK_DELAY"
-    waited=$((waited + OMNI_CHECK_DELAY))
-
-    if ! is_pid_alive "$pid"; then
-      echo "[omnicode] ERROR: omniroute exited during startup. Log: $LOG_FILE" >&2
-      exit 1
-    fi
-
-    if is_omniroute_running; then
-      echo "[omnicode] omniroute started (pid: $pid)"
-      return 0
-    fi
-  done
-
-  echo "[omnicode] ERROR: omniroute did not become ready. Log: $LOG_FILE" >&2
-  exit 1
-}
-
-stop_omniroute_if_idle() {
-  if is_opencode_running; then
-    return 0
-  fi
-
-  if [[ -f "$PID_FILE" ]]; then
-    local pid
-    pid="$(cat "$PID_FILE" 2>/dev/null || true)"
-    if is_pid_alive "$pid"; then
-      echo "[omnicode] no opencode left -> stopping omniroute (pid: $pid)"
-      kill "$pid" 2>/dev/null || true
-    fi
-    rm -f "$PID_FILE"
-  fi
-}
-
-cleanup() {
-  stop_omniroute_if_idle
-}
-trap cleanup EXIT INT TERM
-
-if command -v graymatter >/dev/null 2>&1; then
-  echo "[omnicode] graymatter: initializing"
-  if graymatter init --only opencode >"$GRAYMATTER_LOG" 2>&1; then
-    echo "[omnicode] graymatter: ready"
-  else
-    echo "[omnicode] WARNING: graymatter init failed; continuing. Log: $GRAYMATTER_LOG"
-  fi
-else
-  echo "[omnicode] graymatter: not installed, skipping"
-fi
-
-if command -v openspec >/dev/null 2>&1; then
-  echo "[omnicode] openspec: initializing"
-  if openspec init --force --tools opencode >"$OPENSPEC_LOG" 2>&1; then
-    echo "[omnicode] openspec: ready"
-  else
-    echo "[omnicode] WARNING: openspec init failed; continuing. Log: $OPENSPEC_LOG"
-  fi
-else
-  echo "[omnicode] openspec: not installed, skipping"
-fi
-
-start_omniroute
-
-if [[ "$SESSION_FLAG" == "-s" && -n "$SESSION_ID" ]]; then
-  echo "[omnicode] launching opencode (session: $SESSION_ID)"
-  opencode -s "$SESSION_ID"
-else
-  echo "[omnicode] launching opencode (new session)"
-  opencode
-fi