dotmd-cli 0.77.3 → 0.79.0

package/src/guard.mjs

@@ -223,8 +223,11 @@ function editStatusResult(target, config, detail) {
     rule: 'edit-status',
     detail,
     reason:
-      `Looks like a hand-edit of the \`status:\` field in ${target}. Use \`dotmd set <status> ${target}\` instead — ` +
-      `it validates the status against this doc's type, runs lifecycle hooks, fixes refs, and keeps the index in sync. Direct edits skip all of that.`,
+      // Names the canonical executable: a session that follows this message
+      // should land on the current name, not the legacy alias.
+      `Looks like a hand-edit of the \`status:\` field in ${target}. Use \`runlist set <status> ${target}\` instead — ` +
+      `it validates the status against this doc's type, runs lifecycle hooks, fixes refs, and keeps the index in sync. Direct edits skip all of that. ` +
+      `Creating a doc? \`runlist new <type> <name> --status <status>\` writes the status in the same step.`,
   };
 }
 
@@ -266,9 +269,9 @@ function evalBash(command, config, inspectGitPaths, baseCwd) {
           rule: 'commit-prompt',
           detail: `git ${git.subcommand} ${targets.join(' ')}`,
           reason:
-            `Saved prompts (${targets.join(', ')}) are session-local dotmd artifacts, not source to commit. ` +
+            `Saved prompts (${targets.join(', ')}) are session-local runlist artifacts, not source to commit. ` +
             `Don't git add/commit them — commit your other changes without the prompt in the pathspec. ` +
-            `The next session consumes a prompt with \`dotmd use <file>\` (or \`dotmd use\` for the oldest pending), which prints the body and archives it atomically.`,
+            `The next session consumes a prompt with \`runlist use <file>\` (or \`runlist use\` for the oldest pending), which prints the body and archives it atomically.`,
         };
       }
     }
@@ -280,9 +283,9 @@ function evalBash(command, config, inspectGitPaths, baseCwd) {
         rule: 'cat-prompt',
         detail: `${cmd0} ${promptTokens.join(' ')}`,
         reason:
-          `${promptTokens.join(', ')} is a saved dotmd prompt. To start work from it, run \`dotmd use ${promptTokens[0]}\` — ` +
+          `${promptTokens.join(', ')} is a saved runlist prompt. To start work from it, run \`runlist use ${promptTokens[0]}\` — ` +
           `it commits archive/claim before at-most-once body output (prevents double-consumption). ` +
-          `Just peeking or triaging (not consuming)? \`dotmd prompts show ${promptTokens[0]}\` reads it without archiving. Don't \`${cmd0}\` it directly.`,
+          `Just peeking or triaging (not consuming)? \`runlist prompts show ${promptTokens[0]}\` reads it without archiving. Don't \`${cmd0}\` it directly.`,
       };
     }
 
@@ -305,9 +308,9 @@ function evalRead(filePath, config) {
     rule: 'read-prompt',
     detail: filePath,
     reason:
-      `${filePath} is a saved dotmd prompt. To start work from it, run \`dotmd use ${filePath}\` — it commits archive/claim before at-most-once body output so it can't be double-consumed. ` +
-      `Just peeking or triaging (not consuming)? \`dotmd prompts show ${filePath}\` reads it without archiving. ` +
-      `Surveying the whole queue? \`dotmd prompts show --all\` peeks every pending prompt in one call — don't Read them file by file.`,
+      `${filePath} is a saved runlist prompt. To start work from it, run \`runlist use ${filePath}\` — it commits archive/claim before at-most-once body output so it can't be double-consumed. ` +
+      `Just peeking or triaging (not consuming)? \`runlist prompts show ${filePath}\` reads it without archiving. ` +
+      `Surveying the whole queue? \`runlist prompts show --all\` peeks every pending prompt in one call — don't Read them file by file.`,
   };
 }
 
@@ -393,7 +396,7 @@ function emit(result) {
     hookSpecificOutput.permissionDecisionReason = result.reason;
   } else {
     // warn — allow the call but teach the agent the dotmd-native path.
-    hookSpecificOutput.additionalContext = `[dotmd] ${result.reason}`;
+    hookSpecificOutput.additionalContext = `[runlist] ${result.reason}`;
   }
   process.stdout.write(JSON.stringify({ hookSpecificOutput }) + '\n');
 }

package/src/health.mjs

