dotmd-cli 0.40.0 → 0.40.1

package/bin/dotmd.mjs

@@ -335,15 +335,19 @@ Use --dry-run (-n) to preview changes without writing anything.`,
 
   check: `dotmd check — validate frontmatter and references
 
+By default the warning list is suppressed: you see counts plus a one-line
+pointer to \`dotmd doctor\` (auto-fix) or \`dotmd check --verbose\`
+(per-doc detail). Errors are always shown in full.
+
 Options:
-  --errors-only          Show only errors, suppress warnings
+  --verbose              Show every warning per-doc (with category collapse
+                         applied — high-frequency auto-fixable categories
+                         summarize to a one-line bulk-fix hint).
+  --no-collapse          Like --verbose but disables category collapse too —
+                         every warning prints raw.
+  --errors-only          Show only errors, suppress warnings entirely
   --fix                  Auto-fix broken refs, lint issues, and regenerate index
-  --json                 Output errors and warnings as JSON
-  --no-collapse          Show every warning per-doc (since 0.37.0, high-frequency
-                         auto-fixable warning categories — singular module/surface
-                         deprecations, updated-behind-git — are collapsed into a
-                         one-line summary with the bulk-fix command). --json output
-                         is unchanged regardless.
+  --json                 Output errors and warnings as JSON (always full detail)
   --dry-run, -n          Preview fixes without writing (with --fix)`,
 
   archive: `dotmd archive <file> — archive a document
@@ -1219,6 +1223,7 @@ async function main() {
     const fix = args.includes('--fix');
     const errorsOnly = args.includes('--errors-only');
     const noCollapse = args.includes('--no-collapse');
+    const verbose = args.includes('--verbose');
 
     if (fix) {
       // Auto-fix: broken refs, then lint, then rebuild index
@@ -1249,7 +1254,7 @@ async function main() {
           passed: freshIndex.errors.length === 0,
         }, null, 2) + '\n');
       } else {
-        process.stdout.write('\n' + renderCheck(freshIndex, config, { errorsOnly, noCollapse }));
+        process.stdout.write('\n' + renderCheck(freshIndex, config, { errorsOnly, noCollapse, verbose }));
       }
       if (freshIndex.errors.length > 0) process.exitCode = 1;
       return;
@@ -1268,7 +1273,7 @@ async function main() {
       return;
     }
 
-    process.stdout.write(renderCheck(index, config, { errorsOnly, noCollapse }));
+    process.stdout.write(renderCheck(index, config, { errorsOnly, noCollapse, verbose }));
     if (index.errors.length > 0) process.exitCode = 1;
     return;
   }

package/package.json

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

package/src/render.mjs

@@ -377,7 +377,7 @@ export function renderCheck(index, config, opts = {}) {
 }
 
 function _renderCheck(index, opts = {}) {
-  const { errorsOnly, noCollapse } = opts;
+  const { errorsOnly, noCollapse, verbose } = opts;
   const lines = ['Check', ''];
   lines.push(`- docs scanned: ${index.docs.length}`);
   lines.push(`- errors: ${index.errors.length}`);
@@ -392,22 +392,32 @@ function _renderCheck(index, opts = {}) {
     lines.push('');
   }
 
+  // Warnings: terse by default — print count + pointer. The full per-doc list
+  // grew long enough on real projects that it drowned the summary; agents now
+  // see warnings as a single line and opt in to detail when they need it.
+  // --verbose / --no-collapse expand to the full list (with collapse-by-category
+  // still applied unless --no-collapse is set).
   if (!errorsOnly && index.warnings.length > 0) {
-    lines.push(yellow('Warnings'));
-    if (noCollapse) {
-      for (const issue of index.warnings) {
-        lines.push(`- ${issue.path}: ${issue.message}`);
+    if (verbose || noCollapse) {
+      lines.push(yellow('Warnings'));
+      if (noCollapse) {
+        for (const issue of index.warnings) {
+          lines.push(`- ${issue.path}: ${issue.message}`);
+        }
+      } else {
+        const { passthrough, collapsed } = categorizeWarnings(index.warnings);
+        for (const issue of passthrough) {
+          lines.push(`- ${issue.path}: ${issue.message}`);
+        }
+        for (const sum of collapsed) {
+          lines.push(`- ${sum.count} ${sum.label} — run \`${sum.fix}\` to bulk-fix`);
+        }
       }
+      lines.push('');
     } else {
-      const { passthrough, collapsed } = categorizeWarnings(index.warnings);
-      for (const issue of passthrough) {
-        lines.push(`- ${issue.path}: ${issue.message}`);
-      }
-      for (const sum of collapsed) {
-        lines.push(`- ${sum.count} ${sum.label} — run \`${sum.fix}\` to bulk-fix`);
-      }
+      lines.push(dim(`Run \`dotmd check --verbose\` for per-doc detail, or \`dotmd doctor\` to auto-fix where possible.`));
+      lines.push('');
     }
-    lines.push('');
   }
 
   if (index.errors.length === 0 && index.warnings.length === 0) {