koguma 2.2.0 → 2.2.2

package/cli/scaffold.ts

@@ -11,7 +11,11 @@ import {
 import { resolve } from 'path';
 import { ok, warn } from './log.ts';
 import { generateKogumaToml } from './config.ts';
-import { findMarkdownField, type ContentTypeInfo } from './content.ts';
+import {
+  findMarkdownField,
+  findMarkdownFields,
+  type ContentTypeInfo
+} from './content.ts';
 import matter from 'gray-matter';
 
 // ── Template types ─────────────────────────────────────────────────
@@ -315,29 +319,50 @@ export function generateExampleFile(
   ctId: string,
   fields: Record<string, { fieldType: string }>,
   singleton?: boolean
-): { content: string; extension: string } {
+): {
+  content: string;
+  extension: string;
+  siblingFiles?: { fieldId: string; content: string }[];
+} {
   const frontmatter: Record<string, unknown> = {};
-  let hasMarkdown = false;
+  const mdFields = Object.entries(fields)
+    .filter(([, meta]) => meta.fieldType === 'markdown')
+    .map(([id]) => id);
+  const primaryMdField = mdFields[0] ?? null;
+  const extraMdFields = mdFields.slice(1);
 
   for (const [fieldId, meta] of Object.entries(fields)) {
     if (meta.fieldType === 'markdown') {
-      hasMarkdown = true;
-      continue; // markdown goes in body, not frontmatter
+      continue; // markdown goes in body or sibling files, not frontmatter
     }
     frontmatter[fieldId] = placeholderForFieldType(meta.fieldType);
   }
 
-  if (hasMarkdown) {
+  // Build sibling example files for extra markdown fields
+  const siblingFiles: { fieldId: string; content: string }[] = [];
+  for (const fieldId of extraMdFields) {
+    siblingFiles.push({
+      fieldId,
+      content: `Write your ${fieldId} content here.`
+    });
+  }
+
+  if (primaryMdField) {
     const fm = matter.stringify('', frontmatter).trim();
     const bodyHint = singleton ? '' : `\nWrite your ${ctId} content here.\n`;
     return {
       content: `${fm}\n${bodyHint}`,
-      extension: '.md'
+      extension: '.md',
+      ...(siblingFiles.length > 0 ? { siblingFiles } : {})
     };
   }
 
   const fm = matter.stringify('', frontmatter).trim();
-  return { content: fm + '\n', extension: '.md' };
+  return {
+    content: fm + '\n',
+    extension: '.md',
+    ...(siblingFiles.length > 0 ? { siblingFiles } : {})
+  };
 }
 
 /**
@@ -367,7 +392,7 @@ export function scaffoldContentDirFromTemplate(
         fields[fid] = { fieldType: fieldTypeFromExpression(expr) };
       }
 
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         fields,
         ct.singleton
@@ -375,6 +400,14 @@ export function scaffoldContentDirFromTemplate(
       const filename = `_example${extension}`;
       writeFileSync(resolve(typeDir, filename), content);
       ok(`Created content/${ct.id}/${filename}`);
+
+      // Write sibling example files for extra markdown fields
+      if (siblingFiles) {
+        for (const { fieldId, content: siblingContent } of siblingFiles) {
+          const siblingName = `_example.${fieldId}.md`;
+          writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+        }
+      }
     } else if (!dirExisted) {
       ok(`Created content/${ct.id}/`);
     }
@@ -408,7 +441,7 @@ export function scaffoldContentDir(
     const isEmpty = dirExisted ? readdirSync(typeDir).length === 0 : true;
 
     if (isEmpty) {
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         ct.fieldMeta,
         ct.singleton
@@ -416,6 +449,14 @@ export function scaffoldContentDir(
       const filename = `_example${extension}`;
       writeFileSync(resolve(typeDir, filename), content);
       ok(`Created content/${ct.id}/${filename}`);
+
+      // Write sibling example files for extra markdown fields
+      if (siblingFiles) {
+        for (const { fieldId, content: siblingContent } of siblingFiles) {
+          const siblingName = `_example.${fieldId}.md`;
+          writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+        }
+      }
     } else if (!dirExisted) {
       ok(`Created content/${ct.id}/`);
     }
@@ -538,7 +579,7 @@ export function syncContentDirsWithConfig(
         mkdirSync(typeDir, { recursive: true });
       }
 
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         ct.fieldMeta,
         ct.singleton
@@ -551,6 +592,14 @@ export function syncContentDirsWithConfig(
       if (!dryRun) {
         writeFileSync(resolve(typeDir, filename), content);
         ok(`Created content/${ct.id}/${filename}`);
+
+        // Write sibling example files for extra markdown fields
+        if (siblingFiles) {
+          for (const { fieldId, content: siblingContent } of siblingFiles) {
+            const siblingName = `_example.${fieldId}.md`;
+            writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+          }
+        }
       }
       continue;
     }
@@ -559,7 +608,7 @@ export function syncContentDirsWithConfig(
 
     // If dir is empty, create _example
     if (files.length === 0) {
-      const { content, extension } = generateExampleFile(
+      const { content, extension, siblingFiles } = generateExampleFile(
         ct.id,
         ct.fieldMeta,
         ct.singleton
@@ -572,6 +621,14 @@ export function syncContentDirsWithConfig(
       if (!dryRun) {
         writeFileSync(resolve(typeDir, filename), content);
         ok(`Created content/${ct.id}/${filename}`);
+
+        // Write sibling example files for extra markdown fields
+        if (siblingFiles) {
+          for (const { fieldId, content: siblingContent } of siblingFiles) {
+            const siblingName = `_example.${fieldId}.md`;
+            writeFileSync(resolve(typeDir, siblingName), siblingContent + '\n');
+          }
+        }
       }
       continue;
     }

package/cli/wrangler.ts

@@ -320,12 +320,36 @@ export function wranglerDev(
       /^✘\s+/, // npm dep install error lines (let warn() handle these)
       /^▲\s+/, // npm dep install warning lines
       /^>\s+/, // npm progress lines
-      /^\s*$/ // blank lines
+      /^\s*$/, // blank lines
+      /Reloading local server/, // wrangler dev reload spam
+      /Local server updated/, // wrangler dev reload (handled as status line)
+      /Unable to find and open the program executable/ // benign diagnostic
     ];
 
     const shouldSuppress = (line: string): boolean =>
       suppressPatterns.some(p => p.test(line));
 
+    // ── In-place status line for transient events ──
+    let reloadCount = 0;
+    let hasStatusLine = false;
+    const isTTY = process.stdout.isTTY;
+
+    /** Write a transient status that overwrites itself on the next call */
+    const writeStatus = (text: string) => {
+      if (isTTY) {
+        process.stdout.write(`\r\x1b[K  ⟳ ${text}`);
+        hasStatusLine = true;
+      }
+    };
+
+    /** Clear the status line before printing a permanent line */
+    const clearStatus = () => {
+      if (hasStatusLine && isTTY) {
+        process.stdout.write('\r\x1b[K');
+        hasStatusLine = false;
+      }
+    };
+
     const handleOutput = (data: Buffer, isErr: boolean) => {
       const text = data.toString();
       for (const line of text.split('\n')) {
@@ -336,16 +360,29 @@ export function wranglerDev(
         if (trimmed.includes('Ready on http')) {
           const urlMatch = trimmed.match(/(https?:\/\/[^\s]+)/);
           const url = urlMatch?.[1] ?? 'http://localhost:8787';
+          clearStatus();
           ok(`Server ready → ${url}`);
           continue;
         }
 
+        // Reload events → transient status line (overwrites in place)
+        if (/Reloading local server/.test(trimmed)) {
+          reloadCount++;
+          writeStatus(`reload #${reloadCount}`);
+          continue;
+        }
+        if (/Local server updated/.test(trimmed)) {
+          writeStatus(`reload #${reloadCount} ✓`);
+          continue;
+        }
+
         if (shouldSuppress(line)) continue;
 
         if (trimmed.includes('Starting local server')) continue;
         if (trimmed.includes('Shutting down')) continue;
 
-        // Forward everything else (request logs, errors, warnings)
+        // Permanent line — clear status first
+        clearStatus();
         if (isErr) {
           warn(trimmed);
         } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koguma",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "🐻 A little CMS with big heart — schema-driven, runs on Cloudflare's free tier",
   "type": "module",
   "license": "MIT",