dotmd-cli 0.78.0 → 0.79.1

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);
+}

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`);
 }