@afokapu/atdd-flow 0.3.58 → 0.3.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-flow",
-  "version": "0.3.58",
+  "version": "0.3.59",
   "description": "Filesystem-first Desk registry for projects, seats, tasks, threads, and handoffs.",
   "type": "module",
   "bin": {

package/src/core.ts

@@ -25,6 +25,8 @@ export type Desk = {
   /** Named commands that model portfolio entries may resolve through. */
   executables?: Record<string, string>;
   aliases?: Record<string, string>;
+  /** Model id used for a role when launch model selection falls back; unlisted roles use the strongest candidate. */
+  fallback_model?: Record<string, string>;
 };
 export type ModelCandidate = {
   id: string;

package/src/pi-runtime-launch.ts

@@ -108,6 +108,15 @@ async function launchEligibleTasks(root: string, record: Seat, address: string)
   return eligible.filter((entry): entry is NonNullable<typeof entry> => Boolean(entry));
 }
 
+/** Fallback is the role's configured model when set (failing closed if unavailable), else the strongest candidate. */
+function fallbackCandidate(config: Desk, role: string, candidates: ModelCandidate[], reason: string) {
+  const configured = config.fallback_model?.[role];
+  if (configured === undefined) return { candidate: candidates[0]! };
+  const candidate = candidates.find((entry) => entry.id === configured);
+  if (!candidate) throw new Error(`fallback_model.${role} names "${configured}", which is not an enabled model with an available executable in models.yaml; refusing launch.`);
+  return { candidate, appliedFallback: { role, model: candidate.id, reason } };
+}
+
 async function chooseLaunchModel(root: string, config: Desk, record: Seat, portfolio: ModelPortfolio, select: (input: ModelSelectionInput) => Promise<ModelSelectionResponse> = selectModel) {
   const candidates = availableModelCandidates(config, portfolio);
   if (!candidates.length) throw new Error("No enabled model in models.yaml has an available executable.");
@@ -128,7 +137,7 @@ async function chooseLaunchModel(root: string, config: Desk, record: Seat, portf
     const reason = !selection.available ? selection.reason : selection.confidence < 0.75
       ? `Jev model selection confidence is low (${selection.confidence}).`
       : `Jev selected a model outside the available portfolio: ${selection.selected_model}.`;
-    return { candidate: candidates[0]!, selection, fallback: reason };
+    return { selection, fallback: reason, ...fallbackCandidate(config, record.role, candidates, reason) };
   }
   return { candidate: required(candidates.find((entry) => entry.id === selection.selected_model), `selected model ${selection.selected_model}`), selection };
 }
@@ -390,7 +399,7 @@ async function verifyRuntime(launch: PreparedLaunch, pane: string, priorPath?: s
 
 function receiptSelection(launch: PreparedLaunch) {
   const { selection } = launch;
-  if (selection.fallback) return { result: "fallback", reason: selection.fallback };
+  if (selection.fallback) return { result: "fallback", reason: selection.fallback, ...(selection.appliedFallback ? { applied_fallback: selection.appliedFallback } : {}) };
   return { result: "selected", confidence: selection.selection.confidence,
     ...(selection.selection.available && selection.selection.model ? { model: selection.selection.model } : {}) };
 }