dotmd-cli 0.55.0 → 0.56.0

package/bin/dotmd.mjs

@@ -1233,7 +1233,12 @@ async function main() {
     restArgs.push(args[i]);
   }
 
-  if (!config.configFound && command !== 'init') {
+  // Hook commands (`hud`, `guard`) fire in EVERY repo via the globally-enabled
+  // plugin — `guard` runs on every Bash/Read/Edit. They must stay silent where
+  // dotmd isn't used, so don't nag them about a missing config (they no-op
+  // cleanly on their own). The warning is still useful for interactive commands.
+  const HOOK_COMMANDS = new Set(['hud', 'guard']);
+  if (!config.configFound && command !== 'init' && !HOOK_COMMANDS.has(command)) {
     warn('No dotmd config found — using defaults. Run `dotmd init` to create one.');
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dotmd-cli",
-  "version": "0.55.0",
+  "version": "0.56.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/hud.mjs

@@ -229,20 +229,36 @@ const SUBAGENT_PRIMER = [
   'git add/commit a prompt (they are session-local, often gitignored); hand-edit a `status:` field (use `dotmd set`).',
 ].join('\n');
 
+// The plugin's SessionStart/SubagentStart hooks fire in EVERY repo (it's enabled
+// globally), but the primer only helps where dotmd is actually used. Gate on a
+// discovered config: `dotmd init` writes dotmd.config.mjs, so "has a config" is
+// the zero-false-positive signal for "this is a dotmd repo." A bare docs/ dir is
+// deliberately NOT enough — too many repos have one. In a non-dotmd repo the hook
+// then contributes nothing to the session: no primer, no index build, no heal.
+function isDotmdRepo(config) {
+  return Boolean(config?.configFound);
+}
+
 export function runHud(argv, config) {
   const json = argv.includes('--json');
 
   const drift = detectVersionDrift();
+  const dotmdRepo = isDotmdRepo(config);
 
   // SubagentStart hook entry point — emit the compact primer and return. No
   // index build, no journal read, no slash-command heal: a subagent doesn't
   // need the operator-facing machinery, just the verbs and the guardrails.
   if (argv.includes('--subagent')) {
+    if (!dotmdRepo) return; // silent in repos that don't use dotmd
     process.stdout.write(dim(SUBAGENT_PRIMER) + '\n');
     if (drift) process.stdout.write(yellow(drift) + '\n');
     return;
   }
 
+  // Non-dotmd repo, and not a programmatic --json caller → contribute nothing to
+  // the session. Skip the index build, slash-heal, primer, and drift line.
+  if (!dotmdRepo && !json) return;
+
   const hud = buildHud(config);
 
   // Self-heal stale slash-command files. Wrapped: a broken scaffolder must