cto-agent-system 1.1.0 → 1.2.1

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "cto-agent-system",
       "description": "An autonomous software company: CEO (you) + CTO/CPO/CMO leading 15 specialist agents. Run /cto and the CTO takes over — digests the project, fixes fires, improves the product, reports back with a roadmap.",
-      "version": "1.1.0",
+      "version": "1.2.1",
       "source": "./",
       "author": {
         "name": "xenitV1",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cto-agent-system",
   "description": "An autonomous software company: CEO (you) + CTO/CPO/CMO leading 15 specialist agents. Run /cto and the CTO takes over — digests the project, fixes fires, improves the product, reports back with a roadmap.",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "author": {
     "name": "xenitV1",
     "url": "https://github.com/xenitV1"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cto-agent-system",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "An autonomous software company: CEO (you) + CTO/CPO/CMO leading 15 specialist agents. Run /cto and the CTO takes over — digests the project, fixes fires, improves the product, reports back with a roadmap.",
   "author": {
     "name": "xenitV1",

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "cto-agent-system",
   "displayName": "Software Company Agent System",
   "description": "An autonomous software company: CEO (you) + CTO/CPO/CMO leading 15 specialist agents. Run /cto and the CTO takes over.",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "author": {
     "name": "xenitV1",
     "url": "https://github.com/xenitV1"

package/.zcode-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "cto-agent-system",
   "description": "An autonomous software company: CEO (you) + CTO/CPO/CMO leading 15 specialist agents. Run /cto and the CTO takes over — digests the project, fixes fires, improves the product, reports back with a roadmap.",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "author": {
     "name": "xenitV1",
     "url": "https://github.com/xenitV1"

package/install.js

@@ -22,6 +22,7 @@ import {
 import { dirname, join, resolve, isAbsolute } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir, platform } from "node:os";
+import { ReadStream } from "node:tty";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 // install.js lives at the package root (next to AGENTS.md, src/, .claude/).
@@ -60,22 +61,26 @@ const ADAPTERS = [
   {
     key: "claude", name: "Claude Code", dir: ".claude", cmds: ["claude"],
     globalDir: () => join(homedir(), ".claude"),
-    pluginNote: "In Claude Code/ZCode, also install as a plugin for auto-updates:\n      /plugin marketplace add xenitV1/cto-agent-system\n      /plugin install cto-agent-system@cto-agent-marketplace",
+    pluginCapable: true,
+    pluginCmds: [
+      "/plugin marketplace add xenitV1/cto-agent-system",
+      "/plugin install cto-agent-system@cto-agent-marketplace",
+    ],
   },
   {
     key: "codex", name: "OpenAI Codex", dir: ".codex", cmds: ["codex"],
     globalDir: () => join(homedir(), ".codex"),
-    pluginNote: "Codex plugin (.codex-plugin/) installed via folder copy — Codex auto-detects it.",
+    pluginCapable: false, // .codex-plugin auto-detected from folder copy
   },
   {
     key: "opencode", name: "OpenCode", dir: ".opencode", cmds: ["opencode"],
     globalDir: () => join(homedir(), ".config", "opencode"),
-    pluginNote: "OpenCode agents/rules installed (OpenCode plugins are JS hooks, separate concept).",
+    pluginCapable: false, // OpenCode plugins are JS hooks, separate concept
   },
   {
     key: "cursor", name: "Cursor", dir: ".cursor", cmds: ["cursor"],
     globalDir: () => join(homedir(), ".cursor"),
-    pluginNote: "Cursor plugin (.cursor-plugin/) installed via folder copy — Cursor auto-detects it.",
+    pluginCapable: false, // .cursor-plugin auto-detected from folder copy
   },
 ];
 
@@ -100,6 +105,178 @@ async function askYesNo(rl, question, defaultYes = true) {
   return answer === "y" || answer === "yes";
 }
 
+// ---------------------------------------------------------------------------
+// Interactive menus (arrow keys + space toggle + enter).
+// Zero-dependency: raw TTY via node:tty. Non-TTY falls back to a numbered text
+// prompt. We redraw by clearing each line individually with \x1b[2K and moving
+// up, which is more reliable than whole-block clears.
+// ---------------------------------------------------------------------------
+
+const ESC = "\x1b";
+const HIDE = `${ESC}[?25l`;
+const SHOW = `${ESC}[?25h`;
+const UP = `${ESC}[1A`;
+const CLR = `${ESC}[2K`;          // erase entire current line
+const DOWN = `${ESC}[1B`;
+
+function isInteractiveTty() {
+  return Boolean(stdin.isTTY && stdin instanceof ReadStream);
+}
+
+// Move up N lines and clear each, leaving the cursor at the top of the cleared block.
+function rewind(lines) {
+  if (lines <= 0) return;
+  let out = "";
+  for (let i = 0; i < lines; i++) out += `${UP}${CLR}`;
+  // Drop back down to the first line of the block so we can re-render there.
+  for (let i = 0; i < lines; i++) out += DOWN;
+  out += UP.repeat(lines);
+  stdout.write(out);
+}
+
+/**
+ * Multi-select checkbox menu.
+ * @returns {Promise<number[]>} indices of checked items at confirm time.
+ */
+function checkboxMenu(title, items) {
+  return new Promise((resolvePromise) => {
+    if (!isInteractiveTty()) {
+      const rl = createInterface({ input: stdin, output: stdout });
+      const fallback = async () => {
+        console.log(title);
+        items.forEach((it, i) => {
+          const mark = it.checked ? "[x]" : "[ ]";
+          console.log(`  ${i + 1}. ${mark} ${it.label}${it.hint ? `  — ${it.hint}` : ""}`);
+        });
+        const ans = (await rl.question(
+          `Enter numbers comma-separated (e.g. 1,3) or 'all' (blank=all): `
+        )).trim().toLowerCase();
+        rl.close();
+        if (ans === "all" || ans === "") return items.map((_, i) => i);
+        return ans.split(/[,\s]+/).map((n) => parseInt(n, 10) - 1)
+          .filter((n) => n >= 0 && n < items.length);
+      };
+      fallback().then(resolvePromise);
+      return;
+    }
+
+    let cursor = 0;
+    const state = items.map((it) => !!it.checked);
+    const titleLines = title.split("\n");
+    const totalLines = titleLines.length + 1 + items.length; // title + hint + items
+    let drawn = 0;
+
+    const render = () => {
+      if (drawn > 0) rewind(drawn);
+      const lines = [];
+      lines.push(...titleLines);
+      lines.push("  (↑/↓ move · space toggle · a = all · enter = confirm)");
+      items.forEach((it, i) => {
+        const arrow = i === cursor ? "❯" : " ";
+        const box = state[i] ? "◉" : "◯";
+        const hint = it.hint ? `   ${it.hint}` : "";
+        lines.push(`  ${arrow} ${box} ${it.label}${hint}`);
+      });
+      stdout.write(lines.join("\r\n") + "\r\n");
+      drawn = totalLines;
+    };
+
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    stdin.setRawMode(true);
+    stdout.write(HIDE);
+    render();
+
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      try { stdin.setRawMode(false); } catch {}
+      stdin.pause();
+      stdout.write(SHOW);
+    };
+
+    const onData = (ch) => {
+      if (ch === "\x03") { cleanup(); process.exit(0); }
+      if (ch === "\r" || ch === "\n") {
+        cleanup();
+        resolvePromise(items.map((_, i) => i).filter((i) => state[i]));
+        return;
+      }
+      if (ch === "a" || ch === "A") {
+        const allOn = state.every(Boolean);
+        for (let i = 0; i < state.length; i++) state[i] = !allOn;
+        render();
+        return;
+      }
+      if (ch === " ") { state[cursor] = !state[cursor]; render(); return; }
+      if (ch === `${ESC}[A`) { cursor = (cursor - 1 + items.length) % items.length; render(); return; }
+      if (ch === `${ESC}[B`) { cursor = (cursor + 1) % items.length; render(); return; }
+    };
+
+    stdin.on("data", onData);
+  });
+}
+
+/**
+ * Single-select menu (arrows + enter). Returns chosen index.
+ */
+function selectMenu(title, items) {
+  return new Promise((resolvePromise) => {
+    if (!isInteractiveTty()) {
+      const rl = createInterface({ input: stdin, output: stdout });
+      const fallback = async () => {
+        console.log(title);
+        items.forEach((it, i) => console.log(`  ${i + 1}. ${it.label}`));
+        const ans = parseInt((await rl.question("Choice (number): ")).trim(), 10);
+        rl.close();
+        return Number.isNaN(ans) ? 0 : Math.max(0, Math.min(items.length - 1, ans - 1));
+      };
+      fallback().then(resolvePromise);
+      return;
+    }
+
+    let cursor = 0;
+    const titleLines = title.split("\n");
+    const totalLines = titleLines.length + 1 + items.length;
+    let drawn = 0;
+
+    const render = () => {
+      if (drawn > 0) rewind(drawn);
+      const lines = [];
+      lines.push(...titleLines);
+      lines.push("  (↑/↓ move · enter = select)");
+      items.forEach((it, i) => {
+        const arrow = i === cursor ? "❯" : " ";
+        lines.push(`  ${arrow} ${it.label}`);
+      });
+      stdout.write(lines.join("\r\n") + "\r\n");
+      drawn = totalLines;
+    };
+
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    stdout.write(HIDE);
+    render();
+
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      try { stdin.setRawMode(false); } catch {}
+      stdin.pause();
+      stdout.write(SHOW);
+    };
+
+    const onData = (ch) => {
+      if (ch === "\x03") { cleanup(); process.exit(0); }
+      if (ch === "\r" || ch === "\n") { cleanup(); resolvePromise(cursor); return; }
+      if (ch === `${ESC}[A`) { cursor = (cursor - 1 + items.length) % items.length; render(); return; }
+      if (ch === `${ESC}[B`) { cursor = (cursor + 1) % items.length; render(); return; }
+    };
+
+    stdin.on("data", onData);
+  });
+}
+
 // ---------------------------------------------------------------------------
 // File helpers
 // ---------------------------------------------------------------------------
@@ -107,6 +284,15 @@ async function askYesNo(rl, question, defaultYes = true) {
 function log(icon, msg) { console.log(`  ${icon} ${msg}`); }
 
 function copyTree(src, dst, { overwrite = false } = {}) {
+  const stat = lstatSync(src);
+  if (stat.isFile()) {
+    // src is a single file — copy it (ensuring the parent dir exists).
+    if (!overwrite && existsSync(dst)) return;
+    mkdirSync(dirname(dst), { recursive: true });
+    cpSync(src, dst, { overwrite: true });
+    return;
+  }
+  // src is a directory — recurse.
   mkdirSync(dst, { recursive: true });
   for (const name of readdirSync(src)) {
     const s = join(src, name);
@@ -145,21 +331,32 @@ function installAdapter(adapter, scope, force) {
     log("⚠", `${adapter.dir}/ not shipped (adapter not built yet) — skipping ${adapter.name}`);
     return;
   }
-  const dst = join(adapterBase(adapter, scope), adapter.dir);
-  if (existsSync(dst) && !force) {
-    copyTree(srcDir, dst, { overwrite: false });
-    log("✓", `${adapter.dir}/ (merged) — ${adapter.name}`);
+  // Project scope: write the adapter dir (e.g. <project>/.claude) as-is.
+  // Global scope: merge the CONTENTS of the adapter dir into the tool's
+  // global config dir (e.g. ~/.claude/), NOT a nested ~/.claude/.claude/.
+  // That's how Claude Code / Codex / OpenCode actually discover them.
+  if (scope === "global") {
+    const globalBase = adapter.globalDir();
+    mkdirSync(globalBase, { recursive: true });
+    // Merge each child of srcDir into globalBase.
+    for (const name of readdirSync(srcDir)) {
+      copyTree(join(srcDir, name), join(globalBase, name), { overwrite: force });
+    }
+    log("✓", `${adapter.dir}/* → ${globalBase} (global) — ${adapter.name}`);
   } else {
-    copyTree(srcDir, dst, { overwrite: true });
-    log("✓", `${adapter.dir}/ — ${adapter.name}`);
+    const dst = join(PROJECT_TARGET, adapter.dir);
+    if (existsSync(dst) && !force) {
+      copyTree(srcDir, dst, { overwrite: false });
+      log("✓", `${adapter.dir}/ (merged) — ${adapter.name}`);
+    } else {
+      copyTree(srcDir, dst, { overwrite: true });
+      log("✓", `${adapter.dir}/ — ${adapter.name}`);
+    }
   }
 }
 
-// Adapter base depends on scope; for project it's the project target.
+// Project target (set in main()).
 let PROJECT_TARGET = process.cwd();
-function adapterBase(adapter, scope) {
-  return scope === "global" ? adapter.globalDir() : PROJECT_TARGET;
-}
 
 function initState(target, force) {
   const cto = join(target, ".cto");
@@ -236,20 +433,25 @@ Examples:
   console.log("");
 
   const interactive = !yes && stdin.isTTY;
-  const rl = interactive ? createInterface({ input: stdin, output: stdout }) : null;
 
-  // 2. Scope
+  // 2. Scope — arrow-key single select (interactive) or flags/default.
   let scope;
   if (goGlobal) scope = "global";
   else if (goProject) scope = "project";
   else if (interactive) {
-    if (installed.length > 0) {
-      const g = await askYesNo(rl, "Install GLOBALLY for detected CLI(s) (user-wide)?", true);
-      scope = g ? "global" : "project";
-    } else scope = "project";
+    const scopeItems = installed.length > 0
+      ? [
+          { label: "Global  — install into the user config of detected CLIs (user-wide)" },
+          { label: "Project — install into a specific project directory" },
+        ]
+      : [
+          { label: "Project — install into a specific project directory" },
+          { label: "Global  — install into the user config of detected CLIs" },
+        ];
+    const idx = await selectMenu("Where do you want to install?", scopeItems);
+    scope = scopeItems[idx].label.startsWith("Global") ? "global" : "project";
   } else {
-    // Non-interactive default: project scope.
-    scope = "project";
+    scope = "project"; // non-interactive default
   }
 
   // 3. Target
@@ -269,7 +471,7 @@ Examples:
   log("→", `Target: ${target}`);
   console.log("");
 
-  // 4. Which adapters?
+  // 4. Which adapters — checkbox multi-select (interactive) or flags/default.
   let chosen;
   if (toolList) {
     const want = toolList.split(",").map((s) => s.trim()).filter(Boolean);
@@ -277,52 +479,86 @@ Examples:
   } else if (installAll) {
     chosen = scope === "global" && installed.length ? installed : ADAPTERS;
   } else if (interactive) {
-    const all = await askYesNo(rl, "Install ALL adapters (claude/codex/opencode/cursor)?", true);
-    if (all) {
-      chosen = scope === "global" && installed.length ? installed : ADAPTERS;
-    } else if (scope === "global" && installed.length) {
-      chosen = [];
-      for (const a of installed) {
-        if (await askYesNo(rl, `  Install ${a.name}?`, true)) chosen.push(a);
-      }
-    } else {
-      chosen = [];
-      for (const a of ADAPTERS) {
-        if (await askYesNo(rl, `  Install ${a.name} adapter?`, false)) chosen.push(a);
-      }
-    }
+    // Build checkbox items. Detected CLIs are pre-checked; others unchecked.
+    const detectedKeys = new Set(installed.map((a) => a.key));
+    const items = ADAPTERS.map((a) => ({
+      label: a.name,
+      hint: detectedKeys.has(a.key) ? "detected" : (existsSync(join(PKG_ROOT, a.dir)) ? "available" : "not shipped yet"),
+      checked: detectedKeys.has(a.key),
+    }));
+    const pickedIdx = await checkboxMenu("Select which CLI adapters to install:", items);
+    chosen = pickedIdx.map((i) => ADAPTERS[i]);
   } else {
-    // Non-interactive default: all detected CLIs (global) or all adapters (project).
     chosen = scope === "global" && installed.length ? installed : ADAPTERS;
   }
 
+  // 4b. For plugin-capable adapters, ask: install as plugin (show commands) or copy files?
+  // npx cannot run a CLI's internal /plugin command, so "plugin" means: print the
+  // exact commands for the user to run inside their CLI, and skip file copy.
+  const installMethod = new Map(); // adapter.key -> "plugin" | "files"
+  const pluginCapable = chosen.filter((a) => a.pluginCapable);
+  if (interactive && pluginCapable.length > 0) {
+    console.log("");
+    for (const a of pluginCapable) {
+      const idx = await selectMenu(
+        `${a.name} supports plugins (auto-updates, namespaced). How to install?`,
+        [
+          { label: `Plugin  — I'll run the /plugin commands in ${a.name} (recommended)` },
+          { label: "Files   — copy the adapter files directly (no auto-updates)" },
+        ],
+      );
+      installMethod.set(a.key, idx === 0 ? "plugin" : "files");
+    }
+  } else {
+    for (const a of chosen) installMethod.set(a.key, "files");
+  }
+
   // 5. Init .cto/ state
   let initCto;
   if (scope !== "project") {
     initCto = false;
   } else if (interactive) {
-    initCto = await askYesNo(rl, "Initialize .cto/ state files in the project?", true);
+    const idx = await selectMenu("Initialize .cto/ state files in the project?", [
+      { label: "Yes — create .cto/ state files" },
+      { label: "No  — skip state init" },
+    ]);
+    initCto = idx === 0;
   } else {
-    initCto = true; // non-interactive default for project scope
+    initCto = true;
   }
-
-  if (rl) rl.close();
   console.log("");
   console.log("  ── Installing ──────────────────────────────────────────────");
 
   installConstitution(target, force);
   if (scope === "project") installSrc(target, force);
-  for (const a of chosen) installAdapter(a, scope, force);
+  for (const a of chosen) {
+    if (installMethod.get(a.key) === "plugin") {
+      log("⏭", `${a.name}: skipped file copy — install via plugin commands below`);
+    } else {
+      installAdapter(a, scope, force);
+    }
+  }
   if (initCto) initState(target, force);
 
   console.log("");
   console.log("  ✅ Done.");
   console.log("");
   // Per-CLI next steps: each tool has a different plugin model.
-  console.log("  Next steps per installed CLI:");
+  console.log("  Next steps per selected CLI:");
   for (const a of chosen) {
     console.log(`  ── ${a.name} ──`);
-    console.log(`    ${a.pluginNote}`);
+    if (installMethod.get(a.key) === "plugin") {
+      console.log(`    Install as a plugin (run inside ${a.name}):`);
+      for (const c of (a.pluginCmds || [])) console.log(`      ${c}`);
+    } else if (a.key === "codex") {
+      console.log(`    Codex plugin (.codex-plugin/) copied — Codex auto-detects it.`);
+    } else if (a.key === "opencode") {
+      console.log(`    OpenCode agents/rules copied (OpenCode plugins are JS hooks, separate).`);
+    } else if (a.key === "cursor") {
+      console.log(`    Cursor plugin (.cursor-plugin/) copied — Cursor auto-detects it.`);
+    } else {
+      console.log(`    Adapter files copied into ${scope === "global" ? a.globalDir() : "the project"}.`);
+    }
     console.log("");
   }
   console.log("  Then start the CTO's daily loop:");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cto-agent-system",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "An autonomous software company: CEO (you) + CTO/CPO/CMO leading 15 specialist agents. Run /cto and the CTO takes over — digests the project, fixes fires, improves the product, reports back with a roadmap.",
   "license": "MIT",
   "author": {