dotmd-cli 0.77.3 → 0.79.0

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) {

package/src/runlist.mjs

@@ -426,7 +426,7 @@ function renderRunlist(hubRepoPath, children, opts = {}) {
     const parked = children.filter(c => !c.missing && !archiveStatuses.has(c.status));
     lines.push(dim(parked.length === 0
       ? '  All children archived. Hub is ready for archive.'
-      : `  No pickup-able child — ${parked.length} parked. Unstick one (e.g. \`dotmd set active <child>\`) to continue.`));
+      : `  No pickup-able child — ${parked.length} parked. Unstick one (e.g. \`runlist set active <child>\`) to continue.`));
   }
   return lines.join('\n') + '\n';
 }
@@ -497,7 +497,7 @@ async function runRunlistAdd(positional, config, { dryRun, json, testHooks }) {
   const hubInput = positional[0];
   const childTokens = positional.slice(1);
   if (!hubInput || childTokens.length === 0) {
-    die('Usage: dotmd runlist add <hub-plan> <child...>  (one or more child slugs or plan paths)');
+    die('Usage: runlist runlist add <hub-plan> <child...>  (one or more child slugs or plan paths)');
   }
 
   let hubAbs = resolveHubInput(hubInput, config);
@@ -596,7 +596,7 @@ async function runRunlistAdd(positional, config, { dryRun, json, testHooks }) {
   if (!json) {
     process.stdout.write(dim(`  runlist now has ${newRefs.length} ${newRefs.length === 1 ? 'child' : 'children'}.`) + '\n');
     if (!dryRun) {
-      process.stdout.write(dim(`  Show: dotmd runlist ${hubRepoPath}   ·   pick up next: dotmd runlist next ${hubRepoPath}`) + '\n');
+      process.stdout.write(dim(`  Show: runlist runlist ${hubRepoPath}   ·   pick up next: runlist runlist next ${hubRepoPath}`) + '\n');
     }
   }
 }
@@ -729,7 +729,7 @@ function planClearChildParent(childAbs, hubAbs, config) {
 // Shared front half of remove/reorder: resolve the hub, read its `runlist:`,
 // die if it isn't a sprint hub with an array to mutate.
 function loadSprintHub(hubInput, verb, config) {
-  if (!hubInput) die(`Usage: dotmd runlist ${verb} <hub-plan> <child...>`);
+  if (!hubInput) die(`Usage: runlist runlist ${verb} <hub-plan> <child...>`);
   let hubAbs = resolveHubInput(hubInput, config);
   if (!hubAbs) die(`Hub plan not found: ${hubInput}`);
   hubAbs = authorizeManagedSource(hubAbs, config, { kind: `Runlist ${verb} hub source` }).path;
@@ -749,7 +749,7 @@ function loadSprintHub(hubInput, verb, config) {
 async function runRunlistRemove(positional, config, { dryRun, json, clearParent, testHooks }) {
   const { hubAbs, hubRepoPath, hubDir, existingRefs, raw: hubRaw } = loadSprintHub(positional[0], 'remove', config);
   const childTokens = positional.slice(1);
-  if (childTokens.length === 0) die('Usage: dotmd runlist remove <hub-plan> <child...>');
+  if (childTokens.length === 0) die('Usage: runlist runlist remove <hub-plan> <child...>');
 
   const removeRefs = [];
   for (const token of childTokens) {
@@ -814,7 +814,7 @@ function parseReorderArgs(argv) {
 async function runRunlistReorder(argv, config, { dryRun, json, testHooks }) {
   const { hubInput, children, before, after } = parseReorderArgs(argv);
   if (!hubInput || children.length === 0) {
-    die('Usage: dotmd runlist reorder <hub> <child> --before|--after <other>\n   or: dotmd runlist reorder <hub> <child1> <child2> ...  (full new order)');
+    die('Usage: runlist runlist reorder <hub> <child> --before|--after <other>\n   or: runlist runlist reorder <hub> <child1> <child2> ...  (full new order)');
   }
   const { hubAbs, hubRepoPath, hubDir, existingRefs, raw: hubRaw } = loadSprintHub(hubInput, 'reorder', config);
 
@@ -876,8 +876,8 @@ export async function runRunlist(argv, config, opts = {}) {
 
   if (!hubInput) {
     die(sub === 'next'
-      ? 'Usage: dotmd runlist next <hub-plan>'
-      : 'Usage: dotmd runlist <hub-plan>');
+      ? 'Usage: runlist runlist next <hub-plan>'
+      : 'Usage: runlist runlist <hub-plan>');
   }
 
   const hubAbs = resolveHubInput(hubInput, config);
@@ -919,13 +919,13 @@ export async function runRunlist(argv, config, opts = {}) {
         `No pickup-able child in runlist ${hubRepoPath} — every remaining child is parked:\n` +
         `${listed}\n` +
         `Unstick one before continuing:\n` +
-        `  dotmd set active <child>   # if ready to resume\n` +
-        `  dotmd use <child>          # to inspect`,
+        `  runlist set active <child>   # if ready to resume\n` +
+        `  runlist use <child>          # to inspect`,
       );
     }
     const allArchived = children.some(c => !c.missing) && children.every(c => c.missing || archiveStatuses.has(c.status));
     if (allArchived) {
-      die(`All children in runlist ${hubRepoPath} are archived. Hub is ready for \`dotmd archive ${hubRepoPath}\`.`);
+      die(`All children in runlist ${hubRepoPath} are archived. Hub is ready for \`runlist archive ${hubRepoPath}\`.`);
     }
     const missing = children.filter(c => c.missing).map(c => c.ref);
     die(`No pickup-able child in runlist ${hubRepoPath}. Unresolved refs: ${missing.join(', ')}`);

package/src/ship.mjs

@@ -76,7 +76,7 @@ export async function runShip(argv, config, opts = {}) {
   const positional = argv.filter(a => !a.startsWith('-'));
   const bump = positional[0] ?? 'patch';
   if (!['patch', 'minor', 'major'].includes(bump)) {
-    die(`Invalid bump: ${bump}. Usage: dotmd ship [patch|minor|major]`);
+    die(`Invalid bump: ${bump}. Usage: runlist ship [patch|minor|major]`);
   }
 
   const pkgPath = path.join(config.repoRoot, 'package.json');
@@ -140,7 +140,7 @@ export async function runShip(argv, config, opts = {}) {
     }
 
     const subject = `chore: release ${target}`;
-    const body = `Auto-staged by \`dotmd ship\`:\n${allToStage.map(p => `- ${p}`).join('\n')}`;
+    const body = `Auto-staged by \`runlist ship\`:\n${allToStage.map(p => `- ${p}`).join('\n')}`;
     const commitMsg = `${subject}\n\n${body}`;
     const commit = spawnSync('git', ['commit', '-m', commitMsg], { cwd: config.repoRoot, encoding: 'utf8' });
     if (commit.status !== 0) die(`git commit failed: ${commit.stderr || commit.stdout}`);

package/src/skill-drift.mjs

@@ -15,9 +15,19 @@ import path from 'node:path';
 // surface and forgetting the other is exactly what this catches.
 
 export const CANONICAL_MARKERS = {
+  start: '<!-- runlist:canonical-workflow:start -->',
+  end: '<!-- runlist:canonical-workflow:end -->',
+};
+
+// The spelling used through dotmd-cli 0.78.0. Still read, so a copy of either
+// surface that predates the rename keeps participating in the lockstep instead
+// of silently dropping out of it. A block must open and close with the same
+// spelling; the current spelling is tried first.
+export const LEGACY_CANONICAL_MARKERS = {
   start: '<!-- dotmd:canonical-workflow:start -->',
   end: '<!-- dotmd:canonical-workflow:end -->',
 };
+const MARKER_SETS = [CANONICAL_MARKERS, LEGACY_CANONICAL_MARKERS];
 
 const CLAUDE_MD = 'CLAUDE.md';
 const SKILL_MD = path.join('plugins', 'dotmd', 'skills', 'dotmd', 'SKILL.md');
@@ -28,12 +38,15 @@ const SKILL_MD = path.join('plugins', 'dotmd', 'skills', 'dotmd', 'SKILL.md');
 // its own CLAUDE.md (but never adopted the block) from ever tripping the guard.
 export function extractCanonicalBlock(text) {
   if (typeof text !== 'string') return null;
-  const startIdx = text.indexOf(CANONICAL_MARKERS.start);
-  if (startIdx === -1) return null;
-  const afterStart = startIdx + CANONICAL_MARKERS.start.length;
-  const endIdx = text.indexOf(CANONICAL_MARKERS.end, afterStart);
-  if (endIdx === -1 || endIdx < afterStart) return null;
-  return text.slice(afterStart, endIdx);
+  for (const markers of MARKER_SETS) {
+    const startIdx = text.indexOf(markers.start);
+    if (startIdx === -1) continue;
+    const afterStart = startIdx + markers.start.length;
+    const endIdx = text.indexOf(markers.end, afterStart);
+    if (endIdx === -1 || endIdx < afterStart) continue;
+    return text.slice(afterStart, endIdx);
+  }
+  return null;
 }
 
 // Whitespace-tolerant so a CRLF vs LF or a stray trailing space between the two

package/src/statuses.mjs

@@ -125,8 +125,8 @@ function formatPropDisplay(v) {
 async function runAddStatus(args, config, opts) {
   const flags = parseFlags(args, { allowProps: true });
   const name = flags.positional[0];
-  if (!name) die('Usage: dotmd statuses add <name> --type <type> [--like <existing>] [flags]');
-  if (!flags.type) die('--type is required for `dotmd statuses add`.');
+  if (!name) die('Usage: runlist statuses add <name> --type <type> [--like <existing>] [flags]');
+  if (!flags.type) die('--type is required for `runlist statuses add`.');
 
   const validationErr = validateStatusName(name);
   if (validationErr) die(validationErr);
@@ -135,11 +135,11 @@ async function runAddStatus(args, config, opts) {
   const content = readFileSync(config.configPath, 'utf8');
   const parsed = parseStatusesBlock(content, flags.type);
   if (parsed.form === 'array') {
-    die(`Type '${flags.type}' uses array-form statuses. Run \`dotmd statuses migrate ${flags.type}\` first to convert to rich form.`);
+    die(`Type '${flags.type}' uses array-form statuses. Run \`runlist statuses migrate ${flags.type}\` first to convert to rich form.`);
   }
 
   if (parsed.entries.some(e => e.name === name)) {
-    die(`Status '${name}' already exists in type '${flags.type}'. Use \`dotmd statuses set\` to edit it.`);
+    die(`Status '${name}' already exists in type '${flags.type}'. Use \`runlist statuses set\` to edit it.`);
   }
 
   // Resolve --like base flags
@@ -152,7 +152,7 @@ async function runAddStatus(args, config, opts) {
       die(`--like target '${likeName}' is not defined in type '${flags.type}'.`);
     }
     if (likeEntry.multiLine) {
-      die(`--like target '${likeName}' spans multiple lines in dotmd.config.mjs; this CLI only edits single-line entries.`);
+      die(`--like target '${likeName}' spans multiple lines in runlist.config.mjs; this CLI only edits single-line entries.`);
     }
     baseProps = parseEntryProps(likeEntry.raw);
   }
@@ -235,8 +235,8 @@ function labelOrigin(key, userProps) {
 async function runSetStatus(args, config, opts) {
   const flags = parseFlags(args, { allowProps: true });
   const name = flags.positional[0];
-  if (!name) die('Usage: dotmd statuses set <name> --type <type> [flags]');
-  if (!flags.type) die('--type is required for `dotmd statuses set`.');
+  if (!name) die('Usage: runlist statuses set <name> --type <type> [flags]');
+  if (!flags.type) die('--type is required for `runlist statuses set`.');
   if (Object.keys(flags.props).length === 0) {
     die('At least one flag is required (e.g. --quiet, --staleDays 30).');
   }
@@ -245,15 +245,15 @@ async function runSetStatus(args, config, opts) {
   const content = readFileSync(config.configPath, 'utf8');
   const parsed = parseStatusesBlock(content, flags.type);
   if (parsed.form === 'array') {
-    die(`Type '${flags.type}' uses array-form statuses. Run \`dotmd statuses migrate ${flags.type}\` first.`);
+    die(`Type '${flags.type}' uses array-form statuses. Run \`runlist statuses migrate ${flags.type}\` first.`);
   }
 
   const existing = parsed.entries.find(e => e.name === name);
   if (!existing) {
-    die(`Status '${name}' is not defined in type '${flags.type}'. Use \`dotmd statuses add\` to create it.`);
+    die(`Status '${name}' is not defined in type '${flags.type}'. Use \`runlist statuses add\` to create it.`);
   }
   if (existing.multiLine) {
-    die(`Status '${name}' spans multiple lines in dotmd.config.mjs; edit it by hand.`);
+    die(`Status '${name}' spans multiple lines in runlist.config.mjs; edit it by hand.`);
   }
 
   const oldProps = parseEntryProps(existing.raw);
@@ -306,14 +306,14 @@ function printSetDiff(name, typeName, oldProps, newProps, userProps) {
 async function runRemoveStatus(args, config, opts) {
   const flags = parseFlags(args, { allowProps: false });
   const name = flags.positional[0];
-  if (!name) die('Usage: dotmd statuses remove <name> --type <type>');
-  if (!flags.type) die('--type is required for `dotmd statuses remove`.');
+  if (!name) die('Usage: runlist statuses remove <name> --type <type>');
+  if (!flags.type) die('--type is required for `runlist statuses remove`.');
 
   requireConfigPath(config);
   const content = readFileSync(config.configPath, 'utf8');
   const parsed = parseStatusesBlock(content, flags.type);
   if (parsed.form === 'array') {
-    die(`Type '${flags.type}' uses array-form statuses. Run \`dotmd statuses migrate ${flags.type}\` first.`);
+    die(`Type '${flags.type}' uses array-form statuses. Run \`runlist statuses migrate ${flags.type}\` first.`);
   }
   if (!parsed.entries.find(e => e.name === name)) {
     die(`Status '${name}' is not defined in type '${flags.type}'.`);
@@ -324,7 +324,7 @@ async function runRemoveStatus(args, config, opts) {
   if (offenders.length > 0) {
     const list = offenders.slice(0, 10).map(p => `  - ${p}`).join('\n');
     const more = offenders.length > 10 ? `\n  ... and ${offenders.length - 10} more` : '';
-    die(`${offenders.length} doc(s) currently use status '${name}':\n${list}${more}\n\nMigrate them first: \`dotmd migrate status ${name} <other> [files...]\``);
+    die(`${offenders.length} doc(s) currently use status '${name}':\n${list}${more}\n\nMigrate them first: \`runlist migrate status ${name} <other> [files...]\``);
   }
 
   // Warn (don't refuse) if explicit lifecycle references the name.
@@ -412,7 +412,7 @@ function findMatchingBrace(content, openPos) {
 async function runMigrateType(args, config, opts) {
   const flags = parseFlags(args, { allowProps: false });
   const typeName = flags.positional[0];
-  if (!typeName) die('Usage: dotmd statuses migrate <type>');
+  if (!typeName) die('Usage: runlist statuses migrate <type>');
 
   requireConfigPath(config);
   const content = readFileSync(config.configPath, 'utf8');
@@ -581,7 +581,7 @@ function lastNewlineIndexBefore(content, pos) {
 
 function requireConfigPath(config) {
   if (!config.configPath || !existsSync(config.configPath)) {
-    die(`No dotmd.config.mjs found in ${process.cwd()} — run \`dotmd init\` first.`);
+    die(`No runlist.config.mjs found in ${process.cwd()} — run \`runlist init\` first.`);
   }
 }
 

package/src/summary.mjs

@@ -22,7 +22,7 @@ export function runSummary(argv, config) {
   }
 
   const input = positional[0];
-  if (!input) { die('Usage: dotmd summary <file> [--model <name>] [--json]'); }
+  if (!input) { die('Usage: runlist summary <file> [--model <name>] [--json]'); }
 
   const filePath = resolveDocArg(input, config);
 

package/src/surfaces.mjs

@@ -20,7 +20,7 @@ export function runSurfaces(argv, config) {
 
   if (!surfaces || surfaces.length === 0) {
     process.stdout.write(dim('No surface taxonomy configured. Any surface value is accepted.\n'));
-    process.stdout.write(dim('To restrict, set `taxonomy.surfaces` in dotmd.config.mjs.\n'));
+    process.stdout.write(dim('To restrict, set `taxonomy.surfaces` in runlist.config.mjs.\n'));
     return;
   }
 

package/src/sync-status.mjs

@@ -163,8 +163,8 @@ export function checkHubStatusDrift(docs, config) {
           path: hub.path,
           level: row.marked ? 'error' : 'warning',
           message: row.marked
-            ? `line ${row.line} rows \`${row.target}\` as \`${row.printed}\` inside a \`${MARKER_OPEN}…${MARKER_CLOSE}\` marker, but that doc's status is \`${row.actual}\`. The marker means dotmd owns that word — run \`dotmd sync-status\` to rewrite it, or change the doc's status.`
-            : `line ${row.line} rows \`${row.target}\` as \`${row.printed}\`, but that doc's status is \`${row.actual}\`. Run \`dotmd sync-status\` to rewrite the row, or change the doc's status.`,
+            ? `line ${row.line} rows \`${row.target}\` as \`${row.printed}\` inside a \`${MARKER_OPEN}…${MARKER_CLOSE}\` marker, but that doc's status is \`${row.actual}\`. The marker means runlist owns that word — run \`runlist sync-status\` to rewrite it, or change the doc's status.`
+            : `line ${row.line} rows \`${row.target}\` as \`${row.printed}\`, but that doc's status is \`${row.actual}\`. Run \`runlist sync-status\` to rewrite the row, or change the doc's status.`,
           meta: { kind: DRIFT_KIND, target: row.target, printed: row.printed, actual: row.actual, line: row.line, marked: row.marked },
         };
         (row.marked ? errors : warnings).push(entry);
@@ -257,7 +257,7 @@ export function syncHubStatuses(config, { docs, dryRun = false, adopt = false, h
     if (result.unreadable > 0) {
       process.stdout.write(yellow(`${result.unreadable} row(s) sit under a status column with no readable status word`)
         + ' — lead the cell with the status, or wrap it in '
-        + `${MARKER_OPEN}…${MARKER_CLOSE}. Run \`dotmd check\` to list them.\n`);
+        + `${MARKER_OPEN}…${MARKER_CLOSE}. Run \`runlist check\` to list them.\n`);
     }
   }
   return result;
@@ -281,7 +281,7 @@ function resolveHubArgs(args, docs) {
     const [match] = matches;
     if (!isHubDoc(match)) {
       die(`${match.path} is not a hub — it has no \`runlist:\` and no \`execution_mode: coordination|roadmap\`. `
-        + 'Run `dotmd sync-status` with no argument to sweep every hub.');
+        + 'Run `runlist sync-status` with no argument to sweep every hub.');
     }
     paths.add(match.path);
   }

package/src/update.mjs

@@ -89,7 +89,7 @@ export function readInstalledPlugin(opts = {}) {
 export function planMarketplaceRepair(plugin, { hasClaude, verb }) {
   const reason = `marketplace "${plugin.marketplace}" is not registered, so the installed plugin cannot load`;
   if (plugin.marketplace !== 'dotmd') {
-    return [{ kind: 'skip', reason: `${reason} — re-add that marketplace (dotmd does not know its source), then rerun` }];
+    return [{ kind: 'skip', reason: `${reason} — re-add that marketplace (runlist does not know its source), then rerun` }];
   }
   if (!hasClaude) {
     return [{ kind: 'manual', reason, lines: [`/plugin marketplace add ${CLAUDE_MARKETPLACE}`, `/plugin ${verb} ${plugin.id}`] }];
@@ -112,7 +112,7 @@ export function planUpdate(opts, ctx) {
   }
   if (!opts.cliOnly) {
     if (!ctx.plugin) {
-      steps.push({ kind: 'skip', reason: 'dotmd plugin not installed — skipping plugin update' });
+      steps.push({ kind: 'skip', reason: 'runlist plugin not installed — skipping plugin update' });
     } else if (ctx.plugin.marketplaceRegistered === false) {
       steps.push(...planMarketplaceRepair(ctx.plugin, { hasClaude: ctx.hasClaude, verb: 'update' }));
     } else if (!ctx.hasClaude) {
@@ -127,7 +127,7 @@ export function planUpdate(opts, ctx) {
     if (ctx.opencode?.exists && ctx.opencode.stale) {
       steps.push({ kind: 'opencode', path: ctx.opencode.path });
     } else if (ctx.opencode?.foreign) {
-      steps.push({ kind: 'skip', reason: `${ctx.opencode.path} was not written by dotmd — leaving it alone` });
+      steps.push({ kind: 'skip', reason: `${ctx.opencode.path} was not written by runlist — leaving it alone` });
     }
   }
   return steps;
@@ -140,24 +140,24 @@ export function runUpdate(argv, _config, opts = {}) {
   const plugin = readInstalledPlugin();
 
   if (check) {
-    process.stdout.write(`dotmd CLI:    ${pkg.version}\n`);
+    process.stdout.write(`runlist CLI:    ${pkg.version}\n`);
     if (plugin) {
       const cmp = compareVersions(plugin.version, pkg.version);
       const tag = cmp === 0 ? green('in sync')
         : cmp === null ? dim('(unknown)')
-        : cmp < 0 ? yellow('behind — run `dotmd update`')
+        : cmp < 0 ? yellow('behind — run `runlist update`')
         : yellow('ahead — CLI is behind');
-      process.stdout.write(`dotmd plugin: ${plugin.version ?? '?'} (${plugin.id}) ${tag}\n`);
+      process.stdout.write(`runlist plugin: ${plugin.version ?? '?'} (${plugin.id}) ${tag}\n`);
       if (plugin.marketplaceRegistered === false) {
-        process.stdout.write(yellow(`  marketplace "${plugin.marketplace}" is not registered — the plugin fails to load; run \`dotmd install claude\`\n`));
+        process.stdout.write(yellow(`  marketplace "${plugin.marketplace}" is not registered — the plugin fails to load; run \`runlist install claude\`\n`));
       }
     } else {
-      process.stdout.write(dim('dotmd plugin: not installed — `dotmd install claude`\n'));
+      process.stdout.write(dim('runlist plugin: not installed — `runlist install claude`\n'));
     }
     const oc = opencodeStatus({ version: pkg.version });
-    if (!oc.exists) process.stdout.write(dim('dotmd opencode: not installed\n'));
-    else if (oc.foreign) process.stdout.write(`dotmd opencode: ${yellow('unmanaged file — not written by dotmd')}\n`);
-    else process.stdout.write(`dotmd opencode: ${oc.version} ${oc.stale ? yellow('behind — run `dotmd update`') : green('in sync')}\n`);
+    if (!oc.exists) process.stdout.write(dim('runlist opencode: not installed\n'));
+    else if (oc.foreign) process.stdout.write(`runlist opencode: ${yellow('unmanaged file — not written by runlist')}\n`);
+    else process.stdout.write(`runlist opencode: ${oc.version} ${oc.stale ? yellow('behind — run `runlist update`') : green('in sync')}\n`);
     return;
   }
 

package/src/use.mjs

@@ -15,13 +15,16 @@ import { resolveDocArg } from './index.mjs';
 // With no argument, consumes the oldest pending prompt.
 export async function runUse(argv, config, opts = {}) {
   const positional = argv.find(a => !a.startsWith('-'));
+  // `--no-claim` reads and archives a prompt without starting the plan it links.
+  const noClaim = argv.includes('--no-claim');
+  const promptOpts = { ...opts, noClaim };
 
   if (!positional) {
     const queue = pendingPromptsOldestFirst(config);
     if (queue.length === 0) die('No pending prompts. Pass a file to use a plan or doc.');
     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, promptOpts);
   }
 
   // Exact path first, then prompt slugs (they keep precedence on a slug
@@ -39,8 +42,9 @@ export async function runUse(argv, config, opts = {}) {
   const type = asString(parsed.type);
 
   if (type === 'prompt') {
-    return consumePrompt(filePath, config, opts);
+    return consumePrompt(filePath, config, promptOpts);
   }
+  if (noClaim) die('--no-claim applies to prompts only; a plan opened with `use` is always claimed.');
   if (type === 'plan') {
     // Mark in-session (pure frontmatter) and print the plan card.
     return startPlan([filePath, ...argv.filter(a => a !== positional)], config, opts);

package/src/validate.mjs

@@ -143,7 +143,7 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
         doc.warnings.push({
           path: doc.path,
           level: 'warning',
-          message: `Unknown surface \`${surface}\`; expected a known surface taxonomy value.${hint} Run \`dotmd surfaces\` to list all valid values.`,
+          message: `Unknown surface \`${surface}\`; expected a known surface taxonomy value.${hint} Run \`runlist surfaces\` to list all valid values.`,
         });
       }
     }
@@ -173,7 +173,7 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
       const autoFixable = singularValues.every(autoFixableString)
         && pluralValue.every(autoFixableString);
       const guidance = autoFixable
-        ? `use \`${target}\`. Run \`dotmd lint --fix\` to migrate.`
+        ? `use \`${target}\`. Run \`runlist lint --fix\` to migrate.`
         : `use a \`${plural}:\` YAML list. Remove the deprecated \`${singular}:\` block manually and preserve all of its values.`;
       doc.warnings.push({
         path: doc.path,
@@ -228,7 +228,7 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
       doc.errors.push({
         path: doc.path,
         level: 'error',
-        message: `\`status: ${doc.status}\` but file is a direct child of \`${parentDir}/\`, not \`${parentDir}/${config.archiveDir}/\`. Run \`dotmd archive ${doc.path}\` to relocate to \`${expected}\`, or change the status.`,
+        message: `\`status: ${doc.status}\` but file is a direct child of \`${parentDir}/\`, not \`${parentDir}/${config.archiveDir}/\`. Run \`runlist archive ${doc.path}\` to relocate to \`${expected}\`, or change the status.`,
       });
     }
   }
@@ -244,8 +244,8 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
     const parentSegments = path.dirname(doc.path).split('/');
     if (parentSegments.includes(config.archiveDir)) {
       const heal = doc.type === 'prompt'
-        ? `dotmd prompts archive ${doc.path}`
-        : `dotmd set archived ${doc.path}`;
+        ? `runlist prompts archive ${doc.path}`
+        : `runlist set archived ${doc.path}`;
       doc.errors.push({
         path: doc.path,
         level: 'error',
@@ -492,7 +492,7 @@ export function checkCoordinationHubExecutionMode(docs, config) {
     warnings.push({
       path: doc.path,
       level: 'warning',
-      message: `reads as a coordination runlist (slug \`${base}\`) but is missing \`execution_mode: coordination\`. Add it so \`dotmd plans\` / \`dotmd runlists\` reliably treat it as a runlist, not an active plan.`,
+      message: `reads as a coordination runlist (slug \`${base}\`) but is missing \`execution_mode: coordination\`. Add it so \`runlist plans\` / \`runlist runlists\` reliably treat it as a runlist, not an active plan.`,
     });
   }
   return warnings;
@@ -547,7 +547,7 @@ export function checkRoadmapHubExecutionMode(docs, config) {
       warnings.push({
         path: doc.path,
         level: 'warning',
-        message: `is a coordination hub whose ${hubChildren} of ${resolved} \`related_plans:\` children are themselves runlists — that's structurally a tier-3 roadmap. Set \`execution_mode: roadmap\` so \`dotmd roadmap\` rolls their progress up (recursive done/total) instead of rendering it flat among them.`,
+        message: `is a coordination hub whose ${hubChildren} of ${resolved} \`related_plans:\` children are themselves runlists — that's structurally a tier-3 roadmap. Set \`execution_mode: roadmap\` so \`runlist roadmap\` rolls their progress up (recursive done/total) instead of rendering it flat among them.`,
       });
     }
   }
@@ -622,7 +622,7 @@ export function validatePlanShape(doc, body, frontmatter, config) {
     doc.warnings.push({
       path: doc.path,
       level: 'warning',
-      message: `\`next_step\` is ${nextStep.length} chars (cap: 800). One mechanical fix: \`dotmd doctor --frontmatter-fix\` (moves the overflow into the body) — do NOT hand-trim or re-run check in a loop. Going forward, write next_step as a 1-2 sentence pointer; detail goes in the body.`,
+      message: `\`next_step\` is ${nextStep.length} chars (cap: 800). One mechanical fix: \`runlist doctor --frontmatter-fix\` (moves the overflow into the body) — do NOT hand-trim or re-run check in a loop. Going forward, write next_step as a 1-2 sentence pointer; detail goes in the body.`,
     });
   }
 
@@ -635,7 +635,7 @@ export function validatePlanShape(doc, body, frontmatter, config) {
     doc.warnings.push({
       path: doc.path,
       level: 'warning',
-      message: `\`current_state\` is ${currentState.length} chars (cap: 1500). One mechanical fix: \`dotmd doctor --frontmatter-fix\` (moves the overflow into the body) — do NOT hand-trim or re-run check in a loop. Going forward, write current_state as a 2-4 sentence summary; detail goes in the body.`,
+      message: `\`current_state\` is ${currentState.length} chars (cap: 1500). One mechanical fix: \`runlist doctor --frontmatter-fix\` (moves the overflow into the body) — do NOT hand-trim or re-run check in a loop. Going forward, write current_state as a 2-4 sentence summary; detail goes in the body.`,
     });
   }
 

package/src/watch.mjs

@@ -22,7 +22,7 @@ export function runWatch(argv, config) {
 
     // Clear terminal
     process.stdout.write('\x1b[2J\x1b[H');
-    process.stderr.write(dim(`[${new Date().toLocaleTimeString()}] dotmd ${subCommand.join(' ')}`) + '\n\n');
+    process.stderr.write(dim(`[${new Date().toLocaleTimeString()}] runlist ${subCommand.join(' ')}`) + '\n\n');
 
     spawnSync(process.execPath, [cliPath, ...subCommand], {
       stdio: 'inherit',