dotmd-cli 0.10.4 → 0.10.6

package/README.md

@@ -116,6 +116,9 @@ dotmd deps [file]            Dependency tree or overview
 dotmd context [--summarize]  Compact briefing (LLM-oriented)
 dotmd focus [status]         Detailed view for one status group
 dotmd query [filters]        Filtered search
+dotmd plans                  List all plans
+dotmd stale                  List stale docs
+dotmd actionable             List docs with next steps
 dotmd index [--write]        Generate/update docs.md index block
 dotmd status <file> <status> Transition document status
 dotmd archive <file>         Archive (status + move + update refs)
@@ -339,14 +342,16 @@ dotmd migrate module auth identity          # rename a module
 
 ### Preset Aliases
 
+Built-in presets: `plans`, `stale`, `actionable`. Add your own in config:
+
 ```js
 export const presets = {
-  stale: ['--status', 'active,ready', '--stale', '--sort', 'updated', '--all'],
   mine: ['--owner', 'robert', '--status', 'active', '--all'],
+  blocked: ['--status', 'blocked', '--all'],
 };
 ```
 
-Then run `dotmd stale` or `dotmd mine` as shorthand.
+Then run `dotmd mine` or `dotmd blocked` as shorthand. All presets support query flags (`--json`, `--sort`, etc.).
 
 ### Watch Mode
 

package/bin/dotmd.mjs

@@ -45,6 +45,9 @@ View & Query:
   graph [--dot] [--json]            Visualize document relationships
   deps [file] [--json]              Dependency tree or overview
   diff [file] [--summarize]         Show changes since last updated date
+  plans                             List all plans (shortcut for query --type plan)
+  stale                             List stale docs across all statuses
+  actionable                        List docs with a next step ready to act on
   summary <file> [--json]           AI summary of a document
 
 Validate & Fix:
@@ -341,6 +344,26 @@ directory. Skips any files that already exist.
 
 If docs/ already contains .md files, auto-detects statuses, surfaces,
 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.)
+
+Examples:
+  dotmd plans                       # all plans
+  dotmd plans --status active       # active plans only
+  dotmd plans --json                # JSON output`,
+
+  stale: `dotmd stale — list stale documents
+
+Shows docs that haven't been updated within their staleness threshold.
+Supports all query flags (--status, --json, --sort, etc.)`,
+
+  actionable: `dotmd actionable — list docs with next steps
+
+Shows active/ready docs that have a next_step defined.
+Supports all query flags (--status, --json, --sort, etc.)`,
 };
 
 async function main() {
@@ -665,7 +688,7 @@ async function main() {
   // Unknown command — suggest closest match
   const allCommands = [
     'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'context',
-    'focus', 'query', 'index', 'status', 'archive', 'touch', 'doctor',
+    'focus', 'query', 'plans', 'stale', 'actionable', 'index', 'status', 'archive', 'touch', 'doctor',
     'fix-refs', 'lint', 'rename', 'migrate', 'notion', 'export', 'summary',
     'watch', 'diff', 'new', 'init', 'completions',
   ];

package/dotmd.config.example.mjs

@@ -99,9 +99,12 @@ export const referenceFields = {
 };
 
 // Query presets — expand to filter args when used as commands
+// Built-in: plans, stale, actionable. Add your own here:
 export const presets = {
-  stale: ['--status', 'active,ready,planned,blocked,research', '--stale', '--sort', 'updated', '--all'],
-  actionable: ['--status', 'active,ready', '--has-next-step', '--sort', 'updated', '--all'],
+  // plans: ['--type', 'plan', '--sort', 'status', '--all'],           // built-in
+  // stale: ['--status', '...', '--stale', '--sort', 'updated', '--all'], // built-in
+  // actionable: ['--status', 'active,ready', '--has-next-step', ...],   // built-in
+  mine: ['--owner', 'robert', '--status', 'active', '--all'],
 };
 
 // ─── Notion ──────────────────────────────────────────────────────────────────

package/package.json

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

package/src/completions.mjs

@@ -2,7 +2,7 @@ import { die } from './util.mjs';
 
 const COMMANDS = [
   'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'context', 'focus', 'query',
-  'index', 'status', 'archive', 'touch', 'doctor', 'lint', 'rename', 'migrate',
+  'plans', 'stale', 'actionable', 'index', 'status', 'archive', 'touch', 'doctor', 'lint', 'rename', 'migrate',
   'fix-refs', 'notion', 'export', 'summary', 'watch', 'diff', 'init', 'new', 'completions',
 ];
 
@@ -25,6 +25,9 @@ const COMMAND_FLAGS = {
   notion: ['import', 'export', 'sync', '--force', '--dry-run'],
   export: ['--format', '--output', '--status', '--module', '--root', '--type'],
   focus: ['--json'],
+  plans: ['--status', '--json', '--sort', '--limit', '--all', '--stale', '--has-next-step'],
+  stale: ['--json', '--sort', '--limit', '--all'],
+  actionable: ['--json', '--sort', '--limit', '--all'],
   status: [],
   archive: [],
   doctor: [],

package/src/config.mjs

@@ -79,6 +79,7 @@ const DEFAULTS = {
   notion: null,
 
   presets: {
+    plans: ['--type', 'plan', '--sort', 'status', '--all'],
     stale: ['--status', 'active,ready,planned,blocked,research', '--stale', '--sort', 'updated', '--all'],
     actionable: ['--status', 'active,ready', '--has-next-step', '--sort', 'updated', '--all'],
   },

package/src/validate.mjs

@@ -79,14 +79,15 @@ export function validateDoc(doc, frontmatter, headingTitle, config) {
     doc.warnings.push({ path: doc.path, level: 'warning', message: 'Missing `summary` and no blockquote fallback found.' });
   }
 
-  // Determine which statuses should have current_state and next_step
-  const isWorkStatus = knownStatus && doc.status && !config.lifecycle.terminalStatuses.has(doc.status) && !config.lifecycle.skipWarningsFor.has(doc.status);
+  // Determine which statuses should have current_state and next_step (plans only, not docs/research)
+  const isPlanWork = knownStatus && doc.status && (!doc.type || doc.type === 'plan')
+    && !config.lifecycle.terminalStatuses.has(doc.status) && !config.lifecycle.skipWarningsFor.has(doc.status);
 
-  if (isWorkStatus && !asString(frontmatter.current_state)) {
+  if (isPlanWork && !asString(frontmatter.current_state)) {
     doc.warnings.push({ path: doc.path, level: 'warning', message: 'Missing `current_state`; index output is using a fallback or placeholder.' });
   }
 
-  if (isWorkStatus && doc.status !== 'blocked' && !asString(frontmatter.next_step)) {
+  if (isPlanWork && doc.status !== 'blocked' && !asString(frontmatter.next_step)) {
     doc.warnings.push({ path: doc.path, level: 'warning', message: 'Missing `next_step`; command output will omit a clear immediate action.' });
   }