dotmd-cli 0.36.0 → 0.36.2

package/package.json

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

package/src/config.mjs

@@ -158,6 +158,16 @@ function normalizeRichStatuses(config, userConfig) {
       const quietImpliesSkipStale = p.quiet && p.skipStale !== false;
       const quietImpliesSkipWarnings = p.quiet && p.skipWarnings !== false;
 
+      // Contradiction diagnostics — emit at load so dead config doesn't fail silently.
+      const skipStaleEffective = p.skipStale === true || quietImpliesSkipStale;
+      const skipWarningsEffective = p.skipWarnings === true || quietImpliesSkipWarnings;
+      if (skipStaleEffective && p.staleDays != null) {
+        warn(`dotmd config: status "${typeName}.${name}" has skipStale: true and staleDays: ${p.staleDays} — staleDays is ignored. Drop one to silence this warning.`);
+      }
+      if (skipWarningsEffective && p.requiresModule) {
+        warn(`dotmd config: status "${typeName}.${name}" has skipWarnings: true and requiresModule: true — the module requirement can never fire. Drop one to silence this warning.`);
+      }
+
       if (p.archive && !derived.archiveStatuses.includes(name)) derived.archiveStatuses.push(name);
       if ((p.skipStale || quietImpliesSkipStale) && !derived.skipStaleFor.includes(name)) derived.skipStaleFor.push(name);
       if ((p.skipWarnings || quietImpliesSkipWarnings) && !derived.skipWarningsFor.includes(name)) derived.skipWarningsFor.push(name);

package/src/glossary.mjs

@@ -7,7 +7,7 @@ import { bold, dim, green, yellow } from './color.mjs';
 function parseGlossaryTable(content, sectionHeading) {
   const headingRegex = new RegExp(`^##\\s+${sectionHeading.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`, 'm');
   const match = content.match(headingRegex);
-  if (!match) return [];
+  if (!match) return { found: false, entries: [] };
 
   const sectionStart = match.index + match[0].length;
   const nextHeading = content.indexOf('\n## ', sectionStart);
@@ -47,7 +47,7 @@ function parseGlossaryTable(content, sectionHeading) {
     entries.push({ term: m[1], meaning: `UI label: "${m[2]}"${m[3] ? ` (${m[3]})` : ''}`, tiers: 'schema→UI' });
   }
 
-  return entries;
+  return { found: true, entries };
 }
 
 function loadGlossary(config) {
@@ -62,7 +62,8 @@ function loadGlossary(config) {
 
   const content = readFileSync(filePath, 'utf8');
   const section = glossaryConfig.section ?? 'Terminology';
-  return parseGlossaryTable(content, section);
+  const result = parseGlossaryTable(content, section);
+  return { ...result, path: glossaryConfig.path, section };
 }
 
 function matchTerm(query, entries) {
@@ -177,9 +178,15 @@ export function runGlossary(argv, config) {
   const listAll = argv.includes('--list');
   const term = argv.find(a => !a.startsWith('-'));
 
-  const entries = loadGlossary(config);
-  if (!entries) die('No glossary configured. Add glossary: { path, section } to your dotmd config.');
-  if (entries.length === 0) die('Glossary section found but no entries parsed.');
+  const result = loadGlossary(config);
+  if (!result) die('No glossary configured. Add glossary: { path, section } to your dotmd config.');
+  if (!result.found) {
+    die(`Glossary section "## ${result.section}" not found in ${result.path}. Add the section, or update glossary.section in dotmd.config.mjs.`);
+  }
+  if (result.entries.length === 0) {
+    die(`Glossary section "## ${result.section}" found in ${result.path} but contains no recognizable entries (expected markdown table or schema→UI bullets).`);
+  }
+  const entries = result.entries;
 
   if (json && listAll) {
     const index = buildIndex(config);

package/src/lifecycle.mjs

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { extractFrontmatter, parseSimpleFrontmatter, replaceFrontmatter } from './frontmatter.mjs';
-import { asString, toRepoPath, die, warn, resolveDocPath, resolveRefPath, escapeRegex, nowIso } from './util.mjs';
+import { asString, toRepoPath, die, warn, resolveDocPath, resolveRefPath, escapeRegex, nowIso, suggestCandidates } from './util.mjs';
 import { gitMv, getGitLastModified, getGitLastModifiedBatch } from './git.mjs';
 import { buildIndex, collectDocFiles } from './index.mjs';
 import { renderIndexFile, writeIndex } from './index-file.mjs';
@@ -101,7 +101,11 @@ export async function runStatus(argv, config, opts = {}) {
     }
   }
 
-  if (!effectiveValid.has(newStatus)) { die(`Invalid status: ${newStatus}\nValid: ${[...effectiveValid].join(', ')}`); }
+  if (!effectiveValid.has(newStatus)) {
+    const suggestions = suggestCandidates(newStatus, [...effectiveValid]);
+    const hint = suggestions.length ? `\nDid you mean: ${suggestions.join(', ')}?` : '';
+    die(`Invalid status: ${newStatus}\nValid: ${[...effectiveValid].join(', ')}${hint}`);
+  }
 
   const oldStatus = asString(parsedFm.status);
 

package/src/new.mjs

@@ -69,14 +69,27 @@ ${ctx?.bodyInput?.trim() ?? ''}
       'current_state:',
       'next_step:',
     ].join('\n'),
-    body: (t, ctx) => `
+    body: (t, ctx) => {
+      const bodyInput = ctx?.bodyInput?.trim() ?? '';
+      // Full-body shortcut: if the input already authors `## Section` headings,
+      // it's a complete plan body the user/agent wrote start-to-finish. Drop
+      // the scaffold's later sections to avoid duplicate empty `## Goals`,
+      // `## Phases`, etc. below the user's already-filled versions. A bare title
+      // (`# X`) at the head of the body is honored — we don't double-print the
+      // scaffold's title. Otherwise emit the scaffold and slot the body into
+      // `## Problem` as before (section-content mode).
+      if (/^##\s+\S/m.test(bodyInput)) {
+        const hasOwnTitle = /^#\s+\S/.test(bodyInput);
+        return hasOwnTitle ? `\n${bodyInput}\n` : `\n# ${t}\n\n${bodyInput}\n`;
+      }
+      return `
 # ${t}
 
 > One-paragraph problem statement: what this plan is for, why now.
 
 ## Problem
 
-${ctx?.bodyInput?.trim() ?? ''}
+${bodyInput}
 
 ## Goals
 
@@ -128,7 +141,8 @@ Status markers (put in heading text):
 ## Closeout
 
 <!-- Filled on archive: what shipped, key commits, deferrals dispositioned. -->
-`,
+`;
+    },
   },
   prompt: {
     description: 'Saved prompt to seed a future Claude session — body is required',

package/src/query.mjs

@@ -251,7 +251,13 @@ function getDocSummary(doc, config) {
 
 function renderQueryResults(docs, filters, config) {
   process.stdout.write('Query\n\n');
-  process.stdout.write(`- results: ${docs.length}\n`);
+  const total = filters._totalBeforeLimit ?? docs.length;
+  const truncated = !filters.all && total > docs.length;
+  if (truncated) {
+    process.stdout.write(`- results: ${docs.length} of ${total} ${dim('(use --all to see all)')}\n`);
+  } else {
+    process.stdout.write(`- results: ${docs.length}\n`);
+  }
   if (filters.types?.length) process.stdout.write(`- type: ${filters.types.join(', ')}\n`);
   if (filters.statuses?.length) process.stdout.write(`- status: ${filters.statuses.join(', ')}\n`);
   if (filters.keyword) process.stdout.write(`- keyword: ${filters.keyword}\n`);
@@ -381,12 +387,13 @@ function renderPlansOutput(docs, filters, config, opts = {}) {
     // Triage view: flat, sorted by recency, tag on right.
     process.stdout.write('\n');
     renderPlanRows(docs, filters, maxWidth, { showTag: true });
-    // Footer when the result was capped.
-    const hidden = totalAll - totalShown;
-    if (hidden > 0) {
-      process.stdout.write('\n');
-      process.stdout.write(dim(`  ${hidden} more ${noun}  ·  dotmd ${noun} --all  ·  dotmd ${noun} status\n`));
-    }
+  }
+
+  // Footer when the result was capped — emit for every view shape.
+  const hidden = totalAll - totalShown;
+  if (hidden > 0) {
+    process.stdout.write('\n');
+    process.stdout.write(dim(`  ${hidden} more ${noun}  ·  dotmd ${noun} --all  ·  dotmd ${noun} status\n`));
   }
 
   process.stdout.write('\n');

package/src/render.mjs

@@ -275,7 +275,13 @@ function _renderContext(index, config, opts = {}) {
 
   const stale = index.docs.filter(d => d.isStale && !config.lifecycle.skipStaleFor.has(d.status));
   if (stale.length) {
-    lines.push(`Stale: ${stale.map(d => `${toSlug(d)} (${d.daysSinceUpdate}d)`).join(', ')}`);
+    const cap = config.context?.staleTailLimit ?? 8;
+    const shown = stale.slice(0, cap).map(d => `${toSlug(d)} (${d.daysSinceUpdate}d)`).join(', ');
+    const overflow = stale.length - cap;
+    const tail = overflow > 0
+      ? `${shown}, …and ${overflow} more (run \`dotmd stale\` for the full list)`
+      : shown;
+    lines.push(`Stale: ${tail}`);
   } else {
     lines.push('Stale: none');
   }