dotmd-cli 0.36.1 → 0.36.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.36.1",
+  "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/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');
   }