dotmd-cli 0.31.0 → 0.31.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.31.0",
+  "version": "0.31.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/export.mjs

@@ -151,8 +151,8 @@ function exportMarkdown(docs, config) {
       lines.push(`### ${doc.title}`);
       const meta = [`Status: ${doc.status}`];
       if (doc.updated) meta.push(`Updated: ${doc.updated}`);
-      if (doc.module) meta.push(`Module: ${doc.module}`);
-      if (doc.surface) meta.push(`Surface: ${doc.surface}`);
+      if (doc.modules?.length) meta.push(`Module: ${doc.modules.join(', ')}`);
+      if (doc.surfaces?.length) meta.push(`Surface: ${doc.surfaces.join(', ')}`);
       if (doc.owner) meta.push(`Owner: ${doc.owner}`);
       lines.push(`> ${meta.join(' | ')}`, '');
       if (doc.body.trim()) lines.push(doc.body.trim());
@@ -292,8 +292,8 @@ function buildDocPage(doc) {
   let meta = `<table class="meta">`;
   meta += `<tr><td>Status</td><td><span class="badge ${badgeClass}">${doc.status ?? 'unknown'}</span></td></tr>`;
   if (doc.updated) meta += `<tr><td>Updated</td><td>${escHtml(doc.updated)}</td></tr>`;
-  if (doc.module) meta += `<tr><td>Module</td><td>${escHtml(doc.module)}</td></tr>`;
-  if (doc.surface) meta += `<tr><td>Surface</td><td>${escHtml(doc.surface)}</td></tr>`;
+  if (doc.modules?.length) meta += `<tr><td>Module</td><td>${escHtml(doc.modules.join(', '))}</td></tr>`;
+  if (doc.surfaces?.length) meta += `<tr><td>Surface</td><td>${escHtml(doc.surfaces.join(', '))}</td></tr>`;
   if (doc.owner) meta += `<tr><td>Owner</td><td>${escHtml(doc.owner)}</td></tr>`;
   meta += `<tr><td>Path</td><td><code>${escHtml(doc.path)}</code></td></tr>`;
   meta += `</table>`;

package/src/git.mjs

@@ -1,4 +1,6 @@
 import { spawnSync } from 'node:child_process';
+import { renameSync } from 'node:fs';
+import path from 'node:path';
 
 let gitChecked = false;
 function ensureGit() {
@@ -49,6 +51,20 @@ export function getGitLastModifiedBatch(repoRoot) {
 
 export function gitMv(source, target, repoRoot) {
   ensureGit();
+  // Source is untracked (scaffolded this session, never committed; or repoRoot
+  // is not a git repo at all): a plain rename is the only correct move. `git mv`
+  // would error with `fatal: not under version control` and the user can't act
+  // on that — the file is genuinely a doc, just not yet staged.
+  if (!isTracked(source, repoRoot)) {
+    const absSource = path.isAbsolute(source) ? source : path.join(repoRoot, source);
+    const absTarget = path.isAbsolute(target) ? target : path.join(repoRoot, target);
+    try {
+      renameSync(absSource, absTarget);
+      return { status: 0, stderr: '' };
+    } catch (err) {
+      return { status: 1, stderr: err.message };
+    }
+  }
   const result = spawnSync('git', ['mv', source, target], {
     cwd: repoRoot,
     encoding: 'utf8',
@@ -56,6 +72,15 @@ export function gitMv(source, target, repoRoot) {
   return { status: result.status, stderr: result.stderr };
 }
 
+function isTracked(source, repoRoot) {
+  const relSource = path.isAbsolute(source) ? path.relative(repoRoot, source) : source;
+  const result = spawnSync('git', ['ls-files', '--error-unmatch', '--', relSource], {
+    cwd: repoRoot,
+    encoding: 'utf8',
+  });
+  return result.status === 0;
+}
+
 export function gitDiffSince(relPath, sinceDate, repoRoot, opts = {}) {
   ensureGit();
   // Find the last commit at or before sinceDate

package/src/graph.mjs

@@ -43,7 +43,9 @@ export function buildGraph(index, config, filters = {}) {
     title: d.title,
     status: d.status,
     module: d.module,
+    modules: d.modules,
     surface: d.surface,
+    surfaces: d.surfaces,
     edgeCount: 0,
   }));
   const nodeMap = new Map(nodes.map(n => [n.id, n]));

package/src/render.mjs

@@ -379,10 +379,10 @@ export function renderCoverage(index, config) {
 export function buildCoverage(index, config) {
   const scope = [...new Set(index.docs.map(d => d.status).filter(s => s && !config.lifecycle.terminalStatuses.has(s)))];
   const scoped = index.docs.filter(doc => doc.status && !config.lifecycle.terminalStatuses.has(doc.status));
-  const missingSurface = scoped.filter(doc => !doc.surface);
-  const missingModule = scoped.filter(doc => !doc.module);
-  const modulePlatform = scoped.filter(doc => doc.module === 'platform');
-  const moduleNone = scoped.filter(doc => doc.module === 'none');
+  const missingSurface = scoped.filter(doc => !doc.surfaces?.length);
+  const missingModule = scoped.filter(doc => !doc.modules?.length);
+  const modulePlatform = scoped.filter(doc => doc.modules?.includes('platform'));
+  const moduleNone = scoped.filter(doc => doc.modules?.includes('none'));
   const auditLevelNone = scoped.filter(doc => doc.auditLevel === 'none');
   const audited = scoped.filter(doc => ['pass1', 'pass2', 'deep'].includes(doc.auditLevel));
 

package/src/stats.mjs

@@ -64,8 +64,8 @@ export function buildStats(index, config) {
     completeness: {
       scoped: scoped.length,
       hasOwner: scoped.filter(d => d.owner).length,
-      hasSurface: scoped.filter(d => d.surface).length,
-      hasModule: scoped.filter(d => d.module).length,
+      hasSurface: scoped.filter(d => d.surfaces?.length).length,
+      hasModule: scoped.filter(d => d.modules?.length).length,
       hasNextStep: scoped.filter(d => d.hasNextStep).length,
     },
     checklists: {

package/src/validate.mjs

@@ -102,8 +102,8 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
     doc.errors.push({ path: doc.path, level: 'error', message: '`modules` must be a YAML list when present.' });
   }
 
-  if (config.moduleRequiredStatuses.has(doc.status) && !doc.module) {
-    doc.errors.push({ path: doc.path, level: 'error', message: '`module` is required for active/ready/planned/blocked docs; use a real module, `platform`, or `none`.' });
+  if (config.moduleRequiredStatuses.has(doc.status) && !doc.modules?.length) {
+    doc.errors.push({ path: doc.path, level: 'error', message: '`module` is required for active/ready/planned/blocked docs; use a real module, `platform`, or `none`. Accepts singular `module:` or plural `modules:` list.' });
   }
 
   if (config.validSurfaces) {