npm - dotmd-cli - Versions diffs - 0.22.1 → 0.23.0 - Mend

dotmd-cli 0.22.1 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/bin/dotmd.mjs CHANGED Viewed

@@ -55,7 +55,7 @@ Lifecycle:
   migrate <field> <old> <new> [f...]Batch update a frontmatter field value (optional file filter)
 Create & Export:
-  new <name> [--template <t>]       Create doc from template (plan, adr, rfc, audit, design)
+  new <type> <name> [body]          Create doc of given type (plan, doc, prompt, research)
   index [--write]                   Generate/update docs.md index block
   export [--format md|html|json]    Export docs as markdown, HTML, or JSON
   notion import|export|sync [db-id] Notion database integration
@@ -386,22 +386,42 @@ With --write, updates the configured index file in place.
 Use --dry-run (-n) with --write to preview without writing.`,
-  new: `dotmd new <name> — create a new document
+  new: `dotmd new <type> <name> [body] — create a new document
-Creates a new markdown document with frontmatter in the docs root.
+Types and their default destinations:
+  plan        docs/plans/<slug>.md     (build-up template: Problem → Phases → Closeout)
+  doc         docs/<slug>.md           (minimal reference doc)
+  prompt      docs/prompts/<slug>.md   (saved prompt to seed a future session — body required)
+  research    docs/<slug>.md           (audit / investigation)
-Options:
-  --template <name>    Use a template (default, plan, adr, rfc, audit, design)
-  --status <s>         Set initial status (default: active)
-  --title <t>          Override the document title
+\`<type>\` can be omitted; defaults to \`doc\`.
+\`<name>\` is slugified for the filename.
+Body input (prompt type only):
+  <text>                 Inline body as 3rd positional
+  --message "<text>"     Explicit inline body
+  -                      Read body from stdin (heredoc-friendly for agents)
+  @path                  Read body from a file
+Examples:
+  dotmd new plan auth-revamp
+  dotmd new prompt cleanup-tomorrow "look at remaining lint warnings"
+  dotmd new prompt resume-foo - <<'EOF'
+  multi-line
+  prompt body
+  EOF
+  dotmd new prompt from-file @/tmp/draft.md
+Other options:
+  --status <s>         Set initial status (defaults to first valid status for the type)
+  --title <t>          Override the auto-derived title
   --root <name>        Create in a specific docs root
-  --list-templates     Show available templates
+  --list-types         Show registered types (alias: --list-templates)
 For plans, the default status vocabulary is: in-session, active, planned,
-blocked, partial, paused, awaiting, queued-after, archived. Run
-\`dotmd status --help\` for what each one means.
+blocked, partial, paused, awaiting, queued-after, archived.
+For prompts: pending (default), claimed, archived.
-The filename is derived from <name> by slugifying it.
 Use --dry-run (-n) to preview without creating the file.`,
   watch: `dotmd watch [command] — re-run a command on file changes

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "CLI for managing markdown documents with YAML frontmatter — index, query, validate, graph, export, Notion sync, AI summaries.",
   "type": "module",
   "license": "MIT",

package/src/claude-commands.mjs CHANGED Viewed

@@ -22,7 +22,8 @@ function generatePlansCommand(config) {
   lines.push('- `dotmd health` — plan velocity, aging, checklist progress, pipeline view');
   lines.push('- `dotmd unblocks <file>` — what depends on / is blocked by a plan');
   lines.push('- `dotmd next` — ready plans with next steps (what to promote)');
-  lines.push('- `dotmd new <name> --template plan` — scaffold with full phase structure');
+  lines.push('- `dotmd new plan <name>` — scaffold with full phase structure');
+  lines.push('- `dotmd new prompt <name> "<body>"` — save a resume-prompt to docs/prompts/');
   lines.push('- `dotmd archive <file>` — archive with auto ref-fixing (both directions)');
   lines.push('- `dotmd bulk archive <files>` — archive multiple at once');
   lines.push('- `dotmd status <file> <status>` — transition status');
@@ -115,7 +116,10 @@ function generateDocsCommand(config) {
   lines.push('');
   lines.push('Lifecycle:');
-  lines.push('- `dotmd new <name> --template plan` — scaffold new plan');
+  lines.push('- `dotmd new plan <name>` — scaffold new plan');
+  lines.push('- `dotmd new doc <name>` — scaffold reference doc');
+  lines.push('- `dotmd new prompt <name> "<body>"` — save a resume-prompt');
+  lines.push('- `dotmd new research <name>` — scaffold an audit/investigation');
   lines.push('- `dotmd status <file> <status>` — transition status');
   lines.push('- `dotmd archive <file>` — archive with auto ref-fixing');
   lines.push('- `dotmd bulk archive <files>` — archive multiple at once');

package/src/config.mjs CHANGED Viewed

@@ -40,6 +40,11 @@ const DEFAULTS = {
       context: { expanded: ['active'], listed: [], counted: ['reference', 'archived'] },
       staleDays: { active: 30 },
     },
+    prompt: {
+      statuses: ['pending', 'claimed', 'archived'],
+      context: { expanded: ['pending'], listed: [], counted: ['claimed', 'archived'] },
+      staleDays: { pending: 30 },
+    },
   },
   statuses: {

package/src/new.mjs CHANGED Viewed

@@ -1,17 +1,24 @@
-import { existsSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { toRepoPath, die, warn, nowIso } from './util.mjs';
 import { green, dim, bold } from './color.mjs';
 import { isInteractive, promptText } from './prompt.mjs';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
 const BUILTIN_TEMPLATES = {
-  default: {
-    description: 'Minimal document with status and updated date',
-    frontmatter: (s, d) => `type: doc\nstatus: ${s}\nupdated: ${d}`,
+  doc: {
+    description: 'Reference doc, design note, glossary entry, etc.',
+    defaultStatus: 'active',
+    frontmatter: (s, d) => `type: doc\nstatus: ${s}\ncreated: ${d}\nupdated: ${d}`,
     body: (t) => `\n# ${t}\n`,
   },
   plan: {
     description: 'Execution plan — build-up shape (Problem → Phases → Closeout) with phase status markers and Version History',
+    dir: 'plans',
+    defaultStatus: 'active',
     frontmatter: (s, d) => [
       'type: plan',
       `status: ${s}`,
@@ -88,67 +95,127 @@ Status markers (put in heading text):
 <!-- Filled on archive: what shipped, key commits, deferrals dispositioned. -->
 `,
   },
-  adr: {
-    description: 'Architecture Decision Record',
-    frontmatter: (s, d) => `type: doc\nstatus: ${s}\nupdated: ${d}\ndecision_date:\ndeciders:`,
-    body: (t) => `\n# ${t}\n\n## Context\n\n\n\n## Decision\n\n\n\n## Consequences\n\n\n`,
-  },
-  rfc: {
-    description: 'Request for Comments',
-    frontmatter: (s, d) => `type: doc\nstatus: ${s}\nupdated: ${d}\nowner:\nreviewers:`,
-    body: (t) => `\n# ${t}\n\n## Summary\n\n\n\n## Motivation\n\n\n\n## Detailed Design\n\n\n\n## Alternatives\n\n\n\n## Open Questions\n\n\n`,
-  },
-  audit: {
+  research: {
     description: 'Codebase audit or research investigation',
-    frontmatter: (s, d) => `type: research\nstatus: ${s}\nupdated: ${d}\naudited: ${d}\naudit_level: pass1\nmodule:\nsource_of_truth: code\nsupports_plans:`,
+    defaultStatus: 'active',
+    frontmatter: (s, d) => [
+      'type: research',
+      `status: ${s}`,
+      `created: ${d}`,
+      `updated: ${d}`,
+      `audited: ${d}`,
+      'audit_level: pass1',
+      'module:',
+      'source_of_truth: code',
+      'supports_plans: []',
+    ].join('\n'),
     body: (t) => `\n# ${t}\n\n## Scope\n\n\n\n## Findings\n\n\n\n## Recommendations\n\n\n`,
   },
-  design: {
-    description: 'Design document with goals, non-goals, and implementation plan',
-    frontmatter: (s, d) => `type: doc\nstatus: ${s}\nupdated: ${d}\nowner:\nsurface:\nmodule:\nrelated_plans:`,
-    body: (t) => `\n# ${t}\n\n## Overview\n\n\n\n## Goals\n\n\n\n## Non-Goals\n\n\n\n## Design\n\n\n\n## Implementation Plan\n\n- [ ] \n`,
+  prompt: {
+    description: 'Saved prompt to seed a future Claude session — body is required',
+    dir: 'prompts',
+    defaultStatus: 'pending',
+    requiresBody: true,
+    frontmatter: (s, d, ctx) => [
+      'type: prompt',
+      `status: ${s}`,
+      `created: ${d}`,
+      `dotmd_version: ${pkg.version}`,
+      `context: ${ctx?.title ? `"${ctx.title.replace(/"/g, '\\"')}"` : ''}`,
+      'related_plans: []',
+    ].join('\n'),
+    body: (t, ctx) => `\n${ctx?.bodyInput ?? '<!-- prompt body -->'}\n`,
   },
 };
