claudeos-core 2.2.0 → 2.3.1

package/plan-installer/structure-scanner.js

@@ -1,65 +1,65 @@
-/**
- * ClaudeOS-Core — Structure Scanner (Orchestrator)
- *
- * Scans project directory structure to discover domains (backend + frontend).
- * Delegates to language-specific scanners in ./scanners/.
- *
- * Supported scanners:
- *   - scan-java.js      — Java (5 patterns: A/B/C/D/E + fallback)
- *   - scan-kotlin.js    — Kotlin (multi-module + CQRS + single fallback)
- *   - scan-node.js      — Node.js (Express/NestJS/Fastify)
- *   - scan-python.js    — Python (Django/FastAPI/Flask)
- *   - scan-frontend.js  — Angular, Next.js, React, Vue (+ 4-stage fallback + stats)
- */
-
-const { scanJavaDomains } = require("./scanners/scan-java");
-const { scanKotlinDomains, resolveSharedQueryDomains } = require("./scanners/scan-kotlin");
-const { scanNodeDomains } = require("./scanners/scan-node");
-const { scanPythonDomains } = require("./scanners/scan-python");
-const { scanFrontendDomains, countFrontendStats } = require("./scanners/scan-frontend");
-
-async function scanStructure(stack, ROOT) {
-  let backendDomains = [];
-  let frontendDomains = [];
-  let rootPackage = null;
-
-  // ── Backend scanners ──
-  if (stack.language === "java") {
-    const r = await scanJavaDomains(stack, ROOT);
-    backendDomains.push(...r.backendDomains);
-    if (r.rootPackage) rootPackage = r.rootPackage;
-  }
-
-  if (stack.language === "kotlin") {
-    const r = await scanKotlinDomains(stack, ROOT);
-    backendDomains.push(...r.backendDomains);
-    if (r.rootPackage) rootPackage = r.rootPackage;
-  }
-
-  if ((stack.language === "typescript" || stack.language === "javascript") && stack.framework && stack.framework !== "vite") {
-    const r = await scanNodeDomains(stack, ROOT);
-    backendDomains.push(...r.backendDomains);
-  }
-
-  if (stack.language === "python") {
-    const r = await scanPythonDomains(stack, ROOT);
-    backendDomains.push(...r.backendDomains);
-  }
-
-  // ── Frontend scanner ──
-  const fe = await scanFrontendDomains(stack, ROOT);
-  frontendDomains.push(...fe.frontendDomains);
-
-  // ── Frontend stats ──
-  const frontend = await countFrontendStats(stack, ROOT);
-
-  // ── Aggregate ──
-  const allDomains = [
-    ...backendDomains.sort((a, b) => b.totalFiles - a.totalFiles),
-    ...frontendDomains.sort((a, b) => b.totalFiles - a.totalFiles),
-  ];
-
-  return { domains: allDomains, backendDomains, frontendDomains, rootPackage, frontend };
-}
-
-module.exports = { scanStructure, resolveSharedQueryDomains };
+/**
+ * ClaudeOS-Core — Structure Scanner (Orchestrator)
+ *
+ * Scans project directory structure to discover domains (backend + frontend).
+ * Delegates to language-specific scanners in ./scanners/.
+ *
+ * Supported scanners:
+ *   - scan-java.js      — Java (5 patterns: A/B/C/D/E + fallback)
+ *   - scan-kotlin.js    — Kotlin (multi-module + CQRS + single fallback)
+ *   - scan-node.js      — Node.js (Express/NestJS/Fastify)
+ *   - scan-python.js    — Python (Django/FastAPI/Flask)
+ *   - scan-frontend.js  — Angular, Next.js, React, Vue (+ 4-stage fallback + stats)
+ */
+
+const { scanJavaDomains } = require("./scanners/scan-java");
+const { scanKotlinDomains, resolveSharedQueryDomains } = require("./scanners/scan-kotlin");
+const { scanNodeDomains } = require("./scanners/scan-node");
+const { scanPythonDomains } = require("./scanners/scan-python");
+const { scanFrontendDomains, countFrontendStats } = require("./scanners/scan-frontend");
+
+async function scanStructure(stack, ROOT) {
+  let backendDomains = [];
+  let frontendDomains = [];
+  let rootPackage = null;
+
+  // ── Backend scanners ──
+  if (stack.language === "java") {
+    const r = await scanJavaDomains(stack, ROOT);
+    backendDomains.push(...r.backendDomains);
+    if (r.rootPackage) rootPackage = r.rootPackage;
+  }
+
+  if (stack.language === "kotlin") {
+    const r = await scanKotlinDomains(stack, ROOT);
+    backendDomains.push(...r.backendDomains);
+    if (r.rootPackage) rootPackage = r.rootPackage;
+  }
+
+  if ((stack.language === "typescript" || stack.language === "javascript") && stack.framework && stack.framework !== "vite") {
+    const r = await scanNodeDomains(stack, ROOT);
+    backendDomains.push(...r.backendDomains);
+  }
+
+  if (stack.language === "python") {
+    const r = await scanPythonDomains(stack, ROOT);
+    backendDomains.push(...r.backendDomains);
+  }
+
+  // ── Frontend scanner ──
+  const fe = await scanFrontendDomains(stack, ROOT);
+  frontendDomains.push(...fe.frontendDomains);
+
+  // ── Frontend stats ──
+  const frontend = await countFrontendStats(stack, ROOT);
+
+  // ── Aggregate ──
+  const allDomains = [
+    ...backendDomains.sort((a, b) => b.totalFiles - a.totalFiles),
+    ...frontendDomains.sort((a, b) => b.totalFiles - a.totalFiles),
+  ];
+
+  return { domains: allDomains, backendDomains, frontendDomains, rootPackage, frontend };
+}
+
+module.exports = { scanStructure, resolveSharedQueryDomains };

