dotmd-cli 0.87.1 → 0.87.2

package/README.md

@@ -97,20 +97,21 @@ Restart Claude Code, or run `/reload-plugins`, after a plugin update.
 ```bash
 runlist init                    # create config, docs/, and the generated index
 runlist new plan auth-refresh  # scaffold a typed document
-runlist briefing               # compact active-work orientation
-runlist plans                  # live plan dashboard
+runlist plans                  # compact live plan dashboard
+runlist briefing               # comprehensive active-work view
 runlist check                  # validate schema, references, and lifecycle shape
 runlist doctor                 # preview repairs; add --apply to write
 ```
 
-`runlist briefing` is the compact orientation view. `runlist context` is the fuller
+`runlist plans` is the compact orientation view. `runlist briefing` lists live
+plans with next steps and grows with the corpus. `runlist context` is the fuller
 human/LLM briefing, while `runlist agent-context` emits bounded structured JSON for
 agent integrations.
 
 ## Core Workflow
 
 ```bash
-runlist briefing
+runlist plans
 runlist use docs/plans/auth-refresh.md
 runlist set awaiting docs/plans/auth-refresh.md --note "Need API owner decision"
 runlist set active docs/plans/auth-refresh.md --note "Decision received"

package/bin/dotmd.mjs

@@ -676,10 +676,11 @@ Options:
   --json                 Output as JSON ({ owned, prompts, errors, previousSelf,
                          fleet, recentRejections, misuseRecap, drift })`,
 
-  briefing: `runlist briefing — compact summary for session start
+  briefing: `runlist briefing — comprehensive live-work summary
 
-Shows plan statuses with next steps, doc/research counts, and health
-in 5-10 lines. Designed for LLM context injection.
+Shows every live plan with its next step, plus doc/research counts and health.
+Output grows with the corpus; use \`runlist plans\` for compact orientation or
+\`runlist agent-context\` for structured agent context.
 
 Options:
   --json                 Output as JSON`,
@@ -1983,7 +1984,15 @@ async function main() {
   if (command === 'glossary') { const { runGlossary } = await import('../src/glossary.mjs'); runGlossary(restArgs, config); return; }
   if (command === 'model') { const { runModel } = await import('../src/model.mjs'); await runModel(restArgs, config); return; }
   if (command === 'show') { const { runShow } = await import('../src/show.mjs'); runShow(restArgs, config); return; }
-  if (command === 'decisions') { const { runDecisions } = await import('../src/decisions.mjs'); runDecisions(restArgs, config); return; }
+  if (command === 'decisions') {
+    const { runDecisions } = await import('../src/decisions.mjs');
+    const result = runDecisions(restArgs, config);
+    if (result?.defects?.length) {
+      const first = result.defects[0];
+      _exitFailureMessage = `${result.defects.length} decision defect(s); first: ${first.doc}:${first.line} ${first.message}`;
+    }
+    return;
+  }
   if (command === 'export') { const { runExport } = await import('../src/export.mjs'); runExport(restArgs, config, { dryRun, root: rootArg, type: typeArg }); return; }
 
   // Lifecycle commands
@@ -2175,7 +2184,10 @@ async function main() {
         writeCheckPreviewNote();
         process.stdout.write('\n' + renderCheck(freshIndex, config, { errorsOnly, noCollapse, verbose }));
       }
-      if (freshIndex.errors.length > 0) process.exitCode = 1;
+      if (freshIndex.errors.length > 0) {
+        process.exitCode = 1;
+        _exitFailureMessage = checkFailureSummary(freshIndex.errors);
+      }
       return;
     }
 
@@ -2185,13 +2197,19 @@ async function main() {
 
     if (args.includes('--json')) {
       process.stdout.write(JSON.stringify(checkJson(index), null, 2) + '\n');
-      if (index.errors.length > 0) process.exitCode = 1;
+      if (index.errors.length > 0) {
+        process.exitCode = 1;
+        _exitFailureMessage = checkFailureSummary(index.errors);
+      }
       return;
     }
 
     writeCheckPreviewNote();
     process.stdout.write(renderCheck(index, config, { errorsOnly, noCollapse, verbose }));
-    if (index.errors.length > 0) process.exitCode = 1;
+    if (index.errors.length > 0) {
+      process.exitCode = 1;
+      _exitFailureMessage = checkFailureSummary(index.errors);
+    }
     return;
   }
 
@@ -2416,9 +2434,15 @@ async function main() {
 let _resolvedConfig = null;
 let _resolvedCommand = null;
 let _suppressObservability = false;
+let _exitFailureMessage = null;
 const _startMs = Date.now();
 const _invocationArgs = process.argv.slice(2);
 
+function checkFailureSummary(errors) {
+  const first = errors[0];
+  return `${errors.length} check error(s); first: ${first.path ? `${first.path}: ` : ''}${first.message}`;
+}
+
 function _journalExit(err) {
   if (_suppressObservability || _resolvedCommand === 'hud' || _invocationArgs.includes('--dry-run') || _invocationArgs.includes('-n')) return;
   try {
@@ -2433,7 +2457,7 @@ function _journalExit(err) {
   // A command that reports its own failure through the exit code (check with
   // errors, a failed update step) is a failure too.
   const code = Number(process.exitCode ?? 0);
-  const failure = err ?? (code !== 0 ? { name: 'ExitStatus', message: `exited with status ${code}` } : null);
+  const failure = err ?? (code !== 0 ? { name: 'ExitStatus', message: _exitFailureMessage ?? `exited with status ${code}` } : null);
   if (failure) {
     try {
       recordGlobalError({

package/package.json

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

package/src/baton.mjs

@@ -65,7 +65,7 @@ function pendingHandoffs(promptPath, planPath, config) {
 function refusePendingHandoff(pending) {
   const lines = pending.map(p => `  ${p}`).join('\n');
   const slug = path.basename(pending[0], '.md');
-  die(`Nothing saved: a handoff for this is already pending:\n${lines}\nUse it (\`runlist use ${slug}\`) or archive it (\`runlist prompts archive ${pending[0]}\`), then run baton again.`);
+  die(`Nothing saved: a handoff for this is already pending:\n${lines}\nInspect it with \`runlist prompts show ${slug}\`. If it is current, keep it and do not hand off again. If it is stale, run \`runlist prompts archive ${pending[0]}\`, then run baton again.`);
 }
 
 // Is this positional a filesystem reference (must resolve, typos die) or a

package/src/decisions.mjs

@@ -689,7 +689,7 @@ export function runDecisions(args, config) {
       process.stdout.write(`${items.length} decision items in ${docs.length} documents; ${defects.length} defects.\n`);
     }
     if (defects.length) process.exitCode = 1;
-    return;
+    return { defects };
   }
 
   let docFilter = null;