@jaggerxtrm/specialists 3.4.3 → 3.4.4

package/config/hooks/specialists-complete.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// specialists-complete — Claude Code UserPromptSubmit hook
+// specialists-complete — Claude Code UserPromptSubmit/PostToolUse hook
 // Checks .specialists/ready/ for completed background job markers and injects
-// completion banners into Claude's context.
+// completion/failure banners into Claude's context.
 //
 // Installed by: specialists install
 
@@ -32,16 +32,26 @@ for (const jobId of markers) {
   try {
     let specialist = jobId;
     let elapsed = '';
+    let completionStatus = 'done';
+    let errorMessage = '';
 
     if (existsSync(statusPath)) {
       const status = JSON.parse(readFileSync(statusPath, 'utf-8'));
       specialist = status.specialist ?? jobId;
       elapsed = status.elapsed_s !== undefined ? `, ${status.elapsed_s}s` : '';
+      completionStatus = status.status ?? 'done';
+      errorMessage = status.error ? ` — ${status.error}` : '';
     }
 
-    banners.push(
-      `[Specialist '${specialist}' completed (job ${jobId}${elapsed}). Run: specialists result ${jobId}]`
-    );
+    if (completionStatus === 'error') {
+      banners.push(
+        `[Specialist '${specialist}' failed (job ${jobId}${elapsed}${errorMessage}). Run: specialists feed ${jobId} --follow]`
+      );
+    } else {
+      banners.push(
+        `[Specialist '${specialist}' completed (job ${jobId}${elapsed}). Run: specialists result ${jobId}]`
+      );
+    }
 
     // Delete marker so it only fires once
     unlinkSync(markerPath);
@@ -53,7 +63,7 @@ for (const jobId of markers) {
 
 if (banners.length === 0) process.exit(0);
 
-// UserPromptSubmit hooks inject content via JSON
+// UserPromptSubmit/PostToolUse hooks inject content via JSON
 process.stdout.write(JSON.stringify({
   type: 'inject',
   content: banners.join('\n'),

package/config/hooks/specialists-session-start.mjs

@@ -107,7 +107,7 @@ lines.push('specialists status                                 # system health')
 lines.push('specialists doctor                                 # troubleshoot issues');
 lines.push('```');
 lines.push('');
-lines.push('MCP tools: specialist_init · use_specialist · start_specialist · feed_specialist · run_parallel');
+lines.push('MCP tools: use_specialist (foreground only)');
 
 // ── Output ─────────────────────────────────────────────────────────────────
 if (lines.length === 0) process.exit(0);

package/config/skills/using-specialists/SKILL.md

@@ -296,6 +296,8 @@ Available after `specialists init` and session restart.
 
 MCP is intentionally minimal. Use CLI commands for orchestration, monitoring, steering,
 resume, and cancellation.
+If you encounter legacy `start_specialist`, treat it as deprecated and migrate to
+`specialists run <name> --prompt "..." --background`.
 
 ---
 

package/dist/index.js

@@ -19297,6 +19297,7 @@ function ensureProjectHookWiring(cwd) {
     }
   }
   addHook("UserPromptSubmit", "node .claude/hooks/specialists-complete.mjs");
+  addHook("PostToolUse", "node .claude/hooks/specialists-complete.mjs");
   addHook("SessionStart", "node .claude/hooks/specialists-session-start.mjs");
   if (changed) {
     saveJson(settingsPath, settings);
@@ -20201,6 +20202,10 @@ class Supervisor {
   readyDir() {
     return join10(this.opts.jobsDir, "..", "ready");
   }
+  writeReadyMarker(id) {
+    mkdirSync2(this.readyDir(), { recursive: true });
+    writeFileSync3(join10(this.readyDir(), id), "", "utf-8");
+  }
   readStatus(id) {
     const path = this.statusPath(id);
     if (!existsSync10(path))
@@ -20566,8 +20571,7 @@ class Supervisor {
         bead_id: result.beadId,
         output: result.output
       }));
-      mkdirSync2(this.readyDir(), { recursive: true });
-      writeFileSync3(join10(this.readyDir(), id), "", "utf-8");
+      this.writeReadyMarker(id);
       return id;
     } catch (err) {
       const elapsed = Math.round((Date.now() - startedAtMs) / 1000);
@@ -20580,6 +20584,7 @@ class Supervisor {
       appendTimelineEvent(createRunCompleteEvent("ERROR", elapsed, {
         error: errorMsg
       }));
+      this.writeReadyMarker(id);
       throw err;
     } finally {
       if (stuckIntervalId !== undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaggerxtrm/specialists",
-  "version": "3.4.3",
+  "version": "3.4.4",
   "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",