Function effectiveConcurrencyMode

src/llm/role-resolver.ts:133–161

(
  config: QodexConfig,
  parentProvider: ResolvedRole['provider'],
  subagentProvider: ResolvedRole['provider'],
)

 * fall back) along with a human-readable reason for /roles or wizard output.
 */
export function effectiveConcurrencyMode(
  config: QodexConfig,
  parentProvider: ResolvedRole['provider'],
  subagentProvider: ResolvedRole['provider'],
): { mode: 'sequential' | 'parallel'; reason: string } {
  const configured = (config as any).subagents?.mode as 'off' | 'sequential' | 'parallel' | undefined;
  const policy = (config as any).subagents?.concurrencyMode as 'auto' | 'force' | undefined;

  if (configured !== 'parallel') {
    return { mode: 'sequential', reason: `configured mode = ${configured ?? 'sequential'}` };
  }
  if (policy === 'force') {
    return { mode: 'parallel', reason: 'concurrencyMode=force (override)' };
  }

  // auto policy — parallel only if at least one side is non-local
  const parentLocal = parentProvider === 'ollama';
  const subLocal = subagentProvider === 'ollama';
  if (parentLocal && subLocal) {
    return {
      mode: 'sequential',
      reason: 'both parent and sub-agent are local — single-GPU serialization, parallel offers no speedup',
    };
  }
  return {
    mode: 'parallel',
    reason: `${parentLocal ? 'parent-local' : 'parent-cloud'} + ${subLocal ? 'sub-local' : 'sub-cloud'}: distinct compute paths`,
  };
}