@really-knows-ai/foundry 3.3.8 → 3.3.9

package/dist/.opencode/plugins/foundry-tools/orchestrate-tool.js

@@ -110,6 +110,7 @@ export function createOrchestrateTool({ tool, pending }) {
           error: tool.schema.string().optional(),
         }).optional(),
         cycleDef: tool.schema.string().optional().describe('Test-mode cycle definition override (path to cycle file)'),
+        defaultModel: tool.schema.string().optional().describe('Fallback model for stages with no explicit model in the cycle definition (e.g. "opencode-go/deepseek-v4-flash")'),
       },
 
       async execute(args, context) {
@@ -145,6 +146,7 @@ export function createOrchestrateTool({ tool, pending }) {
             cwd, cycleDef: args.cycleDef, git, mint, finalize,
             now: () => Date.now(),
             lastResult: args.lastResult ?? null,
+            defaultModel: args.defaultModel,
           }, io);
 
           await injectDispatchPromptExtras(result, cwd);

package/dist/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [3.3.9] - 2026-05-19
+
+### Fixed
+
+- **Stage model fallback.** When a cycle's `models:` map omits a stage (e.g.,
+  `quench`), the orchestrator now falls back to the caller's `defaultModel`,
+  then `models.default`, then any available model in the map, instead of
+  failing with a hard violation. `foundry_orchestrate` accepts an optional
+  `defaultModel` arg for this purpose.
+- **No-models-map fallback.** When the cycle has no `models:` block at all but
+  `defaultModel` is provided, the orchestrator uses it — previously returned
+  a violation.
+
 ## [3.3.8] - 2026-05-19
 
 ### Fixed

package/dist/scripts/orchestrate.js

@@ -87,6 +87,7 @@ function buildSortArgs(args, now) {
     mint: args.mint,
     now: typeof now === 'function' ? now() : now,
     ulid: args.ulid ?? defaultUlid,
+    defaultModel: args.defaultModel,
   };
 }
 

package/dist/scripts/sort.js

@@ -147,10 +147,26 @@ function resolveRoute(ctx) {
   return determineRoute(ctx.stages, ctx.history, ctx.feedback, ctx.maxIterations);
 }
 
-function resolveModel(route, frontmatter, agentsDir, io) {
-  const routeBase = baseStage(route);
-  if (!frontmatter.models || !frontmatter.models[routeBase]) return null;
-  const modelId = frontmatter.models[routeBase];
+function firstModelValue(models) {
+  if (!models) return undefined;
+  const keys = Object.keys(models);
+  return keys.length > 0 ? models[keys[0]] : undefined;
+}
+
+function resolveModelId(routeBase, models, defaultModel) {
+  return models[routeBase] || defaultModel || models.default || firstModelValue(models);
+}
+
+function pickModelId(route, frontmatter, defaultModel) {
+  const models = frontmatter.models;
+  if (!models) return defaultModel || null;
+  return resolveModelId(baseStage(route), models, defaultModel) || null;
+}
+
+function resolveModel(route, frontmatter, agentsDir, io, defaultModel) {
+  const modelId = pickModelId(route, frontmatter, defaultModel);
+  if (!modelId) return null;
+
   const model = `foundry-${modelId.replace(/[/.]/g, '-')}`;
   const agentPath = `${agentsDir}/${model}.md`;
   if (!io.exists(agentPath)) {
@@ -162,8 +178,8 @@ function resolveModel(route, frontmatter, agentsDir, io) {
   return model;
 }
 
-function checkModel(route, frontmatter, agentsDir, io) {
-  const modelResult = resolveModel(route, frontmatter, agentsDir, io);
+function checkModel(route, frontmatter, agentsDir, io, defaultModel) {
+  const modelResult = resolveModel(route, frontmatter, agentsDir, io, defaultModel);
   if (modelResult && modelResult.error) return { error: modelResult.error };
   return { model: typeof modelResult === 'string' ? modelResult : null };
 }
@@ -217,6 +233,7 @@ const RUN_SORT_DEFAULTS = Object.freeze({
   historyPath: 'WORK.history.yaml',
   foundryDir: 'foundry',
   cycleDef: undefined,
+  defaultModel: undefined,
   agentsDir: '.opencode/agents',
   mint: undefined,
 });
@@ -246,7 +263,7 @@ export function runSort(args = {}, io = defaultIO) {
   if (prep.kind !== 'ok') return { route: prep.kind, details: prep.details };
 
   const route = resolveRoute(buildRouteCtx(prep));
-  const modelCheck = checkModel(route, prep.frontmatter, opts.agentsDir, io);
+  const modelCheck = checkModel(route, prep.frontmatter, opts.agentsDir, io, opts.defaultModel);
   if (modelCheck.error) return { route: 'violation', details: modelCheck.error };
 
   return mintToken({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@really-knows-ai/foundry",
-  "version": "3.3.8",
+  "version": "3.3.9",
   "description": "A skill-driven framework for governed artefact generation with AI coding tools. Define your own artefact types, laws, and flows — Foundry handles the forge → quench → appraise pipeline with deterministic routing, quality gates, and iterative refinement.",
   "type": "module",
   "main": "dist/.opencode/plugins/foundry.js",