dotmd-cli 0.14.9 → 0.14.11

package/bin/dotmd.mjs

@@ -103,6 +103,7 @@ Filters:
   --has-blockers         Only docs with blockers
   --checklist-open       Only docs with open checklist items
   --sort <field>         Sort by: updated (default), title, status
+  --group <field>        Group by: module, surface, owner (plans view)
   --limit <n>            Max results (default: 20)
   --all                  Show all results (no limit)
   --git                  Use git dates instead of frontmatter
@@ -365,11 +366,13 @@ modules, and reference fields to pre-populate the config.`,
   plans: `dotmd plans — list all plans
 
 Shows all documents with type: plan, sorted by status.
-Supports all query flags (--status, --json, --sort, etc.)
+Supports all query flags (--status, --module, --json, --sort, --group, etc.)
 
 Examples:
   dotmd plans                       # all plans
   dotmd plans --status active       # active plans only
+  dotmd plans --module auth         # plans for the auth module
+  dotmd plans --group module        # all plans grouped by module
   dotmd plans --json                # JSON output`,
 
   stale: `dotmd stale — list stale documents

package/package.json

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

package/src/index.mjs

@@ -146,7 +146,7 @@ export function parseDocFile(filePath, config) {
 
   // Tag doc with its root
   const roots = config.docsRoots || [config.docsRoot];
-  const docRoot = roots.find(r => filePath.startsWith(r)) ?? config.docsRoot;
+  const docRoot = roots.find(r => filePath.startsWith(r + '/')) ?? config.docsRoot;
   const rootLabel = path.relative(config.repoRoot, docRoot).split(path.sep).join('/');
 
   const docType = asString(parsedFrontmatter.type) ?? null;

package/src/lifecycle.mjs

@@ -10,7 +10,7 @@ import { isInteractive, promptChoice } from './prompt.mjs';
 
 function findFileRoot(filePath, config) {
   const roots = config.docsRoots || [config.docsRoot];
-  return roots.find(r => filePath.startsWith(r)) ?? config.docsRoot;
+  return roots.find(r => filePath.startsWith(r + '/')) ?? config.docsRoot;
 }
 
 export async function runStatus(argv, config, opts = {}) {
@@ -63,8 +63,10 @@ export async function runStatus(argv, config, opts = {}) {
 
   const today = new Date().toISOString().slice(0, 10);
   const archiveDir = path.join(fileRoot, config.archiveDir);
-  const isArchiving = config.lifecycle.archiveStatuses.has(newStatus) && !filePath.includes(`/${config.archiveDir}/`);
-  const isUnarchiving = !config.lifecycle.archiveStatuses.has(newStatus) && filePath.includes(`/${config.archiveDir}/`);
+  const relFromRoot = path.relative(fileRoot, filePath);
+  const inArchive = relFromRoot.startsWith(config.archiveDir + '/') || relFromRoot.startsWith(config.archiveDir + path.sep);
+  const isArchiving = config.lifecycle.archiveStatuses.has(newStatus) && !inArchive;
+  const isUnarchiving = !config.lifecycle.archiveStatuses.has(newStatus) && inArchive;
   let finalPath = filePath;
 
   if (dryRun) {
@@ -239,7 +241,10 @@ export function runArchive(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)}`); }
-  if (filePath.includes(`/${config.archiveDir}/`)) { die(`Already archived: ${toRepoPath(filePath, config.repoRoot)}`); }
+
+  const archiveFileRoot = findFileRoot(filePath, config);
+  const relFromRoot = path.relative(archiveFileRoot, filePath);
+  if (relFromRoot.startsWith(config.archiveDir + '/') || relFromRoot.startsWith(config.archiveDir + path.sep)) { die(`Already archived: ${toRepoPath(filePath, config.repoRoot)}`); }
 
   const raw = readFileSync(filePath, 'utf8');
   const { frontmatter } = extractFrontmatter(raw);
