koguma 2.0.0 → 2.1.0

package/README.md

@@ -149,7 +149,7 @@ content/
 │   ├── hello-world.md           # file = one entry
 │   └── our-mission.md
 ├── siteSettings/
-│   └── index.yml                # singletons use index.yml
+│   └── index.md                 # singletons use index.md
 └── media/                       # optional local images
     └── hero-banner.jpg
 ```
@@ -244,7 +244,7 @@ Your Project
     ├── post/
     │   └── hello-world.md
     └── siteSettings/
-        └── index.yml
+        └── index.md
 
 Koguma (this package)
 ├── src/

package/cli/content.ts

@@ -8,14 +8,16 @@
  *   │   ├── hello-world.md        # markdown body + frontmatter
  *   │   └── our-mission.md
  *   ├── siteSettings/
- *   │   └── index.yml             # singletons use index.yml
+ *   │   └── index.md              # singletons use index.md
  *   └── media/                    # optional local images (not managed here)
  *       └── hero.jpg
  *
- * Markdown files use YAML frontmatter for structured fields.
+ * All content files use the .md extension with YAML frontmatter.
  * The file body (below the frontmatter) is mapped to the first `markdown`
- * field in the content type definition. If the content type has no markdown
- * field, YAML-only files (.yml) are used.
+ * field in the content type definition. Files without a markdown field
+ * are frontmatter-only .md files (no body below the --- delimiter).
+ *
+ * Legacy .yml files are still accepted on read for backwards compatibility.
  */
 
 import matter from 'gray-matter';
@@ -36,7 +38,7 @@ export interface ContentEntry {
   contentType: string;
   /** Slug derived from filename (without extension) */
   slug: string;
-  /** Whether this is a singleton (index.yml) */
+  /** Whether this is a singleton (index.md) */
   singleton: boolean;
   /** All frontmatter fields */
   fields: Record<string, unknown>;
@@ -56,7 +58,8 @@ export interface ContentTypeInfo {
 // ── Parse a single content file ────────────────────────────────────
 
 /**
- * Parse a .md or .yml file into a ContentEntry.
+ * Parse a .md or .yml/.yaml file into a ContentEntry.
+ * (.yml/.yaml are accepted for backwards compatibility)
  */
 export function parseContentFile(
   filePath: string,
@@ -65,7 +68,7 @@ export function parseContentFile(
   const raw = readFileSync(filePath, 'utf-8');
   const ext = extname(filePath).toLowerCase();
   const name = basename(filePath, ext);
-  const singleton = name === 'index' && ext === '.yml';
+  const singleton = name === 'index' && (ext === '.yml' || ext === '.md');
 
   if (ext === '.yml' || ext === '.yaml') {
     // YAML-only file (no markdown body)
@@ -97,8 +100,8 @@ export function parseContentFile(
 
   return {
     contentType,
-    slug: name,
-    singleton: false,
+    slug: singleton ? contentType : name,
+    singleton,
     fields: parsed.data,
     body,
     filePath
@@ -252,15 +255,15 @@ export function dbRowToContentFile(
     };
   }
 
-  // YAML-only file (no markdown field or empty body)
+  // Frontmatter-only file (no markdown field or empty body)
   const fm = matter.stringify('', fields).trim();
-  return { content: fm + '\n', extension: '.yml' };
+  return { content: fm + '\n', extension: '.md' };
 }
 
 // ── Write content/ directory from D1 entries ───────────────────────
 
 /**
- * Write D1 entries to the content/ directory as .md/.yml files.
+ * Write D1 entries to the content/ directory as .md files.
  * Each content type gets its own subdirectory.
  *
  * @param contentDir - Absolute path to the content/ directory

package/cli/scaffold.ts

@@ -337,7 +337,7 @@ export function generateExampleFile(
   }
 
   const fm = matter.stringify('', frontmatter).trim();
-  return { content: fm + '\n', extension: '.yml' };
+  return { content: fm + '\n', extension: '.md' };
 }
 
 /**

package/package.json

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