@jhizzard/termdeck 0.4.6 → 0.5.0

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.0",
   "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/