dotmd-cli 0.12.0 → 0.13.0

package/README.md

@@ -113,7 +113,8 @@ dotmd coverage [--json]      Metadata coverage report
 dotmd stats [--json]         Doc health dashboard
 dotmd graph [--dot|--json]   Visualize document relationships
 dotmd deps [file]            Dependency tree or overview
-dotmd context [--summarize]  Compact briefing (LLM-oriented)
+dotmd briefing               Compact summary for session start
+dotmd context [--summarize]  Full briefing (LLM-oriented)
 dotmd focus [status]         Detailed view for one status group
 dotmd query [filters]        Filtered search
 dotmd plans                  List all plans

package/bin/dotmd.mjs

@@ -5,7 +5,7 @@ import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 import { resolveConfig } from '../src/config.mjs';
 import { buildIndex } from '../src/index.mjs';
-import { renderCompactList, renderVerboseList, renderContext, renderCheck, renderCoverage, buildCoverage } from '../src/render.mjs';
+import { renderCompactList, renderVerboseList, renderContext, renderBriefing, renderCheck, renderCoverage, buildCoverage } from '../src/render.mjs';
 import { renderIndexFile, writeIndex } from '../src/index-file.mjs';
 import { runFocus, runQuery } from '../src/query.mjs';
 import { runStatus, runArchive, runTouch, runBulkArchive, runPickup, runFinish } from '../src/lifecycle.mjs';
