great-cto 2.67.0 → 2.69.0

package/dist/main.js

@@ -41,6 +41,7 @@ function parseArgs(argv) {
         command: "init",
         boardPort: 3141,
         boardNoOpen: false,
+        consoleBind: null,
         dir: process.cwd(),
         yes: false,
         dryRun: false,
@@ -87,8 +88,14 @@ function parseArgs(argv) {
             const v = a.slice("--host=".length);
             args.host = (v === "codex" || v === "claude-code") ? v : null;
         }
+        else if (a === "--bind")
+            args.consoleBind = argv[++i] ?? null;
+        else if (a.startsWith("--bind="))
+            args.consoleBind = a.slice("--bind=".length) || null;
         else if (a === "board")
             args.command = "board";
+        else if (a === "console")
+            args.command = "console";
         else if (a === "register")
             args.command = "register";
         else if (a === "ci")
@@ -187,8 +194,10 @@ async function runRegister(args) {
 }
 // ── Board server lifecycle helpers ───────────────────────────────────────────
 /** Absolute path to the board PID file (persists across CLI invocations). */
-function boardPidFilePath() {
-    return join(homedir(), ".great_cto", "board.pid");
+function boardPidFilePath(surface) {
+    // The two surfaces are separate processes with separate lifecycles — a console
+    // start must never kill the builder board (and vice versa).
+    return join(homedir(), ".great_cto", surface === "console" ? "console.pid" : "board.pid");
 }
 /**
  * Locate the board server.mjs — checks dev layouts then plugin cache versions
@@ -217,8 +226,8 @@ function findBoardServerPath() {
  * Kill the board server recorded in the PID file.
  * Returns true if a live process was terminated.
  */
-async function killExistingBoard() {
-    const pidFile = boardPidFilePath();
+async function killExistingBoard(surface) {
+    const pidFile = boardPidFilePath(surface);
     if (!fsExistsSync(pidFile))
         return false;
     const raw = readFileSync(pidFile, "utf8").trim();
@@ -296,12 +305,12 @@ async function restartBoardAfterUpgrade(port) {
     log(`  ${green("✓")} board restarted → http://localhost:${port}`);
 }
 // ─────────────────────────────────────────────────────────────────────────────
-async function runBoard(args) {
+async function runBoard(args, surface) {
     const { spawn } = await import("node:child_process");
-    // Stop any existing board server (e.g. old version left over after upgrade)
-    const killed = await killExistingBoard();
+    // Stop any existing server OF THIS SURFACE (board and console run side by side)
+    const killed = await killExistingBoard(surface);
     if (killed) {
-        log(`  ${dim("stopped previous board server")}`);
+        log(`  ${dim(surface === "console" ? "stopped previous console server" : "stopped previous board server")}`);
     }
     const serverPath = findBoardServerPath();
     if (!serverPath) {
@@ -311,20 +320,25 @@ async function runBoard(args) {
     const nodeArgs = [serverPath];
     if (args.boardNoOpen)
         nodeArgs.push("--no-open");
+    if (surface)
+        nodeArgs.push("--surface", surface);
+    const env = { ...process.env, BOARD_PORT: String(args.boardPort) };
+    if (surface === "console" && args.consoleBind)
+        env.GREAT_CTO_HOST = args.consoleBind;
     const child = spawn(process.execPath, nodeArgs, {
-        env: { ...process.env, BOARD_PORT: String(args.boardPort) },
+        env,
         stdio: "inherit",
         detached: false,
     });
     // Write PID so future invocations (including init upgrades) can find us
     try {
         mkdirSync(join(homedir(), ".great_cto"), { recursive: true });
-        writeFileSync(boardPidFilePath(), String(child.pid));
+        writeFileSync(boardPidFilePath(surface), String(child.pid));
     }
     catch { /* best-effort */ }
     child.on("exit", code => {
         try {
-            unlinkSync(boardPidFilePath());
+            unlinkSync(boardPidFilePath(surface));
         }
         catch { /* ignore */ }
         process.exit(code ?? 0);
@@ -338,6 +352,7 @@ ${bold("Usage:")}
   npx great-cto install [options]    Same as init
   npx great-cto [init] [options]     Detect + bootstrap
   npx great-cto board [--port 3141] [--no-open]
+  npx great-cto console [--port 8788] [--bind 0.0.0.0] [--no-open]
   npx great-cto register [--dir PATH]
   npx great-cto ci [path] [--no-archetype] [--no-budget]
   npx great-cto mcp [--sse --port N]
@@ -352,6 +367,12 @@ ${bold("Board:")}
   great-cto board --port 4000  Use a different port
   great-cto board --no-open    Start server without opening browser
 
+${bold("Operator console (the second surface — invite-only, hostable):")}
+  great-cto console                 Serve ONLY the operator console (no dev board)
+  great-cto console --port 8788     Different port
+  great-cto console --bind 0.0.0.0  Reachable beyond this machine (tunnel/hosting);
+                                    operators sign in via invite links
+
 ${bold("Register:")}
   great-cto register           Add this repo to ~/.great_cto/projects.json
                                (auto-discovered after /audit or /start, but
@@ -972,6 +993,16 @@ async function main() {
             process.exit(1);
         }
     }
+    if (args.command === "console") {
+        try {
+            const code = await runBoard(args, "console");
+            process.exit(code);
+        }
+        catch (e) {
+            error(e.message);
+            process.exit(1);
+        }
+    }
     if (args.command === "register") {
         try {
             const code = await runRegister(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "great-cto",
-  "version": "2.67.0",
+  "version": "2.69.0",
   "description": "One command install for the great_cto Claude Code plugin. Auto-detects your stack, picks the right archetype, bootstraps PROJECT.md.",
   "keywords": [
     "claude-code",