dotmd-cli 0.18.0 → 0.19.0

package/package.json

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

package/src/lifecycle.mjs

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { extractFrontmatter, parseSimpleFrontmatter, replaceFrontmatter } from './frontmatter.mjs';
-import { asString, toRepoPath, die, warn, resolveDocPath, escapeRegex } from './util.mjs';
+import { asString, toRepoPath, die, warn, resolveDocPath, escapeRegex, nowIso } from './util.mjs';
 import { gitMv, getGitLastModified, getGitLastModifiedBatch } from './git.mjs';
 import { buildIndex, collectDocFiles } from './index.mjs';
 import { renderIndexFile, writeIndex } from './index-file.mjs';
@@ -71,7 +71,7 @@ export async function runStatus(argv, config, opts = {}) {
     return;
   }
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
   const archiveDir = path.join(fileRoot, config.archiveDir);
   const relFromRoot = path.relative(fileRoot, filePath);
   const inArchive = relFromRoot.startsWith(config.archiveDir + '/') || relFromRoot.startsWith(config.archiveDir + path.sep);
@@ -185,7 +185,7 @@ export async function runPickup(argv, config, opts = {}) {
   const pickupable = new Set(['active', 'planned', 'in-session']);
   if (oldStatus && !pickupable.has(oldStatus) && !handoffQueued) die(`Cannot pick up a plan with status '${oldStatus}'. Must be active or planned.\n  ${repoPath}`);
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
   const leaseOldStatus = oldStatus === 'in-session' ? 'active' : (oldStatus ?? 'active');
   let leaseOutcome = 'acquired';
 
@@ -302,7 +302,7 @@ export async function runUnpickup(argv, config, opts = {}) {
       const parsedFm = parseSimpleFrontmatter(fmRaw);
       const cur = asString(parsedFm.status);
       if (cur === 'in-session') {
-        const today = new Date().toISOString().slice(0, 10);
+        const today = nowIso();
         updateFrontmatter(filePath, { status: newStatus, updated: today });
       }
       // If frontmatter is no longer in-session (manual flip), leave it alone.
@@ -412,7 +412,7 @@ export async function runFinish(argv, config, opts = {}) {
 
   if (oldStatus !== 'in-session') die(`Plan is not in-session (current: ${oldStatus}).\n  ${repoPath}`);
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
 
   if (dryRun) {
     process.stderr.write(`${dim('[dry-run]')} Would update: status: in-session → ${targetStatus}, updated: ${today}\n`);
@@ -451,7 +451,7 @@ export function runArchive(argv, config, opts = {}) {
   const parsed = parseSimpleFrontmatter(frontmatter);
   const oldStatus = asString(parsed.status) ?? 'unknown';
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
   const targetDir = path.join(archiveFileRoot, config.archiveDir);
   const targetPath = path.join(targetDir, path.basename(filePath));
   const oldRepoPath = toRepoPath(filePath, config.repoRoot);
@@ -608,7 +608,7 @@ export function runTouch(argv, config, opts = {}) {
   const filePath = resolveDocPath(input, config);
   if (!filePath) { die(`File not found: ${input}\nSearched: ${toRepoPath(config.repoRoot, config.repoRoot) || '.'}, ${toRepoPath(config.docsRoot, config.repoRoot)}`); }
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
 
   if (dryRun) {
     process.stdout.write(`${dim('[dry-run]')} Would touch: ${toRepoPath(filePath, config.repoRoot)} (updated → ${today})\n`);
@@ -790,7 +790,7 @@ export async function runHandoff(argv, config, opts = {}) {
     die(`Not held by this session: ${repoPath}\n  Run \`dotmd pickup ${repoPath}\` first.`);
   }
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
   const targetStatus = lease.oldStatus || 'active';
 
   if (dryRun) {

package/src/new.mjs

@@ -1,6 +1,6 @@
 import { existsSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
-import { toRepoPath, die, warn } from './util.mjs';
+import { toRepoPath, die, warn, nowIso } from './util.mjs';
 import { green, dim, bold } from './color.mjs';
 import { isInteractive, promptText } from './prompt.mjs';
 
@@ -11,9 +11,82 @@ const BUILTIN_TEMPLATES = {
     body: (t) => `\n# ${t}\n`,
   },
   plan: {
-    description: 'Execution plan with module, surface, and cross-references',
-    frontmatter: (s, d) => `type: plan\nstatus: ${s}\nupdated: ${d}\nsurface:\nmodule:\ncurrent_state:\nrelated_plans:`,
-    body: (t) => `\n# ${t}\n\n## Overview\n\n\n\n## Implementation Plan\n\n- [ ] \n\n## Open Questions\n\n\n`,
+    description: 'Execution plan — build-up shape (Problem → Phases → Closeout) with phase status markers and Version History',
+    frontmatter: (s, d) => [
+      'type: plan',
+      `status: ${s}`,
+      `created: ${d}`,
+      `updated: ${d}`,
+      'surfaces: []',
+      'modules: []',
+      'domain:',
+      'audience: internal',
+      'parent_plan:',
+      'related_plans: []',
+      'related_docs: []',
+      'current_state:',
+      'next_step:',
+    ].join('\n'),
+    body: (t, ctx) => `
+# ${t}
+
+> One-paragraph problem statement: what this plan is for, why now.
+
+## Problem
+
+
+
+## Goals
+
+
+
+## Non-Goals
+
+
+
+## What Exists Today
+
+
+
+## Constraints
+
+
+
+## Decisions
+
+
+
+## Open Questions
+
+
+
+## Phases
+
+<!--
+Status markers (put in heading text):
+  ⬜  not started
+  🟡  in progress (pickup targets this)
+  ✅  shipped (history; pickup skips)
+  ⏭  skipped (with reason in body)
+  🚧  blocked (link to blocker)
+-->
+
+### Phase 1 — <title> ⬜
+
+
+
+## Deferred
+
+
+
+## Version History
+
+- **${ctx?.today ?? ''}** Created.
+
+## Closeout
+
+<!-- Filled on archive: what shipped, key commits, deferrals dispositioned. -->
+`,
   },
   adr: {
     description: 'Architecture Decision Record',
@@ -115,7 +188,7 @@ export async function runNew(argv, config, opts = {}) {
     die(`File already exists: ${repoPath}`);
   }
 
-  const today = new Date().toISOString().slice(0, 10);
+  const today = nowIso();
 
   // Generate content
   let content;
@@ -123,7 +196,7 @@ export async function runNew(argv, config, opts = {}) {
     content = template(name, { status, title: docTitle, today });
   } else {
     const fm = template.frontmatter(status, today);
-    const body = template.body(docTitle);
+    const body = template.body(docTitle, { today, status });
     content = `---\n${fm}\n---\n${body}`;
   }
 

package/src/util.mjs

@@ -55,6 +55,10 @@ export function toRepoPath(absolutePath, repoRoot) {
   return path.relative(repoRoot, absolutePath).split(path.sep).join('/');
 }
 
+export function nowIso() {
+  return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+
 export function warn(message) {
   process.stderr.write(`${dim(message)}\n`);
 }