contentbase 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contentbase",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "repository": "https://github.com/soederpop/contentbase",
   "website": "https://contentbase.soederpop.com",
   "type": "module",
@@ -50,6 +50,11 @@
     "vitest": "^1.6.0"
   },
   "luca": {
-    "aliases": ["contentbase", "content base", "content", "the orm"]
+    "aliases": [
+      "contentbase",
+      "content base",
+      "content",
+      "the orm"
+    ]
   }
 }

package/src/cli/commands/action.ts

@@ -38,6 +38,7 @@ async function handler(options: z.infer<typeof argsSchema>, context: { container
 
 commands.register('action', {
   description: 'Run a named action on the collection',
+  usage: '<name>',
   help: `# cnotes action
 
 Run a named action registered on the collection. Actions are custom functions defined in your collection's entry point.

package/src/cli/commands/create.ts

@@ -2,6 +2,7 @@ import { z } from 'zod'
 import fs from 'fs/promises'
 import path from 'path'
 import matter from 'gray-matter'
+import { execSync } from 'child_process'
 import { commands } from '../registry.js'
 import { loadCollection } from '../load-collection.js'
 import { kebabCase } from '../../utils/inflect.js'
@@ -10,6 +11,7 @@ import { introspectMetaSchema } from '../../collection.js'
 const argsSchema = z.object({
   title: z.string().optional(),
   contentFolder: z.string().optional(),
+  openEditor: z.boolean().optional(),
 })
 
 async function handler(options: z.infer<typeof argsSchema>, context: { container: any }) {
@@ -125,10 +127,37 @@ async function handler(options: z.infer<typeof argsSchema>, context: { container
   await fs.writeFile(filePath, content, 'utf8')
 
   console.log(`Created ${filePath}`)
+
+  if (options.openEditor) {
+    const editor = process.env.EDITOR
+    if (editor) {
+      execSync(`${editor} ${filePath}`, { stdio: 'inherit' })
+    } else {
+      const candidates = ['cursor', 'code', 'vim']
+      let found = false
+      for (const cmd of candidates) {
+        try {
+          execSync(`which ${cmd}`, { stdio: 'ignore' })
+          execSync(`${cmd} ${filePath}`, { stdio: 'inherit' })
+          found = true
+          break
+        } catch {
+          // not available, try next
+        }
+      }
+      if (!found) {
+        console.error(
+          'No editor found. Tried: cursor, code, vim. Set $EDITOR to your preferred editor.'
+        )
+        process.exit(1)
+      }
+    }
+  }
 }
 
 commands.register('create', {
   description: 'Create a new document for a model type',
+  usage: '<model>',
   help: `# cnotes create
 
 Create a new document for a registered model, with proper frontmatter defaults and section scaffolding.
@@ -151,6 +180,7 @@ cnotes create <model> --title "Document Title" [options]
 |--------|-------------|
 | \`--title\` | **Required.** Title for the new document (used as H1 and slug) |
 | \`--meta.*\` | Set frontmatter fields (e.g. \`--meta.status active\`) |
+| \`--open-editor\` | Open the new file in your editor ($EDITOR, or tries cursor/code/vim) |
 | \`--contentFolder\` | Path to content folder |
 
 ## Template Lookup

package/src/cli/commands/extract.ts

@@ -123,6 +123,7 @@ async function handler(options: z.infer<typeof argsSchema>, context: { container
 
 commands.register('extract', {
   description: 'Extract specific sections from documents',
+  usage: '<glob>',
   help: `# cnotes extract
 
 Extract specific sections from one or more documents. Supports glob patterns for matching multiple documents and outputs clean markdown with normalized headings.

package/src/cli/commands/help.ts

@@ -22,7 +22,8 @@ async function handler(_options: any, context: { container: any }) {
 
   for (const name of commands.available) {
     const def = commands.get(name)!
-    lines.push(`| \`${name}\` | ${def.description} |`)
+    const label = def.usage ? `${name} ${def.usage}` : name
+    lines.push(`| \`${label}\` | ${def.description} |`)
   }
 
   lines.push(

package/src/cli/commands/init.ts

@@ -60,6 +60,7 @@ collection.register(Post);
 
 commands.register('init', {
   description: 'Initialize a new contentbase project',
+  usage: '[name]',
   help: `# cnotes init
 
 Scaffold a new contentbase project with a sample model and document.

package/src/cli/commands/search.ts

@@ -223,6 +223,7 @@ async function handler(options: z.infer<typeof argsSchema>, { container }: { con
 
 commands.register('search', {
   description: 'Semantic search across collection documents',
+  usage: '<query>',
   help: `# cnotes search
 
 Search documents in the collection using keyword, semantic, or hybrid search modes. Requires a search index — run \`cnotes embed\` first.

package/src/cli/commands/text-search.ts

@@ -86,6 +86,7 @@ async function handler(options: z.infer<typeof argsSchema>, { container }: { con
 
 commands.register('text-search', {
   description: 'Search file contents with pattern matching',
+  usage: '<pattern>',
   help: `# cnotes text-search
 
 Search file contents within the collection using ripgrep. Returns matching files by default, or line-level detail with \`--expanded\`.

package/src/cli/commands/validate.ts

@@ -85,6 +85,7 @@ async function handler(options: z.infer<typeof argsSchema>, context: { container
 
 commands.register('validate', {
   description: 'Validate documents against their model schemas',
+  usage: '[model]',
   help: `# cnotes validate
 
 Validate documents against their model schemas. Check frontmatter types, required fields, and optionally fill in missing defaults.

package/src/cli/registry.ts

@@ -2,6 +2,7 @@ import type { z } from 'zod'
 
 export interface CommandDefinition {
   description: string
+  usage?: string
   help?: string
   argsSchema?: z.ZodType<any>
   handler: (options: any, context: { container: any }) => Promise<void>