dotmd-cli 0.42.1 → 0.44.0

package/bin/dotmd.mjs

@@ -14,6 +14,26 @@ const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'),
 const HELP = {
   _main: `dotmd v${pkg.version} — frontmatter markdown document manager
 
+Common commands:
+  plans                 Live plans (excludes archived)
+  briefing              Full briefing with plan counts + next steps
+  set <status> [file]   Transition status (start work, finish, archive — all via target status)
+  new <type> <name>     Create plan/doc/prompt (pipe stdin or @path for body)
+  archive <file>        Close out a plan (status → archived, move, update refs)
+  prompts [next|use|new]  Manage saved prompts
+
+More help:
+  dotmd help all        Full command list
+  dotmd help statuses   Status vocabulary + transitions
+  dotmd <cmd> --help    Per-command details
+
+Global flags: --config <path>  --root <name>  --type <t,…>  --dry-run/-n  --verbose  --version`,
+
+  // Full command list — opt-in via \`dotmd help all\`. Kept exhaustive so the
+  // top-level \`--help\` can stay terse without losing discoverability. When you
+  // add a new command, add it here too.
+  'help:all': `dotmd v${pkg.version} — full command list
+
 View & Query:
   hud [--json]                      Two-line actionable triage (held / prompts / stuck) — silent when clean
   list [--verbose] [--json]         List docs grouped by status (default command)
@@ -42,17 +62,14 @@ Analyze:
   glossary <term> [--list] [--json] Look up domain terms + related docs
 
 Validate & Fix:
-  check [--fix] [--errors-only] [--json]  Validate frontmatter and references
   doctor [--apply]                  Auto-fix everything: refs, lint, dates, index (preview by default)
   lint [--fix]                      Check and auto-fix frontmatter issues
   fix-refs [--dry-run]              Auto-fix broken reference paths + body links
 
 Lifecycle:
-  pickup <file> [--takeover]        Pick up a plan (set in-session + print body)
-  release [<file>] [--to <s>]       Release in-session lease (alias: unpickup)
+  set <status> [<file>]             Unified transition: archive/release/start/transition in one verb
   runlist <hub> [next]              Show or walk an ordered group of plans (see \`dotmd help runlist\`)
   status <file> <status>            Transition document status (deprecated; prefer \`set\`)
-  set <status> [<file>]             Unified transition: archive/release/transition in one verb
   archive <file>                    Archive (status + move + update refs)
   bulk archive <f1> <f2> ...        Archive multiple files at once
   ship [patch|minor|major]          Regen + commit + bump in one step (default: patch)
@@ -636,16 +653,17 @@ Types and their default destinations:
 \`<name>\` is slugified for the filename.
 
 Body input (all built-in types — required for prompt, optional for plan/doc):
-  @path                  Read body from a file (preferred for multi-line bodies)
-  -                      Read body from stdin (heredoc-friendly for agents)
-  --message "<text>"     Explicit inline body
+  piped stdin            Auto-consumed when stdin is piped/redirected (no flag needed)
+  @path                  Read body from a file
+  -                      Explicit stdin marker (equivalent to piped stdin)
+  --body "<text>"        Explicit inline body (alias: --message)
   <text>                 Inline body as 3rd positional
 
-Tip for agents: prefer \`@path\` or \`-\` for multi-line bodies. Inline bodies
-put the entire content on the bash command line, which (a) breaks under shell
-quoting for backticks/dollar-signs and (b) trips PreToolUse hooks that scan
-command strings for forbidden literals (destructive-git patterns, etc.).
-\`@/tmp/foo.md\` sidesteps both.
+Tip for agents: prefer piped stdin or \`@path\` for multi-line bodies. Inline
+bodies put the entire content on the bash command line, which (a) breaks
+under shell quoting for backticks/dollar-signs and (b) trips PreToolUse hooks
+that scan command strings for forbidden literals (destructive-git patterns,
+etc.). \`cat /tmp/foo.md | dotmd new …\` and \`@/tmp/foo.md\` both sidestep both.
 
 For plan/doc, a single-section body lands under the type's first scaffolded
 section (e.g. \`## Problem\` for plans). If the body already authors
@@ -656,12 +674,13 @@ the title + your body is emitted — no duplicated empty outline below
 Examples:
   dotmd new plan auth-revamp
   dotmd new prompt resume-foo @/tmp/draft.md
-  dotmd new prompt resume-foo - <<'EOF'
+  cat /tmp/draft.md | dotmd new prompt resume-foo
+  dotmd new prompt resume-foo <<'EOF'
   multi-line
   prompt body
   EOF
   dotmd new prompt cleanup-tomorrow "look at remaining lint warnings"
-  dotmd new plan full-spec - <<'EOF'
+  dotmd new plan full-spec <<'EOF'
   ## Problem
   …
   ## Phases
@@ -1040,7 +1059,7 @@ async function main() {
       const key = `help:${topic}`;
       if (HELP[key]) { process.stdout.write(`${HELP[key]}\n`); return; }
       if (HELP[topic]) { process.stdout.write(`${HELP[topic]}\n`); return; }
-      process.stderr.write(`Unknown help topic: ${topic}\n\nAvailable topics: statuses\nPer-command help: dotmd <cmd> --help\n`);
+      process.stderr.write(`Unknown help topic: ${topic}\n\nAvailable topics: all, statuses\nPer-command help: dotmd <cmd> --help\n`);
       process.exit(1);
     }
     process.stdout.write(`${HELP._main}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.42.1",
+  "version": "0.44.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/claude-commands.mjs

@@ -63,19 +63,18 @@ function generatePlansCommand(config, version) {
   lines.push('');
   lines.push('Plan-specific commands:');
   lines.push('- `dotmd context` — briefing with active/paused/ready plans, age tags, next steps');
-  lines.push('- `dotmd pickup <file>` — pick up a plan (set in-session + print body)');
-  lines.push('- `dotmd release` — release current session\'s leases (alias: unpickup)');
-  lines.push('- `dotmd health` — plan velocity, aging, checklist progress, pipeline view');
-  lines.push('- `dotmd unblocks <file>` — what depends on / is blocked by a plan');
-  lines.push('- `dotmd actionable` — ready plans with next steps (what to promote)');
+  lines.push('- `dotmd set <status> [<file>]` — single status verb. Use this to start, transition, or close any plan:');
+  lines.push('    - `dotmd set in-session <file>` — start work on a plan (acquires the lease + prints body)');
+  lines.push('    - `dotmd set <status> [<file>]` — transition to any other status; if you held the lease it releases automatically');
+  lines.push('    - `dotmd set archived <file>` — close out (same as `dotmd archive`)');
+  lines.push('- `dotmd archive <file>` — explicit archive with ref-fixing (equivalent to `set archived`)');
+  lines.push('- `dotmd bulk archive <files>` — archive multiple at once');
   lines.push('- `dotmd new plan <name>` — scaffold with full phase structure');
-  lines.push('- `dotmd prompts new <name> "<body>"` — save a resume-prompt to docs/prompts/');
+  lines.push('- `dotmd prompts new <name>` — save a resume-prompt to docs/prompts/ (pipe stdin or @path for body)');
   lines.push('- `dotmd prompts next` — consume oldest pending prompt (prints body, auto-archives)');
   lines.push('- `dotmd prompts use <file>` — consume a specific prompt (prints body, auto-archives)');
-  lines.push('- `dotmd archive <file>` — archive with auto ref-fixing (both directions)');
-  lines.push('- `dotmd bulk archive <files>` — archive multiple at once');
-  lines.push('- `dotmd set <status> [<file>]` — unified transition (archive / release / status bump in one verb; infers path from held lease)');
-  lines.push('- `dotmd status <file> <status>` — transition status (legacy; `set` is preferred)');
+  lines.push('- `dotmd unblocks <file>` — what depends on / is blocked by a plan');
+  lines.push('- `dotmd actionable` — ready plans with next steps (what to promote)');
   lines.push('- `dotmd query --keyword <term>` — find plans by keyword');
 
   if (config.raw?.glossary) {
@@ -85,8 +84,8 @@ function generatePlansCommand(config, version) {
   lines.push('');
   lines.push('If the user asks about a specific plan, read its file directly (path is in the briefing or findable via `dotmd query --keyword <term>`).');
   lines.push('');
-  lines.push('If the user asks to change a plan\'s status, use `dotmd status <file> <status>`.');
-  lines.push('If the user asks to archive a plan, use `dotmd archive <file>`.');
+  lines.push('If the user asks to change a plan\'s status, use `dotmd set <status> <file>`.');
+  lines.push('If the user asks to archive a plan, use `dotmd set archived <file>` (or `dotmd archive <file>`).');
   lines.push('');
   lines.push('**Saved prompts (`docs/prompts/*.md`):** if the user references a file under `docs/prompts/` — e.g. "resume via docs/prompts/foo.md", "use this prompt", "load that one" — consume it with `dotmd prompts use <file>` (atomically prints the body and archives the prompt so it cannot be double-consumed). Do NOT `cat` it, read it with the file-reading tool, or copy its body into chat. To pick the oldest pending prompt without naming a file, use `dotmd prompts next`.');
   lines.push('');
@@ -96,15 +95,15 @@ function generatePlansCommand(config, version) {
 
 function generateBatonCommand(config, version) {
   const lines = [...frontmatterFor('baton', config), markerFor(version), ''];
-  lines.push('Wrap this session. Minimum required (two commands):');
-  lines.push('');
-  lines.push('1. **Save the resume prompt.** `dotmd new prompt resume-<plan-slug>` with a 10-20 line body via heredoc: the next concrete decision plus any gotchas. NOT a recap of the plan body. The saved prompt IS the handoff — never print it into chat for copy-paste.');
+  lines.push('Wrap this session. Two commands:');
   lines.push('');
-  lines.push('2. **Release the lease.** `dotmd release` — or `dotmd archive <file>` if the work is fully shipped (archive auto-releases).');
+  lines.push('1. **Save the resume prompt.** `dotmd new prompt resume-<plan-slug>` — pipe stdin or pass `@path`. 10-20 line body: the next concrete decision plus any gotchas. NOT a recap of the plan body. The saved prompt IS the handoff — never print it into chat for copy-paste.');
   lines.push('');
-  lines.push('Optional, only when genuinely needed:');
-  lines.push('- Status really changed (paused / awaiting / partial / blocked): `dotmd status <file> <status>` BEFORE `dotmd release`.');
-  lines.push('- Plan dashboard text is misleading the user: edit `next_step:` in the plan frontmatter. Cosmetic — the next session reads the resume prompt, not the plan frontmatter.');
+  lines.push('2. **Close out via `dotmd set <status>`.** Pick the status that matches reality:');
+  lines.push('    - `dotmd set active <file>` — work continues, release the lease back to the queue');
+  lines.push('    - `dotmd set archived <file>` — fully shipped (also: `dotmd archive <file>`)');
+  lines.push('    - `dotmd set paused <file>` / `awaiting <file>` / `partial <file>` / `blocked <file>` — when the status really changed');
+  lines.push('  `set` releases the held lease automatically when transitioning out of `in-session`.');
   lines.push('');
   lines.push('If you don\'t already know which plan you hold: `dotmd hud --json` and read `.owned`. Do NOT use `dotmd plans --status in-session` — that lists every session\'s holdings, not just yours.');
   lines.push('');
@@ -131,7 +130,6 @@ function generateDocsCommand(config, version) {
 
   lines.push('Commands for working with docs:');
   lines.push('- `dotmd context` — LLM-oriented briefing across all types');
-  lines.push('- `dotmd check` — validate frontmatter, refs, body links (target: 0 errors)');
   lines.push('- `dotmd doctor` — auto-fix everything in one pass (refs, lint, dates, index)');
   lines.push('- `dotmd query [filters]` — search by status, keyword, module, surface, type, staleness');
   lines.push('- `dotmd health` — plan pipeline, velocity, aging');

package/src/hud.mjs

@@ -1,10 +1,10 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
-import { readLeases, findStaleLeases, currentSessionId, STALE_LEASE_AGE_HOURS } from './lease.mjs';
+import { readLeases, findStaleLeases, currentSessionId } from './lease.mjs';
 import { scrubStaleSilently } from './lease-scrub.mjs';
 import { extractFrontmatter, parseSimpleFrontmatter } from './frontmatter.mjs';
 import { asString, toRepoPath } from './util.mjs';
-import { green, yellow, red, dim } from './color.mjs';
+import { dim } from './color.mjs';
 import { buildIndex } from './index.mjs';
 import { refreshStaleSlashCommands } from './claude-commands.mjs';
 
@@ -115,18 +115,15 @@ export function runHud(argv, config) {
   }
 
   const lines = [];
-  if (hud.owned.length > 0) {
-    lines.push(green(`▶ You hold ${hud.owned.length} plan${hud.owned.length === 1 ? '' : 's'}: ${previewList(hud.owned)}`));
-  }
-  if (hud.prompts.length > 0) {
-    lines.push(green(`▶ ${hud.prompts.length} pending prompt${hud.prompts.length === 1 ? '' : 's'}: ${previewList(hud.prompts)}  ${dim('(consume: `dotmd prompts use <file>` — do not cat/read)')}`));
-  }
-  if (hud.stale.length > 0) {
-    lines.push(yellow(`⚠ ${hud.stale.length} stuck lease${hud.stale.length === 1 ? '' : 's'} >${STALE_LEASE_AGE_HOURS}h  ${dim('(run: dotmd release --stale)')}`));
-  }
-  if (hud.errors > 0) {
-    lines.push(red(`✗ ${hud.errors} validation error${hud.errors === 1 ? '' : 's'}  ${dim('(run: dotmd check)')}`));
-  }
+
+  // Always-on command primer. Replaces the prior plan-state / prompts /
+  // stuck-leases / validation-errors lines — those signals belong inside
+  // their own commands (`plans`, `prompts`), not in the SessionStart hook.
+  // hud's job is purely to remind the agent which verbs exist, since that's
+  // the one thing the agent reaches for `--help` to recover. Keep it tight:
+  // one line, the minimum verb set.
+  lines.push(dim('dotmd: plans|briefing  set <status> [<file>]  new <type> <slug>  prompts next|use|new  archive <file>'));
+
   if (refreshed.length > 0) {
     const from = refreshed[0].from;
     const to = refreshed[0].to;
@@ -134,21 +131,5 @@ export function runHud(argv, config) {
     lines.push(dim(`↻ slash commands refreshed (v${from} → v${to}): ${names}`));
   }
 
-  // Teach-once primer for fresh installs. The first session that runs hud in
-  // a dotmd-managed repo gets one line explaining what dotmd is and how to
-  // hand off — without this, a clean repo emits nothing and Claude has no
-  // signal that dotmd is the prompt/handoff machinery here. Gated on a
-  // marker under .dotmd/ (already the per-repo state dir, already gitignored
-  // by `dotmd init`) so subsequent sessions stay silent.
-  const primerMarker = path.join(config.repoRoot, '.dotmd', 'primer-shown');
-  if (!existsSync(primerMarker)) {
-    lines.push(dim('dotmd: managing this repo\'s docs. Use `dotmd new prompt` for handoffs (never hand-write docs/prompts/*.md). `dotmd plans` shows the queue. `dotmd --help` for more.'));
-    try {
-      mkdirSync(path.dirname(primerMarker), { recursive: true });
-      writeFileSync(primerMarker, '');
-    } catch { /* best-effort — failed marker write just means the primer reprints next session */ }
-  }
-
-  if (lines.length === 0) return; // silent when clean
   process.stdout.write(lines.join('\n') + '\n');
 }

package/src/lifecycle.mjs

@@ -303,11 +303,11 @@ export async function runPickup(argv, config, opts = {}) {
   const pickupable = new Set(['active', 'planned', 'in-session']);
   if (oldStatus && !pickupable.has(oldStatus)) {
     die(
-      `Cannot pick up a plan with status '${oldStatus}'. Must be active or planned.\n` +
+      `Cannot start work on a plan with status '${oldStatus}'. Must be active or planned.\n` +
       `  ${repoPath}\n` +
       `\n` +
       `Recover with:\n` +
-      `  dotmd status ${repoPath} active && dotmd pickup ${repoPath}`,
+      `  dotmd set active ${repoPath} && dotmd set in-session ${repoPath}`,
     );
   }
 
@@ -370,7 +370,7 @@ export async function runPickup(argv, config, opts = {}) {
       process.stderr.write(`${green('▶ Picked up')}: ${repoPath} (${oldStatus ?? 'unset'} → in-session)\n\n`);
     }
     if (fullBody) {
-      const header = `[dotmd] holding ${repoPath} — release with: dotmd release ${repoPath}\n---\n`;
+      const header = `[dotmd] holding ${repoPath} — close with: dotmd set <status> ${repoPath}\n---\n`;
       process.stdout.write(header);
       const content = (body ?? '').trim();
       if (content) process.stdout.write(content + '\n');
@@ -665,8 +665,14 @@ export async function runSet(argv, config, opts = {}) {
 
   if (!newStatus) die('Usage: dotmd set <status> [<path>]');
 
+  // `set in-session` acquires a lease + prints the plan body (same as the
+  // legacy `pickup` verb). Delegated so `set` is the single status verb.
   if (newStatus === 'in-session') {
-    die('To acquire an in-session lease, use `dotmd pickup <file>`. `dotmd set` is for releasing/transitioning a held lease.');
+    const pickArgs = input ? [input] : [];
+    if (argv.includes('--takeover')) pickArgs.push('--takeover');
+    if (noIndex) pickArgs.push('--no-index');
+    if (showFiles) pickArgs.push('--show-files');
+    return runPickup(pickArgs, config, { dryRun });
   }
 
   if (!input) {

package/src/new.mjs

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, fstatSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { toRepoPath, die, warn, nowIso, emitFilesFooter } from './util.mjs';
@@ -26,7 +26,7 @@ const BUILTIN_TEMPLATES = {
   doc: {
     description: 'Reference doc, design note, module overview — build-up shape lite',
     defaultStatus: 'active',
-    // Body input optional. When passed (inline / --message / @file / stdin),
+    // Body input optional. When passed (inline / --body / @file / stdin),
     // it lands in the Overview section. Without it, Overview is left blank
     // and the user fills it in.
     acceptsBody: true,
@@ -263,12 +263,18 @@ export async function runNew(argv, config, opts = {}) {
   let status = null;
   let title = null;
   let rootName = opts.root ?? null;
-  let messageFlag = null;
+  let bodyFlag = null;
+  let bodyFlagName = null; // tracks which spelling the caller used, for error attribution
   let showFiles = opts.showFiles ?? false;
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === '--status' && argv[i + 1]) { status = argv[++i]; continue; }
     if (argv[i] === '--title' && argv[i + 1]) { title = argv[++i]; continue; }
-    if (argv[i] === '--message' && argv[i + 1]) { messageFlag = argv[++i]; continue; }
+    // --body is the canonical flag; --message is a back-compat alias.
+    if ((argv[i] === '--body' || argv[i] === '--message') && argv[i + 1]) {
+      bodyFlagName = argv[i];
+      bodyFlag = argv[++i];
+      continue;
+    }
     if (argv[i] === '--root' && argv[i + 1]) { rootName = argv[++i]; continue; }
     if (argv[i] === '--config') { i++; continue; }
     if (argv[i] === '--show-files') { showFiles = true; continue; }
@@ -304,7 +310,7 @@ export async function runNew(argv, config, opts = {}) {
       name = await promptText(`${typeName} name: `);
       if (!name) die('No name provided.');
     } else {
-      die(`Usage: dotmd new <type> <name> [body]\n       types: ${[...knownTypes].join(', ')}\n       body: inline text | "-" (stdin) | "@path" (file) | --message "..."`);
+      die(`Usage: dotmd new <type> <name> [body]\n       types: ${[...knownTypes].join(', ')}\n       body: inline text | piped stdin (auto) | "@path" (file) | --body "..."`);
     }
   }
 
@@ -331,13 +337,31 @@ export async function runNew(argv, config, opts = {}) {
     die(`Invalid status \`${status}\` for type \`${typeName}\`\nValid: ${[...effective].join(', ')}`);
   }
 
-  // Body input resolution: messageFlag > bodyArg > nothing
+  // Body input resolution: --body flag > positional bodyArg > auto-piped-stdin > nothing
   let bodyInput = null;
   let bodyInputSource = null;
-  if (messageFlag !== null) { bodyInput = readBodyInput(messageFlag); bodyInputSource = '--message'; }
+  if (bodyFlag !== null) { bodyInput = readBodyInput(bodyFlag); bodyInputSource = bodyFlagName; }
   else if (bodyArg !== null) {
     bodyInput = readBodyInput(bodyArg);
     bodyInputSource = bodyArg === '-' ? 'stdin (`-`)' : (bodyArg.startsWith('@') ? `file (\`${bodyArg}\`)` : 'inline body argument');
+  } else if (template.acceptsBody || template.requiresBody) {
+    // Auto-consume piped or redirected stdin so agents don't need the `-`
+    // placeholder for the most common pattern (`cat draft.md | dotmd new …`,
+    // `dotmd new … < draft.md`, or a `<<'EOF'` heredoc). We probe stdin via
+    // fstatSync rather than `!isTTY` so a closed/inherited fd doesn't trigger
+    // a blocking read of an empty stream. We accept FIFO (shell pipes), regular
+    // file (shell redirection / heredoc), and socket (Node spawnSync `input:`
+    // delivers stdin as an AF_UNIX socket).
+    try {
+      const stat = fstatSync(0);
+      if (stat.isFIFO() || stat.isFile() || stat.isSocket()) {
+        const piped = readFileSync(0, 'utf8');
+        if (piped.length > 0) {
+          bodyInput = piped;
+          bodyInputSource = 'piped stdin';
+        }
+      }
+    } catch { /* stdin not introspectable — skip auto-consume */ }
   }
 
   // If the body input has a leading `---…---` frontmatter block, lift its keys
@@ -355,7 +379,7 @@ export async function runNew(argv, config, opts = {}) {
   }
 
   if (template.requiresBody && (!bodyInput || !bodyInput.trim())) {
-    die(`\`${typeName}\` template requires a body. Pass inline, --message "...", - for stdin, or @path for a file.`);
+    die(`\`${typeName}\` template requires a body. Pipe stdin (\`cat draft.md | dotmd new ${typeName} <slug>\`), pass @path, --body "...", or inline text.`);
   }
 
   // Fail-fast when the user passes body input to a template that doesn't

package/src/pickup-card.mjs

@@ -194,7 +194,7 @@ export function buildCard(filePath, raw, config) {
 // Render the card to human-format string.
 export function renderCard(card) {
   const lines = [];
-  lines.push(`[dotmd] holding ${card.path} — release with: dotmd release ${card.path}`);
+  lines.push(`[dotmd] holding ${card.path} — close with: dotmd set <status> ${card.path}`);
   lines.push('---');
   lines.push(`# ${card.title}`);
   const meta = [card.status, card.updated && `updated ${card.updated}`].filter(Boolean).join(' · ');
@@ -252,7 +252,7 @@ export function renderCard(card) {
   }
 
   lines.push('');
-  lines.push(dim(`Body: ${formatBytes(card.bodyBytes)}. \`dotmd pickup ${card.path} --full\` for everything, or Read the file with offset/limit to target a section by line number.`));
+  lines.push(dim(`Body: ${formatBytes(card.bodyBytes)}. \`dotmd set in-session ${card.path} --full\` for everything, or Read the file with offset/limit to target a section by line number.`));
   return lines.join('\n') + '\n';
 }
 

package/src/prompts.mjs

@@ -248,7 +248,7 @@ function runPromptsArchive(argv, config, opts = {}) {
 
 async function runPromptsNew(argv, config, opts = {}) {
   if (!argv[0] || argv[0].startsWith('-')) {
-    die('Usage: dotmd prompts new <slug> [body]\n       body: inline text | "-" (stdin) | "@path" (file) | --message "..."');
+    die('Usage: dotmd prompts new <slug> [body]\n       body: inline text | piped stdin (auto) | "@path" (file) | --body "..."');
   }
   return runNew(['prompt', ...argv], config, opts);
 }

package/src/validate.mjs

@@ -186,14 +186,14 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
       doc.warnings.push({
         path: doc.path,
         level: 'warning',
-        message: `\`status: in-session\` but no active lease found (last session may have crashed without releasing). Run \`dotmd release ${doc.path}\` to clear, or \`dotmd status ${doc.path} active\` to re-queue.`,
+        message: `\`status: in-session\` but no active lease found (last session may have crashed without releasing). Run \`dotmd set active ${doc.path}\` to clear and re-queue.`,
       });
     } else if (isLeaseStale(lease)) {
       const ageHours = Math.floor((Date.now() - new Date(lease.pickedUpAt).getTime()) / (1000 * 60 * 60));
       doc.warnings.push({
         path: doc.path,
         level: 'warning',
-        message: `\`status: in-session\` but lease is stale (last touched ${ageHours}h ago, >${STALE_LEASE_AGE_HOURS}h threshold). Run \`dotmd release ${doc.path}\` to clear, or \`dotmd status ${doc.path} active\` to re-queue.`,
+        message: `\`status: in-session\` but lease is stale (last touched ${ageHours}h ago, >${STALE_LEASE_AGE_HOURS}h threshold). Run \`dotmd set active ${doc.path}\` to clear and re-queue.`,
       });
     }
   }