@jaggerxtrm/specialists 3.6.19 → 3.7.0

package/dist/index.js

@@ -17511,7 +17511,7 @@ ${result.warnings.map((w) => `  \u26A0 ${w}`).join(`
   const raw = JSON.parse(jsonContent);
   return SpecialistSchema.parseAsync(raw);
 }
-var KebabCase, Semver, MetadataSchema, ExecutionSchema, PromptSchema2, ScriptEntrySchema, SkillsSchema, CapabilitiesSchema, CommunicationSchema, ValidationSchema, StallDetectionSchema, SpecialistSchema;
+var KebabCase, Semver, MetadataSchema, ExecutionSchema, PromptSchema2, ScriptEntrySchema, SkillsSchema, CapabilitiesSchema, CommunicationSchema, ValidationSchema, MandatoryRuleSchema, MandatoryRulesSchema, StallDetectionSchema, SpecialistSchema;
 var init_schema = __esm(() => {
   init_zod();
   KebabCase = stringType().regex(/^[a-z][a-z0-9-]*$/, "Must be kebab-case");
@@ -17580,6 +17580,17 @@ var init_schema = __esm(() => {
     files_to_watch: arrayType(stringType()).optional(),
     stale_threshold_days: numberType().optional()
   }).optional();
+  MandatoryRuleSchema = objectType({
+    id: stringType(),
+    level: enumType(["error", "warn", "info"]).default("error"),
+    text: stringType(),
+    when: stringType().optional()
+  });
+  MandatoryRulesSchema = objectType({
+    template_sets: arrayType(KebabCase).default([]),
+    disable_default_globals: booleanType().default(false),
+    inline_rules: arrayType(MandatoryRuleSchema).default([])
+  }).optional();
   StallDetectionSchema = objectType({
     running_silence_warn_ms: numberType().optional(),
     running_silence_error_ms: numberType().optional(),
@@ -17596,6 +17607,7 @@ var init_schema = __esm(() => {
       communication: CommunicationSchema,
       validation: ValidationSchema,
       stall_detection: StallDetectionSchema,
+      mandatory_rules: MandatoryRulesSchema,
       output_file: stringType().optional(),
       beads_integration: enumType(["auto", "always", "never"]).default("auto"),
       beads_write_notes: booleanType().default(true),
@@ -18750,6 +18762,152 @@ function stripJsonFences(text) {
   return text.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
 }
 
+// src/specialist/mandatory-rules.ts
+import { existsSync as existsSync3, readFileSync } from "fs";
+import { resolve as resolve2 } from "path";
+function readJsonFile(filePath) {
+  return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function loadMandatoryRulesIndex(cwd) {
+  const indexPath = resolve2(cwd, "config/mandatory-rules/index.json");
+  if (!existsSync3(indexPath)) {
+    console.warn("[specialist runner] Missing config/mandatory-rules/index.json; skipping MANDATORY_RULES injection");
+    return null;
+  }
+  return readJsonFile(indexPath);
+}
+function parseQuotedScalar(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+function parseRuleEntry(lines, startIndex) {
+  const entryLine = lines[startIndex]?.trim();
+  if (!entryLine?.startsWith("- "))
+    return null;
+  const firstLine = entryLine.slice(2).trim();
+  const inlineFields = {};
+  if (firstLine.length > 0 && !firstLine.includes(":")) {
+    inlineFields.text = parseQuotedScalar(firstLine);
+  } else if (firstLine.length > 0) {
+    const [key, ...rest] = firstLine.split(":");
+    inlineFields[key.trim()] = parseQuotedScalar(rest.join(":"));
+  }
+  let nextIndex = startIndex + 1;
+  while (nextIndex < lines.length) {
+    const line = lines[nextIndex];
+    if (!line.trim()) {
+      nextIndex += 1;
+      continue;
+    }
+    if (/^\s*-\s+/.test(line))
+      break;
+    if (!/^\s+/.test(line))
+      break;
+    const trimmed = line.trim();
+    const match = trimmed.match(/^([A-Za-z0-9_]+):\s*(.*)$/);
+    if (!match) {
+      nextIndex += 1;
+      continue;
+    }
+    inlineFields[match[1]] = parseQuotedScalar(match[2]);
+    nextIndex += 1;
+  }
+  if (!inlineFields.text)
+    return null;
+  return {
+    rule: {
+      id: inlineFields.id ?? "",
+      level: inlineFields.level ?? "required",
+      text: inlineFields.text,
+      ...inlineFields.when ? { when: inlineFields.when } : {}
+    },
+    nextIndex
+  };
+}
+function parseMandatoryRulesFrontmatter(content, setId) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n?/);
+  if (!frontmatterMatch)
+    return [];
+  const lines = frontmatterMatch[1].split(`
+`);
+  const rulesHeaderIndex = lines.findIndex((line) => /^rules:\s*$/.test(line.trim()));
+  if (rulesHeaderIndex === -1)
+    return [];
+  const rules = [];
+  let index = rulesHeaderIndex + 1;
+  while (index < lines.length) {
+    const line = lines[index];
+    if (!line.trim()) {
+      index += 1;
+      continue;
+    }
+    if (!/^\s*-\s+/.test(line))
+      break;
+    const parsed = parseRuleEntry(lines, index);
+    if (!parsed)
+      break;
+    const ruleIndex = rules.length + 1;
+    rules.push({
+      id: parsed.rule.id || `${setId}-${ruleIndex}`,
+      level: parsed.rule.level,
+      text: parsed.rule.text,
+      ...parsed.rule.when ? { when: parsed.rule.when } : {}
+    });
+    index = parsed.nextIndex;
+  }
+  return rules;
+}
+function readMandatoryRuleSet(cwd, id) {
+  const candidates = [
+    resolve2(cwd, `.specialists/mandatory-rules/${id}.md`),
+    resolve2(cwd, `config/mandatory-rules/${id}.md`)
+  ];
+  const filePath = candidates.find((path) => existsSync3(path));
+  if (!filePath)
+    return null;
+  const content = readFileSync(filePath, "utf8");
+  const rules = parseMandatoryRulesFrontmatter(content, id);
+  if (rules.length > 0)
+    return { id, rules };
+  const body = content.replace(/^---\n[\s\S]*?\n---\n?/, "").trim();
+  if (!body)
+    return null;
+  return {
+    id,
+    rules: [{ id: `${id}-1`, level: "required", text: body.replace(/\s+/g, " ") }]
+  };
+}
+function formatMandatoryRulesBlock(sets) {
+  if (sets.length === 0)
+    return "";
+  const sections = sets.map((set2) => {
+    const rules = set2.rules.map((rule) => `- [${rule.level}] ${rule.text}`).join(`
+`);
+    return `### ${set2.id}
+${rules}`;
+  });
+  return `## MANDATORY_RULES
+${sections.join(`
+
+`)}`;
+}
+function buildMandatoryRulesBlock(specialistConfig) {
+  const cwd = specialistConfig.cwd ?? process.cwd();
+  const index = loadMandatoryRulesIndex(cwd);
+  if (!index)
+    return "";
+  const setIds = [
+    ...index.required_template_sets ?? [],
+    ...index.default_template_sets ?? []
+  ];
+  const sets = setIds.map((id) => readMandatoryRuleSet(cwd, id)).filter((set2) => set2 !== null);
+  return formatMandatoryRulesBlock(sets);
+}
+var init_mandatory_rules = () => {};
+
 // src/specialist/beads.ts
 import { spawnSync } from "child_process";
 function buildBeadContext(bead, completedBlockers = []) {
@@ -18903,7 +19061,7 @@ function shouldCreateBead(beadsIntegration, permissionRequired) {
 var init_beads = () => {};
 
 // src/specialist/observability-db.ts
-import { chmodSync, existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync, writeFileSync as writeFileSync2 } from "fs";
+import { chmodSync, existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import { spawnSync as spawnSync2 } from "child_process";
 import { join as join3, sep as sep2 } from "path";
 function resolveGitRootFrom(cwd) {
@@ -18953,7 +19111,7 @@ function resolveObservabilityDbLocation(cwd = process.cwd()) {
 }
 function ensureObservabilityDbFile(location) {
   mkdirSync2(location.dbDirectory, { recursive: true });
-  const alreadyExists = existsSync3(location.dbPath);
+  const alreadyExists = existsSync4(location.dbPath);
   if (!alreadyExists) {
     writeFileSync2(location.dbPath, "", { encoding: "utf-8", flag: "wx" });
   }
@@ -18967,7 +19125,7 @@ function ensureGitignoreHasObservabilityDbEntries(gitRoot) {
     ".specialists/db/*.db-wal",
     ".specialists/db/*.db-shm"
   ];
-  const existing = existsSync3(gitignorePath) ? readFileSync(gitignorePath, "utf-8") : "";
+  const existing = existsSync4(gitignorePath) ? readFileSync2(gitignorePath, "utf-8") : "";
   const existingLines = new Set(existing.split(/\r?\n/).map((line) => line.trim()).filter(Boolean));
   const missingEntries = requiredEntries.filter((entry) => !existingLines.has(entry));
   if (missingEntries.length === 0) {
@@ -18996,7 +19154,7 @@ var init_observability_db = __esm(() => {
 
 // src/specialist/job-root.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { dirname as dirname2, join as join4, resolve as resolve2 } from "path";
+import { dirname as dirname2, join as join4, resolve as resolve3 } from "path";
 function resolveCommonGitRoot(cwd) {
   const result = spawnSync3("git", ["rev-parse", "--git-common-dir"], {
     cwd,
@@ -19008,7 +19166,7 @@ function resolveCommonGitRoot(cwd) {
   const gitCommonDir = result.stdout?.trim();
   if (!gitCommonDir)
     return;
-  return dirname2(resolve2(cwd, gitCommonDir));
+  return dirname2(resolve3(cwd, gitCommonDir));
 }
 function resolveJobsDir(cwd = process.cwd()) {
   const commonRoot = resolveCommonGitRoot(cwd) ?? cwd;
@@ -19028,7 +19186,7 @@ function resolveCurrentBranch(cwd = process.cwd()) {
 var init_job_root = () => {};
 
 // src/specialist/observability-sqlite.ts
-import { existsSync as existsSync4, readFileSync as readFileSync2, statSync } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync3, statSync } from "fs";
 import { join as join5 } from "path";
 function loadBunDatabase() {
   if (_probed)
@@ -20632,7 +20790,7 @@ class SqliteClient {
         WHERE worktree_column IS NOT NULL AND worktree_column != ''
       `).all();
       for (const row of worktreeRows) {
-        if (existsSync4(row.worktree_column))
+        if (existsSync5(row.worktree_column))
           continue;
         findings.push({
           kind: "stale-pointer",
@@ -20659,10 +20817,10 @@ function hasRunCompleteEvent(jobId, cwd = process.cwd()) {
     sqliteClient?.close();
   }
   const eventsPath = join5(resolveJobsDir(cwd), jobId, "events.jsonl");
-  if (!existsSync4(eventsPath))
+  if (!existsSync5(eventsPath))
     return false;
   try {
-    const lines = readFileSync2(eventsPath, "utf-8").split(`
+    const lines = readFileSync3(eventsPath, "utf-8").split(`
 `).map((line) => line.trim()).filter((line) => line.length > 0);
     for (const line of lines) {
       const event = JSON.parse(line);
@@ -20678,7 +20836,7 @@ function createObservabilitySqliteClient(cwd = process.cwd()) {
   if (!loadBunDatabase())
     return null;
   const location = resolveObservabilityDbLocation(cwd);
-  if (!existsSync4(location.dbPath))
+  if (!existsSync5(location.dbPath))
     return null;
   try {
     const Ctor = loadBunDatabase();
@@ -20926,8 +21084,8 @@ var init_memory_retrieval = __esm(() => {
 import { createHash as createHash2 } from "crypto";
 import { writeFile } from "fs/promises";
 import { execSync as execSync2, spawnSync as spawnSync4 } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync3 } from "fs";
-import { basename as basename2, resolve as resolve3 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync4 } from "fs";
+import { basename as basename2, resolve as resolve4 } from "path";
 import { homedir as homedir2 } from "os";
 function runScript(command, cwd) {
   const run = (command ?? "").trim();
@@ -20958,7 +21116,7 @@ ${blocks}
 </pre_flight_context>`;
 }
 function resolvePath(p) {
-  return p.startsWith("~/") ? resolve3(homedir2(), p.slice(2)) : resolve3(p);
+  return p.startsWith("~/") ? resolve4(homedir2(), p.slice(2)) : resolve4(p);
 }
 function commandExists(cmd) {
   const result = spawnSync4("which", [cmd], { stdio: "ignore" });
@@ -20966,7 +21124,7 @@ function commandExists(cmd) {
 }
 function validateShebang(filePath, errors5) {
   try {
-    const head = readFileSync3(filePath, "utf-8").slice(0, 120);
+    const head = readFileSync4(filePath, "utf-8").slice(0, 120);
     if (!head.startsWith("#!"))
       return;
     const shebang = head.split(`
@@ -20996,7 +21154,7 @@ function validateBeforeRun(spec, permissionLevel) {
   const warnings = [];
   for (const p of spec.specialist.skills?.paths ?? []) {
     const abs = resolvePath(p);
-    if (!existsSync5(abs))
+    if (!existsSync6(abs))
       warnings.push(`  \u26A0 skills.paths: file not found: ${p}`);
   }
   for (const script of spec.specialist.skills?.scripts ?? []) {
@@ -21006,7 +21164,7 @@ function validateBeforeRun(spec, permissionLevel) {
     const isFilePath = run.startsWith("./") || run.startsWith("../") || run.startsWith("/") || run.startsWith("~/");
     if (isFilePath) {
       const abs = resolvePath(run);
-      if (!existsSync5(abs)) {
+      if (!existsSync6(abs)) {
         errors5.push(`  \u2717 skills.scripts: script not found: ${run}`);
       } else {
         validateShebang(abs, errors5);
@@ -21041,7 +21199,7 @@ ${errors5.join(`
   }
 }
 function sleep(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 function getRetryDelayMs(attemptNumber) {
   const baseDelay = RETRY_BASE_DELAY_MS * 2 ** Math.max(0, attemptNumber - 1);
@@ -21332,7 +21490,7 @@ ${buildBeadBoundaryInstruction(runCwd, options.worktreeBoundary)}`.trim();
       execution.extensions?.gitnexus === false ? "pi-gitnexus" : undefined
     ].filter((value) => Boolean(value));
     validateBeforeRun(spec, permissionLevel);
-    const runCwd = resolve3(options.workingDirectory ?? process.cwd());
+    const runCwd = resolve4(options.workingDirectory ?? process.cwd());
     const preScripts = spec.specialist.skills?.scripts?.filter((s) => s.phase === "pre") ?? [];
     const preResults = preScripts.map((s) => runScript(s.run ?? s.path, runCwd)).filter((_, i) => preScripts[i].inject_output);
     const preScriptOutput = formatScriptOutput(preResults);
@@ -21357,7 +21515,23 @@ ${buildBeadBoundaryInstruction(runCwd, options.worktreeBoundary)}`.trim();
       ...beadVariables
     };
     const taskTemplate = options.inputBeadId ? renderTemplate(prompt.task_template, beadTemplateVariables) : prompt.task_template;
-    const renderedTask = renderTemplate(taskTemplate, variables);
+    let renderedTask = renderTemplate(taskTemplate, variables);
+    let mandatoryRulesBlock = "";
+    try {
+      mandatoryRulesBlock = buildMandatoryRulesBlock({ cwd: runCwd });
+      if (mandatoryRulesBlock.trim()) {
+        const rulesTokens = Math.ceil(mandatoryRulesBlock.length / 4);
+        if (rulesTokens <= 2000) {
+          renderedTask = `${renderedTask}
+
+${mandatoryRulesBlock}`;
+        } else {
+          console.warn(`[specialist runner] Skipping MANDATORY_RULES injection: rules block too large (${rulesTokens} tokens, limit 2000)`);
+        }
+      }
+    } catch (error2) {
+      console.warn(`[specialist runner] Skipping MANDATORY_RULES injection: ${String(error2)}`);
+    }
     const promptHash = createHash2("sha256").update(renderedTask).digest("hex").slice(0, 16);
     await hooks.emit("post_render", invocationId, metadata.name, metadata.version, {
       prompt_hash: promptHash,
@@ -21398,8 +21572,8 @@ Respond like smart caveman. Cut all filler, keep technical substance.
 ---
 `;
     try {
-      const gitnexusMetaPath = resolve3(runCwd, ".gitnexus/meta.json");
-      if (existsSync5(gitnexusMetaPath)) {
+      const gitnexusMetaPath = resolve4(runCwd, ".gitnexus/meta.json");
+      if (existsSync6(gitnexusMetaPath)) {
         agentsMd += `
 
 ---
@@ -21452,8 +21626,8 @@ ${memoryInjection.block}
           memoryTokens = memoryInjection.estimatedTokens;
         }
         try {
-          const gitnexusMetaPath = resolve3(runCwd, ".gitnexus/meta.json");
-          if (existsSync5(gitnexusMetaPath)) {
+          const gitnexusMetaPath = resolve4(runCwd, ".gitnexus/meta.json");
+          if (existsSync6(gitnexusMetaPath)) {
             const symbolCandidates = (beadForMemory.title.match(/\b(?:[A-Z][a-z0-9]+(?:[A-Z][a-z0-9]+)+|[a-z]+[A-Z][A-Za-z0-9]*)\b/g) ?? []).slice(0, 2);
             const summaries = [];
             for (const symbol of symbolCandidates) {
@@ -21503,6 +21677,35 @@ ${summaries.join(`
         }
       })
     });
+    const mandatoryRulesInjection = (() => {
+      if (!mandatoryRulesBlock.trim())
+        return null;
+      const setsLoaded = mandatoryRulesBlock.match(/^###\s+(.+)$/gm)?.map((line) => line.replace(/^###\s+/, "").trim()) ?? [];
+      const ruleCount = (mandatoryRulesBlock.match(/^- \[[^\]]+\]/gm) ?? []).length;
+      const payload = {
+        source: "mandatory_rules_injection",
+        data: {
+          sets_loaded: setsLoaded,
+          rules_count: ruleCount,
+          inline_rules_count: ruleCount,
+          globals_disabled: false,
+          token_estimate: estimateInjectedTokens(mandatoryRulesBlock)
+        }
+      };
+      return {
+        payload,
+        summary: JSON.stringify({
+          kind: "meta",
+          ...payload
+        })
+      };
+    })();
+    if (mandatoryRulesInjection) {
+      onEvent?.("meta", {
+        ...mandatoryRulesInjection.payload,
+        summary: mandatoryRulesInjection.summary
+      });
+    }
     if (metadata.name === "reviewer" && options.reusedFromJobId) {
       const reviewerDiffContext = buildReviewerDiffContext(runCwd);
       agentsMd += buildReviewerDiffInstruction(reviewerDiffContext);
@@ -21723,6 +21926,7 @@ var PERMISSION_GATED_TOOLS, RETRY_BASE_DELAY_MS = 1000, RETRY_MAX_JITTER = 0.2,
 var init_runner = __esm(() => {
   init_session();
   init_circuitBreaker();
+  init_mandatory_rules();
   init_beads();
   init_memory_retrieval();
   PERMISSION_GATED_TOOLS = {
@@ -21964,16 +22168,16 @@ __export(exports_version, {
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
 import { dirname as dirname4, join as join7 } from "path";
-import { existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 async function run2() {
   const req = createRequire(import.meta.url);
   const here = dirname4(fileURLToPath(import.meta.url));
   const bundlePkgPath = join7(here, "..", "package.json");
   const sourcePkgPath = join7(here, "..", "..", "package.json");
   let pkg;
-  if (existsSync6(bundlePkgPath)) {
+  if (existsSync7(bundlePkgPath)) {
     pkg = req("../package.json");
-  } else if (existsSync6(sourcePkgPath)) {
+  } else if (existsSync7(sourcePkgPath)) {
     pkg = req("../../package.json");
   } else {
     console.error("Cannot find package.json");
@@ -22121,6 +22325,17 @@ function mapCallbackEventToTimelineEvent(callbackEvent, context) {
         backend: "injected",
         ...context.memoryInjection ? { memory_injection: context.memoryInjection } : {}
       };
+    case "meta": {
+      const payload = context.metaPayload;
+      return {
+        t,
+        type: TIMELINE_EVENT_TYPES.META,
+        model: payload?.model ?? "meta",
+        backend: payload?.backend ?? "injected",
+        ...payload?.source ? { source: payload.source } : {},
+        ...payload?.data ? { data: payload.data } : {}
+      };
+    }
     case "text":
       return {
         t,
@@ -22400,7 +22615,7 @@ var init_epic_lifecycle = __esm(() => {
 });
 
 // src/specialist/process-liveness.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 function isValidPid(pid) {
   return Number.isInteger(pid) && pid > 0;
 }
@@ -22414,7 +22629,7 @@ function isAliveBySignal(pid) {
 }
 function parseBootTimeMs() {
   try {
-    const procStat = readFileSync4("/proc/stat", "utf-8");
+    const procStat = readFileSync5("/proc/stat", "utf-8");
     const bootLine = procStat.split(`
 `).find((line) => line.startsWith("btime "));
     if (!bootLine)
@@ -22429,7 +22644,7 @@ function parseBootTimeMs() {
 }
 function parseProcessStartTimeMs(pid) {
   try {
-    const statRaw = readFileSync4(`/proc/${pid}/stat`, "utf-8");
+    const statRaw = readFileSync5(`/proc/${pid}/stat`, "utf-8");
     const closeParenIndex = statRaw.lastIndexOf(")");
     if (closeParenIndex < 0)
       return;
@@ -22791,12 +23006,12 @@ var init_tmux_utils = () => {};
 import {
   appendFileSync,
   closeSync,
-  existsSync as existsSync7,
+  existsSync as existsSync8,
   fsyncSync,
   mkdirSync as mkdirSync3,
   openSync,
   readdirSync,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   renameSync,
   rmSync,
   statSync as statSync2,
@@ -23136,8 +23351,8 @@ class Supervisor {
     } finally {
       this.pendingSqliteOperations -= 1;
       if (this.pendingSqliteOperations === 0) {
-        for (const resolve4 of this.pendingSqliteDrainResolvers) {
-          resolve4();
+        for (const resolve5 of this.pendingSqliteDrainResolvers) {
+          resolve5();
         }
         this.pendingSqliteDrainResolvers.clear();
       }
@@ -23146,8 +23361,8 @@ class Supervisor {
   async waitForPendingSqliteOperations() {
     if (this.pendingSqliteOperations === 0)
       return;
-    await new Promise((resolve4) => {
-      this.pendingSqliteDrainResolvers.add(resolve4);
+    await new Promise((resolve5) => {
+      this.pendingSqliteDrainResolvers.add(resolve5);
     });
   }
   async dispose() {
@@ -23207,10 +23422,10 @@ class Supervisor {
       }
     }
     const path = this.statusPath(id);
-    if (!existsSync7(path))
+    if (!existsSync8(path))
       return null;
     try {
-      const status = JSON.parse(readFileSync5(path, "utf-8"));
+      const status = JSON.parse(readFileSync6(path, "utf-8"));
       return this.withComputedLiveness(status);
     } catch {
       return null;
@@ -23244,15 +23459,15 @@ class Supervisor {
         console.warn(`[supervisor] SQLite listStatuses failed, falling back to file state: ${String(error2)}`);
       }
     }
-    if (!existsSync7(this.resolvedJobsDir))
+    if (!existsSync8(this.resolvedJobsDir))
       return [];
     const jobs = [];
     for (const entry of readdirSync(this.resolvedJobsDir)) {
       const path = join8(this.resolvedJobsDir, entry, "status.json");
-      if (!existsSync7(path))
+      if (!existsSync8(path))
         continue;
       try {
-        const status = JSON.parse(readFileSync5(path, "utf-8"));
+        const status = JSON.parse(readFileSync6(path, "utf-8"));
         jobs.push(this.withComputedLiveness(status));
       } catch {}
     }
@@ -23326,7 +23541,7 @@ class Supervisor {
     }
   }
   gc() {
-    if (!existsSync7(this.resolvedJobsDir))
+    if (!existsSync8(this.resolvedJobsDir))
       return;
     const cutoff = Date.now() - JOB_TTL_DAYS * 86400000;
     for (const entry of readdirSync(this.resolvedJobsDir)) {
@@ -23341,7 +23556,7 @@ class Supervisor {
     }
   }
   crashRecovery() {
-    if (!existsSync7(this.resolvedJobsDir))
+    if (!existsSync8(this.resolvedJobsDir))
       return;
     const thresholds = {
       ...STALL_DETECTION_DEFAULTS,
@@ -23350,10 +23565,10 @@ class Supervisor {
     const now = Date.now();
     for (const entry of readdirSync(this.resolvedJobsDir)) {
       const statusPath = join8(this.resolvedJobsDir, entry, "status.json");
-      if (!existsSync7(statusPath))
+      if (!existsSync8(statusPath))
         continue;
       try {
-        const s = JSON.parse(readFileSync5(statusPath, "utf-8"));
+        const s = JSON.parse(readFileSync6(statusPath, "utf-8"));
         if (s.status === "running" || s.status === "starting") {
           if (!s.pid)
             continue;
@@ -23574,8 +23789,8 @@ class Supervisor {
     let keepAliveExitResolved = false;
     let isReadOnlySpecialist = false;
     let resolveKeepAliveExit;
-    const keepAliveExitPromise = new Promise((resolve4) => {
-      resolveKeepAliveExit = resolve4;
+    const keepAliveExitPromise = new Promise((resolve5) => {
+      resolveKeepAliveExit = resolve5;
     });
     const finishKeepAlive = (exit) => {
       if (keepAliveExitResolved)
@@ -23817,29 +24032,35 @@ ${appendError}
         }
         const toolCallId = details?.toolCallId;
         const toolState = toolCallId ? activeToolCalls.get(toolCallId) : latestUncorrelatedToolState;
-        const memoryInjection = (() => {
-          if (eventType !== "memory_injection" || !details?.summary)
+        const parsedMeta = (() => {
+          if (eventType !== "memory_injection" && eventType !== "meta" || !details?.summary)
             return;
           try {
-            const parsed = JSON.parse(details.summary);
-            const injection = parsed.memory_injection;
-            if (!injection)
-              return;
-            return {
-              static_tokens: injection.static_tokens ?? 0,
-              memory_tokens: injection.memory_tokens ?? 0,
-              gitnexus_tokens: injection.gitnexus_tokens ?? 0,
-              total_tokens: injection.total_tokens ?? 0
-            };
+            return JSON.parse(details.summary);
           } catch {
             return;
           }
         })();
-        if (eventType === "memory_injection" && memoryInjection) {
+        const metaDetails = details;
+        const memoryInjection = parsedMeta?.memory_injection ? {
+          static_tokens: parsedMeta.memory_injection.static_tokens ?? 0,
+          memory_tokens: parsedMeta.memory_injection.memory_tokens ?? 0,
+          gitnexus_tokens: parsedMeta.memory_injection.gitnexus_tokens ?? 0,
+          total_tokens: parsedMeta.memory_injection.total_tokens ?? 0
+        } : undefined;
+        const mandatoryRulesInjection = parsedMeta?.source === "mandatory_rules_injection" && parsedMeta.data ? {
+          sets_loaded: parsedMeta.data.sets_loaded ?? [],
+          rules_count: parsedMeta.data.rules_count ?? 0,
+          inline_rules_count: parsedMeta.data.inline_rules_count ?? 0,
+          globals_disabled: parsedMeta.data.globals_disabled ?? false,
+          token_estimate: parsedMeta.data.token_estimate ?? 0
+        } : undefined;
+        if (memoryInjection || mandatoryRulesInjection) {
           setStatus({
             startup_context: {
               ...statusSnapshot.startup_context ?? {},
-              memory_injection: memoryInjection
+              ...memoryInjection ? { memory_injection: memoryInjection } : {},
+              ...mandatoryRulesInjection ? { mandatory_rules_injection: mandatoryRulesInjection } : {}
             }
           });
         }
@@ -23871,7 +24092,13 @@ ${appendError}
             extension: details?.extension,
             errorMessage: details?.errorMessage
           },
-          memoryInjection
+          memoryInjection,
+          metaPayload: eventType === "meta" ? {
+            model: details?.model,
+            backend: metaDetails?.backend,
+            source: metaDetails?.source,
+            data: metaDetails?.data
+          } : undefined
         });
         if (timelineEvent) {
           appendTimelineEvent(timelineEvent);
@@ -23956,7 +24183,7 @@ ${appendError}
         setStatus({ bead_id: beadId });
       }, (fn) => {
         steerFn = fn;
-        if (!existsSync7(fifoPath))
+        if (!existsSync8(fifoPath))
           return;
         fifoFd = openSync(fifoPath, "r+");
         fifoReadStream = createReadStream("", { fd: fifoFd, autoClose: false });
@@ -24252,7 +24479,7 @@ ${appendError}
       } catch {}
       closeSync(eventsFd);
       try {
-        if (existsSync7(fifoPath))
+        if (existsSync8(fifoPath))
           rmSync(fifoPath);
       } catch {}
       if (statusSnapshot.tmux_session) {
@@ -24301,7 +24528,7 @@ __export(exports_list, {
   ArgParseError: () => ArgParseError
 });
 import { spawnSync as spawnSync7 } from "child_process";
-import { existsSync as existsSync8, readdirSync as readdirSync2, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync9, readdirSync as readdirSync2, readFileSync as readFileSync7 } from "fs";
 import { join as join9 } from "path";
 import readline from "readline";
 function permissionBadge(permission) {
@@ -24334,14 +24561,14 @@ function toLiveJob(status) {
 }
 function readJobStatus(statusPath) {
   try {
-    return JSON.parse(readFileSync6(statusPath, "utf-8"));
+    return JSON.parse(readFileSync7(statusPath, "utf-8"));
   } catch {
     return null;
   }
 }
 function listLiveJobs(showDead) {
   const jobsDir = join9(process.cwd(), ".specialists", "jobs");
-  if (!existsSync8(jobsDir))
+  if (!existsSync9(jobsDir))
     return [];
   const jobs = readdirSync2(jobsDir).map((entry) => toLiveJob(readJobStatus(join9(jobsDir, entry, "status.json")))).filter((job) => job !== null).filter((job) => showDead || !job.isDead).sort((a, b) => b.startedAtMs - a.startedAtMs);
   return jobs;
@@ -24360,7 +24587,7 @@ function renderLiveSelector(jobs, selectedIndex) {
   ];
 }
 function selectLiveJob(jobs) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const input = process.stdin;
     const output = process.stdout;
     const wasRawMode = input.isTTY ? input.isRaw : false;
@@ -24376,7 +24603,7 @@ function selectLiveJob(jobs) {
         readline.moveCursor(output, 0, -renderedLineCount);
         readline.clearScreenDown(output);
       }
-      resolve4(selected);
+      resolve5(selected);
     };
     const render = () => {
       if (renderedLineCount > 0) {
@@ -24903,9 +25130,9 @@ var exports_init = {};
 __export(exports_init, {
   run: () => run6
 });
-import { copyFileSync, cpSync, existsSync as existsSync9, lstatSync, mkdirSync as mkdirSync4, readdirSync as readdirSync3, readFileSync as readFileSync7, readlinkSync, renameSync as renameSync2, symlinkSync, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
+import { copyFileSync, cpSync, existsSync as existsSync10, lstatSync, mkdirSync as mkdirSync4, readdirSync as readdirSync3, readFileSync as readFileSync8, readlinkSync, renameSync as renameSync2, symlinkSync, unlinkSync, writeFileSync as writeFileSync4 } from "fs";
 import { spawnSync as spawnSync9 } from "child_process";
-import { basename as basename3, dirname as dirname5, join as join10, relative, resolve as resolve4 } from "path";
+import { basename as basename3, dirname as dirname5, join as join10, relative, resolve as resolve5 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function ok(msg) {
   console.log(`  ${green4("\u2713")} ${msg}`);
@@ -24920,7 +25147,7 @@ function isInstalled(bin) {
   return spawnSync9("which", [bin], { encoding: "utf8", timeout: 2000 }).status === 0;
 }
 function assertXtrmPrerequisites(cwd) {
-  const hasXtrmDir = existsSync9(join10(cwd, ".xtrm"));
+  const hasXtrmDir = existsSync10(join10(cwd, ".xtrm"));
   const hasXtCli = isInstalled("xt");
   if (hasXtrmDir && hasXtCli)
     return;
@@ -24942,10 +25169,10 @@ function warnMissingOptionalPrerequisites() {
   }
 }
 function loadJson(path, fallback) {
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return structuredClone(fallback);
   try {
-    return JSON.parse(readFileSync7(path, "utf-8"));
+    return JSON.parse(readFileSync8(path, "utf-8"));
   } catch {
     return structuredClone(fallback);
   }
@@ -24957,19 +25184,19 @@ function saveJson(path, value) {
 function resolvePackagePath(relativePath) {
   const configPath = `config/${relativePath}`;
   let resolved = fileURLToPath2(new URL(`../${configPath}`, import.meta.url));
-  if (existsSync9(resolved))
+  if (existsSync10(resolved))
     return resolved;
   resolved = fileURLToPath2(new URL(`../../${configPath}`, import.meta.url));
-  if (existsSync9(resolved))
+  if (existsSync10(resolved))
     return resolved;
   return null;
 }
 function migrateLegacySpecialists(cwd, scope) {
   const sourceDir = join10(cwd, ".specialists", scope, "specialists");
-  if (!existsSync9(sourceDir))
+  if (!existsSync10(sourceDir))
     return;
   const targetDir = join10(cwd, ".specialists", scope);
-  if (!existsSync9(targetDir)) {
+  if (!existsSync10(targetDir)) {
     mkdirSync4(targetDir, { recursive: true });
   }
   const files = readdirSync3(sourceDir).filter((f) => f.endsWith(".specialist.json") || f.endsWith(".specialist.json"));
@@ -24980,7 +25207,7 @@ function migrateLegacySpecialists(cwd, scope) {
   for (const file of files) {
     const src = join10(sourceDir, file);
     const dest = join10(targetDir, file);
-    if (existsSync9(dest)) {
+    if (existsSync10(dest)) {
       skipped++;
       continue;
     }
@@ -25006,7 +25233,7 @@ function copyCanonicalSpecialists(cwd) {
     skip("no specialist files found in package");
     return;
   }
-  if (!existsSync9(targetDir)) {
+  if (!existsSync10(targetDir)) {
     mkdirSync4(targetDir, { recursive: true });
   }
   let copied = 0;
@@ -25014,7 +25241,7 @@ function copyCanonicalSpecialists(cwd) {
   for (const file of files) {
     const src = join10(sourceDir, file);
     const dest = join10(targetDir, file);
-    if (existsSync9(dest)) {
+    if (existsSync10(dest)) {
       copyFileSync(src, dest);
       refreshed++;
     } else {
@@ -25041,7 +25268,7 @@ function copyCanonicalNodeConfigs(cwd) {
     skip("no node config files found in package");
     return;
   }
-  if (!existsSync9(targetDir)) {
+  if (!existsSync10(targetDir)) {
     mkdirSync4(targetDir, { recursive: true });
   }
   let copied = 0;
@@ -25049,7 +25276,7 @@ function copyCanonicalNodeConfigs(cwd) {
   for (const file of files) {
     const src = join10(sourceDir, file);
     const dest = join10(targetDir, file);
-    if (existsSync9(dest)) {
+    if (existsSync10(dest)) {
       copyFileSync(src, dest);
       refreshed++;
     } else {
@@ -25088,7 +25315,7 @@ function installProjectHooks(cwd) {
   for (const file of hooks) {
     const src = join10(sourceDir, file);
     const xtrmDest = join10(targetDir, file);
-    if (existsSync9(xtrmDest)) {
+    if (existsSync10(xtrmDest)) {
       skippedCopies++;
     } else {
       copyFileSync(src, xtrmDest);
@@ -25096,7 +25323,7 @@ function installProjectHooks(cwd) {
     }
     const claudeHookPath = join10(claudeHooksDir, file);
     const relativeTarget = `../../.xtrm/hooks/specialists/${file}`;
-    if (existsSync9(claudeHookPath)) {
+    if (existsSync10(claudeHookPath)) {
       const stats = lstatSync(claudeHookPath);
       if (!stats.isSymbolicLink()) {
         unlinkSync(claudeHookPath);
@@ -25104,7 +25331,7 @@ function installProjectHooks(cwd) {
         rewiredLinks++;
         continue;
       }
-      const currentTarget = resolve4(dirname5(claudeHookPath), readlinkSync(claudeHookPath));
+      const currentTarget = resolve5(dirname5(claudeHookPath), readlinkSync(claudeHookPath));
       if (currentTarget !== xtrmDest) {
         unlinkSync(claudeHookPath);
         symlinkSync(relativeTarget, claudeHookPath);
@@ -25131,7 +25358,7 @@ function installProjectHooks(cwd) {
 function ensureProjectHookWiring(cwd) {
   const settingsPath = join10(cwd, ".claude", "settings.json");
   const settingsDir = join10(cwd, ".claude");
-  if (!existsSync9(settingsDir)) {
+  if (!existsSync10(settingsDir)) {
     mkdirSync4(settingsDir, { recursive: true });
   }
   const settings = loadJson(settingsPath, {});
@@ -25167,7 +25394,7 @@ function ensureProjectHookWiring(cwd) {
   }
 }
 function ensureRootSymlink(rootPath, expectedTargetPath) {
-  if (!existsSync9(rootPath)) {
+  if (!existsSync10(rootPath)) {
     mkdirSync4(dirname5(rootPath), { recursive: true });
     const relTarget = relative(dirname5(rootPath), expectedTargetPath);
     symlinkSync(relTarget, rootPath);
@@ -25179,14 +25406,14 @@ function ensureRootSymlink(rootPath, expectedTargetPath) {
     throw new Error(`${rootPath} must be a symlink to ${expectedTargetPath}. Aborting.`);
   }
   const linkTarget = readlinkSync(rootPath);
-  const resolvedTarget = resolve4(dirname5(rootPath), linkTarget);
-  const resolvedExpected = resolve4(expectedTargetPath);
+  const resolvedTarget = resolve5(dirname5(rootPath), linkTarget);
+  const resolvedExpected = resolve5(expectedTargetPath);
   if (resolvedTarget === resolvedExpected) {
     return;
   }
   const legacyTargets = [
-    resolve4(expectedTargetPath, "claude"),
-    resolve4(expectedTargetPath, "pi")
+    resolve5(expectedTargetPath, "claude"),
+    resolve5(expectedTargetPath, "pi")
   ];
   if (legacyTargets.includes(resolvedTarget)) {
     unlinkSync(rootPath);
@@ -25213,14 +25440,14 @@ function ensureActiveSkillSymlink(defaultSkillPath, activeLinkPath) {
   if (!stats.isSymbolicLink()) {
     throw new Error(`${activeLinkPath} already exists and is not a symlink.`);
   }
-  const currentTarget = resolve4(dirname5(activeLinkPath), readlinkSync(activeLinkPath));
-  if (currentTarget !== resolve4(defaultSkillPath)) {
+  const currentTarget = resolve5(dirname5(activeLinkPath), readlinkSync(activeLinkPath));
+  if (currentTarget !== resolve5(defaultSkillPath)) {
     throw new Error(`${activeLinkPath} points to an unexpected target.`);
   }
 }
 function installProjectSkills(cwd, syncSkills) {
   const xtrmRoot = join10(cwd, ".xtrm");
-  if (!existsSync9(xtrmRoot)) {
+  if (!existsSync10(xtrmRoot)) {
     throw new Error(".xtrm/ is missing. Install xtrm first, then run specialists init.");
   }
   const sourceDir = resolvePackagePath("skills");
@@ -25244,7 +25471,7 @@ function installProjectSkills(cwd, syncSkills) {
   for (const skill of skills) {
     const src = join10(sourceDir, skill);
     const defaultSkillPath = join10(defaultRoot, skill);
-    if (existsSync9(defaultSkillPath)) {
+    if (existsSync10(defaultSkillPath)) {
       if (syncSkills) {
         cpSync(src, defaultSkillPath, { recursive: true, force: true });
         refreshed++;
@@ -25266,7 +25493,7 @@ function createSpecialistsDirs(cwd) {
   const userDir = join10(cwd, ".specialists", "user");
   let created = 0;
   for (const dir of [defaultDir, userDir]) {
-    if (!existsSync9(dir)) {
+    if (!existsSync10(dir)) {
       mkdirSync4(dir, { recursive: true });
       created++;
     }
@@ -25282,7 +25509,7 @@ function createRuntimeDirs(cwd) {
   ];
   let created = 0;
   for (const dir of runtimeDirs) {
-    if (!existsSync9(dir)) {
+    if (!existsSync10(dir)) {
       mkdirSync4(dir, { recursive: true });
       created++;
     }
@@ -25306,7 +25533,7 @@ function ensureProjectMcp(cwd) {
 }
 function ensureGitignore(cwd) {
   const gitignorePath = join10(cwd, ".gitignore");
-  const existing = existsSync9(gitignorePath) ? readFileSync7(gitignorePath, "utf-8") : "";
+  const existing = existsSync10(gitignorePath) ? readFileSync8(gitignorePath, "utf-8") : "";
   let added = 0;
   const lines = existing.split(`
 `);
@@ -25331,7 +25558,7 @@ function ensureObservabilityDb(cwd) {
     skip("observability DB path resolves inside jobs directory \u2014 skipped");
     return;
   }
-  const alreadyExists = existsSync9(location.dbPath);
+  const alreadyExists = existsSync10(location.dbPath);
   if (alreadyExists) {
     skip("observability database already exists (not touched)");
     return;
@@ -25352,8 +25579,8 @@ function ensureObservabilityDb(cwd) {
 }
 function ensureAgentsMd(cwd) {
   const agentsPath = join10(cwd, "AGENTS.md");
-  if (existsSync9(agentsPath)) {
-    const existing = readFileSync7(agentsPath, "utf-8");
+  if (existsSync10(agentsPath)) {
+    const existing = readFileSync8(agentsPath, "utf-8");
     if (existing.includes(AGENTS_MARKER)) {
       skip("AGENTS.md already has Specialists section");
     } else {
@@ -25368,10 +25595,10 @@ function ensureAgentsMd(cwd) {
   }
 }
 function readJsonObject(path) {
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return {};
   try {
-    return JSON.parse(readFileSync7(path, "utf-8"));
+    return JSON.parse(readFileSync8(path, "utf-8"));
   } catch {
     return {};
   }
@@ -25399,14 +25626,14 @@ function hasHookCommand(settings, eventName, command) {
 function validateInitPostconditions(cwd) {
   const warnings = [];
   const xtrmHooksDir = join10(cwd, ".xtrm", "hooks", "specialists");
-  const xtrmHookFiles = existsSync9(xtrmHooksDir) ? readdirSync3(xtrmHooksDir).filter((file) => file.endsWith(".mjs")) : [];
+  const xtrmHookFiles = existsSync10(xtrmHooksDir) ? readdirSync3(xtrmHooksDir).filter((file) => file.endsWith(".mjs")) : [];
   if (xtrmHookFiles.length === 0) {
     warnings.push(".xtrm/hooks/specialists/ is missing or has no .mjs hooks");
   }
   const claudeHooksDir = join10(cwd, ".claude", "hooks");
   for (const hookFile of xtrmHookFiles) {
     const claudeHookPath = join10(claudeHooksDir, hookFile);
-    if (!existsSync9(claudeHookPath)) {
+    if (!existsSync10(claudeHookPath)) {
       warnings.push(`.claude/hooks/${hookFile} is missing`);
       continue;
     }
@@ -25415,8 +25642,8 @@ function validateInitPostconditions(cwd) {
       warnings.push(`.claude/hooks/${hookFile} is not a symlink`);
       continue;
     }
-    const expectedTarget = resolve4(xtrmHooksDir, hookFile);
-    const resolvedTarget = resolve4(dirname5(claudeHookPath), readlinkSync(claudeHookPath));
+    const expectedTarget = resolve5(xtrmHooksDir, hookFile);
+    const resolvedTarget = resolve5(dirname5(claudeHookPath), readlinkSync(claudeHookPath));
     if (resolvedTarget !== expectedTarget) {
       warnings.push(`.claude/hooks/${hookFile} points to unexpected target`);
     }
@@ -25441,12 +25668,12 @@ function validateInitPostconditions(cwd) {
   }
   const runtimeDirs = [join10(cwd, ".specialists", "jobs"), join10(cwd, ".specialists", "ready")];
   for (const runtimeDir of runtimeDirs) {
-    if (!existsSync9(runtimeDir)) {
+    if (!existsSync10(runtimeDir)) {
       warnings.push(`${relative(cwd, runtimeDir)} is missing`);
     }
   }
   const defaultSkillsRoot = join10(cwd, ".xtrm", "skills", "default");
-  const defaultSkills = existsSync9(defaultSkillsRoot) ? readdirSync3(defaultSkillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()) : [];
+  const defaultSkills = existsSync10(defaultSkillsRoot) ? readdirSync3(defaultSkillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()) : [];
   if (defaultSkills.length === 0) {
     warnings.push(".xtrm/skills/default/ is missing or has no skill directories");
   }
@@ -25461,7 +25688,7 @@ function validateInitPostconditions(cwd) {
     }
   ];
   for (const symlink of rootSymlinks) {
-    if (!existsSync9(symlink.linkPath)) {
+    if (!existsSync10(symlink.linkPath)) {
       warnings.push(`${relative(cwd, symlink.linkPath)} is missing`);
       continue;
     }
@@ -25470,8 +25697,8 @@ function validateInitPostconditions(cwd) {
       warnings.push(`${relative(cwd, symlink.linkPath)} is not a symlink`);
       continue;
     }
-    const resolvedTarget = resolve4(dirname5(symlink.linkPath), readlinkSync(symlink.linkPath));
-    if (resolvedTarget !== resolve4(symlink.expectedTarget)) {
+    const resolvedTarget = resolve5(dirname5(symlink.linkPath), readlinkSync(symlink.linkPath));
+    if (resolvedTarget !== resolve5(symlink.expectedTarget)) {
       warnings.push(`${relative(cwd, symlink.linkPath)} points to an unexpected target`);
     }
   }
@@ -25645,8 +25872,8 @@ var exports_db = {};
 __export(exports_db, {
   run: () => run8
 });
-import { existsSync as existsSync10, mkdirSync as mkdirSync5, readdirSync as readdirSync4, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
-import { dirname as dirname6, join as join11, resolve as resolve5 } from "path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync5, readdirSync as readdirSync4, readFileSync as readFileSync9, writeFileSync as writeFileSync5 } from "fs";
+import { dirname as dirname6, join as join11, resolve as resolve6 } from "path";
 function formatBytes(bytes) {
   if (bytes < 1024)
     return `${bytes} B`;
@@ -25795,7 +26022,7 @@ function parsePruneOptions(argv) {
 }
 function parseStatusFile(jobDirectoryPath, fallbackJobId) {
   const statusPath = join11(jobDirectoryPath, "status.json");
-  const statusRaw = readFileSync8(statusPath, "utf-8");
+  const statusRaw = readFileSync9(statusPath, "utf-8");
   const parsed = JSON.parse(statusRaw);
   const jobId = typeof parsed.id === "string" && parsed.id.length > 0 ? parsed.id : fallbackJobId;
   const specialist = typeof parsed.specialist === "string" && parsed.specialist.length > 0 ? parsed.specialist : "unknown";
@@ -25810,9 +26037,9 @@ function parseStatusFile(jobDirectoryPath, fallbackJobId) {
   };
 }
 function replayEvents(eventsPath, sqliteClient, status) {
-  if (!existsSync10(eventsPath))
+  if (!existsSync11(eventsPath))
     return 0;
-  const rawContent = readFileSync8(eventsPath, "utf-8");
+  const rawContent = readFileSync9(eventsPath, "utf-8");
   const lines = rawContent.split(`
 `).map((line) => line.trim()).filter((line) => line.length > 0);
   let importedEvents = 0;
@@ -25838,7 +26065,7 @@ function runBackfill(options) {
   };
   try {
     const jobsDirectoryPath = resolveJobsDir(process.cwd());
-    if (!existsSync10(jobsDirectoryPath)) {
+    if (!existsSync11(jobsDirectoryPath)) {
       console.log("No jobs directory found. Nothing to backfill.");
       return;
     }
@@ -25848,7 +26075,7 @@ function runBackfill(options) {
         continue;
       const jobDirectoryPath = join11(jobsDirectoryPath, jobEntry.name);
       const statusPath = join11(jobDirectoryPath, "status.json");
-      if (!existsSync10(statusPath))
+      if (!existsSync11(statusPath))
         continue;
       try {
         const status = parseStatusFile(jobDirectoryPath, jobEntry.name);
@@ -25961,14 +26188,14 @@ ${bold7("specialists db prune")}
   }
 }
 function parseBenchmarkExportOptions(argv) {
-  const defaultOutput = resolve5(process.cwd(), ".specialists/benchmarks/executor-benchmark-rows.jsonl");
+  const defaultOutput = resolve6(process.cwd(), ".specialists/benchmarks/executor-benchmark-rows.jsonl");
   let outputPath = defaultOutput;
   let epicId;
   let includePrepJobs = false;
   for (let i = 0;i < argv.length; i += 1) {
     const argument = argv[i];
     if (argument === "--output" && argv[i + 1]) {
-      outputPath = resolve5(process.cwd(), argv[i + 1]);
+      outputPath = resolve6(process.cwd(), argv[i + 1]);
       i += 1;
       continue;
     }
@@ -26201,7 +26428,7 @@ __export(exports_validate, {
   ArgParseError: () => ArgParseError3
 });
 import { readFile as readFile3 } from "fs/promises";
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import { join as join12 } from "path";
 function parseArgs4(argv) {
   const name = argv[0];
@@ -26221,11 +26448,11 @@ function findSpecialistFile(name) {
   ];
   for (const dir of scanDirs) {
     const jsonCandidate = join12(dir, `${name}.specialist.json`);
-    if (existsSync11(jsonCandidate)) {
+    if (existsSync12(jsonCandidate)) {
       return jsonCandidate;
     }
     const yamlCandidate = join12(dir, `${name}.specialist.json`);
-    if (existsSync11(yamlCandidate)) {
+    if (existsSync12(yamlCandidate)) {
       process.stderr.write(`[specialists] DEPRECATED: YAML specialist config detected at ${yamlCandidate}. Please migrate to .specialist.json
 `);
       return yamlCandidate;
@@ -26320,7 +26547,7 @@ __export(exports_edit, {
   run: () => run10
 });
 import { spawnSync as spawnSync10 } from "child_process";
-import { existsSync as existsSync12, readdirSync as readdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync13, readdirSync as readdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync6 } from "fs";
 import { join as join13 } from "path";
 function loadPresets() {
   const paths = [
@@ -26328,9 +26555,9 @@ function loadPresets() {
     join13(process.cwd(), "config", "specialists", "presets.json")
   ];
   for (const p of paths) {
-    if (existsSync12(p)) {
+    if (existsSync13(p)) {
       try {
-        const data = JSON.parse(readFileSync9(p, "utf-8"));
+        const data = JSON.parse(readFileSync10(p, "utf-8"));
         return data;
       } catch {
         return {};
@@ -26528,7 +26755,7 @@ ${usage()}`);
   if (action === "get" && (pendingArrayOp || filePath)) {
     fail("Error: --get cannot be combined with --append/--remove/--file");
   }
-  if (filePath && !existsSync12(filePath)) {
+  if (filePath && !existsSync13(filePath)) {
     fail(`Error: file not found: ${filePath}`);
   }
   return { name, all, scope, dryRun, action, path, value, filePath, preset };
@@ -26663,7 +26890,7 @@ function formatOutputValue(value) {
 }
 function openAllConfigSpecialistsInEditor() {
   const configDir = join13(process.cwd(), "config", "specialists");
-  if (!existsSync12(configDir)) {
+  if (!existsSync13(configDir)) {
     fail(`Error: missing directory: ${configDir}`);
   }
   const files = readdirSync5(configDir).filter((file) => file.endsWith(".specialist.json")).sort().map((file) => join13(configDir, file));
@@ -26683,7 +26910,7 @@ function getRawValue(args, resolvedPath) {
   if (!MULTILINE_FILE_PATHS.has(resolvedPath.normalizedPath)) {
     fail(`Error: --file is only supported for: ${Array.from(MULTILINE_FILE_PATHS).join(", ")}`);
   }
-  return readFileSync9(args.filePath, "utf-8");
+  return readFileSync10(args.filePath, "utf-8");
 }
 function getAtPath(root, segments) {
   let current = root;
@@ -26793,7 +27020,7 @@ async function run10() {
     }
     const targets2 = await resolveTargets(args);
     for (const target of targets2) {
-      const raw = readFileSync9(target.filePath, "utf-8");
+      const raw = readFileSync10(target.filePath, "utf-8");
       const doc2 = JSON.parse(raw);
       for (const [fieldPath, fieldValue] of Object.entries(preset.fields)) {
         const resolved = resolvePath2(fieldPath);
@@ -26819,7 +27046,7 @@ async function run10() {
     fail("Error: no specialists found");
   }
   for (const target of targets) {
-    const raw = readFileSync9(target.filePath, "utf-8");
+    const raw = readFileSync10(target.filePath, "utf-8");
     let doc2;
     try {
       const parsed = JSON.parse(raw);
@@ -26962,8 +27189,8 @@ var init_config = __esm(() => {
 });
 
 // src/specialist/worktree.ts
-import { existsSync as existsSync13, symlinkSync as symlinkSync2, mkdirSync as mkdirSync6 } from "fs";
-import { join as join14, resolve as resolve6 } from "path";
+import { existsSync as existsSync14, symlinkSync as symlinkSync2, mkdirSync as mkdirSync6 } from "fs";
+import { join as join14, resolve as resolve7 } from "path";
 import { spawnSync as spawnSync11, execFileSync as execFileSync2 } from "child_process";
 function deriveBranchName(beadId, specialistName) {
   return `feature/${beadId}-${slugify(specialistName)}`;
@@ -26996,11 +27223,11 @@ function provisionWorktree(options) {
   const branch = deriveBranchName(options.beadId, options.specialistName);
   const existingPath = findExistingWorktree(branch, cwd);
   if (existingPath) {
-    return { branch, worktreePath: resolve6(existingPath), reused: true };
+    return { branch, worktreePath: resolve7(existingPath), reused: true };
   }
   const worktreeBase = options.worktreeBase ?? join14(commonRoot, ".worktrees", options.beadId);
   const worktreeName = deriveWorktreeName(options.beadId, options.specialistName);
-  const worktreePath = resolve6(join14(worktreeBase, worktreeName));
+  const worktreePath = resolve7(join14(worktreeBase, worktreeName));
   createWorktreeViaBd(worktreePath, branch, commonRoot);
   symlinkPiNpmCache(commonRoot, worktreePath);
   return { branch, worktreePath, reused: false };
@@ -27008,7 +27235,7 @@ function provisionWorktree(options) {
 function symlinkPiNpmCache(commonRoot, worktreePath) {
   const source = join14(commonRoot, ".pi", "npm");
   const target = join14(worktreePath, ".pi", "npm");
-  if (!existsSync13(source) || existsSync13(target))
+  if (!existsSync14(source) || existsSync14(target))
     return;
   try {
     mkdirSync6(join14(worktreePath, ".pi"), { recursive: true });
@@ -27074,7 +27301,7 @@ __export(exports_merge, {
   checkEpicUnresolvedGuard: () => checkEpicUnresolvedGuard,
   assertMainRepoCleanForMerge: () => assertMainRepoCleanForMerge
 });
-import { existsSync as existsSync14, readdirSync as readdirSync6, readFileSync as readFileSync10 } from "fs";
+import { existsSync as existsSync15, readdirSync as readdirSync6, readFileSync as readFileSync11 } from "fs";
 import { spawnSync as spawnSync12 } from "child_process";
 import { join as join15 } from "path";
 function parseOptions(argv) {
@@ -27254,7 +27481,7 @@ Use 'sp epic merge ${membership.epicId}' to publish all chains together, or 'sp
 }
 function readAllJobStatuses() {
   const jobsDir = resolveJobsDir();
-  if (!existsSync14(jobsDir))
+  if (!existsSync15(jobsDir))
     return [];
   const entries = readdirSync6(jobsDir, { withFileTypes: true });
   const statuses = [];
@@ -27262,9 +27489,9 @@ function readAllJobStatuses() {
     if (!entry.isDirectory())
       continue;
     const statusPath = join15(jobsDir, entry.name, "status.json");
-    if (!existsSync14(statusPath))
+    if (!existsSync15(statusPath))
       continue;
-    const parsed = readJson(readFileSync10(statusPath, "utf-8"));
+    const parsed = readJson(readFileSync11(statusPath, "utf-8"));
     if (!parsed || typeof parsed !== "object")
       continue;
     statuses.push(parsed);
@@ -27763,7 +27990,9 @@ function formatToolDetail(event) {
     return `${toolName}: ${dim8("start")}`;
   }
   if (event.phase === "end" && event.is_error) {
-    return `${toolName}: ${red2("error")}`;
+    const summary = event.result_summary?.split(`
+`)[0]?.trim().slice(0, 120);
+    return summary ? `${toolName}: ${red2(summary)}` : `${toolName}: ${red2("error")}`;
   }
   return `${toolName}: ${dim8(event.phase)}`;
 }
@@ -27781,6 +28010,8 @@ function formatEventLine(event, options) {
   if (event.type === "meta") {
     detailParts.push(`model=${event.model}`);
     detailParts.push(`backend=${event.backend}`);
+    if (event.source)
+      detailParts.push(`source=${event.source}`);
   } else if (event.type === "tool") {
     detail = formatToolDetail(event);
   } else if (event.type === "error") {
@@ -27920,7 +28151,7 @@ __export(exports_run, {
   run: () => run13
 });
 import { join as join16 } from "path";
-import { readFileSync as readFileSync11 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 import { randomBytes } from "crypto";
 import { spawn as cpSpawn, execSync as execSync3 } from "child_process";
 async function parseArgs6(argv) {
@@ -28035,13 +28266,13 @@ async function parseArgs6(argv) {
     process.exit(1);
   }
   if (!prompt && !beadId && !process.stdin.isTTY) {
-    prompt = await new Promise((resolve7) => {
+    prompt = await new Promise((resolve8) => {
       let buf = "";
       process.stdin.setEncoding("utf-8");
       process.stdin.on("data", (chunk) => {
         buf += chunk;
       });
-      process.stdin.on("end", () => resolve7(buf.trim()));
+      process.stdin.on("end", () => resolve8(buf.trim()));
     });
   }
   if (!prompt && !beadId && !reuseJobId) {
@@ -28199,7 +28430,7 @@ function startEventTailer(jobId, jobsDir, mode, specialist, beadId) {
   const drain = () => {
     let content;
     try {
-      content = readFileSync11(eventsPath, "utf-8");
+      content = readFileSync12(eventsPath, "utf-8");
     } catch {
       return;
     }
@@ -28300,7 +28531,7 @@ async function run13() {
     const latestPath = join16(jobsDir2, "latest");
     const oldLatest = (() => {
       try {
-        return readFileSync11(latestPath, "utf-8").trim();
+        return readFileSync12(latestPath, "utf-8").trim();
       } catch {
         return "";
       }
@@ -28328,7 +28559,7 @@ async function run13() {
     while (Date.now() < deadline) {
       await new Promise((r) => setTimeout(r, 100));
       try {
-        const current = readFileSync11(latestPath, "utf-8").trim();
+        const current = readFileSync12(latestPath, "utf-8").trim();
         if (current && current !== oldLatest) {
           jobId2 = current;
           break;
@@ -28583,7 +28814,7 @@ var init_node_resolve = __esm(() => {
 });
 
 // src/specialist/job-control.ts
-import { existsSync as existsSync15, readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "fs";
 import { join as join17 } from "path";
 
 class JobControl {
@@ -28615,8 +28846,8 @@ class JobControl {
       }
     };
     let resolveJobId;
-    const jobIdPromise = new Promise((resolve7) => {
-      resolveJobId = resolve7;
+    const jobIdPromise = new Promise((resolve8) => {
+      resolveJobId = resolve8;
     });
     this.supervisor = new Supervisor({
       runner: this.runner,
@@ -28659,10 +28890,10 @@ class JobControl {
         return sqliteResult;
     } catch {}
     const resultPath = this.resultPath(jobId);
-    if (!existsSync15(resultPath))
+    if (!existsSync16(resultPath))
       return null;
     try {
-      return readFileSync12(resultPath, "utf-8");
+      return readFileSync13(resultPath, "utf-8");
     } catch {
       return null;
     }
@@ -28681,7 +28912,7 @@ class JobControl {
       if (deadline !== undefined && Date.now() >= deadline) {
         throw new Error(`Timed out waiting for terminal status for job ${jobId}`);
       }
-      await new Promise((resolve7) => setTimeout(resolve7, backoffMs));
+      await new Promise((resolve8) => setTimeout(resolve8, backoffMs));
       backoffMs = Math.min(backoffMs * 2, MAX_BACKOFF_MS);
     }
   }
@@ -28860,7 +29091,7 @@ function hashOutput(output2, salt) {
   return createHash3("sha256").update(value).digest("hex");
 }
 function sleep2(ms) {
-  return new Promise((resolve7) => setTimeout(resolve7, ms));
+  return new Promise((resolve8) => setTimeout(resolve8, ms));
 }
 function toContextHealth(contextPct) {
   if (contextPct === null)
@@ -30773,10 +31004,10 @@ var exports_node = {};
 __export(exports_node, {
   handleNodeCommand: () => handleNodeCommand
 });
-import { existsSync as existsSync16, readFileSync as readFileSync13, readdirSync as readdirSync7 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync14, readdirSync as readdirSync7 } from "fs";
 import { randomUUID } from "crypto";
 import { spawnSync as spawnSync14 } from "child_process";
-import { basename as basename4, join as join18, resolve as resolve7 } from "path";
+import { basename as basename4, join as join18, resolve as resolve8 } from "path";
 function parseNodeArgs(argv) {
   const command = argv[0];
   const supportedCommands = new Set(["run", "list", "promote", "members", "memory", "stop", "spawn-member", "create-bead", "complete", "wait-phase"]);
@@ -30960,8 +31191,8 @@ function toNodeName(filePath) {
 function discoverNodeConfigs(cwd) {
   const discoveredByName = new Map;
   for (const directory of NODE_DISCOVERY_DIRS) {
-    const absoluteDir = resolve7(cwd, directory.path);
-    if (!existsSync16(absoluteDir))
+    const absoluteDir = resolve8(cwd, directory.path);
+    if (!existsSync17(absoluteDir))
       continue;
     const files = readdirSync7(absoluteDir).filter((fileName) => fileName.endsWith(NODE_CONFIG_SUFFIX));
     for (const fileName of files) {
@@ -30975,8 +31206,8 @@ function discoverNodeConfigs(cwd) {
   return [...discoveredByName.values()].sort((left, right) => left.name.localeCompare(right.name));
 }
 function resolveNodeConfigPath(cwd, input2) {
-  const explicitPath = resolve7(cwd, input2);
-  if (existsSync16(explicitPath)) {
+  const explicitPath = resolve8(cwd, input2);
+  if (existsSync17(explicitPath)) {
     return explicitPath;
   }
   const normalizedName = input2.endsWith(NODE_CONFIG_SUFFIX) ? input2.slice(0, -NODE_CONFIG_SUFFIX.length) : input2;
@@ -31071,7 +31302,7 @@ async function handleNodeRun(args) {
     throw new Error("Observability SQLite DB is unavailable. Run: specialists db setup");
   }
   try {
-    const rawConfig = args.inlineJson ? args.inlineJson : readFileSync13(resolveNodeConfigPath(process.cwd(), args.nodeConfigInput), "utf-8");
+    const rawConfig = args.inlineJson ? args.inlineJson : readFileSync14(resolveNodeConfigPath(process.cwd(), args.nodeConfigInput), "utf-8");
     const config2 = parseNodeConfig(rawConfig);
     const loader = new SpecialistLoader;
     const runner = new SpecialistRunner({
@@ -31520,7 +31751,7 @@ async function handleNodeAction(args) {
           if (deadline !== null && Date.now() >= deadline) {
             throw new Error(`Timed out waiting for phase '${args.phaseId}' members: ${memberKeys.join(", ")}`);
           }
-          await new Promise((resolve8) => setTimeout(resolve8, 500));
+          await new Promise((resolve9) => setTimeout(resolve9, 500));
         }
       } finally {
         sqliteClient.close();
@@ -31607,7 +31838,7 @@ var init_node = __esm(() => {
 });
 
 // src/specialist/epic-reconciler.ts
-import { mkdirSync as mkdirSync7, openSync as openSync2, readFileSync as readFileSync14, rmSync as rmSync2, writeFileSync as writeFileSync8 } from "fs";
+import { mkdirSync as mkdirSync7, openSync as openSync2, readFileSync as readFileSync15, rmSync as rmSync2, writeFileSync as writeFileSync8 } from "fs";
 import { join as join19 } from "path";
 function buildEpicLockPath(epicId) {
   const location = resolveObservabilityDbLocation();
@@ -31624,7 +31855,7 @@ function withEpicAdvisoryLock(epicId, action) {
   } catch {
     let holder = "unknown";
     try {
-      holder = readFileSync14(lockPath, "utf-8");
+      holder = readFileSync15(lockPath, "utf-8");
     } catch {
       holder = "unknown";
     }
@@ -32600,7 +32831,7 @@ __export(exports_status, {
   run: () => run14
 });
 import { spawnSync as spawnSync16 } from "child_process";
-import { existsSync as existsSync17, readFileSync as readFileSync15 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync16 } from "fs";
 import { join as join20 } from "path";
 function ok2(msg) {
   console.log(`  ${green8("\u2713")} ${msg}`);
@@ -32693,9 +32924,9 @@ function countJobEvents(sqliteClient, jobsDir, jobId) {
     console.warn(`SQLite events read failed for job ${jobId}; falling back to events.jsonl`, error2);
   }
   const eventsFile = join20(jobsDir, jobId, "events.jsonl");
-  if (!existsSync17(eventsFile))
+  if (!existsSync18(eventsFile))
     return 0;
-  const raw = readFileSync15(eventsFile, "utf-8").trim();
+  const raw = readFileSync16(eventsFile, "utf-8").trim();
   if (!raw)
     return 0;
   return raw.split(`
@@ -32727,9 +32958,9 @@ function getLatestContextSnapshot(sqliteClient, jobsDir, jobId) {
     console.warn(`SQLite events read failed for job ${jobId}; falling back to events.jsonl`, error2);
   }
   const eventsFile = join20(jobsDir, jobId, "events.jsonl");
-  if (!existsSync17(eventsFile))
+  if (!existsSync18(eventsFile))
     return null;
-  const lines = readFileSync15(eventsFile, "utf-8").split(`
+  const lines = readFileSync16(eventsFile, "utf-8").split(`
 `);
   for (let index = lines.length - 1;index >= 0; index -= 1) {
     const line = lines[index].trim();
@@ -32834,11 +33065,11 @@ async function run14() {
 `).slice(1).map((line) => line.split(/\s+/)[0]).filter(Boolean)) : new Set;
     const bdInstalled = isInstalled2("bd");
     const bdVersion = bdInstalled ? cmd("bd", ["--version"]) : null;
-    const beadsPresent = existsSync17(join20(process.cwd(), ".beads"));
+    const beadsPresent = existsSync18(join20(process.cwd(), ".beads"));
     const specialistsBin = cmd("which", ["specialists"]);
     const jobsDir = resolveJobsDir();
     let jobs = [];
-    if (existsSync17(jobsDir)) {
+    if (existsSync18(jobsDir)) {
       supervisor = new Supervisor({
         runner: null,
         runOptions: null,
@@ -32995,7 +33226,7 @@ __export(exports_ps, {
   run: () => run15
 });
 import { spawnSync as spawnSync17 } from "child_process";
-import { existsSync as existsSync18, readdirSync as readdirSync8, readFileSync as readFileSync16 } from "fs";
+import { existsSync as existsSync19, readdirSync as readdirSync8, readFileSync as readFileSync17 } from "fs";
 import { join as join21 } from "path";
 function parseArgs7(argv) {
   let nodeId;
@@ -33026,25 +33257,25 @@ function isVisibleStatus(status, all) {
   return ACTIVE_STATES.includes(status);
 }
 function readStatusesFromFiles(jobsDir) {
-  if (!existsSync18(jobsDir))
+  if (!existsSync19(jobsDir))
     return [];
   const statuses = [];
   for (const entry of readdirSync8(jobsDir)) {
     const statusPath = join21(jobsDir, entry, "status.json");
-    if (!existsSync18(statusPath))
+    if (!existsSync19(statusPath))
       continue;
     try {
-      statuses.push(JSON.parse(readFileSync16(statusPath, "utf-8")));
+      statuses.push(JSON.parse(readFileSync17(statusPath, "utf-8")));
     } catch {}
   }
   return statuses.sort((a, b) => b.started_at_ms - a.started_at_ms);
 }
 function readLastToolEventFromFile(jobsDir, jobId) {
   const eventsPath = join21(jobsDir, jobId, "events.jsonl");
-  if (!existsSync18(eventsPath))
+  if (!existsSync19(eventsPath))
     return;
   try {
-    const lines = readFileSync16(eventsPath, "utf-8").split(`
+    const lines = readFileSync17(eventsPath, "utf-8").split(`
 `);
     for (let index = lines.length - 1;index >= 0; index -= 1) {
       const line = lines[index]?.trim();
@@ -33802,7 +34033,7 @@ var exports_result = {};
 __export(exports_result, {
   run: () => run16
 });
-import { existsSync as existsSync19, readFileSync as readFileSync17 } from "fs";
+import { existsSync as existsSync20, readFileSync as readFileSync18 } from "fs";
 import { join as join22 } from "path";
 function parseArgs8(argv) {
   let jobId;
@@ -33894,9 +34125,9 @@ function readTimelineEventsForResult(sqliteClient, jobsDir, jobId) {
     } catch {}
   }
   const eventsPath = join22(jobsDir, jobId, "events.jsonl");
-  if (!existsSync19(eventsPath))
+  if (!existsSync20(eventsPath))
     return [];
-  return readFileSync17(eventsPath, "utf-8").split(`
+  return readFileSync18(eventsPath, "utf-8").split(`
 `).map((line) => line.trim()).filter(Boolean).map((line) => parseTimelineEvent(line)).filter((event) => event !== null);
 }
 function deriveStartupSnapshot(status, events) {
@@ -34037,10 +34268,10 @@ async function run16() {
       } catch (error2) {
         console.warn(`SQLite result read failed for job ${jobId}; falling back to result.txt`, error2);
       }
-      if (!existsSync19(resultPath)) {
+      if (!existsSync20(resultPath)) {
         return null;
       }
-      return readFileSync17(resultPath, "utf-8");
+      return readFileSync18(resultPath, "utf-8");
     };
     if (args.wait) {
       const startMs = Date.now();
@@ -34214,7 +34445,7 @@ var init_result = __esm(() => {
 });
 
 // src/specialist/timeline-query.ts
-import { existsSync as existsSync20, readdirSync as readdirSync9, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync21, readdirSync as readdirSync9, readFileSync as readFileSync19 } from "fs";
 import { basename as basename5, join as join23 } from "path";
 function readJobEvents(jobDir) {
   const jobId = basename5(jobDir);
@@ -34226,9 +34457,9 @@ function readJobEvents(jobDir) {
     }
   } catch {}
   const eventsPath = join23(jobDir, "events.jsonl");
-  if (!existsSync20(eventsPath))
+  if (!existsSync21(eventsPath))
     return [];
-  const content = readFileSync18(eventsPath, "utf-8");
+  const content = readFileSync19(eventsPath, "utf-8");
   const lines = content.split(`
 `).filter(Boolean);
   const events = [];
@@ -34244,7 +34475,7 @@ function readJobEventsById(jobsDir, jobId) {
   return readJobEvents(join23(jobsDir, jobId));
 }
 function readAllJobEvents(jobsDir) {
-  if (!existsSync20(jobsDir))
+  if (!existsSync21(jobsDir))
     return [];
   const batches = [];
   const entries = readdirSync9(jobsDir);
@@ -34261,9 +34492,9 @@ function readAllJobEvents(jobsDir) {
     const statusPath = join23(jobDir, "status.json");
     let specialist = "unknown";
     let beadId;
-    if (existsSync20(statusPath)) {
+    if (existsSync21(statusPath)) {
       try {
-        const status = JSON.parse(readFileSync18(statusPath, "utf-8"));
+        const status = JSON.parse(readFileSync19(statusPath, "utf-8"));
         specialist = status.specialist ?? "unknown";
         beadId = status.bead_id;
       } catch {}
@@ -34360,9 +34591,9 @@ __export(exports_feed, {
 });
 import {
   closeSync as closeSync2,
-  existsSync as existsSync21,
+  existsSync as existsSync22,
   openSync as openSync3,
-  readFileSync as readFileSync19,
+  readFileSync as readFileSync20,
   readdirSync as readdirSync10,
   statSync as statSync3
 } from "fs";
@@ -34474,6 +34705,10 @@ function formatStartupContextLine(event) {
       parts.push(`skills=${snapshot.skills.count}`);
     return parts.length > 0 ? dim8(`  \u21B3 startup ${parts.join(" ")}`) : null;
   }
+  if (event.type === "meta" && event.source === "mandatory_rules_injection" && event.data) {
+    const data = event.data;
+    return dim8(`  \u21B3 mandatory_rules sets=${(data.sets_loaded ?? []).join(",") || "none"} rules=${data.rules_count ?? 0} tokens=~${data.token_estimate ?? 0}`);
+  }
   if (event.type === "meta" && event.memory_injection) {
     const mem = event.memory_injection;
     return dim8(`  \u21B3 memory static=${mem.static_tokens} dynamic=${mem.memory_tokens} gitnexus=${mem.gitnexus_tokens} total=${mem.total_tokens}`);
@@ -34507,7 +34742,7 @@ function readFileFresh(filePath) {
   let fd = null;
   try {
     fd = openSync3(filePath, "r");
-    return readFileSync19(fd, "utf-8");
+    return readFileSync20(fd, "utf-8");
   } catch {
     return null;
   } finally {
@@ -34733,7 +34968,7 @@ function filterMergedEventsByNode(sqliteClient, jobsDir, merged, nodeId) {
   });
 }
 function listMatchingJobIds(sqliteClient, jobsDir, options) {
-  if (!existsSync21(jobsDir))
+  if (!existsSync22(jobsDir))
     return [];
   const jobIds = [];
   for (const entry of readdirSync10(jobsDir)) {
@@ -34847,7 +35082,7 @@ async function followMerged(sqliteClient, jobsDir, options) {
   }
   const lastPrintedEventKey = new Map;
   const seenMetaKey = new Map;
-  await new Promise((resolve8) => {
+  await new Promise((resolve9) => {
     const interval = setInterval(() => {
       const batches = filteredBatches();
       for (const jobId of listMatchingJobIds(sqliteClient, jobsDir, options)) {
@@ -34924,7 +35159,7 @@ async function followMerged(sqliteClient, jobsDir, options) {
       }
       if (!options.forever && trackedJobs.size > 0 && completedJobs.size === trackedJobs.size) {
         clearInterval(interval);
-        resolve8();
+        resolve9();
       }
     }, 500);
   });
@@ -34934,7 +35169,7 @@ async function run17() {
   const sqliteClient = createObservabilitySqliteClient();
   try {
     const jobsDir = join24(process.cwd(), ".specialists", "jobs");
-    if (!existsSync21(jobsDir)) {
+    if (!existsSync22(jobsDir)) {
       console.log(dim8("No jobs directory found."));
       return;
     }
@@ -34973,7 +35208,7 @@ var exports_poll = {};
 __export(exports_poll, {
   run: () => run18
 });
-import { existsSync as existsSync22, readFileSync as readFileSync20 } from "fs";
+import { existsSync as existsSync23, readFileSync as readFileSync21 } from "fs";
 import { join as join25 } from "path";
 function parseArgs10(argv) {
   let jobId;
@@ -35014,16 +35249,16 @@ function readJobState(jobsDir, jobId, cursor, outputCursor) {
   const jobDir = join25(jobsDir, jobId);
   const statusPath = join25(jobDir, "status.json");
   let status = null;
-  if (existsSync22(statusPath)) {
+  if (existsSync23(statusPath)) {
     try {
-      status = JSON.parse(readFileSync20(statusPath, "utf-8"));
+      status = JSON.parse(readFileSync21(statusPath, "utf-8"));
     } catch {}
   }
   const resultPath = join25(jobDir, "result.txt");
   let fullOutput = "";
-  if (existsSync22(resultPath)) {
+  if (existsSync23(resultPath)) {
     try {
-      fullOutput = readFileSync20(resultPath, "utf-8");
+      fullOutput = readFileSync21(resultPath, "utf-8");
     } catch {}
   }
   const events = readJobEventsById(jobsDir, jobId);
@@ -35057,7 +35292,7 @@ async function run18() {
   const { jobId, cursor, outputCursor } = parseArgs10(process.argv.slice(3));
   const jobsDir = join25(process.cwd(), ".specialists", "jobs");
   const jobDir = join25(jobsDir, jobId);
-  if (!existsSync22(jobDir)) {
+  if (!existsSync23(jobDir)) {
     const result2 = {
       job_id: jobId,
       status: "error",
@@ -35205,15 +35440,15 @@ async function run21() {
 }
 
 // src/specialist/worktree-gc.ts
-import { existsSync as existsSync23, readdirSync as readdirSync11, readFileSync as readFileSync21 } from "fs";
+import { existsSync as existsSync24, readdirSync as readdirSync11, readFileSync as readFileSync22 } from "fs";
 import { join as join26 } from "path";
 import { spawnSync as spawnSync18 } from "child_process";
 function readJobStatus2(jobDir) {
   const statusPath = join26(jobDir, "status.json");
-  if (!existsSync23(statusPath))
+  if (!existsSync24(statusPath))
     return null;
   try {
-    return JSON.parse(readFileSync21(statusPath, "utf-8"));
+    return JSON.parse(readFileSync22(statusPath, "utf-8"));
   } catch {
     return null;
   }
@@ -35225,7 +35460,7 @@ function isActive(status) {
   return ACTIVE_STATUSES.has(status);
 }
 function collectWorktreeGcCandidates(jobsDir) {
-  if (!existsSync23(jobsDir))
+  if (!existsSync24(jobsDir))
     return [];
   const candidates = [];
   for (const entry of readdirSync11(jobsDir, { withFileTypes: true })) {
@@ -35241,7 +35476,7 @@ function collectWorktreeGcCandidates(jobsDir) {
     const { worktree_path: worktreePath, branch } = status;
     if (!worktreePath)
       continue;
-    if (!existsSync23(worktreePath))
+    if (!existsSync24(worktreePath))
       continue;
     candidates.push({
       jobId: status.id,
@@ -35287,9 +35522,9 @@ __export(exports_clean, {
   run: () => run22
 });
 import {
-  existsSync as existsSync24,
+  existsSync as existsSync25,
   readdirSync as readdirSync12,
-  readFileSync as readFileSync22,
+  readFileSync as readFileSync23,
   rmSync as rmSync3,
   statSync as statSync4
 } from "fs";
@@ -35381,11 +35616,11 @@ function readCompletedJobDirectory(baseDirectory, entry) {
   if (containsProtectedSqliteArtifact(directoryPath))
     return null;
   const statusFilePath = join27(directoryPath, "status.json");
-  if (!existsSync24(statusFilePath))
+  if (!existsSync25(statusFilePath))
     return null;
   let statusData;
   try {
-    statusData = JSON.parse(readFileSync22(statusFilePath, "utf-8"));
+    statusData = JSON.parse(readFileSync23(statusFilePath, "utf-8"));
   } catch {
     return null;
   }
@@ -35482,7 +35717,7 @@ async function run22() {
     printUsageAndExit2(message);
   }
   const jobsDirectoryPath = resolveJobsDir();
-  if (!existsSync24(jobsDirectoryPath)) {
+  if (!existsSync25(jobsDirectoryPath)) {
     console.log("No jobs directory found.");
     return;
   }
@@ -35667,7 +35902,7 @@ async function waitForProcessExit(pid, timeoutMs) {
   while (Date.now() < deadline) {
     if (!isProcessAlive(pid))
       return true;
-    await new Promise((resolve8) => setTimeout(resolve8, 100));
+    await new Promise((resolve9) => setTimeout(resolve9, 100));
   }
   return !isProcessAlive(pid);
 }
@@ -35777,7 +36012,7 @@ __export(exports_attach, {
   run: () => run25
 });
 import { execFileSync as execFileSync3, spawnSync as spawnSync20 } from "child_process";
-import { readFileSync as readFileSync23 } from "fs";
+import { readFileSync as readFileSync24 } from "fs";
 import { join as join28 } from "path";
 function exitWithError(message) {
   console.error(message);
@@ -35785,7 +36020,7 @@ function exitWithError(message) {
 }
 function readStatus(statusPath, jobId) {
   try {
-    return JSON.parse(readFileSync23(statusPath, "utf-8"));
+    return JSON.parse(readFileSync24(statusPath, "utf-8"));
   } catch (error2) {
     if (error2 && typeof error2 === "object" && "code" in error2 && error2.code === "ENOENT") {
       exitWithError(`Job \`${jobId}\` not found. Run \`specialists status\` to see active jobs.`);
@@ -36061,8 +36296,8 @@ __export(exports_doctor, {
 });
 import { createHash as createHash4 } from "crypto";
 import { spawnSync as spawnSync21 } from "child_process";
-import { existsSync as existsSync25, lstatSync as lstatSync2, mkdirSync as mkdirSync8, readdirSync as readdirSync13, readFileSync as readFileSync24, readlinkSync as readlinkSync2, writeFileSync as writeFileSync11 } from "fs";
-import { dirname as dirname7, join as join29, relative as relative2, resolve as resolve8 } from "path";
+import { existsSync as existsSync26, lstatSync as lstatSync2, mkdirSync as mkdirSync8, readdirSync as readdirSync13, readFileSync as readFileSync25, readlinkSync as readlinkSync2, writeFileSync as writeFileSync11 } from "fs";
+import { dirname as dirname7, join as join29, relative as relative2, resolve as resolve9 } from "path";
 function ok3(msg) {
   console.log(`  ${green14("\u2713")} ${msg}`);
 }
@@ -36091,10 +36326,10 @@ function isInstalled3(bin) {
   return spawnSync21("which", [bin], { encoding: "utf8", timeout: 2000 }).status === 0;
 }
 function loadJson2(path) {
-  if (!existsSync25(path))
+  if (!existsSync26(path))
     return null;
   try {
-    return JSON.parse(readFileSync24(path, "utf8"));
+    return JSON.parse(readFileSync25(path, "utf8"));
   } catch {
     return null;
   }
@@ -36137,7 +36372,7 @@ function checkBd() {
     return false;
   }
   ok3(`bd installed  ${dim13(sp("bd", ["--version"]).stdout || "")}`);
-  if (existsSync25(join29(CWD, ".beads")))
+  if (existsSync26(join29(CWD, ".beads")))
     ok3(".beads/ present in project");
   else
     warn3(".beads/ not found in project");
@@ -36158,7 +36393,7 @@ function checkHooks() {
   let allPresent = true;
   for (const name of HOOK_NAMES) {
     const canonicalPath = join29(HOOKS_DIR, name);
-    if (!existsSync25(canonicalPath)) {
+    if (!existsSync26(canonicalPath)) {
       fail4(`${relative2(CWD, canonicalPath)}  ${red7("missing")}`);
       fix("specialists init");
       allPresent = false;
@@ -36220,7 +36455,7 @@ function checkMCP() {
 }
 function hashFile(path) {
   const hash = createHash4("sha256");
-  hash.update(readFileSync24(path));
+  hash.update(readFileSync25(path));
   return hash.digest("hex");
 }
 function collectFileHashes(rootDir) {
@@ -36238,12 +36473,12 @@ function collectFileHashes(rootDir) {
       hashes.set(relPath, hashFile(fullPath));
     }
   };
-  if (existsSync25(rootDir))
+  if (existsSync26(rootDir))
     visit2(rootDir);
   return hashes;
 }
 function isSymlinkTo(linkPath, expectedTargetPath) {
-  if (!existsSync25(linkPath))
+  if (!existsSync26(linkPath))
     return { ok: false, reason: "missing" };
   let stats;
   try {
@@ -36255,8 +36490,8 @@ function isSymlinkTo(linkPath, expectedTargetPath) {
     return { ok: false, reason: "not-symlink" };
   try {
     const rawTarget = readlinkSync2(linkPath);
-    const resolvedTarget = resolve8(dirname7(linkPath), rawTarget);
-    const resolvedExpected = resolve8(expectedTargetPath);
+    const resolvedTarget = resolve9(dirname7(linkPath), rawTarget);
+    const resolvedExpected = resolve9(expectedTargetPath);
     if (resolvedTarget !== resolvedExpected) {
       return { ok: false, reason: "wrong-target", target: rawTarget };
     }
@@ -36267,12 +36502,12 @@ function isSymlinkTo(linkPath, expectedTargetPath) {
 }
 function checkSkillDrift() {
   section3("Skill drift  (.xtrm skill sync)");
-  if (!existsSync25(CONFIG_SKILLS_DIR)) {
+  if (!existsSync26(CONFIG_SKILLS_DIR)) {
     fail4("config/skills/ missing");
     fix("restore config/skills/ from git");
     return false;
   }
-  if (!existsSync25(XTRM_DEFAULT_SKILLS_DIR)) {
+  if (!existsSync26(XTRM_DEFAULT_SKILLS_DIR)) {
     fail4(".xtrm/skills/default/ missing");
     fix("specialists init --sync-skills");
     return false;
@@ -36315,7 +36550,7 @@ function checkSkillDrift() {
   let linksOk = true;
   for (const scope of ["claude", "pi"]) {
     const activeRoot = join29(XTRM_ACTIVE_SKILLS_DIR, scope);
-    if (!existsSync25(activeRoot)) {
+    if (!existsSync26(activeRoot)) {
       fail4(`${relative2(CWD, activeRoot)}/ missing`);
       fix("specialists init --sync-skills");
       linksOk = false;
@@ -36374,14 +36609,14 @@ function checkRuntimeDirs() {
   const jobsDir = join29(rootDir, "jobs");
   const readyDir = join29(rootDir, "ready");
   let allOk = true;
-  if (!existsSync25(rootDir)) {
+  if (!existsSync26(rootDir)) {
     warn3(".specialists/ not found in current project");
     fix("specialists init");
     allOk = false;
   } else {
     ok3(".specialists/ present");
     for (const [subDir, label] of [[jobsDir, "jobs"], [readyDir, "ready"]]) {
-      if (!existsSync25(subDir)) {
+      if (!existsSync26(subDir)) {
         warn3(`.specialists/${label}/ missing \u2014 auto-creating`);
         mkdirSync8(subDir, { recursive: true });
         ok3(`.specialists/${label}/ created`);
@@ -36414,7 +36649,7 @@ function compareVersions(left, right) {
 }
 function setStatusError(statusPath) {
   try {
-    const raw = readFileSync24(statusPath, "utf8");
+    const raw = readFileSync25(statusPath, "utf8");
     const status = JSON.parse(raw);
     status.status = "error";
     writeFileSync11(statusPath, `${JSON.stringify(status, null, 2)}
@@ -36437,10 +36672,10 @@ function cleanupProcesses(jobsDir, dryRun) {
   };
   for (const jobId of entries) {
     const statusPath = join29(jobsDir, jobId, "status.json");
-    if (!existsSync25(statusPath))
+    if (!existsSync26(statusPath))
       continue;
     try {
-      const status = JSON.parse(readFileSync24(statusPath, "utf8"));
+      const status = JSON.parse(readFileSync25(statusPath, "utf8"));
       result.total += 1;
       if (status.status !== "running" && status.status !== "starting")
         continue;
@@ -36517,7 +36752,7 @@ ${bold13("specialists doctor orphans")}
 function checkZombieJobs() {
   section3("Background jobs");
   const jobsDir = join29(CWD, ".specialists", "jobs");
-  if (!existsSync25(jobsDir)) {
+  if (!existsSync26(jobsDir)) {
     hint("No .specialists/jobs/ \u2014 skipping");
     return true;
   }