dotmd-cli 0.64.1 → 0.64.2

package/README.md

@@ -9,6 +9,7 @@ Index, query, validate, and lifecycle-manage any collection of `.md` files — p
 ```bash
 npm install -g dotmd-cli    # global — use `dotmd` anywhere
 npm install -D dotmd-cli    # project devDep — use via npm scripts
+npx dotmd-cli init          # try it without installing — scaffold a repo first
 # requires Node.js >= 20
 ```
 
@@ -27,6 +28,19 @@ The plugin bundles the hooks (`SessionStart`/`SubagentStart` priming, a `PreTool
 
 > **Upgrading to 0.57.0+:** per-repo `.claude/commands/{plans,docs,baton}.md` scaffolding is retired — that guidance now ships via the plugin's workflow skill and `/plans`, `/docs`, `/prompts`, `/baton` commands. On the next `dotmd hud` (SessionStart), dotmd removes those generated files (only banner-stamped `<!-- dotmd-generated -->` ones — your hand-authored command files are never touched). If you'd committed them, you'll see deletions to commit — that's expected. Run `claude plugin update dotmd@dotmd` to pick up `/baton`.
 
+### Updating
+
+The CLI and the Claude Code plugin are versioned in lockstep but ship as separate artifacts, so upgrading one can leave the other behind. `dotmd update` keeps them aligned:
+
+```bash
+dotmd update                 # update both: npm CLI + the plugin
+dotmd update --check         # report CLI vs plugin versions, change nothing (no network)
+dotmd update --cli-only      # just the npm CLI
+dotmd update --plugin-only   # just the plugin (what to run after a plain npm upgrade)
+```
+
+`--plugin-only` is the usual fixup: after `npm i -g dotmd-cli@latest` the CLI is fresh but the plugin is stale, so run `dotmd update --plugin-only`, then restart the session (or `/reload-plugins`).
+
 ## Quick Start
 
 ```bash

package/bin/dotmd.mjs

@@ -255,6 +255,7 @@ Create & Export:
 
 Setup:
   init                              Create starter config + docs directory
+  update [--check|--cli-only|--plugin-only]  Update the CLI + Claude Code plugin (--check reports skew, no network)
   statuses [list|add|set|remove|migrate]  Manage per-project status taxonomy
   help statuses                     Full status vocabulary + unstuck-actions + transitions
   watch [command]                   Re-run a command on file changes

package/package.json

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

package/src/init.mjs

@@ -190,9 +190,15 @@ function generateDetectedConfig(scan, rootPath) {
     lines.push('');
   }
 
-  if (scan.surfaces.size > 0) {
+  if (scan.surfaces.size > 0 || scan.modules.size > 0) {
     lines.push('export const taxonomy = {');
-    lines.push(`  surfaces: [${[...scan.surfaces].sort().map(s => `'${s}'`).join(', ')}],`);
+    // Emit the full detected set so every existing doc passes — taxonomy
+    // enforcement only flags values outside the list, and the scan collected
+    // all of them. New surfaces/modules added later warn until appended here.
+    if (scan.surfaces.size > 0)
+      lines.push(`  surfaces: [${[...scan.surfaces].sort().map(s => `'${s}'`).join(', ')}],`);
+    if (scan.modules.size > 0)
+      lines.push(`  modules: [${[...scan.modules].sort().map(m => `'${m}'`).join(', ')}],`);
     lines.push('};');
     lines.push('');
   }