ring/platforms/opencode/plugin/config/config-handler.ts

/**
 * Ring Config Handler
 *
 * Creates a config hook that injects Ring agents, skills, and commands
 * into OpenCode's configuration at runtime.
 *
 * Pattern from oh-my-opencode:
 * config: async (opencodeConfig) => {
 *   // Modify opencodeConfig.agent, .skill, .command
 *   return opencodeConfig
 * }
 */

import { dirname, join } from "node:path"
import { fileURLToPath } from "node:url"
import { loadRingAgents } from "../loaders/agent-loader.js"
import { loadRingCommands } from "../loaders/command-loader.js"
import { loadRingSkills } from "../loaders/skill-loader.js"
import type { RingConfig } from "./schema.js"

// Determine plugin root directory (where assets/ is located)
const __dirname = dirname(fileURLToPath(import.meta.url))
const pluginRoot = join(__dirname, "..", "..")

/**
 * OpenCode config structure (subset used by Ring).
 */
export interface OpenCodeConfig {
  /** Agent configurations */
  agent?: Record<string, unknown>

  /** Command configurations */
  command?: Record<string, unknown>

  /** Permission settings */
  permission?: Record<string, string>

  /** Tools configuration */
  tools?: Record<string, boolean>

  /** Model configuration */
  model?: string
}

/**
 * Dependencies for creating the config handler.
 */
export interface ConfigHandlerDeps {
  /** Project root directory */
  projectRoot: string
  /** Ring plugin configuration */
  ringConfig: RingConfig
}

/**
 * Create the config handler that injects Ring components.
 *
 * This handler is called by OpenCode to modify the configuration
 * before the session starts. We use this to inject:
 * - Ring agents (from plugin's assets/agent/ + user's .opencode/agent/)
 * - Ring skills (from plugin's assets/skill/ + user's .opencode/skill/)
 * - Ring commands (from plugin's assets/command/ + user's .opencode/command/)
 *
 * User's customizations take priority over Ring's built-in assets.
 */
export function createConfigHandler(deps: ConfigHandlerDeps) {
  const { projectRoot, ringConfig } = deps

  return async (config: OpenCodeConfig): Promise<void> => {
    const debug = process.env.DEBUG === "true" || process.env.RING_DEBUG === "true"

    // Load Ring agents (from plugin's assets/ + user's .opencode/)
    const ringAgents = loadRingAgents(pluginRoot, projectRoot, ringConfig.disabled_agents)

    if (debug) {
      const agentNames = Object.keys(ringAgents)
      console.debug(
        `[ring] Loaded ${agentNames.length} agents:`,
        agentNames.slice(0, 5).join(", "),
        agentNames.length > 5 ? "..." : "",
      )
    }

    // Load Ring skills (from plugin's assets/ + user's .opencode/)
    const ringSkills = loadRingSkills(pluginRoot, projectRoot, ringConfig.disabled_skills)

    if (debug) {
      const skillNames = Object.keys(ringSkills)
      console.debug(
        `[ring] Loaded ${skillNames.length} skills:`,
        skillNames.slice(0, 5).join(", "),
        skillNames.length > 5 ? "..." : "",
      )
    }

    // Load Ring commands (from plugin's assets/ + user's .opencode/)
    const { commands: ringCommands, validation: commandValidation } = loadRingCommands(
      pluginRoot,
      projectRoot,
      ringConfig.disabled_commands,
      debug, // Only validate refs in debug mode
    )

    if (debug) {
      const commandNames = Object.keys(ringCommands)
      console.debug(
        `[ring] Loaded ${commandNames.length} commands:`,
        commandNames.slice(0, 5).join(", "),
        commandNames.length > 5 ? "..." : "",
      )

      // Log validation warnings
      for (const warning of commandValidation) {
        console.debug(`[ring] Command '${warning.command}': ${warning.issue}`)
      }
    }

    // Inject agents into config
    // Ring agents are added with lower priority (spread first, then existing)
    // so project-specific overrides can take precedence
    // TODO(review): Consider deep merge for nested agent configs
    config.agent = {
      ...ringAgents,
      ...(config.agent ?? {}),
    }

    // Inject skills and commands
    // Commands and skills both go into config.command
    config.command = {
      ...ringSkills,
      ...ringCommands,
      ...(config.command ?? {}),
    }

    // Disable recursive agent calls in certain agents
    const agentConfig = config.agent as Record<string, { tools?: Record<string, boolean> }>

    // Prevent explore agents from using task recursively
    if (agentConfig["ring:codebase-explorer"]) {
      agentConfig["ring:codebase-explorer"].tools = {
        ...agentConfig["ring:codebase-explorer"].tools,
        task: false,
      }
    }

    // Prevent reviewers from spawning more reviewers
    const reviewerAgents = [
      "ring:code-reviewer",
      "ring:security-reviewer",
      "ring:business-logic-reviewer",
      "ring:test-reviewer",
      "ring:nil-safety-reviewer",
    ]

    for (const reviewerName of reviewerAgents) {
      if (agentConfig[reviewerName]) {
        agentConfig[reviewerName].tools = {
          ...agentConfig[reviewerName].tools,
          task: false,
        }
      }
    }

    if (debug) {
      console.debug("[ring] Config injection complete")
    }
  }
}