dotmd-cli 0.50.0 → 0.50.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.50.0",
+  "version": "0.50.2",
   "description": "CLI for managing markdown documents with YAML frontmatter — index, query, validate, graph, export, Notion sync, AI summaries.",
   "type": "module",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "test": "node --test test/*.test.mjs",
     "preversion": "npm test",
     "version": "node bin/dotmd.mjs hud >/dev/null 2>&1; git add .claude/commands docs/docs.md 2>/dev/null; true",
-    "postversion": "git push origin main --tags && gh release create v$npm_package_version --generate-notes --title v$npm_package_version && sleep 5 && gh run watch $(gh run list --workflow=publish.yml --limit 1 --json databaseId --jq '.[0].databaseId') --exit-status && sleep 10 && npm cache clean --force && npm install -g dotmd-cli@$npm_package_version"
+    "postversion": "bash scripts/postversion.sh"
   },
   "engines": {
     "node": ">=20"

package/src/claude-commands.mjs

@@ -100,7 +100,7 @@ function generateBatonCommand(config, version) {
   const lines = [...frontmatterFor('baton', config), markerFor(version), ''];
   lines.push('Wrap this session. Two commands:');
   lines.push('');
-  lines.push('1. **Save the resume prompt.** `dotmd new prompt resume-<plan-slug>` — pipe stdin or pass `@path`. 10-20 line body: the next concrete decision plus any gotchas. NOT a recap of the plan body. The saved prompt IS the handoff — never print it into chat for copy-paste.');
+  lines.push('1. **Save the resume prompt.** `dotmd new prompt resume-<plan-slug>` — pipe stdin or pass `@path`. 10-20 line body: the next concrete decision plus any gotchas. NOT a recap of the plan body. The saved prompt IS the handoff — never print it into chat for copy-paste. Treat `docs/prompts/` as local session state: it is often gitignored and should not be committed just because you created a handoff prompt.');
   lines.push('');
   lines.push('2. **Close out via `dotmd set <status>`.** Pick the status that matches reality:');
   lines.push('    - `dotmd set active <file>` — work continues, return the plan to the active queue');
@@ -133,7 +133,7 @@ function generateDocsCommand(config, version) {
 
   lines.push('Commands for working with docs:');
   lines.push('- `dotmd context` — LLM-oriented briefing across all types');
-  lines.push('- `dotmd doctor` — auto-fix everything in one pass (refs, lint, dates, index)');
+  lines.push('- `dotmd doctor --apply` — auto-fix everything in one pass (refs, lint, dates, index; bare `dotmd doctor` previews only)');
   lines.push('- `dotmd query [filters]` — search by status, keyword, module, surface, type, staleness');
   lines.push('- `dotmd health` — plan pipeline, velocity, aging');
   lines.push('- `dotmd stats` — doc health dashboard (completeness, checklists, audit coverage)');

package/src/render.mjs

@@ -493,7 +493,7 @@ function _renderCheck(index, opts = {}) {
       }
       lines.push('');
     } else {
-      lines.push(dim(`Run \`dotmd check --verbose\` for per-doc detail. \`dotmd doctor\` auto-fixes supported issues; remaining issues need the suggested manual command.`));
+      lines.push(dim(`Run \`dotmd check --verbose\` for per-doc detail. \`dotmd doctor --apply\` auto-fixes supported issues (bare \`dotmd doctor\` previews only); remaining issues need the suggested manual command.`));
       lines.push('');
     }
   }

package/src/validate.mjs

@@ -416,7 +416,10 @@ export function checkBidirectionalReferences(docs, config) {
 // rendering), so divergence almost always means the agent forgot the back-link.
 // Warning fires on the CHILD (that's the file that needs the edit). Skips
 // terminal/archive statuses on either side — runlists referencing closed work
-// are a normal history pattern.
+// are a normal history pattern. A `>`-prefixed (one-way) runlist entry opts
+// that child out of the back-pointer requirement — the same per-ref escape
+// hatch the bidirectional reciprocity check honors (A4) — so a hub can order a
+// child it doesn't own without nagging the child to add `parent_plan:`.
 export function checkRunlistBackPointers(docs, config) {
   const warnings = [];
   const skipStatuses = new Set([
@@ -428,10 +431,13 @@ export function checkRunlistBackPointers(docs, config) {
   for (const hub of docs) {
     if (skipStatuses.has(hub.status)) continue;
     const runlistRefs = hub.refFields?.runlist ?? [];
+    const runlistDirs = hub.refFieldDirections?.runlist ?? [];
     if (runlistRefs.length === 0) continue;
     const hubDir = path.dirname(path.join(config.repoRoot, hub.path));
 
-    for (const ref of runlistRefs) {
+    for (let i = 0; i < runlistRefs.length; i++) {
+      const ref = runlistRefs[i];
+      if (runlistDirs[i] === 'one-way') continue; // `> child.md` → ordered but no back-pointer expected
       const resolved = resolveRefPath(ref, hubDir, config.repoRoot);
       if (!resolved) continue; // unresolved refs already get their own existence error
       const childPath = toRepoPath(resolved, config.repoRoot);