great-cto 2.20.0 → 2.21.0

package/dist/bootstrap.js

@@ -4,12 +4,13 @@ import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { dim, success, warn } from "./ui.js";
 import { suggestJurisdictions } from "./jurisdictions.js";
+import { compileFlow, renderFlowMd } from "./flow.js";
 export function bootstrap(dir, detection, archetype, compliance, detectionMeta) {
     const greatCtoDir = join(dir, ".great_cto");
     const projectMd = join(greatCtoDir, "PROJECT.md");
     if (existsSync(projectMd)) {
         warn(`.great_cto/PROJECT.md already exists — not overwriting.`);
-        return { projectMdPath: projectMd, created: false, skippedReason: "already exists" };
+        return { projectMdPath: projectMd, created: false, skippedReason: "already exists", flow: null };
     }
     mkdirSync(greatCtoDir, { recursive: true });
     const title = inferProjectTitle(dir);
@@ -120,7 +121,14 @@ when you actually start work:
 `;
     writeFileSync(projectMd, content, "utf-8");
     success(`created .great_cto/PROJECT.md ${dim(`(archetype: ${archetype})`)}`);
-    return { projectMdPath: projectMd, created: true, skippedReason: null };
+    // Write FLOW.md — compiled delivery flow for agents and user
+    const confidence = detectionMeta?.confidence ?? "medium";
+    const size = (detection.projectSize ?? "medium");
+    const flow = compileFlow(archetype, size, detection, compliance, confidence);
+    const flowMdPath = join(greatCtoDir, "FLOW.md");
+    const generatedAt = new Date().toISOString().slice(0, 10);
+    writeFileSync(flowMdPath, renderFlowMd(flow, generatedAt), "utf-8");
+    return { projectMdPath: projectMd, created: true, skippedReason: null, flow };
 }
 /**
  * Slugify a project title into a tenant-id safe for HTTP headers and audit

package/dist/flow.js

@@ -0,0 +1,188 @@
+// flow.ts — compiles all detection outputs into a single user-facing FlowResult.
+// Pure function: no I/O, no side effects.
+// Called by bootstrap.ts (writes FLOW.md) and main.ts (prints summary).
+import { reviewersFor, gatesFor } from "./archetypes.js";
+import { suggestPackReviewers, suggestPackGates, suggestPacks } from "./packs.js";
+import { suggestJurisdictions, suggestJurisdictionReviewers, suggestJurisdictionGates } from "./jurisdictions.js";
+// ── Human-readable titles ─────────────────────────────────────────────────
+const ARCHETYPE_TITLE = {
+    "fintech": "Fintech",
+    "healthcare": "Healthcare",
+    "enterprise-saas": "Enterprise SaaS",
+    "agent-product": "AI agent",
+    "ai-system": "AI system",
+    "mlops": "MLOps pipeline",
+    "commerce": "E-commerce",
+    "marketplace": "Marketplace",
+    "mobile-app": "Mobile app",
+    "web-service": "Web service",
+    "library": "Library / SDK",
+    "cli-tool": "CLI tool",
+    "data-platform": "Data platform",
+    "streaming": "Streaming system",
+    "infra": "Infrastructure",
+    "devtools": "Developer tool",
+    "browser-extension": "Browser extension",
+    "game": "Game",
+    "web3": "Web3 / DeFi",
+    "iot-embedded": "IoT / embedded",
+    "cms": "CMS",
+    "edtech": "EdTech",
+    "gov-public": "Government",
+    "insurance": "Insurance",
+    "regulated": "Regulated system",
+    "greenfield": "New project",
+};
+// Gate id (StandardGate) → user label
+const GATE_LABEL = {
+    "plan": "gate:plan",
+    "arch": "gate:arch",
+    "code": "gate:code",
+    "qa": "gate:qa",
+    "security": "gate:security",
+    "compliance": "gate:compliance",
+    "ship": "gate:ship",
+    "cost": "gate:cost-forecast",
+    "oracle-review": "gate:oracle-review",
+    "edtech-review": "gate:edtech-review",
+    "gov-review": "gate:gov-review",
+    "insurance-review": "gate:insurance-review",
+};
+// Cost (low, high) per feature cycle by archetype tier
+const ARCHETYPE_COST = {
+    "fintech": [8, 18],
+    "healthcare": [8, 18],
+    "agent-product": [8, 18],
+    "mlops": [8, 18],
+    "marketplace": [8, 18],
+    "enterprise-saas": [8, 18],
+    "regulated": [8, 18],
+    "edtech": [8, 18],
+    "gov-public": [8, 18],
+    "insurance": [8, 18],
+    "web3": [8, 18],
+    "commerce": [3, 8],
+    "mobile-app": [3, 8],
+    "web-service": [3, 8],
+    "data-platform": [3, 8],
+    "streaming": [3, 8],
+    "devtools": [3, 8],
+    "browser-extension": [3, 8],
+    "game": [3, 8],
+    "cms": [3, 8],
+    "ai-system": [3, 8],
+    "iot-embedded": [3, 8],
+    "infra": [3, 8],
+    "library": [0.5, 3],
+    "cli-tool": [0.5, 3],
+    "greenfield": [0.5, 3],
+};
+// ── Main export ───────────────────────────────────────────────────────────
+/**
+ * Compile all detection outputs into a single FlowResult.
+ *
+ * Pure function — no file I/O. Called by bootstrap.ts (FLOW.md) and
+ * main.ts (summary output).
+ */
+export function compileFlow(archetype, size, detection, compliance, confidence) {
+    // ── Agents ──────────────────────────────────────────────────────────────
+    const agentSet = new Set(reviewersFor(archetype));
+    for (const r of suggestPackReviewers(detection))
+        agentSet.add(r);
+    for (const r of suggestJurisdictionReviewers(detection))
+        agentSet.add(r);
+    // Always include base orchestration agents
+    agentSet.add("architect");
+    agentSet.add("senior-dev");
+    agentSet.add("qa-engineer");
+    // ── Gates ────────────────────────────────────────────────────────────────
+    const gateSet = new Set(gatesFor(archetype, size).map((g) => GATE_LABEL[g] ?? `gate:${g}`));
+    for (const g of suggestPackGates(detection))
+        gateSet.add(g);
+    for (const g of suggestJurisdictionGates(detection))
+        gateSet.add(g);
+    // ── Packs + jurisdictions for routing block ──────────────────────────────
+    const packs = suggestPacks(detection);
+    const jurisdictions = suggestJurisdictions(detection);
+    // ── Title ────────────────────────────────────────────────────────────────
+    const productLabel = ARCHETYPE_TITLE[archetype] ?? archetype;
+    const jCodes = jurisdictions
+        .slice(0, 3)
+        .map((j) => j.jurisdiction.toUpperCase())
+        .join(" + ");
+    const title = jCodes ? `${productLabel} · ${jCodes}` : productLabel;
+    // ── ID ───────────────────────────────────────────────────────────────────
+    const id = [archetype, ...jurisdictions.map((j) => j.jurisdiction)]
+        .join("-")
+        .toLowerCase();
+    // ── Cost range ────────────────────────────────────────────────────────────
+    const costEntry = ARCHETYPE_COST[archetype] ?? [3, 8];
+    const [low, high] = costEntry;
+    return {
+        id,
+        title,
+        agents: Array.from(agentSet).sort(),
+        gates: Array.from(gateSet).sort(),
+        compliance: [...new Set(compliance)].sort(),
+        costRange: { low, high },
+        routing: {
+            archetype,
+            packs: packs.map((p) => p.pack),
+            jurisdictions: jurisdictions.map((j) => j.jurisdiction),
+            confidence,
+        },
+    };
+}
+/**
+ * Render FLOW.md content from a FlowResult.
+ * Exported separately so bootstrap.ts can call it without depending on main.ts.
+ */
+export function renderFlowMd(flow, generatedAt) {
+    const agentLines = flow.agents.map((a) => `- ${a}`).join("\n");
+    const gateLines = flow.gates.map((g) => `- ${g}`).join("\n");
+    const complianceLines = flow.compliance.length > 0
+        ? flow.compliance.map((c) => `- ${c}`).join("\n")
+        : "- none";
+    const packLines = flow.routing.packs.length > 0
+        ? flow.routing.packs.join(", ")
+        : "none";
+    const jLines = flow.routing.jurisdictions.length > 0
+        ? flow.routing.jurisdictions.join(", ")
+        : "none";
+    return `# Delivery Flow
+
+> Auto-generated by \`great-cto init\` on ${generatedAt}.
+> This file tells agents how to orchestrate your SDLC.
+> Regenerates on \`npx great-cto init --force\`. Edit \`_routing:\` to tune.
+
+## Detected
+
+${flow.title}
+
+## Agents
+
+${agentLines}
+
+## Human gates
+
+${gateLines}
+
+## Compliance
+
+${complianceLines}
+
+## Cost estimate
+
+$${flow.costRange.low}–$${flow.costRange.high} per feature cycle
+
+---
+
+<!-- Internal routing — view with: great-cto flow explain -->
+_routing:
+  id: ${flow.id}
+  archetype: ${flow.routing.archetype}
+  packs: [${packLines}]
+  jurisdictions: [${jLines}]
+  confidence: ${flow.routing.confidence}
+`;
+}

