dotmd-cli 0.87.2 → 0.89.1

package/src/init.mjs

@@ -53,8 +53,8 @@ export const root = 'docs';
 
 export const index = {
   path: 'docs/docs.md',
-  startMarker: '<!-- GENERATED:dotmd:start -->',
-  endMarker: '<!-- GENERATED:dotmd:end -->',
+  startMarker: '<!-- GENERATED:runlist:start -->',
+  endMarker: '<!-- GENERATED:runlist:end -->',
   archivedLimit: 8,
 };
 
@@ -118,11 +118,11 @@ against the type, and runs the lifecycle hooks.
 
 const STARTER_INDEX = `# Docs
 
-<!-- GENERATED:dotmd:start -->
+<!-- GENERATED:runlist:start -->
 
 _No docs yet. Run \`runlist list\` after creating your first document._
 
-<!-- GENERATED:dotmd:end -->
+<!-- GENERATED:runlist:end -->
 `;
 
 function scanExistingDocs(dir) {
@@ -263,8 +263,8 @@ function generateDetectedConfig(scan, rootPath) {
 
   lines.push('export const index = {');
   lines.push(`  path: '${rootPath}/docs.md',`);
-  lines.push(`  startMarker: '<!-- GENERATED:dotmd:start -->',`);
-  lines.push(`  endMarker: '<!-- GENERATED:dotmd:end -->',`);
+  lines.push(`  startMarker: '<!-- GENERATED:runlist:start -->',`);
+  lines.push(`  endMarker: '<!-- GENERATED:runlist:end -->',`);
   lines.push(`  snapshot: 'status',`);
   lines.push('};');
   lines.push('');

package/src/install.mjs

@@ -9,11 +9,12 @@ import {
 } from './host-integration.mjs';
 import { readInstalledPlugin } from './update.mjs';
 import { executableName, which } from './util.mjs';
+import { codexStatus, installCodexPlugin } from './codex-integration.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
 
-const HOSTS = ['claude', 'opencode'];
+const HOSTS = ['claude', 'codex', 'opencode'];
 const ALIASES = { 'claude-code': 'claude', claudecode: 'claude' };
 
 function flagValue(argv, name) {
@@ -33,6 +34,7 @@ function hostStates() {
       marketplaceRegistered: plugin ? plugin.marketplaceRegistered : null,
     },
     opencode: { ...opencodeStatus({ version: pkg.version }), detected: opencodeDetected() },
+    codex: codexStatus({ version: pkg.version }),
   };
 }
 
@@ -42,7 +44,7 @@ function reportStatus(json) {
     process.stdout.write(JSON.stringify({ cli: pkg.version, hosts: states }, null, 2) + '\n');
     return;
   }
-  const { claude, opencode } = states;
+  const { claude, codex, opencode } = states;
   process.stdout.write(`${bold('runlist host integrations')}  ${dim(`CLI ${pkg.version}`)}\n\n`);
 
   const claudeBroken = claude.installed && claude.marketplaceRegistered === false;
@@ -52,6 +54,13 @@ function reportStatus(json) {
   process.stdout.write(`  claude    ${claudeState}\n`);
   process.stdout.write(`            ${dim(claude.installed ? claude.id : 'plugin: SessionStart primer, PreToolUse guard, workflow skill')}\n`);
 
+  const codexState = codex.foreign ? yellow('unmanaged directory present')
+    : !codex.exists ? yellow('not installed')
+    : codex.stale ? yellow(`${codex.version} — behind CLI ${pkg.version}`)
+    : green(codex.version);
+  process.stdout.write(`  codex     ${codexState}\n`);
+  process.stdout.write(`            ${dim(codex.plugin)}\n`);
+
   const ocState = opencode.foreign ? yellow('unmanaged file present')
     : !opencode.exists ? yellow('not installed')
     : opencode.stale ? yellow(`${opencode.version} — behind CLI ${pkg.version}`)
@@ -61,6 +70,7 @@ function reportStatus(json) {
 
   const todo = [];
   if (!claude.installed || claudeBroken) todo.push('runlist install claude');
+  if (!codex.exists || codex.stale) todo.push('runlist install codex');
   if (!opencode.exists || opencode.stale) todo.push('runlist install opencode');
   if (todo.length) {
     process.stdout.write('\n');
@@ -73,6 +83,43 @@ function reportStatus(json) {
   }
 }
 
+function installCodex(argv, dryRun, json) {
+  if (argv.includes('--remove')) {
+    process.stderr.write('Codex removal is managed by `codex plugin remove`; the personal marketplace source is left available.\n');
+    process.exitCode = 1;
+    return;
+  }
+  const result = installCodexPlugin({ version: pkg.version, dryRun });
+  if (result.action === 'refused') {
+    if (json) process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    else process.stderr.write(`refused: ${result.reason}\n`);
+    process.exitCode = 1;
+    return;
+  }
+  if (!json) process.stdout.write(`${dryRun ? '[dry-run] ' : ''}${result.action} codex integration (${pkg.version}) at ${result.plugin}\n`);
+  if (dryRun) {
+    if (json) process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    return;
+  }
+  const selector = `runlist-codex@${result.marketplaceName}`;
+  if (!which('codex')) {
+    if (json) process.stdout.write(JSON.stringify({ ...result, pluginAdd: 'codex-cli-unavailable' }, null, 2) + '\n');
+    else process.stdout.write(`Install in Codex with: codex plugin add ${selector}\n`);
+    return;
+  }
+  const added = spawnSync(executableName('codex'), ['plugin', 'add', selector], {
+    stdio: json ? 'pipe' : 'inherit', encoding: json ? 'utf8' : undefined,
+    shell: process.platform === 'win32',
+  });
+  if (json) process.stdout.write(JSON.stringify({ ...result, pluginAdd: added.status === 0 ? 'installed' : 'failed', pluginAddExit: added.status }, null, 2) + '\n');
+  if (added.status !== 0) {
+    process.stderr.write(`Codex plugin source is ready; finish installation with: codex plugin add ${selector}\n`);
+    process.exitCode = 1;
+  } else if (!json) {
+    process.stdout.write('Start a new Codex thread and review/trust the plugin hooks to enable the primer and guard.\n');
+  }
+}
+
 function installClaude(argv, dryRun, json) {
   const remove = argv.includes('--remove');
   const steps = planClaudeInstall({ installed: readInstalledPlugin(), hasClaude: which('claude'), remove });
@@ -164,5 +211,6 @@ export function runInstall(argv, _config, opts = {}) {
 
   const dryRun = Boolean(opts.dryRun);
   if (host === 'claude') { installClaude(argv, dryRun, json); return; }
+  if (host === 'codex') { installCodex(argv, dryRun, json); return; }
   installOpencode(argv, dryRun, json);
 }

package/src/lifecycle.mjs

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { extractFrontmatter, parseSimpleFrontmatter, normalizeEol } from './frontmatter.mjs';
-import { asString, toRepoPath, die, warn, resolveDocPath, escapeRegex, nowIso, suggestCandidates, emitFilesFooter, isArchivedPath, currentSessionId } from './util.mjs';
+import { asString, toRepoPath, die, warn, resolveDocPath, resolveRefPath, escapeRegex, nowIso, suggestCandidates, emitFilesFooter, isArchivedPath, currentSessionId } from './util.mjs';
 import { readJournalEntries } from './journal.mjs';
 import { captureGitIndexGeneration, getGitLastModifiedBatch, getGitLastSubstantiveModifiedBatch, isTracked } from './git.mjs';
 import { buildIndex, collectDocFiles, resolveDocArg } from './index.mjs';
@@ -78,6 +78,22 @@ function commitLifecycleMutation(filePath, targetPath, config, updates, historyF
     };
   };
   if (targetPath) {
+    // A companion prompt created or refreshed by baton links this plan before
+    // its status transition decides whether to file it elsewhere. Stamp the
+    // destination into that companion before publishing any transaction path.
+    const newRepoPath = toRepoPath(targetPath, config.repoRoot);
+    const retargetPrompt = item => {
+      if (typeof item.content !== 'string') return item;
+      const { frontmatter, body } = extractFrontmatter(item.content);
+      if (!frontmatter) return item;
+      const fm = parseSimpleFrontmatter(frontmatter);
+      const linked = asString(fm.plan);
+      const resolved = linked ? resolveRefPath(linked, path.dirname(item.path), config.repoRoot) : null;
+      if (asString(fm.type) !== 'prompt' || !resolved || path.resolve(resolved) !== path.resolve(filePath)) return item;
+      const rewritten = frontmatter.replace(/^plan:[ \t]*\S.*$/m, `plan: ${newRepoPath}`);
+      return { ...item, content: `---\n${rewritten}\n---\n${body}` };
+    };
+    const creations = (options.creations ?? []).map(retargetPrompt);
     let result;
     const tracked = isTracked(filePath, config.repoRoot);
     const gitIndex = tracked ? captureGitIndexGeneration(config.repoRoot) : null;
@@ -89,8 +105,8 @@ function commitLifecycleMutation(filePath, targetPath, config, updates, historyF
     const identities = createReferenceIdentitySet([filePath, ...allFiles]);
     const referenceFields = configuredReferenceFields(config);
     const additionalUpdates = options.skipInboundRefs
-      ? (options.additionalUpdates ?? [])
-      : (options.additionalUpdates ?? []).map(item => ({
+      ? (options.additionalUpdates ?? []).map(retargetPrompt)
+      : (options.additionalUpdates ?? []).map(item => retargetPrompt({
           ...item,
           content: item.content === undefined ? undefined : rewriteDocumentReferences(item.content, {
             sourcePath: item.path, repoRoot: config.repoRoot, identities, oldPath: filePath, newPath: targetPath, referenceFields,
@@ -108,7 +124,7 @@ function commitLifecycleMutation(filePath, targetPath, config, updates, historyF
           sourcePath: docFile, repoRoot: config.repoRoot, identities, oldPath: filePath, newPath: targetPath, referenceFields,
         }),
       })), ...additionalUpdates],
-      creations: options.creations ?? [],
+      creations,
       guards: options.guards ?? [],
       gitMove: tracked,
       gitIndex,
@@ -506,7 +522,7 @@ export async function runStatus(argv, config, opts = {}) {
       process.stdout.write(`${prefix} Would append Version History: - **${today}** Status: ${oldStatus ?? 'unknown'} → ${newStatus} — ${note}\n`);
     }
     process.stdout.write(`${prefix} ${toRepoPath(finalPath, config.repoRoot)}: ${oldStatus ?? 'unknown'} → ${newStatus}\n`);
-    return;
+    return { dryRun: true, oldRepoPath: toRepoPath(filePath, config.repoRoot), newRepoPath: toRepoPath(finalPath, config.repoRoot), touched: [] };
   }
 
   const mutationResult = commitLifecycleMutation(filePath, targetPath, config, { status: newStatus, updated: today }, currentOld => {
@@ -516,6 +532,7 @@ export async function runStatus(argv, config, opts = {}) {
     createSection: Boolean(note),
     additionalUpdates: opts.additionalUpdates,
     creations: opts.creations,
+    guards: opts.guards,
     testHooks: opts.testHooks,
   });
 
@@ -845,7 +862,7 @@ export function runArchive(argv, config, opts = {}) {
     if (config.hooks?.onArchive) {
       out.write(`${prefix} Would fire hook: onArchive\n`);
     }
-    return;
+    return { dryRun: true, oldRepoPath, newRepoPath, touched: [] };
   }
 
   const mutationResult = commitLifecycleMutation(filePath, targetPath, config, { status: targetStatus, updated: today },
@@ -1008,6 +1025,7 @@ export async function runSet(argv, config, opts = {}) {
       dryRun, note, archiveStatus: newStatus, force, testHooks: opts.testHooks, deferIndex: opts.deferIndex,
       additionalUpdates: opts.additionalUpdates,
       creations: opts.creations,
+      guards: opts.guards,
     });
   }
 
@@ -1059,8 +1077,9 @@ export async function runSet(argv, config, opts = {}) {
     dryRun,
     suppressDeprecation: true,
     note,
-    additionalUpdates: releaseUpdate ? [releaseUpdate] : [],
+    additionalUpdates: [...(opts.additionalUpdates ?? []), ...(releaseUpdate ? [releaseUpdate] : [])],
     creations: opts.creations,
+    guards: opts.guards,
     testHooks: opts.testHooks,
     deferIndex: opts.deferIndex,
   });

package/src/migrate-prompts.mjs

@@ -64,7 +64,7 @@ export function migrateOnePrompt(raw, opts = {}) {
       'type: prompt',
       'status: pending',
       `created: ${created}`,
-      `dotmd_version: ${pkg.version}`,
+      `runlist_version: ${pkg.version}`,
       `context: "${context.replace(/"/g, '\\"')}"`,
       'related_plans: []',
     ].join('\n');
@@ -86,7 +86,7 @@ export function migrateOnePrompt(raw, opts = {}) {
   if (!parsed.type) needed.push(['type', 'prompt']);
   if (!parsed.status) needed.push(['status', 'pending']);
   if (!parsed.created) needed.push(['created', created]);
-  if (!parsed.dotmd_version) needed.push(['dotmd_version', pkg.version]);
+  if (!parsed.runlist_version && !parsed.dotmd_version) needed.push(['runlist_version', pkg.version]);
   if (!parsed.context) {
     // Prefer existing `title:` if present, else derive from body/filename.
     const ctx = typeof parsed.title === 'string' ? parsed.title : deriveContext(rawBody || raw, opts.filePath || 'unknown');

package/src/new.mjs

@@ -237,7 +237,7 @@ Status markers (put in heading text):
       `status: ${s}`,
       `created: ${d}`,
       `updated: ${d}`,
-      `dotmd_version: ${pkg.version}`,
+      `runlist_version: ${pkg.version}`,
       `context: ${ctx?.title ? `"${ctx.title.replace(/"/g, '\\"')}"` : ''}`,
       'related_plans:',
     ].join('\n'),

package/src/update.mjs

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { green, dim, yellow } from './color.mjs';
 import { executableName, which } from './util.mjs';
 import { CLAUDE_MARKETPLACE, claudeMarketplaceRefusalHint, installOpencodePlugin, opencodeStatus } from './host-integration.mjs';
+import { codexStatus } from './codex-integration.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
@@ -129,6 +130,11 @@ export function planUpdate(opts, ctx) {
     } else if (ctx.opencode?.foreign) {
       steps.push({ kind: 'skip', reason: `${ctx.opencode.path} was not written by runlist — leaving it alone` });
     }
+    if (ctx.codex?.foreign) {
+      steps.push({ kind: 'skip', reason: `${ctx.codex.plugin} was not written by runlist — leaving it alone` });
+    } else if (ctx.codex?.exists && (ctx.codex.stale || (!opts.pluginOnly && ctx.hasNpm))) {
+      steps.push({ kind: 'codex', cmd: ['runlist', 'install', 'codex'] });
+    }
   }
   return steps;
 }
@@ -158,11 +164,16 @@ export function runUpdate(argv, _config, opts = {}) {
     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`);
+    const cx = codexStatus({ version: pkg.version });
+    if (!cx.exists) process.stdout.write(dim('runlist codex: not installed\n'));
+    else if (cx.foreign) process.stdout.write(`runlist codex: ${yellow('unmanaged plugin directory')}\n`);
+    else process.stdout.write(`runlist codex: ${cx.version} ${cx.stale ? yellow('behind — run `runlist update`') : green('in sync')}\n`);
     return;
   }
 
   const opencode = opencodeStatus({ version: pkg.version });
-  const steps = planUpdate({ cliOnly, pluginOnly }, { plugin, opencode, hasClaude: which('claude'), hasNpm: which('npm') });
+  const codex = codexStatus({ version: pkg.version });
+  const steps = planUpdate({ cliOnly, pluginOnly }, { plugin, opencode, codex, hasClaude: which('claude'), hasNpm: which('npm') });
   if (opts.dryRun) {
     for (const step of steps) {
       if (step.kind === 'skip') process.stdout.write(dim(`[dry-run] skip: ${step.reason}\n`));