@fro.bot/systematic 2.33.2 → 3.0.0

package/dist/index.js

@@ -2,7 +2,6 @@
 import {
   AgentOverlaySchema,
   CategoryOverlaySchema,
-  convertFileWithCache,
   exports_external,
   extractAgentFrontmatter,
   extractCommandFrontmatter,
@@ -15,15 +14,15 @@ import {
   loadConfigWithSources,
   parseFrontmatter,
   walkDir
-} from "./index-vyzhzvap.js";
+} from "./index-yskzf7vh.js";
 
 // src/index.ts
-import fs6 from "fs";
+import fs8 from "fs";
 import path9 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/lib/bootstrap.ts
-import fs from "fs";
+import fs2 from "fs";
 import os from "os";
 import path2 from "path";
 
@@ -31,6 +30,7 @@ import path2 from "path";
 import { pathToFileURL } from "url";
 
 // src/lib/skill-loader.ts
+import fs from "fs";
 import path from "path";
 var SKILL_PREFIX = "systematic:";
 var SKILL_DESCRIPTION_PREFIX = "(Systematic) ";
@@ -66,10 +66,8 @@ function extractSkillBody(wrappedTemplate) {
 }
 function loadSkill(skillInfo) {
   try {
-    const converted = convertFileWithCache(skillInfo.skillFile, "skill", {
-      source: "bundled"
-    });
-    const { body } = parseFrontmatter(converted);
+    const content = fs.readFileSync(skillInfo.skillFile, "utf8");
+    const { body } = parseFrontmatter(content);
     const wrappedTemplate = wrapSkillTemplate(skillInfo.skillFile, body);
     return {
       name: skillInfo.name,
@@ -83,8 +81,7 @@ function loadSkill(skillInfo) {
       subtask: skillInfo.subtask,
       agent: skillInfo.agent,
       model: skillInfo.model,
-      argumentHint: skillInfo.argumentHint,
-      deprecated: skillInfo.deprecated
+      argumentHint: skillInfo.argumentHint
     };
   } catch {
     return null;
@@ -193,7 +190,7 @@ ${content}` : content;
 };
 function getSkillUsageTemplate() {
   return `**Skills naming:**
-- Systematic bundled skills use the \`systematic:\` prefix (e.g., \`systematic:setup\`)
+- Systematic bundled skills use the \`systematic:\` prefix (e.g., \`systematic:onboarding\`)
 - Workflow skills with their own namespace keep it (e.g., \`ce:brainstorm\`)
 - Skills can also be invoked without prefix if unambiguous
 
@@ -205,22 +202,22 @@ function getSkillUsageTemplate() {
 Bundled skills ship with the Systematic plugin and are discoverable via \`systematic_skill\`.`;
 }
 function getBootstrapContent(config, deps) {
-  const { bundledSkillsDir } = deps;
+  const { bundledSkillsDir, usageTemplate } = deps;
   if (!config.bootstrap.enabled)
     return null;
   if (config.bootstrap.file) {
     const customPath = config.bootstrap.file.startsWith("~/") ? path2.join(os.homedir(), config.bootstrap.file.slice(2)) : config.bootstrap.file;
-    if (fs.existsSync(customPath)) {
-      return fs.readFileSync(customPath, "utf8");
+    if (fs2.existsSync(customPath)) {
+      return fs2.readFileSync(customPath, "utf8");
     }
   }
   const usingSystematicPath = path2.join(bundledSkillsDir, "using-systematic/SKILL.md");
-  if (!fs.existsSync(usingSystematicPath))
+  if (!fs2.existsSync(usingSystematicPath))
     return null;
-  const fullContent = fs.readFileSync(usingSystematicPath, "utf8");
+  const fullContent = fs2.readFileSync(usingSystematicPath, "utf8");
   const { body } = parseFrontmatter(fullContent);
   const content = body.trim();
-  const skillUsage = getSkillUsageTemplate();
+  const skillUsage = usageTemplate ?? getSkillUsageTemplate();
   const catalog = renderCatalogVerbose({
     bundledSkillsDir,
     disabledSkills: config.disabled_skills
@@ -240,11 +237,12 @@ ${skillUsage}${catalogSection}
 }
 
 // src/lib/config-handler.ts
+import fs6 from "fs";
 import os3 from "os";
 import path7 from "path";
 
 // src/lib/agent-overlays.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import path4 from "path";
 
 // src/lib/source-model-defaults.ts
@@ -323,27 +321,6 @@ var SOURCE_CATEGORY_MODEL_DEFAULTS = {
       }
     ]
   },
-  docs: {
-    rationale: "Documentation and summarization tasks should start cheaper and faster; quality is sufficient at mid-tier models.",
-    providers: [
-      {
-        provider: "github-copilot",
-        models: [{ model: "gemini-3.1-pro-preview" }]
-      },
-      {
-        provider: "openai",
-        models: [{ model: "gpt-5.4-mini" }]
-      },
-      {
-        provider: "anthropic",
-        models: [{ model: "claude-haiku-4-5" }]
-      },
-      {
-        provider: "opencode",
-        models: [{ model: "claude-haiku-4-5" }]
-      }
-    ]
-  },
   "document-review": {
     rationale: "Requirements and plan critique benefit from the strongest nuanced reasoning to surface non-obvious gaps and contradictions.",
     providers: [
@@ -507,22 +484,6 @@ function resolveAgentOverlaySet(overlays) {
     categoriesByKey: new Map(overlays.categories.map((overlay) => [overlay.key, overlay]))
   };
 }
-function inferBuiltInTemperature(name, description) {
-  const sample = `${name} ${description ?? ""}`.toLowerCase();
-  if (/(review|audit|security|sentinel|oracle|lint|verification|guardian)/.test(sample)) {
-    return 0.1;
-  }
-  if (/(plan|planning|architecture|strategist|analysis|research)/.test(sample)) {
-    return 0.2;
-  }
-  if (/(doc|readme|changelog|editor|writer)/.test(sample)) {
-    return 0.3;
-  }
-  if (/(brainstorm|creative|ideate|design|concept)/.test(sample)) {
-    return 0.6;
-  }
-  return 0.3;
-}
 function assertSourceCategoryModelCoverage(categories) {
   const missingCategories = categories.filter((category) => !Object.hasOwn(SOURCE_CATEGORY_MODEL_DEFAULTS, category));
   if (missingCategories.length > 0) {
@@ -611,14 +572,14 @@ function validateOverlaySkills(overlay, skills, enabledSkills) {
 }
 function readCategoryDirs(agentsDir) {
   try {
-    return fs2.readdirSync(agentsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+    return fs3.readdirSync(agentsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
   } catch {
     return [];
   }
 }
 function readMarkdownFiles(categoryDir) {
   try {
-    return fs2.readdirSync(categoryDir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => entry.name).sort();
+    return fs3.readdirSync(categoryDir, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => entry.name).sort();
   } catch {
     return [];
   }
@@ -631,7 +592,7 @@ function throwConfigError(sourcePath, keyPath, message) {
 }
 
 // src/lib/discovered-skills.ts
-import fs3 from "fs";
+import fs4 from "fs";
 import path5 from "path";
 var SKILL_NAME_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 function isValidSkillName(name) {
@@ -641,7 +602,7 @@ function findGitWorktreeRoot(startDir) {
   let current = path5.resolve(startDir);
   while (true) {
     try {
-      if (fs3.existsSync(path5.join(current, ".git"))) {
+      if (fs4.existsSync(path5.join(current, ".git"))) {
         return current;
       }
     } catch {
@@ -661,7 +622,7 @@ function upWalk(targets, start, stop) {
     for (const target of targets) {
       const candidate = path5.join(current, target);
       try {
-        if (fs3.existsSync(candidate)) {
+        if (fs4.existsSync(candidate)) {
           results.push(candidate);
         }
       } catch {}
@@ -692,7 +653,7 @@ function globSkillFiles(rootDir, subdirNames) {
   for (const subdirName of subdirNames) {
     const scanRoot = path5.join(rootDir, subdirName);
     try {
-      if (!fs3.existsSync(scanRoot))
+      if (!fs4.existsSync(scanRoot))
         continue;
       const entries = walkDir(scanRoot, {
         maxDepth: 10,
@@ -708,7 +669,7 @@ function globSkillFiles(rootDir, subdirNames) {
 function toDiscoveredSkill(skillPath, rootId) {
   let content;
   try {
-    content = fs3.readFileSync(skillPath, "utf8");
+    content = fs4.readFileSync(skillPath, "utf8");
   } catch {
     return;
   }
@@ -757,7 +718,7 @@ function discoverSkills(options) {
 
 // src/lib/model-availability.ts
 import { createHash } from "crypto";
-import fs4 from "fs";
+import fs5 from "fs";
 import os2 from "os";
 import path6 from "path";
 function emptyAvailability() {
@@ -789,7 +750,7 @@ function isProviderRecord(value) {
 function readModelsFromCache(filePath) {
   let fd;
   try {
-    fd = fs4.openSync(filePath, "r");
+    fd = fs5.openSync(filePath, "r");
   } catch {
     return null;
   }
@@ -797,7 +758,7 @@ function readModelsFromCache(filePath) {
   try {
     let stat;
     try {
-      stat = fs4.fstatSync(fd);
+      stat = fs5.fstatSync(fd);
     } catch {
       return null;
     }
@@ -812,7 +773,7 @@ function readModelsFromCache(filePath) {
     const buffer = Buffer.alloc(stat.size);
     let bytesRead;
     try {
-      bytesRead = fs4.readSync(fd, buffer, 0, stat.size, 0);
+      bytesRead = fs5.readSync(fd, buffer, 0, stat.size, 0);
     } catch {
       return null;
     }
@@ -821,7 +782,7 @@ function readModelsFromCache(filePath) {
     raw = buffer.toString("utf8");
   } finally {
     try {
-      fs4.closeSync(fd);
+      fs5.closeSync(fd);
     } catch {}
   }
   if (raw.trim().length === 0)
@@ -956,10 +917,7 @@ function formatAgentDescription(name, description) {
 }
 function loadAgentAsConfig(agentInfo) {
   try {
-    const converted = convertFileWithCache(agentInfo.file, "agent", {
-      source: "bundled",
-      agentMode: "subagent"
-    });
+    const content = fs6.readFileSync(agentInfo.file, "utf8");
     const {
       description,
       prompt,
@@ -974,7 +932,7 @@ function loadAgentAsConfig(agentInfo) {
       steps,
       hidden,
       permission
-    } = extractAgentFrontmatter(converted);
+    } = extractAgentFrontmatter(content);
     const config = {
       description: formatAgentDescription(agentInfo.name, description),
       prompt
@@ -1008,11 +966,9 @@ function loadAgentAsConfig(agentInfo) {
 }
 function loadCommandAsConfig(commandInfo) {
   try {
-    const converted = convertFileWithCache(commandInfo.file, "command", {
-      source: "bundled"
-    });
-    const { name, description, agent, model, subtask } = extractCommandFrontmatter(converted);
-    const { body } = parseFrontmatter(converted);
+    const content = fs6.readFileSync(commandInfo.file, "utf8");
+    const { name, description, agent, model, subtask } = extractCommandFrontmatter(content);
+    const { body } = parseFrontmatter(content);
     const cleanName = commandInfo.name.replace(/^\//, "");
     const baseDescription = description || `${name || cleanName} command`;
     const wrappedTemplate = `<command-instruction>
@@ -1080,7 +1036,6 @@ function applyAgentOverlays(config, agentInfo, overlays, availabilitySet) {
   if (hasPermissionOverlay && isRecord(config.permission)) {
     addPermissionRules(permissionRules, config.permission);
   }
-  result.temperature = result.temperature ?? inferBuiltInTemperature(agentInfo.name, result.description);
   applySourceModelDefault(result, agentInfo, availabilitySet);
   applyAgentOverlay(result, categoryOverlay?.value, permissionRules);
   applyAgentOverlay(result, exactOverlay?.value, permissionRules);
@@ -1329,10 +1284,66 @@ function normalizePath(path8) {
 }
 
 // src/lib/skill-tool.ts
-import fs5 from "fs";
+import { tool } from "@opencode-ai/plugin/tool";
+
+// src/lib/skill-resolver.ts
+import fs7 from "fs";
 import path8 from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
-import { tool } from "@opencode-ai/plugin/tool";
+function getAllSkills(options) {
+  const { bundledSkillsDir, disabledSkills } = options;
+  return findSkillsInDir(bundledSkillsDir).filter((s) => !disabledSkills.includes(s.name)).map((skillInfo) => loadSkill(skillInfo)).filter((s) => s !== null).sort((a, b) => a.name.localeCompare(b.name));
+}
+function resolveSkill(options, requestedName) {
+  const normalizedName = requestedName.startsWith("systematic:") ? requestedName.slice("systematic:".length) : requestedName;
+  const skills = getAllSkills(options);
+  const matchedSkill = skills.find((s) => s.name === normalizedName);
+  if (!matchedSkill) {
+    const availableSystematic = buildCatalogEntries(options).map((s) => s.prefixedName);
+    throw new Error(`Skill "${requestedName}" not found. Available systematic skills: ${availableSystematic.join(", ")}`);
+  }
+  return matchedSkill;
+}
+function buildSkillToolDescription(options) {
+  const catalog = renderCatalogCompact(options);
+  return `Load a specialized skill that provides domain-specific instructions and workflows.
+
+When you recognize that a task matches one of the available skills listed below, use this tool to load the full skill instructions.
+
+The skill will inject detailed instructions, workflows, and access to bundled resources (scripts, references, templates) into the conversation context.
+
+Tool output includes a \`<skill_content name="...">\` block with the loaded content.
+
+${catalog}`;
+}
+function buildSkillToolParameterHint(options) {
+  const entries = buildCatalogEntries(options);
+  const examples = entries.slice(0, 3).map((s) => `'${s.prefixedName}'`).join(", ");
+  const hint = examples.length > 0 ? ` (e.g., ${examples}, ...)` : "";
+  return `The name of the skill from available_skills${hint}`;
+}
+function buildSkillContentOutput(matchedSkill) {
+  const body = extractSkillBody(matchedSkill.wrappedTemplate);
+  const dir = path8.dirname(matchedSkill.skillFile);
+  const base = pathToFileURL2(dir).href;
+  const files = discoverSkillFiles(dir);
+  const lines = [
+    `<skill_content name="${matchedSkill.prefixedName}">`,
+    `# Skill: ${matchedSkill.prefixedName}`,
+    "",
+    body.trim(),
+    "",
+    `Base directory for this skill: ${base}`,
+    "Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.",
+    "Note: file list is sampled."
+  ];
+  if (files) {
+    lines.push("", "<skill_files>", files, "</skill_files>");
+  }
+  lines.push("</skill_content>");
+  return { output: lines.join(`
+`), dir };
+}
 function discoverSkillFiles(dir, limit = 10) {
   const files = [];
   function shouldSkipDirectory(name) {
@@ -1354,7 +1365,7 @@ function discoverSkillFiles(dir, limit = 10) {
     if (files.length >= limit)
       return;
     try {
-      const entries = fs5.readdirSync(currentDir, { withFileTypes: true });
+      const entries = fs7.readdirSync(currentDir, { withFileTypes: true });
       for (const entry of entries) {
         if (files.length >= limit)
           break;
@@ -1366,46 +1377,11 @@ function discoverSkillFiles(dir, limit = 10) {
   return files.map((file) => `  <file>${file}</file>`).join(`
 `);
 }
-function formatDeprecationMessage(name, deprecated) {
-  let msg = `[systematic] skill "${name}" is deprecated since ${deprecated.since}; will be removed in ${deprecated.removal}.`;
-  if (deprecated.replacement) {
-    msg += ` Replacement: ${deprecated.replacement}`;
-    if (!deprecated.replacement.endsWith(".")) {
-      msg += ".";
-    }
-  }
-  if (deprecated.reason) {
-    msg += ` Reason: ${deprecated.reason}`;
-    if (!deprecated.reason.endsWith(".")) {
-      msg += ".";
-    }
-  }
-  return msg;
-}
+// src/lib/skill-tool.ts
 function createSkillTool(options) {
   const { bundledSkillsDir, disabledSkills } = options;
-  const warnedSkills = new Set;
-  const getAllSkills = () => {
-    return findSkillsInDir(bundledSkillsDir).filter((s) => !disabledSkills.includes(s.name)).map((skillInfo) => loadSkill(skillInfo)).filter((s) => s !== null).sort((a, b) => a.name.localeCompare(b.name));
-  };
-  const buildDescription = () => {
-    const catalog = renderCatalogCompact({ bundledSkillsDir, disabledSkills });
-    return `Load a specialized skill that provides domain-specific instructions and workflows.
-
-When you recognize that a task matches one of the available skills listed below, use this tool to load the full skill instructions.
-
-The skill will inject detailed instructions, workflows, and access to bundled resources (scripts, references, templates) into the conversation context.
-
-Tool output includes a \`<skill_content name="...">\` block with the loaded content.
-
-${catalog}`;
-  };
-  const buildParameterHint = () => {
-    const entries = buildCatalogEntries({ bundledSkillsDir, disabledSkills });
-    const examples = entries.slice(0, 3).map((s) => `'${s.prefixedName}'`).join(", ");
-    const hint = examples.length > 0 ? ` (e.g., ${examples}, ...)` : "";
-    return `The name of the skill from available_skills${hint}`;
-  };
+  const buildDescription = () => buildSkillToolDescription({ bundledSkillsDir, disabledSkills });
+  const buildParameterHint = () => buildSkillToolParameterHint({ bundledSkillsDir, disabledSkills });
   let cachedDescription = null;
   let cachedParameterHint = null;
   return tool({
@@ -1425,24 +1401,8 @@ ${catalog}`;
     },
     async execute(args, context) {
       const requestedName = args.name;
-      const normalizedName = requestedName.startsWith("systematic:") ? requestedName.slice("systematic:".length) : requestedName;
-      const skills = getAllSkills();
-      const matchedSkill = skills.find((s) => s.name === normalizedName);
-      if (!matchedSkill) {
-        const availableSystematic = buildCatalogEntries({
-          bundledSkillsDir,
-          disabledSkills
-        }).map((s) => s.prefixedName);
-        throw new Error(`Skill "${requestedName}" not found. Available systematic skills: ${availableSystematic.join(", ")}`);
-      }
-      if (matchedSkill.deprecated && !warnedSkills.has(matchedSkill.name)) {
-        console.warn(formatDeprecationMessage(matchedSkill.name, matchedSkill.deprecated));
-        warnedSkills.add(matchedSkill.name);
-      }
-      const body = extractSkillBody(matchedSkill.wrappedTemplate);
-      const dir = path8.dirname(matchedSkill.skillFile);
-      const base = pathToFileURL2(dir).href;
-      const files = discoverSkillFiles(dir);
+      const matchedSkill = resolveSkill({ bundledSkillsDir, disabledSkills }, requestedName);
+      const { output, dir } = buildSkillContentOutput(matchedSkill);
       await context.ask({
         permission: "skill",
         patterns: [matchedSkill.prefixedName],
@@ -1456,22 +1416,7 @@ ${catalog}`;
           dir
         }
       });
-      const output = [
-        `<skill_content name="${matchedSkill.prefixedName}">`,
-        `# Skill: ${matchedSkill.prefixedName}`,
-        "",
-        body.trim(),
-        "",
-        `Base directory for this skill: ${base}`,
-        "Relative paths in this skill (e.g., scripts/, reference/) are relative to this base directory.",
-        "Note: file list is sampled."
-      ];
-      if (files) {
-        output.push("", "<skill_files>", files, "</skill_files>");
-      }
-      output.push("</skill_content>");
-      return output.join(`
-`);
+      return output;
     }
   });
 }
@@ -1485,9 +1430,9 @@ var bundledCommandsDir = path9.join(packageRoot2, "commands");
 var packageJsonPath = path9.join(packageRoot2, "package.json");
 var getPackageVersion = () => {
   try {
-    if (!fs6.existsSync(packageJsonPath))
+    if (!fs8.existsSync(packageJsonPath))
       return "unknown";
-    const content = fs6.readFileSync(packageJsonPath, "utf8");
+    const content = fs8.readFileSync(packageJsonPath, "utf8");
     const parsed = JSON.parse(content);
     return parsed.version ?? "unknown";
   } catch {

package/dist/lib/agent-overlays.d.ts

@@ -41,5 +41,4 @@ export interface ResolvedAgentOverlaySet {
 export declare function buildBundledAgentInventory(agentsDir: string, disabledAgents: string[]): BundledAgentInventory;
 export declare function validateAgentOverlays({ inventory, overlays, nativeAgents, enabledSkills, }: ValidateAgentOverlaysOptions): ValidatedAgentOverlays;
 export declare function resolveAgentOverlaySet(overlays: ValidatedAgentOverlays): ResolvedAgentOverlaySet;
-export declare function inferBuiltInTemperature(name: string, description?: string): number;
 export declare function assertSourceCategoryModelCoverage(categories: string[]): void;

package/dist/lib/agent-resolver.d.ts

@@ -0,0 +1,28 @@
+/** Runtime persona catalog for `systematic_delegate`. Pi has no agent-discovery of its own, so category is dropped when flattening `agents/<category>/<name>.md` into this catalog. */
+/** A single resolved persona entry in the flattened catalog. */
+export interface AgentCatalogEntry {
+    /** Flat persona name (category dropped). */
+    name: string;
+    /** Human-readable description, used in tool description/parameter hints. */
+    description: string;
+    /** Full persona system-prompt body (frontmatter stripped). */
+    body: string;
+    /** Raw comma-separated `tools:` frontmatter value, if declared. Undefined = not declared. */
+    toolsSource: string | undefined;
+}
+/** Fails closed if the same persona name appears under more than one category. */
+export declare function buildAgentCatalog(agentsDir: string): AgentCatalogEntry[];
+/** Resolves a persona by exact flat name from the catalog. */
+export declare function resolveAgent(catalog: AgentCatalogEntry[], name: string): AgentCatalogEntry | undefined;
+/**
+ * Deterministic, bounded description of available personas for the delegation
+ * tool's description/parameter hint text. Stable ordering (catalog is pre-sorted).
+ */
+export declare function renderAgentCatalogCompact(catalog: AgentCatalogEntry[]): string;
+/** Pi built-in read-only tool names used as the default allowlist. */
+export declare const DEFAULT_READONLY_TOOLS: readonly ["read", "grep", "find", "ls"];
+export interface ResolvedToolAllowlist {
+    tools: string[];
+}
+/** Undeclared tools use the read-only default; unknown or `Task` declarations fail closed. */
+export declare function resolveToolAllowlist(toolsSource: string | undefined): ResolvedToolAllowlist;

package/dist/lib/bootstrap.d.ts

@@ -20,5 +20,12 @@ export declare const applyBootstrapContent: (output: {
 }, content: string) => void;
 export interface BootstrapDeps {
     bundledSkillsDir: string;
+    usageTemplate?: string;
 }
-export declare function getBootstrapContent(config: SystematicConfig, deps: BootstrapDeps): string | null;
+type BootstrapContentConfig = Pick<SystematicConfig, 'bootstrap' | 'disabled_skills'>;
+/** Safely computes default bootstrap content, returning null instead of throwing. */
+export declare function computeBootstrapContentSafe(deps: BootstrapDeps, reportError?: (error: unknown) => void): string | null;
+/** Composes an existing system prompt with nullable bootstrap content; returns null when bootstrapContent is null. */
+export declare function composeSystemPromptWithBootstrap(existingSystemPrompt: string, bootstrapContent: string | null): string | null;
+export declare function getBootstrapContent(config: BootstrapContentConfig, deps: BootstrapDeps): string | null;
+export {};

package/dist/lib/bundled-names.d.ts

@@ -1,5 +1,5 @@
-export declare const BUNDLED_AGENT_NAMES: readonly ["adversarial-document-reviewer", "adversarial-reviewer", "agent-native-reviewer", "ankane-readme-writer", "api-contract-reviewer", "architecture-strategist", "best-practices-researcher", "bug-reproduction-validator", "cli-agent-readiness-reviewer", "cli-readiness-reviewer", "code-simplicity-reviewer", "coherence-reviewer", "correctness-reviewer", "data-integrity-guardian", "data-migration-expert", "data-migrations-reviewer", "deployment-verification-agent", "design-implementation-reviewer", "design-iterator", "design-lens-reviewer", "dhh-rails-reviewer", "feasibility-reviewer", "figma-design-sync", "framework-docs-researcher", "git-history-analyzer", "issue-intelligence-analyst", "julik-frontend-races-reviewer", "kieran-python-reviewer", "kieran-rails-reviewer", "kieran-typescript-reviewer", "learnings-researcher", "lint", "maintainability-reviewer", "pattern-recognition-specialist", "performance-oracle", "performance-reviewer", "pr-comment-resolver", "previous-comments-reviewer", "product-lens-reviewer", "project-standards-reviewer", "reliability-reviewer", "repo-research-analyst", "schema-drift-detector", "scope-guardian-reviewer", "security-lens-reviewer", "security-reviewer", "security-sentinel", "slack-researcher", "spec-flow-analyzer", "systematic-implementer", "testing-reviewer"];
-export declare const BUNDLED_AGENT_QUALIFIED_IDS: readonly ["design/design-implementation-reviewer", "design/design-iterator", "design/figma-design-sync", "docs/ankane-readme-writer", "document-review/adversarial-document-reviewer", "document-review/coherence-reviewer", "document-review/design-lens-reviewer", "document-review/feasibility-reviewer", "document-review/product-lens-reviewer", "document-review/scope-guardian-reviewer", "document-review/security-lens-reviewer", "research/best-practices-researcher", "research/framework-docs-researcher", "research/git-history-analyzer", "research/issue-intelligence-analyst", "research/learnings-researcher", "research/repo-research-analyst", "research/slack-researcher", "review/adversarial-reviewer", "review/agent-native-reviewer", "review/api-contract-reviewer", "review/architecture-strategist", "review/cli-agent-readiness-reviewer", "review/cli-readiness-reviewer", "review/code-simplicity-reviewer", "review/correctness-reviewer", "review/data-integrity-guardian", "review/data-migration-expert", "review/data-migrations-reviewer", "review/deployment-verification-agent", "review/dhh-rails-reviewer", "review/julik-frontend-races-reviewer", "review/kieran-python-reviewer", "review/kieran-rails-reviewer", "review/kieran-typescript-reviewer", "review/maintainability-reviewer", "review/pattern-recognition-specialist", "review/performance-oracle", "review/performance-reviewer", "review/previous-comments-reviewer", "review/project-standards-reviewer", "review/reliability-reviewer", "review/schema-drift-detector", "review/security-reviewer", "review/security-sentinel", "review/testing-reviewer", "workflow/bug-reproduction-validator", "workflow/lint", "workflow/pr-comment-resolver", "workflow/spec-flow-analyzer", "workflow/systematic-implementer"];
-export declare const BUNDLED_SKILL_NAMES: readonly ["agent-browser", "agent-native-architecture", "agent-native-audit", "andrew-kane-gem-writer", "ce:brainstorm", "ce:compound", "ce:compound-refresh", "ce:ideate", "ce:plan", "ce:review", "ce:work", "changelog", "claude-permissions-optimizer", "compound-docs", "deepen-plan", "deploy-docs", "dhh-rails-style", "document-review", "dspy-ruby", "every-style-editor", "feature-video", "frontend-design", "gemini-imagegen", "generate_command", "git-clean-gone-branches", "git-commit", "git-commit-push-pr", "git-worktree", "lfg", "onboarding", "orchestrating-subagents", "orchestrating-swarms", "proof", "rclone", "report-bug-ce", "reproduce-bug", "resolve-pr-feedback", "setup", "slfg", "test-browser", "test-driven-development", "test-xcode", "todo-create", "todo-resolve", "todo-triage", "using-systematic", "writing-skills", "writing-systematic-skills"];
+export declare const BUNDLED_AGENT_NAMES: readonly ["adversarial-document-reviewer", "adversarial-reviewer", "agent-native-reviewer", "api-contract-reviewer", "architecture-strategist", "best-practices-researcher", "bug-reproduction-validator", "cli-readiness-reviewer", "code-simplicity-reviewer", "coherence-reviewer", "correctness-reviewer", "data-migrations-reviewer", "deployment-verification-agent", "design-iterator", "design-lens-reviewer", "feasibility-reviewer", "framework-docs-researcher", "git-history-analyzer", "issue-intelligence-analyst", "kieran-typescript-reviewer", "learnings-researcher", "maintainability-reviewer", "pattern-recognition-specialist", "performance-reviewer", "pr-comment-resolver", "previous-comments-reviewer", "product-lens-reviewer", "project-standards-reviewer", "reliability-reviewer", "repo-research-analyst", "scope-guardian-reviewer", "security-lens-reviewer", "security-reviewer", "slack-researcher", "spec-flow-analyzer", "systematic-implementer", "testing-reviewer"];
+export declare const BUNDLED_AGENT_QUALIFIED_IDS: readonly ["design/design-iterator", "document-review/adversarial-document-reviewer", "document-review/coherence-reviewer", "document-review/design-lens-reviewer", "document-review/feasibility-reviewer", "document-review/product-lens-reviewer", "document-review/scope-guardian-reviewer", "document-review/security-lens-reviewer", "research/best-practices-researcher", "research/framework-docs-researcher", "research/git-history-analyzer", "research/issue-intelligence-analyst", "research/learnings-researcher", "research/repo-research-analyst", "research/slack-researcher", "review/adversarial-reviewer", "review/agent-native-reviewer", "review/api-contract-reviewer", "review/architecture-strategist", "review/cli-readiness-reviewer", "review/code-simplicity-reviewer", "review/correctness-reviewer", "review/data-migrations-reviewer", "review/deployment-verification-agent", "review/kieran-typescript-reviewer", "review/maintainability-reviewer", "review/pattern-recognition-specialist", "review/performance-reviewer", "review/previous-comments-reviewer", "review/project-standards-reviewer", "review/reliability-reviewer", "review/security-reviewer", "review/testing-reviewer", "workflow/bug-reproduction-validator", "workflow/pr-comment-resolver", "workflow/spec-flow-analyzer", "workflow/systematic-implementer"];
+export declare const BUNDLED_SKILL_NAMES: readonly ["agent-browser", "agent-native-architecture", "agent-native-audit", "ce:brainstorm", "ce:compound", "ce:compound-refresh", "ce:ideate", "ce:plan", "ce:review", "ce:work", "compound-docs", "deepen-plan", "deploy-docs", "document-review", "frontend-design", "git-clean-gone-branches", "git-commit", "git-commit-push-pr", "git-worktree", "lfg", "onboarding", "orchestrating-subagents", "report-bug-ce", "reproduce-bug", "resolve-pr-feedback", "slfg", "test-browser", "test-driven-development", "todos", "using-systematic", "writing-skills"];
 export type BundledAgentName = (typeof BUNDLED_AGENT_NAMES)[number];
 export type BundledSkillName = (typeof BUNDLED_SKILL_NAMES)[number];

package/dist/lib/pi-delegate-session.d.ts

@@ -0,0 +1,31 @@
+/** Real Pi session-construction for `systematic_delegate`. `noExtensions: true` is the structural depth-1 boundary preventing the child from re-registering `systematic_delegate` or any project/user extension. */
+import type { CreateAgentSessionOptions, CreateAgentSessionResult, ResourceLoader } from '@earendil-works/pi-coding-agent';
+import { DefaultResourceLoader, SessionManager } from '@earendil-works/pi-coding-agent';
+/** `DefaultResourceLoaderOptions` is not exported by the package, so it's derived from the constructor's parameter type. */
+type DefaultResourceLoaderOptions = ConstructorParameters<typeof DefaultResourceLoader>[0];
+import type { CreateDelegateSession } from './pi-delegate-tool.js';
+export interface PiDelegateSessionRuntime {
+    getAgentDir: () => string;
+    createResourceLoader: (options: DefaultResourceLoaderOptions) => ResourceLoader & {
+        reload: () => Promise<void>;
+    };
+    createInMemorySessionManager: (cwd: string) => ReturnType<typeof SessionManager.inMemory>;
+    createAgentSession: (options: CreateAgentSessionOptions) => Promise<CreateAgentSessionResult>;
+}
+export declare const REAL_PI_DELEGATE_SESSION_RUNTIME: PiDelegateSessionRuntime;
+export declare function buildDelegateResourceLoaderOptions(options: {
+    cwd: string;
+    agentDir: string;
+    systemPromptOverride: string;
+}): DefaultResourceLoaderOptions;
+export declare function buildDelegateAgentSessionOptions(options: {
+    cwd: string;
+    agentDir: string;
+    model: CreateAgentSessionOptions['model'];
+    allowedToolNames: string[];
+    resourceLoader: ResourceLoader;
+    sessionManager: ReturnType<typeof SessionManager.inMemory>;
+}): CreateAgentSessionOptions;
+export declare function createDelegateSessionWith(runtime: PiDelegateSessionRuntime): CreateDelegateSession;
+export declare const createRealPiDelegateSession: CreateDelegateSession;
+export {};

package/dist/lib/pi-delegate-tool.d.ts

@@ -0,0 +1,42 @@
+/** Pi-specific adapter factory for the `systematic_delegate` tool. `noExtensions: true` is the structural depth-1 boundary; max turns is fixed at 20. */
+import type { ExtensionContext, ToolDefinition } from '@earendil-works/pi-coding-agent';
+import { Type } from 'typebox';
+import { type AgentCatalogEntry } from './agent-resolver.js';
+/** Fixed, non-configurable delegation bounds (LOCKED). */
+export declare const MAX_DELEGATE_TURNS = 20;
+export declare const DELEGATE_TOOL_NAME = "systematic_delegate";
+export declare const DELEGATE_EXECUTION_MODE: "sequential";
+export type DelegateOutcome = 'completed' | 'turn_limit' | 'aborted' | 'failed';
+/** The parent session's model, narrowed to always-defined (validated before use). */
+export type DelegateParentModel = NonNullable<ExtensionContext['model']>;
+export interface DelegateToolDetails {
+    persona: string;
+    turnCount: number;
+    outcome: DelegateOutcome;
+}
+export interface DelegateSessionLike {
+    subscribe(listener: (event: {
+        type: string;
+    }) => void): () => void;
+    prompt(text: string): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): void;
+    getLastAssistantText(): string | undefined;
+}
+export type CreateDelegateSession = (options: {
+    agentName: string;
+    model: DelegateParentModel;
+    cwd: string;
+    systemPromptOverride: string;
+    allowedToolNames: string[];
+}) => Promise<DelegateSessionLike>;
+export interface PiDelegateToolDeps {
+    catalog: AgentCatalogEntry[];
+    createDelegateSession: CreateDelegateSession;
+}
+export declare function createPiDelegateTool(deps: PiDelegateToolDeps): ToolDefinition<ReturnType<typeof buildDelegateParametersSchema>, DelegateToolDetails>;
+declare function buildDelegateParametersSchema(catalog: AgentCatalogEntry[]): Type.TObject<{
+    agent: Type.TString;
+    task: Type.TString;
+}>;
+export {};

package/dist/lib/removed-names.d.ts

@@ -7,9 +7,9 @@
  * configs that disabled them before removal. Genuinely-unknown names (typos,
  * names that never existed) are still rejected by strict validation.
  *
- * This list is empty until v3 populates it with the first removed names.
- * Add a name here only when the corresponding skill or agent directory is
- * actually deleted from the repo.
+ * These lists were populated as of v3, which removed a batch of bundled
+ * skills and agents. Add a name here only when the corresponding skill or
+ * agent directory is actually deleted from the repo.
  */
 export declare const REMOVED_BUNDLED_SKILL_NAMES: readonly string[];
 export declare const REMOVED_BUNDLED_AGENT_NAMES: readonly string[];