camelmind 0.2.3 → 0.2.5

package/dist/index.js

@@ -153,6 +153,7 @@ var FRAMEWORK_FILES = [
   "eslint.config.mjs",
   "proxy.ts"
 ];
+var DEFAULT_IGNORED_FILES = ["app/home/page.tsx"];
 async function walkFiles(dir) {
   if (!await fs2.pathExists(dir)) return [];
   const entries = await fs2.readdir(dir, { withFileTypes: true });
@@ -224,6 +225,19 @@ async function plannedTemplateFiles() {
   files.push(...FRAMEWORK_FILES);
   return files.sort();
 }
+function normalizeUpdatePath(file) {
+  return file.replace(/\\/g, "/").replace(/^\.?\//, "");
+}
+function ignoredFilesFor(options) {
+  const ignored = /* @__PURE__ */ new Set();
+  if (!options.overwriteHome) {
+    for (const file of DEFAULT_IGNORED_FILES) ignored.add(file);
+  }
+  for (const file of options.ignoreFile ?? []) {
+    ignored.add(normalizeUpdatePath(file));
+  }
+  return ignored;
+}
 async function update(targetDir, options) {
   const projectRoot = path2.resolve(process.cwd(), targetDir ?? ".");
   const packageJsonPath = path2.join(projectRoot, "package.json");
@@ -236,7 +250,10 @@ async function update(targetDir, options) {
     console.error(chalk2.red("Run this command from a CamelMind project root, or pass the project directory."));
     process.exit(1);
   }
-  const files = await plannedTemplateFiles();
+  const ignoredFiles = ignoredFilesFor(options);
+  const allFiles = await plannedTemplateFiles();
+  const files = allFiles.filter((file) => !ignoredFiles.has(file));
+  const skippedFiles = allFiles.filter((file) => ignoredFiles.has(file));
   const backupRoot = path2.join(
     projectRoot,
     ".camelmind-update-backup",
@@ -247,12 +264,17 @@ async function update(targetDir, options) {
 
   Project: ${chalk2.cyan(projectRoot)}
   Files:   ${chalk2.cyan(String(files.length))} framework files + package.json
+  Skipped: ${chalk2.cyan(String(skippedFiles.length))} preserved files
   Backup:  ${chalk2.cyan(path2.relative(projectRoot, backupRoot))}
 `);
   if (options.dryRun) {
     console.log(chalk2.bold("  Dry run \u2014 files that would be refreshed:\n"));
     for (const file of files) console.log(`    ${file}`);
     console.log("    package.json");
+    if (skippedFiles.length) {
+      console.log(chalk2.bold("\n  Preserved files:\n"));
+      for (const file of skippedFiles) console.log(`    ${file}`);
+    }
     console.log("");
     return;
   }
@@ -359,5 +381,5 @@ var program = new Command();
 program.name("camelmind").description("CamelMind CLI \u2014 scaffold and manage documentation sites").version(pkg.version);
 program.command("init [project-name]").description("Create a new CamelMind documentation site").option("--no-install", "Skip installing npm dependencies").action(init);
 program.command("version").description("Show installed version and check for updates").action(() => checkVersion(pkg.version));
-program.command("update [project-dir]").description("Update an existing CamelMind site to the latest platform files").option("--no-install", "Skip installing npm dependencies").option("--dry-run", "Show what would change without writing files").option("-y, --yes", "Skip the confirmation prompt").action(update);
+program.command("update [project-dir]").description("Update an existing CamelMind site to the latest platform files").option("--no-install", "Skip installing npm dependencies").option("--dry-run", "Show what would change without writing files").option("--ignore-file <path...>", "Preserve additional project files during update").option("--overwrite-home", "Overwrite app/home/page.tsx with the latest template").option("-y, --yes", "Skip the confirmation prompt").action(update);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camelmind",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Create and manage CamelMind documentation sites",
   "license": "MIT",
   "type": "module",

package/template/app/globals.css

@@ -36,14 +36,24 @@
   --cm-btn-primary-bg: var(--cm-oasis-teal);
   --cm-btn-primary-text: #FFFFFF;
 
-  --cm-note-bg: #EAF7FA;
+  --cm-note-bg: #EDF8FA;
   --cm-note-border: #4BA8B7;
-  --cm-tip-bg: #EEF7EC;
-  --cm-tip-border: #5B9B62;
-  --cm-warning-bg: #FFF6E2;
-  --cm-warning-border: #D9A441;
-  --cm-danger-bg: #FFF0EC;
-  --cm-danger-border: #C76B56;
+  --cm-note-icon: #2E8391;
+  --cm-tip-bg: #F1F6EC;
+  --cm-tip-border: #7D9850;
+  --cm-tip-icon: #6A8741;
+  --cm-warning-bg: #FFF7E6;
+  --cm-warning-border: #D8A15B;
+  --cm-warning-icon: #B67D32;
+  --cm-important-bg: #F1EEF8;
+  --cm-important-border: #6B5B95;
+  --cm-important-icon: #56467C;
+  --cm-danger-bg: #FFF1ED;
+  --cm-danger-border: #BF6651;
+  --cm-danger-icon: #A54D39;
+  --cm-success-bg: #ECF7EF;
+  --cm-success-border: #5B9B62;
+  --cm-success-icon: #4D8453;
 
   --cm-radius-md: 10px;
   --cm-font-heading: var(--font-alegreya), Georgia, serif;
@@ -66,6 +76,25 @@
   --cm-link-hover: #7AD2DE;
   --cm-active: #63C1CF;
   --cm-active-border: #63C1CF;
+
+  --cm-note-bg: #1F3E49;
+  --cm-note-border: #63C1CF;
+  --cm-note-icon: #8BDDE8;
+  --cm-tip-bg: #344329;
+  --cm-tip-border: #A7BC72;
+  --cm-tip-icon: #B8CC84;
+  --cm-warning-bg: #4A3518;
+  --cm-warning-border: #E8B34E;
+  --cm-warning-icon: #F0C46F;
+  --cm-important-bg: #48351F;
+  --cm-important-border: #D8A15B;
+  --cm-important-icon: #E3BA7A;
+  --cm-danger-bg: #4A241F;
+  --cm-danger-border: #D9826C;
+  --cm-danger-icon: #E99B87;
+  --cm-success-bg: #24402C;
+  --cm-success-border: #73B97B;
+  --cm-success-icon: #8ACD91;
 }
 
 .cm-primary-button {
@@ -80,8 +109,8 @@
   margin-bottom: 1.25rem;
   border-radius: 8px;
   font-size: 1rem;
-  background-color: #fdfdfd;
-  border: 1.5px solid #bbbbbb;
+  background-color: var(--cm-bg-secondary);
+  border: 1.5px solid var(--cm-border);
   overflow: hidden;
 }
 
@@ -91,32 +120,38 @@
   font-size: 0.85rem;
   padding: 0.4rem 0.75rem;
   letter-spacing: 0.04em;
-  color: #1f1f1f;
+  color: var(--cm-text-primary);
 }
 
 .callout-body {
   padding: 0.5rem 0.75rem 0.75rem;
   font-size: 0.95rem;
-  color: #333;
+  color: var(--cm-text-primary);
 }
 
 .callout.note  { border-color: var(--cm-note-border); }
 .callout.note  .callout-header { background-color: var(--cm-note-bg); color: var(--cm-text-primary); }
+.callout.note  .callout-header svg { color: var(--cm-note-icon); }
 
 .callout.tip   { border-color: var(--cm-tip-border); }
 .callout.tip   .callout-header { background-color: var(--cm-tip-bg); color: var(--cm-text-primary); }
+.callout.tip   .callout-header svg { color: var(--cm-tip-icon); }
 
 .callout.warning { border-color: var(--cm-warning-border); }
 .callout.warning .callout-header { background-color: var(--cm-warning-bg); color: var(--cm-text-primary); }
+.callout.warning .callout-header svg { color: var(--cm-warning-icon); }
 
-.callout.important { border-color: var(--cm-oasis-teal); }
-.callout.important .callout-header { background-color: var(--cm-note-bg); color: var(--cm-text-primary); }
+.callout.important { border-color: var(--cm-important-border); }
+.callout.important .callout-header { background-color: var(--cm-important-bg); color: var(--cm-text-primary); }
+.callout.important .callout-header svg { color: var(--cm-important-icon); }
 
 .callout.danger  { border-color: var(--cm-danger-border); }
 .callout.danger  .callout-header { background-color: var(--cm-danger-bg); color: var(--cm-text-primary); }
+.callout.danger  .callout-header svg { color: var(--cm-danger-icon); }
 
-.callout.success { border-color: var(--cm-tip-border); }
-.callout.success .callout-header { background-color: var(--cm-tip-bg); color: var(--cm-text-primary); }
+.callout.success { border-color: var(--cm-success-border); }
+.callout.success .callout-header { background-color: var(--cm-success-bg); color: var(--cm-text-primary); }
+.callout.success .callout-header svg { color: var(--cm-success-icon); }
 
 body {
   font-family: var(--cm-font-body);
@@ -318,35 +353,35 @@ body {
 /* ── Dark mode overrides ── */
 
 .dark .callout {
-  background-color: #1e2027;
-  border-color: #374151;
+  background-color: var(--cm-bg-secondary);
+  border-color: var(--cm-border);
 }
 
 .dark .callout-header {
-  color: #f3f4f6;
+  color: var(--cm-text-primary);
 }
 
 .dark .callout-body {
-  color: #d1d5db;
+  color: var(--cm-text-secondary);
 }
 
-.dark .callout.note  { border-color: #3b5ea6; }
-.dark .callout.note  .callout-header { background-color: #1e3a5f; }
+.dark .callout.note  { border-color: var(--cm-note-border); }
+.dark .callout.note  .callout-header { background-color: var(--cm-note-bg); }
 
-.dark .callout.tip   { border-color: #3b4ea6; }
-.dark .callout.tip   .callout-header { background-color: #1e2f6b; }
+.dark .callout.tip   { border-color: var(--cm-tip-border); }
+.dark .callout.tip   .callout-header { background-color: var(--cm-tip-bg); }
 
-.dark .callout.warning { border-color: #7c5a2a; }
-.dark .callout.warning .callout-header { background-color: #4a3010; }
+.dark .callout.warning { border-color: var(--cm-warning-border); }
+.dark .callout.warning .callout-header { background-color: var(--cm-warning-bg); }
 
-.dark .callout.important { border-color: #1a7a70; }
-.dark .callout.important .callout-header { background-color: #0d3d39; }
+.dark .callout.important { border-color: var(--cm-important-border); }
+.dark .callout.important .callout-header { background-color: var(--cm-important-bg); }
 
-.dark .callout.danger  { border-color: #7c2a2a; }
-.dark .callout.danger  .callout-header { background-color: #4a1010; }
+.dark .callout.danger  { border-color: var(--cm-danger-border); }
+.dark .callout.danger  .callout-header { background-color: var(--cm-danger-bg); }
 
-.dark .callout.success { border-color: #2a6b2a; }
-.dark .callout.success .callout-header { background-color: #103a10; }
+.dark .callout.success { border-color: var(--cm-success-border); }
+.dark .callout.success .callout-header { background-color: var(--cm-success-bg); }
 
 /* Dark prose — tables, code, headings */
 .dark .prose {

package/template/lib/mdx.ts

@@ -2,6 +2,18 @@ import fs from "fs"
 import path from "path"
 import { execSync } from "child_process"
 import matter from "gray-matter"
+import yaml from "js-yaml"
+
+// gray-matter's bundled YAML engine calls the js-yaml v3 API (safeLoad/safeDump),
+// which js-yaml v4 removed — pass the current API explicitly.
+const matterOptions = {
+  engines: {
+    yaml: {
+      parse: (s: string) => yaml.load(s) as object,
+      stringify: (o: object) => yaml.dump(o),
+    },
+  },
+}
 
 export type FrontMatter = {
   title: string
@@ -53,14 +65,14 @@ export function processForLLM(source: string): string {
 export function loadFrontmatterOnly(filePath: string): FrontMatter {
   const fullPath = path.join(process.cwd(), filePath)
   const raw = fs.readFileSync(fullPath, "utf-8")
-  const { data } = matter(raw)
+  const { data } = matter(raw, matterOptions)
   return data as FrontMatter
 }
 
 export function loadMdxFile(filePath: string): DocContent {
   const fullPath = path.join(process.cwd(), filePath)
   const raw = fs.readFileSync(fullPath, "utf-8")
-  const { data, content } = matter(raw)
+  const { data, content } = matter(raw, matterOptions)
   const frontmatter = data as FrontMatter
 
   let lastUpdated: Date | null = null

package/template/next.config.ts

@@ -1,6 +1,7 @@
 import type { NextConfig } from "next";
 
 const isOffline = process.env.OFFLINE_MODE === "true"
+const isDev = process.env.NODE_ENV === "development"
 
 const securityHeaders = [
   { key: "X-Frame-Options", value: "DENY" },
@@ -11,7 +12,8 @@ const securityHeaders = [
     key: "Content-Security-Policy",
     value: [
       "default-src 'self'",
-      "script-src 'self' 'unsafe-inline'",
+      // React dev mode (Fast Refresh, component stacks) needs eval()
+      `script-src 'self' 'unsafe-inline'${isDev ? " 'unsafe-eval'" : ""}`,
       "style-src 'self' 'unsafe-inline'",
       "img-src 'self' data:",
       "font-src 'self'",

package/template/scripts/build-search-index.ts

@@ -76,7 +76,9 @@ async function main() {
   for (const entry of entries) {
     const filePath = path.join(ROOT, entry.file)
     if (!fs.existsSync(filePath)) continue
-    const { data: frontmatter, content } = matter(fs.readFileSync(filePath, "utf-8"))
+    const { data: frontmatter, content } = matter(fs.readFileSync(filePath, "utf-8"), {
+      engines: { yaml: { parse: (s: string) => yaml.load(s) as object, stringify: (o: object) => yaml.dump(o) } },
+    })
 
     index.push({
       slug: entry.slug,