dotmd-cli 0.8.3 → 0.8.5

package/bin/dotmd.mjs

@@ -35,7 +35,7 @@ const HELP = {
   _main: `dotmd v${pkg.version} — frontmatter markdown document manager
 
 Commands:
-  list [--verbose]       List docs grouped by status (default)
+  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
@@ -70,6 +70,22 @@ Options:
   --help, -h             Show help
   --version, -v          Show version`,
 
+  list: `dotmd list — list docs grouped by status
+
+Options:
+  --verbose              Show full details per doc
+  --json                 Output full index as JSON (same as dotmd json)`,
+
+  json: `dotmd json — full index as JSON
+
+Outputs the complete document index as JSON to stdout.`,
+
+  completions: `dotmd completions <bash|zsh> — output shell completion script
+
+Add to your shell config:
+  bash: eval "$(dotmd completions bash)"
+  zsh:  eval "$(dotmd completions zsh)"`,
+
   query: `dotmd query — filtered document search
 
 Filters:
@@ -105,7 +121,9 @@ Use --dry-run (-n) to preview changes without writing anything.`,
 
 Options:
   --errors-only          Show only errors, suppress warnings
-  --fix                  Auto-fix broken references and regenerate index`,
+  --fix                  Auto-fix broken refs, lint issues, and regenerate index
+  --json                 Output errors and warnings as JSON
+  --dry-run, -n          Preview fixes without writing (with --fix)`,
 
   archive: `dotmd archive <file> — archive a document
 
@@ -123,13 +141,17 @@ Options:
 
   focus: `dotmd focus [status] — detailed view for one status group
 
-Shows detailed info for all docs matching the given status (default: active).`,
+Shows detailed info for all docs matching the given status (default: active).
+
+Options:
+  --json                 Output as JSON`,
 
   context: `dotmd context — compact briefing (LLM-oriented)
 
 Generates a compact status briefing designed for AI/LLM consumption.
 
 Options:
+  --json                 Output as JSON
   --summarize            Add AI summaries for expanded docs
   --model <name>         MLX model for AI summaries`,
 
@@ -242,7 +264,8 @@ Options:
   --output <path>          Write to file/directory (default: stdout for md/json)
   --status <s1,s2>         Filter by status
   --module <name>          Filter by module
-  --root <name>            Filter by root`,
+  --root <name>            Filter by root
+  --dry-run, -n            Preview without writing`,
 
   summary: `dotmd summary <file> — AI summary of a document
 
@@ -266,8 +289,14 @@ Options:
 
   lint: `dotmd lint [--fix] — check and auto-fix frontmatter issues
 
-Scans all docs for fixable problems: missing updated dates, status casing,
-camelCase key names, trailing whitespace in values, missing EOF newline.
+Scans all docs for fixable problems:
+  - Missing status (inferred via local AI model when available)
+  - Missing updated date (set to today)
+  - Status casing (e.g. Active → active)
+  - camelCase key names (e.g. nextStep → next_step)
+  - Comma-separated surface values (converted to surfaces: array)
+  - Trailing whitespace in frontmatter values
+  - Missing newline at end of file
 
 Without --fix, reports all issues. With --fix, applies fixes in place.
 Use --dry-run (-n) with --fix to preview without writing anything.`,
@@ -433,19 +462,32 @@ async function main() {
 
     if (fix) {
       // Auto-fix: broken refs, then lint, then rebuild index
-      const refResult = fixBrokenRefs(config, { dryRun, quiet: false });
-      if (!dryRun) {
-        runLint(['--fix'], config, { dryRun });
-      }
-      if (!dryRun && config.indexPath) {
-        const { renderIndexFile: rif, writeIndex: wi } = await import('../src/index-file.mjs');
-        const freshIndex = buildIndex(config);
-        wi(rif(freshIndex, config), config);
-        process.stdout.write('Index regenerated.\n');
+      fixBrokenRefs(config, { dryRun, quiet: false });
+      runLint(['--fix'], config, { dryRun });
+      if (config.indexPath) {
+        if (!dryRun) {
+          const { renderIndexFile: rif, writeIndex: wi } = await import('../src/index-file.mjs');
+          const freshIndex = buildIndex(config);
+          wi(rif(freshIndex, config), config);
+          process.stdout.write('Index regenerated.\n');
+        } else {
+          process.stdout.write('[dry-run] Would regenerate index.\n');
+        }
       }
       // Show remaining issues
       const freshIndex = buildIndex(config);
-      process.stdout.write('\n' + renderCheck(freshIndex, config, { errorsOnly }));
+      if (args.includes('--json')) {
+        process.stdout.write(JSON.stringify({
+          docsScanned: freshIndex.docs.length,
+          errors: freshIndex.errors,
+          warnings: errorsOnly ? [] : freshIndex.warnings,
+          errorCount: freshIndex.errors.length,
+          warningCount: freshIndex.warnings.length,
+          passed: freshIndex.errors.length === 0,
+        }, null, 2) + '\n');
+      } else {
+        process.stdout.write('\n' + renderCheck(freshIndex, config, { errorsOnly }));
+      }
       if (freshIndex.errors.length > 0) process.exitCode = 1;
       return;
     }

package/package.json

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

package/src/lint.mjs

@@ -78,9 +78,13 @@ export function runLint(argv, config, opts = {}) {
     }
   }
 
-  // Also get non-fixable issues from index
+  // Also get non-fixable issues from index, excluding issues we can already fix
   const index = buildIndex(config);
-  const nonFixable = [...index.errors, ...index.warnings];
+  const fixablePaths = new Set(fixable.map(f => f.repoPath));
+  const nonFixable = [...index.errors, ...index.warnings].filter(issue => {
+    if (issue.message.includes('Missing frontmatter `status`') && fixablePaths.has(issue.path)) return false;
+    return true;
+  });
 
   if (!fix) {
     // Report mode

package/src/render.mjs

@@ -41,6 +41,32 @@ function _renderCompactList(index, config) {
     lines.push('');
   }
 
+  // Render docs with statuses not in statusOrder
+  const knownStatuses = new Set(config.statusOrder);
+  const otherStatuses = [...new Set(index.docs.filter(d => d.status && !knownStatuses.has(d.status)).map(d => d.status))].sort();
+  for (const status of otherStatuses) {
+    const docs = index.docs.filter(d => d.status === status);
+    if (!docs.length) continue;
+
+    lines.push(bold(`${capitalize(status)} (${docs.length})`));
+    const maxTitle = Math.min(config.display.truncateTitle || 30, Math.max(...docs.map(d => d.title.length)));
+
+    for (const doc of docs) {
+      const title = doc.title.length > maxTitle
+        ? doc.title.slice(0, maxTitle - 3) + '...'
+        : doc.title.padEnd(maxTitle);
+      const days = doc.daysSinceUpdate != null ? `${doc.daysSinceUpdate}d` : '';
+      const progress = renderProgressBar(doc.checklist);
+      const next = doc.nextStep ? `next: ${doc.nextStep}` : '';
+      const parts = [`  ${title}  ${days.padStart(4)}`];
+      if (progress) parts.push(progress);
+      if (next) parts.push(next);
+      const line = parts.join('  ');
+      lines.push(line.length > maxWidth ? line.slice(0, maxWidth - 3) + '...' : line);
+    }
+    lines.push('');
+  }
+
   return `${lines.join('\n').trimEnd()}\n`;
 }
 
@@ -62,6 +88,24 @@ export function renderVerboseList(index, config) {
     lines.push('');
   }
 
+  // Render docs with statuses not in statusOrder
+  const knownStatuses = new Set(config.statusOrder);
+  const otherStatuses = [...new Set(index.docs.filter(d => d.status && !knownStatuses.has(d.status)).map(d => d.status))].sort();
+  for (const status of otherStatuses) {
+    const docs = index.docs.filter(doc => doc.status === status);
+    if (docs.length === 0) continue;
+
+    lines.push(`${capitalize(status)} (${docs.length})`);
+    for (const doc of docs) {
+      const parts = [`- ${doc.title}`, `${capitalize(status)}: ${doc.currentState}`, `(${doc.path})`];
+      if (doc.nextStep) {
+        parts.push(`next: ${doc.nextStep}`);
+      }
+      lines.push(parts.join(' — '));
+    }
+    lines.push('');
+  }
+
   return `${lines.join('\n').trimEnd()}\n`;
 }