@jaggerxtrm/specialists 2.1.20 → 3.0.0

package/hooks/beads-close-memory-prompt.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// beads-close-memory-prompt — Claude Code PostToolUse hook
+// After `bd close`: injects a short reminder into Claude's context to capture
+// knowledge and consider underused beads features.
+// Output to stdout is shown to Claude as additional context.
+//
+// Installed by: specialists install
+
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+let input;
+try {
+  input = JSON.parse(readFileSync(0, 'utf8'));
+} catch {
+  process.exit(0);
+}
+
+// Only fire on Bash tool
+if (input.tool_name !== 'Bash') process.exit(0);
+
+const cmd = (input.tool_input?.command ?? '').trim();
+
+// Only fire when the command is `bd close ...`
+if (!/\bbd\s+close\b/.test(cmd)) process.exit(0);
+
+// Only fire in projects that use beads
+const cwd = input.cwd ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+if (!existsSync(join(cwd, '.beads'))) process.exit(0);
+
+// Inject reminder into Claude's context
+process.stdout.write(
+  '\n[beads] Issue(s) closed. Before moving on:\n\n' +
+  '  Knowledge worth keeping?\n' +
+  '    bd remember "key insight from this work"\n' +
+  '    bd memories <keyword>   -- search what is already stored\n\n' +
+  '  Discovered related work while implementing?\n' +
+  '    bd create --title="..." --deps=discovered-from:<id>\n\n' +
+  '  Underused features to consider:\n' +
+  '    bd dep add <a> <b>   -- link blocking relationships between issues\n' +
+  '    bd graph             -- visualize issue dependency graph\n' +
+  '    bd orphans           -- issues referenced in commits but still open\n' +
+  '    bd preflight         -- PR readiness checklist before gh pr create\n' +
+  '    bd stale             -- issues not touched recently\n'
+);
+
+process.exit(0);

package/hooks/specialists-complete.mjs

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+// specialists-complete — Claude Code UserPromptSubmit hook
+// Checks .specialists/ready/ for completed background job markers and injects
+// completion banners into Claude's context.
+//
+// Installed by: specialists install
+
+import { existsSync, readdirSync, readFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+
+const cwd = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+const readyDir = join(cwd, '.specialists', 'ready');
+
+// Exit silently if no ready dir or nothing to report
+if (!existsSync(readyDir)) process.exit(0);
+
+let markers;
+try {
+  markers = readdirSync(readyDir).filter(f => !f.startsWith('.'));
+} catch {
+  process.exit(0);
+}
+
+if (markers.length === 0) process.exit(0);
+
+const banners = [];
+
+for (const jobId of markers) {
+  const markerPath = join(readyDir, jobId);
+  const statusPath = join(cwd, '.specialists', 'jobs', jobId, 'status.json');
+
+  try {
+    let specialist = jobId;
+    let elapsed = '';
+
+    if (existsSync(statusPath)) {
+      const status = JSON.parse(readFileSync(statusPath, 'utf-8'));
+      specialist = status.specialist ?? jobId;
+      elapsed = status.elapsed_s !== undefined ? `, ${status.elapsed_s}s` : '';
+    }
+
+    banners.push(
+      `[Specialist '${specialist}' completed (job ${jobId}${elapsed}). Run: specialists result ${jobId}]`
+    );
+
+    // Delete marker so it only fires once
+    unlinkSync(markerPath);
+  } catch {
+    // Ignore malformed entries
+    try { unlinkSync(markerPath); } catch { /* ignore */ }
+  }
+}
+
+if (banners.length === 0) process.exit(0);
+
+// UserPromptSubmit hooks inject content via JSON
+process.stdout.write(JSON.stringify({
+  type: 'inject',
+  content: banners.join('\n'),
+}) + '\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaggerxtrm/specialists",
-  "version": "2.1.20",
+  "version": "3.0.0",
   "description": "OmniSpecialist — 7-tool MCP orchestration layer powered by the Specialist System. Discover and execute .specialist.yaml files across project/user/system scopes via pi.",
   "main": "dist/index.js",
   "type": "module",