claudeos-core 2.2.0 → 2.3.0

package/lib/expected-guides.js

@@ -1,23 +1,23 @@
-/**
- * Single source of truth for the 9 guide files Pass 3 must generate.
- *
- * Used by:
- *   - bin/commands/init.js Guard 3 (fails Pass 3 if any are missing)
- *   - content-validator/index.js [5/9] (reports MISSING/EMPTY)
- *
- * Adding a guide: edit this file only.
- */
-
-const EXPECTED_GUIDE_FILES = [
-  "01.onboarding/01.overview.md",
-  "01.onboarding/02.quickstart.md",
-  "01.onboarding/03.glossary.md",
-  "02.usage/01.faq.md",
-  "02.usage/02.real-world-examples.md",
-  "02.usage/03.do-and-dont.md",
-  "03.troubleshooting/01.troubleshooting.md",
-  "04.architecture/01.file-map.md",
-  "04.architecture/02.pros-and-cons.md",
-];
-
-module.exports = { EXPECTED_GUIDE_FILES };
+/**
+ * Single source of truth for the 9 guide files Pass 3 must generate.
+ *
+ * Used by:
+ *   - bin/commands/init.js Guard 3 (fails Pass 3 if any are missing)
+ *   - content-validator/index.js [5/9] (reports MISSING/EMPTY)
+ *
+ * Adding a guide: edit this file only.
+ */
+
+const EXPECTED_GUIDE_FILES = [
+  "01.onboarding/01.overview.md",
+  "01.onboarding/02.quickstart.md",
+  "01.onboarding/03.glossary.md",
+  "02.usage/01.faq.md",
+  "02.usage/02.real-world-examples.md",
+  "02.usage/03.do-and-dont.md",
+  "03.troubleshooting/01.troubleshooting.md",
+  "04.architecture/01.file-map.md",
+  "04.architecture/02.pros-and-cons.md",
+];
+
+module.exports = { EXPECTED_GUIDE_FILES };

package/lib/expected-outputs.js

