dotmd-cli 0.8.1 → 0.8.3

package/bin/dotmd.mjs

@@ -25,7 +25,7 @@ import { runSummary } from '../src/summary.mjs';
 import { runDeps } from '../src/deps.mjs';
 import { runExport } from '../src/export.mjs';
 import { runNotion } from '../src/notion.mjs';
-import { die, warn } from '../src/util.mjs';
+import { die, warn, levenshtein } from '../src/util.mjs';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -88,7 +88,10 @@ Filters:
   --limit <n>            Max results (default: 20)
   --all                  Show all results (no limit)
   --git                  Use git dates instead of frontmatter
-  --json                 Output as JSON`,
+  --json                 Output as JSON
+  --summarize            Add AI summaries to results
+  --summarize-limit <n>  Max docs to summarize (default: 5)
+  --model <name>         MLX model for AI summaries`,
 
   status: `dotmd status <file> <new-status> — transition document status
 
@@ -111,6 +114,25 @@ references in other docs, and regenerates the index.
 
 Use --dry-run (-n) to preview changes without writing anything.`,
 
+  coverage: `dotmd coverage — metadata coverage report
+
+Shows which docs are missing surface, module, or audit metadata.
+
+Options:
+  --json                 Machine-readable JSON output`,
+
+  focus: `dotmd focus [status] — detailed view for one status group
+
+Shows detailed info for all docs matching the given status (default: active).`,
+
+  context: `dotmd context — compact briefing (LLM-oriented)
+
+Generates a compact status briefing designed for AI/LLM consumption.
+
+Options:
+  --summarize            Add AI summaries for expanded docs
+  --model <name>         MLX model for AI summaries`,
+
   stats: `dotmd stats — doc health dashboard
 
 Shows aggregated metrics: status counts, staleness, errors/warnings,
@@ -320,7 +342,14 @@ async function main() {
   const verbose = args.includes('--verbose');
 
   const config = await resolveConfig(process.cwd(), explicitConfig);
-  const restArgs = args.slice(1);
+
+  // Strip global flags from restArgs so commands don't have to filter them
+  const restArgs = [];
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--config') { i++; continue; }
+    if (args[i] === '--dry-run' || args[i] === '-n' || args[i] === '--verbose') continue;
+    restArgs.push(args[i]);
+  }
 
   if (!config.configFound && command !== 'init') {
     warn('No dotmd config found — using defaults. Run `dotmd init` to create one.');
@@ -351,16 +380,16 @@ async function main() {
   if (command === 'diff') { runDiff(restArgs, config); return; }
   if (command === 'summary') { runSummary(restArgs, config); return; }
   if (command === 'deps') { runDeps(restArgs, config); return; }
-  if (command === 'export') { runExport(restArgs, config); return; }
+  if (command === 'export') { runExport(restArgs, config, { dryRun }); return; }
   if (command === 'notion') { await runNotion(restArgs, config, { dryRun }); return; }
 
   // Lifecycle commands
-  if (command === 'status') { runStatus(restArgs, config, { dryRun }); return; }
+  if (command === 'status') { await runStatus(restArgs, config, { dryRun }); return; }
   if (command === 'archive') { runArchive(restArgs, config, { dryRun }); return; }
   if (command === 'touch') { runTouch(restArgs, config, { dryRun }); return; }
-  if (command === 'new') { runNew(restArgs, config, { dryRun }); return; }
+  if (command === 'new') { await runNew(restArgs, config, { dryRun }); return; }
   if (command === 'lint') { runLint(restArgs, config, { dryRun }); return; }
-  if (command === 'rename') { runRename(restArgs, config, { dryRun }); return; }
+  if (command === 'rename') { await runRename(restArgs, config, { dryRun }); return; }
   if (command === 'migrate') { runMigrate(restArgs, config, { dryRun }); return; }
   if (command === 'fix-refs') { runFixRefs(restArgs, config, { dryRun }); return; }
   if (command === 'doctor') { runDoctor(restArgs, config, { dryRun }); return; }
@@ -388,7 +417,9 @@ async function main() {
   }
 
   if (command === 'list') {
-    if (args.includes('--verbose')) {
+    if (args.includes('--json')) {
+      process.stdout.write(`${JSON.stringify(index, null, 2)}\n`);
+    } else if (args.includes('--verbose')) {
       process.stdout.write(renderVerboseList(index, config));
     } else {
       process.stdout.write(renderCompactList(index, config));
@@ -419,6 +450,19 @@ async function main() {
       return;
     }
 
+    if (args.includes('--json')) {
+      process.stdout.write(JSON.stringify({
+        docsScanned: index.docs.length,
+        errors: index.errors,
+        warnings: errorsOnly ? [] : index.warnings,
+        errorCount: index.errors.length,
+        warningCount: index.warnings.length,
+        passed: index.errors.length === 0,
+      }, null, 2) + '\n');
+      if (index.errors.length > 0) process.exitCode = 1;
+      return;
+    }
+
     process.stdout.write(renderCheck(index, config, { errorsOnly }));
     if (index.errors.length > 0) process.exitCode = 1;
     return;
@@ -463,6 +507,23 @@ async function main() {
   if (command === 'focus') { runFocus(index, restArgs, config); return; }
   if (command === 'query') { runQuery(index, restArgs, config); return; }
   if (command === 'context') {
+    if (args.includes('--json')) {
+      const byStatus = {};
+      for (const s of config.statusOrder) {
+        const docs = index.docs.filter(d => d.status === s);
+        if (docs.length) byStatus[s] = docs;
+      }
+      const stale = index.docs.filter(d => d.isStale && !config.lifecycle.skipStaleFor.has(d.status));
+      process.stdout.write(JSON.stringify({
+        generatedAt: new Date().toISOString(),
+        docsByStatus: byStatus,
+        countsByStatus: index.countsByStatus,
+        stale: stale.map(d => ({ path: d.path, title: d.title, daysSinceUpdate: d.daysSinceUpdate })),
+        errorCount: index.errors.length,
+        warningCount: index.warnings.length,
+      }, null, 2) + '\n');
+      return;
+    }
     const summarize = args.includes('--summarize');
     const modelIdx = args.indexOf('--model');
     const model = modelIdx !== -1 && args[modelIdx + 1] ? args[modelIdx + 1] : undefined;
@@ -489,8 +550,20 @@ async function main() {
     return;
   }
 
-  // Unknown command — show help
-  die(`Unknown command: ${command}\n\n${HELP._main}`);
+  // Unknown command — suggest closest match
+  const allCommands = [
+    'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'context',
+    'focus', 'query', 'index', 'status', 'archive', 'touch', 'doctor',
+    'fix-refs', 'lint', 'rename', 'migrate', 'notion', 'export', 'summary',
+    'watch', 'diff', 'new', 'init', 'completions',
+  ];
+  const matches = allCommands
+    .map(c => ({ cmd: c, dist: levenshtein(command, c) }))
+    .sort((a, b) => a.dist - b.dist);
+  if (matches[0] && matches[0].dist <= 3) {
+    die(`Unknown command: ${command}\n\nDid you mean \`dotmd ${matches[0].cmd}\`?`);
+  }
+  die(`Unknown command: ${command}\n\nRun \`dotmd --help\` for available commands.`);
 }
 
 main().catch(err => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "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

@@ -1,5 +1,6 @@
 import { spawnSync } from 'node:child_process';
 import { warn } from './util.mjs';
+import { dim } from './color.mjs';
 
 let uvChecked = null;
 
@@ -11,10 +12,13 @@ export function checkUvAvailable() {
   return uvChecked;
 }
 
+export const DEFAULT_MODEL = 'mlx-community/Llama-3.2-3B-Instruct-4bit';
+
 export function runMLX(prompt, opts = {}) {
-  const { model = 'mlx-community/Llama-3.2-3B-Instruct-4bit', maxTokens = 200, timeout = 120000 } = opts;
+  const { model = DEFAULT_MODEL, maxTokens = 200, timeout = 120000 } = opts;
   if (!checkUvAvailable()) return null;
 
+  process.stderr.write(dim('  generating...'));
   const result = spawnSync('uv', [
     'run', '--with', 'mlx-lm',
     'python3', '-m', 'mlx_lm', 'generate',
@@ -24,6 +28,7 @@ export function runMLX(prompt, opts = {}) {
     '--verbose', 'false',
   ], { encoding: 'utf8', timeout });
 
+  process.stderr.write('\r\x1b[K');
   if (result.status !== 0) return null;
 
   const output = result.stdout.trim();

package/src/completions.mjs

@@ -14,22 +14,27 @@ const COMMAND_FLAGS = {
           '--checklist-open', '--sort', '--limit', '--all', '--git', '--json',
           '--summarize', '--summarize-limit', '--model'],
   index: ['--write'],
-  list: ['--verbose'],
+  list: ['--verbose', '--json'],
   coverage: ['--json'],
   new: ['--status', '--title', '--template', '--list-templates', '--root'],
-  diff: ['--stat', '--since', '--summarize', '--model'],
-  check: ['--errors-only', '--fix'],
+  diff: ['--stat', '--since', '--summarize', '--model', '--max-tokens'],
+  check: ['--errors-only', '--fix', '--json'],
   stats: ['--json'],
   graph: ['--dot', '--json', '--status', '--module', '--surface'],
   deps: ['--json', '--depth'],
   notion: ['import', 'export', 'sync', '--force', '--dry-run'],
   export: ['--format', '--output', '--status', '--module', '--root'],
+  focus: ['--json'],
+  status: [],
+  archive: [],
+  doctor: [],
+  watch: [],
   lint: ['--fix'],
   rename: [],
   migrate: [],
   'fix-refs': [],
   summary: ['--model', '--max-tokens', '--json'],
-  context: ['--summarize', '--model'],
+  context: ['--summarize', '--model', '--json'],
   touch: ['--git'],
 };
 

package/src/config.mjs

@@ -161,7 +161,7 @@ export async function resolveConfig(cwd, explicitConfigPath) {
     try {
       mod = await import(configUrl);
     } catch (err) {
-      die('Failed to load config: ' + configPath + '\n' + err.message + '\nRun `dotmd init` to create a starter config.');
+      die('Failed to load config: ' + configPath + '\n' + err.message + '\nCheck for syntax errors in your config file.');
     }
 
     configDir = path.dirname(configPath);

package/src/diff.mjs

@@ -3,7 +3,7 @@ import { extractFrontmatter, parseSimpleFrontmatter } from './frontmatter.mjs';
 import { asString, toRepoPath, resolveDocPath, die, warn } from './util.mjs';
 import { gitDiffSince } from './git.mjs';
 import { buildIndex } from './index.mjs';
-import { summarizeDiffText } from './ai.mjs';
+import { summarizeDiffText, DEFAULT_MODEL } from './ai.mjs';
 import { bold, dim, green } from './color.mjs';
 
 export function runDiff(argv, config) {
@@ -12,7 +12,7 @@ export function runDiff(argv, config) {
   let stat = false;
   let sinceOverride = null;
   let summarize = false;
-  let model = 'mlx-community/Llama-3.2-3B-Instruct-4bit';
+  let model = DEFAULT_MODEL;
 
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--stat') { stat = true; continue; }

package/src/export.mjs

@@ -5,13 +5,14 @@ import { buildIndex } from './index.mjs';
 import { buildGraph } from './graph.mjs';
 import { resolveDocPath, toRepoPath, capitalize, die } from './util.mjs';
 
-export function runExport(argv, config) {
+export function runExport(argv, config, opts = {}) {
   const positional = [];
   let format = 'md';
   let output = null;
   let statusFilter = null;
   let moduleFilter = null;
   let rootFilter = null;
+  const dryRun = opts.dryRun;
 
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--format' && argv[i + 1]) { format = argv[++i]; continue; }
@@ -62,26 +63,42 @@ export function runExport(argv, config) {
   // Load bodies
   const docsWithBody = docs.map(d => loadDocWithBody(d, config));
 
+  const prefix = dryRun ? '[dry-run] ' : '';
+
   if (format === 'md') {
-    const content = exportMarkdown(docsWithBody, config);
-    if (output) {
-      writeFileSync(output, content, 'utf8');
-      process.stdout.write(`Exported ${docs.length} docs to ${output}\n`);
+    if (dryRun) {
+      process.stdout.write(`${prefix}Would export ${docs.length} docs as markdown`);
+      process.stdout.write(output ? ` to ${output}\n` : ' to stdout\n');
     } else {
-      process.stdout.write(content);
+      const content = exportMarkdown(docsWithBody, config);
+      if (output) {
+        writeFileSync(output, content, 'utf8');
+        process.stdout.write(`Exported ${docs.length} docs to ${output}\n`);
+      } else {
+        process.stdout.write(content);
+      }
     }
   } else if (format === 'json') {
-    const content = exportJson(docsWithBody);
-    if (output) {
-      writeFileSync(output, content, 'utf8');
-      process.stdout.write(`Exported ${docs.length} docs to ${output}\n`);
+    if (dryRun) {
+      process.stdout.write(`${prefix}Would export ${docs.length} docs as JSON`);
+      process.stdout.write(output ? ` to ${output}\n` : ' to stdout\n');
     } else {
-      process.stdout.write(content);
+      const content = exportJson(docsWithBody);
+      if (output) {
+        writeFileSync(output, content, 'utf8');
+        process.stdout.write(`Exported ${docs.length} docs to ${output}\n`);
+      } else {
+        process.stdout.write(content);
+      }
     }
   } else if (format === 'html') {
     const outDir = output ?? 'dotmd-export';
-    exportHtml(docsWithBody, config, outDir);
-    process.stdout.write(`Exported ${docs.length} docs to ${outDir}/\n`);
+    if (dryRun) {
+      process.stdout.write(`${prefix}Would export ${docs.length} docs as HTML to ${outDir}/\n`);
+    } else {
+      exportHtml(docsWithBody, config, outDir);
+      process.stdout.write(`Exported ${docs.length} docs to ${outDir}/\n`);
+    }
   }
 }
 

package/src/index-file.mjs

@@ -1,4 +1,5 @@
 import { readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
 import { capitalize, escapeTable } from './util.mjs';
 import { formatSnapshot } from './render.mjs';
 
@@ -19,7 +20,7 @@ export function renderIndexFile(index, config) {
 
 function renderGeneratedBlock(index, config) {
   const lines = [];
-  const prefix = config.docsRootPrefix;
+  const indexDir = config.indexPath ? path.dirname(path.relative(config.repoRoot, config.indexPath)).split(path.sep).join('/') : '';
 
   for (const status of config.statusOrder) {
     const docs = index.docs.filter(doc => doc.status === status);
@@ -37,7 +38,7 @@ function renderGeneratedBlock(index, config) {
     lines.push('|-----|-----------------|');
     for (const doc of docs) {
       const snapshot = formatSnapshot(doc, config);
-      const linkPath = prefix ? doc.path.replace(prefix, '') : doc.path;
+      const linkPath = indexDir ? path.relative(indexDir, doc.path).split(path.sep).join('/') : doc.path;
       lines.push(`| [${escapeTable(doc.title)}](${linkPath}) | ${escapeTable(snapshot)} |`);
     }
     lines.push('');
@@ -49,7 +50,7 @@ function renderGeneratedBlock(index, config) {
 function renderArchivedSection(docs, config, status) {
   const lines = [];
   const limit = config.archivedHighlightLimit;
-  const prefix = config.docsRootPrefix;
+  const indexDir = config.indexPath ? path.dirname(path.relative(config.repoRoot, config.indexPath)).split(path.sep).join('/') : '';
   const highlights = docs
     .filter(doc => doc.currentState && doc.currentState !== 'No current_state set')
     .sort((a, b) => {
@@ -66,7 +67,7 @@ function renderArchivedSection(docs, config, status) {
   lines.push('| Doc | Status Snapshot |');
   lines.push('|-----|-----------------|');
   for (const doc of highlights) {
-    const linkPath = prefix ? doc.path.replace(prefix, '') : doc.path;
+    const linkPath = indexDir ? path.relative(indexDir, doc.path).split(path.sep).join('/') : doc.path;
     lines.push(`| [${escapeTable(doc.title)}](${linkPath}) | ${escapeTable(formatSnapshot(doc, config))} |`);
   }
   lines.push('');

package/src/lifecycle.mjs

@@ -6,18 +6,27 @@ import { gitMv, getGitLastModified } from './git.mjs';
 import { buildIndex, collectDocFiles } from './index.mjs';
 import { renderIndexFile, writeIndex } from './index-file.mjs';
 import { green, dim, yellow } from './color.mjs';
+import { isInteractive, promptChoice } from './prompt.mjs';
 
 function findFileRoot(filePath, config) {
   const roots = config.docsRoots || [config.docsRoot];
   return roots.find(r => filePath.startsWith(r)) ?? config.docsRoot;
 }
 
-export function runStatus(argv, config, opts = {}) {
+export async function runStatus(argv, config, opts = {}) {
   const { dryRun } = opts;
   const input = argv[0];
-  const newStatus = argv[1];
+  let newStatus = argv[1];
 
-  if (!input || !newStatus) { die('Usage: dotmd status <file> <new-status>'); }
+  if (!input) { die('Usage: dotmd status <file> <new-status>'); }
+  if (!newStatus) {
+    if (isInteractive()) {
+      newStatus = await promptChoice('Which status?', config.statusOrder);
+      if (!newStatus) die('No status selected.');
+    } else {
+      die('Usage: dotmd status <file> <new-status>');
+    }
+  }
   if (!config.validStatuses.has(newStatus)) { die(`Invalid status: ${newStatus}\nValid: ${[...config.validStatuses].join(', ')}`); }
 
   const filePath = resolveDocPath(input, config);

package/src/lint.mjs

@@ -3,6 +3,7 @@ import { extractFrontmatter, parseSimpleFrontmatter, replaceFrontmatter } from '
 import { asString, toRepoPath, escapeRegex, warn } from './util.mjs';
 import { buildIndex, collectDocFiles } from './index.mjs';
 import { updateFrontmatter } from './lifecycle.mjs';
+import { runMLX, checkUvAvailable } from './ai.mjs';
 import { bold, green, yellow, dim } from './color.mjs';
 
 const KEY_RENAMES = {
@@ -28,6 +29,11 @@ export function runLint(argv, config, opts = {}) {
     const repoPath = toRepoPath(filePath, config.repoRoot);
     const fixes = [];
 
+    // Missing status (fixable via AI inference)
+    if (!asString(parsed.status)) {
+      fixes.push({ field: 'status', oldValue: null, newValue: null, type: 'infer-status' });
+    }
+
     // Missing updated
     if (!asString(parsed.updated) && asString(parsed.status) && !config.lifecycle.skipWarningsFor.has(asString(parsed.status))) {
       const today = new Date().toISOString().slice(0, 10);
@@ -85,6 +91,8 @@ export function runLint(argv, config, opts = {}) {
         for (const f of fixes) {
           if (f.type === 'rename-key') {
             process.stdout.write(dim(`    ${f.oldValue} → ${f.newValue}\n`));
+          } else if (f.type === 'infer-status') {
+            process.stdout.write(dim(`    missing status (fixable via AI)\n`));
           } else if (f.type === 'split-to-array') {
             process.stdout.write(dim(`    ${f.field}: "${f.oldValue}" → surfaces: [${f.newValue.join(', ')}]\n`));
           } else if (f.type === 'eof') {
@@ -138,6 +146,20 @@ export function runLint(argv, config, opts = {}) {
     }
 
     if (!dryRun) {
+      // Apply infer-status fixes via AI
+      for (const f of fixes.filter(f => f.type === 'infer-status')) {
+        const raw = readFileSync(filePath, 'utf8');
+        const { body } = extractFrontmatter(raw);
+        const statusList = config.statusOrder.join(', ');
+        const prompt = `Given this markdown document, classify it into exactly one of these statuses: ${statusList}.\nReply with ONLY the status word, nothing else.\n\nFile: ${repoPath}\n\n${(body ?? '').slice(0, 4000)}`;
+        const result = runMLX(prompt, { maxTokens: 10 });
+        const suggested = result?.trim().toLowerCase().split(/\s+/)[0];
+        if (suggested && config.validStatuses.has(suggested)) {
+          updateFrontmatter(filePath, { status: suggested });
+          f.newValue = suggested;
+        }
+      }
+
       // Apply split-to-array fixes (surface: a, b → surfaces: array)
       for (const sa of splitToArray) {
         let raw = readFileSync(filePath, 'utf8');
@@ -199,6 +221,12 @@ export function runLint(argv, config, opts = {}) {
         process.stdout.write(`${prefix}  ${dim(`${f.oldValue} → ${f.newValue}`)}\n`);
       } else if (f.type === 'eof') {
         process.stdout.write(`${prefix}  ${dim('added newline at EOF')}\n`);
+      } else if (f.type === 'infer-status') {
+        if (f.newValue) {
+          process.stdout.write(`${prefix}  ${dim(`status: (missing) → ${f.newValue} (AI-inferred)`)}\n`);
+        } else {
+          process.stdout.write(`${prefix}  ${dim('status: (missing) — AI inference unavailable')}\n`);
+        }
       } else if (f.type === 'split-to-array') {
         process.stdout.write(`${prefix}  ${dim(`${f.field}: "${f.oldValue}" → surfaces: [${f.newValue.join(', ')}]`)}\n`);
       } else if (f.type === 'add') {

package/src/new.mjs

@@ -2,6 +2,7 @@ import { existsSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { toRepoPath, die, warn } from './util.mjs';
 import { green, dim, bold } from './color.mjs';
+import { isInteractive, promptText } from './prompt.mjs';
 
 const BUILTIN_TEMPLATES = {
   default: {
@@ -36,7 +37,7 @@ const BUILTIN_TEMPLATES = {
   },
 };
 
-export function runNew(argv, config, opts = {}) {
+export async function runNew(argv, config, opts = {}) {
   const { dryRun } = opts;
 
   // Parse args
@@ -50,6 +51,7 @@ export function runNew(argv, config, opts = {}) {
     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] === '--root' && argv[i + 1]) { rootName = argv[++i]; continue; }
+    if (argv[i] === '--config') { i++; continue; }
     if (argv[i] === '--list-templates') {
       listTemplates(config);
       return;
@@ -57,8 +59,15 @@ export function runNew(argv, config, opts = {}) {
     if (!argv[i].startsWith('-')) positional.push(argv[i]);
   }
 
-  const name = positional[0];
-  if (!name) { die('Usage: dotmd new <name> [--template <t>] [--status <s>] [--title <t>]\n       dotmd new --list-templates'); }
+  let name = positional[0];
+  if (!name) {
+    if (isInteractive()) {
+      name = await promptText('Document name: ');
+      if (!name) die('No name provided.');
+    } else {
+      die('Usage: dotmd new <name> [--template <t>] [--status <s>] [--title <t>]\n       dotmd new --list-templates');
+    }
+  }
 
   // Validate status
   if (!config.validStatuses.has(status)) {

package/src/prompt.mjs

@@ -0,0 +1,25 @@
+import { createInterface } from 'node:readline';
+
+export function isInteractive() {
+  return Boolean(process.stdin.isTTY);
+}
+
+export async function promptText(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  return new Promise(resolve => {
+    rl.question(question, answer => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+export async function promptChoice(question, options) {
+  process.stderr.write(question + '\n');
+  options.forEach((opt, i) => process.stderr.write(`  ${i + 1}) ${opt}\n`));
+  const answer = await promptText('> ');
+  const idx = parseInt(answer, 10) - 1;
+  if (idx >= 0 && idx < options.length) return options[idx];
+  const match = options.find(o => o.toLowerCase() === answer.toLowerCase());
+  return match ?? null;
+}

package/src/query.mjs

@@ -9,9 +9,14 @@ import { summarizeDocBody } from './ai.mjs';
 import { dim } from './color.mjs';
 
 export function runFocus(index, argv, config) {
-  const statusFilter = argv[0] ?? 'active';
+  const statusFilter = argv.find(a => !a.startsWith('-')) ?? 'active';
   const docs = index.docs.filter(doc => doc.status === statusFilter);
 
+  if (argv.includes('--json')) {
+    process.stdout.write(JSON.stringify({ status: statusFilter, count: docs.length, docs }, null, 2) + '\n');
+    return;
+  }
+
   if (docs.length === 0) {
     process.stdout.write(`No docs found for status: ${statusFilter}\n`);
     return;
@@ -139,7 +144,7 @@ function getDocSummary(doc, config) {
     const meta = { title: doc.title, status: doc.status, path: doc.path };
     return config.hooks.summarizeDoc
       ? config.hooks.summarizeDoc(body, meta)
-      : summarizeDocBody(body, meta, { model: undefined });
+      : summarizeDocBody(body, meta);
   } catch { return null; }
 }
 

package/src/rename.mjs

@@ -5,8 +5,9 @@ import { toRepoPath, resolveDocPath, die, warn } from './util.mjs';
 import { collectDocFiles } from './index.mjs';
 import { gitMv } from './git.mjs';
 import { green, dim, yellow } from './color.mjs';
+import { isInteractive, promptText } from './prompt.mjs';
 
-export function runRename(argv, config, opts = {}) {
+export async function runRename(argv, config, opts = {}) {
   const { dryRun } = opts;
 
   // Parse positional args (skip flags)
@@ -17,10 +18,16 @@ export function runRename(argv, config, opts = {}) {
   }
 
   const oldInput = positional[0];
-  const newInput = positional[1];
-
-  if (!oldInput || !newInput) {
-    die('Usage: dotmd rename <old> <new>');
+  let newInput = positional[1];
+
+  if (!oldInput) { die('Usage: dotmd rename <old> <new>'); }
+  if (!newInput) {
+    if (isInteractive()) {
+      newInput = await promptText('New name: ');
+      if (!newInput) die('No name provided.');
+    } else {
+      die('Usage: dotmd rename <old> <new>');
+    }
   }
 
   // Resolve old path

package/src/util.mjs

@@ -70,6 +70,21 @@ export function die(message) {
   throw new DotmdError(message);
 }
 
+export function levenshtein(a, b) {
+  if (a.length === 0) return b.length;
+  if (b.length === 0) return a.length;
+  const matrix = [];
+  for (let i = 0; i <= b.length; i++) matrix[i] = [i];
+  for (let j = 0; j <= a.length; j++) matrix[0][j] = j;
+  for (let i = 1; i <= b.length; i++) {
+    for (let j = 1; j <= a.length; j++) {
+      const cost = b[i - 1] === a[j - 1] ? 0 : 1;
+      matrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + cost);
+    }
+  }
+  return matrix[b.length][a.length];
+}
+
 export function resolveDocPath(input, config) {
   if (!input) return null;
   if (path.isAbsolute(input)) return existsSync(input) ? input : null;

package/src/validate.mjs

@@ -13,15 +13,18 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
     doc.warnings.push({ path: doc.path, level: 'warning', message: `Unknown status \`${doc.status}\`; not in statuses.order.` });
   }
 
-  if (!config.lifecycle.skipWarningsFor.has(doc.status) && !doc.updated) {
+  // Only enforce lifecycle fields for known statuses (skip for unknown like implemented, partial, etc.)
+  const knownStatus = config.validStatuses.has(doc.status);
+
+  if (knownStatus && !config.lifecycle.skipWarningsFor.has(doc.status) && !doc.updated) {
     doc.errors.push({ path: doc.path, level: 'error', message: 'Missing frontmatter `updated` for non-archived doc.' });
   }
 
-  if (doc.auditLevel && doc.auditLevel !== 'none' && !doc.audited) {
+  if (knownStatus && doc.auditLevel && doc.auditLevel !== 'none' && !doc.audited) {
     doc.errors.push({ path: doc.path, level: 'error', message: '`audit_level` is set without `audited`.' });
   }
 
-  if (doc.auditLevel === 'none' && doc.audited) {
+  if (knownStatus && doc.auditLevel === 'none' && doc.audited) {
     doc.errors.push({ path: doc.path, level: 'error', message: '`audit_level: none` cannot be combined with `audited`.' });
   }