@jaggerxtrm/specialists 3.4.4 → 3.5.1

package/README.md

@@ -81,6 +81,7 @@ specialists doctor
 | xtrm / worktree integration | [docs/worktree.md](docs/worktree.md) |
 | RPC mode notes | [docs/pi-rpc.md](docs/pi-rpc.md) |
 | Pi subprocess isolation and extensions | [docs/pi-session.md](docs/pi-session.md) |
+| NodeSupervisor architecture, node lifecycle, and `sp node` CLI | [docs/nodes.md](docs/nodes.md) |
 
 ## Project structure
 

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

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 // specialists-session-start — Claude Code SessionStart hook
 // Injects specialists context at the start of every session:
-//   • using-specialists skill (behavioral delegation guide)
 //   • Active background jobs (if any)
 //   • Available specialists list
 //   • Key CLI commands reminder
@@ -11,25 +10,13 @@
 
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
-
+import { homedir } from 'node:os';
 
 const cwd     = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+const HOME    = homedir();
 const jobsDir = join(cwd, '.specialists', 'jobs');
 const lines   = [];
 
-// ── 0. using-specialists skill ─────────────────────────────────────────────
-// Inject the behavioral delegation guide so Claude knows when and how to
-// use specialists without waiting for the user to ask.
-const skillPath = join(cwd, '.specialists', 'default', 'skills', 'using-specialists', 'SKILL.md');
-if (existsSync(skillPath)) {
-  const raw = readFileSync(skillPath, 'utf-8');
-  // Strip YAML frontmatter (--- ... ---) if present
-  const content = raw.startsWith('---')
-    ? raw.replace(/^---[\s\S]*?---\n?/, '').trimStart()
-    : raw;
-  lines.push(content);
-}
-
 // ── 1. Active background jobs ──────────────────────────────────────────────
 if (existsSync(jobsDir)) {
   let entries = [];
@@ -72,20 +59,21 @@ function readSpecialistNames(dir) {
   }
 }
 
-const defaultNames = readSpecialistNames(join(cwd, '.specialists', 'default', 'specialists'));
-const userNames    = readSpecialistNames(join(cwd, '.specialists', 'user', 'specialists'));
+const projectNames = readSpecialistNames(join(cwd, 'specialists'));
+const userNames    = readSpecialistNames(join(HOME, '.agents', 'specialists'));
 
-// User takes precedence on name collision; merge and sort
-const allNames = [...new Set([...userNames, ...defaultNames])].sort();
+// Merge, deduplicate, sort
+const allNames = [...new Set([...projectNames, ...userNames])].sort();
 
 if (allNames.length > 0) {
   lines.push('## Specialists — Available');
   lines.push('');
-  if (defaultNames.length > 0) {
-    lines.push(`default (${defaultNames.length}): ${defaultNames.join(', ')}`);
+  if (projectNames.length > 0) {
+    lines.push(`project (${projectNames.length}): ${projectNames.join(', ')}`);
   }
   if (userNames.length > 0) {
-    const extraUser = userNames.filter(n => !defaultNames.includes(n));
+    // Only show user-scope names not already in project
+    const extraUser = userNames.filter(n => !projectNames.includes(n));
     if (extraUser.length > 0) {
       lines.push(`user    (${extraUser.length}): ${extraUser.join(', ')}`);
     }
@@ -99,8 +87,7 @@ lines.push('');
 lines.push('```');
 lines.push('specialists list                                   # discover available specialists');
 lines.push('specialists run <name> --prompt "..."              # run foreground (streams output)');
-lines.push('process start "specialists run <name> --prompt "..."" name="sp-<name>" # async via process extension');
-lines.push('specialists run <name> --prompt "..."              # foreground stream');
+lines.push('specialists run <name> --prompt "..."              # run; job ID prints on stderr');
 lines.push('specialists feed <job-id> --follow                 # tail live events');
 lines.push('specialists result <job-id>                        # read final output');
 lines.push('specialists status                                 # system health');
@@ -113,8 +100,6 @@ lines.push('MCP tools: use_specialist (foreground only)');
 if (lines.length === 0) process.exit(0);
 
 process.stdout.write(JSON.stringify({
-  hookSpecificOutput: {
-    hookEventName: 'SessionStart',
-    additionalSystemPrompt: lines.join('\n'),
-  },
+  type: 'inject',
+  content: lines.join('\n'),
 }) + '\n');

package/config/presets.json

@@ -0,0 +1,26 @@
+{
+  "cheap": {
+    "description": "Low-cost, fast responses — best for exploration and simple tasks",
+    "fields": {
+      "specialist.execution.model": "dashscope/qwen3.5-plus",
+      "specialist.execution.thinking_level": "off",
+      "specialist.execution.stall_timeout_ms": 60000
+    }
+  },
+  "medium": {
+    "description": "Balanced cost/quality — good default for most tasks",
+    "fields": {
+      "specialist.execution.model": "anthropic/claude-sonnet-4-6",
+      "specialist.execution.thinking_level": "low",
+      "specialist.execution.stall_timeout_ms": 120000
+    }
+  },
+  "power": {
+    "description": "Maximum capability — complex implementation and reasoning",
+    "fields": {
+      "specialist.execution.model": "openai-codex/gpt-5.4",
+      "specialist.execution.thinking_level": "high",
+      "specialist.execution.stall_timeout_ms": 300000
+    }
+  }
+}