dotmd-cli 0.8.6 → 0.9.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Beyond
+Copyright (c) 2026 Robert Owens
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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,
@@ -77,6 +83,13 @@ export const presets = {
   actionable: ['--status', 'active,ready', '--has-next-step', '--sort', 'updated', '--all'],
 };
 
+// ─── Notion ──────────────────────────────────────────────────────────────────
+// IMPORTANT: Use environment variables for tokens — never hardcode secrets in config files.
+// export const notion = {
+//   token: process.env.NOTION_TOKEN,
+//   databaseId: process.env.NOTION_DATABASE_ID,
+// };
+
 // ─── Function Hooks ──────────────────────────────────────────────────────────
 // Hooks are optional. Each receives a default implementation it can wrap or replace.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.8.6",
+  "version": "0.9.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/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/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/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.' });