claudeos-core 2.1.1 → 2.3.0

package/plan-installer/domain-grouper.js

@@ -1,76 +1,76 @@
-/**
- * ClaudeOS-Core — Domain Grouper
- *
- * Splits domains into analysis groups, determines active domains,
- * and selects appropriate templates based on detected stack.
- */
-
-function splitDomainGroups(domains, type, template) {
-  const MAX_FILES_PER_GROUP = 40;
-  const MAX_DOMAINS_PER_GROUP = 4;
-  const groups = [];
-  let current = [];
-  let fileCount = 0;
-
-  for (const d of domains) {
-    // Flush current group before adding if it would exceed limits
-    if (current.length > 0 && (fileCount + d.totalFiles > MAX_FILES_PER_GROUP || current.length >= MAX_DOMAINS_PER_GROUP)) {
-      groups.push({ type, template, domains: [...current], estimatedFiles: fileCount });
-      current = [];
-      fileCount = 0;
-    }
-    current.push(d.name);
-    fileCount += d.totalFiles;
-  }
-  if (current.length > 0) {
-    groups.push({ type, template, domains: [...current], estimatedFiles: fileCount });
-  }
-
-  return groups;
-}
-
-// ─── Determine active domains ───────────────────────────────────
-function determineActiveDomains(stack) {
-  const isBackend = !!stack.framework && stack.framework !== "vite";
-  return {
-    "00.core": true,
-    "10.backend": !!isBackend,
-    "20.frontend": !!stack.frontend,
-    "30.security-db": !!(stack.database || isBackend || stack.frontend),
-    "40.infra": true,
-    "50.verification": true,
-    "90.optional": true,
-  };
-}
-
-// ─── Template selection (multi-stack) ──────────────────────────────
-function selectTemplates(stack) {
-  const templates = { backend: null, frontend: null };
-
-  // Backend template (requires a backend framework; language-only fallback skipped for pure frontend projects)
-  if (stack.language === "kotlin") templates.backend = "kotlin-spring";
-  else if (stack.language === "java") templates.backend = "java-spring";
-  else if (stack.framework === "nestjs") templates.backend = "node-nestjs";
-  else if (stack.framework === "express") templates.backend = "node-express";
-  else if (stack.framework === "fastify") templates.backend = "node-fastify";
-  else if (stack.framework === "django") templates.backend = "python-django";
-  else if (stack.framework === "fastapi") templates.backend = "python-fastapi";
-  else if (stack.framework === "flask") templates.backend = "python-flask";
-  else if ((stack.language === "typescript" || stack.language === "javascript") && stack.framework && stack.framework !== "vite") templates.backend = "node-express";
-  else if (stack.language === "python" && stack.framework) templates.backend = "python-fastapi";
-
-  // Frontend template
-  if (stack.frontend === "nextjs") {
-    templates.frontend = "node-nextjs";
-  } else if (stack.frontend === "react") {
-    templates.frontend = stack.framework === "vite" ? "node-vite" : "node-nextjs";
-  } else if (stack.frontend === "vue") {
-    templates.frontend = "vue-nuxt";
-  } else if (stack.frontend === "angular") {
-    templates.frontend = "angular";
-  }
-
-  return templates;
-}
-
-module.exports = { splitDomainGroups, determineActiveDomains, selectTemplates };
+/**
+ * ClaudeOS-Core — Domain Grouper
+ *
+ * Splits domains into analysis groups, determines active domains,
+ * and selects appropriate templates based on detected stack.
+ */
+
+function splitDomainGroups(domains, type, template) {
+  const MAX_FILES_PER_GROUP = 40;
+  const MAX_DOMAINS_PER_GROUP = 4;
+  const groups = [];
+  let current = [];
+  let fileCount = 0;
+
+  for (const d of domains) {
+    // Flush current group before adding if it would exceed limits
+    if (current.length > 0 && (fileCount + d.totalFiles > MAX_FILES_PER_GROUP || current.length >= MAX_DOMAINS_PER_GROUP)) {
+      groups.push({ type, template, domains: [...current], estimatedFiles: fileCount });
+      current = [];
+      fileCount = 0;
+    }
+    current.push(d.name);
+    fileCount += d.totalFiles;
+  }
+  if (current.length > 0) {
+    groups.push({ type, template, domains: [...current], estimatedFiles: fileCount });
+  }
+
+  return groups;
+}
+
+// ─── Determine active domains ───────────────────────────────────
+function determineActiveDomains(stack) {
+  const isBackend = !!stack.framework && stack.framework !== "vite";
+  return {
+    "00.core": true,
+    "10.backend": !!isBackend,
+    "20.frontend": !!stack.frontend,
+    "30.security-db": !!(stack.database || isBackend || stack.frontend),
+    "40.infra": true,
+    "50.verification": true,
+    "90.optional": true,
+  };
+}
+
+// ─── Template selection (multi-stack) ──────────────────────────────
+function selectTemplates(stack) {
+  const templates = { backend: null, frontend: null };
+
+  // Backend template (requires a backend framework; language-only fallback skipped for pure frontend projects)
+  if (stack.language === "kotlin") templates.backend = "kotlin-spring";
+  else if (stack.language === "java") templates.backend = "java-spring";
+  else if (stack.framework === "nestjs") templates.backend = "node-nestjs";
+  else if (stack.framework === "express") templates.backend = "node-express";
+  else if (stack.framework === "fastify") templates.backend = "node-fastify";
+  else if (stack.framework === "django") templates.backend = "python-django";
+  else if (stack.framework === "fastapi") templates.backend = "python-fastapi";
+  else if (stack.framework === "flask") templates.backend = "python-flask";
+  else if ((stack.language === "typescript" || stack.language === "javascript") && stack.framework && stack.framework !== "vite") templates.backend = "node-express";
+  else if (stack.language === "python" && stack.framework) templates.backend = "python-fastapi";
+
+  // Frontend template
+  if (stack.frontend === "nextjs") {
+    templates.frontend = "node-nextjs";
+  } else if (stack.frontend === "react") {
+    templates.frontend = stack.framework === "vite" ? "node-vite" : "node-nextjs";
+  } else if (stack.frontend === "vue") {
+    templates.frontend = "vue-nuxt";
+  } else if (stack.frontend === "angular") {
+    templates.frontend = "angular";
+  }
+
+  return templates;
+}
+
+module.exports = { splitDomainGroups, determineActiveDomains, selectTemplates };

