dotmd-cli 0.9.4 → 0.9.6

package/bin/dotmd.mjs

@@ -34,40 +34,50 @@ const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'),
 const HELP = {
   _main: `dotmd v${pkg.version} — frontmatter markdown document manager
 
-Commands:
-  list [--verbose|--json] List docs grouped by status (default)
-  json                   Full index as JSON
-  check [flags]          Validate frontmatter and references
-  coverage [--json]      Metadata coverage report
-  stats [--json]         Doc health dashboard
-  graph [--dot|--json]   Visualize document relationships
-  deps [file]            Dependency tree or overview
-  context                Compact briefing (LLM-oriented)
-  focus [status]         Detailed view for one status group
-  query [filters]        Filtered search
-  index [--write]        Generate/update docs.md index block
-  status <file> <status> Transition document status
-  archive <file>         Archive (status + move + update refs)
-  touch <file>           Bump updated date
-  doctor                 Auto-fix everything: refs, lint, dates, index
-  fix-refs               Auto-fix broken reference paths
-  lint [--fix]           Check and auto-fix frontmatter issues
-  rename <old> <new>     Rename doc and update references
-  migrate <f> <old> <new>  Batch update a frontmatter field
-  watch [command]       Re-run a command on file changes
-  notion <sub> [db-id]   Notion import/export/sync
-  export [file]          Export docs as md, html, or json
-  summary <file>        AI summary of a document
-  diff [file]           Show changes since last updated date
-  new <name>             Create a new document from template
-  init                   Create starter config + docs directory
-  completions <shell>    Output shell completion script (bash, zsh)
-
-Options:
+View & Query:
+  list [--verbose] [--json]         List docs grouped by status (default command)
+  json                              Full index as JSON
+  context [--summarize] [--json]    Compact briefing (LLM-oriented)
+  focus [status] [--json]           Detailed view for one status group
+  query [filters] [--json]          Filtered search (--status, --keyword, --stale, etc.)
+  coverage [--json]                 Metadata coverage report
+  stats [--json]                    Doc health dashboard
+  graph [--dot] [--json]            Visualize document relationships
+  deps [file] [--json]              Dependency tree or overview
+  diff [file] [--summarize]         Show changes since last updated date
+  summary <file> [--json]           AI summary of a document
+
+Validate & Fix:
+  check [--fix] [--errors-only] [--json]  Validate frontmatter and references
+  doctor [--dry-run]                Auto-fix everything: refs, lint, dates, index
+  lint [--fix]                      Check and auto-fix frontmatter issues
+  fix-refs [--dry-run]              Auto-fix broken reference paths + body links
+
+Lifecycle:
+  status <file> <status>            Transition document status
+  archive <file>                    Archive (status + move + update refs)
+  touch <file>                      Bump updated date
+  touch --git                       Bulk-sync dates from git history
+  rename <old> <new>                Rename doc and update all references
+  migrate <field> <old> <new>       Batch update a frontmatter field value
+
+Create & Export:
+  new <name> [--template <t>]       Create doc from template (plan, adr, rfc, audit, design)
+  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
+
+Setup:
+  init                              Create starter config + docs directory
+  watch [command]                   Re-run a command on file changes
+  completions <shell>               Shell completion script (bash, zsh)
+
+Global Options:
   --config <path>        Explicit config file path
+  --root <name>          Filter to a specific docs root
   --dry-run, -n          Preview changes without writing anything
   --verbose              Show config details and doc count
-  --help, -h             Show help
+  --help, -h             Show help (per-command: dotmd <cmd> --help)
   --version, -v          Show version`,
 
   list: `dotmd list — list docs grouped by status

package/package.json

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

package/src/ai.mjs

@@ -34,18 +34,19 @@ export function runMLX(prompt, opts = {}) {
   const output = result.stdout.trim();
   const lines = output.split('\n')
     .filter(l => !l.includes('Fetching') && !l.includes('Warning:') && !l.includes('=========='));
-  return lines.join(' ').trim() || null;
+  const text = lines.join(' ').trim();
+  return text ? text.replace(/\*\*/g, '').replace(/^#+\s*/gm, '').trim() : null;
 }
 
 export function summarizeDocBody(bodyText, meta, opts = {}) {
   if (!bodyText?.trim()) return null;
-  const prompt = `Summarize this markdown document in 2-3 sentences. Focus on what the document is about, its current state, and any key next actions or open questions.
+  const prompt = `<|begin_of_text|><|start_header_id|>system<|end_header_id|>
+You write brief, direct summaries. No preamble. No filler. Start with the subject immediately.<|eot_id|><|start_header_id|>user<|end_header_id|>
+Write a 2-3 sentence plain text summary of this document. State what it covers, its current state (${meta.status}), and what remains to be done. No markdown formatting. No bold, headers, or bullets. Do not start with "This document" or "Here is".
 
 Title: ${meta.title}
-Status: ${meta.status}
-File: ${meta.path}
-
-${bodyText.slice(0, 6000)}`;
+${bodyText.slice(0, 6000)}<|eot_id|><|start_header_id|>assistant<|end_header_id|>
+`;
   return runMLX(prompt, { maxTokens: 200, ...opts });
 }