dotmd-cli 0.13.1 → 0.14.0

package/README.md

@@ -41,6 +41,9 @@ eval "$(dotmd completions zsh)"     # add to ~/.zshrc
 - **Stats** — health dashboard with staleness, completeness, audit coverage
 - **Graph** — visualize document relationships as text, Graphviz DOT, or JSON
 - **Deps** — dependency tree or overview of what blocks what
+- **Unblocks** — impact analysis: what depends on a doc
+- **Health** — plan velocity, aging, pipeline status
+- **Glossary** — domain term lookup with related docs
 - **Lifecycle** — transition statuses, auto-archive with `git mv` and reference updates
 - **Doctor** — auto-fix broken refs, lint issues, date drift, and stale indexes in one pass
 - **Scaffold** — create new docs from templates (plan, ADR, RFC, audit, design)
@@ -113,6 +116,8 @@ dotmd coverage [--json]      Metadata coverage report
 dotmd stats [--json]         Doc health dashboard
 dotmd graph [--dot|--json]   Visualize document relationships
 dotmd deps [file]            Dependency tree or overview
+dotmd unblocks <file>        Show what depends on this doc
+dotmd health [--json]        Plan velocity, aging, and pipeline
 dotmd briefing               Compact summary for session start
 dotmd context [--summarize]  Full briefing (LLM-oriented)
 dotmd focus [status]         Detailed view for one status group
@@ -125,6 +130,7 @@ dotmd pickup <file>          Pick up a plan (in-session + print)
 dotmd finish <file>          Finish a plan (done or active)
 dotmd status <file> <status> Transition document status
 dotmd archive <file>         Archive (status + move + update refs)
+dotmd bulk archive <files>   Archive multiple files at once
 dotmd touch <file>           Bump updated date
 dotmd touch --git            Bulk-sync dates from git history
 dotmd doctor                 Auto-fix everything in one pass
@@ -135,6 +141,7 @@ dotmd migrate <f> <old> <new>  Batch update a frontmatter field
 dotmd notion <sub> [db-id]   Notion import/export/sync
 dotmd export [file]          Export docs as md, html, or json
 dotmd summary <file>         AI summary of a document
+dotmd glossary <term>        Look up domain terms + related docs
 dotmd watch [command]        Re-run a command on file changes
 dotmd diff [file]            Show changes since last updated date
 dotmd new <name>             Create a new document from template
@@ -238,6 +245,27 @@ dotmd deps docs/plan-a.md --depth 2      # limit tree depth
 dotmd deps --json                        # machine-readable
 ```
 
+### Unblocks
+
+```bash
+dotmd unblocks docs/plan-a.md            # what depends on this plan
+dotmd unblocks docs/plan-a.md --json     # machine-readable
+```
+
+### Health
+
+```bash
+dotmd health                             # plan pipeline and aging
+dotmd health --json                      # machine-readable
+```
+
+### Briefing
+
+```bash
+dotmd briefing                           # compact 5-10 line summary
+dotmd briefing --json                    # machine-readable
+```
+
 ### AI Summaries
 
 ```bash
@@ -249,6 +277,14 @@ dotmd context --summarize                # AI-enhanced briefing
 
 Uses a local model by default. Override with `--model <name>` or the `summarizeDoc` hook.
 
+### Glossary
+
+```bash
+dotmd glossary "auth token"              # look up a term
+dotmd glossary --list                    # list all terms
+dotmd glossary --json                    # machine-readable
+```
+
 ### Export
 
 ```bash
@@ -309,6 +345,21 @@ dotmd archive docs/old-plan.md           # move + update refs + regen index
 dotmd archive docs/old-plan.md -n        # preview
 ```
 
+### Bulk Archive
+
+```bash
+dotmd bulk archive docs/old-a.md docs/old-b.md   # archive multiple
+dotmd bulk archive docs/old-*.md -n               # preview
+```
+
+### Pickup & Finish
+
+```bash
+dotmd pickup docs/plans/my-plan.md       # set in-session + print content
+dotmd finish docs/plans/my-plan.md       # set done + bump date
+dotmd finish docs/plans/my-plan.md active  # back to active for more work
+```
+
 ### Touch
 
 ```bash

package/bin/dotmd.mjs

@@ -15,23 +15,24 @@ const HELP = {
 
 View & Query:
   list [--verbose] [--json]         List docs grouped by status (default command)
-  json                              Full index as JSON
-  briefing [--json]                 Compact summary for session start (5-10 lines)
+  briefing [--json]                 Compact summary for session start
   context [--summarize] [--json]    Full briefing (LLM-oriented)
   focus [status] [--json]           Detailed view for one status group
   query [filters] [--json]          Filtered search (--status, --keyword, --stale, etc.)
-  coverage [--json]                 Metadata coverage report
+  plans                             All plans (preset)
+  stale                             Stale docs (preset)
+  actionable                        Docs with next steps (preset)
+
+Analyze:
   stats [--json]                    Doc health dashboard
+  health [--json]                   Plan velocity, aging, and pipeline health
+  coverage [--json]                 Metadata coverage report
   graph [--dot] [--json]            Visualize document relationships
   deps [file] [--json]              Dependency tree or overview
   unblocks <file> [--json]          Show what completes when this doc ships
-  health [--json]                   Plan velocity, aging, and pipeline health
-  glossary <term> [--list] [--json] Look up domain terms + related docs
   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
+  glossary <term> [--list] [--json] Look up domain terms + related docs
 
 Validate & Fix:
   check [--fix] [--errors-only] [--json]  Validate frontmatter and references
@@ -380,6 +381,38 @@ Supports all query flags (--status, --json, --sort, etc.)`,
 
 Shows active/ready docs that have a next_step defined.
 Supports all query flags (--status, --json, --sort, etc.)`,
+
+  unblocks: `dotmd unblocks <file> — show what completes when this doc ships
+
+Shows documents that reference or depend on the given file.
+Useful for impact analysis before archiving or changing a plan.
+
+Options:
+  --json                 Output as JSON`,
+
+  health: `dotmd health — plan velocity, aging, and pipeline health
+
+Shows plan pipeline status, active plan aging, recently archived
+plans, and checklist progress. Plans-only view.
+
+Options:
+  --json                 Output as JSON`,
+
+  glossary: `dotmd glossary <term> — look up domain terms and related docs
+
+Searches the glossary table in your docs for matching terms.
+Shows definition, related docs, and see-also entries.
+
+Options:
+  --list                 List all glossary terms
+  --json                 Output as JSON`,
+
+  bulk: `dotmd bulk archive <f1> <f2> ... — archive multiple files at once
+
+Archives each file: sets status to archived, moves to archive
+directory, updates references, and regenerates the index.
+
+Use --dry-run (-n) to preview changes without writing anything.`,
 };
 
 async function main() {
@@ -741,7 +774,8 @@ async function main() {
   // Unknown command — suggest closest match
   const allCommands = [
     'list', 'json', 'check', 'coverage', 'stats', 'graph', 'deps', 'briefing', 'context',
-    'focus', 'query', 'plans', 'stale', 'actionable', 'index', 'pickup', 'finish', 'status', 'archive', 'touch', 'doctor',
+    'focus', 'query', 'plans', 'stale', 'actionable', 'index', 'pickup', 'finish', 'status', 'archive', 'bulk', 'touch', 'doctor',
+    'unblocks', 'health', 'glossary',
     'fix-refs', 'lint', 'rename', 'migrate', 'notion', 'export', 'summary',
     'watch', 'diff', 'new', 'init', 'completions',
   ];

package/package.json

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