@@ -123,7 +123,7 @@ export function runHealth(argv, config) {
 
   // Roadmaps (tier-3) — pinned above Runlists with the recursive grand total.
   if (roadmapHubs.length > 0) {
-    process.stdout.write(`${bold('Roadmaps:')} ${roadmapHubs.length}  ${dim('· dotmd roadmap')}\n`);
+    process.stdout.write(`${bold('Roadmaps:')} ${roadmapHubs.length}  ${dim('· runlist roadmap')}\n`);
     for (const doc of roadmapHubs.slice(0, 8)) {
       const slug = hubLabel(doc).padEnd(28);
       const age = doc.daysSinceUpdate != null ? `${doc.daysSinceUpdate}d` : '?d';
@@ -142,7 +142,7 @@ export function runHealth(argv, config) {
   // surfaced as their own tally so they don't inflate the active count. Newest
   // first, mirroring `dotmd runlists`; capped with a "more" footer.
   if (runlistHubs.length > 0) {
-    process.stdout.write(`${bold('Runlists:')} ${runlistHubs.length}  ${dim('· dotmd runlists')}\n`);
+    process.stdout.write(`${bold('Runlists:')} ${runlistHubs.length}  ${dim('· runlist runlists')}\n`);
     for (const doc of runlistHubs.slice(0, 8)) {
       const slug = hubLabel(doc).padEnd(28);
       const age = doc.daysSinceUpdate != null ? `${doc.daysSinceUpdate}d` : '?d';

package/src/hints.mjs

@@ -17,32 +17,32 @@ const TEMPLATES = [
   {
     match: /Too many arguments|Usage:/i,
     hint: ({ count, argv }) =>
-      `${count}× the same shape on \`${argv[0]} ${argv[1] ?? ''}\` in this session. Run \`dotmd ${argv[0]} --help\` for the expected positional args.`,
+      `${count}× the same shape on \`${argv[0]} ${argv[1] ?? ''}\` in this session. Run \`runlist ${argv[0]} --help\` for the expected positional args.`,
   },
   {
     match: /Already (consumed|archived)/i,
     hint: ({ count, argv }) =>
-      `${count}× attempts to use a path that is already archived. Use \`dotmd prompts list\` to see what is actually pending, or \`dotmd next\` for the oldest live prompt.`,
+      `${count}× attempts to use a path that is already archived. Use \`runlist prompts list\` to see what is actually pending, or \`runlist next\` for the oldest live prompt.`,
   },
   {
     match: /No pending prompts/i,
     hint: ({ count }) =>
-      `${count}× \`dotmd next\` with no pending prompts in the queue. Either queue one with \`dotmd new prompt <slug> "..."\` or pass an explicit prompt file to \`dotmd use\`.`,
+      `${count}× \`runlist next\` with no pending prompts in the queue. Either queue one with \`runlist new prompt <slug> "..."\` or pass an explicit prompt file to \`runlist use\`.`,
   },
   {
     match: /Unknown command/i,
     hint: ({ count }) =>
-      `${count}× the same unknown command. Run \`dotmd --help\` to list available commands; the dispatch already prints a did-you-mean for close misses.`,
+      `${count}× the same unknown command. Run \`runlist --help\` to list available commands; the dispatch already prints a did-you-mean for close misses.`,
   },
   {
     match: /File not found|does not resolve/i,
     hint: ({ count, argv }) =>
-      `${count}× pointing at a path that doesn't exist. Confirm the file with \`dotmd query\` or \`dotmd plans\` — paths resolve relative to repo root or doc roots, not the cwd.`,
+      `${count}× pointing at a path that doesn't exist. Confirm the file with \`runlist query\` or \`runlist plans\` — paths resolve relative to repo root or doc roots, not the cwd.`,
   },
   {
     match: /Unknown status|Unknown surface/i,
     hint: ({ count }) =>
-      `${count}× rejected by the taxonomy validator. Run \`dotmd statuses list\` or \`dotmd surfaces\` to print the valid values for this project.`,
+      `${count}× rejected by the taxonomy validator. Run \`runlist statuses list\` or \`runlist surfaces\` to print the valid values for this project.`,
   },
 ];
 
@@ -122,7 +122,7 @@ export function findRepeatFailureHint(failingArgv, config) {
       }
     }
 
-    return `${count}× the same failing shape on \`${failingArgv[0]}\` in this session (last attempt ${ageMin}m ago). Check the args — \`dotmd ${failingArgv[0]} --help\` shows what's expected.`;
+    return `${count}× the same failing shape on \`${failingArgv[0]}\` in this session (last attempt ${ageMin}m ago). Check the args — \`runlist ${failingArgv[0]} --help\` shows what's expected.`;
   } catch {
     return null;
   }

package/src/host-integration.mjs

@@ -25,7 +25,13 @@ import { hostSessionSource } from './util.mjs';
 import { readEnv, stateDir } from './naming.mjs';
 import { planMarketplaceRepair } from './update.mjs';
 
-export const GENERATED_MARKER = 'dotmd-generated:';
+// New files carry the current banner. Every reader accepts both: files written
+// by dotmd-cli 0.78.0 and earlier carry the legacy banner, and those must stay
+// recognizable as generated forever, or an old install turns into a "foreign"
+// file that install/update/remove refuse to touch.
+export const GENERATED_MARKER = 'runlist-generated:';
+export const LEGACY_GENERATED_MARKER = 'dotmd-generated:';
+const GENERATED_MARKERS = [GENERATED_MARKER, LEGACY_GENERATED_MARKER];
 const PLUGIN_FILENAME = 'dotmd.js';
 const ASSET = path.resolve(fileURLToPath(import.meta.url), '..', '..', 'assets', 'opencode', 'plugin.js');
 
@@ -58,8 +64,8 @@ export function opencodePluginPath(opts = {}) {
 function banner(version) {
   return [
     `// ${GENERATED_MARKER}${version}`,
-    '// Generated by `dotmd install opencode`. Refreshed by `dotmd update`.',
-    '// Hand edits are overwritten — remove with `dotmd install opencode --remove`.',
+    '// Generated by `runlist install opencode`. Refreshed by `runlist update`.',
+    '// Hand edits are overwritten — remove with `runlist install opencode --remove`.',
     '',
   ].join('\n');
 }
@@ -68,31 +74,44 @@ export function renderOpencodePlugin(version) {
   return banner(version) + readFileSync(ASSET, 'utf8');
 }
 
-// The version a generated file was written by, or null when the file is absent
-// or carries no dotmd banner. A file without the banner is the user's own and
-// is never written or removed — same rule the retired slash-command scaffolding
-// followed.
-export function installedVersion(filePath) {
+// The banner a generated file carries — { marker, version } — or null when the
+// file is absent or carries neither banner. A file without a banner is the
+// user's own and is never written or removed — same rule the retired
+// slash-command scaffolding followed. The earliest banner in the file wins.
+export function readGeneratedBanner(filePath) {
   let contents;
   try { contents = readFileSync(filePath, 'utf8'); } catch { return null; }
-  const marker = contents.indexOf(GENERATED_MARKER);
-  if (marker < 0) return null;
-  const rest = contents.slice(marker + GENERATED_MARKER.length);
-  return rest.split('\n', 1)[0].trim() || null;
+  let found = null;
+  for (const marker of GENERATED_MARKERS) {
+    const at = contents.indexOf(marker);
+    if (at >= 0 && (found === null || at < found.at)) found = { marker, at };
+  }
+  if (!found) return null;
+  const rest = contents.slice(found.at + found.marker.length);
+  return { marker: found.marker, version: rest.split('\n', 1)[0].trim() || null };
+}
+
+export function installedVersion(filePath) {
+  return readGeneratedBanner(filePath)?.version ?? null;
 }
 
 export function opencodeStatus(opts = {}) {
   const { version, ...rest } = opts;
   const filePath = opencodePluginPath(rest);
   const exists = existsSync(filePath);
-  const installed = exists ? installedVersion(filePath) : null;
+  const generated = exists ? readGeneratedBanner(filePath) : null;
+  const installed = generated?.version ?? null;
+  const legacyBanner = generated?.marker === LEGACY_GENERATED_MARKER;
   return {
     path: filePath,
     exists,
     version: installed,
     // Present but unmarked: the user put a `dotmd.js` there themselves.
     foreign: exists && installed === null,
-    stale: installed !== null && version !== undefined && installed !== version,
+    // A legacy banner is stale even at the same version, so the next install or
+    // update rewrites it in place with the current banner.
+    stale: installed !== null && ((version !== undefined && installed !== version) || legacyBanner),
+    legacyBanner,
   };
 }
 
@@ -110,7 +129,7 @@ export function installOpencodePlugin(opts = {}) {
   const { version, dryRun = false, force = false, ...rest } = opts;
   const status = opencodeStatus({ version, ...rest });
   if (status.foreign && !force) {
-    return { ...status, action: 'refused', reason: 'a dotmd.js without a dotmd banner is already there — it was not written by dotmd' };
+    return { ...status, action: 'refused', reason: 'a dotmd.js without a generated banner is already there — it was not written by runlist' };
   }
   if (status.exists && !status.stale && !status.foreign) {
     return { ...status, action: 'current' };
@@ -153,7 +172,7 @@ export function describeSessionIdentity(opts = {}) {
       // still carries the old identity — say so rather than leave a warning
       // marker with no explanation.
       ? 'restart OpenCode — this session predates the installed integration'
-      : 'dotmd install opencode  — for a per-session identity');
+      : 'runlist install opencode  — for a per-session identity');
   } else if (source.scope === 'terminal') {
     advice.push('every agent session in this terminal shares this id — set RUNLIST_SESSION_ID per session');
   }
@@ -202,11 +221,11 @@ export function degradedIdentityNotice(repoRoot, opts = {}) {
 
   const installed = opencodeStatus({ env, homedir, version }).exists;
   const lines = installed
-    ? ['[dotmd] This OpenCode session started before the dotmd integration loaded, so its plan',
+    ? ['[runlist] This OpenCode session started before the runlist integration loaded, so its plan',
       '        ownership is still process-scoped. Restart OpenCode to pick it up.']
-    : ['[dotmd] OpenCode detected, dotmd integration not installed — plan ownership is scoped to',
+    : ['[runlist] OpenCode detected, runlist integration not installed — plan ownership is scoped to',
       '        the OpenCode process, so another session in it can release plans this one claimed,',
-      '        and no session-start briefing runs. Fix once: dotmd install opencode'];
+      '        and no session-start briefing runs. Fix once: runlist install opencode'];
 
   if (!record) return lines.join('\n');
   if (!repoRoot) return lines.join('\n');
@@ -251,7 +270,7 @@ export function claudeMarketplaceRefusalHint(marketplace = 'dotmd') {
 // the side effects stay in the caller.
 export function planClaudeInstall({ installed, hasClaude, remove = false } = {}) {
   if (remove) {
-    if (!installed) return [{ kind: 'skip', reason: 'dotmd plugin is not installed' }];
+    if (!installed) return [{ kind: 'skip', reason: 'runlist plugin is not installed' }];
     return hasClaude
       ? [{ kind: 'run', cmd: ['claude', 'plugin', 'uninstall', installed.id] }]
       : [{ kind: 'manual', lines: [`/plugin uninstall ${installed.id}`] }];
@@ -263,7 +282,7 @@ export function planClaudeInstall({ installed, hasClaude, remove = false } = {})
     return planMarketplaceRepair(installed, { hasClaude, verb: 'update' })
       .map(step => (step.kind === 'marketplace' || step.kind === 'plugin' ? { ...step, kind: 'run', step: step.kind } : step));
   }
-  if (installed) return [{ kind: 'skip', reason: `dotmd plugin already installed (${installed.version ?? 'unknown version'})` }];
+  if (installed) return [{ kind: 'skip', reason: `runlist plugin already installed (${installed.version ?? 'unknown version'})` }];
   // The marketplace has to be registered before the plugin resolves; adding one
   // already present is a no-op, so this stays safe to re-run.
   if (!hasClaude) {
@@ -280,7 +299,7 @@ export function removeOpencodePlugin(opts = {}) {
   const status = opencodeStatus(rest);
   if (!status.exists) return { ...status, action: 'absent' };
   if (status.foreign && !force) {
-    return { ...status, action: 'refused', reason: 'not a dotmd-generated file' };
+    return { ...status, action: 'refused', reason: 'not a runlist-generated file' };
   }
   if (!dryRun) rmSync(status.path, { force: true });
   return { ...status, action: 'removed' };

package/src/hub-membership.mjs

@@ -273,7 +273,7 @@ export function checkHubMembershipDrift(docs, config) {
     warnings.push({
       path: child.path,
       level: 'warning',
-      message: `is ranked in the body order of \`${hub.path}\` (the list \`dotmd runlist next\` walks) but has no \`parent_plan:\`. Add \`parent_plan: ${hub.path}\` so reverse-link tooling (pickup-card Related:, graph) stays consistent.`,
+      message: `is ranked in the body order of \`${hub.path}\` (the list \`runlist runlist next\` walks) but has no \`parent_plan:\`. Add \`parent_plan: ${hub.path}\` so reverse-link tooling (pickup-card Related:, graph) stays consistent.`,
       meta: { kind: BACKREF_KIND, hub: hub.path, source: 'body-order' },
     });
   }

package/src/hud.mjs

@@ -33,8 +33,8 @@ export function detectVersionDrift(env = process.env) {
     const pluginVersion = JSON.parse(readFileSync(pj, 'utf8')).version;
     const cmp = compareVersions(pluginVersion, pkg.version);
     if (cmp === null || cmp === 0) return null;
-    if (cmp < 0) return `dotmd plugin ${pluginVersion} is behind the CLI ${pkg.version} — run \`dotmd update\` then restart.`;
-    return `dotmd CLI ${pkg.version} is behind the plugin ${pluginVersion} — run \`dotmd update\` (or npm i -g dotmd-cli).`;
+    if (cmp < 0) return `runlist plugin ${pluginVersion} is behind the CLI ${pkg.version} — run \`runlist update\` then restart.`;
+    return `runlist CLI ${pkg.version} is behind the plugin ${pluginVersion} — run \`runlist update\` (or npm i -g dotmd-cli).`;
   } catch {
     return null;
   }
@@ -155,9 +155,9 @@ const MISUSE_RECAP_WINDOW_MS = 7 * 24 * 60 * 60 * 1000;
 const MISUSE_RECAP_THRESHOLD = 3;
 
 const MISUSE_CORRECTIONS = {
-  'edit-status': 'never hand-edit `status:`; use `dotmd set <status> <file>`',
-  'cat-prompt': 'consume prompts with `dotmd use <file>`; peek without consuming via `dotmd prompts show <file>`',
-  'read-prompt': 'consume prompts with `dotmd use <file>`; peek without consuming via `dotmd prompts show <file>`',
+  'edit-status': 'never hand-edit `status:`; use `runlist set <status> <file>`',
+  'cat-prompt': 'consume prompts with `runlist use <file>`; peek without consuming via `runlist prompts show <file>`',
+  'read-prompt': 'consume prompts with `runlist use <file>`; peek without consuming via `runlist prompts show <file>`',
   'commit-prompt': 'saved prompts are session-local; never git add/commit them',
 };
 
@@ -176,7 +176,7 @@ export function buildMisuseRecap(config, now = Date.now()) {
   const top = [...counts.entries()].sort((a, b) => b[1] - a[1])[0];
   if (!top || top[1] < MISUSE_RECAP_THRESHOLD) return null;
   const [rule, count] = top;
-  const fix = MISUSE_CORRECTIONS[rule] ?? 'see `dotmd misuse`';
+  const fix = MISUSE_CORRECTIONS[rule] ?? 'see `runlist misuse`';
   return `sessions here tripped ${rule} ${count}× this week — ${fix}`;
 }
 
@@ -235,15 +235,15 @@ export function buildHud(config) {
 // lines: the verbs + the three wrong-moves the guard exists to stop, so the
 // subagent self-corrects before the guard ever has to fire.
 const SUBAGENT_PRIMER = [
-  'dotmd manages this repo\'s plans/docs/prompts (markdown + YAML frontmatter).',
+  'runlist manages this repo\'s plans/docs/prompts (markdown + YAML frontmatter).',
   'Verbs: plans|briefing | query <filters> | use [<file>] | set <status> <file> | new <type> <slug> | archive <file>.',
-  'Do NOT: cat/read a docs/prompts/*.md (use `dotmd use <file>` — archive/claim commits before at-most-once output);',
-  'git add/commit a prompt (they are session-local, often gitignored); hand-edit a `status:` field (use `dotmd set`).',
+  'Do NOT: cat/read a docs/prompts/*.md (use `runlist use <file>` — archive/claim commits before at-most-once output);',
+  'git add/commit a prompt (they are session-local, often gitignored); hand-edit a `status:` field (use `runlist set`).',
 ].join('\n');
 
 export function buildPlanStatusPrimer(config, { maxChars = 220 } = {}) {
   const statuses = (resolveStatusMetadata(config).byType.plan ?? []).map(item => item.name);
-  const fallback = 'run `dotmd statuses list --type plan`';
+  const fallback = 'run `runlist statuses list --type plan`';
   if (statuses.length === 0) return `Plan statuses unavailable; ${fallback}.`;
   const prefix = 'Plan statuses: ';
   const full = `${prefix}${statuses.join(', ')}`;
@@ -313,15 +313,15 @@ export function runHud(argv, config) {
   //     Global in-session counts never provide a fallback.
   // The misuse recap stays for the same reason: a repeat-offense rule means
   // the primer alone isn't landing, so name the habit to break.
-  process.stdout.write(dim('dotmd: plans|briefing  set <status> [<file>]  new <type> <slug>  use [<file>]  archive <file>  baton [<slug>] <@<file>|-> (save a resume prompt; releases the in-session plan if any)  (use [no-arg] → oldest pending prompt)') + '\n');
+  process.stdout.write(dim('runlist: plans|briefing  set <status> [<file>]  new <type> <slug>  use [<file>]  archive <file>  baton [<slug>] <@<file>|-> (save a resume prompt; releases the in-session plan if any)  (use [no-arg] → oldest pending prompt)') + '\n');
   process.stdout.write(dim(buildPlanStatusPrimer(config)) + '\n');
   if (hud.owned && hud.owned.via === 'ownership') {
-    process.stdout.write(yellow(`[dotmd] in-session (yours): ${hud.owned.path} — continue it; hand off with \`dotmd baton @/tmp/draft.md\` before stopping.`) + '\n');
+    process.stdout.write(yellow(`[runlist] in-session (yours): ${hud.owned.path} — continue it; hand off with \`runlist baton @/tmp/draft.md\` before stopping.`) + '\n');
   }
   if (hud.prompts.length > 0) {
     const n = hud.prompts.length;
-    process.stdout.write(yellow(`[dotmd] ${n} pending prompt${n === 1 ? '' : 's'} queued for this session — unless the user asks for something else, start by running \`dotmd use\` to consume the oldest (${hud.prompts[0]}) and act on it. Peek first: \`dotmd prompts show <file>\`; list: \`dotmd prompts\`.`) + '\n');
+    process.stdout.write(yellow(`[runlist] ${n} pending prompt${n === 1 ? '' : 's'} queued for this session — unless the user asks for something else, start by running \`runlist use\` to consume the oldest (${hud.prompts[0]}) and act on it. Peek first: \`runlist prompts show <file>\`; list: \`runlist prompts\`.`) + '\n');
   }
-  if (hud.misuseRecap) process.stdout.write(yellow(`[dotmd] ${hud.misuseRecap}`) + '\n');
+  if (hud.misuseRecap) process.stdout.write(yellow(`[runlist] ${hud.misuseRecap}`) + '\n');
   if (drift) process.stdout.write(yellow(drift) + '\n');
 }

package/src/index-file.mjs

@@ -72,7 +72,7 @@ function renderArchivedSection(docs, config, status) {
     lines.push(`| [${escapeTable(doc.title)}](${linkPath}) | ${escapeTable(formatSnapshot(doc, config))} |`);
   }
   lines.push('');
-  lines.push('- Use `dotmd list` or `dotmd json` for the full inventory.');
+  lines.push('- Use `runlist list` or `runlist json` for the full inventory.');
 
   return lines;
 }
@@ -141,7 +141,7 @@ export function checkIndex(docs, config, opts = {}) {
   const index = { docs };
   const expected = renderIndexFile(index, config);
   if (expected !== current) {
-    errors.push({ path: config.indexPath, level: 'error', message: 'Generated index block is stale. Run `dotmd index`.' });
+    errors.push({ path: config.indexPath, level: 'error', message: 'Generated index block is stale. Run `runlist index`.' });
   }
 
   return { warnings, errors };

package/src/init.mjs

@@ -87,40 +87,40 @@ status: planned
 created: ${today}
 updated: ${today}
 title: Example Plan
-summary: A scaffolded sample showing what a dotmd plan looks like — safe to delete.
-current_state: "Scaffolded by \`dotmd init\` as a shape reference. Nothing here is real work."
+summary: A scaffolded sample showing what a runlist plan looks like — safe to delete.
+current_state: "Scaffolded by \`runlist init\` as a shape reference. Nothing here is real work."
 next_step: "Delete this file, or edit it into your first real plan."
 ---
 
 # Example Plan
 
-> A scaffolded sample showing what a dotmd plan looks like — safe to delete.
+> A scaffolded sample showing what a runlist plan looks like — safe to delete.
 
 ## Problem
 
-\`dotmd init\` leaves this file behind so \`docs/plans/\` survives a clone (git cannot
+\`runlist init\` leaves this file behind so \`docs/plans/\` survives a clone (git cannot
 track an empty directory) and so the frontmatter above has something to point at.
 
 The fields that matter: \`status\` drives every listing, \`current_state\` and
-\`next_step\` are what \`dotmd briefing\` reads out, and \`updated\` drives staleness.
-Never hand-edit \`status:\` — \`dotmd set <status> <file>\` writes it, validates it
+\`next_step\` are what \`runlist briefing\` reads out, and \`updated\` drives staleness.
+Never hand-edit \`status:\` — \`runlist set <status> <file>\` writes it, validates it
 against the type, and runs the lifecycle hooks.
 
 ## Phases
 
-- [ ] Delete this file: \`dotmd archive docs/plans/${SAMPLE_PLAN_NAME}\`
-- [ ] Write a real one: \`dotmd new plan <name>\`
+- [ ] Delete this file: \`runlist archive docs/plans/${SAMPLE_PLAN_NAME}\`
+- [ ] Write a real one: \`runlist new plan <name>\`
 
 ## Version History
 
-- Scaffolded by \`dotmd init\`.
+- Scaffolded by \`runlist init\`.
 `;
 
 const STARTER_INDEX = `# Docs
 
 <!-- GENERATED:dotmd:start -->
 
-_No docs yet. Run \`dotmd list\` after creating your first document._
+_No docs yet. Run \`runlist list\` after creating your first document._
 
 <!-- GENERATED:dotmd:end -->
 `;
@@ -332,7 +332,7 @@ export async function runInit(cwd, config, opts = {}) {
     }
     if (existsSync(subPath)) {
       const detail = total > 0
-        ? ` (${counts.withFrontmatter} dotmd-tracked, ${counts.withoutFrontmatter} plain .md)`
+        ? ` (${counts.withFrontmatter} runlist-tracked, ${counts.withoutFrontmatter} plain .md)`
         : '';
       process.stdout.write(`  ${dryTag}${dim('exists')}  docs/${sub}/${detail}\n`);
     } else {
@@ -373,7 +373,7 @@ export async function runInit(cwd, config, opts = {}) {
     for (const sub of subs) {
       process.stdout.write(`             • move into docs/: mv ./${sub}/* docs/${sub}/ && rmdir ./${sub}\n`);
     }
-    process.stdout.write(`             • or use a flat layout — set in dotmd.config.mjs:\n`);
+    process.stdout.write(`             • or use a flat layout — set in runlist.config.mjs:\n`);
     process.stdout.write(`                 export const root = [${subs.map(s => `'${s}'`).join(', ')}];\n`);
   }
 
@@ -425,7 +425,7 @@ export async function runInit(cwd, config, opts = {}) {
     });
     // Exit 0 → ignored. Exit 1 → not ignored. Exit 128 → not in repo / git error.
     if (probe.status === 0) {
-      process.stdout.write(`\n  ${yellow('notice')}  docs/ is gitignored — files dotmd manages will NOT be tracked.\n`);
+      process.stdout.write(`\n  ${yellow('notice')}  docs/ is gitignored — files runlist manages will NOT be tracked.\n`);
       process.stdout.write(`           Add an exception to .gitignore so docs/ is tracked:\n`);
       process.stdout.write(`             !docs/\n`);
       process.stdout.write(`           Or run: echo '!docs/' >> .gitignore\n`);
@@ -438,7 +438,7 @@ export async function runInit(cwd, config, opts = {}) {
   if (scan?.untaggedCount > 0) {
     const n = scan.untaggedCount;
     const noun = n === 1 ? 'file' : 'files';
-    process.stdout.write(`\n  ${yellow('hint')}    ${n} untagged .md ${noun} found — run \`dotmd bulk-tag --dry-run\` to preview tagging.\n`);
+    process.stdout.write(`\n  ${yellow('hint')}    ${n} untagged .md ${noun} found — run \`runlist bulk-tag --dry-run\` to preview tagging.\n`);
   }
 
   // Claude Code integration. dotmd no longer scaffolds per-repo
@@ -457,25 +457,25 @@ export async function runInit(cwd, config, opts = {}) {
     const removed = removeGeneratedSlashCommands(cwd, { dryRun });
     for (const r of removed) {
       const verb = dryRun ? 'would remove' : 'removed';
-      process.stdout.write(`  ${dryTag}${yellow('clean')}   .claude/commands/${r.name} (retired — ${verb}; guidance ships via the dotmd plugin)\n`);
+      process.stdout.write(`  ${dryTag}${yellow('clean')}   .claude/commands/${r.name} (retired — ${verb}; guidance ships via the runlist plugin)\n`);
     }
   }
 
   if (likelyClaudeUser) {
     const sessionStart = detectSessionStartHook(cwd);
     if (sessionStart.wired) {
-      process.stdout.write(`  ${dim('exists')}  ${sessionStart.file} (SessionStart hook for \`dotmd hud\` already wired)\n`);
+      process.stdout.write(`  ${dim('exists')}  ${sessionStart.file} (SessionStart hook for \`runlist hud\` already wired)\n`);
     } else {
-      process.stdout.write(`\n  ${yellow('hint')}    install the dotmd Claude Code plugin so its hooks + workflow skill\n`);
+      process.stdout.write(`\n  ${yellow('hint')}    install the runlist Claude Code plugin so its hooks + workflow skill\n`);
       process.stdout.write(`            travel to every session and subagent automatically:\n\n`);
       process.stdout.write(`              /plugin marketplace add reowens/dotmd\n`);
       process.stdout.write(`              /plugin install dotmd@dotmd\n\n`);
-      process.stdout.write(`            The plugin's hooks call \`dotmd\` on your PATH, so install the CLI\n`);
+      process.stdout.write(`            The plugin's hooks call \`runlist\` on your PATH, so install the CLI\n`);
       process.stdout.write(`            globally too — ${green('npm i -g dotmd-cli')} (a project devDependency won't power them).\n\n`);
-      process.stdout.write(`            Or, without the plugin, wire \`dotmd hud\` at SessionStart by hand —\n`);
+      process.stdout.write(`            Or, without the plugin, wire \`runlist hud\` at SessionStart by hand —\n`);
       process.stdout.write(`            add to .claude/settings.json (merge into any existing hooks):\n\n`);
       process.stdout.write(`              "hooks": { "SessionStart": [\n`);
-      process.stdout.write(`                { "hooks": [{ "type": "command", "command": "dotmd hud" }] }\n`);
+      process.stdout.write(`                { "hooks": [{ "type": "command", "command": "runlist hud" }] }\n`);
       process.stdout.write(`              ] }\n`);
     }
   }
@@ -505,8 +505,8 @@ export async function runInit(cwd, config, opts = {}) {
   }
 
   process.stdout.write(`\nReady. A few starting points:\n`);
-  process.stdout.write(`  dotmd new doc my-doc            # scaffold a reference doc\n`);
-  process.stdout.write(`  dotmd new plan my-plan          # scaffold an execution plan\n`);
-  process.stdout.write(`  dotmd list                      # see what you've got\n`);
-  process.stdout.write(`  dotmd hud                       # session-start triage\n\n`);
+  process.stdout.write(`  runlist new doc my-doc            # scaffold a reference doc\n`);
+  process.stdout.write(`  runlist new plan my-plan          # scaffold an execution plan\n`);
+  process.stdout.write(`  runlist list                      # see what you've got\n`);
+  process.stdout.write(`  runlist hud                       # session-start triage\n\n`);
 }

package/src/install.mjs

@@ -43,7 +43,7 @@ function reportStatus(json) {
     return;
   }
   const { claude, opencode } = states;
-  process.stdout.write(`${bold('dotmd host integrations')}  ${dim(`CLI ${pkg.version}`)}\n\n`);
+  process.stdout.write(`${bold('runlist host integrations')}  ${dim(`CLI ${pkg.version}`)}\n\n`);
 
   const claudeBroken = claude.installed && claude.marketplaceRegistered === false;
   const claudeState = !claude.installed ? yellow('not installed')
@@ -60,8 +60,8 @@ function reportStatus(json) {
   process.stdout.write(`            ${dim(opencode.path)}\n`);
 
   const todo = [];
-  if (!claude.installed || claudeBroken) todo.push('dotmd install claude');
-  if (!opencode.exists || opencode.stale) todo.push('dotmd install opencode');
+  if (!claude.installed || claudeBroken) todo.push('runlist install claude');
+  if (!opencode.exists || opencode.stale) todo.push('runlist install opencode');
   if (todo.length) {
     process.stdout.write('\n');
     for (const cmd of todo) process.stdout.write(`Run ${bold(cmd)}\n`);
@@ -143,7 +143,7 @@ function installOpencode(argv, dryRun, json) {
       if (dryRun) return result;
       process.stdout.write('\nRestart OpenCode to apply. New sessions then get:\n');
       process.stdout.write(`  ${dim('·')} a per-session ownership identity (one session can no longer release another's plan)\n`);
-      process.stdout.write(`  ${dim('·')} the ${bold('dotmd hud')} primer at session start, like Claude Code's SessionStart hook\n`);
+      process.stdout.write(`  ${dim('·')} the ${bold('runlist hud')} primer at session start, like Claude Code's SessionStart hook\n`);
       process.stdout.write(dim('\nPlans already in-session were claimed under the old process-scoped identity;\n'));
       process.stdout.write(dim('close them before restarting, or reclaim with --force afterwards.\n'));
       return result;

package/src/journal.mjs

@@ -10,11 +10,17 @@ const ROTATE_SIZE_BYTES = 5 * 1024 * 1024;
 const ROTATE_AGE_MS = 30 * 24 * 60 * 60 * 1000;
 const BACKUP_RETENTION_MS = ROTATE_AGE_MS;
 
-const ERROR_LOG_FILE = 'dotmd-errors.log';
-const ERROR_LOG_BACKUP = 'dotmd-errors.log.1';
+// New writes go to the runlist-* names. The dotmd-* names are what dotmd-cli
+// 0.78.0 and earlier wrote, and what an older CLI still installed elsewhere on
+// the machine keeps writing, so readers merge both and never rename or delete
+// the legacy files (beyond the usual stale-schema and stale-backup pruning).
+const ERROR_LOG_FILE = 'runlist-errors.log';
+const ERROR_LOG_BACKUP = 'runlist-errors.log.1';
 
-const MISUSE_LOG_FILE = 'dotmd-misuse.log';
-const MISUSE_LOG_BACKUP = 'dotmd-misuse.log.1';
+const MISUSE_LOG_FILE = 'runlist-misuse.log';
+const MISUSE_LOG_BACKUP = 'runlist-misuse.log.1';
+const LEGACY_MISUSE_LOG_FILE = 'dotmd-misuse.log';
+const LEGACY_MISUSE_LOG_BACKUP = 'dotmd-misuse.log.1';
 const TELEMETRY_SCHEMA = 2;
 const REDACTED = '[redacted]';
 const SENSITIVE_VALUE_FLAGS = new Set([
@@ -358,9 +364,12 @@ export function recordGuardEvent(event) {
   }
 }
 
-export function readMisuseEntries() {
-  const file = globalMisuseLogPath();
-  purgeLegacyTelemetry(file, globalMisuseLogBackupPath());
+// Every misuse log a reader should see: the current file, then the legacy one.
+export function globalMisuseLogPaths() {
+  return [globalMisuseLogPath(), path.join(globalErrorLogDir(), LEGACY_MISUSE_LOG_FILE)];
+}
+
+function readLogLines(file) {
   if (!existsSync(file)) return [];
   let raw;
   try { raw = readFileSync(file, 'utf8'); } catch { return []; }
@@ -371,3 +380,27 @@ export function readMisuseEntries() {
   }
   return out;
 }
+
+// Current and legacy entries, merged oldest-first by timestamp. The sort is
+// stable, so entries with equal or unparseable timestamps keep file order.
+export function readMisuseEntries() {
+  const dir = globalErrorLogDir();
+  const pairs = [
+    [globalMisuseLogPath(), globalMisuseLogBackupPath()],
+    [path.join(dir, LEGACY_MISUSE_LOG_FILE), path.join(dir, LEGACY_MISUSE_LOG_BACKUP)],
+  ];
+  const entries = [];
+  for (const [file, backup] of pairs) {
+    purgeLegacyTelemetry(file, backup);
+    pruneStaleBackup(backup);
+    entries.push(...readLogLines(file));
+  }
+  const time = (entry) => {
+    const t = Date.parse(entry?.ts);
+    return Number.isNaN(t) ? 0 : t;
+  };
+  return entries
+    .map((entry, index) => ({ entry, index, t: time(entry) }))
+    .sort((a, b) => a.t - b.t || a.index - b.index)
+    .map(({ entry }) => entry);
+}