cto-agent-system 1.0.0 → 1.2.0

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.0.0",
+      "version": "1.2.0",
       "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.0.0",
+  "version": "1.2.0",
   "author": {
     "name": "xenitV1",
     "url": "https://github.com/xenitV1"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cto-agent-system",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "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.0.0",
+  "version": "1.2.0",
   "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.0.0",
+  "version": "1.2.0",
   "author": {
     "name": "xenitV1",
     "url": "https://github.com/xenitV1"

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xenitV1
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,11 @@
 # Software Company Agent System
 
+[![npm version](https://img.shields.io/npm/v/cto-agent-system.svg?style=flat&color=cb3837)](https://www.npmjs.com/package/cto-agent-system)
+[![npm downloads](https://img.shields.io/npm/dm/cto-agent-system.svg?style=flat&color=cb3837)](https://www.npmjs.com/package/cto-agent-system)
+[![GitHub release](https://img.shields.io/github/v/release/xenitV1/cto-agent-system?style=flat&color=181717)](https://github.com/xenitV1/cto-agent-system/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat)](https://github.com/xenitV1/cto-agent-system/blob/main/LICENSE)
+[![CI](https://github.com/xenitV1/cto-agent-system/actions/workflows/ci.yml/badge.svg)](https://github.com/xenitV1/cto-agent-system/actions/workflows/ci.yml)
+
 **A software company you own, but don't run.**
 
 Type `/cto` in the morning and say "good morning, start working". The CTO takes over: digests the project, decides what needs doing on its own, coordinates the team (CTO/CPO/CMO + specialists), improves code and product, and hands you a daily report + roadmap in the evening. You're the CEO (owner); they run the company.
@@ -8,6 +14,12 @@ This is **not a feature-request system**. It's an **autonomous software company*
 
 Works in **Claude Code, Codex, and OpenCode** (Cursor / Copilot adapters planned). Zero runtime — just markdown + one install script.
 
+> 📦 **npm:** [cto-agent-system](https://www.npmjs.com/package/cto-agent-system) ·
+> 🐙 **GitHub:** [xenitV1/cto-agent-system](https://github.com/xenitV1/cto-agent-system) ·
+> 🚀 **Releases:** [v1.0.0](https://github.com/xenitV1/cto-agent-system/releases) ·
+> 📖 **Vision:** [VISION.md](VISION.md) ·
+> 🛡️ **Security:** [SECURITY.md](SECURITY.md)
+
 ---
 
 ## Why
@@ -171,12 +183,23 @@ Borrowed the best ideas from proven systems (studied from their source):
 
 ## Status
 
-**Phase 1 (MVP):** ✅ Core doctrine, 15 agents, 20 skills, state system, 3 CLI adapters, installer.
-**Phase 2 (planned):** UX/accessibility lens skills, Cursor/Copilot adapters, evals.
+**Phase 1 (MVP):** ✅ Core doctrine, 15 agents, 22 skills (incl. bootstrap + secure-branch + self-improvement), state system, 3 CLI adapters + Cursor plugin manifest, SessionStart hook, npx installer.
+**Phase 2 (planned):** UX/accessibility lens skills, Cursor/Copilot adapters, evals, self-improvement feedback aggregators.
 **Phase 3 (optional):** Kanban UI, cron autonomy (runs while you're away), multi-project.
 
 ---
 
+## Contributing
+
+Contributions welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md). Please read the [`VISION.md`](VISION.md) and the constitution ([`AGENTS.md`](AGENTS.md)) first; changes that affect agent behavior are high-stakes and should be discussed in an issue before a PR.
+
+- 🐛 [Report a bug](https://github.com/xenitV1/cto-agent-system/issues/new?template=bug_report.md)
+- 💡 [Request a feature](https://github.com/xenitV1/cto-agent-system/issues/new?template=feature_request.md)
+- 🛡️ [Security policy](SECURITY.md)
+- 📜 [Code of Conduct](CODE_OF_CONDUCT.md)
+
+---
+
 ## License
 
-MIT — see `LICENSE`.
+MIT © [xenitV1](https://github.com/xenitV1) — see [`LICENSE`](LICENSE).

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/).
@@ -57,10 +58,26 @@ function hasCommand(cmd) {
 }
 
 const ADAPTERS = [
-  { key: "claude",  name: "Claude Code",   dir: ".claude",  cmds: ["claude"],  globalDir: () => join(homedir(), ".claude") },
-  { key: "codex",   name: "OpenAI Codex",  dir: ".codex",   cmds: ["codex"],   globalDir: () => join(homedir(), ".codex") },
-  { key: "opencode",name: "OpenCode",      dir: ".opencode",cmds: ["opencode"],globalDir: () => join(homedir(), ".config", "opencode") },
-  { key: "cursor",  name: "Cursor",        dir: ".cursor",  cmds: ["cursor"],  globalDir: () => join(homedir(), ".cursor") },
+  {
+    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",
+  },
+  {
+    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.",
+  },
+  {
+    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).",
+  },
+  {
+    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.",
+  },
 ];
 
 function detectInstalledClis() {
@@ -84,6 +101,174 @@ async function askYesNo(rl, question, defaultYes = true) {
   return answer === "y" || answer === "yes";
 }
 
+// ---------------------------------------------------------------------------
+// Interactive multi-select (arrow keys + space to toggle + enter to confirm)
+// Zero-dependency: drives raw TTY mode directly. Falls back to a numbered
+// prompt when stdin is not a TTY (piped/CI).
+// ---------------------------------------------------------------------------
+
+const ESC = "\x1b[";
+
+function hideCursor() { stdout.write(`${ESC}?25l`); }
+function showCursor() { stdout.write(`${ESC}?25h`); }
+function clearMenu(lines) { stdout.write(`${ESC}${lines}A${ESC}J`); } // move up, clear down
+function writeLine(s) { stdout.write(`${s}\r\n`); }
+
+/**
+ * Render a multi-select menu.
+ * @param {string} title    Prompt header.
+ * @param {{label:string, hint?:string, checked:boolean}[]} items
+ * @param {boolean} allowToggle  If false, behaves like a single-select.
+ * @returns {Promise<number[]>}  Indices of checked items (on confirm).
+ */
+function checkboxMenu(title, items, { allowToggle = true } = {}) {
+  return new Promise((resolvePromise) => {
+    // Non-TTY fallback: numbered prompt.
+    const isTTY = stdin.isTTY && stdin instanceof ReadStream;
+    if (!isTTY) {
+      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': `
+        )).trim().toLowerCase();
+        rl.close();
+        if (ans === "all" || ans === "") return items.map((_, i) => i);
+        const picked = ans.split(/[,\s]+/).map((n) => parseInt(n, 10) - 1)
+          .filter((n) => n >= 0 && n < items.length);
+        return picked;
+      };
+      fallback().then(resolvePromise);
+      return;
+    }
+
+    let cursor = 0;
+    const state = items.map((it) => !!it.checked);
+    const headerLines = title.split("\n").length + 1; // title + blank
+
+    const render = () => {
+      writeLine(title);
+      writeLine("  (↑/↓ 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}` : "";
+        writeLine(`  ${arrow} ${box} ${it.label}${hint}`);
+      });
+    };
+
+    // Render once, then capture how many lines we wrote so we can clear on re-render.
+    let lastLines = 0;
+    const paint = () => {
+      if (lastLines > 0) clearMenu(lastLines);
+      const before = stdout.rows; // unused; we count lines instead
+      const lineCount = headerLines + 1 + items.length; // title(=headerLines) + hint + items
+      render();
+      lastLines = lineCount;
+    };
+
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    hideCursor();
+    paint();
+
+    const onData = (ch) => {
+      // Ctrl-C
+      if (ch === "\x03") { cleanup(); process.exit(0); }
+      // Enter
+      if (ch === "\r" || ch === "\n") {
+        cleanup();
+        const result = items.map((_, i) => i).filter((i) => state[i]);
+        resolvePromise(result);
+        return;
+      }
+      // 'a' = toggle all
+      if (ch === "a" || ch === "A") {
+        const allOn = state.every(Boolean);
+        for (let i = 0; i < state.length; i++) state[i] = !allOn;
+        paint();
+        return;
+      }
+      // space = toggle current
+      if (ch === " ") {
+        if (allowToggle) { state[cursor] = !state[cursor]; paint(); }
+        return;
+      }
+      // arrows
+      if (ch === `${ESC}A`) { cursor = (cursor - 1 + items.length) % items.length; paint(); return; } // up
+      if (ch === `${ESC}B`) { cursor = (cursor + 1) % items.length; paint(); return; } // down
+    };
+
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      stdin.setRawMode(false);
+      stdin.pause();
+      showCursor();
+    };
+
+    stdin.on("data", onData);
+  });
+}
+
+/**
+ * Single-select menu (arrows + enter). Returns chosen index.
+ */
+function selectMenu(title, items) {
+  return new Promise((resolvePromise) => {
+    const isTTY = stdin.isTTY && stdin instanceof ReadStream;
+    if (!isTTY) {
+      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;
+    let lastLines = 0;
+    const paint = () => {
+      if (lastLines > 0) clearMenu(lastLines);
+      writeLine(title);
+      writeLine("  (↑/↓ move, enter select)");
+      items.forEach((it, i) => {
+        const arrow = i === cursor ? "❯" : " ";
+        writeLine(`  ${arrow} ${it.label}`);
+      });
+      lastLines = 1 + 1 + items.length;
+    };
+
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    hideCursor();
+    paint();
+
+    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; paint(); return; }
+      if (ch === `${ESC}B`) { cursor = (cursor + 1) % items.length; paint(); return; }
+    };
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      stdin.setRawMode(false);
+      stdin.pause();
+      showCursor();
+    };
+    stdin.on("data", onData);
+  });
+}
+
 // ---------------------------------------------------------------------------
 // File helpers
 // ---------------------------------------------------------------------------
@@ -220,20 +405,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
@@ -253,7 +443,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);
@@ -261,22 +451,16 @@ 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;
   }
 
@@ -285,12 +469,14 @@ Examples:
   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 ──────────────────────────────────────────────");
 
@@ -302,19 +488,23 @@ Examples:
   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:");
+  for (const a of chosen) {
+    console.log(`  ── ${a.name} ──`);
+    console.log(`    ${a.pluginNote}`);
+    console.log("");
+  }
+  console.log("  Then start the CTO's daily loop:");
   if (scope === "global") {
-    console.log("  Next steps:");
     console.log("    • Open any project in your CLI.");
-    console.log("    • Run:  /cto good morning, start working");
-    console.log("    • The CTO digests the project and runs the autonomous loop.");
   } else {
-    console.log("  Next steps:");
     console.log(`    • cd ${target}`);
-    console.log("    • Open it in your CLI (claude / codex / opencode).");
-    console.log("    • Run:  /cto good morning, start working");
   }
+  console.log("    • Run:  /cto good morning, start working");
+  console.log("    • The CTO runs Phase 0 (secure-branch) → Digest → Prioritize → ... → Report.");
   console.log("");
-  console.log("  Docs: AGENTS.md (constitution), VISION.md (why), src/state/protocol.md (the loop).");
+  console.log("  Docs: AGENTS.md (constitution), src/state/protocol.md (the loop).");
   console.log("");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cto-agent-system",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "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": {