package/plan-installer/index.js

@@ -1,129 +1,137 @@
-#!/usr/bin/env node
-
-/**
- * ClaudeOS-Core — plan-installer (orchestrator)
- *
- * Modules:
- *   - stack-detector.js      — detectStack()
- *   - structure-scanner.js   — scanStructure(), resolveSharedQueryDomains()
- *   - domain-grouper.js      — splitDomainGroups(), determineActiveDomains(), selectTemplates()
- *   - prompt-generator.js    — generatePrompts()
- */
-
-const path = require("path");
-const { ensureDir, writeFileSafe } = require("../lib/safe-fs");
-const { detectStack } = require("./stack-detector");
-const { scanStructure } = require("./structure-scanner");
-const { splitDomainGroups, determineActiveDomains, selectTemplates } = require("./domain-grouper");
-const { generatePrompts } = require("./prompt-generator");
-
-const ROOT = process.env.CLAUDEOS_ROOT || path.resolve(__dirname, "../..");
-const GENERATED_DIR = path.join(ROOT, "claudeos-core/generated");
-const TEMPLATES_DIR = path.join(__dirname, "../pass-prompts/templates");
-
-async function main() {
-  console.log("\n╔═══════════════════════════════════════╗");
-  console.log("║  ClaudeOS-Core — Plan Installer       ║");
-  console.log("╚═══════════════════════════════════════╝\n");
-
-  ensureDir(GENERATED_DIR);
-
-  // Phase 1: Stack detection
-  console.log("  [Phase 1] Detecting stack...");
-  const stack = await detectStack(ROOT);
-  console.log(`    Language:    ${stack.language || "unknown"} ${stack.languageVersion || ""}`);
-  console.log(`    Framework:   ${stack.framework || "none"} ${stack.frameworkVersion || ""}`);
-  if (!stack.language && !stack.framework) {
-    console.warn("\n  ⚠️  No language or framework detected.");
-    console.warn("  Supported: Java, Kotlin, TypeScript, JavaScript, Python");
-    console.warn("  Ensure you have build.gradle, package.json, pyproject.toml, or requirements.txt in the project root.\n");
-  }
-  console.log(`    Frontend:    ${stack.frontend || "none"} ${stack.frontendVersion || ""}`);
-  console.log(`    Database:    ${stack.database || "none"}`);
-  console.log(`    ORM:         ${stack.orm || "none"}`);
-  console.log(`    PackageMgr:  ${stack.packageManager || "none"}\n`);
-
-  // Phase 2: Structure scan
-  console.log("  [Phase 2] Scanning structure...");
-  const { domains, backendDomains, frontendDomains, rootPackage, frontend } = await scanStructure(stack, ROOT);
-  console.log(`    Backend:     ${backendDomains.length} domains`);
-  console.log(`    Frontend:    ${frontendDomains.length} domains`);
-  console.log(`    Total:       ${domains.length} domains`);
-  if (rootPackage) console.log(`    Package:     ${rootPackage}`);
-  if (frontend.exists) console.log(`    Components:  ${frontend.components} components, ${frontend.pages} pages, ${frontend.hooks} hooks`);
-  if (backendDomains.length === 0 && frontendDomains.length === 0) {
-    console.warn("\n  ⚠️  No domains detected.");
-    console.warn("  Pass 1 will be skipped. Generated output may be minimal.\n");
-  }
-  console.log();
-
-  // Phase 3: Template selection
-  console.log("  [Phase 3] Selecting templates...");
-  const templates = selectTemplates(stack);
-  const isMultiStack = !!(templates.backend && templates.frontend);
-  if (templates.backend) console.log(`    Backend:     ${templates.backend}`);
-  if (templates.frontend) console.log(`    Frontend:    ${templates.frontend}`);
-  console.log(`    Mode:        ${isMultiStack ? "🔀 Multi-stack" : "Single-stack"}`);
-  console.log();
-
-  // Phase 4: Domain group splitting
-  console.log("  [Phase 4] Splitting domain groups...");
-  const allGroups = [];
-  if (templates.backend && backendDomains.length > 0) allGroups.push(...splitDomainGroups(backendDomains, "backend", templates.backend));
-  if (templates.frontend && frontendDomains.length > 0) allGroups.push(...splitDomainGroups(frontendDomains, "frontend", templates.frontend));
-  allGroups.forEach((g, i) => { g.passNum = i + 1; });
-  allGroups.forEach((g, i) => {
-    const icon = g.type === "backend" ? "⚙️" : "🎨";
-    console.log(`    ${icon} Group ${i + 1}: [${g.domains.join(", ")}] (${g.type}, ~${g.estimatedFiles} files)`);
-  });
-  console.log();
-
-  // Phase 5: Active domains
-  console.log("  [Phase 5] Active domains...");
-  const active = determineActiveDomains(stack);
-  Object.entries(active).forEach(([k, v]) => console.log(`    ${v ? "✅" : "⏭️"} ${k}`));
-  console.log();
-
-  // Phase 6: Prompt generation
-  const lang = process.env.CLAUDEOS_LANG || "en";
-  console.log(`  [Phase 6] Generating prompts (lang: ${lang})...`);
-  generatePrompts(templates, lang, TEMPLATES_DIR, GENERATED_DIR);
-  console.log();
-
-  // Save outputs
-  const defaultPort = (stack.framework === "fastapi" || stack.framework === "django") ? 8000
-    : stack.framework === "flask" ? 5000
-    : stack.framework === "vite" ? 5173
-    : stack.frontend === "angular" ? 4200
-    : stack.frontend === "nextjs" ? 3000
-    : (stack.framework === "express" || stack.framework === "nestjs" || stack.framework === "fastify") ? 3000 : 8080;
-  const analysis = {
-    analyzedAt: new Date().toISOString(), lang,
-    stack: { ...stack, port: stack.port || defaultPort },
-    templates, isMultiStack, rootPackage,
-    domains, backendDomains, frontendDomains, frontend,
-    activeDomains: active,
-    summary: {
-      totalDomains: domains.length, backendDomains: backendDomains.length,
-      frontendDomains: frontendDomains.length,
-      totalFiles: domains.reduce((s, d) => s + d.totalFiles, 0),
-    },
-  };
-  writeFileSafe(path.join(GENERATED_DIR, "project-analysis.json"), JSON.stringify(analysis, null, 2));
-  console.log("  💾 project-analysis.json saved");
-
-  const domainGroups = {
-    generatedAt: new Date().toISOString(), isMultiStack, templates,
-    totalDomains: domains.length, totalGroups: allGroups.length,
-    maxDomainsPerGroup: 4, maxFilesPerGroup: 40, groups: allGroups,
-  };
-  writeFileSafe(path.join(GENERATED_DIR, "domain-groups.json"), JSON.stringify(domainGroups, null, 2));
-  console.log("  💾 domain-groups.json saved\n");
-  console.log("  ✅ Plan Installer complete\n");
-}
-
-main().catch(e => {
-  console.error(`\n  ❌ Plan Installer failed: ${e.message || e}`);
-  if (e.code === "EACCES" || e.code === "EPERM") console.error("  Check file/directory permissions.");
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * ClaudeOS-Core — plan-installer (orchestrator)
+ *
+ * Modules:
+ *   - stack-detector.js      — detectStack()
+ *   - structure-scanner.js   — scanStructure(), resolveSharedQueryDomains()
+ *   - domain-grouper.js      — splitDomainGroups(), determineActiveDomains(), selectTemplates()
+ *   - prompt-generator.js    — generatePrompts()
+ */
+
+const path = require("path");
+const { ensureDir, writeFileSafe } = require("../lib/safe-fs");
+const { detectStack } = require("./stack-detector");
+const { scanStructure } = require("./structure-scanner");
+const { splitDomainGroups, determineActiveDomains, selectTemplates } = require("./domain-grouper");
+const { generatePrompts } = require("./prompt-generator");
+
+const ROOT = process.env.CLAUDEOS_ROOT || path.resolve(__dirname, "../..");
+const GENERATED_DIR = path.join(ROOT, "claudeos-core/generated");
+const TEMPLATES_DIR = path.join(__dirname, "../pass-prompts/templates");
+
+async function main() {
+  console.log("\n╔═══════════════════════════════════════╗");
+  console.log("║  ClaudeOS-Core — Plan Installer       ║");
+  console.log("╚═══════════════════════════════════════╝\n");
+
+  ensureDir(GENERATED_DIR);
+
+  // Phase 1: Stack detection
+  console.log("  [Phase 1] Detecting stack...");
+  const stack = await detectStack(ROOT);
+  console.log(`    Language:    ${stack.language || "unknown"} ${stack.languageVersion || ""}`);
+  console.log(`    Framework:   ${stack.framework || "none"} ${stack.frameworkVersion || ""}`);
+  if (!stack.language && !stack.framework) {
+    console.warn("\n  ⚠️  No language or framework detected.");
+    console.warn("  Supported: Java, Kotlin, TypeScript, JavaScript, Python");
+    console.warn("  Ensure you have build.gradle, package.json, pyproject.toml, or requirements.txt in the project root.\n");
+  }
+  console.log(`    Frontend:    ${stack.frontend || "none"} ${stack.frontendVersion || ""}`);
+  console.log(`    Database:    ${stack.database || "none"}`);
+  console.log(`    ORM:         ${stack.orm || "none"}`);
+  console.log(`    PackageMgr:  ${stack.packageManager || "none"}\n`);
+
+  // Phase 2: Structure scan
+  console.log("  [Phase 2] Scanning structure...");
+  const { domains, backendDomains, frontendDomains, rootPackage, frontend } = await scanStructure(stack, ROOT);
+  console.log(`    Backend:     ${backendDomains.length} domains`);
+  console.log(`    Frontend:    ${frontendDomains.length} domains`);
+  console.log(`    Total:       ${domains.length} domains`);
+  if (rootPackage) console.log(`    Package:     ${rootPackage}`);
+  if (frontend.exists) console.log(`    Components:  ${frontend.components} components, ${frontend.pages} pages, ${frontend.hooks} hooks`);
+  if (backendDomains.length === 0 && frontendDomains.length === 0) {
+    console.warn("\n  ⚠️  No domains detected.");
+    console.warn("  Pass 1 will be skipped. Generated output may be minimal.\n");
+  }
+  console.log();
+
+  // Phase 3: Template selection
+  console.log("  [Phase 3] Selecting templates...");
+  const templates = selectTemplates(stack);
+  const isMultiStack = !!(templates.backend && templates.frontend);
+  if (templates.backend) console.log(`    Backend:     ${templates.backend}`);
+  if (templates.frontend) console.log(`    Frontend:    ${templates.frontend}`);
+  console.log(`    Mode:        ${isMultiStack ? "🔀 Multi-stack" : "Single-stack"}`);
+  console.log();
+
+  // Phase 4: Domain group splitting
+  console.log("  [Phase 4] Splitting domain groups...");
+  const allGroups = [];
+  if (templates.backend && backendDomains.length > 0) allGroups.push(...splitDomainGroups(backendDomains, "backend", templates.backend));
+  if (templates.frontend && frontendDomains.length > 0) allGroups.push(...splitDomainGroups(frontendDomains, "frontend", templates.frontend));
+  allGroups.forEach((g, i) => { g.passNum = i + 1; });
+  allGroups.forEach((g, i) => {
+    const icon = g.type === "backend" ? "⚙️" : "🎨";
+    console.log(`    ${icon} Group ${i + 1}: [${g.domains.join(", ")}] (${g.type}, ~${g.estimatedFiles} files)`);
+  });
+  console.log();
+
+  // Phase 5: Active domains
+  console.log("  [Phase 5] Active domains...");
+  const active = determineActiveDomains(stack);
+  Object.entries(active).forEach(([k, v]) => console.log(`    ${v ? "✅" : "⏭️"} ${k}`));
+  console.log();
+
+  // Phase 6: Prompt generation
+  const lang = process.env.CLAUDEOS_LANG || "en";
+  console.log(`  [Phase 6] Generating prompts (lang: ${lang})...`);
+  generatePrompts(templates, lang, TEMPLATES_DIR, GENERATED_DIR);
+  console.log();
+
+  // Save outputs
+  //
+  // Port resolution precedence (stack.port):
+  //   1. stack.port already set by stack-detector (Spring application.yml
+  //      server.port, or .env file PORT variable) — highest authority.
+  //   2. defaultPort fallback below — framework convention, only used when
+  //      the project declares no port of its own. This is a last-resort
+  //      default; prefer that stack-detector extract it from .env.example
+  //      to keep CLAUDE.md truthful to what the project actually runs.
+  const defaultPort = (stack.framework === "fastapi" || stack.framework === "django") ? 8000
+    : stack.framework === "flask" ? 5000
+    : stack.framework === "vite" ? 5173
+    : stack.frontend === "angular" ? 4200
+    : stack.frontend === "nextjs" ? 3000
+    : (stack.framework === "express" || stack.framework === "nestjs" || stack.framework === "fastify") ? 3000 : 8080;
+  const analysis = {
+    analyzedAt: new Date().toISOString(), lang,
+    stack: { ...stack, port: stack.port || defaultPort },
+    templates, isMultiStack, rootPackage,
+    domains, backendDomains, frontendDomains, frontend,
+    activeDomains: active,
+    summary: {
+      totalDomains: domains.length, backendDomains: backendDomains.length,
+      frontendDomains: frontendDomains.length,
+      totalFiles: domains.reduce((s, d) => s + d.totalFiles, 0),
+    },
+  };
+  writeFileSafe(path.join(GENERATED_DIR, "project-analysis.json"), JSON.stringify(analysis, null, 2));
+  console.log("  💾 project-analysis.json saved");
+
+  const domainGroups = {
+    generatedAt: new Date().toISOString(), isMultiStack, templates,
+    totalDomains: domains.length, totalGroups: allGroups.length,
+    maxDomainsPerGroup: 4, maxFilesPerGroup: 40, groups: allGroups,
+  };
+  writeFileSafe(path.join(GENERATED_DIR, "domain-groups.json"), JSON.stringify(domainGroups, null, 2));
+  console.log("  💾 domain-groups.json saved\n");
+  console.log("  ✅ Plan Installer complete\n");
+}
+
+main().catch(e => {
+  console.error(`\n  ❌ Plan Installer failed: ${e.message || e}`);
+  if (e.code === "EACCES" || e.code === "EPERM") console.error("  Check file/directory permissions.");
+  process.exit(1);
+});