@@ -1,90 +1,90 @@
-/**
- * Pass 3 output directories that must have real content on success.
- *
- * Complements expected-guides.js (9 guide files). Used by init.js Guard 3
- * to detect truncation that occurs AFTER the guide/ section — e.g. Claude
- * writes guide/ fully but cuts off before skills/ or plan/.
- *
- * Severity source: content-validator/index.js. Entries here map 1:1 to
- * validator ERROR-level checks. database/ and mcp-guide/ are intentionally
- * omitted because the validator flags them as WARNING-level only (stacks
- * legitimately skip when no DB or MCP integration is detected).
- */
-
-const fs = require("fs");
-const path = require("path");
-
-const EXPECTED_OUTPUTS = [
-  {
-    // Sentinel file written by every stack's pass3.md template.
-    label: "claudeos-core/standard/00.core/01.project-overview.md",
-    kind: "file",
-    relPath: "claudeos-core/standard/00.core/01.project-overview.md",
-  },
-  {
-    // Skills/ holds scaffold-crud-feature (backend) and/or scaffold-page-feature
-    // (frontend) sub-skills. Zero non-empty .md files = truncation.
-    label: "claudeos-core/skills/ (≥1 non-empty .md)",
-    kind: "dir-has-nonempty-md",
-    relPath: "claudeos-core/skills",
-  },
-  // Note: claudeos-core/plan/ check was removed in this version because
-  // master plan files (10.standard-master.md, 20.rules-master.md, etc.) are
-  // no longer generated. Master plans were an internal tool backup not
-  // consumed by Claude Code at runtime, and aggregating many files in a
-  // single session caused "Prompt is too long" failures on mid-sized
-  // projects (confirmed on an 18-domain production run).
-];
-
-function readSafe(p) {
-  try { return fs.readFileSync(p, "utf-8"); }
-  catch (_e) { return null; }
-}
-
-// BOM-aware emptiness check. String.prototype.trim does NOT remove U+FEFF
-// (not in Unicode White_Space), so a BOM-only file would pass a naive
-// `.trim().length === 0` check — we strip it explicitly first. Mirrors
-// content-validator/index.js:115 and the H2 check in init.js Guard 3.
-function isBlank(text) {
-  return text.replace(/^\uFEFF/, "").trim().length === 0;
-}
-
-// Stack-based traversal (no recursion limit, same pattern as lib/staged-rules.js
-// walkFiles). Returns true on the first non-empty .md found; unreadable dirs
-// are skipped silently (matches the project's fault-tolerant fs conventions).
-function hasNonEmptyMdRecursive(dir) {
-  const stack = [dir];
-  while (stack.length) {
-    const current = stack.pop();
-    let entries;
-    try { entries = fs.readdirSync(current, { withFileTypes: true }); }
-    catch (_e) { continue; }
-    for (const e of entries) {
-      const full = path.join(current, e.name);
-      if (e.isDirectory()) { stack.push(full); continue; }
-      if (!e.isFile() || !e.name.endsWith(".md")) continue;
-      const content = readSafe(full);
-      if (content !== null && !isBlank(content)) return true;
-    }
-  }
-  return false;
-}
-
-function findMissingOutputs(projectRoot) {
-  const missing = [];
-  for (const check of EXPECTED_OUTPUTS) {
-    const abs = path.join(projectRoot, check.relPath);
-    if (check.kind === "file") {
-      if (!fs.existsSync(abs)) { missing.push(`${check.label} — not created`); continue; }
-      const c = readSafe(abs);
-      if (c === null) { missing.push(`${check.label} — unreadable`); continue; }
-      if (isBlank(c)) { missing.push(`${check.label} — empty`); }
-    } else if (check.kind === "dir-has-nonempty-md") {
-      if (!fs.existsSync(abs)) { missing.push(`${check.label} — directory missing`); continue; }
-      if (!hasNonEmptyMdRecursive(abs)) { missing.push(`${check.label} — no non-empty .md files found`); }
-    }
-  }
-  return missing;
-}
-
-module.exports = { EXPECTED_OUTPUTS, findMissingOutputs, hasNonEmptyMdRecursive };
+/**
+ * Pass 3 output directories that must have real content on success.
+ *
+ * Complements expected-guides.js (9 guide files). Used by init.js Guard 3
+ * to detect truncation that occurs AFTER the guide/ section — e.g. Claude
+ * writes guide/ fully but cuts off before skills/ or plan/.
+ *
+ * Severity source: content-validator/index.js. Entries here map 1:1 to
+ * validator ERROR-level checks. database/ and mcp-guide/ are intentionally
+ * omitted because the validator flags them as WARNING-level only (stacks
+ * legitimately skip when no DB or MCP integration is detected).
+ */
+
+const fs = require("fs");
+const path = require("path");
+
+const EXPECTED_OUTPUTS = [
+  {
+    // Sentinel file written by every stack's pass3.md template.
+    label: "claudeos-core/standard/00.core/01.project-overview.md",
+    kind: "file",
+    relPath: "claudeos-core/standard/00.core/01.project-overview.md",
+  },
+  {
+    // Skills/ holds scaffold-crud-feature (backend) and/or scaffold-page-feature
+    // (frontend) sub-skills. Zero non-empty .md files = truncation.
+    label: "claudeos-core/skills/ (≥1 non-empty .md)",
+    kind: "dir-has-nonempty-md",
+    relPath: "claudeos-core/skills",
+  },
+  // Note: claudeos-core/plan/ check was removed in this version because
+  // master plan files (10.standard-master.md, 20.rules-master.md, etc.) are
+  // no longer generated. Master plans were an internal tool backup not
+  // consumed by Claude Code at runtime, and aggregating many files in a
+  // single session caused "Prompt is too long" failures on mid-sized
+  // projects (confirmed on an 18-domain production run).
+];
+
+function readSafe(p) {
+  try { return fs.readFileSync(p, "utf-8"); }
+  catch (_e) { return null; }
+}
+
+// BOM-aware emptiness check. String.prototype.trim does NOT remove U+FEFF
+// (not in Unicode White_Space), so a BOM-only file would pass a naive
+// `.trim().length === 0` check — we strip it explicitly first. Mirrors
+// content-validator/index.js:115 and the H2 check in init.js Guard 3.
+function isBlank(text) {
+  return text.replace(/^\uFEFF/, "").trim().length === 0;
+}
+
+// Stack-based traversal (no recursion limit, same pattern as lib/staged-rules.js
+// walkFiles). Returns true on the first non-empty .md found; unreadable dirs
+// are skipped silently (matches the project's fault-tolerant fs conventions).
+function hasNonEmptyMdRecursive(dir) {
+  const stack = [dir];
+  while (stack.length) {
+    const current = stack.pop();
+    let entries;
+    try { entries = fs.readdirSync(current, { withFileTypes: true }); }
+    catch (_e) { continue; }
+    for (const e of entries) {
+      const full = path.join(current, e.name);
+      if (e.isDirectory()) { stack.push(full); continue; }
+      if (!e.isFile() || !e.name.endsWith(".md")) continue;
+      const content = readSafe(full);
+      if (content !== null && !isBlank(content)) return true;
+    }
+  }
+  return false;
+}
+
+function findMissingOutputs(projectRoot) {
+  const missing = [];
+  for (const check of EXPECTED_OUTPUTS) {
+    const abs = path.join(projectRoot, check.relPath);
+    if (check.kind === "file") {
+      if (!fs.existsSync(abs)) { missing.push(`${check.label} — not created`); continue; }
+      const c = readSafe(abs);
+      if (c === null) { missing.push(`${check.label} — unreadable`); continue; }
+      if (isBlank(c)) { missing.push(`${check.label} — empty`); }
+    } else if (check.kind === "dir-has-nonempty-md") {
+      if (!fs.existsSync(abs)) { missing.push(`${check.label} — directory missing`); continue; }
+      if (!hasNonEmptyMdRecursive(abs)) { missing.push(`${check.label} — no non-empty .md files found`); }
+    }
+  }
+  return missing;
+}
+
+module.exports = { EXPECTED_OUTPUTS, findMissingOutputs, hasNonEmptyMdRecursive };