@@ -39,7 +39,8 @@ const HELP = {
 View & Query:
   list [--verbose] [--json]         List docs grouped by status (default command)
   json                              Full index as JSON
-  context [--summarize] [--json]    Compact briefing (LLM-oriented)
+  briefing [--json]                 Compact summary for session start (5-10 lines)
+  context [--summarize] [--json]    Full briefing (LLM-oriented)
   focus [status] [--json]           Detailed view for one status group
   query [filters] [--json]          Filtered search (--status, --keyword, --stale, etc.)
   coverage [--json]                 Metadata coverage report
@@ -191,7 +192,15 @@ Shows detailed info for all docs matching the given status (default: active).
 Options:
   --json                 Output as JSON`,
 
-  context: `dotmd context — compact briefing (LLM-oriented)
+  briefing: `dotmd briefing — compact summary for session start
+
+Shows plan statuses with next steps, doc/research counts, and health
+in 5-10 lines. Designed for LLM context injection.
+
+Options:
+  --json                 Output as JSON`,
+
+  context: `dotmd context — full briefing (LLM-oriented)
 
 Generates a compact status briefing designed for AI/LLM consumption.
 
@@ -648,6 +657,24 @@ async function main() {
 
   if (command === 'focus') { runFocus(index, restArgs, config); return; }
   if (command === 'query') { runQuery(index, restArgs, config); return; }
+  if (command === 'briefing') {
+    if (args.includes('--json')) {
+      const plans = index.docs.filter(d => d.type === 'plan');
+      const docs = index.docs.filter(d => d.type === 'doc');
+      const research = index.docs.filter(d => d.type === 'research');
+      const stale = index.docs.filter(d => d.isStale && !config.lifecycle.skipStaleFor.has(d.status)).length;
+      process.stdout.write(JSON.stringify({
+        plans: { total: plans.length, inSession: plans.filter(d => d.status === 'in-session').map(d => ({ path: d.path, title: d.title, nextStep: d.nextStep })), active: plans.filter(d => d.status === 'active').map(d => ({ path: d.path, title: d.title, nextStep: d.nextStep })) },
+        docs: { total: docs.length, active: docs.filter(d => !config.lifecycle.terminalStatuses.has(d.status)).length },
+        research: { total: research.length, active: research.filter(d => d.status === 'active').length },
+        stale, errorCount: index.errors.length, warningCount: index.warnings.length,
+      }, null, 2) + '\n');
+    } else {
+      process.stdout.write(renderBriefing(index, config));
+    }
+    return;
+  }
+
   if (command === 'context') {
     const summarize = args.includes('--summarize');
     const modelIdx = args.indexOf('--model');
@@ -723,7 +750,7 @@ async function main() {
 
   // Unknown command — suggest closest match
   const allCommands = [
-    'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'context',
+    'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'briefing', 'context',
     'focus', 'query', 'plans', 'stale', 'actionable', 'index', 'pickup', 'finish', 'status', 'archive', 'touch', 'doctor',
     'fix-refs', 'lint', 'rename', 'migrate', 'notion', 'export', 'summary',
     'watch', 'diff', 'new', 'init', 'completions',

package/package.json

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

package/src/completions.mjs

@@ -1,7 +1,7 @@
 import { die } from './util.mjs';
 
 const COMMANDS = [
-  'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'unblocks', 'health', 'glossary', 'context', 'focus', 'query',
+  'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'unblocks', 'health', 'glossary', 'briefing', 'context', 'focus', 'query',
   'plans', 'stale', 'actionable', 'index', 'pickup', 'finish', 'status', 'archive', 'bulk', 'touch', 'doctor', 'lint', 'rename', 'migrate',
   'fix-refs', 'notion', 'export', 'summary', 'watch', 'diff', 'init', 'new', 'completions',
 ];
@@ -32,6 +32,7 @@ const COMMAND_FLAGS = {
   plans: ['--status', '--json', '--sort', '--limit', '--all', '--stale', '--has-next-step'],
   stale: ['--json', '--sort', '--limit', '--all'],
   actionable: ['--json', '--sort', '--limit', '--all'],
+  briefing: ['--json'],
   pickup: ['--json'],
   finish: ['--json'],
   status: [],

package/src/render.mjs

@@ -258,6 +258,44 @@ function _renderContext(index, config, opts = {}) {
   return `${lines.join('\n').trimEnd()}\n`;
 }
 
+export function renderBriefing(index, config) {
+  const lines = [];
+  const plans = index.docs.filter(d => d.type === 'plan');
+  const docs = index.docs.filter(d => d.type === 'doc');
+  const research = index.docs.filter(d => d.type === 'research');
+  const untyped = index.docs.filter(d => !d.type);
+
+  if (plans.length) {
+    const bySt = {};
+    for (const p of plans) { bySt[p.status] = (bySt[p.status] ?? 0) + 1; }
+    const counts = Object.entries(bySt).map(([s, n]) => `${n} ${s}`).join(', ');
+    lines.push(`${plans.length} plans: ${counts}`);
+    const show = plans.filter(p => p.status === 'in-session' || p.status === 'active');
+    for (const p of show) {
+      const next = p.nextStep ? `next: ${p.nextStep}` : '(no next step)';
+      lines.push(`  > ${path.basename(p.path, '.md')} (${p.status}) ${next}`);
+    }
+  }
+
+  const parts = [];
+  if (docs.length) {
+    const active = docs.filter(d => !config.lifecycle.terminalStatuses.has(d.status)).length;
+    const rest = docs.length - active;
+    parts.push(`${active} docs active` + (rest ? `, ${rest} other` : ''));
+  }
+  if (research.length) {
+    const active = research.filter(d => d.status === 'active').length;
+    parts.push(`${active} research active`);
+  }
+  if (untyped.length) parts.push(`${untyped.length} untyped`);
+  if (parts.length) lines.push(parts.join(' | '));
+
+  const stale = index.docs.filter(d => d.isStale && !config.lifecycle.skipStaleFor.has(d.status)).length;
+  lines.push(`Stale: ${stale} | Errors: ${index.errors.length} | Warnings: ${index.warnings.length}`);
+
+  return lines.join('\n') + '\n';
+}
+
 export function renderCheck(index, config, opts = {}) {
   const defaultRenderer = (idx) => _renderCheck(idx, opts);
   if (config.hooks.renderCheck) {