+function readBodyInput(source) {
+  if (source === '-') {
+    try { return readFileSync(0, 'utf8'); } catch (err) { die(`Could not read body from stdin: ${err.message}`); }
+  }
+  if (typeof source === 'string' && source.startsWith('@')) {
+    const file = source.slice(1);
+    if (!existsSync(file)) die(`Body file not found: ${file}`);
+    return readFileSync(file, 'utf8');
+  }
+  return source;
+}
 export async function runNew(argv, config, opts = {}) {
   const { dryRun } = opts;
-  // Parse args
+  // Parse args. Pull out flags first.
   const positional = [];
-  let status = 'active';
+  let status = null;
   let title = null;
-  let templateName = null;
   let rootName = opts.root ?? null;
+  let messageFlag = null;
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--status' && argv[i + 1]) { status = argv[++i]; continue; }
     if (argv[i] === '--title' && argv[i + 1]) { title = argv[++i]; continue; }
-    if (argv[i] === '--template' && argv[i + 1]) { templateName = argv[++i]; continue; }
+    if (argv[i] === '--message' && argv[i + 1]) { messageFlag = argv[++i]; continue; }
     if (argv[i] === '--root' && argv[i + 1]) { rootName = argv[++i]; continue; }
     if (argv[i] === '--config') { i++; continue; }
-    if (argv[i] === '--list-templates') {
+    if (argv[i] === '--list-templates' || argv[i] === '--list-types') {
       listTemplates(config);
       return;
     }
-    if (!argv[i].startsWith('-')) positional.push(argv[i]);
+    // Treat `-` alone (stdin marker) as a positional, not a flag.
+    if (!argv[i].startsWith('-') || argv[i] === '-') positional.push(argv[i]);
+  }
+  // Resolve type vs name:
+  //   `dotmd new plan auth-revamp`     → type=plan, name=auth-revamp
+  //   `dotmd new auth-revamp`          → type=doc (default), name=auth-revamp
+  //   `dotmd new prompt foo "body"`    → type=prompt, name=foo, bodyArg="body"
+  const knownTypes = new Set(Object.keys(BUILTIN_TEMPLATES));
+  // Also include any custom templates from config
+  for (const k of Object.keys(config.raw?.templates ?? {})) knownTypes.add(k);
+  let typeName, name, bodyArg = null;
+  if (positional.length >= 1 && knownTypes.has(positional[0])) {
+    typeName = positional[0];
+    name = positional[1];
+    if (positional.length > 2) bodyArg = positional.slice(2).join(' ');
+  } else {
+    typeName = 'doc';
+    name = positional[0];
+    if (positional.length > 1) bodyArg = positional.slice(1).join(' ');
   }
-  let name = positional[0];
   if (!name) {
     if (isInteractive()) {
-      name = await promptText('Document name: ');
+      name = await promptText(`${typeName} name: `);
       if (!name) die('No name provided.');
     } else {
-      die('Usage: dotmd new <name> [--template <t>] [--status <s>] [--title <t>]\n       dotmd new --list-templates');
+      die(`Usage: dotmd new <type> <name> [body]\n       types: ${[...knownTypes].join(', ')}\n       body: inline text | "-" (stdin) | "@path" (file) | --message "..."`);
     }
   }
-  // Validate status
-  if (!config.validStatuses.has(status)) {
-    die(`Invalid status: ${status}\nValid: ${[...config.validStatuses].join(', ')}`);
+  // Resolve template (by type name, falls back to lookup)
+  const template = resolveTemplate(typeName, config);
+  // Validate status (template default first, then per-type list, then 'active')
+  if (!status) {
+    if (typeof template === 'object' && template.defaultStatus) {
+      status = template.defaultStatus;
+    } else {
+      const typeStatuses = config.typeStatuses?.get(typeName);
+      status = typeStatuses && typeStatuses.size > 0 ? [...typeStatuses][0] : 'active';
+    }
+  }
+  const effective = config.typeStatuses?.get(typeName) ?? config.validStatuses;
+  if (!effective.has(status)) {
+    die(`Invalid status \`${status}\` for type \`${typeName}\`\nValid: ${[...effective].join(', ')}`);
   }
-  // Resolve template
-  const template = resolveTemplate(templateName ?? 'default', config);
+  // Body input resolution: messageFlag > bodyArg > nothing
+  let bodyInput = null;
+  if (messageFlag !== null) bodyInput = readBodyInput(messageFlag);
+  else if (bodyArg !== null) bodyInput = readBodyInput(bodyArg);
+  if (template.requiresBody && (!bodyInput || !bodyInput.trim())) {
+    die(`\`${typeName}\` template requires a body. Pass inline, --message "...", - for stdin, or @path for a file.`);
+  }
   // If name contains path separators, split into directory prefix and basename
   let nameDir = null;
@@ -179,7 +246,12 @@ export async function runNew(argv, config, opts = {}) {
     targetRoot = match;
   }
-  // Path — if user provided a directory prefix, resolve relative to repoRoot
+  // Template-declared subdirectory (e.g., prompt → 'prompts')
+  if (typeof template === 'object' && template.dir && !nameDir) {
+    nameDir = path.join(path.relative(config.repoRoot, targetRoot), template.dir);
+  }
+  // Path — if user provided a directory prefix OR template declared one, resolve relative to repoRoot
   const baseDir = nameDir ? path.resolve(config.repoRoot, nameDir) : targetRoot;
   const filePath = path.join(baseDir, slug + '.md');
   const repoPath = toRepoPath(filePath, config.repoRoot);
@@ -192,26 +264,28 @@ export async function runNew(argv, config, opts = {}) {
   // Generate content
   let content;
+  const tmplCtx = { status, title: docTitle, today, bodyInput };
   if (typeof template === 'function') {
-    content = template(name, { status, title: docTitle, today });
+    content = template(name, tmplCtx);
   } else {
-    const fm = template.frontmatter(status, today);
-    const body = template.body(docTitle, { today, status });
+    const fm = template.frontmatter(status, today, tmplCtx);
+    const body = template.body(docTitle, tmplCtx);
     content = `---\n${fm}\n---\n${body}`;
   }
   if (dryRun) {
     process.stdout.write(`${dim('[dry-run]')} Would create: ${repoPath}\n`);
-    if (templateName) process.stdout.write(`${dim('[dry-run]')} Template: ${templateName}\n`);
+    process.stdout.write(`${dim('[dry-run]')} Type: ${typeName}\n`);
     return;
   }
+  // Ensure parent dir exists (templates with `dir:` may target a new subdirectory)
+  mkdirSync(path.dirname(filePath), { recursive: true });
   writeFileSync(filePath, content, 'utf8');
-  process.stdout.write(`${green('Created')}: ${repoPath}`);
-  if (templateName) process.stdout.write(` ${dim(`(template: ${templateName})`)}`);
-  process.stdout.write('\n');
+  process.stdout.write(`${green('Created')}: ${repoPath} ${dim(`(${typeName})`)}\n`);
-  try { config.hooks.onNew?.({ path: repoPath, status, title: docTitle, template: templateName }); } catch (err) { warn(`Hook 'onNew' threw: ${err.message}`); }
+  try { config.hooks.onNew?.({ path: repoPath, status, title: docTitle, type: typeName }); } catch (err) { warn(`Hook 'onNew' threw: ${err.message}`); }
 }
 function resolveTemplate(name, config) {
@@ -221,7 +295,7 @@ function resolveTemplate(name, config) {
   if (BUILTIN_TEMPLATES[name]) return BUILTIN_TEMPLATES[name];
   const available = [...new Set([...Object.keys(BUILTIN_TEMPLATES), ...Object.keys(configTemplates)])];
-  die(`Unknown template: ${name}\nAvailable: ${available.join(', ')}`);
+  die(`Unknown type: ${name}\nAvailable: ${available.join(', ')}`);
 }
 function listTemplates(config) {
@@ -231,7 +305,7 @@ function listTemplates(config) {
     all[k] = v;
   }
-  process.stdout.write(bold('Available templates') + '\n\n');
+  process.stdout.write(bold('Available types') + '\n\n');
   for (const [name, tmpl] of Object.entries(all)) {
     const desc = typeof tmpl === 'function'
       ? '(custom function)'