package/sync-checker/index.js

@@ -1,177 +1,177 @@
-#!/usr/bin/env node
-
-/**
- * ClaudeOS-Core — Sync Checker
- *
- * Role: Check disk ↔ Master Plan sync status based on sync-map.json
- * Detection items:
- *   - Unregistered: file exists on disk but not registered in any plan
- *   - Orphaned:     registered in plan but missing from disk
- *
- * Usage: npx claudeos-core <cmd> or node claudeos-core-tools/sync-checker/index.js
- * Depends: manifest-generator must run first (sync-map.json)
- */
-
-const fs = require("fs");
-const path = require("path");
-const { glob } = require("glob");
-const { updateStaleReport } = require("../lib/stale-report");
-
-const ROOT = process.env.CLAUDEOS_ROOT || path.resolve(__dirname, "../..");
-const GEN = path.join(ROOT, "claudeos-core/generated");
-const SMP = path.join(GEN, "sync-map.json");
-
-const TRACKED = [
-  { dir: ".claude/rules",           pfx: "rules"     },
-  { dir: "claudeos-core/standard",  pfx: "standard"  },
-  { dir: "claudeos-core/skills",    pfx: "skills"    },
-  { dir: "claudeos-core/guide",     pfx: "guide"     },
-  { dir: "claudeos-core/database",  pfx: "database"  },
-  { dir: "claudeos-core/mcp-guide", pfx: "mcp-guide" },
-  { dir: "claudeos-core/memory",    pfx: "memory"    },
-];
-
-function rel(p) {
-  return path.relative(ROOT, p).replace(/\\/g, "/");
-}
-
-function isWithinRoot(absPath) {
-  let resolved = path.resolve(absPath);
-  let root = path.resolve(ROOT);
-  if (process.platform === "win32") {
-    resolved = resolved.toLowerCase();
-    root = root.toLowerCase();
-  }
-  return resolved === root || resolved.startsWith(root + path.sep);
-}
-
-async function main() {
-  console.log("\n╔═══════════════════════════════════════╗");
-  console.log("║  ClaudeOS-Core — Sync Checker         ║");
-  console.log("╚═══════════════════════════════════════╝\n");
-
-  // Master plan directory is optional. If it doesn't exist (new default for
-  // claudeos-core, since master plans are no longer generated) AND sync-map
-  // has no mappings to validate, sync-checker has nothing to compare against
-  // and should skip cleanly. This is a PASS state, not a failure.
-  //
-  // However, if sync-map.json DOES contain mappings (either because master
-  // plans exist, or because a caller wrote mappings directly for testing),
-  // we still validate them normally.
-  const PLAN_DIR = path.join(ROOT, "claudeos-core/plan");
-  const planExists = fs.existsSync(PLAN_DIR);
-
-  if (!fs.existsSync(SMP)) {
-    // No sync-map at all.
-    if (!planExists) {
-      console.log("  ℹ️  No plan/ directory and no sync-map.json — nothing to compare; skipping.\n");
-      updateStaleReport(GEN, "syncMisses",
-        { checkedAt: new Date().toISOString(), unregistered: [], orphaned: [], skipped: true },
-        { syncIssues: 0, status: "ok" }
-      );
-      process.exit(0);
-    }
-    console.log("  ❌ sync-map.json not found. Run manifest-generator first.\n");
-    process.exit(1);
-  }
-
-  let sm;
-  try {
-    sm = JSON.parse(fs.readFileSync(SMP, "utf-8"));
-  } catch (e) {
-    console.log(`  ❌ sync-map.json is malformed: ${e.message}\n`);
-    process.exit(1);
-  }
-  if (!Array.isArray(sm.mappings)) {
-    console.log("  ❌ sync-map.json has no mappings array.\n");
-    process.exit(1);
-  }
-
-  // If sync-map has no mappings AND plan/ directory doesn't exist, skip
-  // cleanly — there's no ground truth to validate against and no master plans
-  // in use.
-  if (sm.mappings.length === 0 && !planExists) {
-    console.log("  ℹ️  No plan/ directory and sync-map has no mappings — skipping.\n");
-    updateStaleReport(GEN, "syncMisses",
-      { checkedAt: new Date().toISOString(), unregistered: [], orphaned: [], skipped: true },
-      { syncIssues: 0, status: "ok" }
-    );
-    process.exit(0);
-  }
-
-  // If sync-map has no mappings but plan/ exists (e.g., empty plan files),
-  // skip without raising a warning — there's nothing to validate.
-  if (sm.mappings.length === 0) {
-    console.log("  ℹ️  sync-map has no mappings — nothing to validate; skipping.\n");
-    updateStaleReport(GEN, "syncMisses",
-      { checkedAt: new Date().toISOString(), unregistered: [], orphaned: [], skipped: true },
-      { syncIssues: 0, status: "ok" }
-    );
-    process.exit(0);
-  }
-
-  const reg = new Set(sm.mappings.map((m) => m.sourcePath).filter(Boolean));
-  const issues = { unreg: [], orphan: [] };
-
-  // ─── [1/2] Disk → Plan: detect unregistered files ───────
-  console.log("  [1/2] Disk → Plan...");
-  for (const t of TRACKED) {
-    const abs = path.join(ROOT, t.dir);
-    if (!fs.existsSync(abs)) continue;
-
-    for (const f of await glob("**/*.md", { cwd: abs, absolute: true })) {
-      const r = rel(f);
-      if (path.basename(f) === "README.md") continue;
-      if (!reg.has(r)) {
-        issues.unreg.push({ path: r, domain: t.pfx });
-      }
-    }
-  }
-
-  // Check CLAUDE.md separately
-  if (fs.existsSync(path.join(ROOT, "CLAUDE.md")) && !reg.has("CLAUDE.md")) {
-    issues.unreg.push({ path: "CLAUDE.md", domain: "root" });
-  }
-
-  // ─── [2/2] Plan → Disk: detect orphaned files ───────────────
-  console.log("  [2/2] Plan → Disk...");
-  for (const m of sm.mappings) {
-    if (!m.sourcePath) continue;
-    const abs = path.join(ROOT, m.sourcePath);
-    // Skip path traversal attempts (allow files at ROOT level and below)
-    if (!isWithinRoot(abs)) continue;
-    if (!fs.existsSync(abs)) {
-      issues.orphan.push({ path: m.sourcePath, plan: m.planFile });
-    }
-  }
-
-  // ─── Output results ─────────────────────────────────────────
-  if (issues.unreg.length) {
-    console.log(`\n  ⚠️  Unregistered (${issues.unreg.length}):`);
-    issues.unreg.forEach((i) => console.log(`     + ${i.path}`));
-  }
-  if (issues.orphan.length) {
-    console.log(`\n  ⚠️  Orphaned (${issues.orphan.length}):`);
-    issues.orphan.forEach((i) => console.log(`     - ${i.path}`));
-  }
-
-  const total = issues.unreg.length + issues.orphan.length;
-  console.log(`\n  Registered: ${reg.size} | Unregistered: ${issues.unreg.length} | Orphaned: ${issues.orphan.length}`);
-  console.log(total === 0 ? "  ✅ All in sync\n" : `  ⚠️  ${total} issues\n`);
-
-  // ─── Update stale-report.json ────────────────────────────
-  updateStaleReport(GEN, "syncMisses",
-    { checkedAt: new Date().toISOString(), unregistered: issues.unreg, orphaned: issues.orphan },
-    { syncIssues: total, status: total === 0 ? "ok" : "warning" }
-  );
-
-  // Exit 1 only for orphaned files (actual breakage), not for unregistered (informational)
-  const orphanCount = issues.orphan.length;
-  process.exit(orphanCount > 0 ? 1 : 0);
-}
-
-if (require.main === module) {
-  main().catch(e => { console.error(`\n  ❌ Unexpected error: ${e.message || e}`); process.exit(1); });
-}
-
-module.exports = { main };
+#!/usr/bin/env node
+
+/**
+ * ClaudeOS-Core — Sync Checker
+ *
+ * Role: Check disk ↔ Master Plan sync status based on sync-map.json
+ * Detection items:
+ *   - Unregistered: file exists on disk but not registered in any plan
+ *   - Orphaned:     registered in plan but missing from disk
+ *
+ * Usage: npx claudeos-core <cmd> or node claudeos-core-tools/sync-checker/index.js
+ * Depends: manifest-generator must run first (sync-map.json)
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { glob } = require("glob");
+const { updateStaleReport } = require("../lib/stale-report");
+
+const ROOT = process.env.CLAUDEOS_ROOT || path.resolve(__dirname, "../..");
+const GEN = path.join(ROOT, "claudeos-core/generated");
+const SMP = path.join(GEN, "sync-map.json");
+
+const TRACKED = [
+  { dir: ".claude/rules",           pfx: "rules"     },
+  { dir: "claudeos-core/standard",  pfx: "standard"  },
+  { dir: "claudeos-core/skills",    pfx: "skills"    },
+  { dir: "claudeos-core/guide",     pfx: "guide"     },
+  { dir: "claudeos-core/database",  pfx: "database"  },
+  { dir: "claudeos-core/mcp-guide", pfx: "mcp-guide" },
+  { dir: "claudeos-core/memory",    pfx: "memory"    },
+];
+
+function rel(p) {
+  return path.relative(ROOT, p).replace(/\\/g, "/");
+}
+
+function isWithinRoot(absPath) {
+  let resolved = path.resolve(absPath);
+  let root = path.resolve(ROOT);
+  if (process.platform === "win32") {
+    resolved = resolved.toLowerCase();
+    root = root.toLowerCase();
+  }
+  return resolved === root || resolved.startsWith(root + path.sep);
+}
+
+async function main() {
+  console.log("\n╔═══════════════════════════════════════╗");
+  console.log("║  ClaudeOS-Core — Sync Checker         ║");
+  console.log("╚═══════════════════════════════════════╝\n");
+
+  // Master plan directory is optional. If it doesn't exist (new default for
+  // claudeos-core, since master plans are no longer generated) AND sync-map
+  // has no mappings to validate, sync-checker has nothing to compare against
+  // and should skip cleanly. This is a PASS state, not a failure.
+  //
+  // However, if sync-map.json DOES contain mappings (either because master
+  // plans exist, or because a caller wrote mappings directly for testing),
+  // we still validate them normally.
+  const PLAN_DIR = path.join(ROOT, "claudeos-core/plan");
+  const planExists = fs.existsSync(PLAN_DIR);
+
+  if (!fs.existsSync(SMP)) {
+    // No sync-map at all.
+    if (!planExists) {
+      console.log("  ℹ️  No plan/ directory and no sync-map.json — nothing to compare; skipping.\n");
+      updateStaleReport(GEN, "syncMisses",
+        { checkedAt: new Date().toISOString(), unregistered: [], orphaned: [], skipped: true },
+        { syncIssues: 0, status: "ok" }
+      );
+      process.exit(0);
+    }
+    console.log("  ❌ sync-map.json not found. Run manifest-generator first.\n");
+    process.exit(1);
+  }
+
+  let sm;
+  try {
+    sm = JSON.parse(fs.readFileSync(SMP, "utf-8"));
+  } catch (e) {
+    console.log(`  ❌ sync-map.json is malformed: ${e.message}\n`);
+    process.exit(1);
+  }
+  if (!Array.isArray(sm.mappings)) {
+    console.log("  ❌ sync-map.json has no mappings array.\n");
+    process.exit(1);
+  }
+
+  // If sync-map has no mappings AND plan/ directory doesn't exist, skip
+  // cleanly — there's no ground truth to validate against and no master plans
+  // in use.
+  if (sm.mappings.length === 0 && !planExists) {
+    console.log("  ℹ️  No plan/ directory and sync-map has no mappings — skipping.\n");
+    updateStaleReport(GEN, "syncMisses",
+      { checkedAt: new Date().toISOString(), unregistered: [], orphaned: [], skipped: true },
+      { syncIssues: 0, status: "ok" }
+    );
+    process.exit(0);
+  }
+
+  // If sync-map has no mappings but plan/ exists (e.g., empty plan files),
+  // skip without raising a warning — there's nothing to validate.
+  if (sm.mappings.length === 0) {
+    console.log("  ℹ️  sync-map has no mappings — nothing to validate; skipping.\n");
+    updateStaleReport(GEN, "syncMisses",
+      { checkedAt: new Date().toISOString(), unregistered: [], orphaned: [], skipped: true },
+      { syncIssues: 0, status: "ok" }
+    );
+    process.exit(0);
+  }
+
+  const reg = new Set(sm.mappings.map((m) => m.sourcePath).filter(Boolean));
+  const issues = { unreg: [], orphan: [] };
+
+  // ─── [1/2] Disk → Plan: detect unregistered files ───────
+  console.log("  [1/2] Disk → Plan...");
+  for (const t of TRACKED) {
+    const abs = path.join(ROOT, t.dir);
+    if (!fs.existsSync(abs)) continue;
+
+    for (const f of await glob("**/*.md", { cwd: abs, absolute: true })) {
+      const r = rel(f);
+      if (path.basename(f) === "README.md") continue;
+      if (!reg.has(r)) {
+        issues.unreg.push({ path: r, domain: t.pfx });
+      }
+    }
+  }
+
+  // Check CLAUDE.md separately
+  if (fs.existsSync(path.join(ROOT, "CLAUDE.md")) && !reg.has("CLAUDE.md")) {
+    issues.unreg.push({ path: "CLAUDE.md", domain: "root" });
+  }
+
+  // ─── [2/2] Plan → Disk: detect orphaned files ───────────────
+  console.log("  [2/2] Plan → Disk...");
+  for (const m of sm.mappings) {
+    if (!m.sourcePath) continue;
+    const abs = path.join(ROOT, m.sourcePath);
+    // Skip path traversal attempts (allow files at ROOT level and below)
+    if (!isWithinRoot(abs)) continue;
+    if (!fs.existsSync(abs)) {
+      issues.orphan.push({ path: m.sourcePath, plan: m.planFile });
+    }
+  }
+
+  // ─── Output results ─────────────────────────────────────────
+  if (issues.unreg.length) {
+    console.log(`\n  ⚠️  Unregistered (${issues.unreg.length}):`);
+    issues.unreg.forEach((i) => console.log(`     + ${i.path}`));
+  }
+  if (issues.orphan.length) {
+    console.log(`\n  ⚠️  Orphaned (${issues.orphan.length}):`);
+    issues.orphan.forEach((i) => console.log(`     - ${i.path}`));
+  }
+
+  const total = issues.unreg.length + issues.orphan.length;
+  console.log(`\n  Registered: ${reg.size} | Unregistered: ${issues.unreg.length} | Orphaned: ${issues.orphan.length}`);
+  console.log(total === 0 ? "  ✅ All in sync\n" : `  ⚠️  ${total} issues\n`);
+
+  // ─── Update stale-report.json ────────────────────────────
+  updateStaleReport(GEN, "syncMisses",
+    { checkedAt: new Date().toISOString(), unregistered: issues.unreg, orphaned: issues.orphan },
+    { syncIssues: total, status: total === 0 ? "ok" : "warning" }
+  );
+
+  // Exit 1 only for orphaned files (actual breakage), not for unregistered (informational)
+  const orphanCount = issues.orphan.length;
+  process.exit(orphanCount > 0 ? 1 : 0);
+}
+
+if (require.main === module) {
+  main().catch(e => { console.error(`\n  ❌ Unexpected error: ${e.message || e}`); process.exit(1); });
+}
+
+module.exports = { main };