devloom 1.0.0 → 1.2.0

package/scripts/profile.mjs

@@ -0,0 +1,755 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, cpSync } from "fs"
+import { homedir } from "os"
+import { resolve, dirname } from "path"
+import { fileURLToPath } from "url"
+import { execSync } from "child_process"
+import {
+  pluginCacheStatus,
+  refreshOpenCodePluginAgentFiles,
+} from "./plugin-cache.mjs"
+import {
+  isValidModelId,
+  findAvailableCandidate,
+  resolveModelCandidate,
+  capabilitiesFor,
+  modelMeetsRole,
+  roleRequiresVision,
+  MIMO_V26_FLASH_CANDIDATES,
+  DEEPSEEK_V41_FLASH_CANDIDATES,
+  MODEL_FAMILIES,
+  VISION_FALLBACK_CANDIDATES,
+} from "./model-capabilities.mjs"
+
+// Provider-agnostic model helpers re-exported so consumers (commands, tests)
+// can import them from the profile manager as the single entry point.
+export {
+  isValidModelId,
+  findAvailableCandidate,
+  resolveModelCandidate,
+  capabilitiesFor,
+  modelMeetsRole,
+  roleRequiresVision,
+  MIMO_V26_FLASH_CANDIDATES,
+  DEEPSEEK_V41_FLASH_CANDIDATES,
+  MODEL_FAMILIES,
+  VISION_FALLBACK_CANDIDATES,
+}
+
+const CONFIG_PATH = ".opencode/devloom/config.json"
+const AGENTS_DIR = homedir() + "/.config/opencode/agents"
+const SOURCE_AGENTS_DIR = resolve(dirname(new URL(import.meta.url).pathname), "..", "agents")
+
+export const TIERS = {
+  senior: {
+    orchestrator: "opencode-go/deepseek-v4-flash",
+    planner: "opencode-go/glm-5.2",
+    developer: "opencode-go/kimi-k3",
+    qa: "opencode-go/deepseek-v4-pro",
+    verifier: "opencode-go/deepseek-v4-pro",
+    security: "opencode-go/glm-5.2",
+    documenter: "opencode-go/qwen3.7-plus",
+    vision: "opencode-go/glm-5.3-flash",
+    "visual-director": "opencode-go/glm-5.2",
+    "visual-critic": "opencode-go/glm-5.3-flash"
+  },
+  standard: {
+    orchestrator: "opencode-go/deepseek-v4-flash",
+    planner: "opencode-go/qwen3.7-max",
+    developer: "opencode-go/glm-5.3-flash",
+    qa: "opencode-go/deepseek-v4-flash",
+    verifier: "opencode-go/deepseek-v4-flash",
+    security: "opencode-go/deepseek-v4-flash",
+    documenter: "opencode-go/deepseek-v4-flash",
+    vision: "opencode-go/glm-5.3-flash",
+    "visual-director": "opencode-go/glm-5.3-flash",
+    "visual-critic": "opencode-go/glm-5.3-flash"
+  }
+}
+
+export const PROFILES = {
+  go: {
+    orchestrator: "opencode-go/deepseek-v4-flash",
+    planner: "opencode-go/qwen3.7-max",
+    developer: "opencode-go/glm-5.3-flash",
+    qa: "opencode-go/deepseek-v4-pro",
+    verifier: "opencode-go/deepseek-v4-pro",
+    security: "opencode-go/glm-5.2",
+    documenter: "opencode-go/qwen3.7-plus",
+    vision: "opencode-go/glm-5.3-flash",
+    "visual-director": "opencode-go/glm-5.2",
+    "visual-critic": "opencode-go/glm-5.3-flash"
+  },
+  "go-economy": {
+    orchestrator: "opencode-go/deepseek-v4-flash",
+    planner: "opencode-go/deepseek-v4-pro",
+    developer: "opencode-go/deepseek-v4-pro",
+    qa: "opencode-go/deepseek-v4-flash",
+    verifier: "opencode-go/deepseek-v4-flash",
+    security: "opencode-go/deepseek-v4-pro",
+    documenter: "opencode-go/qwen3.7-plus",
+    vision: "opencode-go/glm-5.3-flash",
+    "visual-director": "opencode-go/deepseek-v4-pro",
+    "visual-critic": "opencode-go/glm-5.3-flash"
+  },
+  deepseek: {
+    orchestrator: "opencode-go/deepseek-v4-pro",
+    planner: "opencode-go/deepseek-v4-pro",
+    developer: "opencode-go/deepseek-v4-pro",
+    qa: "opencode-go/deepseek-v4-pro",
+    verifier: "opencode-go/deepseek-v4-flash",
+    security: "opencode-go/deepseek-v4-pro",
+    documenter: "opencode-go/deepseek-v4-flash",
+    vision: "opencode-go/deepseek-v4-flash-vision-exp",
+    "visual-director": "opencode-go/deepseek-v4-pro",
+    "visual-critic": "opencode-go/deepseek-v4-flash-vision-exp"
+  },
+  glm: {
+    orchestrator: "opencode-go/glm-5.3-flash",
+    planner: "opencode-go/glm-5.3-flash",
+    developer: "opencode-go/glm-5.3-flash",
+    qa: "opencode-go/glm-5.3-flash",
+    verifier: "opencode-go/glm-5.3-flash",
+    security: "opencode-go/glm-5.3-flash",
+    documenter: "opencode-go/glm-5.3-flash",
+    vision: "opencode-go/glm-5.3-flash",
+    "visual-director": "opencode-go/glm-5.3-flash",
+    "visual-critic": "opencode-go/glm-5.3-flash"
+  },
+  "go-flash": {
+    orchestrator: "opencode-go/deepseek-v4-flash",
+    planner: "opencode-go/deepseek-v4-flash",
+    developer: "opencode-go/deepseek-v4-flash",
+    qa: "opencode-go/deepseek-v4-flash",
+    verifier: "opencode-go/deepseek-v4-flash",
+    security: "opencode-go/deepseek-v4-flash",
+    documenter: "opencode-go/deepseek-v4-flash",
+    vision: "opencode-go/glm-5.3-flash",
+    "visual-director": "opencode-go/deepseek-v4-flash",
+    "visual-critic": "opencode-go/glm-5.3-flash"
+  }
+}
+
+export const FREE_CANDIDATES_BY_ROLE = {
+  orchestration: ["opencode/big-pickle", "opencode/muse-spark-1.3-contributor-free", "opencode/mimo-v2.5-free", "opencode/muse-spark-1.2-contributor-free", "opencode/nemotron-3.5-lightning-free", "opencode/nemotron-3-ultra-free", "opencode/ling-3.0-flash-fin-free"],
+  planning: ["opencode/nemotron-3-ultra-free", "opencode/muse-spark-1.3-contributor-free", "opencode/muse-spark-1.2-contributor-free", "opencode/big-pickle", "opencode/nemotron-3.5-lightning-free", "opencode/ling-3.0-flash-fin-free"],
+  implementation: ["opencode/big-pickle", "opencode/muse-spark-1.3-contributor-free", "opencode/nemotron-3.5-lightning-free", "opencode/mimo-v2.5-free", "opencode/nemotron-3-ultra-free", "opencode/ling-3.0-flash-fin-free"],
+  verification: ["opencode/big-pickle", "opencode/muse-spark-1.3-contributor-free", "opencode/nemotron-3.5-lightning-free", "opencode/mimo-v2.5-free", "opencode/nemotron-3-ultra-free", "opencode/ling-3.0-flash-fin-free"],
+  documentation: ["opencode/muse-spark-1.3-contributor-free", "opencode/muse-spark-1.2-contributor-free", "opencode/nemotron-3-ultra-free", "opencode/mimo-v2.5-free", "opencode/ling-3.0-flash-fin-free"],
+  vision: ["opencode/mimo-v2.5-free", "opencode-go/deepseek-v4-flash-vision-exp", "opencode-go/minimax-m3", "opencode-go/mimo-v2.5-pro"]
+}
+
+export const FREE_ROLE_MAP = {
+  orchestrator: "orchestration",
+  planner: "planning",
+  developer: "implementation",
+  qa: "verification",
+  verifier: "verification",
+  security: "verification",
+  documenter: "documentation",
+  vision: "vision",
+  "visual-director": "vision",
+  "visual-critic": "vision"
+}
+
+export const ALL_AGENTS = Object.keys(FREE_ROLE_MAP)
+
+// Profiles that pin every variant model to their profile definition —
+// tier model overrides would silently break that promise, so they are locked.
+export const LOCKED_TIER_PROFILES = new Set(["go-flash", "free", "mimo"])
+
+function readJson(path, fallback = null) {
+  try { return JSON.parse(readFileSync(path, "utf8")) } catch { return fallback }
+}
+
+function writeJson(path, data) {
+  const dir = dirname(path)
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+  writeFileSync(path, JSON.stringify(data, null, 2) + "\n")
+}
+
+function run(cmd) {
+  try {
+    return execSync(cmd, { encoding: "utf8", timeout: 30000 }).trim()
+  } catch {
+    return ""
+  }
+}
+
+export function detectAvailableModels() {
+  const output = run("opencode models --refresh 2>/dev/null && opencode models 2>/dev/null")
+  if (!output) return []
+  const lines = output.split("\n").map(l => l.trim()).filter(l => l && !l.startsWith("lmstudio/"))
+  return [...new Set(lines)]
+}
+
+export function hasGoModels(available) {
+  return available.some(m => m.startsWith("opencode-go/"))
+}
+
+export function getFreeModels(available) {
+  return available.filter(m => m.startsWith("opencode/") && m.endsWith("-free") || m === "opencode/big-pickle")
+    .concat(available.filter(m => m.startsWith("opencode-go/free-")))
+}
+
+export function pickBestFree(available, role) {
+  const candidates = FREE_CANDIDATES_BY_ROLE[role] || FREE_CANDIDATES_BY_ROLE.verification
+  for (const c of candidates) {
+    if (available.includes(c)) return c
+  }
+  for (const c of candidates) {
+    for (const a of available) {
+      if (a.startsWith("opencode/") && (a.includes(c.split("/").pop()?.split("-free")[0] || c) || c.includes(a.split("/").pop()?.split("-free")[0] || a))) {
+        return a
+      }
+    }
+  }
+  const freeModels = getFreeModels(available)
+  return freeModels.length > 0 ? freeModels[0] : "opencode/big-pickle"
+}
+
+export function resolveFreeProfile(available) {
+  const models = {}
+  for (const agent of ALL_AGENTS) {
+    const role = FREE_ROLE_MAP[agent]
+    models[agent] = pickBestFree(available, role)
+  }
+  return models
+}
+
+// Syntax validation is provider-agnostic: any `provider/model` id is valid.
+// Availability stays a separate check against `opencode models` — a model that
+// is well-formed but absent must still fail validation.
+export function validateModels(models, available) {
+  const unavailable = []
+  for (const [agent, model] of Object.entries(models)) {
+    if (!isValidModelId(model)) {
+      unavailable.push({ agent, model, reason: "invalid format" })
+      continue
+    }
+    const matches = available.filter(a => a === model)
+    if (matches.length === 0) {
+      unavailable.push({ agent, model, reason: "not found in available models" })
+    }
+  }
+  return unavailable
+}
+
+// Capability routing: roles that require image input (vision, visual-critic)
+// are moved to a vision-capable fallback when the assigned model has no
+// evidence of vision support. Never swaps when no alternative is available —
+// the caller reports the limitation instead of pretending.
+export function enforceVisionRoles(models, available, fallbacks = {}) {
+  const result = { ...models }
+  const applied = { ...fallbacks }
+  for (const agent of Object.keys(result)) {
+    if (!roleRequiresVision(agent)) continue
+    if (modelMeetsRole(result[agent], agent).ok) continue
+    const replacement = findAvailableCandidate(VISION_FALLBACK_CANDIDATES, available)
+    if (!replacement) continue
+    applied[agent] = { from: result[agent], to: replacement, reason: "vision capability" }
+    result[agent] = replacement
+  }
+  return { result, fallbacks: applied }
+}
+
+function containsKey(obj, key) {
+  return Object.prototype.hasOwnProperty.call(obj, key)
+}
+
+// Strict family resolution used by `deepseek-mimo`: resolves a candidate chain
+// against the live catalog and FAILS FAST with diagnostics when nothing
+// matches. Never substitutes unrelated models — a blocked dispatch is worse
+// than a clear exit the user can act on.
+function resolveStrictCandidate(label, candidates, available, familyPattern, profileName) {
+  const resolved = resolveModelCandidate(candidates, available, { familyPattern })
+  if (!resolved.model) {
+    console.error(`${label} is not available in this environment.`)
+    console.error("")
+    console.error("Attempted candidates:")
+    for (const candidate of resolved.attempted) {
+      console.error(`  ${candidate} (not found)`)
+    }
+    const compatible = familyPattern ? available.filter((m) => familyPattern.test(m)) : []
+    console.error("")
+    if (compatible.length > 0) {
+      console.error(`Available compatible ${label} models:`)
+      for (const m of compatible) console.error(`  ${m}`)
+    } else {
+      console.error(`No compatible ${label} models are available. Run: opencode models`)
+    }
+    console.error("")
+    console.error(`The ${profileName} profile was NOT activated. No unrelated models were substituted.`)
+    console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, deepseek-mimo, free")
+    process.exit(1)
+  }
+  return resolved
+}
+
+export function applyFallbacks(models, unavailable, available) {
+  const result = { ...models }
+  const fallbacks = {}
+  for (const { agent, model } of unavailable) {
+    if (containsKey(FREE_ROLE_MAP, agent)) {
+      const role = FREE_ROLE_MAP[agent]
+      const fb = pickBestFree(available, role)
+      result[agent] = fb
+      fallbacks[agent] = { from: model, to: fb }
+    } else {
+      const fb = pickBestFree(available, "verification")
+      result[agent] = fb
+      fallbacks[agent] = { from: model, to: fb }
+    }
+  }
+  return { result, fallbacks }
+}
+
+function readConfig() {
+  return readJson(CONFIG_PATH, {})
+}
+
+function writeConfig(config) {
+  writeJson(CONFIG_PATH, config)
+}
+
+function ensureAgentFiles() {
+  if (!existsSync(AGENTS_DIR)) {
+    mkdirSync(AGENTS_DIR, { recursive: true })
+  }
+  const srcFiles = readdirSync(SOURCE_AGENTS_DIR).filter(f => f.startsWith("devloom-") && f.endsWith(".md"))
+  const existing = new Set(readdirSync(AGENTS_DIR).filter(f => f.startsWith("devloom-") && f.endsWith(".md")))
+  for (const f of srcFiles) {
+    if (!existing.has(f)) {
+      try { cpSync(resolve(SOURCE_AGENTS_DIR, f), resolve(AGENTS_DIR, f)) } catch {}
+    }
+  }
+}
+
+export const AGENT_VARIANTS = {
+  developer: ["developer", "developer-flash", "developer-senior"],
+  planner: ["planner", "planner-flash", "planner-senior"],
+  qa: ["qa", "qa-flash"],
+  verifier: ["verifier"],
+  security: ["security", "security-senior"],
+  documenter: ["documenter", "documenter-flash"],
+  orchestrator: ["orchestrator"],
+  vision: ["vision"],
+  "visual-director": ["visual-director"],
+  "visual-critic": ["visual-critic"]
+}
+
+export function applyModelsToAgentFiles(models, profileLabel = "") {
+  ensureAgentFiles()
+  for (const [agent, model] of Object.entries(models)) {
+    const variants = AGENT_VARIANTS[agent] || [agent]
+    for (const v of variants) {
+      const f = resolve(AGENTS_DIR, `devloom-${v}.md`)
+      if (!existsSync(f)) continue
+      try {
+        let content = readFileSync(f, "utf8")
+        content = content.replace(/^model: .*/m, `model: ${model}`)
+        if (v === "orchestrator" && profileLabel) {
+          content = content.replace(/^(description: "DevLoom Orchestrator:)([^"]*)"/m, (_, prefix, rest) => {
+            const cleaned = rest.replace(/\s*\(profile: [^)]*\)/, "")
+            return `${prefix}${cleaned} (profile: ${profileLabel})"`
+          })
+        }
+        writeFileSync(f, content)
+      } catch {}
+    }
+  }
+}
+
+export function cmdApplyTier(tierName, available) {
+  const tier = TIERS[tierName]
+  if (!tier) {
+    console.error("Unknown tier:", tierName)
+    console.error("Valid tiers: senior, standard")
+    process.exit(1)
+  }
+
+  const config = readConfig()
+  if (LOCKED_TIER_PROFILES.has(config.resolvedProfile)) {
+    console.error(`Cannot apply tier "${tierName}" to profile "${config.resolvedProfile}".`)
+    console.error(`Profile "${config.resolvedProfile}" locks all models to its profile definition.`)
+    console.error("Switch to 'go' or 'go-economy' profile to use tier overrides.")
+    process.exit(1)
+  }
+
+  const models = { ...tier }
+  const unresolved = validateModels(models, available)
+  if (unresolved.length > 0) {
+    console.error(`Tier "${tierName}" has unavailable models:`)
+    for (const u of unresolved) console.error(`  ${u.agent}: ${u.model}`)
+    process.exit(1)
+  }
+
+  applyModelsToAgentFiles(models)
+
+  config.tier = tierName
+  config.tierModels = models
+  config.models = { ...models }
+  writeConfig(config)
+
+  return models
+}
+
+export function cmdSet(profileName) {
+  const available = detectAvailableModels()
+  const hasGo = hasGoModels(available)
+
+  if ((profileName === "go" || profileName === "go-economy" || profileName === "deepseek" || profileName === "glm" || profileName === "go-flash" || profileName === "deepseek-mimo") && !hasGo) {
+    console.error("No OpenCode Go models detected. Run: opencode /connect to add OpenCode Go.")
+    console.error("Fall back to: /devloom-auto or /devloom-free")
+    process.exit(1)
+  }
+
+  let resolvedProfile = profileName
+  let models = {}
+  let fallbacks = {}
+  let unavailable = []
+
+  if (profileName === "go") {
+    models = { ...PROFILES.go }
+    unavailable = validateModels(models, available)
+    if (unavailable.length > 0) {
+      const fb = applyFallbacks(models, unavailable, available)
+      models = fb.result
+      fallbacks = fb.fallbacks
+    }
+  } else if (profileName === "go-economy") {
+    models = { ...PROFILES["go-economy"] }
+    unavailable = validateModels(models, available)
+    if (unavailable.length > 0) {
+      const fb = applyFallbacks(models, unavailable, available)
+      models = fb.result
+      fallbacks = fb.fallbacks
+    }
+  } else if (profileName === "free") {
+    models = resolveFreeProfile(available)
+    unavailable = validateModels(models, available)
+  } else if (profileName === "deepseek") {
+    models = { ...PROFILES.deepseek }
+    unavailable = validateModels(models, available)
+    if (unavailable.length > 0) {
+      const fb = applyFallbacks(models, unavailable, available)
+      models = fb.result
+      fallbacks = fb.fallbacks
+    }
+  } else if (profileName === "glm") {
+    models = { ...PROFILES.glm }
+    unavailable = validateModels(models, available)
+    if (unavailable.length > 0) {
+      const fb = applyFallbacks(models, unavailable, available)
+      models = fb.result
+      fallbacks = fb.fallbacks
+    }
+  } else if (profileName === "go-flash") {
+    models = { ...PROFILES["go-flash"] }
+    unavailable = validateModels(models, available)
+    if (unavailable.length > 0) {
+      const fb = applyFallbacks(models, unavailable, available)
+      models = fb.result
+      fallbacks = fb.fallbacks
+    }
+  } else if (profileName === "mimo") {
+    // First-class MiMo profile: resolve the V2.6 Flash candidate chain against
+    // the live catalog instead of hardcoding a provider prefix.
+    const resolved = resolveModelCandidate(MIMO_V26_FLASH_CANDIDATES, available, {
+      familyPattern: MODEL_FAMILIES.mimoV26Flash.familyPattern,
+    })
+    if (!resolved.model) {
+      console.error("MiMo V2.6 Flash is not available in this environment.")
+      console.error("")
+      console.error("Attempted candidates:")
+      for (const candidate of resolved.attempted) {
+        console.error(`  ${candidate} (not found)`)
+      }
+      const compatible = available.filter((m) => MODEL_FAMILIES.mimoV26Flash.familyPattern.test(m))
+      console.error("")
+      if (compatible.length > 0) {
+        console.error("Available compatible MiMo V2.6 models:")
+        for (const m of compatible) console.error(`  ${m}`)
+      } else {
+        const anyMimo = available.filter((m) => /mimo/i.test(m))
+        if (anyMimo.length > 0) {
+          console.error("Available MiMo models (different version — not used automatically):")
+          for (const m of anyMimo) console.error(`  ${m}`)
+        } else {
+          console.error("No MiMo models are available. Run: opencode models")
+        }
+      }
+      console.error("")
+      console.error("The mimo profile was NOT activated. No unrelated models were substituted.")
+      console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, deepseek-mimo, free")
+      process.exit(1)
+    }
+    models = Object.fromEntries(ALL_AGENTS.map((agent) => [agent, resolved.model]))
+    if (!resolved.exact) {
+      for (const agent of ALL_AGENTS) {
+        fallbacks[agent] = {
+          from: "mimo-v2.6-flash (candidate chain)",
+          to: resolved.model,
+          reason: "family fallback",
+        }
+      }
+    }
+  } else if (profileName === "deepseek-mimo") {
+    // Hybrid: DeepSeek V4.1 Flash is the fast lane for the 7 general roles;
+    // MiMo V2.6 Flash serves the graphical/complex visual roles. Both chains
+    // resolve strictly — exit 1 with diagnostics instead of substituting.
+    const deepseekResolved = resolveStrictCandidate(
+      "DeepSeek V4.1 Flash",
+      DEEPSEEK_V41_FLASH_CANDIDATES,
+      available,
+      MODEL_FAMILIES.deepseekV41Flash.familyPattern,
+      "deepseek-mimo"
+    )
+    const mimoResolved = resolveStrictCandidate(
+      "MiMo V2.6 Flash",
+      MIMO_V26_FLASH_CANDIDATES,
+      available,
+      MODEL_FAMILIES.mimoV26Flash.familyPattern,
+      "deepseek-mimo"
+    )
+    const visualRoles = new Set(["vision", "visual-director", "visual-critic"])
+    models = Object.fromEntries(
+      ALL_AGENTS.map((agent) => [agent, visualRoles.has(agent) ? mimoResolved.model : deepseekResolved.model])
+    )
+    const recordChainFallback = (agent, resolved, chainLabel) => {
+      if (resolved.exact) return
+      fallbacks[agent] = {
+        from: `${chainLabel} (candidate chain)`,
+        to: resolved.model,
+        reason: "family fallback",
+      }
+    }
+    for (const agent of ALL_AGENTS) {
+      recordChainFallback(agent, visualRoles.has(agent) ? mimoResolved : deepseekResolved, visualRoles.has(agent) ? "mimo-v2.6-flash" : "deepseek-v4.1-flash")
+    }
+  } else if (profileName === "auto") {
+    if (hasGo) {
+      models = { ...PROFILES["go-flash"] }
+      resolvedProfile = "go-flash"
+    } else {
+      models = resolveFreeProfile(available)
+      resolvedProfile = "free"
+    }
+    unavailable = validateModels(models, available)
+    if (unavailable.length > 0) {
+      const fb = applyFallbacks(models, unavailable, available)
+      models = fb.result
+      fallbacks = fb.fallbacks
+    }
+  } else {
+    console.error("Unknown profile:", profileName)
+    console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, deepseek-mimo, free")
+    process.exit(1)
+  }
+
+  // Capability routing: keep vision-required roles on vision-capable models.
+  const enforced = enforceVisionRoles(models, available, fallbacks)
+  models = enforced.result
+  fallbacks = enforced.fallbacks
+
+  const prev = readConfig()
+  const config = {
+    profile: profileName,
+    resolvedProfile,
+    models,
+    overrides: prev.overrides || {},
+    tier: LOCKED_TIER_PROFILES.has(resolvedProfile) ? null : (prev.tier || null),
+    tierModels: LOCKED_TIER_PROFILES.has(resolvedProfile) ? null : (prev.tierModels || null),
+    availableModelsSnapshot: available,
+    fallbacks
+  }
+
+  writeConfig(config)
+  applyModelsToAgentFiles(models, config.resolvedProfile ?? config.profile)
+
+  const cacheStatus = pluginCacheStatus()
+  if (cacheStatus === "ok") {
+    refreshOpenCodePluginAgentFiles(AGENTS_DIR)
+    console.log("OpenCode plugin cache refreshed with the current profile.")
+  } else {
+    console.log(`Note: DevLoom plugin cache is ${cacheStatus === "missing" ? "missing" : "stale"} — run /devloom-refresh once, then restart opencode to see the profile in the sidebar.`)
+  }
+  console.log("Restart opencode (or run: opencode --continue) to see the updated profile and agents in the sidebar.")
+
+  return config
+}
+
+export function cmdCurrent() {
+  const config = readConfig()
+  if (!config || !config.profile) {
+    console.log("No DevLoom profile configured yet.")
+    console.log("Run: /devloom-init or /devloom-auto")
+    return
+  }
+  console.log(`Profile: ${config.profile}`)
+  if (config.tier) {
+    console.log(`Tier: ${config.tier}`)
+  } else if (LOCKED_TIER_PROFILES.has(config.resolvedProfile)) {
+    console.log(`Tier: locked (profile "${config.resolvedProfile}" does not support tier overrides)`)
+  }
+  console.log("")
+  const activeModels = config.tierModels || config.models
+  console.log("Resolved models:")
+  for (const [agent, model] of Object.entries(activeModels)) {
+    const tiered = config.tier && config.models[agent] !== model ? ` (tier: ${model})` : ""
+    const overridden = config.overrides && config.overrides[agent] ? " (override)" : ""
+    const fallbacked = config.fallbacks && config.fallbacks[agent] ? " (fallback)" : ""
+    const base = config.tier ? config.models[agent] : null
+    const label = base && base !== model ? `${base} → ${model}` : model
+    console.log(`  ${agent}: ${label}${tiered}${overridden}${fallbacked}`)
+  }
+  if (config.unresolved && config.unresolved.length > 0) {
+    console.log("")
+    console.log("Unavailable models:")
+    for (const u of config.unresolved) {
+      console.log(`  ${u.agent}: ${u.model} (${u.reason})`)
+    }
+  }
+  if (config.fallbacks && Object.keys(config.fallbacks).length > 0) {
+    console.log("")
+    console.log("Fallbacks applied:")
+    for (const [agent, fb] of Object.entries(config.fallbacks)) {
+      console.log(`  ${agent}: ${fb.from} -> ${fb.to}`)
+    }
+  }
+}
+
+export function cmdValidate() {
+  const available = detectAvailableModels()
+  const config = readConfig()
+  if (!config || !config.models) {
+    console.log("No DevLoom configuration to validate.")
+    process.exit(1)
+  }
+  const allUnavailable = []
+  for (const [agent, model] of Object.entries(config.models)) {
+    if (!available.includes(model)) {
+      allUnavailable.push({ agent, model, reason: "not available" })
+    }
+  }
+  if (allUnavailable.length > 0) {
+    console.log("Unavailable models:")
+    for (const u of allUnavailable) {
+      console.log(`  ${u.agent}: ${u.model}`)
+    }
+    process.exit(1)
+  } else {
+    console.log("All models are available.")
+  }
+}
+
+export function cmdApply() {
+  const config = readConfig()
+  if (!config || !config.profile) {
+    console.error("No profile configured. Run /devloom-init or /devloom-auto first.")
+    process.exit(1)
+  }
+  const available = detectAvailableModels()
+  const models = config.models || {}
+  applyModelsToAgentFiles(models, config.resolvedProfile ?? config.profile)
+
+  config.availableModelsSnapshot = available
+  config.requiresReload = true
+  writeConfig(config)
+
+  console.log("Profile applied to agent files.")
+  console.log("")
+
+  const cacheStatus = pluginCacheStatus()
+  if (cacheStatus === "ok") {
+    refreshOpenCodePluginAgentFiles(AGENTS_DIR)
+    console.log("OpenCode plugin cache refreshed with the current profile.")
+  } else {
+    console.log(`NOTE: the DevLoom plugin cache is ${cacheStatus === "missing" ? "missing (plugin not installed in OpenCode)" : "stale"} —`)
+    console.log("the profile will not show in the sidebar until the plugin code is refreshed.")
+    console.log("Run: /devloom-refresh   (or: npm install -g devloom && opencode plugin devloom --global --force)")
+  }
+  console.log("")
+  console.log("Restart opencode (or run: opencode --continue) to see the updated profile and agents in the sidebar.")
+  console.log("")
+
+  if (existsSync(AGENTS_DIR)) {
+    const reopenScript = ".opencode/devloom/reopen.sh"
+    writeFileSync(reopenScript, "#!/usr/bin/env bash\nexec opencode --continue\n")
+    try { execSync(`chmod +x ${reopenScript}`) } catch {}
+
+    console.log("If the current OpenCode session does not pick up the new agent models immediately,")
+    console.log("continue the same session with:")
+    console.log("")
+    console.log("  opencode --continue")
+    console.log("")
+    console.log("Or run:")
+    console.log(`  bash ${reopenScript}`)
+  }
+}
+
+export function cmdDetect() {
+  const available = detectAvailableModels()
+  const hasGo = hasGoModels(available)
+
+  console.log("Available models:", available.length)
+  if (hasGo) {
+    console.log("OpenCode Go models detected: yes")
+    console.log("Recommended profile: go")
+  } else {
+    console.log("OpenCode Go models detected: no")
+    console.log("Recommended profile: free")
+  }
+  const freeCount = getFreeModels(available).length
+  console.log(`Free models available: ${freeCount}`)
+  const mimo = findAvailableCandidate(MIMO_V26_FLASH_CANDIDATES, available)
+  console.log(mimo ? `MiMo V2.6 Flash: available (${mimo})` : "MiMo V2.6 Flash: not available")
+}
+
+function main() {
+  const args = process.argv.slice(2)
+  const command = args[0] || ""
+
+  switch (command) {
+    case "set":
+      if (!args[1]) { console.error("Usage: devloom profile set <auto|go|go-economy|deepseek|glm|go-flash|mimo|deepseek-mimo|free>"); process.exit(1) }
+      cmdSet(args[1])
+      console.log(`DevLoom profile changed to: ${args[1]}`)
+      if (args[1] !== "free") {
+        console.log(`Resolved profile: ${args[1]}`)
+      }
+      break
+    case "current":
+      cmdCurrent()
+      break
+    case "validate":
+      cmdValidate()
+      break
+    case "apply":
+      cmdApply()
+      break
+    case "detect":
+      cmdDetect()
+      break
+    case "tier":
+      if (!args[1]) { console.error("Usage: devloom profile tier <senior|balanced|junior>"); process.exit(1) }
+      if (!["senior","standard"].includes(args[1])) { console.error("Invalid tier. Valid: senior, standard"); process.exit(1) }
+      const available = detectAvailableModels()
+      cmdApplyTier(args[1], available)
+      console.log(`DevLoom tier changed to: ${args[1]}`)
+      break
+    default:
+      console.log("DevLoom Profile Manager")
+      console.log("")
+      console.log("Commands:")
+      console.log("  devloom profile set <auto|go|go-economy|deepseek|glm|go-flash|mimo|deepseek-mimo|free>")
+      console.log("  devloom profile tier <senior|standard>")
+      console.log("  devloom profile current")
+      console.log("  devloom profile validate")
+      console.log("  devloom profile apply")
+      console.log("  devloom profile detect")
+  }
+}
+
+const isMain = process.argv[1] ? fileURLToPath(import.meta.url) === resolve(process.argv[1]) : false
+if (isMain) main()