dotmd-cli 0.78.0 → 0.79.0

package/src/migrate-template.mjs

@@ -163,8 +163,8 @@ export function runMigrateTemplate(argv, config, opts = {}) {
   }
 
   if (dryRun) {
-    process.stdout.write(`\nRun ${bold('dotmd doctor --migrate-template')} without --dry-run to apply.\n`);
+    process.stdout.write(`\nRun ${bold('runlist doctor --migrate-template')} without --dry-run to apply.\n`);
   } else {
-    process.stdout.write(`\n${green('Done.')} Re-run ${bold('dotmd check')} to see remaining issues.\n`);
+    process.stdout.write(`\n${green('Done.')} Re-run ${bold('runlist check')} to see remaining issues.\n`);
   }
 }

package/src/migrate.mjs

@@ -23,7 +23,7 @@ export function runMigrate(argv, config, opts = {}) {
   const fileArgs = positional.slice(3);
 
   if (!field || !oldValue || !newValue) {
-    die('Usage: dotmd migrate <field> <old-value> <new-value> [files...]');
+    die('Usage: runlist migrate <field> <old-value> <new-value> [files...]');
   }
 
   const allFiles = collectDocFiles(config);

package/src/misuse-read.mjs

@@ -1,5 +1,5 @@
 import { existsSync } from 'node:fs';
-import { readMisuseEntries, globalMisuseLogPath } from './journal.mjs';
+import { readMisuseEntries, globalMisuseLogPaths } from './journal.mjs';
 import { dim, red, yellow } from './color.mjs';
 
 // `dotmd misuse` — read the cross-repo guard log. Every wrong-move the
@@ -19,11 +19,10 @@ function parseArgs(argv) {
 }
 
 export function runMisuse(argv, _config) {
-  const file = globalMisuseLogPath();
-  if (!existsSync(file)) {
+  if (!globalMisuseLogPaths().some(file => existsSync(file))) {
     process.stderr.write(
-      'No misuse log yet. The PreToolUse guard (`dotmd guard`) writes here when it intercepts a wrong move.\n' +
-      'Wire it up: add a PreToolUse hook that runs `dotmd guard` (see `dotmd help guard`).\n',
+      'No misuse log yet. The PreToolUse guard (`runlist guard`) writes here when it intercepts a wrong move.\n' +
+      'Wire it up: add a PreToolUse hook that runs `runlist guard` (see `runlist help guard`).\n',
     );
     return;
   }

package/src/modules.mjs

@@ -268,7 +268,7 @@ export function runModulesDashboard(index, argv, config) {
 
   if (!flags.all && rows.length > flags.limit) {
     const hidden = rows.length - flags.limit;
-    process.stdout.write('\n' + dim(`  ${hidden} more module${hidden === 1 ? '' : 's'}  ·  dotmd modules --all\n`));
+    process.stdout.write('\n' + dim(`  ${hidden} more module${hidden === 1 ? '' : 's'}  ·  runlist modules --all\n`));
   }
 }
 
@@ -283,7 +283,7 @@ export function runModuleDetail(index, argv, config) {
     positional.push(arg);
   }
   const name = positional[0];
-  if (!name) die('Usage: dotmd module <name>');
+  if (!name) die('Usage: runlist module <name>');
 
   const { rows } = aggregateModules(index.docs, config);
   const row = rows.find(r => r.name === name);
@@ -292,7 +292,7 @@ export function runModuleDetail(index, argv, config) {
     const suggestions = suggestCandidates(name, candidates);
     const hint = suggestions.length
       ? `Did you mean: ${suggestions.join(', ')}?`
-      : `Available: ${candidates.slice(0, 5).join(', ')}${candidates.length > 5 ? ', …' : ''} (run \`dotmd modules\` for the full list).`;
+      : `Available: ${candidates.slice(0, 5).join(', ')}${candidates.length > 5 ? ', …' : ''} (run \`runlist modules\` for the full list).`;
     die(`Module '${name}' not found. ${hint}`);
   }
 

package/src/new.mjs

@@ -338,7 +338,7 @@ export function readBodyInput(source) {
       if (isBodyPlaceholder(file)) {
         die(`\`@${file}\` is a placeholder, not a real path — write the body to a file first, then pass it:\n` +
           `  @/tmp/my-draft.md   read the body from that file\n` +
-          `  -                   read the body from stdin (\`cat notes.md | dotmd …\`)\n` +
+          `  -                   read the body from stdin (\`cat notes.md | runlist …\`)\n` +
           `  --message "..."     short one-liners only`);
       }
       die(`Body file not found: ${file}`);
@@ -447,8 +447,8 @@ ${bodyInput?.trim() ?? ''}
 
 ${steps}
 
-Pick up the next child with \`dotmd runlist next ${hubSlug}\` — it targets the
-first non-archived child. \`dotmd runlist ${hubSlug}\` shows the sequence + status.
+Pick up the next child with \`runlist runlist next ${hubSlug}\` — it targets the
+first non-archived child. \`runlist runlist ${hubSlug}\` shows the sequence + status.
 
 ## Version History
 
@@ -493,7 +493,7 @@ function roadmapHubBody(title, hubSlug, bodyInput, today) {
 # ${title}
 
 > One-paragraph: the domain this roadmap composes. A roadmap points at *runlists*
-> (not leaf plans) and rolls their done/total up — see \`dotmd roadmap ${hubSlug}\`.
+> (not leaf plans) and rolls their done/total up — see \`runlist roadmap ${hubSlug}\`.
 
 ## Scope
 
@@ -687,7 +687,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 | piped stdin (auto) | "@path" (file) | --body "..."`);
+      die(`Usage: runlist new <type> <name> [body]\n       types: ${[...knownTypes].join(', ')}\n       body: inline text | piped stdin (auto) | "@path" (file) | --body "..."`);
     }
   }
 
@@ -734,7 +734,7 @@ export async function runNew(argv, config, opts = {}) {
   if (planShapes.length > 0 && typeName !== 'plan') {
     const flag = planShapes[0][0];
     const usage = flag === '--runlist' ? '--runlist a,b,c' : flag;
-    die(`${flag} only applies to plans. Use: dotmd new plan <name> ${usage}`);
+    die(`${flag} only applies to plans. Use: runlist new plan <name> ${usage}`);
   }
   if (planShapes.length > 1) {
     die(`${planShapes.map(([f]) => f).join(' and ')} are mutually exclusive — a plan has one body shape. Pick one.`);
@@ -787,7 +787,7 @@ export async function runNew(argv, config, opts = {}) {
   }
 
   if (template.requiresBody && (!bodyInput || !bodyInput.trim())) {
-    die(`\`${typeName}\` template requires a body. Pipe stdin (\`cat draft.md | dotmd new ${typeName} <slug>\`), pass @path, --body "...", or inline text.`);
+    die(`\`${typeName}\` template requires a body. Pipe stdin (\`cat draft.md | runlist new ${typeName} <slug>\`), pass @path, --body "...", or inline text.`);
   }
 
   // Fail-fast when the user passes body input to a template that doesn't
@@ -817,10 +817,10 @@ export async function runNew(argv, config, opts = {}) {
     const builtinAccepts = Boolean(builtin && (builtin.acceptsBody || builtin.requiresBody));
     let cause;
     if (isOverride && builtinAccepts) {
-      const where = config.configPath ? toRepoPath(config.configPath, config.repoRoot) : 'dotmd.config.mjs';
+      const where = config.configPath ? toRepoPath(config.configPath, config.repoRoot) : 'runlist.config.mjs';
       cause = `Your config (${where}) overrides the built-in \`${typeName}\` template, and the override drops body acceptance.\nFix: in that override, add \`acceptsBody: true\` AND interpolate \`\${ctx?.bodyInput?.trim() ?? ''}\` into your \`body\` fn (e.g., inside \`## Problem\`). Or drop the override to use the built-in.`;
     } else {
-      cause = `Either drop the body, switch to a template that accepts it, or set \`acceptsBody: true\` on your custom \`${typeName}\` template in dotmd.config.mjs.`;
+      cause = `Either drop the body, switch to a template that accepts it, or set \`acceptsBody: true\` on your custom \`${typeName}\` template in runlist.config.mjs.`;
     }
     die(`\`${typeName}\` template does not accept body input, but body was passed via ${bodyInputSource}.${hint}\n${cause}`);
   }
@@ -909,7 +909,7 @@ export async function runNew(argv, config, opts = {}) {
         + `  ${repoPath}\n\n`
         + `A name with a \`/\` is read relative to the repo.\n`
         + `To place it under a root instead:\n`
-        + `  dotmd new ${typeName} ${name} --root ${path.basename(targetRoot)}\n`
+        + `  runlist new ${typeName} ${name} --root ${path.basename(targetRoot)}\n`
         + `     → ${toRepoPath(rooted, config.repoRoot)}\n\n`
         + `Roots: ${allRoots.map(root => path.basename(root)).join(', ')}`);
     }
@@ -1039,7 +1039,7 @@ export async function runNew(argv, config, opts = {}) {
   // confusingly). Tell the agent the next step explicitly, and flag a gitignored
   // target for any type so "why won't this commit" never happens silently.
   if (typeName === 'prompt') {
-    process.stdout.write(dim('Session-local — no need to commit. The next session runs `dotmd use` (or `dotmd use ' + repoPath + '`) to consume it.\n'));
+    process.stdout.write(dim('Session-local — no need to commit. The next session runs `runlist use` (or `runlist use ' + repoPath + '`) to consume it.\n'));
   }
   // Teach the field-length contract at the moment the fields get written —
   // learning it from a cap warning later sends sessions into hand-trim /

package/src/output-identity.mjs

@@ -1,7 +1,12 @@
 import { createHash } from 'node:crypto';
 import path from 'node:path';
 
-export const HTML_FALLBACK_DIR = '__dotmd';
+export const HTML_FALLBACK_DIR = '__runlist';
+// Exports written by dotmd-cli 0.78.0 and earlier put fallbacks under this
+// directory, and an old export tree may still hold it. It stays reserved so a
+// document's own path can never land inside a stale fallback directory.
+export const LEGACY_HTML_FALLBACK_DIR = '__dotmd';
+const RESERVED_FALLBACK_DIRS = [HTML_FALLBACK_DIR, LEGACY_HTML_FALLBACK_DIR];
 
 function normalizeRelative(value, kind) {
   if (typeof value !== 'string' || value.includes('\0')) {
@@ -59,7 +64,7 @@ export function allocateOutputIdentities(docs) {
       preferred,
       conflict: preferred.toLowerCase() === 'index.html'
         || preferred.toLowerCase().startsWith('index.html/')
-        || preferred.toLowerCase().startsWith(`${HTML_FALLBACK_DIR.toLowerCase()}/`),
+        || RESERVED_FALLBACK_DIRS.some(dir => preferred.toLowerCase().startsWith(`${dir.toLowerCase()}/`)),
     });
   }
 

package/src/pickup-card.mjs

@@ -208,7 +208,7 @@ export function buildCard(filePath, raw, config) {
 // Render the card to human-format string.
 export function renderCard(card) {
   const lines = [];
-  lines.push(`[dotmd] in-session: ${card.path} — close with: dotmd set <status> ${card.path}`);
+  lines.push(`[runlist] in-session: ${card.path} — close with: runlist set <status> ${card.path}`);
   lines.push('---');
   lines.push(`# ${card.title}`);
   const meta = [card.status, card.updated && `updated ${card.updated}`].filter(Boolean).join(' · ');
@@ -266,7 +266,7 @@ export function renderCard(card) {
   }
 
   lines.push('');
-  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.`));
+  lines.push(dim(`Body: ${formatBytes(card.bodyBytes)}. \`runlist 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/pickup.mjs

@@ -251,7 +251,7 @@ export function prepareOwnershipMigration(oldRepoPath, newPath, config, { sessio
     // `rename` has no --force of its own: a rename carries the claim across to
     // the new path rather than ending it, so the takeover has to happen first.
     throw planBusyError(oldRepoPath, ownership,
-      `release it first with \`dotmd set <status> ${oldRepoPath} --force\`, then rename.`);
+      `release it first with \`runlist set <status> ${oldRepoPath} --force\`, then rename.`);
   }
   const identity = plannedPlanIdentity(newPath, config);
   const recordPath = recordPathForIdentity(identity, config);
@@ -459,7 +459,7 @@ export function releaseVanishedPlanClaim(claim, config, { now = new Date().toISO
       throw new Error(`Claim changed under us for ${claim.plan}; re-run to see the current state.`);
     }
     if (existsSync(path.resolve(config.repoRoot, ownership.plan))) {
-      throw new Error(`${ownership.plan} exists after all — release it with \`dotmd set active\` instead.`);
+      throw new Error(`${ownership.plan} exists after all — release it with \`runlist set active\` instead.`);
     }
     replaceSnapshot(snapshot, JSON.stringify({
       schema: OWNERSHIP_SCHEMA,

package/src/prompts.mjs

@@ -33,9 +33,9 @@ export async function runPrompts(argv, config, opts = {}) {
   const sub = argv[0];
 
   if (sub && REMOVED_SUBCOMMANDS.has(sub)) {
-    die(`\`dotmd prompts ${sub}\` was removed — a prompt is pending or archived, and nothing else.\n`
+    die(`\`runlist prompts ${sub}\` was removed — a prompt is pending or archived, and nothing else.\n`
       + 'A prompt directs work, so parking one instead of archiving it leaves work state outside the\n'
-      + 'plan that owns it. Lift its content into that plan, then `dotmd prompts archive <file>`.');
+      + 'plan that owns it. Lift its content into that plan, then `runlist prompts archive <file>`.');
   }
 
   if (!sub || !SUBCOMMANDS.has(sub)) {
@@ -242,7 +242,7 @@ export function resolvePromptInput(input, config, options = {}) {
 
 async function runPromptsUse(argv, config, opts = {}) {
   const input = argv.find(a => !a.startsWith('-'));
-  if (!input) die('Usage: dotmd prompts use <file-or-slug>');
+  if (!input) die('Usage: runlist prompts use <file-or-slug>');
   const noIndex = argv.includes('--no-index') || opts.noIndex;
   const showFiles = argv.includes('--show-files') || opts.showFiles;
   const noClaim = argv.includes('--no-claim');
@@ -374,8 +374,8 @@ export async function writeConsumedBody(body, archivedPath, write = null, linked
     }
   }
   catch (err) {
-    const completion = linkedPlan ? ` Then complete the linked claim with \`dotmd use ${linkedPlan}\`.` : '';
-    throw new Error(`Prompt was consumed but body output failed (${err.code ?? err.message}). It will not be emitted again; recover it with \`dotmd prompts show ${archivedPath}\`.${completion}`);
+    const completion = linkedPlan ? ` Then complete the linked claim with \`runlist use ${linkedPlan}\`.` : '';
+    throw new Error(`Prompt was consumed but body output failed (${err.code ?? err.message}). It will not be emitted again; recover it with \`runlist prompts show ${archivedPath}\`.${completion}`);
   }
 }
 
@@ -395,7 +395,7 @@ export async function writeConsumedBody(body, archivedPath, write = null, linked
 function explainUnclaimablePlan(disposition, repoPath, status, startable) {
   switch (disposition.kind) {
     case 'parked':
-      return `${repoPath} is ${status} — \`dotmd set ${startable} ${repoPath}\` to unpark it, then \`dotmd use ${repoPath}\``;
+      return `${repoPath} is ${status} — \`runlist set ${startable} ${repoPath}\` to unpark it, then \`runlist use ${repoPath}\``;
     case 'busy':
       return `${repoPath} is claimed by another session (${disposition.owner})`;
     case 'terminal':
@@ -406,7 +406,7 @@ function explainUnclaimablePlan(disposition, repoPath, status, startable) {
     case 'unconfigured-status':
       return `${repoPath} has a status this repo does not configure (${status ?? 'none'})`;
     case 'ownership-corrupt':
-      return `${repoPath} has an unreadable ownership record — \`dotmd doctor --claims\``;
+      return `${repoPath} has an unreadable ownership record — \`runlist doctor --claims\``;
     default:
       return `${repoPath} cannot be claimed (${disposition.kind})`;
   }
@@ -504,7 +504,7 @@ function runPromptsShow(argv, config) {
   const inputs = argv.filter((a, i) => !a.startsWith('-') && i !== limitValueIdx);
 
   if (!inputs.length && !all) {
-    die('Usage: dotmd prompts show <file-or-slug>...\n       dotmd prompts show --all [--limit N]   # peek the whole pending queue');
+    die('Usage: runlist prompts show <file-or-slug>...\n       runlist prompts show --all [--limit N]   # peek the whole pending queue');
   }
   if (inputs.length && all) die('Pass either prompt names or --all, not both.');
 
@@ -532,7 +532,7 @@ function runPromptsShow(argv, config) {
       if (shown > 0) process.stdout.write('\n');
       process.stdout.write(dim(`──── ${repoPath} [${status}] ────\n`));
     } else {
-      process.stderr.write(dim(`${repoPath} [${status}] — read-only peek; \`dotmd use ${repoPath}\` to consume\n`));
+      process.stderr.write(dim(`${repoPath} [${status}] — read-only peek; \`runlist use ${repoPath}\` to consume\n`));
     }
     process.stdout.write(body);
     if (!body.endsWith('\n')) process.stdout.write('\n');
@@ -545,13 +545,13 @@ function runPromptsShow(argv, config) {
   const truncated = total > targets.length;
   if (multi || truncated) {
     const suffix = truncated ? ` of ${total} (use --limit to change)` : '';
-    process.stderr.write(dim(`\n${shown} prompt${shown === 1 ? '' : 's'}${suffix} — read-only peek; \`dotmd use <file>\` to consume one\n`));
+    process.stderr.write(dim(`\n${shown} prompt${shown === 1 ? '' : 's'}${suffix} — read-only peek; \`runlist use <file>\` to consume one\n`));
   }
 }
 
 function runPromptsArchive(argv, config, opts = {}) {
   const input = argv.find(a => !a.startsWith('-'));
-  if (!input) die('Usage: dotmd prompts archive <file-or-slug>');
+  if (!input) die('Usage: runlist prompts archive <file-or-slug>');
   const noIndex = argv.includes('--no-index') || opts.noIndex;
   const showFiles = argv.includes('--show-files') || opts.showFiles;
   const filePath = resolvePromptInput(input, config);
@@ -568,7 +568,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 | piped stdin (auto) | "@path" (file) | --body "..."');
+    die('Usage: runlist prompts new <slug> [body]\n       body: inline text | piped stdin (auto) | "@path" (file) | --body "..."');
   }
   return runNew(['prompt', ...argv], config, opts);
 }

package/src/query.mjs

@@ -83,7 +83,7 @@ export function runQuery(index, argv, config, opts = {}) {
   if (opts.type && !filters.types) filters.types = opts.type.split(',').map(v => v.trim()).filter(Boolean);
   if (opts.root && !filters.root) filters.root = opts.root;
   if (filters.body && !filters.keyword) {
-    die('`--body` extends a keyword search into document bodies — pass `--keyword <term>` (or use `dotmd grep <term>`).');
+    die('`--body` extends a keyword search into document bodies — pass `--keyword <term>` (or use `runlist grep <term>`).');
   }
   const docs = filterDocs(index.docs, filters, config, opts.gitMetadataOptions);
   const summaryPreviewSkipped = filters.summarize && config._execution?.suppressSideEffects;
@@ -193,7 +193,7 @@ export function runRunlists(index, argv, config) {
   }
 
   const roadmapPointer = roadmapCount > 0
-    ? dim(`  ${roadmapCount} roadmap${roadmapCount === 1 ? '' : 's'}  ·  dotmd roadmaps\n`)
+    ? dim(`  ${roadmapCount} roadmap${roadmapCount === 1 ? '' : 's'}  ·  runlist roadmaps\n`)
     : '';
 
   if (hubs.length === 0) {
@@ -206,7 +206,7 @@ export function runRunlists(index, argv, config) {
   const shown = hubs.slice(0, limit);
   renderCoordinationSection(shown, coordination, maxWidth, hubs.length);
   const hidden = hubs.length - shown.length;
-  if (hidden > 0) process.stdout.write(dim(`  ${hidden} more  ·  dotmd runlists --limit ${hubs.length}\n`));
+  if (hidden > 0) process.stdout.write(dim(`  ${hidden} more  ·  runlist runlists --limit ${hubs.length}\n`));
   if (roadmapPointer) process.stdout.write(roadmapPointer);
   process.stdout.write('\n');
 }
@@ -651,7 +651,7 @@ function renderPlansOutput(docs, filters, config, opts = {}) {
     const mainHidden = mainAll.length - mainShown.length;
     if (mainHidden > 0) {
       process.stdout.write('\n');
-      process.stdout.write(dim(`  ${mainHidden} more ${noun}  ·  dotmd ${noun} --all  ·  dotmd ${noun} status\n`));
+      process.stdout.write(dim(`  ${mainHidden} more ${noun}  ·  runlist ${noun} --all  ·  runlist ${noun} status\n`));
     }
 
     // Roadmaps tier — pinned above Runlists, with the recursive grand total.
@@ -659,7 +659,7 @@ function renderPlansOutput(docs, filters, config, opts = {}) {
       renderRoadmapsSection(roadmapShown, roadmap, maxWidth, roadmapAll.length);
       const roadmapHidden = roadmapAll.length - roadmapShown.length;
       if (roadmapHidden > 0) {
-        process.stdout.write(dim(`  ${roadmapHidden} more roadmaps  ·  dotmd roadmaps\n`));
+        process.stdout.write(dim(`  ${roadmapHidden} more roadmaps  ·  runlist roadmaps\n`));
       }
     }
 
@@ -667,7 +667,7 @@ function renderPlansOutput(docs, filters, config, opts = {}) {
       renderCoordinationSection(coordShown, coordination, maxWidth, coordAll.length);
       const coordHidden = coordAll.length - coordShown.length;
       if (coordHidden > 0) {
-        process.stdout.write(dim(`  ${coordHidden} more runlists  ·  dotmd ${noun} --all\n`));
+        process.stdout.write(dim(`  ${coordHidden} more runlists  ·  runlist ${noun} --all\n`));
       }
     }
 
@@ -684,7 +684,7 @@ function renderPlansOutput(docs, filters, config, opts = {}) {
         && !archiveStatuses.has(v.doc.status)
         && !isArchivedPath(v.doc.path, config)).length;
       if (filterHidden > 0) {
-        process.stdout.write(dim(`  ${filterHidden} runlist${filterHidden === 1 ? '' : 's'} hidden by filter  ·  dotmd runlists\n`));
+        process.stdout.write(dim(`  ${filterHidden} runlist${filterHidden === 1 ? '' : 's'} hidden by filter  ·  runlist runlists\n`));
       }
     }
 
@@ -696,7 +696,7 @@ function renderPlansOutput(docs, filters, config, opts = {}) {
   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(dim(`  ${hidden} more ${noun}  ·  runlist ${noun} --all  ·  runlist ${noun} status\n`));
   }
 
   process.stdout.write('\n');
@@ -876,7 +876,7 @@ function renderHubBlock(hub, info, children, maxWidth, topMaxSlug) {
 // bird's-eye), distinct from the Runlists section's per-hub rollup. `dotmd
 // roadmap <hub>` expands one into its child rows.
 function renderRoadmapsSection(roadmapDocs, roadmap, maxWidth, total) {
-  process.stdout.write(`\n${bold(`Roadmaps (${total ?? roadmapDocs.length})`)} ${dim('· dotmd roadmap')}\n`);
+  process.stdout.write(`\n${bold(`Roadmaps (${total ?? roadmapDocs.length})`)} ${dim('· runlist roadmap')}\n`);
   const maxSlug = Math.min(34, Math.max(...roadmapDocs.map(d => hubLabel(d).length)));
   for (const doc of roadmapDocs) {
     const info = roadmap?.get(doc.path);

package/src/rename.mjs

@@ -16,9 +16,9 @@ export async function runRename(argv, config, opts = {}) {
   const positional = argv.filter(arg => !arg.startsWith('-'));
   const oldInput = positional[0];
   let newInput = positional[1];
-  if (!oldInput) die('Usage: dotmd rename <old> <new>');
+  if (!oldInput) die('Usage: runlist rename <old> <new>');
   if (!newInput) {
-    if (!isInteractive()) die('Usage: dotmd rename <old> <new>');
+    if (!isInteractive()) die('Usage: runlist rename <old> <new>');
     newInput = await promptText('New name: ');
     if (!newInput) die('No name provided.');
   }

package/src/render.mjs

@@ -284,7 +284,7 @@ function _renderContext(index, config, opts = {}) {
     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}, …and ${overflow} more (run \`runlist stale\` for the full list)`
       : shown;
     lines.push(`Stale: ${tail}`);
   } else {
@@ -297,7 +297,7 @@ function _renderContext(index, config, opts = {}) {
     const parts = [];
     if (withErrors.length) parts.push(`${withErrors.length} with errors`);
     if (withWarnings.length) parts.push(`${withWarnings.length} with warnings`);
-    lines.push(`Non-compliant: ${parts.join(', ')} (run \`dotmd check\` for details)`);
+    lines.push(`Non-compliant: ${parts.join(', ')} (run \`runlist check\` for details)`);
   }
 
   const ctx = config.context;
@@ -371,10 +371,10 @@ export function renderBriefing(index, config) {
       lines.push(`  > ${path.basename(p.path, '.md')} (${p.status}) ${next}`);
     }
     if (liveRoadmaps.length) {
-      lines.push(`  ${liveRoadmaps.length} roadmap${liveRoadmaps.length === 1 ? '' : 's'} ${dim('· dotmd roadmaps')}`);
+      lines.push(`  ${liveRoadmaps.length} roadmap${liveRoadmaps.length === 1 ? '' : 's'} ${dim('· runlist roadmaps')}`);
     }
     if (liveRunlists) {
-      lines.push(`  ${liveRunlists} runlist${liveRunlists === 1 ? '' : 's'} ${dim('· dotmd runlists')}`);
+      lines.push(`  ${liveRunlists} runlist${liveRunlists === 1 ? '' : 's'} ${dim('· runlist runlists')}`);
     }
   }
 
@@ -396,7 +396,7 @@ export function renderBriefing(index, config) {
   // with no clue what or where. `dotmd check` is the canonical detail view.
   const errorCount = index.errors.length;
   const errorPart = errorCount > 0
-    ? `Errors: ${errorCount} ${dim('(run `dotmd check` to see)')}`
+    ? `Errors: ${errorCount} ${dim('(run `runlist check` to see)')}`
     : `Errors: ${errorCount}`;
   lines.push(`Stale: ${stale} | ${errorPart} | Warnings: ${index.warnings.length}`);
 
@@ -420,13 +420,13 @@ export function classifyIssueAction(issue) {
   // re-matching their prose. Drift is mechanically fixable; an unreadable cell
   // is not — nothing can guess which word in it was meant to be the status.
   if (issue?.meta?.kind === 'hub-status-drift') {
-    return { action: 'dotmd sync-status', fixable: true, label: 'hub status drift' };
+    return { action: 'runlist sync-status', fixable: true, label: 'hub status drift' };
   }
   if (issue?.meta?.kind === 'hub-status-unreadable') {
     return { action: `edit ${file}: lead the status cell with the status word, or wrap it in <!--s-->…<!--/s-->`, fixable: false, label: 'hub status rows' };
   }
   if (issue?.meta?.kind === 'hub-membership-backref') {
-    return { action: 'dotmd fix-membership', fixable: true, label: 'membership back-references' };
+    return { action: 'runlist fix-membership', fixable: true, label: 'membership back-references' };
   }
   if (issue?.meta?.kind === 'hub-membership-orphan') {
     return { action: `edit ${file}: add the child to the hub's meaningful list, or correct the child's parent_plan`, fixable: false, label: 'orphan membership claims' };
@@ -436,41 +436,41 @@ export function classifyIssueAction(issue) {
   }
 
   if (/Missing frontmatter `status`/.test(message)) {
-    return { action: `dotmd bulk-tag ${file}`, fixable: false, label: 'missing status' };
+    return { action: `runlist bulk-tag ${file}`, fixable: false, label: 'missing status' };
   }
   if (/Missing frontmatter `updated`/.test(message) || /frontmatter `updated: .*` is behind git history/.test(message)) {
-    return { action: 'dotmd touch --git', fixable: true, label: 'dates' };
+    return { action: 'runlist touch --git', fixable: true, label: 'dates' };
   }
-  if ((/`(?:module|surface):` \(singular\) is deprecated/.test(message) && /Run `dotmd lint --fix`/.test(message))
+  if ((/`(?:module|surface):` \(singular\) is deprecated/.test(message) && /Run `runlist lint --fix`/.test(message))
     || /camelCase|nextStep|currentState|auditLevel/.test(message)) {
-    return { action: 'dotmd lint --fix', fixable: true, label: 'frontmatter migrations' };
+    return { action: 'runlist lint --fix', fixable: true, label: 'frontmatter migrations' };
   }
   if (/Unknown surface/.test(message)) {
-    return { action: 'dotmd surfaces', fixable: false, label: 'taxonomy' };
+    return { action: 'runlist surfaces', fixable: false, label: 'taxonomy' };
   }
   if (/Glossary config points at section|Glossary file configured/.test(message)) {
-    return { action: 'edit dotmd.config.mjs glossary.path/glossary.section', fixable: false, label: 'glossary config' };
+    return { action: 'edit runlist.config.mjs glossary.path/glossary.section', fixable: false, label: 'glossary config' };
   }
   if (/under `.*\/` but `status: .*` is not an archive status/.test(message)) {
-    return { action: message.match(/Run `([^`]+)`/)?.[1] ?? `dotmd set archived ${file}`, fixable: true, label: 'archive drift' };
+    return { action: message.match(/Run `([^`]+)`/)?.[1] ?? `runlist set archived ${file}`, fixable: true, label: 'archive drift' };
   }
   if (/`status: .*` but file is a direct child/.test(message)) {
-    return { action: `dotmd archive ${file}`, fixable: true, label: 'archive drift' };
+    return { action: `runlist archive ${file}`, fixable: true, label: 'archive drift' };
   }
   if (/`current_state` is \d+ chars|`next_step` is \d+ chars/.test(message)) {
-    return { action: 'dotmd doctor --frontmatter-fix', fixable: true, label: 'long frontmatter' };
+    return { action: 'runlist doctor --frontmatter-fix', fixable: true, label: 'long frontmatter' };
   }
   if (/`modules` is required/.test(message)) {
-    return { action: `edit ${file} modules: or run dotmd lint --fix if scaffolded empty`, fixable: false, label: 'module metadata' };
+    return { action: `edit ${file} modules: or run runlist lint --fix if scaffolded empty`, fixable: false, label: 'module metadata' };
   }
   if (issue?.meta?.kind === 'body-link-resolution') {
     if (issue.meta.targetKind === 'document' && issue.meta.reason === 'missing') {
-      return { action: 'dotmd fix-refs --dry-run', fixable: true, label: 'document links' };
+      return { action: 'runlist fix-refs --dry-run', fixable: true, label: 'document links' };
     }
     return { action: `edit ${file}: correct the linked file, asset, or directory`, fixable: false, label: 'file links' };
   }
   if (/entry `.*` does not resolve/.test(message)) {
-    return { action: 'dotmd fix-refs --dry-run', fixable: true, label: 'references' };
+    return { action: 'runlist fix-refs --dry-run', fixable: true, label: 'references' };
   }
 
   return { action: `edit ${file}`, fixable: false, label: 'manual review' };
@@ -573,7 +573,7 @@ function _renderCheck(index, config, opts = {}) {
       }
       lines.push('');
     } else {
-      lines.push(dim(`Run \`dotmd check --verbose\` for per-doc detail. \`dotmd doctor --apply\` auto-fixes supported issues (bare \`dotmd doctor\` previews only); remaining issues need the suggested manual command.`));
+      lines.push(dim(`Run \`runlist check --verbose\` for per-doc detail. \`runlist doctor --apply\` auto-fixes supported issues (bare \`runlist doctor\` previews only); remaining issues need the suggested manual command.`));
       lines.push('');
     }
   }

package/src/roadmap.mjs

@@ -61,7 +61,7 @@ function renderRoadmap(info, maxWidth) {
   return lines.join('\n') + '\n';
 }
 
-const NO_ROADMAPS = 'No roadmaps found. A roadmap is a plan with `execution_mode: roadmap` that composes runlists.\nScaffold one: dotmd new plan <name> --roadmap\n';
+const NO_ROADMAPS = 'No roadmaps found. A roadmap is a plan with `execution_mode: roadmap` that composes runlists.\nScaffold one: runlist new plan <name> --roadmap\n';
 
 // `dotmd roadmaps` — the dashboard over every roadmap hub (mirrors `dotmd
 // runlists`): one row per roadmap with its recursive grand total + child count.
@@ -106,7 +106,7 @@ export function runRoadmap(index, argv, config) {
     const info = roadmaps.get(repoPath);
     if (!info) {
       die(`${repoPath} is not a roadmap hub (needs \`execution_mode: roadmap\`).\n` +
-        `See \`dotmd roadmaps\` for roadmaps, or \`dotmd runlist ${hubArg}\` if it's a runlist.`);
+        `See \`runlist roadmaps\` for roadmaps, or \`runlist runlist ${hubArg}\` if it's a runlist.`);
     }
     if (json) { process.stdout.write(JSON.stringify(roadmapJson(info), null, 2) + '\n'); return; }
     process.stdout.write('\n' + renderRoadmap(info, process.stdout.columns || 100) + '\n');
@@ -139,10 +139,10 @@ function resolveRoadmapTarget(roadmaps, hubArg, config) {
     if (!info) die(`${hubArg} is not a roadmap hub (needs \`execution_mode: roadmap\`).`);
     return info;
   }
-  if (roadmaps.size === 0) die('No roadmaps found. Scaffold one: dotmd new plan <name> --roadmap');
+  if (roadmaps.size === 0) die('No roadmaps found. Scaffold one: runlist new plan <name> --roadmap');
   if (roadmaps.size > 1) {
     const listed = [...roadmaps.values()].map(r => `  ${hubLabel(r.doc)}`).join('\n');
-    die(`Multiple roadmaps — name one: dotmd roadmap next <hub>\n${listed}`);
+    die(`Multiple roadmaps — name one: runlist roadmap next <hub>\n${listed}`);
   }
   return [...roadmaps.values()][0];
 }
@@ -169,7 +169,7 @@ export async function runRoadmapNext(index, argv, config, opts = {}) {
       return `  ${hubLabel(c.doc)} (${c.doneCount}/${c.total} · ${state})`;
     }).join('\n');
     die(`No pickup-able plan across roadmap ${hubLabel(info.doc)} — every child runlist is done or parked:\n${lines}\n` +
-      `Unstick one (e.g. \`dotmd set active <child>\`), or inspect a runlist: \`dotmd runlist <hub>\`.`);
+      `Unstick one (e.g. \`runlist set active <child>\`), or inspect a runlist: \`runlist runlist <hub>\`.`);
   }
 
   if (!json) {