@jaggerxtrm/specialists 3.12.0 → 3.14.0

package/dist/lib.js

@@ -555,6 +555,8 @@ var require_Alias = __commonJS((exports) => {
       });
     }
     resolve(doc, ctx) {
+      if (ctx?.maxAliasCount === 0)
+        throw new ReferenceError("Alias resolution is disabled");
       let nodes;
       if (ctx?.aliasResolveCache) {
         nodes = ctx.aliasResolveCache;
@@ -1334,6 +1336,7 @@ var require_stringify = __commonJS((exports) => {
       nullStr: "null",
       simpleKeys: false,
       singleQuote: null,
+      trailingComma: false,
       trueStr: "true",
       verifyAliasOrder: true
     }, doc.schema.toStringOptions, options);
@@ -1603,18 +1606,18 @@ var require_merge = __commonJS((exports) => {
   };
   var isMergeKey = (ctx, key) => (merge.identify(key) || identity.isScalar(key) && (!key.type || key.type === Scalar.Scalar.PLAIN) && merge.identify(key.value)) && ctx?.doc.schema.tags.some((tag) => tag.tag === merge.tag && tag.default);
   function addMergeToJSMap(ctx, map, value) {
-    value = ctx && identity.isAlias(value) ? value.resolve(ctx.doc) : value;
-    if (identity.isSeq(value))
-      for (const it of value.items)
+    const source = resolveAliasValue(ctx, value);
+    if (identity.isSeq(source))
+      for (const it of source.items)
         mergeValue(ctx, map, it);
-    else if (Array.isArray(value))
-      for (const it of value)
+    else if (Array.isArray(source))
+      for (const it of source)
         mergeValue(ctx, map, it);
     else
-      mergeValue(ctx, map, value);
+      mergeValue(ctx, map, source);
   }
   function mergeValue(ctx, map, value) {
-    const source = ctx && identity.isAlias(value) ? value.resolve(ctx.doc) : value;
+    const source = resolveAliasValue(ctx, value);
     if (!identity.isMap(source))
       throw new Error("Merge sources must be maps or map aliases");
     const srcMap = source.toJSON(null, ctx, Map);
@@ -1635,6 +1638,9 @@ var require_merge = __commonJS((exports) => {
     }
     return map;
   }
+  function resolveAliasValue(ctx, value) {
+    return ctx && identity.isAlias(value) ? value.resolve(ctx.doc, ctx) : value;
+  }
   exports.addMergeToJSMap = addMergeToJSMap;
   exports.isMergeKey = isMergeKey;
   exports.merge = merge;
@@ -1842,13 +1848,20 @@ ${indent}${line}` : `
       if (comment)
         reqNewline = true;
       let str = stringify.stringify(item, itemCtx, () => comment = null);
-      if (i < items.length - 1)
+      reqNewline || (reqNewline = lines.length > linesAtValue || str.includes(`
+`));
+      if (i < items.length - 1) {
         str += ",";
+      } else if (ctx.options.trailingComma) {
+        if (ctx.options.lineWidth > 0) {
+          reqNewline || (reqNewline = lines.reduce((sum, line) => sum + line.length + 2, 2) + (str.length + 2) > ctx.options.lineWidth);
+        }
+        if (reqNewline) {
+          str += ",";
+        }
+      }
       if (comment)
         str += stringifyComment.lineComment(str, itemIndent, commentString(comment));
-      if (!reqNewline && (lines.length > linesAtValue || str.includes(`
-`)))
-        reqNewline = true;
       lines.push(str);
       linesAtValue = lines.length;
     }
@@ -2203,7 +2216,7 @@ var require_stringifyNumber = __commonJS((exports) => {
     if (!isFinite(num))
       return isNaN(num) ? ".nan" : num < 0 ? "-.inf" : ".inf";
     let n = Object.is(value, -0) ? "-0" : JSON.stringify(value);
-    if (!format && minFractionDigits && (!tag || tag === "tag:yaml.org,2002:float") && /^\d/.test(n)) {
+    if (!format && minFractionDigits && (!tag || tag === "tag:yaml.org,2002:float") && /^-?\d/.test(n) && !n.includes("e")) {
       let i = n.indexOf(".");
       if (i < 0) {
         i = n.length;
@@ -4428,7 +4441,7 @@ var require_resolve_flow_scalar = __commonJS((exports) => {
           while (next === " " || next === "\t")
             next = source[++i + 1];
         } else if (next === "x" || next === "u" || next === "U") {
-          const length = { x: 2, u: 4, U: 8 }[next];
+          const length = next === "x" ? 2 : next === "u" ? 4 : 8;
           res += parseCharCode(source, i + 1, length, onError);
           i += length;
         } else {
@@ -4497,12 +4510,13 @@ var require_resolve_flow_scalar = __commonJS((exports) => {
     const cc = source.substr(offset, length);
     const ok = cc.length === length && /^[0-9a-fA-F]+$/.test(cc);
     const code = ok ? parseInt(cc, 16) : NaN;
-    if (isNaN(code)) {
+    try {
+      return String.fromCodePoint(code);
+    } catch {
       const raw = source.substr(offset - 2, length + 2);
       onError(offset - 2, "BAD_DQ_ESCAPE", `Invalid escape sequence ${raw}`);
       return raw;
     }
-    return String.fromCodePoint(code);
   }
   exports.resolveFlowScalar = resolveFlowScalar;
 });
@@ -4643,17 +4657,22 @@ var require_compose_node = __commonJS((exports) => {
       case "block-map":
       case "block-seq":
       case "flow-collection":
-        node = composeCollection.composeCollection(CN, ctx, token, props, onError);
-        if (anchor)
-          node.anchor = anchor.source.substring(1);
+        try {
+          node = composeCollection.composeCollection(CN, ctx, token, props, onError);
+          if (anchor)
+            node.anchor = anchor.source.substring(1);
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          onError(token, "RESOURCE_EXHAUSTION", message);
+        }
         break;
       default: {
         const message = token.type === "error" ? token.message : `Unsupported token (type: ${token.type})`;
         onError(token, "UNEXPECTED_TOKEN", message);
-        node = composeEmptyNode(ctx, token.offset, undefined, null, props, onError);
         isSrcToken = false;
       }
     }
+    node ?? (node = composeEmptyNode(ctx, token.offset, undefined, null, props, onError));
     if (anchor && node.anchor === "")
       onError(anchor, "BAD_ALIAS", "Anchor cannot be an empty string");
     if (atKey && ctx.options.stringKeys && (!identity.isScalar(node) || typeof node.value !== "string" || node.tag && node.tag !== "tag:yaml.org,2002:str")) {
@@ -6908,6 +6927,7 @@ var require_public_api = __commonJS((exports) => {
 import { spawn } from "node:child_process";
 import { createHash, randomUUID } from "node:crypto";
 import { readFileSync as readFileSync2 } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
 
 // src/specialist/templateEngine.ts
 function renderTemplate(template, variables) {
@@ -6917,7 +6937,8 @@ function renderTemplate(template, variables) {
 }
 
 // src/specialist/observability-sqlite.ts
-import { existsSync, readFileSync, statSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join as join2 } from "node:path";
 
 // src/specialist/observability-db.ts
 import { spawnSync } from "node:child_process";
@@ -9013,23 +9034,30 @@ class SqliteClient {
     this.db.close();
   }
 }
-function createObservabilitySqliteClient(cwd = process.cwd()) {
+function openObservabilitySqliteClient(dbPath) {
   if (!loadBunDatabase())
     return null;
-  const location = resolveObservabilityDbLocation(cwd);
-  if (!existsSync(location.dbPath))
-    return null;
   try {
     const Ctor = loadBunDatabase();
-    const initDb = new Ctor(location.dbPath);
+    const initDb = new Ctor(dbPath);
     initDb.run(`PRAGMA busy_timeout=${BUSY_TIMEOUT_MS}`);
     initSchema(initDb);
     initDb.close();
-    return new SqliteClient(location.dbPath);
+    return new SqliteClient(dbPath);
   } catch {
     return null;
   }
 }
+function createObservabilitySqliteClient(cwd = process.cwd()) {
+  const location = resolveObservabilityDbLocation(cwd);
+  if (!existsSync(location.dbPath))
+    return null;
+  return openObservabilitySqliteClient(location.dbPath);
+}
+function createObservabilitySqliteClientAtPath(dbPath) {
+  mkdirSync(dirname(dbPath), { recursive: true });
+  return openObservabilitySqliteClient(dbPath);
+}
 
 // src/specialist/script-runner.ts
 class CompatGuardError extends Error {
@@ -9040,6 +9068,18 @@ class CompatGuardError extends Error {
     this.name = "CompatGuardError";
   }
 }
+function isPathWithinRoot(candidatePath, rootPath) {
+  const candidate = resolve(candidatePath);
+  const root = resolve(rootPath);
+  const rel = relative(root, candidate);
+  return rel === "" || rel.length > 0 && !rel.startsWith("..") && !isAbsolute(rel);
+}
+function assertSkillPathWithinRoots(field, path, roots) {
+  const allowed = roots.some((root) => isPathWithinRoot(path, root));
+  if (!allowed) {
+    throw new CompatGuardError(field, `skill path '${path}' not under any --allow-skills-roots entry`);
+  }
+}
 function hasUnsubstitutedVariables(template, variables) {
   const matches = template.match(/\$([a-zA-Z_][a-zA-Z0-9_]*)/g) ?? [];
   for (const match of matches) {
@@ -9058,8 +9098,8 @@ function compatGuard(spec, trust) {
   if (execution.permission_required !== "READ_ONLY")
     throw new CompatGuardError("execution.permission_required", "permission_required must be READ_ONLY");
   const hasScripts = (spec.specialist.skills?.scripts?.length ?? 0) > 0;
-  if (hasScripts && !trust?.allowLocalScripts) {
-    throw new CompatGuardError("skills.scripts", "scripts not allowed (enable with --allow-local-scripts)");
+  if (hasScripts) {
+    throw new CompatGuardError("skills.scripts", "local scripts are not supported in script-class specialists");
   }
   const hasPaths = (spec.specialist.skills?.paths?.length ?? 0) > 0;
   const hasSkillInherit = Boolean(spec.specialist.prompt.skill_inherit);
@@ -9069,26 +9109,34 @@ function compatGuard(spec, trust) {
   if (hasSkillInherit && !trust?.allowSkills) {
     throw new CompatGuardError("prompt.skill_inherit", "skills not allowed (enable with --allow-skills)");
   }
-  if (hasPaths && trust?.allowSkills && trust.allowSkillsRoots && trust.allowSkillsRoots.length > 0) {
+  if (trust?.allowSkills && trust.allowSkillsRoots && trust.allowSkillsRoots.length > 0) {
     const paths = spec.specialist.skills?.paths ?? [];
-    for (const path of paths) {
-      const allowed = trust.allowSkillsRoots.some((root) => path.startsWith(root));
-      if (!allowed) {
-        throw new CompatGuardError("skills.paths", `skill path '${path}' not under any --allow-skills-roots entry`);
-      }
+    for (const path of paths)
+      assertSkillPathWithinRoots("skills.paths", path, trust.allowSkillsRoots);
+    if (typeof spec.specialist.prompt.skill_inherit === "string") {
+      assertSkillPathWithinRoots("prompt.skill_inherit", spec.specialist.prompt.skill_inherit, trust.allowSkillsRoots);
     }
   }
 }
+function collectSkillPathEntries(spec) {
+  return [
+    ...(spec.specialist.skills?.paths ?? []).map((path) => ({ path, source: "skills.paths" })),
+    ...typeof spec.specialist.prompt.skill_inherit === "string" ? [{ path: spec.specialist.prompt.skill_inherit, source: "prompt.skill_inherit" }] : []
+  ];
+}
+function collectSkillPaths(spec) {
+  return collectSkillPathEntries(spec).map((entry) => entry.path);
+}
 function computeSkillSources(spec) {
-  const paths = spec.specialist.skills?.paths ?? [];
+  const entries = collectSkillPathEntries(spec);
   const sources = [];
-  for (const path of paths) {
+  for (const { path, source } of entries) {
     try {
       const content = readFileSync2(path);
       const sha256 = createHash("sha256").update(content).digest("hex");
-      sources.push({ path, sha256 });
+      sources.push({ path, sha256, source });
     } catch {
-      sources.push({ path, sha256: "unreadable" });
+      sources.push({ path, sha256: "unreadable", source });
     }
   }
   return sources;
@@ -9099,6 +9147,34 @@ function renderTaskTemplate(template, variables) {
     throw new Error(`Missing template variable: ${missing}`);
   return renderTemplate(template, variables);
 }
+function truncateForPrompt(value, limitBytes) {
+  if (Buffer.byteLength(value, "utf8") <= limitBytes)
+    return value;
+  return `${value.slice(0, limitBytes)}
+... truncated ...`;
+}
+function buildJsonOutputContract(spec) {
+  if (spec.specialist.execution.response_format !== "json")
+    return;
+  const schema = spec.specialist.prompt.output_schema;
+  const required = Array.isArray(schema?.required) ? schema.required.filter((value) => typeof value === "string") : [];
+  const lines = [
+    "Output contract:",
+    "- Return only valid JSON. Do not include Markdown fences, prose, or commentary."
+  ];
+  if (required.length > 0)
+    lines.push(`- Include these required top-level keys: ${required.join(", ")}.`);
+  if (schema)
+    lines.push(`- JSON schema: ${truncateForPrompt(JSON.stringify(schema), 4096)}`);
+  return lines.join(`
+`);
+}
+function applyOutputContract(prompt, spec) {
+  const contract = buildJsonOutputContract(spec);
+  return contract ? `${prompt}
+
+${contract}` : prompt;
+}
 function mapErrorType(message) {
   if (message.includes("Specialist not found"))
     return "specialist_not_found";
@@ -9106,6 +9182,8 @@ function mapErrorType(message) {
     return "specialist_load_error";
   if (message.includes("Missing template variable"))
     return "template_variable_missing";
+  if (message.includes("prompt too large"))
+    return "prompt_too_large";
   if (message.includes("output too large"))
     return "output_too_large";
   if (message.includes("auth") || message.includes("403") || message.includes("401"))
@@ -9176,6 +9254,19 @@ function writeTraceRow(client, specialist, model, traceId, output, durationMs, s
 var DEFAULT_PENDING_LINE_LIMIT_BYTES = 16 * 1024 * 1024;
 var DEFAULT_ASSISTANT_TEXT_LIMIT_BYTES = 4 * 1024 * 1024;
 var DEFAULT_STDERR_LIMIT_BYTES = 1 * 1024 * 1024;
+var DEFAULT_PROMPT_LIMIT_BYTES = 4 * 1024 * 1024;
+function resolvePromptLimitBytes(spec) {
+  return spec.specialist.execution.prompt_limit_bytes ?? resolveEnvPromptLimitBytes() ?? DEFAULT_PROMPT_LIMIT_BYTES;
+}
+function resolveEnvPromptLimitBytes() {
+  const raw = process.env.SPECIALISTS_SCRIPT_PROMPT_LIMIT_BYTES;
+  if (raw === undefined)
+    return;
+  const envLimit = Number(raw);
+  if (!Number.isFinite(envLimit) || envLimit <= 0)
+    return;
+  return Math.floor(envLimit);
+}
 function resolveAssistantTextLimitBytes(spec) {
   return spec.specialist.execution.stdout_limit_bytes ?? resolveEnvAssistantTextLimitBytes() ?? DEFAULT_ASSISTANT_TEXT_LIMIT_BYTES;
 }
@@ -9191,8 +9282,9 @@ function resolveEnvAssistantTextLimitBytes() {
   return Math.floor(envLimit);
 }
 function openObservabilityClient(options) {
-  const dbPath = options.observabilityDbPath ?? options.projectDir;
-  return createObservabilitySqliteClient(dbPath);
+  if (options.observabilityDbPath)
+    return createObservabilitySqliteClientAtPath(options.observabilityDbPath);
+  return createObservabilitySqliteClient(options.projectDir);
 }
 function resolveScriptSpecialistName(name) {
   if (name === "changelog-keeper")
@@ -9206,9 +9298,28 @@ async function runScriptSpecialist(input, options) {
     const resolvedSpecialist = resolveScriptSpecialistName(input.specialist);
     const spec = await options.loader.get(resolvedSpecialist);
     compatGuard(spec, options.trust);
+    const skillPaths = options.trust?.allowSkills ? collectSkillPaths(spec) : [];
     const skillSources = options.trust?.allowSkills ? computeSkillSources(spec) : undefined;
     const template = input.template ?? spec.specialist.prompt.task_template;
-    const prompt = renderTaskTemplate(template, input.variables ?? {});
+    const prompt = applyOutputContract(renderTaskTemplate(template, input.variables ?? {}), spec);
+    const modelCandidates = collectModelCandidates(input, spec, options);
+    const promptLimitBytes = resolvePromptLimitBytes(spec);
+    const promptBytes = Buffer.byteLength(prompt, "utf8");
+    if (promptBytes > promptLimitBytes) {
+      return {
+        success: false,
+        error: `prompt too large: ${promptBytes} bytes exceeds limit ${promptLimitBytes} bytes`,
+        error_type: "prompt_too_large",
+        meta: {
+          specialist: resolvedSpecialist,
+          requested_specialist: input.requested_specialist ?? input.specialist,
+          resolved_specialist: resolvedSpecialist,
+          model: modelCandidates[0],
+          duration_ms: Date.now() - startedAt,
+          trace_id: traceId
+        }
+      };
+    }
     if (process.env.SPECIALISTS_SCRIPT_STUB_OUTPUT) {
       return {
         success: true,
@@ -9224,11 +9335,11 @@ async function runScriptSpecialist(input, options) {
       };
     }
     const timeoutMs = input.timeout_ms ?? spec.specialist.execution.timeout_ms ?? 120000;
-    const modelCandidates = collectModelCandidates(input, spec, options);
     const assistantTextLimitBytes = resolveAssistantTextLimitBytes(spec);
     const attempts = [];
     for (const model of modelCandidates) {
-      const attempt = await runSingleAttempt(prompt, model, input.thinking_level ?? spec.specialist.execution.thinking_level, timeoutMs, assistantTextLimitBytes, options);
+      const systemPrompt = spec.specialist.prompt.system || undefined;
+      const attempt = await runSingleAttempt(prompt, model, input.thinking_level ?? spec.specialist.execution.thinking_level, timeoutMs, assistantTextLimitBytes, options, systemPrompt, skillPaths);
       attempts.push(attempt);
       const parsed = classifyAttempt(attempt);
       if (parsed.retryable)
@@ -9271,14 +9382,23 @@ function collectModelCandidates(input, spec, options) {
   const candidates = [input.model_override, spec.specialist.execution.model, spec.specialist.execution.fallback_model, options.fallbackModel].filter((value) => typeof value === "string" && value.length > 0);
   return [...new Set(candidates)];
 }
-function runSingleAttempt(prompt, model, thinkingLevel, timeoutMs, assistantTextLimitBytes, options) {
-  return new Promise((resolve, reject) => {
-    const args = ["--mode", "json", "--no-session", "--no-extensions", "--no-tools", "--model", model];
+function runSingleAttempt(prompt, model, thinkingLevel, timeoutMs, assistantTextLimitBytes, options, systemPrompt, skillPaths = []) {
+  return new Promise((resolve2, reject) => {
+    const args = ["--mode", "json", "--no-session", "--no-extensions", "--no-tools", "--offline", "--no-context-files", "--no-prompt-templates", "--no-themes"];
+    if (skillPaths.length === 0)
+      args.push("--no-skills");
+    for (const skillPath of skillPaths)
+      args.push("--skill", skillPath);
+    args.push("--model", model);
     if (thinkingLevel)
       args.push("--thinking", thinkingLevel);
-    args.push(prompt);
-    const pi = spawn("pi", args, { stdio: ["ignore", "pipe", "pipe"] });
+    if (systemPrompt)
+      args.push("--system-prompt", systemPrompt);
+    const pi = spawn("pi", args, { stdio: ["pipe", "pipe", "pipe"], cwd: options.projectDir ?? process.cwd() });
     options.onChild?.(pi);
+    pi.stdin?.on("error", () => {});
+    pi.stdin?.write(prompt);
+    pi.stdin?.end();
     let stderr = "";
     let timedOut = false;
     let outputTooLarge = false;
@@ -9347,7 +9467,7 @@ function runSingleAttempt(prompt, model, thinkingLevel, timeoutMs, assistantText
     pi.on("error", reject);
     pi.on("close", (code) => {
       clearTimeout(timer);
-      resolve({
+      resolve2({
         model,
         text: assistantText,
         stderr,
@@ -9386,7 +9506,7 @@ function isRetryableModelFailure(stderr, text) {
 }
 // src/specialist/loader.ts
 import { readdir, readFile, stat } from "node:fs/promises";
-import { basename, join as join2 } from "node:path";
+import { basename, join as join3 } from "node:path";
 import { existsSync as existsSync3 } from "node:fs";
 
 // node_modules/yaml/dist/index.js
@@ -13266,6 +13386,7 @@ var ExecutionSchema = objectType({
   max_retries: numberType().int().min(0).default(0),
   interactive: booleanType().default(false),
   stdout_limit_bytes: numberType().int().positive().optional(),
+  prompt_limit_bytes: numberType().int().positive().optional(),
   response_format: enumType(["text", "json", "markdown"]).default("text"),
   output_type: enumType(["codegen", "analysis", "review", "synthesis", "orchestration", "workflow", "research", "custom"]).default("custom"),
   permission_required: enumType(["READ_ONLY", "LOW", "MEDIUM", "HIGH"]).default("READ_ONLY"),
@@ -13439,15 +13560,15 @@ class SpecialistLoader {
   }
   getScanDirs() {
     const dirs = [
-      { path: join2(this.projectDir, ".specialists", "user"), scope: "user", source: "user" },
-      { path: join2(this.projectDir, ".specialists", "user", "specialists"), scope: "user", source: "legacy" },
-      { path: join2(this.projectDir, ".specialists", "default"), scope: "default", source: "default-mirror" },
-      { path: join2(this.projectDir, ".specialists", "default", "specialists"), scope: "default", source: "legacy" },
-      { path: join2(this.projectDir, "config", "specialists"), scope: "package", source: "package-fallback" },
+      { path: join3(this.projectDir, ".specialists", "user"), scope: "user", source: "user" },
+      { path: join3(this.projectDir, ".specialists", "user", "specialists"), scope: "user", source: "legacy" },
+      { path: join3(this.projectDir, ".specialists", "default"), scope: "default", source: "default-mirror" },
+      { path: join3(this.projectDir, ".specialists", "default", "specialists"), scope: "default", source: "legacy" },
+      { path: join3(this.projectDir, "config", "specialists"), scope: "package", source: "package-fallback" },
       { path: resolveCanonicalAssetDir("specialists") ?? "", scope: "package", source: "package-live" },
-      { path: join2(this.projectDir, "specialists"), scope: "default", source: "legacy" },
-      { path: join2(this.projectDir, ".claude", "specialists"), scope: "default", source: "legacy" },
-      { path: join2(this.projectDir, ".agent-forge", "specialists"), scope: "default", source: "legacy" }
+      { path: join3(this.projectDir, "specialists"), scope: "default", source: "legacy" },
+      { path: join3(this.projectDir, ".claude", "specialists"), scope: "default", source: "legacy" },
+      { path: join3(this.projectDir, ".agent-forge", "specialists"), scope: "default", source: "legacy" }
     ];
     return dirs.filter((d) => d.path && existsSync3(d.path));
   }
@@ -13457,11 +13578,11 @@ class SpecialistLoader {
     return JSON.stringify($parse(content));
   }
   resolveSpecialistPath(dirPath, specialistName) {
-    const jsonPath = join2(dirPath, `${specialistName}.specialist.json`);
+    const jsonPath = join3(dirPath, `${specialistName}.specialist.json`);
     if (existsSync3(jsonPath)) {
       return { filePath: jsonPath, deprecatedYaml: false };
     }
-    const yamlPath = join2(dirPath, `${specialistName}.specialist.yaml`);
+    const yamlPath = join3(dirPath, `${specialistName}.specialist.yaml`);
     if (existsSync3(yamlPath)) {
       return { filePath: yamlPath, deprecatedYaml: true };
     }
@@ -13539,9 +13660,9 @@ class SpecialistLoader {
         const fileDir = dir.path;
         const resolved = rawPaths.map((p) => {
           if (p.startsWith("~/"))
-            return join2(process.env.HOME || "", p.slice(2));
+            return join3(process.env.HOME || "", p.slice(2));
           if (p.startsWith("./"))
-            return join2(fileDir, p.slice(2));
+            return join3(fileDir, p.slice(2));
           return p;
         });
         spec.specialist.skills.paths = resolved;

package/dist/types/cli/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAqEA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAiGzC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/help.ts"],"names":[],"mappings":"AAoEA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAgGzC"}

package/dist/types/cli/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAkjBA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAgSzC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/run.ts"],"names":[],"mappings":"AAkjBA,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAiSzC"}

package/dist/types/cli/script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/cli/script.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmD,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE5H,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAQD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsCpD;AAeD,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAchE;AAwBD,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/E;AAED,eAAO,MAAM,SAAS;;;CAA6B,CAAC"}
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/cli/script.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmD,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE5H,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB;AAQD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsCpD;AAeD,wBAAgB,WAAW,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAchE;AAwBD,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAc/E;AAED,eAAO,MAAM,SAAS;;;CAA6B,CAAC"}

package/dist/types/cli/serve.d.ts

@@ -5,14 +5,19 @@ interface ServeArgs {
     queueTimeoutMs: number;
     shutdownGraceMs: number;
     projectDir: string;
+    dbPath?: string;
     fallbackModel?: string;
     auditFailureThreshold: number;
     allowSkills: boolean;
     allowSkillsRoots: string[];
-    allowLocalScripts: boolean;
     reloadPollMs: number;
+    readinessCanaryMode: 'off' | 'warn' | 'require';
+    readinessRequiredPiFlags: string[];
+    readinessCanarySpecialist?: string;
+    readinessCanaryTimeoutMs: number;
+    logLevel: 'off' | 'info' | 'debug';
 }
-export type ReadinessReason = 'draining' | 'degraded:audit' | 'pi_config_unreadable' | 'db_not_writable' | 'empty_user_dir' | 'invalid_spec_in_user_dir';
+export type ReadinessReason = 'draining' | 'degraded:audit' | 'pi_config_unreadable' | 'db_not_writable' | 'pi_binary_missing' | 'pi_flag_missing' | 'pi_smoke_failed' | 'empty_user_dir' | 'invalid_spec_in_user_dir';
 export interface ReadinessState {
     shuttingDown: boolean;
     auditFailures: number[];
@@ -27,13 +32,17 @@ export interface ReadinessCheckOptions {
     piConfigPath?: string;
     auditFailureThreshold: number;
     now?: number;
+    piCanaryMode?: 'off' | 'warn' | 'require';
+    piCanaryCheck?: () => Promise<ReadinessReason | undefined> | ReadinessReason | undefined;
 }
 export declare function evaluateReadiness(opts: ReadinessCheckOptions): Promise<{
     ready: true;
+    warning?: ReadinessReason;
 } | {
     ready: false;
     reason: ReadinessReason;
 }>;
+export declare function checkPiHelpForFlags(flags?: string[]): ReadinessReason | undefined;
 export declare function startServe(argv?: string[]): Promise<{
     server: import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
     args: ServeArgs;

package/dist/types/cli/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/cli/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAcpF,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,gBAAgB,GAChB,sBAAsB,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAIxF;AA8BD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CA4BzI;AAyDD,wBAAsB,UAAU,CAAC,IAAI,GAAE,MAAM,EAA0B;;;;;GAmFtE;AAED,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/cli/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAepF,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;CACpC;AAKD,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,gBAAgB,GAChB,sBAAsB,GACtB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAIxF;AA8BD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,GAAG,eAAe,GAAG,SAAS,CAAC;CAC1F;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAC,CAsCpK;AAmDD,wBAAgB,mBAAmB,CAAC,KAAK,GAAE,MAAM,EAA8B,GAAG,eAAe,GAAG,SAAS,CAM5G;AAiDD,wBAAsB,UAAU,CAAC,IAAI,GAAE,MAAM,EAA0B;;;;;GA0KtE;AAED,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E"}

package/dist/types/cli/version-check.d.ts

@@ -1,3 +1,5 @@
+type PackageRequire = (specifier: string) => unknown;
+export declare function readBundledPackageVersion(requireFn?: PackageRequire): string;
 export declare const localVersion: string;
 export interface VersionCheckCache {
     checked_at_ms: number;
@@ -14,4 +16,5 @@ export declare function readCachedVersionCheck(): VersionCheckCache | null;
 export declare function getVersionCheckResult(): VersionCheckResult | null;
 export declare function formatVersionCheckNudge(result: VersionCheckResult): string | null;
 export declare function markVersionCheckNotified(result: VersionCheckResult): void;
+export {};
 //# sourceMappingURL=version-check.d.ts.map

package/dist/types/cli/version-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../../src/cli/version-check.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,QAAiB,CAAC;AAM3C,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAK/C;AAWD,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,IAAI,CAEjE;AAkDD,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CA2BjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAIjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAMzE"}
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../../src/cli/version-check.ts"],"names":[],"mappings":"AAOA,KAAK,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;AAErD,wBAAgB,yBAAyB,CAAC,SAAS,GAAE,cAAwB,GAAG,MAAM,CAYrF;AAID,eAAO,MAAM,YAAY,QAAiB,CAAC;AAM3C,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAK/C;AAWD,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,IAAI,CAEjE;AAkDD,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CA2BjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAIjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAMzE"}

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@
 /**
  * Specialists MCP Server — entry point
  * Subcommands: install, version, list, view, models, init, db, validate, edit, config, run,
- *              status, ps, result, feed, poll, clean, merge, epic, end, stop, attach, quickstart, serve, script, release, help
+ *              status, ps, result, feed, clean, merge, epic, end, stop, attach, quickstart, serve, script, release, help
  */
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/types/specialist/mandatory-rules.d.ts

@@ -17,8 +17,13 @@ interface MandatoryRulesIndex {
     required_template_sets?: string[];
     default_template_sets?: string[];
 }
+export interface MandatoryRulesSection {
+    setId: string;
+    block: string;
+}
 export interface MandatoryRulesInjection {
     block: string;
+    sections: MandatoryRulesSection[];
     setsLoaded: string[];
     ruleCount: number;
     inlineRulesCount: number;

package/dist/types/specialist/mandatory-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mandatory-rules.d.ts","sourceRoot":"","sources":["../../../src/specialist/mandatory-rules.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,UAAU,mBAAmB;IAC3B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAwB/E;AAiKD,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GACpG,uBAAuB,CA4BzB;AAED,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAEtJ"}
+{"version":3,"file":"mandatory-rules.d.ts","sourceRoot":"","sources":["../../../src/specialist/mandatory-rules.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,UAAU,mBAAmB;IAC3B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAsBD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAwB/E;AAoKD,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GACpG,uBAAuB,CA6BzB;AAED,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,8BAA8B,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAEtJ"}

package/dist/types/specialist/observability-sqlite.d.ts

@@ -257,5 +257,6 @@ export interface ObservabilitySqliteClient {
 }
 export declare function hasRunCompleteEvent(jobId: string, cwd?: string): boolean;
 export declare function createObservabilitySqliteClient(cwd?: string): ObservabilitySqliteClient | null;
+export declare function createObservabilitySqliteClientAtPath(dbPath: string): ObservabilitySqliteClient | null;
 export {};
 //# sourceMappingURL=observability-sqlite.d.ts.map