great-cto 2.5.5 → 2.5.6

package/dist/archetypes.js

@@ -156,9 +156,30 @@ const RULES = [
                 s += 6; // explicit agent framework
             if ((hasLlm || hasLlmFw) && hasAgentFw)
                 s += 2; // bonus
-            // README mining hint
-            if (d.readmeKeywords.includes("agent") || d.readmeKeywords.includes("ai"))
+            // Project-shape signals (agent-runtime archetypes that don't depend
+            // on a specific framework — e.g. a deterministic local agent runtime
+            // built from scratch). Each signal is weak; multiple together strong.
+            const kws = d.readmeKeywords.map((k) => k.toLowerCase());
+            const agentRuntimeKws = [
+                "agent", "agent-runtime", "agent_runtime", "agentic",
+                "tool-calling", "tool-use", "tool_use", "tool-registry",
+                "planner", "agent-loop", "agent-runtime", "deterministic-agent",
+                "plan-step", "planstep", "tool-allowlist", "agent-budget",
+                "mcp-server", "mcp-client", "mcp",
+            ];
+            const matchedAgentKws = agentRuntimeKws.filter((k) => kws.includes(k));
+            if (matchedAgentKws.length >= 3)
+                s += 5; // strong shape signal
+            else if (matchedAgentKws.length === 2)
+                s += 3;
+            else if (matchedAgentKws.length === 1)
                 s += 1;
+            // Stack-name patterns: agent-runtime / agent-product (the user
+            // explicitly named their library/package after agent or runtime).
+            // Detected via signals — d.stack includes the package name as a token.
+            const stackJoined = d.stack.join(" ").toLowerCase();
+            if (/(?:^| )agent[-_](?:runtime|product|loop|kit|sdk)/.test(stackJoined))
+                s += 2;
             return s;
         },
         reason: (d) => {

package/dist/ci.js

@@ -114,7 +114,11 @@ async function archetypeCheck(cwd, quiet) {
         if (result.primary !== declared) {
             return {
                 ok: false,
-                msg: `archetype drift: declared=${declared}, detected=${result.primary} (${result.confidence})`,
+                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 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)`,
             };
         }
         return { ok: true, msg: `archetype confirmed: ${declared}` };

package/dist/main.js

@@ -95,6 +95,18 @@ function parseArgs(argv) {
             args.command = "webhook";
         else if (a === "report")
             args.command = "report";
+        // Slash-commands surfaced as CLI subcommands so users get a clear hint
+        // instead of a confusing usage error. These work only in the chat plugin.
+        else if (a === "start" || a === "audit" || a === "inbox" || a === "digest" ||
+            a === "review" || a === "doctor" || a === "burn" || a === "save" ||
+            a === "resume" || a === "learn" || a === "agent-review" || a === "agent-retire" ||
+            a === "rfc" || a === "release" || a === "ownership" || a === "oncall" ||
+            a === "sec" || a === "poc" || a === "promote" || a === "crystallize" ||
+            a === "migrate") {
+            args.command = "chat-only-hint";
+            // Stash which command they tried so we can quote it back
+            args._slashTried = a;
+        }
         else if (a.startsWith("--dir="))
             args.dir = a.slice("--dir=".length);
         else if (a === "--dir")
@@ -417,16 +429,45 @@ ${bold("Links:")}
 async function runInit(args) {
     banner();
     // ── 1. detect ────────────────────────────────────────────
+    // Guard: refuse to init in $HOME or other "obviously not a project" locations.
+    // Most projects have at least one of: package.json / pyproject.toml /
+    // Cargo.toml / go.mod / .git / src/. Without any signal we'd default to
+    // greenfield with low confidence, which leaves users confused.
+    const HOME = process.env.HOME || process.env.USERPROFILE || "";
+    if (args.dir === HOME) {
+        error(`refusing to initialize great_cto in $HOME (${HOME}).`);
+        log("");
+        log(`great_cto is meant to run inside a project repository, not your home directory.`);
+        log(`If you're testing the install, ${cyan("cd")} into a real repo first:`);
+        log("");
+        log(`    ${cyan("cd /path/to/your/project")}`);
+        log(`    ${cyan("npx great-cto init")}`);
+        log("");
+        log(`Or create an empty test project:`);
+        log("");
+        log(`    ${cyan("mkdir /tmp/test-greatcto && cd /tmp/test-greatcto && git init")}`);
+        log(`    ${cyan("npx great-cto init")}`);
+        return 2;
+    }
     step(1, 5, `scanning ${args.dir}`);
     const detection = detect(args.dir);
     if (detection.hasExistingGreatCto) {
         warn(".great_cto/ already exists in this directory.");
-        warn("If you're re-initializing, back it up first or run with --force.");
+        log("");
+        log(`To preserve existing config: nothing to do, you're already initialized.`);
+        log(`To start fresh: back up ${cyan(".great_cto/")} first, then re-run with ${cyan("--force")}:`);
+        log("");
+        log(`    ${cyan("npx great-cto init --force")}`);
+        log("");
+        log(`To override the detected archetype without re-init:`);
+        log("");
+        log(`    ${cyan("npx great-cto init --force --archetype agent-product")}`);
+        log("");
         if (!args.yes && !args.force) {
-            const ok = await confirm("Continue anyway?", false);
+            const ok = await confirm("Continue anyway? (existing PROJECT.md will be kept as-is)", false);
             if (!ok) {
-                log("Aborted.");
-                return 1;
+                log(yellow("Aborted. (Not an error — your existing config is intact.)"));
+                return 0; // exit 0 — user-initiated abort is not a failure
             }
         }
     }
@@ -865,6 +906,22 @@ async function main() {
             process.exit(2);
         }
     }
+    if (args.command === "chat-only-hint") {
+        const tried = args._slashTried || "<command>";
+        error(`'${tried}' is a chat slash command, not a CLI subcommand.`);
+        log("");
+        log(`To run it, open Claude Code, Cursor, or any AI assistant that has`);
+        log(`great_cto installed and type:`);
+        log("");
+        log(`    ${cyan("/" + tried)} ${dim("[args]")}`);
+        log("");
+        log(`The CLI surface (this command) only exposes:`);
+        log(`  ${cyan("init")} · ${cyan("scan")} · ${cyan("list-rules")} · ${cyan("ci")} · ${cyan("mcp")} ·`);
+        log(`  ${cyan("adapt")} · ${cyan("serve")} · ${cyan("webhook")} · ${cyan("report")} · ${cyan("board")} · ${cyan("register")}`);
+        log("");
+        log(`Run ${cyan("npx great-cto --help")} for the full CLI reference.`);
+        process.exit(2);
+    }
     if (args.command === "report") {
         try {
             const { runReport, parseReportArgs } = await import("./report.js");

package/package.json

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