@inceptionstack/roundhouse 0.3.11 → 0.3.13

package/README.md

@@ -95,7 +95,8 @@ roundhouse install    # installs as systemd service, starts automatically
 roundhouse <command>
 
 Commands:
-  start               Start the gateway (foreground)
+  start               Start the gateway daemon
+  run                 Run the gateway in foreground
   tui [thread]        Open agent TUI on a gateway session
   install             Install as a systemd daemon (requires sudo)
   uninstall           Remove the systemd daemon

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inceptionstack/roundhouse",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "type": "module",
   "description": "Multi-platform chat gateway that routes messages through a configured AI agent",
   "license": "MIT",

package/src/cli/cli.ts

@@ -56,6 +56,28 @@ function systemctl(verb: string, message?: string): void {
 // ── Commands ────────────────────────────────────────
 
 async function cmdStart() {
+  // If systemd service is installed, start via systemctl
+  const serviceInstalled = run(`systemctl list-unit-files ${SERVICE_NAME}.service`, { silent: true }).includes(SERVICE_NAME);
+  if (serviceInstalled) {
+    const isActive = run(`systemctl is-active ${SERVICE_NAME}`, { silent: true }) === "active";
+    if (isActive) {
+      console.log("Roundhouse is already running.");
+      console.log("  Use: roundhouse restart   to restart");
+      console.log("       roundhouse status    to check status");
+      console.log("       roundhouse logs      to tail logs");
+      return;
+    }
+    systemctl("start", "Daemon started.");
+    return;
+  }
+
+  // No systemd service — fall back to foreground
+  console.log("No systemd service found. Running in foreground (use Ctrl+C to stop)...");
+  console.log("  Tip: run 'roundhouse install' to set up the systemd daemon.\n");
+  await cmdRun();
+}
+
+async function cmdRun() {
   process.env.ROUNDHOUSE_CONFIG = CONFIG_PATH;
   const indexPath = resolve(__dirname, "..", "index.ts");
   const jsPath = resolve(__dirname, "..", "dist", "index.js");
@@ -117,15 +139,15 @@ async function cmdInstall() {
   const binPath = run("which roundhouse", { silent: true });
   const nodePath = run("which node", { silent: true }) || process.execPath;
   const tsxPath = resolve(__dirname, "..", "..", "node_modules", ".bin", "tsx");
-  const srcIndex = resolve(__dirname, "..", "index.ts");
 
   let execStart: string;
   if (binPath) {
-    execStart = `${nodePath} ${binPath} start`;
+    execStart = `${nodePath} ${binPath} run`;
   } else {
-    // No global install — use tsx directly
+    // No global install — run CLI via tsx with 'run' subcommand
     const tsxBin = run("which tsx", { silent: true }) || tsxPath;
-    execStart = `${tsxBin} ${srcIndex}`;
+    const cliPath = resolve(__dirname, "cli.ts");
+    execStart = `${tsxBin} ${cliPath} run`;
   }
 
   // Compute PATH that includes node's bin dir (for mise/nvm setups)
@@ -417,7 +439,8 @@ Usage:
 Commands:
   setup               One-command install & configure (also works via npx)
   pair                Pair Telegram account for notifications
-  start               Start the gateway (foreground)
+  start               Start the gateway daemon
+  run                 Run the gateway in foreground
   tui [thread]        Open agent TUI on a gateway session
   install             Install as a systemd daemon (requires sudo)
   uninstall           Remove the systemd daemon
@@ -600,6 +623,7 @@ const commands: Record<string, () => void | Promise<void>> = {
   setup: () => cmdSetup(process.argv.slice(3)),
   pair: () => cmdPair(process.argv.slice(3)),
   start: cmdStart,
+  run: cmdRun,
   install: cmdInstall,
   uninstall: cmdUninstall,
   update: cmdUpdate,

package/src/cli/doctor/checks/credentials.ts

@@ -22,7 +22,7 @@ export const credentialChecks: DoctorCheck[] = [
         return {
           id: "telegram-token", category: "credentials", name: "Telegram bot token",
           status: "fail", summary: "TELEGRAM_BOT_TOKEN not set",
-          details: ["Set TELEGRAM_BOT_TOKEN in your environment or ~/.roundhouse/env"],
+          details: ["Set TELEGRAM_BOT_TOKEN in your environment or ~/.roundhouse/.env"],
         };
       }
       if (!/^\d+:[A-Za-z0-9_-]+$/.test(token)) {

package/src/cli/setup.ts

@@ -630,7 +630,7 @@ async function stepConfigure(
   }
 
   await atomicWriteText(ENV_PATH, envLines.join("\n") + "\n");
-  ok(`~/.roundhouse/env${opts.psst ? " (non-secret config only)" : ""}`);
+  ok(`~/.roundhouse/.env${opts.psst ? " (non-secret config only)" : ""}`);
 }
 
 async function stepPair(opts: SetupOptions, botInfo: BotInfo): Promise<PairResult | null> {
@@ -740,12 +740,12 @@ async function stepInstallSystemd(opts: SetupOptions): Promise<void> {
     }
   }
 
-  // Build ExecStart
+  // Build ExecStart — uses `roundhouse run` (foreground mode for systemd)
   let execStart: string;
   if (psstBin) {
-    execStart = `${psstBin} run ${nodeBin} ${roundhouseBin} start`;
+    execStart = `${psstBin} run ${nodeBin} ${roundhouseBin} run`;
   } else {
-    execStart = `${nodeBin} ${roundhouseBin} start`;
+    execStart = `${nodeBin} ${roundhouseBin} run`;
   }
 
   // Always include env file for non-secret config (AWS_PROFILE, etc)
@@ -873,7 +873,7 @@ export async function cmdSetup(argv: string[]): Promise<void> {
     }
     log(`   Bot: @${botInfo.username}`);
     log(`   Memory: ${opts.extensions.some((e) => e.includes("pi-memory")) ? "agent-managed" : "roundhouse-managed"}`);
-    log(`   Secrets: ${opts.psst ? "psst vault (encrypted)" : "~/.roundhouse/env (plaintext)"}`);
+    log(`   Secrets: ${opts.psst ? "psst vault (encrypted)" : "~/.roundhouse/.env (plaintext)"}`);
     log(`   Send /status to @${botInfo.username} on Telegram.\n`);
   } catch (err: any) {
     log("\n━━━━━━━━━━━━━━━━━━━");
@@ -993,7 +993,7 @@ function printDryRun(opts: SetupOptions): void {
   log(`  Set defaultProvider: ${opts.provider}`);
   log(`  Set defaultModel: ${opts.model}`);
   log(`Would write: ~/.roundhouse/gateway.config.json`);
-  log(`Would write: ~/.roundhouse/env${opts.psst ? " (non-secret config only)" : ""}`);
+  log(`Would write: ~/.roundhouse/.env${opts.psst ? " (non-secret config only)" : ""}`);
   log(`Would register ${BOT_COMMANDS.length} bot commands`);
   if (opts.systemd) log(`Would install systemd service`);
   log("\nNo changes made.\n");

package/src/config.ts

@@ -21,7 +21,10 @@ export const LEGACY_CONFIG_DIR = resolve(homedir(), ".config", "roundhouse");
 /** Active config directory — use ROUNDHOUSE_DIR */
 export const CONFIG_DIR = ROUNDHOUSE_DIR;
 export const CONFIG_PATH = resolve(ROUNDHOUSE_DIR, "gateway.config.json");
-export const ENV_FILE_PATH = resolve(ROUNDHOUSE_DIR, "env");
+export const ENV_FILE_PATH = resolve(ROUNDHOUSE_DIR, ".env");
+
+/** Legacy env file name (deprecated) */
+export const LEGACY_ENV_FILE_PATH = resolve(ROUNDHOUSE_DIR, "env");
 
 /** Cron directories */
 export const CRON_JOBS_DIR = resolve(ROUNDHOUSE_DIR, "crons");
@@ -109,15 +112,26 @@ export async function resolveConfigPath(): Promise<{ path: string; legacy: boole
 let envFileWarned = false;
 
 export async function resolveEnvFilePath(): Promise<string> {
+  // Canonical: ~/.roundhouse/.env
   if (await fileExists(ENV_FILE_PATH)) return ENV_FILE_PATH;
-  const legacyEnv = resolve(LEGACY_CONFIG_DIR, "env");
-  if (await fileExists(legacyEnv)) {
+  // Legacy: ~/.roundhouse/env (old name, same directory)
+  if (await fileExists(LEGACY_ENV_FILE_PATH)) {
+    if (!envFileWarned) {
+      envFileWarned = true;
+      console.warn(`[roundhouse] \u26a0\ufe0f  Env file found at legacy path: ${LEGACY_ENV_FILE_PATH}`);
+      console.warn(`[roundhouse]    Rename it to ${ENV_FILE_PATH} \u2014 legacy name will be removed in a future version.`);
+    }
+    return LEGACY_ENV_FILE_PATH;
+  }
+  // Legacy: ~/.config/roundhouse/env (old directory)
+  const legacyDirEnv = resolve(LEGACY_CONFIG_DIR, "env");
+  if (await fileExists(legacyDirEnv)) {
     if (!envFileWarned) {
       envFileWarned = true;
-      console.warn(`[roundhouse] \u26a0\ufe0f  Env file found at legacy path: ${legacyEnv}`);
+      console.warn(`[roundhouse] \u26a0\ufe0f  Env file found at legacy path: ${legacyDirEnv}`);
       console.warn(`[roundhouse]    Move it to ${ENV_FILE_PATH} \u2014 legacy path will be removed in a future version.`);
     }
-    return legacyEnv;
+    return legacyDirEnv;
   }
   return ENV_FILE_PATH;
 }