dotmd-cli 0.8.5 → 0.8.7

package/bin/dotmd.mjs

@@ -431,8 +431,10 @@ async function main() {
     index.docs = index.docs.filter(d => d.root === rootFilter || d.root.endsWith('/' + rootFilter) || d.root.split('/').pop() === rootFilter);
     index.errors = index.errors.filter(e => index.docs.some(d => d.path === e.path));
     index.warnings = index.warnings.filter(w => index.docs.some(d => d.path === w.path));
-    for (const status of config.statusOrder) {
-      index.countsByStatus[status] = index.docs.filter(d => d.status === status).length;
+    index.countsByStatus = {};
+    for (const doc of index.docs) {
+      const s = doc.status ?? 'unknown';
+      index.countsByStatus[s] = (index.countsByStatus[s] ?? 0) + 1;
     }
   }
 
@@ -551,9 +553,10 @@ async function main() {
   if (command === 'context') {
     if (args.includes('--json')) {
       const byStatus = {};
-      for (const s of config.statusOrder) {
-        const docs = index.docs.filter(d => d.status === s);
-        if (docs.length) byStatus[s] = docs;
+      for (const doc of index.docs) {
+        const s = doc.status ?? 'unknown';
+        if (!byStatus[s]) byStatus[s] = [];
+        byStatus[s].push(doc);
       }
       const stale = index.docs.filter(d => d.isStale && !config.lifecycle.skipStaleFor.has(d.status));
       process.stdout.write(JSON.stringify({

package/dotmd.config.example.mjs

@@ -16,6 +16,12 @@ export const excludeDirs = ['evidence'];
 // Status workflow — order determines display grouping
 export const statuses = {
   order: ['active', 'ready', 'planned', 'research', 'blocked', 'reference', 'archived'],
+  // Additional statuses valid only in specific roots (merged with order)
+  // Useful when different doc areas track different things (e.g. plans vs module docs)
+  // rootStatuses: {
+  //   'docs/modules': ['implemented', 'partial', 'draft', 'deprecated'],
+  //   'docs/core':    ['implemented', 'partial'],
+  // },
   // Days after which a doc is considered stale (null = never stale)
   staleDays: {
     active: 14,

package/package.json

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

package/src/config.mjs

@@ -216,6 +216,16 @@ export async function resolveConfig(cwd, explicitConfigPath) {
     staleDaysByStatus[status] = config.statuses.staleDays?.[status] ?? null;
   }
 
+  // Per-root additional statuses (merged with global validStatuses)
+  const rootStatusesRaw = config.statuses.rootStatuses ?? {};
+  const rootLabels = new Set(rootPaths.map(r => path.relative(configDir, path.resolve(configDir, r)).split(path.sep).join('/')));
+  const rootValidStatuses = new Map();
+  for (const [rootKey, extraStatuses] of Object.entries(rootStatusesRaw)) {
+    const merged = new Set(validStatuses);
+    for (const s of extraStatuses) merged.add(s);
+    rootValidStatuses.set(rootKey, merged);
+  }
+
   const validSurfaces = config.taxonomy.surfaces
     ? new Set(config.taxonomy.surfaces)
     : null;
@@ -235,6 +245,13 @@ export async function resolveConfig(cwd, explicitConfigPath) {
   const skipStaleFor = new Set(lifecycle.skipStaleFor);
   const skipWarningsFor = new Set(lifecycle.skipWarningsFor);
 
+  // Warn if rootStatuses keys don't match any configured root
+  for (const rootKey of Object.keys(rootStatusesRaw)) {
+    if (!rootLabels.has(rootKey)) {
+      earlyWarnings.push(`Config: statuses.rootStatuses key '${rootKey}' does not match any configured root.`);
+    }
+  }
+
   const configWarnings = [...earlyWarnings, ...validateConfig(userConfig, config, validStatuses, indexPath)];
 
   return {
@@ -252,6 +269,7 @@ export async function resolveConfig(cwd, explicitConfigPath) {
 
     statusOrder,
     validStatuses,
+    rootValidStatuses,
     staleDaysByStatus,
 
     lifecycle: { archiveStatuses, skipStaleFor, skipWarningsFor },

package/src/index.mjs

@@ -51,6 +51,12 @@ export function buildIndex(config) {
     status,
     transformedDocs.filter(doc => doc.status === status).length,
   ]));
+  const knownStatuses = new Set(config.statusOrder);
+  for (const doc of transformedDocs) {
+    if (doc.status && !knownStatuses.has(doc.status)) {
+      countsByStatus[doc.status] = (countsByStatus[doc.status] ?? 0) + 1;
+    }
+  }
 
   if (config.indexPath) {
     const indexCheck = checkIndex(transformedDocs, config);

package/src/lifecycle.mjs

@@ -27,11 +27,16 @@ export async function runStatus(argv, config, opts = {}) {
       die('Usage: dotmd status <file> <new-status>');
     }
   }
-  if (!config.validStatuses.has(newStatus)) { die(`Invalid status: ${newStatus}\nValid: ${[...config.validStatuses].join(', ')}`); }
-
   const filePath = resolveDocPath(input, config);
   if (!filePath) { die(`File not found: ${input}\nSearched: ${toRepoPath(config.repoRoot, config.repoRoot) || '.'}, ${toRepoPath(config.docsRoot, config.repoRoot)}`); }
 
+  // Validate status against root-specific vocabulary
+  const fileRoot = findFileRoot(filePath, config);
+  const rootLabel = path.relative(config.repoRoot, fileRoot).split(path.sep).join('/');
+  const rootSet = config.rootValidStatuses?.get(rootLabel);
+  const effectiveValid = rootSet ?? config.validStatuses;
+  if (!effectiveValid.has(newStatus)) { die(`Invalid status: ${newStatus}\nValid: ${[...effectiveValid].join(', ')}`); }
+
   const raw = readFileSync(filePath, 'utf8');
   const { frontmatter } = extractFrontmatter(raw);
   const parsed = parseSimpleFrontmatter(frontmatter);
@@ -43,7 +48,6 @@ export async function runStatus(argv, config, opts = {}) {
   }
 
   const today = new Date().toISOString().slice(0, 10);
-  const fileRoot = findFileRoot(filePath, config);
   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}/`);

package/src/render.mjs

@@ -124,8 +124,10 @@ function _renderContext(index, config, opts = {}) {
   const ctx = config.context;
 
   const byStatus = {};
-  for (const status of config.statusOrder) {
-    byStatus[status] = index.docs.filter(d => d.status === status);
+  for (const doc of index.docs) {
+    const s = doc.status ?? 'unknown';
+    if (!byStatus[s]) byStatus[s] = [];
+    byStatus[s].push(doc);
   }
 
   for (const status of (ctx.expanded || [])) {

package/src/stats.mjs

@@ -94,7 +94,11 @@ function _renderStats(stats, config) {
 
   // Status
   lines.push(bold('Status'));
-  const statusParts = config.statusOrder
+  const allStatuses = [
+    ...config.statusOrder.filter(s => stats.countsByStatus[s]),
+    ...Object.keys(stats.countsByStatus).filter(s => !config.statusOrder.includes(s)).sort(),
+  ];
+  const statusParts = allStatuses
     .filter(s => stats.countsByStatus[s])
     .map(s => `${s}: ${stats.countsByStatus[s]}`);
   lines.push('  ' + statusParts.join('  '));

package/src/validate.mjs

@@ -6,15 +6,20 @@ import { toRepoPath } from './util.mjs';
 
 const NOW = new Date();
 
+function isValidStatus(status, root, config) {
+  const rootSet = config.rootValidStatuses?.get(root);
+  if (rootSet) return rootSet.has(status);
+  return config.validStatuses.has(status);
+}
+
 export function validateDoc(doc, frontmatter, headingTitle, config) {
   if (!doc.status) {
     doc.errors.push({ path: doc.path, level: 'error', message: 'Missing frontmatter `status`.' });
-  } else if (!config.validStatuses.has(doc.status)) {
+  } else if (!isValidStatus(doc.status, doc.root, config)) {
     doc.warnings.push({ path: doc.path, level: 'warning', message: `Unknown status \`${doc.status}\`; not in statuses.order.` });
   }
 
-  // Only enforce lifecycle fields for known statuses (skip for unknown like implemented, partial, etc.)
-  const knownStatus = config.validStatuses.has(doc.status);
+  const knownStatus = isValidStatus(doc.status, doc.root, config);
 
   if (knownStatus && !config.lifecycle.skipWarningsFor.has(doc.status) && !doc.updated) {
     doc.errors.push({ path: doc.path, level: 'error', message: 'Missing frontmatter `updated` for non-archived doc.' });