@fro.bot/systematic 2.14.4 → 2.15.0

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   findCommandsInDir,
   findSkillsInDir,
   getConfigPaths
-} from "./index-7100fhg3.js";
+} from "./index-6xnehr4s.js";
 
 // src/cli.ts
 import fs from "fs";

package/dist/{index-7100fhg3.js → index-6xnehr4s.js}

@@ -15684,6 +15684,161 @@ var OPENCODE_AGENT_COLOR_TOKENS = [
   "info"
 ];
 
+// src/lib/bundled-names.ts
+var BUNDLED_AGENT_NAMES = [
+  "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"
+];
+var BUNDLED_AGENT_QUALIFIED_IDS = [
+  "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"
+];
+var BUNDLED_SKILL_NAMES = [
+  "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-swarms",
+  "proof",
+  "rclone",
+  "report-bug-ce",
+  "reproduce-bug",
+  "resolve-pr-feedback",
+  "setup",
+  "slfg",
+  "test-browser",
+  "test-xcode",
+  "todo-create",
+  "todo-resolve",
+  "todo-triage",
+  "using-systematic",
+  "writing-systematic-skills"
+];
+
 // src/lib/config-schema.ts
 var permissionSettingSchema = exports_external.enum(["ask", "allow", "deny"]);
 var permissionRuleSchema = exports_external.union([
@@ -15813,21 +15968,31 @@ var SystematicConfigSchema = exports_external.object({
       "https://fro.bot/systematic/schemas/v2/systematic-config.schema.json"
     ]
   }),
-  agents: exports_external.record(exports_external.string(), AgentOverlaySchema).default({}).meta({
-    description: "Per-agent configuration overlays keyed by agent name",
-    examples: [{ "correctness-reviewer": { temperature: 0.1 } }, {}]
+  agents: exports_external.object(Object.fromEntries([...BUNDLED_AGENT_NAMES, ...BUNDLED_AGENT_QUALIFIED_IDS].map((name) => [name, AgentOverlaySchema.optional()]))).strict().default({}).meta({
+    description: "Per-agent configuration overlays keyed by bundled agent name (bare or qualified category/name). Unknown keys are rejected with a Zod parse error. To overlay a user-defined agent, configure it through OpenCode-native config (.opencode/opencode.json) instead.",
+    examples: [
+      { "correctness-reviewer": { temperature: 0.1 } },
+      { "review/correctness-reviewer": { temperature: 0.1 } },
+      {}
+    ]
   }),
   categories: exports_external.record(exports_external.string(), CategoryOverlaySchema).default({}).meta({
     description: "Per-category configuration overlays keyed by category name",
     examples: [{ review: { model: "anthropic/claude-opus-4-7" } }, {}]
   }),
-  disabled_skills: exports_external.array(exports_external.string()).default([]).meta({
-    description: "Array of skill names to disable globally",
+  disabled_skills: exports_external.array(exports_external.enum(BUNDLED_SKILL_NAMES)).default([]).meta({
+    description: "Array of bundled skill names to disable globally. Unknown skill names are rejected at parse time.",
     examples: [["ce:plan", "ce:review"]]
   }),
-  disabled_agents: exports_external.array(exports_external.string()).default([]).meta({
-    description: "Array of agent names to disable globally",
-    examples: [["previous-comments-reviewer", "cli-readiness-reviewer"]]
+  disabled_agents: exports_external.array(exports_external.enum([
+    ...BUNDLED_AGENT_NAMES,
+    ...BUNDLED_AGENT_QUALIFIED_IDS
+  ])).default([]).meta({
+    description: "Array of bundled agent names (bare or qualified category/name) to disable globally. Unknown agent names are rejected at parse time.",
+    examples: [
+      ["previous-comments-reviewer", "cli-readiness-reviewer"],
+      ["review/security-reviewer"]
+    ]
   }),
   disabled_commands: exports_external.array(exports_external.string()).default([]).meta({
     description: "Array of command names to disable globally",
@@ -15893,12 +16058,32 @@ function loadJsoncFile(filePath) {
   }
   return parsed;
 }
-function throwTopLevelConfigSchemaError(filePath, trust, issues) {
+var TYPED_VALIDATION_DOCS_URL = "https://systematic.fro.bot/getting-started/configuration#typed-validation";
+var TYPED_KEY_FIELDS = new Set([
+  "agents",
+  "disabled_agents",
+  "disabled_skills"
+]);
+function enrichUnrecognizedKeyIssues(issues) {
+  return issues.map((issue2) => {
+    if (issue2.code !== "unrecognized_keys")
+      return issue2;
+    const topField = issue2.path[0];
+    if (typeof topField !== "string" || !TYPED_KEY_FIELDS.has(topField)) {
+      return issue2;
+    }
+    const badKey = issue2.message.match(/"([^"]+)"/)?.[1] ?? "";
+    const hint = badKey ? `Unrecognized key '${badKey}' in \`${topField}\`. This must be a bundled name. See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.` : `${issue2.message} See ${TYPED_VALIDATION_DOCS_URL} for the full list of valid names.`;
+    return { ...issue2, message: hint };
+  });
+}
+function throwTopLevelConfigSchemaError(filePath, trust, rawIssues) {
+  const issues = enrichUnrecognizedKeyIssues(rawIssues);
   const issue2 = issues[0];
   if (!issue2) {
     throw Object.assign(new Error(`Invalid Systematic config in ${filePath}: schema validation failed`), { _tag: "ConfigSchemaError", filePath, trust, issues });
   }
-  const fieldPath = issue2.code === "unrecognized_keys" ? issue2.message.match(/"([^"]+)"/)?.[1] ?? issue2.path.join(".") : issue2.path.join(".");
+  const fieldPath = issue2.code === "unrecognized_keys" ? null : issue2.path.join(".");
   const message = fieldPath ? `Invalid Systematic config in ${filePath}: ${fieldPath} ${issue2.message}` : `Invalid Systematic config in ${filePath}: ${issue2.message}`;
   throw Object.assign(new Error(message), {
     _tag: "ConfigSchemaError",

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   loadConfig,
   loadConfigWithSources,
   parseFrontmatter
-} from "./index-7100fhg3.js";
+} from "./index-6xnehr4s.js";
 
 // src/index.ts
 import fs5 from "fs";
@@ -634,6 +634,7 @@ function emptyAvailability() {
 var MAX_CACHE_FILE_BYTES = 16 * 1024 * 1024;
 var DEFAULT_API_TIMEOUT_MS = 1500;
 var MODELS_JSON_FILENAME = "models.json";
+var availabilityCache = new WeakMap;
 function resolveCacheDir() {
   const xdgCacheHome = process.env.XDG_CACHE_HOME?.trim();
   const cacheBase = xdgCacheHome && path5.isAbsolute(xdgCacheHome) ? xdgCacheHome : path5.join(os2.homedir(), ".cache");
@@ -739,9 +740,19 @@ function buildSetFromProviders(providers) {
   return result;
 }
 async function getAvailableModels(client, options = {}) {
+  const cached = availabilityCache.get(client);
+  if (cached !== undefined) {
+    return cached;
+  }
+  const cacheAndReturn = (envelope) => {
+    if (envelope.status !== "unknown") {
+      availabilityCache.set(client, envelope);
+    }
+    return envelope;
+  };
   const timeoutMs = options.apiTimeoutMs === undefined ? DEFAULT_API_TIMEOUT_MS : options.apiTimeoutMs;
   if (typeof client.config?.providers !== "function") {
-    return readFallbackCache();
+    return cacheAndReturn(readFallbackCache());
   }
   const apiCall = client.config.providers();
   let response;
@@ -757,24 +768,24 @@ async function getAvailableModels(client, options = {}) {
       const raced = await Promise.race([apiCall, timeoutPromise]);
       if (raced === TIMEOUT_SENTINEL) {
         console.warn(`[systematic] client.config.providers() exceeded ${timeoutMs}ms; falling back to models.json cache.`);
-        return readFallbackCache();
+        return cacheAndReturn(readFallbackCache());
       }
       response = raced;
     }
   } catch {
-    return readFallbackCache();
+    return cacheAndReturn(readFallbackCache());
   }
   if (response.error !== undefined || response.data === undefined) {
-    return readFallbackCache();
+    return cacheAndReturn(readFallbackCache());
   }
   const models = buildSetFromProviders(response.data.providers);
   if (models.size === 0) {
-    return emptyAvailability();
+    return cacheAndReturn(emptyAvailability());
   }
-  return {
+  return cacheAndReturn({
     status: "api",
     models
-  };
+  });
 }
 
 // src/lib/config-handler.ts

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

@@ -0,0 +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-swarms", "proof", "rclone", "report-bug-ce", "reproduce-bug", "resolve-pr-feedback", "setup", "slfg", "test-browser", "test-xcode", "todo-create", "todo-resolve", "todo-triage", "using-systematic", "writing-systematic-skills"];
+export type BundledAgentName = (typeof BUNDLED_AGENT_NAMES)[number];
+export type BundledSkillName = (typeof BUNDLED_SKILL_NAMES)[number];