package/dist/main.js

@@ -18,6 +18,7 @@ import { install, findInstalledVersions } from "./installer.js";
 import { enableGreatCto } from "./settings.js";
 import { installAllCompanions } from "./companion.js";
 import { bootstrap } from "./bootstrap.js";
+import { compileFlow } from "./flow.js";
 import { shouldUseLlmFallback, suggestArchetypeFromLlm } from "./llm-fallback.js";
 import { readFileSync, copyFileSync, chmodSync, existsSync as fsExistsSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -576,23 +577,26 @@ async function runInit(args) {
         }
     }
     const compliance = suggestCompliance(detection, archetype);
-    log(`  ${dim("archetype:")} ${cyan(archetype)} ${dim(`(confidence: ${confidence})`)}`);
-    log(`  ${dim("rationale:")} ${rationale}`);
-    if (alternatives.length > 0) {
-        log(`  ${dim("alternatives:")} ${alternatives.join(", ")}`);
+    // Compile flow — used for user-facing summary AND written to FLOW.md by bootstrap()
+    const compiledFlow = compileFlow(archetype, (detection.projectSize ?? "medium"), detection, compliance, confidence);
+    // ── User-facing "Compiled flow" summary ──────────────────────────────────
+    log("");
+    log(`${bold("Compiled flow:")} ${cyan(compiledFlow.title)}`);
+    log(`  ${dim("Agents:")}     ${compiledFlow.agents.join(" · ")}`);
+    log(`  ${dim("Gates:")}      ${compiledFlow.gates.join(" · ")}`);
+    if (compiledFlow.compliance.length > 0) {
+        log(`  ${dim("Compliance:")} ${compiledFlow.compliance.join(", ")}`);
     }
-    log(`  ${dim("suggested compliance:")} ${compliance.length > 0 ? compliance.join(", ") : "none"}`);
-    // v1.0.144+: ask user to confirm archetype if confidence is low
-    // OR if alternatives are present and not user-specified
+    log(`  ${dim("Cost:")}       ~$${compiledFlow.costRange.low}–$${compiledFlow.costRange.high} per feature cycle`);
+    log("");
+    // Low-confidence notice — show only when actionable
     if (!args.yes && !args.archetype && (confidence === "low" || (confidence === "medium" && alternatives.length >= 2))) {
-        log("");
-        log(`${bold("⚠ Archetype detection confidence:")} ${cyan(confidence)}`);
-        log(`  Top candidate: ${cyan(archetype)} — ${dim(rationale)}`);
+        log(`  ${yellow("⚠")} ${dim(`Detected as ${cyan(archetype)} (${confidence} confidence).`)}`);
         if (alternatives.length > 0) {
-            log(`  Alternatives:  ${alternatives.map(a => cyan(a)).join(", ")}`);
+            log(`  ${dim("Alternatives: " + alternatives.join(", "))}`);
         }
-        log(`  ${dim("If wrong, override with: --archetype " + (alternatives[0] ?? "<name>"))}`);
-        log(`  ${dim("Or edit .great_cto/PROJECT.md after install — agents read 'archetype:' field.")}`);
+        log(`  ${dim("Override: npx great-cto init --archetype <name>")}`);
+        log("");
     }
     // Confirmation
     if (!args.yes) {

package/package.json

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