@jaggerxtrm/specialists 2.1.12 → 2.1.14

package/README.md

@@ -195,13 +195,18 @@ Pre-script output is formatted as `<pre_flight_context>` XML and available in `t
 
 ## CLI
 
-Once installed globally, the `specialists` command provides:
+Once installed globally, `specialists <command>` provides:
 
 | Command | Description |
 |---------|-------------|
-| `specialists install` | Full-stack installer: pi, beads, dolt, MCP registration, hooks, scaffold |
-| `specialists list` | List all discovered specialists with model, description, and scope |
-| `specialists version` | Print the installed package version |
+| `specialists install` | Full-stack installer: pi, beads, dolt, MCP registration, hooks |
+| `specialists init` | Scaffold `./specialists/` and inject usage block into `AGENTS.md` |
+| `specialists list` | List discovered specialists with model, description, and scope |
+| `specialists edit <name> --<field> <value>` | Edit a specialist field in-place |
+| `specialists run <name>` | Run a specialist and stream output to stdout |
+| `specialists status` | Show system health: specialists, pi, beads, MCP |
+| `specialists version` | Print installed package version |
+| `specialists help` | Show command reference |
 | `specialists` | Start the MCP server (called by Claude Code — not for direct use) |
 
 ### specialists list
@@ -218,6 +223,59 @@ Specialists (9)
 
 Scopes: `[project]` = `./specialists/` (or `.claude/specialists/`), `[user]` = `~/.agents/specialists/`
 
+Filter by scope or category: `specialists list --scope user --category analysis`
+
+### specialists edit
+
+Edit individual fields without opening the file:
+
+```bash
+specialists edit init-session --model anthropic/claude-sonnet-4-6
+specialists edit bug-hunt --permission MEDIUM
+specialists edit overthinker --timeout 300000
+specialists edit codebase-explorer --tags "analysis,architecture"
+specialists edit my-spec --description "New description" --dry-run
+```
+
+Editable fields: `model`, `fallback-model`, `description`, `permission`, `timeout`, `tags`
+
+### specialists run
+
+Run a specialist directly from the terminal — no MCP required:
+
+```bash
+# Inline prompt
+specialists run init-session --prompt "What changed recently?"
+
+# Pipe from stdin
+echo "Analyse the architecture" | specialists run codebase-explorer
+
+# Override model, skip beads
+specialists run overthinker --prompt "Refactor strategy?" --model anthropic/claude-sonnet-4-6 --no-beads
+```
+
+Output streams to stdout in real time. Model, duration, and bead ID appear on stderr.
+
+### specialists status
+
+```
+specialists status
+
+── Specialists ───────────────────────────
+  ✓ 9 found  (9 project)
+
+── pi  (coding agent runtime) ────────────
+  ✓ v0.57.1  —  4 providers active  (anthropic, google-gemini-cli, qwen, zai)
+
+── beads  (issue tracker) ────────────────
+  ✓ bd installed  v0.59.0
+  ✓ .beads/ present in project
+
+── MCP ───────────────────────────────────
+  ✓ specialists binary installed  /usr/local/bin/specialists
+  verify registration: claude mcp get specialists
+```
+
 ---
 
 ## Development

package/bin/install.js

@@ -303,14 +303,14 @@ process.exit(0);
 
 const BEADS_EDIT_GATE_ENTRY = {
   matcher: 'Edit|Write|MultiEdit|NotebookEdit|mcp__serena__replace_symbol_body|mcp__serena__insert_after_symbol|mcp__serena__insert_before_symbol',
-  hooks: [{ type: 'command', command: BEADS_EDIT_GATE_FILE, timeout: 10 }],
+  hooks: [{ type: 'command', command: BEADS_EDIT_GATE_FILE, timeout: 10000 }],
 };
 const BEADS_COMMIT_GATE_ENTRY = {
   matcher: 'Bash',
-  hooks: [{ type: 'command', command: BEADS_COMMIT_GATE_FILE, timeout: 10 }],
+  hooks: [{ type: 'command', command: BEADS_COMMIT_GATE_FILE, timeout: 10000 }],
 };
 const BEADS_STOP_GATE_ENTRY = {
-  hooks: [{ type: 'command', command: BEADS_STOP_GATE_FILE, timeout: 10 }],
+  hooks: [{ type: 'command', command: BEADS_STOP_GATE_FILE, timeout: 10000 }],
 };
 
 function installHook() {

package/dist/index.js

@@ -18149,7 +18149,7 @@ import { execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { dirname as dirname2, join as join4 } from "node:path";
 async function run() {
-  const installerPath = join4(dirname2(fileURLToPath(import.meta.url)), "..", "..", "bin", "install.js");
+  const installerPath = join4(dirname2(fileURLToPath(import.meta.url)), "..", "bin", "install.js");
   execFileSync(process.execPath, [installerPath], { stdio: "inherit" });
 }
 var init_install = () => {};
@@ -18539,26 +18539,127 @@ var init_run = __esm(() => {
   init_beads();
 });
 
+// src/cli/status.ts
+var exports_status = {};
+__export(exports_status, {
+  run: () => run7
+});
+import { spawnSync as spawnSync3 } from "node:child_process";
+import { existsSync as existsSync4 } from "node:fs";
+import { join as join7 } from "node:path";
+function ok2(msg) {
+  console.log(`  ${green4("✓")} ${msg}`);
+}
+function warn(msg) {
+  console.log(`  ${yellow4("○")} ${msg}`);
+}
+function fail(msg) {
+  console.log(`  ${red("✗")} ${msg}`);
+}
+function info(msg) {
+  console.log(`  ${dim5(msg)}`);
+}
+function section(label) {
+  const line = "─".repeat(Math.max(0, 38 - label.length));
+  console.log(`
+${bold5(`── ${label} ${line}`)}`);
+}
+function cmd(bin, args) {
+  const r = spawnSync3(bin, args, {
+    encoding: "utf8",
+    stdio: "pipe",
+    timeout: 5000
+  });
+  return { ok: r.status === 0 && !r.error, stdout: (r.stdout ?? "").trim() };
+}
+function isInstalled(bin) {
+  return spawnSync3("which", [bin], { encoding: "utf8", timeout: 2000 }).status === 0;
+}
+async function run7() {
+  console.log(`
+${bold5("specialists status")}
+`);
+  section("Specialists");
+  const loader = new SpecialistLoader;
+  const all = await loader.list();
+  if (all.length === 0) {
+    warn(`no specialists found — run ${yellow4("specialists init")} to scaffold`);
+  } else {
+    const byScope = all.reduce((acc, s) => {
+      acc[s.scope] = (acc[s.scope] ?? 0) + 1;
+      return acc;
+    }, {});
+    const scopeSummary = Object.entries(byScope).map(([scope, n]) => `${n} ${scope}`).join(", ");
+    ok2(`${all.length} found  ${dim5(`(${scopeSummary})`)}`);
+    for (const s of all) {
+      const staleness = await checkStaleness(s);
+      if (staleness === "AGED") {
+        warn(`${s.name}  ${red("AGED")}  ${dim5(s.scope)}`);
+      } else if (staleness === "STALE") {
+        warn(`${s.name}  ${yellow4("STALE")}  ${dim5(s.scope)}`);
+      }
+    }
+  }
+  section("pi  (coding agent runtime)");
+  if (!isInstalled("pi")) {
+    fail(`pi not installed — run ${yellow4("specialists install")}`);
+  } else {
+    const version2 = cmd("pi", ["--version"]);
+    const models = cmd("pi", ["--list-models"]);
+    const providers = new Set(models.stdout.split(`
+`).slice(1).map((line) => line.split(/\s+/)[0]).filter(Boolean));
+    const vStr = version2.ok ? `v${version2.stdout}` : "unknown version";
+    const pStr = providers.size > 0 ? `${providers.size} provider${providers.size > 1 ? "s" : ""} active  ${dim5(`(${[...providers].join(", ")})`)} ` : yellow4("no providers configured — run pi config");
+    ok2(`${vStr}  —  ${pStr}`);
+  }
+  section("beads  (issue tracker)");
+  if (!isInstalled("bd")) {
+    fail(`bd not installed — run ${yellow4("specialists install")}`);
+  } else {
+    const bdVersion = cmd("bd", ["--version"]);
+    ok2(`bd installed${bdVersion.ok ? `  ${dim5(bdVersion.stdout)}` : ""}`);
+    if (existsSync4(join7(process.cwd(), ".beads"))) {
+      ok2(".beads/ present in project");
+    } else {
+      warn(`.beads/ not found — run ${yellow4("bd init")} to enable issue tracking`);
+    }
+  }
+  section("MCP");
+  const specialistsBin = cmd("which", ["specialists"]);
+  if (!specialistsBin.ok) {
+    fail(`specialists not installed globally — run ${yellow4("npm install -g @jaggerxtrm/specialists")}`);
+  } else {
+    ok2(`specialists binary installed  ${dim5(specialistsBin.stdout)}`);
+    info(`verify registration: claude mcp get specialists`);
+    info(`re-register:         specialists install`);
+  }
+  console.log();
+}
+var bold5 = (s) => `\x1B[1m${s}\x1B[0m`, dim5 = (s) => `\x1B[2m${s}\x1B[0m`, green4 = (s) => `\x1B[32m${s}\x1B[0m`, yellow4 = (s) => `\x1B[33m${s}\x1B[0m`, red = (s) => `\x1B[31m${s}\x1B[0m`;
+var init_status = __esm(() => {
+  init_loader();
+});
+
 // src/cli/help.ts
 var exports_help = {};
 __export(exports_help, {
-  run: () => run7
+  run: () => run8
 });
-async function run7() {
+async function run8() {
   const lines = [
     "",
-    bold5("specialists <command>"),
+    bold6("specialists <command>"),
     "",
     "Commands:",
-    ...COMMANDS.map(([cmd, desc]) => `  ${cmd.padEnd(COL_WIDTH)}    ${dim5(desc)}`),
+    ...COMMANDS.map(([cmd2, desc]) => `  ${cmd2.padEnd(COL_WIDTH)}    ${dim6(desc)}`),
     "",
-    dim5("Run 'specialists <command> --help' for command-specific options."),
+    dim6("Run 'specialists <command> --help' for command-specific options."),
     ""
   ];
   console.log(lines.join(`
 `));
 }
-var bold5 = (s) => `\x1B[1m${s}\x1B[0m`, dim5 = (s) => `\x1B[2m${s}\x1B[0m`, COMMANDS, COL_WIDTH;
+var bold6 = (s) => `\x1B[1m${s}\x1B[0m`, dim6 = (s) => `\x1B[2m${s}\x1B[0m`, COMMANDS, COL_WIDTH;
 var init_help = __esm(() => {
   COMMANDS = [
     ["install", "Full-stack installer: pi, beads, dolt, MCP registration, hooks"],
@@ -18570,7 +18671,7 @@ var init_help = __esm(() => {
     ["status", "Show system health (pi, beads, MCP)"],
     ["help", "Show this help message"]
   ];
-  COL_WIDTH = Math.max(...COMMANDS.map(([cmd]) => cmd.length));
+  COL_WIDTH = Math.max(...COMMANDS.map(([cmd2]) => cmd2.length));
 });
 
 // node_modules/zod/v4/core/core.js
@@ -26315,7 +26416,7 @@ class SpecialistsServer {
 
 // src/index.ts
 var sub = process.argv[2];
-async function run8() {
+async function run9() {
   if (sub === "install") {
     const { run: handler } = await Promise.resolve().then(() => (init_install(), exports_install));
     return handler();
@@ -26340,6 +26441,10 @@ async function run8() {
     const { run: handler } = await Promise.resolve().then(() => (init_run(), exports_run));
     return handler();
   }
+  if (sub === "status") {
+    const { run: handler } = await Promise.resolve().then(() => (init_status(), exports_status));
+    return handler();
+  }
   if (sub === "help" || sub === "--help" || sub === "-h") {
     const { run: handler } = await Promise.resolve().then(() => (init_help(), exports_help));
     return handler();
@@ -26348,7 +26453,7 @@ async function run8() {
   const server = new SpecialistsServer;
   await server.start();
 }
-run8().catch((error2) => {
+run9().catch((error2) => {
   logger.error(`Fatal error: ${error2}`);
   process.exit(1);
 });

package/package.json

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