great-cto 2.8.4 → 2.8.6

package/dist/adapt.js

@@ -1,23 +1,10 @@
-// great-cto adapt — platform config generator.
+// great-cto adapt — Claude Code config generator.
 //
-// Writes platform-native config files derived from a shared core. Lets a
-// single great_cto installation work transparently with Claude Code, OpenAI
-// Codex CLI, Cursor, Aider, and Continue. AGENTS.md is the de-facto cross-
-// platform standard (used verbatim by Codex; consumed as fallback by most
-// others) so it forms the shared core.
+// Writes CLAUDE.md + AGENTS.md from .great_cto/PROJECT.md context.
 //
 // Usage:
-//   great-cto adapt --platform claude     CLAUDE.md
-//   great-cto adapt --platform codex      AGENTS.md
-//   great-cto adapt --platform cursor     .cursorrules + .cursor/rules/*.mdc
-//   great-cto adapt --platform aider      .aider.conf.yml + CONVENTIONS.md
-//   great-cto adapt --platform continue   .continue/rules.md
-//   great-cto adapt --platform all        all of the above
-//   great-cto adapt --dry-run             show what would be written
-//
-// Each adapter writes ONLY platform-native files. All share the AGENTS.md
-// core text via getAgentsCore(). To customize per-project, edit
-// .great_cto/PROJECT.md (archetype, owners, compliance) — adapt re-derives.
+//   great-cto adapt            Generate CLAUDE.md + AGENTS.md
+//   great-cto adapt --dry-run  Show what would be written
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 function readProjectMeta(cwd) {
@@ -36,8 +23,7 @@ function readProjectMeta(cwd) {
     return { archetype, compliance, owners, hasGreatCto: true };
 }
 /**
- * Common AGENTS.md content used across platforms.
- * Codex CLI reads this verbatim. Cursor / Aider / Claude Code embed it.
+ * AGENTS.md — Claude Code reads this as the cross-tool agent contract.
  */
 function getAgentsCore(meta) {
     const compliance = meta.compliance.length > 0
@@ -45,10 +31,8 @@ function getAgentsCore(meta) {
         : "_(none auto-detected — set in .great_cto/PROJECT.md)_";
     return `# AGENTS.md
 
-> This file is the cross-tool agent contract. It is consumed by OpenAI Codex
-> CLI, Claude Code, Cursor, Aider, Continue, and any other AGENTS.md-aware
-> tooling. Generated by \`great-cto adapt\` — re-run after editing
-> \`.great_cto/PROJECT.md\`.
+> Project agent contract for Claude Code. Generated by \`great-cto adapt\` —
+> re-run after editing \`.great_cto/PROJECT.md\`.
 
 ## Project context
 
@@ -80,7 +64,7 @@ Override with \`/waiver\` and a written reason. Auto-expires in 14 days.
 
 ## Available tools (via MCP)
 
-When this repo is opened in any MCP-capable tool, \`great-cto mcp\` exposes:
+When this repo is opened in Claude Code, \`great-cto mcp\` exposes:
 
 - \`scan\` — OWASP LLM Top 10 + 24 rules · returns findings
 - \`list_rules\` — full rule catalogue
@@ -88,7 +72,7 @@ When this repo is opened in any MCP-capable tool, \`great-cto mcp\` exposes:
 - \`estimate_cost\` — LLM vs human time estimate for a task
 - \`query_decisions\` — search ADR log
 
-Configure your client to launch:
+Configure Claude Code to launch:
 \`\`\`bash
 npx great-cto mcp
 \`\`\`
@@ -131,17 +115,14 @@ function writeFile(path, content, dryRun) {
     console.log(`  ${existed ? "✎ updated" : "✓ wrote"}  ${path}`);
     return true;
 }
-// ── Per-platform adapters ──────────────────────────────────────────────────
+// ── Claude Code adapter ────────────────────────────────────────────────────
 function adaptClaude(cwd, meta, dryRun) {
-    // Claude Code reads CLAUDE.md (or AGENTS.md as fallback). We write both
-    // for maximum compat — projects with CLAUDE.md already get a top-level
-    // reference, and AGENTS.md unlocks any AGENTS.md-aware tool simultaneously.
     const out = [];
     const agentsBody = getAgentsCore(meta);
     const claudeBody = `# CLAUDE.md
 
 > Project guidance for Claude Code. The full agent contract lives in
-> \`AGENTS.md\` — please read that first. This file adds Claude-Code-specific
+> \`AGENTS.md\` — please read that first. This file adds Claude Code-specific
 > overrides only.
 
 ## Cross-tool contract
@@ -160,9 +141,9 @@ conventions. Generated by \`great-cto adapt\`.
 
 ## Quick links
 
-- ${"`"}/start "..."${"`"} — kick off a feature pipeline
-- ${"`"}/inbox${"`"} — see what needs your decision
-- ${"`"}/agent-review${"`"} — performance scorecard for agents
+- \`/start "..."\` — kick off a feature pipeline
+- \`/inbox\` — see what needs your decision
+- \`/agent-review\` — performance scorecard for agents
 
 `;
     if (writeFile(join(cwd, "AGENTS.md"), agentsBody, dryRun))
@@ -171,141 +152,6 @@ conventions. Generated by \`great-cto adapt\`.
         out.push("CLAUDE.md");
     return out;
 }
-function adaptCodex(cwd, meta, dryRun) {
-    // OpenAI Codex CLI reads AGENTS.md. We write only that — Codex doesn't
-    // currently consume CLAUDE.md / .cursorrules.
-    const out = [];
-    if (writeFile(join(cwd, "AGENTS.md"), getAgentsCore(meta), dryRun))
-        out.push("AGENTS.md");
-    return out;
-}
-function adaptCursor(cwd, meta, dryRun) {
-    // Cursor reads .cursorrules (legacy single file) and .cursor/rules/*.mdc
-    // (modern modular). Write both for compat.
-    const out = [];
-    const rulesContent = `# Cursor rules — auto-generated by great-cto adapt
-# See AGENTS.md for the full agent contract; this file is the Cursor-native
-# subset focusing on inline-completion and chat behaviour.
-
-archetype: ${meta.archetype}
-compliance:
-${meta.compliance.map(c => `  - ${c}`).join("\n") || "  - none"}
-
-## Behaviour
-
-Before suggesting code changes:
-- Read \`AGENTS.md\` for repo-wide conventions
-- Read \`.great_cto/PROJECT.md\` for archetype constraints
-- Check \`~/.great_cto/decisions.md\` for prior ADRs on the topic
-
-## Gates that block merges (do not bypass)
-
-- security-officer: auth/payments/PII changes
-- qa-engineer: feature merges
-- db-migration-reviewer: any migrations/ change
-
-## Style
-
-- TDD: tests RED → implementation GREEN → refactor
-- Conventional commits
-- One concern per PR
-`;
-    const mdcContent = `---
-description: great_cto archetype + compliance contract
-globs: ["**/*"]
-alwaysApply: true
----
-
-This repo is a **${meta.archetype}** project. Compliance gates:
-${meta.compliance.map(c => `- ${c}`).join("\n") || "- none"}
-
-Read \`AGENTS.md\` and \`.great_cto/PROJECT.md\` before proposing changes.
-Run \`npx great-cto ci\` before pushing.
-`;
-    if (writeFile(join(cwd, ".cursorrules"), rulesContent, dryRun))
-        out.push(".cursorrules");
-    if (writeFile(join(cwd, ".cursor", "rules", "great-cto.mdc"), mdcContent, dryRun))
-        out.push(".cursor/rules/great-cto.mdc");
-    if (writeFile(join(cwd, "AGENTS.md"), getAgentsCore(meta), dryRun))
-        out.push("AGENTS.md");
-    return out;
-}
-function adaptAider(cwd, meta, dryRun) {
-    // Aider reads .aider.conf.yml for settings and CONVENTIONS.md (or files
-    // listed in read: arrays) for context.
-    const out = [];
-    const conf = `# .aider.conf.yml — auto-generated by great-cto adapt
-# Aider config. Run aider in this dir and these settings apply.
-
-# Always include AGENTS.md and PROJECT.md as context
-read:
-  - AGENTS.md
-  - .great_cto/PROJECT.md
-
-# Auto-test after edits
-auto-test: true
-test-cmd: "npx great-cto ci --severity high"
-
-# Pretty output
-pretty: true
-
-# Conventional commits
-commit-prompt: "Use conventional commit format: feat/fix/docs/refactor/test/chore"
-
-# Archetype: ${meta.archetype}
-# Compliance: ${meta.compliance.join(", ") || "none"}
-`;
-    const conventions = `# CONVENTIONS.md
-
-> This is the Aider-native conventions file. The cross-tool agent contract
-> lives in \`AGENTS.md\` — please read that for full context.
-
-## Quick rules
-
-- **Archetype:** ${meta.archetype}
-- **Compliance gates:** ${meta.compliance.join(", ") || "_(none)_"}
-
-### Process
-1. Tests first (TDD)
-2. One concern per PR
-3. Conventional commits
-4. Run \`npx great-cto ci\` before push
-
-### Style
-- No secrets in code (\`great-cto scan\` enforces this)
-- Read \`.great_cto/PROJECT.md\` before suggesting architectural changes
-- Read \`~/.great_cto/decisions.md\` for prior ADRs
-`;
-    if (writeFile(join(cwd, ".aider.conf.yml"), conf, dryRun))
-        out.push(".aider.conf.yml");
-    if (writeFile(join(cwd, "CONVENTIONS.md"), conventions, dryRun))
-        out.push("CONVENTIONS.md");
-    if (writeFile(join(cwd, "AGENTS.md"), getAgentsCore(meta), dryRun))
-        out.push("AGENTS.md");
-    return out;
-}
-function adaptContinue(cwd, meta, dryRun) {
-    const out = [];
-    const rulesContent = `# Continue rules — generated by great-cto adapt
-
-## Project context
-
-Archetype: **${meta.archetype}**.
-Compliance: ${meta.compliance.join(", ") || "none"}.
-Read \`AGENTS.md\` for the full contract.
-
-## Behaviour
-
-- Run \`npx great-cto ci\` before pushing
-- Don't bypass gates (security / qa / db-migration)
-- Append lessons to \`.great_cto/lessons.md\` after incidents
-`;
-    if (writeFile(join(cwd, ".continue", "rules.md"), rulesContent, dryRun))
-        out.push(".continue/rules.md");
-    if (writeFile(join(cwd, "AGENTS.md"), getAgentsCore(meta), dryRun))
-        out.push("AGENTS.md");
-    return out;
-}
 // ── Main entry ─────────────────────────────────────────────────────────────
 export async function runAdapt(args) {
     const meta = readProjectMeta(args.cwd);
@@ -314,28 +160,13 @@ export async function runAdapt(args) {
         console.error("Run `npx great-cto init` first to bootstrap the project.");
         return 1;
     }
-    const platforms = args.platform === "all"
-        ? ["claude", "codex", "cursor", "aider", "continue"]
-        : [args.platform];
-    console.log(`great-cto adapt → ${platforms.join(", ")}${args.dryRun ? " (dry-run)" : ""}`);
+    console.log(`great-cto adapt → claude${args.dryRun ? " (dry-run)" : ""}`);
     console.log(`  archetype: ${meta.archetype}  compliance: ${meta.compliance.join(", ") || "none"}`);
     console.log("");
-    const written = [];
-    for (const p of platforms) {
-        console.log(`▸ ${p}`);
-        const adapter = {
-            claude: adaptClaude,
-            codex: adaptCodex,
-            cursor: adaptCursor,
-            aider: adaptAider,
-            continue: adaptContinue,
-        }[p];
-        const out = adapter(args.cwd, meta, args.dryRun);
-        written.push(...out);
-    }
+    const written = adaptClaude(args.cwd, meta, args.dryRun);
     if (!args.dryRun) {
         console.log("");
-        console.log(`✓ generated ${written.length} file(s) for ${platforms.length} platform(s).`);
+        console.log(`✓ generated ${written.length} file(s).`);
         console.log(`  Re-run after editing .great_cto/PROJECT.md to refresh.`);
     }
     return 0;

package/dist/ci.js

@@ -116,7 +116,7 @@ async function archetypeCheck(cwd, quiet) {
                 ok: false,
                 msg: `archetype drift: declared=${declared}, detected=${result.primary} (${result.confidence}). ` +
                     `Either:\n` +
-                    `      • run 'npx great-cto adapt --platform <yours>' to refresh configs after intentional change, or\n` +
+                    `      • run 'npx great-cto adapt' to refresh CLAUDE.md + AGENTS.md after intentional change, or\n` +
                     `      • run 'npx great-cto init --force --archetype ${result.primary}' to align PROJECT.md with the codebase, or\n` +
                     `      • pass '--no-archetype' to ci to skip this check (e.g. during transitional refactors)`,
             };

package/dist/main.js

@@ -66,6 +66,8 @@ function parseArgs(argv) {
             args.version = argv[++i] ?? null;
         else if (a === "--port")
             args.boardPort = parseInt(argv[++i] ?? "3141", 10);
+        else if (a.startsWith("--port="))
+            args.boardPort = parseInt(a.slice("--port=".length), 10);
         else if (a === "--no-open")
             args.boardNoOpen = true;
         else if (a === "--use-llm")
@@ -111,6 +113,16 @@ function parseArgs(argv) {
         else if (a === "init" || a === "help" || a === "version") {
             args.command = a;
         }
+        else if (!a.startsWith("-") && args.command === "init" && i === 0) {
+            // First positional that isn't a recognised subcommand → unknown
+            args.command = "unknown";
+            args.unknownToken = a;
+        }
+        else if (a.startsWith("--") && args.command === "init") {
+            // Unknown long flag in init position → unknown
+            args.command = "unknown";
+            args.unknownToken = a;
+        }
         else
             rest.push(a);
     }
@@ -340,7 +352,7 @@ ${bold("Usage:")}
   npx great-cto list-rules
   npx great-cto ci [path] [--fail-on LVL] [--sarif F] [--junit F]
   npx great-cto mcp [--sse --port N]
-  npx great-cto adapt --platform [claude|codex|cursor|aider|continue|all]
+  npx great-cto adapt [--dry-run]
   npx great-cto serve [--port 3142]
   npx great-cto help
   npx great-cto version
@@ -372,18 +384,14 @@ ${bold("CI gate:")}
   ${dim("(auto-detects \$GITHUB_ACTIONS → emits ::error:: annotations)")}
 
 ${bold("MCP server (cross-platform):")}
-  great-cto mcp                        Stdio MCP server — works in Claude Desktop /
-                                       Cursor / Continue / any MCP host
+  great-cto mcp                        Stdio MCP server — works in Claude Code /
+                                       Claude Desktop / any MCP host
   great-cto mcp --sse --port 8765      SSE mode for remote / multi-client (TODO v2.5)
   ${dim("Tools exposed: scan, list_rules, detect_archetype, estimate_cost, query_decisions")}
 
-${bold("Platform adapter (multi-tool support):")}
-  great-cto adapt --platform claude    Generate AGENTS.md + CLAUDE.md
-  great-cto adapt --platform codex     Generate AGENTS.md (OpenAI Codex CLI)
-  great-cto adapt --platform cursor    Generate .cursorrules + .cursor/rules/*.mdc
-  great-cto adapt --platform aider     Generate .aider.conf.yml + CONVENTIONS.md
-  great-cto adapt --platform continue  Generate .continue/rules.md
-  great-cto adapt --platform all       All of the above
+${bold("Claude Code adapter:")}
+  great-cto adapt                      Generate AGENTS.md + CLAUDE.md
+  great-cto adapt --dry-run            Preview what would be written
   ${dim("Idempotent — re-run after editing .great_cto/PROJECT.md")}
 
 ${bold("Webhook server (preview):")}
@@ -760,6 +768,13 @@ async function main() {
         printHelp();
         process.exit(0);
     }
+    if (args.command === "unknown") {
+        const tok = args.unknownToken ?? "<arg>";
+        error(`great-cto: unknown command or flag '${tok}'`);
+        log("");
+        log(`Run ${cyan("great-cto --help")} for usage.`);
+        process.exit(2);
+    }
     if (args.command === "scan") {
         try {
             const code = await runScan(args, rawArgv);
@@ -828,15 +843,8 @@ async function main() {
     if (args.command === "adapt") {
         try {
             const { runAdapt } = await import("./adapt.js");
-            const platArg = rawArgv.indexOf("--platform");
-            const platform = (platArg >= 0 ? rawArgv[platArg + 1] : "all");
-            const valid = ["claude", "codex", "cursor", "aider", "continue", "all"];
-            if (!valid.includes(platform)) {
-                error(`adapt: --platform must be one of ${valid.join(", ")} (got: ${platform})`);
-                process.exit(2);
-            }
             const code = await runAdapt({
-                platform,
+                platform: "claude",
                 dryRun: rawArgv.includes("--dry-run"),
                 cwd: args.dir,
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "great-cto",
-  "version": "2.8.4",
+  "version": "2.8.6",
   "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",