@@ -247,7 +252,6 @@ export function runArchive(argv, config, opts = {}) {
   const oldStatus = asString(parsed.status) ?? 'unknown';
 
   const today = new Date().toISOString().slice(0, 10);
-  const archiveFileRoot = findFileRoot(filePath, config);
   const targetDir = path.join(archiveFileRoot, config.archiveDir);
   const targetPath = path.join(targetDir, path.basename(filePath));
   const oldRepoPath = toRepoPath(filePath, config.repoRoot);
@@ -314,7 +318,11 @@ export function runBulkArchive(argv, config, opts = {}) {
     }
   }
 
-  const unique = [...new Set(matched)].filter(f => !f.includes(`/${config.archiveDir}/`));
+  const unique = [...new Set(matched)].filter(f => {
+    const root = findFileRoot(f, config);
+    const rel = path.relative(root, f);
+    return !rel.startsWith(config.archiveDir + '/') && !rel.startsWith(config.archiveDir + path.sep);
+  });
   if (unique.length === 0) die('No matching files found (already-archived files are excluded).');
 
   process.stdout.write(`${unique.length} file(s) to archive:\n`);

package/src/query.mjs

@@ -77,6 +77,7 @@ export function parseQueryArgs(argv) {
     types: null, statuses: null, keyword: null, owner: null, surface: null,
     module: null, domain: null, audience: null, executionMode: null,
     updatedSince: null, limit: 20, all: false, sort: 'updated',
+    group: null,
     stale: false, hasNextStep: false, hasBlockers: false,
     checklistOpen: false, json: false, git: false,
     summarize: false, summarizeLimit: 5, model: undefined,
@@ -98,6 +99,7 @@ export function parseQueryArgs(argv) {
     if (arg === '--updated-since' && next) { filters.updatedSince = next; i += 1; continue; }
     if (arg === '--limit' && next) { filters.limit = Number.parseInt(next, 10) || 20; i += 1; continue; }
     if (arg === '--sort' && next) { filters.sort = next; i += 1; continue; }
+    if (arg === '--group' && next) { filters.group = next; i += 1; continue; }
     if (arg === '--all') { filters.all = true; continue; }
     if (arg === '--stale') { filters.stale = true; continue; }
     if (arg === '--has-next-step') { filters.hasNextStep = true; continue; }
@@ -248,50 +250,85 @@ function renderPlansOutput(docs, filters, config) {
   // Active filter note (only if user applied extra filters beyond the preset defaults)
   const activeFilters = [];
   if (filters.statuses?.length) activeFilters.push(`status: ${filters.statuses.join(', ')}`);
+  if (filters.module) activeFilters.push(`module: ${filters.module}`);
+  if (filters.surface) activeFilters.push(`surface: ${filters.surface}`);
+  if (filters.owner) activeFilters.push(`owner: ${filters.owner}`);
   if (filters.keyword) activeFilters.push(`keyword: ${filters.keyword}`);
   if (filters.stale) activeFilters.push('stale only');
   if (filters.hasNextStep) activeFilters.push('has next step');
   if (filters.hasBlockers) activeFilters.push('has blockers');
   if (activeFilters.length) process.stdout.write(dim(`  filtered: ${activeFilters.join(' | ')}`) + '\n');
 
-  // Group by status, ordered by config.statusOrder
-  const statusGroups = new Map();
-  for (const d of docs) {
-    const s = d.status ?? 'unknown';
-    if (!statusGroups.has(s)) statusGroups.set(s, []);
-    statusGroups.get(s).push(d);
-  }
-
-  const orderedStatuses = [...config.statusOrder.filter(s => statusGroups.has(s)), ...([...statusGroups.keys()].filter(s => !config.statusOrder.includes(s)))];
   const maxWidth = process.stdout.columns || 100;
 
-  for (const status of orderedStatuses) {
-    const group = statusGroups.get(status);
-    process.stdout.write(`\n${bold(`${capitalize(status)} (${group.length})`)}\n`);
-
-    const maxSlug = Math.min(30, Math.max(...group.map(d => toSlug(d).length)));
+  // Group by module or status
+  if (filters.group === 'module') {
+    renderPlansByGroup(docs, d => d.modules?.length ? d.modules : ['(none)'], filters, maxWidth);
+  } else if (filters.group === 'surface') {
+    renderPlansByGroup(docs, d => d.surfaces?.length ? d.surfaces : ['(none)'], filters, maxWidth);
+  } else if (filters.group === 'owner') {
+    renderPlansByGroup(docs, d => [d.owner ?? '(none)'], filters, maxWidth);
+  } else {
+    // Default: group by status, ordered by config.statusOrder
+    const statusGroups = new Map();
+    for (const d of docs) {
+      const s = d.status ?? 'unknown';
+      if (!statusGroups.has(s)) statusGroups.set(s, []);
+      statusGroups.get(s).push(d);
+    }
 
-    for (const doc of group) {
-      const slug = toSlug(doc).padEnd(maxSlug);
-      const age = doc.daysSinceUpdate != null ? `${doc.daysSinceUpdate}d` : ' —';
-      const ageStr = doc.daysSinceUpdate != null && doc.isStale ? red(age.padStart(4)) : dim(age.padStart(4));
-      const progress = renderProgressBar(doc.checklist);
+    const orderedStatuses = [...config.statusOrder.filter(s => statusGroups.has(s)), ...([...statusGroups.keys()].filter(s => !config.statusOrder.includes(s)))];
 
-      const parts = [`  ${slug}  ${ageStr}`];
-      if (progress) parts.push(progress);
+    for (const status of orderedStatuses) {
+      const group = statusGroups.get(status);
+      process.stdout.write(`\n${bold(`${capitalize(status)} (${group.length})`)}\n`);
+      renderPlanRows(group, filters, maxWidth);
+    }
+  }
 
-      if (doc.blockers?.length && (status === 'blocked')) {
-        parts.push(yellow(`blockers: ${doc.blockers.join('; ')}`));
-      } else if (doc.nextStep) {
-        parts.push(`next: ${doc.nextStep}`);
-      } else {
-        parts.push(dim('(no next step)'));
-      }
+  process.stdout.write('\n');
+}
 
-      const line = parts.join('  ');
-      process.stdout.write((line.length > maxWidth ? line.slice(0, maxWidth - 3) + '...' : line) + '\n');
+function renderPlansByGroup(docs, keyFn, filters, maxWidth) {
+  const groups = new Map();
+  for (const d of docs) {
+    for (const key of keyFn(d)) {
+      if (!groups.has(key)) groups.set(key, []);
+      groups.get(key).push(d);
     }
   }
 
-  process.stdout.write('\n');
+  const ordered = [...groups.keys()].sort((a, b) => a === '(none)' ? 1 : b === '(none)' ? -1 : a.localeCompare(b));
+  for (const key of ordered) {
+    const group = groups.get(key);
+    process.stdout.write(`\n${bold(`${key} (${group.length})`)}\n`);
+    renderPlanRows(group, filters, maxWidth);
+  }
+}
+
+function renderPlanRows(group, filters, maxWidth) {
+  const maxSlug = Math.min(30, Math.max(...group.map(d => toSlug(d).length)));
+  const showModule = !filters.module && filters.group !== 'module';
+
+  for (const doc of group) {
+    const slug = toSlug(doc).padEnd(maxSlug);
+    const age = doc.daysSinceUpdate != null ? `${doc.daysSinceUpdate}d` : ' —';
+    const ageStr = doc.daysSinceUpdate != null && doc.isStale ? red(age.padStart(4)) : dim(age.padStart(4));
+    const progress = renderProgressBar(doc.checklist);
+
+    const parts = [`  ${slug}  ${ageStr}`];
+    if (progress) parts.push(progress);
+    if (showModule && doc.modules?.length) parts.push(dim(`[${doc.modules.join(',')}]`));
+
+    if (doc.blockers?.length && (doc.status === 'blocked')) {
+      parts.push(yellow(`blockers: ${doc.blockers.join('; ')}`));
+    } else if (doc.nextStep) {
+      parts.push(`next: ${doc.nextStep}`);
+    } else {
+      parts.push(dim('(no next step)'));
+    }
+
+    const line = parts.join('  ');
+    process.stdout.write((line.length > maxWidth ? line.slice(0, maxWidth - 3) + '...' : line) + '\n');
+  }
 }