package/lib/language-config.js

@@ -1,35 +1,35 @@
-/**
- * ClaudeOS-Core — Language Configuration (single source of truth)
- *
- * The 10-language map for generated documentation output. Used by:
- *  - bin/lib/cli-utils.js (re-exports as SUPPORTED_LANGS / LANG_CODES / isValidLang)
- *  - bin/lib/lang-selector.js (interactive picker)
- *  - lib/memory-scaffold.js (translation prompt — re-exports as LANG_LABELS)
- *
- * Adding a language: add the entry here. All consumers pick it up automatically.
- *
- * Format: lang code → human-readable name (native script + English in parens
- * for non-English languages). Order is preserved by Object.keys, which drives
- * the lang-selector display order — `en` first, then alphabetical-ish.
- */
-
-const LANGUAGES = {
-  en:      "English",
-  ko:      "한국어 (Korean)",
-  "zh-CN": "简体中文 (Chinese Simplified)",
-  ja:      "日本語 (Japanese)",
-  es:      "Español (Spanish)",
-  vi:      "Tiếng Việt (Vietnamese)",
-  hi:      "हिन्दी (Hindi)",
-  ru:      "Русский (Russian)",
-  fr:      "Français (French)",
-  de:      "Deutsch (German)",
-};
-
-const LANG_CODES = Object.keys(LANGUAGES);
-
-function isValidLang(lang) {
-  return LANG_CODES.includes(lang);
-}
-
-module.exports = { LANGUAGES, LANG_CODES, isValidLang };
+/**
+ * ClaudeOS-Core — Language Configuration (single source of truth)
+ *
+ * The 10-language map for generated documentation output. Used by:
+ *  - bin/lib/cli-utils.js (re-exports as SUPPORTED_LANGS / LANG_CODES / isValidLang)
+ *  - bin/lib/lang-selector.js (interactive picker)
+ *  - lib/memory-scaffold.js (translation prompt — re-exports as LANG_LABELS)
+ *
+ * Adding a language: add the entry here. All consumers pick it up automatically.
+ *
+ * Format: lang code → human-readable name (native script + English in parens
+ * for non-English languages). Order is preserved by Object.keys, which drives
+ * the lang-selector display order — `en` first, then alphabetical-ish.
+ */
+
+const LANGUAGES = {
+  en:      "English",
+  ko:      "한국어 (Korean)",
+  "zh-CN": "简体中文 (Chinese Simplified)",
+  ja:      "日本語 (Japanese)",
+  es:      "Español (Spanish)",
+  vi:      "Tiếng Việt (Vietnamese)",
+  hi:      "हिन्दी (Hindi)",
+  ru:      "Русский (Russian)",
+  fr:      "Français (French)",
+  de:      "Deutsch (German)",
+};
+
+const LANG_CODES = Object.keys(LANGUAGES);
+
+function isValidLang(lang) {
+  return LANG_CODES.includes(lang);
+}
+
+module.exports = { LANGUAGES, LANG_CODES, isValidLang };