dotmd-cli 0.41.0 → 0.41.1

package/bin/dotmd.mjs

@@ -51,8 +51,7 @@ Lifecycle:
   pickup <file> [--takeover]        Pick up a plan (set in-session + print body)
   release [<file>] [--to <s>]       Release in-session lease (alias: unpickup)
   runlist <hub> [next]              Show or walk an ordered group of plans (see \`dotmd help runlist\`)
-  finish <file> [done|active]       Finish a plan (set done or active)
-  status <file> <status>            Transition document status
+  status <file> <status>            Transition document status (deprecated; prefer \`set\`)
   set <status> [<file>]             Unified transition: archive/release/transition in one verb
   archive <file>                    Archive (status + move + update refs)
   bulk archive <f1> <f2> ...        Archive multiple files at once
@@ -139,10 +138,10 @@ plan statuses (each maps to a distinct unstuck-action)
 
 Canonical transitions:
   active → in-session              \`dotmd pickup <file>\`
-  in-session → active              \`dotmd release <file>\`
-  in-session → partial             \`dotmd status <file> partial\` (+ release)
-  in-session → awaiting            \`dotmd status <file> awaiting\` (+ release)
-  any → archived                   \`dotmd archive <file>\`
+  in-session → active              \`dotmd set active\` (auto-releases lease)
+  in-session → partial             \`dotmd set partial\` (auto-releases lease)
+  in-session → awaiting            \`dotmd set awaiting\` (auto-releases lease)
+  any → archived                   \`dotmd set archived <file>\` (or \`dotmd archive\`)
 
 ────────────────────────────────────────────────────────────────────
 doc statuses
@@ -296,17 +295,6 @@ status. With no file, releases every lease owned by the current session.
 Identical behavior to \`dotmd unpickup\`; both names route to the same
 implementation. See \`dotmd unpickup --help\` for full option list.`,
 
-  finish: `dotmd finish <file> [done|active] — finish working on a plan
-
-Sets the plan status to done (default) or back to active.
-Only works on plans currently in-session.
-
-Options:
-  --json                 Output as JSON
-  --dry-run, -n          Preview without writing
-
-If no file is given, prompts with a list of in-session plans.`,
-
   set: `dotmd set <status> [<file>] — unified status-transition verb
 
 Routes to the right plumbing based on the target status:
@@ -1160,7 +1148,6 @@ async function main() {
   if (command === 'unpickup' || command === 'release') { const { runUnpickup } = await import('../src/lifecycle.mjs'); await runUnpickup(restArgs, config, { dryRun }); return; }
   if (command === 'runlist') { const { runRunlist } = await import('../src/runlist.mjs'); await runRunlist(restArgs, config, { dryRun }); return; }
   if (command === 'handoff') { die('`dotmd handoff` was removed in 0.31.0. Use `dotmd prompts new <name>` to create a saved prompt instead. The .dotmd/handoffs/ sidecar mechanism no longer exists; see CHANGELOG.'); }
-  if (command === 'finish') { const { runFinish } = await import('../src/lifecycle.mjs'); await runFinish(restArgs, config, { dryRun }); return; }
   if (command === 'status') { const { runStatus } = await import('../src/lifecycle.mjs'); await runStatus(restArgs, config, { dryRun }); return; }
   if (command === 'set') { const { runSet } = await import('../src/lifecycle.mjs'); await runSet(restArgs, config, { dryRun }); return; }
   if (command === 'archive') { const { runArchive } = await import('../src/lifecycle.mjs'); runArchive(restArgs, config, { dryRun }); return; }

package/dotmd.config.example.mjs

@@ -268,7 +268,6 @@ export const presets = {
 // export function onRename({ oldPath, newPath, referencesUpdated }) {}
 // export function onLint({ path, fixes }) {}
 // export function onPickup({ path, oldStatus, newStatus }) {}
-// export function onFinish({ path, oldStatus, newStatus }) {}
 
 // AI hooks — override summarization (replaces local MLX model).
 // export function summarizeDoc(body, meta) { return 'Custom summary'; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "description": "CLI for managing markdown documents with YAML frontmatter — index, query, validate, graph, export, Notion sync, AI summaries.",
   "type": "module",
   "license": "MIT",

package/src/commands.mjs

@@ -4,7 +4,7 @@
 // templates points at a real command.
 export const KNOWN_COMMANDS = [
   'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'briefing', 'context', 'hud',
-  'focus', 'query', 'plans', 'prompts', 'stale', 'actionable', 'index', 'pickup', 'release', 'finish', 'status', 'set', 'archive', 'bulk', 'bulk-tag', 'touch', 'doctor',
+  'focus', 'query', 'plans', 'prompts', 'stale', 'actionable', 'index', 'pickup', 'release', 'status', 'set', 'archive', 'bulk', 'bulk-tag', 'touch', 'doctor',
   'unblocks', 'health', 'glossary', 'modules', 'module',
   'fix-refs', 'lint', 'rename', 'migrate', 'notion', 'export', 'summary',
   'watch', 'diff', 'new', 'init', 'completions', 'statuses', 'journal',

package/src/completions.mjs

@@ -2,7 +2,7 @@ import { die } from './util.mjs';
 
 const COMMANDS = [
   'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'unblocks', 'health', 'glossary', 'briefing', 'context', 'focus', 'query',
-  'plans', 'stale', 'actionable', 'index', 'pickup', 'unpickup', 'finish', 'status', 'archive', 'bulk', 'touch', 'doctor', 'lint', 'rename', 'migrate',
+  'plans', 'stale', 'actionable', 'index', 'pickup', 'unpickup', 'status', 'set', 'archive', 'bulk', 'touch', 'doctor', 'lint', 'rename', 'migrate',
   'fix-refs', 'notion', 'export', 'summary', 'watch', 'diff', 'init', 'new', 'completions', 'journal',
 ];
 

package/src/lifecycle.mjs

@@ -112,6 +112,10 @@ export async function runStatus(argv, config, opts = {}) {
   const input = argv[0];
   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 lease is held). Removed in a future major.\n'));
+  }
+
   if (!input) { die('Usage: dotmd status <file> <new-status>'); }
 
   const filePath = resolveDocPath(input, config);
@@ -519,66 +523,6 @@ export async function runUnpickup(argv, config, opts = {}) {
   }
 }
 
-export async function runFinish(argv, config, opts = {}) {
-  const { dryRun } = opts;
-  const json = argv.includes('--json');
-  const positional = argv.filter(a => !a.startsWith('-'));
-  let input = positional[0];
-  const targetStatus = positional[1] ?? 'done';
-
-  if (!['done', 'active'].includes(targetStatus)) die(`Invalid finish status: ${targetStatus}. Use 'done' or 'active'.`);
-
-  // Interactive: pick from in-session plans
-  if (!input) {
-    if (!isInteractive()) die('Usage: dotmd finish <file> [done|active]');
-    const index = buildIndex(config);
-    const inSession = index.docs.filter(d => d.status === 'in-session');
-    if (inSession.length === 0) die('No plans currently in-session.');
-    if (inSession.length === 1) {
-      input = inSession[0].path;
-      process.stderr.write(`${dim(`Auto-selected: ${input}`)}\n`);
-    } else {
-      const choice = await promptChoice('Finish which plan:', inSession.map(d => `${d.title} — ${d.path}`));
-      if (!choice) die('No plan selected.');
-      const idx = inSession.findIndex((_, i) => choice === `${inSession[i].title} — ${inSession[i].path}`);
-      if (idx === -1) die('No plan selected.');
-      input = inSession[idx].path;
-    }
-  }
-
-  const filePath = resolveDocPath(input, config);
-  if (!filePath) die(`File not found: ${input}`);
-
-  const raw = readFileSync(filePath, 'utf8');
-  const { frontmatter: fmRaw } = extractFrontmatter(raw);
-  const parsedFm = parseSimpleFrontmatter(fmRaw);
-  const oldStatus = asString(parsedFm.status);
-  const repoPath = toRepoPath(filePath, config.repoRoot);
-
-  if (oldStatus !== 'in-session') die(`Plan is not in-session (current: ${oldStatus}).\n  ${repoPath}`);
-
-  const today = nowIso();
-
-  if (dryRun) {
-    process.stderr.write(`${dim('[dry-run]')} Would update: status: in-session → ${targetStatus}, updated: ${today}\n`);
-  } else {
-    updateFrontmatter(filePath, { status: targetStatus, updated: today });
-    regenIndex(config);
-  }
-
-  if (json) {
-    process.stdout.write(JSON.stringify({ path: repoPath, oldStatus, newStatus: targetStatus }, null, 2) + '\n');
-  } else {
-    process.stdout.write(`${green('✓ Finished')}: ${repoPath} (in-session → ${targetStatus})\n`);
-  }
-
-  if (!dryRun) {
-    try { releaseLease(config, repoPath, { force: true }); } catch (err) { warn(`Could not release lease for ${repoPath}: ${err.message}`); }
-  }
-
-  try { config.hooks.onFinish?.({ path: repoPath, oldStatus, newStatus: targetStatus }); } catch (err) { warn(`Hook 'onFinish' threw: ${err.message}`); }
-}
-
 export function runArchive(argv, config, opts = {}) {
   const { dryRun, out = process.stdout } = opts;
   const noIndex = argv.includes('--no-index') || opts.noIndex;
@@ -747,7 +691,7 @@ export async function runSet(argv, config, opts = {}) {
   const statusArgs = [filePath, newStatus];
   if (noIndex) statusArgs.push('--no-index');
   if (showFiles) statusArgs.push('--show-files');
-  await runStatus(statusArgs, config, { dryRun });
+  await runStatus(statusArgs, config, { dryRun, suppressDeprecation: true });
 
   if (oldStatus === 'in-session' && newStatus !== 'in-session' && !dryRun) {
     const repoPath = toRepoPath(filePath, config.repoRoot);