dotmd-cli 0.77.3 → 0.79.0

package/src/lifecycle.mjs

@@ -35,7 +35,7 @@ import {
 
 export function renderLifecycleMutation(raw, updates, historyEntry, { createSection = false, bodyTransform = null } = {}) {
   raw = normalizeEol(raw);
-  if (!raw.startsWith('---\n')) throw new Error('Document has no frontmatter block. Retrofit it with `dotmd bulk-tag` first.');
+  if (!raw.startsWith('---\n')) throw new Error('Document has no frontmatter block. Retrofit it with `runlist bulk-tag` first.');
   const endMarker = raw.indexOf('\n---\n', 4);
   if (endMarker === -1) throw new Error('Document has an unclosed frontmatter block.');
   let frontmatter = raw.slice(4, endMarker);
@@ -192,7 +192,7 @@ export function regenIndex(config, options = {}) {
     return true;
   } catch (err) {
     if (options.throwOnError) throw err;
-    warn(`Could not regenerate index (run \`dotmd index\`): ${err.message}`);
+    warn(`Could not regenerate index (run \`runlist index\`): ${err.message}`);
     return false;
   }
 }
@@ -360,10 +360,10 @@ export async function runStatus(argv, config, opts = {}) {
   let newStatus = argv[1];
 
   if (!opts.suppressDeprecation) {
-    process.stderr.write(dim('`dotmd status <file> <status>` is deprecated; prefer `dotmd set <status> [<file>]` (note: <status> first; <file> optional when a plan is in-session). Removed in a future major.\n'));
+    process.stderr.write(dim('`runlist status <file> <status>` is deprecated; prefer `runlist set <status> [<file>]` (note: <status> first; <file> optional when a plan is in-session). Removed in a future major.\n'));
   }
 
-  if (!input) { die('Usage: dotmd status <file> <new-status>'); }
+  if (!input) { die('Usage: runlist status <file> <new-status>'); }
 
   let filePath = resolveDocArg(input, config);
   const sourceAuthorization = authorizeManagedSource(filePath, config, { kind: 'Status source' });
@@ -394,7 +394,7 @@ export async function runStatus(argv, config, opts = {}) {
       newStatus = await promptChoice('Which status?', effectiveOrder);
       if (!newStatus) die('No status selected.');
     } else {
-      die('Usage: dotmd status <file> <new-status>');
+      die('Usage: runlist status <file> <new-status>');
     }
   }
 
@@ -526,7 +526,7 @@ export async function runStatus(argv, config, opts = {}) {
   // this so concurrent agents can do path-limited commits without pulling
   // each other's uncommitted index changes into the staging area.
   if (noIndex) {
-    process.stderr.write(dim('(index not regenerated — run `dotmd index` to refresh)\n'));
+    process.stderr.write(dim('(index not regenerated — run `runlist index` to refresh)\n'));
   } else if (!opts.deferIndex) {
     regenIndex(config);
   }
@@ -568,7 +568,7 @@ export async function startPlan(argv, config, opts = {}) {
 
   // Interactive: pick from active/planned plans
   if (!input) {
-    if (!isInteractive()) die('Usage: dotmd use <plan>');
+    if (!isInteractive()) die('Usage: runlist use <plan>');
     const index = buildIndex(config);
     const sessionId = authoritativeSessionId();
     const candidates = pickupCandidates(index, config, sessionId);
@@ -672,7 +672,7 @@ export async function startPlan(argv, config, opts = {}) {
   } else {
     process.stderr.write(`${green('▶ Started')}: ${repoPath} (${oldStatus ?? 'unset'} → in-session)\n\n`);
     if (fullBody) {
-      const header = `[dotmd] in-session: ${repoPath} — close with: dotmd set <status> ${repoPath}\n---\n`;
+      const header = `[runlist] in-session: ${repoPath} — close with: runlist set <status> ${repoPath}\n---\n`;
       process.stdout.write(header);
       const content = (body ?? '').trim();
       if (content) process.stdout.write(content + '\n');
@@ -707,7 +707,7 @@ export function runArchive(argv, config, opts = {}) {
   }
   const input = argv[0];
 
-  if (!input) { die('Usage: dotmd archive <file>'); }
+  if (!input) { die('Usage: runlist archive <file>'); }
 
   let filePath = resolveDocArg(input, config);
   const sourceAuthorization = authorizeManagedSource(filePath, config, { kind: 'Archive source' });
@@ -861,7 +861,7 @@ export function runArchive(argv, config, opts = {}) {
   if (selfRefsFixed) out.write('Updated references in archived file.\n');
   if (updatedRefCount > 0) out.write(`Updated references in ${updatedRefCount} file(s).\n`);
   if (config.indexPath && indexRegenerated) out.write('Index regenerated.\n');
-  if (config.indexPath && noIndex) out.write(dim('(index not regenerated — run `dotmd index` to refresh)\n'));
+  if (config.indexPath && noIndex) out.write(dim('(index not regenerated — run `runlist index` to refresh)\n'));
 
   const touched = [oldRepoPath, newRepoPath, ...refTouchedPaths];
   if (config.indexPath && indexRegenerated) touched.push(config.indexPath);
@@ -931,7 +931,7 @@ export async function runSet(argv, config, opts = {}) {
   const newStatus = argv[0];
   let input = argv[1];
 
-  if (!newStatus) die('Usage: dotmd set <status> [<path>]');
+  if (!newStatus) die('Usage: runlist set <status> [<path>]');
   let sessionId = null;
   if (!input) {
     sessionId = authoritativeSessionId();
@@ -1051,7 +1051,7 @@ export async function runSet(argv, config, opts = {}) {
       // `@<draft-file>` stays an obvious metavariable: the old `@draft` read as
       // a runnable path and got copied verbatim into failing batons. If it is
       // copied anyway, readBodyInput recognizes the <…> form and says so.
-      warn(`wrapping up? leave a baton so the next session picks up cleanly — write your resume notes to a file, then \`dotmd baton ${path.basename(filePath, '.md')} @<draft-file>\` saves a resume prompt (no copy-paste into chat).`);
+      warn(`wrapping up? leave a baton so the next session picks up cleanly — write your resume notes to a file, then \`runlist baton ${path.basename(filePath, '.md')} @<draft-file>\` saves a resume prompt (no copy-paste into chat).`);
     }
   }
   return result;
@@ -1063,7 +1063,7 @@ export function runBulkArchive(argv, config, opts = {}) {
   const noIndex = argv.includes('--no-index') || opts.noIndex;
   const showFiles = argv.includes('--show-files') || opts.showFiles;
   const inputs = argv.filter(a => !a.startsWith('-'));
-  if (inputs.length === 0) die('Usage: dotmd bulk archive <file1> <file2> ... or <glob>');
+  if (inputs.length === 0) die('Usage: runlist bulk archive <file1> <file2> ... or <glob>');
 
   const allFiles = collectDocFiles(config);
   const matched = [];
@@ -1124,7 +1124,7 @@ export function runBulkArchive(argv, config, opts = {}) {
     catch (err) { indexError = err.message; }
     if (config.indexPath && indexRegenerated) process.stdout.write('Index regenerated.\n');
   } else if (config.indexPath) {
-    process.stdout.write(dim('(index not regenerated — run `dotmd index` to refresh)\n'));
+    process.stdout.write(dim('(index not regenerated — run `runlist index` to refresh)\n'));
   }
   if (showFiles) {
     const all = [...bulkTouched];
@@ -1248,8 +1248,8 @@ export function runTouch(argv, config, opts = {}) {
     return;
   }
 
-  if (inputs.length > 1) die('Multiple files require `dotmd touch --git <file...>`.');
-  if (!input) { die('Usage: dotmd touch <file>\n       dotmd touch --git          Bulk-sync dates from git history'); }
+  if (inputs.length > 1) die('Multiple files require `runlist touch --git <file...>`.');
+  if (!input) { die('Usage: runlist touch <file>\n       runlist touch --git          Bulk-sync dates from git history'); }
 
   let filePath = resolveDocArg(input, config);
   filePath = authorizeManagedSource(filePath, config, { kind: 'Touch source' }).path;
@@ -1358,7 +1358,7 @@ export function updateFrontmatter(filePath, updates) {
   // Name the remedy in the error: this is where every status verb lands when a
   // doc was created outside dotmd, and "no frontmatter block" alone left
   // sessions retrying other verbs instead of fixing the doc.
-  if (!raw.startsWith('---\n')) throw new Error(`${filePath} has no frontmatter block. Retrofit it first: dotmd bulk-tag ${filePath} --type <type> --status <status>`);
+  if (!raw.startsWith('---\n')) throw new Error(`${filePath} has no frontmatter block. Retrofit it first: runlist bulk-tag ${filePath} --type <type> --status <status>`);
 
   const endMarker = raw.indexOf('\n---\n', 4);
   if (endMarker === -1) throw new Error(`${filePath} has unclosed frontmatter block.`);

package/src/lint.mjs

@@ -218,7 +218,7 @@ export function runLint(argv, config, opts = {}) {
           }
         }
       }
-      process.stdout.write(`\nRun ${bold('dotmd lint --fix')} to auto-fix.\n`);
+      process.stdout.write(`\nRun ${bold('runlist lint --fix')} to auto-fix.\n`);
     }
 
     if (nonFixable.length > 0) {

package/src/migrate-prompts.mjs

@@ -167,5 +167,5 @@ export function runMigratePrompts(argv, config, opts = {}) {
       process.stdout.write(dim(`    [${c.kind}] ${c.detail}\n`));
     }
   }
-  if (dryRun) process.stdout.write(`\nRun ${bold('dotmd doctor --migrate-prompts')} without --dry-run to apply.\n`);
+  if (dryRun) process.stdout.write(`\nRun ${bold('runlist doctor --migrate-prompts')} without --dry-run to apply.\n`);
 }

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

@@ -132,7 +132,10 @@ ${ctx?.bodyInput?.trim() ?? ''}
     description: 'Execution plan — build-up shape (Problem → Phases → Closeout) with phase status markers and Version History',
     dir: 'plans',
     targetRoot: 'plans',
-    defaultStatus: 'active',
+    // A scaffolded plan is scoped, not being worked; `dotmd use` starts it.
+    // Defaulting to `active` forced a second, guarded status write for every
+    // plan that was only being written down.
+    defaultStatus: 'planned',
     // Body input lands in the Problem section. Plans don't have an Overview;
     // Problem is the established opening section in the build-up shape.
     acceptsBody: true,
@@ -335,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}`);
@@ -444,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
 
@@ -490,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
 
@@ -684,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 "..."`);
     }
   }
 
@@ -731,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.`);
@@ -784,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
@@ -814,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}`);
   }
@@ -906,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(', ')}`);
     }
@@ -1036,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)) {
@@ -196,7 +196,7 @@ async function runPromptsNext(argv, config, opts = {}) {
   }
   const head = queue[0];
   if (!head.abs) die(`Could not resolve path: ${head.doc.path}`);
-  return consumePrompt(head.abs, config, opts);
+  return consumePrompt(head.abs, config, { ...opts, noClaim: argv.includes('--no-claim') });
 }
 
 // Resolve user input to a prompt path. Tries (in order): exact path,
@@ -242,11 +242,12 @@ 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');
   const filePath = resolvePromptInput(input, config);
-  return consumePrompt(filePath, config, { ...opts, noIndex, showFiles });
+  return consumePrompt(filePath, config, { ...opts, noIndex, showFiles, noClaim });
 }
 
 export async function consumePrompt(filePath, config, opts) {
@@ -269,7 +270,9 @@ export async function consumePrompt(filePath, config, opts) {
   const planRef = asString(parsed.plan);
   let linkedClaim = null;
   let claimSkipReason = null;
-  if (planRef) {
+  if (planRef && opts.noClaim) {
+    claimSkipReason = `--no-claim, ${planRef} left as it is`;
+  } else if (planRef) {
     const outcome = prepareLinkedPromptClaim(planRef, config, path.dirname(filePath));
     if (outcome?.skipped) claimSkipReason = outcome.reason;
     else linkedClaim = outcome;
@@ -371,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}`);
   }
 }
 
@@ -392,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':
@@ -403,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})`;
   }
@@ -501,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.');
 
@@ -529,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');
@@ -542,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);
@@ -565,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.');
   }