@jhizzard/termdeck 0.4.6 → 0.5.1

package/README.md

@@ -22,6 +22,14 @@ First-time user? The **config** button in the toolbar shows what's set up and wh
 
 Enabling Flashback takes **one additional 15-minute setup step** — see Tier 2 below. The rest of this README explains what you get, how it works, and how to go deeper.
 
+### Want the whole stack in one command?
+
+```bash
+npx @jhizzard/termdeck-stack
+```
+
+The meta-installer prints a layered overview of the four packages (TermDeck + Mnestra + Rumen + Supabase MCP), detects what's already on your machine, asks which tier you want, runs `npm install -g` for the missing pieces, and merges Mnestra + Supabase MCP entries into `~/.claude/mcp.json`. See [packages/stack-installer/README.md](packages/stack-installer/README.md) for details, or `npx @jhizzard/termdeck-stack --help`.
+
 ---
 
 ## Documentation hierarchy
@@ -211,8 +219,8 @@ For users who want more than `npx` — cloning from source, building a macOS `.a
 
 ### Alternative install paths
 
-- **Permanent global install:** `npm install -g @jhizzard/termdeck` then `termdeck` from anywhere
-- **Full-stack one-liner:** `termdeck stack` (after global install) — boots Mnestra + checks Rumen + starts TermDeck with the same numbered-step output as `scripts/start.sh` from the repo. Available since v0.4.6; no clone required.
+- **Permanent global install:** `npm install -g @jhizzard/termdeck` then `termdeck` from anywhere. From v0.5.0, `termdeck` (no subcommand) auto-detects a configured stack and boots Mnestra + checks Rumen automatically — same four-step output as `scripts/start.sh`. Use `termdeck --no-stack` to force a Tier-1-only boot.
+- **Force-orchestrate alias:** `termdeck stack` always runs the orchestrator regardless of detection — kept for backward compatibility with v0.4.6 docs and muscle memory.
 - **macOS native app:** `git clone && cd && ./install.sh` — creates `~/Applications/TermDeck.app`
 - **From source:** `git clone && npm install && npm run dev`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.4.6",
+  "version": "0.5.1",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"
@@ -18,7 +18,8 @@
   "workspaces": [
     "packages/server",
     "packages/client",
-    "packages/cli"
+    "packages/cli",
+    "packages/stack-installer"
   ],
   "scripts": {
     "dev": "node packages/server/src/index.js",

package/packages/cli/src/auto-orchestrate.js

@@ -0,0 +1,26 @@
+// Detection helper for Sprint 24: should `termdeck` (no subcommand)
+// auto-route through stack.js? Pure function, isolated for testability —
+// the dispatcher in index.js still owns the actual routing decision.
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+function shouldAutoOrchestrate(homeDir) {
+  const home = homeDir || os.homedir();
+  const secretsPath = path.join(home, '.termdeck', 'secrets.env');
+  const configPath = path.join(home, '.termdeck', 'config.yaml');
+  if (!fs.existsSync(secretsPath) || !fs.existsSync(configPath)) return false;
+  let parsed;
+  try {
+    const yaml = require('yaml');
+    parsed = yaml.parse(fs.readFileSync(configPath, 'utf8')) || {};
+  } catch (_e) {
+    return false;
+  }
+  const mnestraAuto = parsed.mnestra && parsed.mnestra.autoStart === true;
+  const ragEnabled = parsed.rag && parsed.rag.enabled === true;
+  return Boolean(mnestraAuto || ragEnabled);
+}
+
+module.exports = { shouldAutoOrchestrate };

package/packages/cli/src/index.js

@@ -76,6 +76,27 @@ if (args[0] === 'stack') {
   return;
 }
 
+// Sprint 24: when `termdeck` is invoked with no subcommand AND a configured
+// stack is detected, route through stack.js so users don't have to remember
+// the `stack` subcommand. `--no-stack` is the explicit opt-out.
+const { shouldAutoOrchestrate } = require(path.join(__dirname, 'auto-orchestrate.js'));
+
+const KNOWN_SUBCOMMANDS = new Set(['init', 'forge', 'stack']);
+const noStackIdx = args.indexOf('--no-stack');
+const noStackRequested = noStackIdx !== -1;
+if (noStackRequested) args.splice(noStackIdx, 1); // strip before flag parsing
+
+const wantsHelp = args.includes('--help') || args.includes('-h');
+
+if (!KNOWN_SUBCOMMANDS.has(args[0]) && !noStackRequested && !wantsHelp && shouldAutoOrchestrate()) {
+  const stack = require(path.join(__dirname, 'stack.js'));
+  stack(args).then((code) => process.exit(code || 0)).catch((err) => {
+    console.error('[cli] auto-stack failed:', err && err.stack || err);
+    process.exit(1);
+  });
+  return;
+}
+
 const flags = {};
 for (let i = 0; i < args.length; i++) {
   if (args[i] === '--port' && args[i + 1]) {
@@ -90,8 +111,9 @@ for (let i = 0; i < args.length; i++) {
   TermDeck - Web-based terminal multiplexer
 
   Usage:
-    termdeck                    Start TermDeck only (port 3000)
-    termdeck stack              Boot Mnestra + check Rumen + start TermDeck
+    termdeck                    Auto-orchestrate stack if configured, else Tier-1-only
+    termdeck stack              Force boot Mnestra + check Rumen + start TermDeck
+    termdeck --no-stack         Skip orchestrator (force Tier-1-only boot)
     termdeck --port 8080        Start on custom port
     termdeck --no-open          Don't auto-open browser
     termdeck --session-logs     Write per-session markdown logs to ~/.termdeck/sessions/

package/packages/cli/src/stack.js

@@ -385,15 +385,32 @@ async function checkRumen() {
 // ── Step 4: TermDeck ────────────────────────────────────────────────
 
 function execTermDeck({ port, extra }) {
-  // Rather than execve, just require() the existing CLI in-process. That
-  // lets `termdeck stack` share signal handling with the server (Ctrl+C
-  // shuts everything down, including the detached Mnestra if we own it).
+  // Spawn a fresh node process for the CLI rather than require()-ing it
+  // in-process. Two reasons:
+  //   1. require() hits Node's module cache after stack.js → index.js →
+  //      stack.js bounces (the v0.5.0 auto-orchestrate path), so the
+  //      cached index.js is a no-op and the server never starts. This
+  //      manifested in `scripts/start.sh` which already exec'd node, then
+  //      v0.5.0's auto-orchestrate routed it back through stack.js, then
+  //      stack.js tried to re-require the (cached) CLI — silent exit.
+  //   2. Pass --no-stack on the way back so index.js definitively skips
+  //      the auto-orchestrate detection. Defensive even with the spawn.
   const cliPath = path.join(__dirname, 'index.js');
-  const argv = [];
+  const argv = [cliPath, '--no-stack'];
   if (port) argv.push('--port', String(port));
   argv.push(...extra);
-  process.argv = [process.argv[0], cliPath, ...argv];
-  require(cliPath);
+  const child = spawn(process.execPath, argv, {
+    stdio: 'inherit',
+    env: process.env,
+  });
+  child.on('exit', (code, signal) => {
+    if (signal) process.kill(process.pid, signal);
+    else process.exit(code == null ? 0 : code);
+  });
+  // Forward Ctrl+C cleanly so the spawned server can shut down.
+  for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+    process.on(sig, () => { try { child.kill(sig); } catch (_e) { /* gone */ } });
+  }
 }
 
 // ── Main ────────────────────────────────────────────────────────────