@hiai-gg/hiai-opencode 0.1.3 → 0.1.4

package/src/config/types.ts

@@ -32,6 +32,8 @@ export const LEGACY_AGENT_ALIAS_NAMES = [
   "zoe",
   "build",
   "pre-plan",
+  "manager",
+  "vision",
   "logician",
   "librarian",
   "explore",
@@ -54,6 +56,8 @@ export const LEGACY_AGENT_ALIAS_TO_CANONICAL: Record<
   zoe: "bob",
   build: "bob",
   "pre-plan": "strategist",
+  manager: "platform-manager",
+  vision: "multimodal",
   logician: "strategist",
   librarian: "researcher",
   explore: "researcher",
@@ -135,6 +139,16 @@ export interface SkillsConfig {
   disabled?: string[];
 }
 
+export interface SkillDiscoveryConfig {
+  config_sources?: boolean;
+  project_opencode?: boolean;
+  global_opencode?: boolean;
+  project_claude?: boolean;
+  global_claude?: boolean;
+  project_agents?: boolean;
+  global_agents?: boolean;
+}
+
 export interface PermissionsConfig {
   read?: Record<string, string>;
   edit?: Record<string, string>;
@@ -148,6 +162,7 @@ export interface AuthKeys {
   openrouter?: string;
   stitch?: string;
   firecrawl?: string;
+  context7?: string;
 }
 
 export interface OllamaConfig {
@@ -168,6 +183,7 @@ export interface HiaiOpencodeConfig {
   lsp?: Record<string, LspServerConfig>;
   subtask2?: Subtask2Config;
   skills?: SkillsConfig;
+  skill_discovery?: SkillDiscoveryConfig;
   permissions?: PermissionsConfig;
   auth?: AuthKeys;
   ollama?: OllamaConfig;

package/src/features/builtin-commands/commands.ts

@@ -8,6 +8,7 @@ import { REFACTOR_TEMPLATE } from "./templates/refactor"
 import { START_WORK_TEMPLATE } from "./templates/start-work"
 import { HANDOFF_TEMPLATE } from "./templates/handoff"
 import { REMOVE_AI_SLOPS_TEMPLATE } from "./templates/remove-ai-slops"
+import { MCP_STATUS_TEMPLATE } from "./templates/mcp-status"
 
 interface LoadBuiltinCommandsOptions {
   useRegisteredAgents?: boolean
@@ -121,6 +122,12 @@ $ARGUMENTS
 </user-request>`,
       argumentHint: "[goal]",
     },
+    "mcp-status": {
+      description: "(builtin) Show hiai-opencode MCP server status, missing keys, and local runtime availability",
+      template: `<command-instruction>
+${MCP_STATUS_TEMPLATE}
+</command-instruction>`,
+    },
   }
 }
 

package/src/features/builtin-commands/templates/mcp-status.ts

@@ -0,0 +1,36 @@
+export const MCP_STATUS_TEMPLATE = `# MCP Status Command
+
+## Purpose
+
+Use /mcp-status to show the effective hiai-opencode MCP setup without relying on OpenCode's mcp list output.
+
+## Execute
+
+Run:
+
+\`\`\`bash
+hiai-opencode mcp-status
+\`\`\`
+
+If the binary is not on PATH, try the package-local fallback:
+
+\`\`\`bash
+node ./node_modules/@hiai-gg/hiai-opencode/assets/cli/hiai-opencode.mjs mcp-status
+\`\`\`
+
+## Report
+
+Summarize the output in a compact status table:
+
+- MCP server name
+- status: ok, warning, error, disabled
+- cause or next action
+
+Rules:
+
+- Do not print API key values.
+- If a key is missing, name the env var only.
+- If a runtime is missing, give the exact install hint from the command output or the shortest safe next command.
+- Do not edit config unless the user explicitly asks.
+- Do not run package installs unless the user explicitly asks.
+`

package/src/features/builtin-commands/types.ts

@@ -1,6 +1,6 @@
 import type { CommandDefinition } from "../claude-code-command-loader"
 
-export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "remove-ai-slops"
+export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff" | "remove-ai-slops" | "mcp-status"
 
 export interface BuiltinCommandConfig {
   disabled_commands?: BuiltinCommandName[]

package/src/features/builtin-skills/skills/playwright.ts

@@ -5,11 +5,33 @@ export const playwrightSkill: BuiltinSkill = {
   description: "MUST USE for any browser-related tasks. Browser automation via Playwright MCP - verification, browsing, information gathering, web scraping, testing, screenshots, and all browser interactions.",
   template: `# Playwright Browser Automation
 
-This skill provides browser automation capabilities via the Playwright MCP server.`,
+This skill provides browser automation capabilities via the Playwright MCP server.
+
+## Required workflow
+
+1. Load this skill before calling \`skill_mcp\`.
+2. Use \`skill_mcp\` with \`mcp_name="playwright"\` for browser navigation, interaction, screenshots, and visual verification.
+3. If the host says \`MCP server "playwright" not found\`, do not conclude that Playwright is impossible. First report that the skill was not loaded or the Playwright MCP server was not registered in this session.
+4. If Chromium starts but fails with missing Linux libraries such as \`libnspr4\`, \`libnss3\`, \`libatk-bridge\`, \`libgtk-3\`, or similar, distinguish browser OS dependencies from MCP availability.
+
+## Linux dependency fallback
+
+Playwright has two dependency layers:
+
+- Browser binary: installable without sudo with \`npx playwright install chromium\` or by setting \`HIAI_PLAYWRIGHT_INSTALL_BROWSERS=1\` before OpenCode starts.
+- System libraries: on minimal Linux images these usually require admin rights via \`sudo npx playwright install-deps chromium\` or OS package manager equivalents.
+
+If sudo is unavailable, try these alternatives before falling back to curl-only checks:
+
+- Use an already installed Chrome/Chromium/Edge by adding Playwright MCP args in \`hiai-opencode.json\`, for example \`--browser chrome\` or \`--browser msedge\`.
+- Use a remote/browser service or CDP-backed browser when available.
+- Switch the browser automation provider to \`agent-browser\` or \`playwright-cli\` if the workspace has those tools installed.
+
+Only use \`curl\` as a final degraded check. Clearly say that HTTP checks do not replace interactive browser verification.`,
   mcpConfig: {
     playwright: {
       command: "npx",
-      args: ["@playwright/mcp@latest"],
+      args: ["-y", "@playwright/mcp@latest"],
     },
   },
 }

package/src/features/opencode-skill-loader/loader.ts

@@ -62,6 +62,12 @@ export async function loadGlobalAgentsSkills(): Promise<Record<string, CommandDe
   return skillsToCommandDefinitionRecord(skills)
 }
 
+export async function loadManagedPluginSkills(): Promise<Record<string, CommandDefinition>> {
+  const skillsDir = join(getOpenCodeConfigDir({ binary: "opencode" }), ".hiai", "skills", "plugin")
+  const skills = await loadSkillsFromDir({ skillsDir, scope: "builtin" })
+  return skillsToCommandDefinitionRecord(skills)
+}
+
 export interface DiscoverSkillsOptions {
   includeClaudeCodePaths?: boolean
   directory?: string
@@ -170,3 +176,8 @@ export async function discoverGlobalAgentsSkills(): Promise<LoadedSkill[]> {
   const agentsGlobalDir = join(getAgentsConfigDir(), "skills")
   return loadSkillsFromDir({ skillsDir: agentsGlobalDir, scope: "user" })
 }
+
+export async function discoverManagedPluginSkills(): Promise<LoadedSkill[]> {
+  const skillsDir = join(getOpenCodeConfigDir({ binary: "opencode" }), ".hiai", "skills", "plugin")
+  return loadSkillsFromDir({ skillsDir, scope: "builtin" })
+}

package/src/index.ts

@@ -18,6 +18,7 @@ import { injectServerAuthIntoClient, log } from "./shared"
 import { hydratePluginConfigWithPlatformDefaults } from "./shared/runtime-plugin-config"
 import { detectExternalSkillPlugin, getSkillPluginConflictWarning } from "./shared/external-plugin-detector"
 import { PLUGIN_NAME } from "./shared/plugin-identity"
+import { warnIfListPluginEntry, warnMissingRequiredMcpEnv } from "./shared/startup-diagnostics"
 import { startBackgroundCheck as startTmuxCheck } from "./tools/interactive-bash"
 import { lspManager } from "./tools/lsp/client"
 
@@ -69,6 +70,7 @@ const HiaiOpenCodePlugin: Plugin = async (ctx) => {
   log("[HiaiOpenCodePlugin] ENTRY - plugin loading", {
     directory: ctx.directory,
   })
+  warnIfListPluginEntry(ctx.directory)
 
   const skillPluginCheck = detectExternalSkillPlugin(ctx.directory)
   if (skillPluginCheck.detected && skillPluginCheck.pluginName) {
@@ -83,6 +85,10 @@ const HiaiOpenCodePlugin: Plugin = async (ctx) => {
     loadPluginConfig(ctx.directory, ctx),
     internalConfig,
   )
+  warnMissingRequiredMcpEnv({
+    pluginConfig,
+    platformConfig: internalConfig,
+  })
 
   materializeBuiltinSkills(
     createBuiltinSkills({
@@ -220,29 +226,24 @@ const HiaiOpenCodePlugin: Plugin = async (ctx) => {
     auth: {
       provider: "hiai-opencode",
       methods: [
-        { type: "api" as const, label: "Google API key" },
-        { type: "api" as const, label: "OpenAI API key" },
-        { type: "api" as const, label: "OpenRouter API key" },
+        { type: "api" as const, label: "Google Search API key" },
       ],
       loader: async (getAuth: any) => {
         const authData = await getAuth();
         const { registerGetAuth, GOOGLE_PROVIDER_ID, OPENAI_PROVIDER_ID, OPENROUTER_PROVIDER_ID } = await import("./internals/plugins/websearch-cited/index");
 
-        // Helper to get key from config or authData
-        const getKey = (label: string, configKey?: string) => {
-          const fromAuth = authData[label];
-          if (fromAuth) return fromAuth;
+        const getConfiguredKey = (configKey?: string) => {
           if (configKey) return resolveEnvVars(configKey);
           return undefined;
         };
 
-        const googleKey = getKey("Google API key", internalConfig.auth?.googleSearch);
-        const openaiKey = getKey("OpenAI API key", internalConfig.auth?.openai);
-        const openRouterKey = getKey("OpenRouter API key", internalConfig.auth?.openrouter);
+        const googleKey = authData["Google Search API key"] || getConfiguredKey(internalConfig.auth?.googleSearch);
+        const openaiKey = getConfiguredKey(internalConfig.auth?.openai);
+        const openRouterKey = getConfiguredKey(internalConfig.auth?.openrouter);
 
-        if (googleKey) registerGetAuth(GOOGLE_PROVIDER_ID, () => Promise.resolve(googleKey));
-        if (openaiKey) registerGetAuth(OPENAI_PROVIDER_ID, () => Promise.resolve(openaiKey));
-        if (openRouterKey) registerGetAuth(OPENROUTER_PROVIDER_ID, () => Promise.resolve(openRouterKey));
+        if (googleKey) registerGetAuth(GOOGLE_PROVIDER_ID, () => Promise.resolve({ type: "api", key: googleKey }));
+        if (openaiKey) registerGetAuth(OPENAI_PROVIDER_ID, () => Promise.resolve({ type: "api", key: openaiKey }));
+        if (openRouterKey) registerGetAuth(OPENROUTER_PROVIDER_ID, () => Promise.resolve({ type: "api", key: openRouterKey }));
 
         return {};
       },

package/src/plugin/hooks/create-tool-guard-hooks.ts

@@ -136,7 +136,7 @@ export function createToolGuardHooks(args: {
     : null
 
   const fastApply = isHookEnabled("fast-apply")
-    ? safeHook("fast-apply", () => createFastApplyHook(pluginConfig.fast_apply ?? { enabled: false, ollama_url: "http://localhost:11434", model: "qwen3.5:9b", timeout: 30000 }))
+    ? safeHook("fast-apply", () => createFastApplyHook(pluginConfig.fast_apply ?? { enabled: false, ollama_url: "", model: "", timeout: 30000 }))
     : null
 
   return {

package/src/plugin/skill-context.ts

@@ -8,6 +8,7 @@ import type {
 
 import {
   discoverConfigSourceSkills,
+  discoverManagedPluginSkills,
   discoverUserClaudeSkills,
   discoverProjectClaudeSkills,
   discoverOpencodeGlobalSkills,
@@ -18,6 +19,7 @@ import {
 } from "../features/opencode-skill-loader"
 import { createBuiltinSkills } from "../features/builtin-skills"
 import { getSystemMcpServerNames } from "../features/claude-code-mcp-loader"
+import { resolveSkillDiscoveryConfig } from "./skill-discovery-config"
 
 export type SkillContext = {
   mergedSkills: LoadedSkill[]
@@ -71,21 +73,37 @@ export async function createSkillContext(args: {
     return true
   })
 
-  const includeClaudeSkills = pluginConfig.claude_code?.skills !== false
-  const [configSourceSkills, userSkills, globalSkills, projectSkills, opencodeProjectSkills, agentsProjectSkills, agentsGlobalSkills] =
+  const discovery = resolveSkillDiscoveryConfig(pluginConfig)
+  const [
+    managedPluginSkills,
+    configSourceSkills,
+    userSkills,
+    globalSkills,
+    projectSkills,
+    opencodeProjectSkills,
+    agentsProjectSkills,
+    agentsGlobalSkills,
+  ] =
     await Promise.all([
-      discoverConfigSourceSkills({
-        config: pluginConfig.skills,
-        configDir: directory,
-      }),
-      includeClaudeSkills ? discoverUserClaudeSkills() : Promise.resolve([]),
-      discoverOpencodeGlobalSkills(),
-      includeClaudeSkills ? discoverProjectClaudeSkills(directory) : Promise.resolve([]),
-      discoverOpencodeProjectSkills(directory),
-      discoverProjectAgentsSkills(directory),
-      discoverGlobalAgentsSkills(),
+      discoverManagedPluginSkills(),
+      discovery.config_sources
+        ? discoverConfigSourceSkills({
+          config: pluginConfig.skills,
+          configDir: directory,
+        })
+        : Promise.resolve([]),
+      discovery.global_claude ? discoverUserClaudeSkills() : Promise.resolve([]),
+      discovery.global_opencode ? discoverOpencodeGlobalSkills() : Promise.resolve([]),
+      discovery.project_claude ? discoverProjectClaudeSkills(directory) : Promise.resolve([]),
+      discovery.project_opencode ? discoverOpencodeProjectSkills(directory) : Promise.resolve([]),
+      discovery.project_agents ? discoverProjectAgentsSkills(directory) : Promise.resolve([]),
+      discovery.global_agents ? discoverGlobalAgentsSkills() : Promise.resolve([]),
     ])
 
+  const filteredManagedPluginSkills = filterProviderGatedSkills(
+    managedPluginSkills,
+    browserProvider,
+  )
   const filteredConfigSourceSkills = filterProviderGatedSkills(
     configSourceSkills,
     browserProvider,
@@ -109,7 +127,7 @@ export async function createSkillContext(args: {
   const mergedSkills = mergeSkills(
     builtinSkills,
     pluginConfig.skills,
-    filteredConfigSourceSkills,
+    [...filteredManagedPluginSkills, ...filteredConfigSourceSkills],
     [...filteredUserSkills, ...filteredAgentsGlobalSkills],
     filteredGlobalSkills,
     [...filteredProjectSkills, ...filteredAgentsProjectSkills],

package/src/plugin/skill-discovery-config.ts

@@ -0,0 +1,32 @@
+import type { HiaiOpenCodeConfig } from "../config"
+import type { SkillDiscoveryConfig } from "../config/schema"
+
+export type ResolvedSkillDiscoveryConfig = Required<SkillDiscoveryConfig>
+
+const DEFAULT_SKILL_DISCOVERY: ResolvedSkillDiscoveryConfig = {
+  config_sources: true,
+  project_opencode: true,
+  global_opencode: false,
+  project_claude: false,
+  global_claude: false,
+  project_agents: false,
+  global_agents: false,
+}
+
+export function resolveSkillDiscoveryConfig(
+  pluginConfig: HiaiOpenCodeConfig,
+): ResolvedSkillDiscoveryConfig {
+  const resolved: ResolvedSkillDiscoveryConfig = {
+    ...DEFAULT_SKILL_DISCOVERY,
+    ...(pluginConfig.skill_discovery ?? {}),
+  }
+
+  // Compatibility switch: historically this only controlled Claude-style skills.
+  // Keep that meaning, but make it stronger for those two sources.
+  if (pluginConfig.claude_code?.skills === false) {
+    resolved.project_claude = false
+    resolved.global_claude = false
+  }
+
+  return resolved
+}

package/src/plugin-handlers/agent-config-handler.ts

@@ -7,6 +7,7 @@ import { AGENT_NAME_MAP } from "../shared/migration";
 import { registerAgentName } from "../features/claude-code-session-state";
 import {
   discoverConfigSourceSkills,
+  discoverManagedPluginSkills,
   deduplicateSkillsByName,
   discoverGlobalAgentsSkills,
   discoverOpencodeGlobalSkills,
@@ -31,6 +32,7 @@ import {
   filterProtectedAgentOverrides,
 } from "./agent-override-protection";
 import { buildStrategistAgentConfig } from "./strategist-agent-config-builder";
+import { resolveSkillDiscoveryConfig } from "../plugin/skill-discovery-config";
 
 type AgentConfigRecord = Record<string, Record<string, unknown> | undefined> & {
   build?: Record<string, unknown>;
@@ -130,8 +132,9 @@ export async function applyAgentConfig(params: {
     },
   ) as typeof params.pluginConfig.disabled_agents;
 
-  const includeClaudeSkillsForAwareness = params.pluginConfig.claude_code?.skills ?? true;
+  const discovery = resolveSkillDiscoveryConfig(params.pluginConfig);
   const [
+    discoveredManagedPluginSkills,
     discoveredConfigSourceSkills,
     discoveredUserSkills,
     discoveredProjectSkills,
@@ -140,23 +143,27 @@ export async function applyAgentConfig(params: {
     discoveredOpencodeProjectSkills,
     discoveredGlobalAgentsSkills,
   ] = await Promise.all([
-    discoverConfigSourceSkills({
-      config: params.pluginConfig.skills,
-      configDir: params.ctx.directory,
-    }),
-    includeClaudeSkillsForAwareness ? discoverUserClaudeSkills() : Promise.resolve([]),
-    includeClaudeSkillsForAwareness
-       ? discoverProjectClaudeSkills(params.ctx.directory)
-       : Promise.resolve([]),
-    includeClaudeSkillsForAwareness
+    discoverManagedPluginSkills(),
+    discovery.config_sources
+      ? discoverConfigSourceSkills({
+        config: params.pluginConfig.skills,
+        configDir: params.ctx.directory,
+      })
+      : Promise.resolve([]),
+    discovery.global_claude ? discoverUserClaudeSkills() : Promise.resolve([]),
+    discovery.project_claude
+      ? discoverProjectClaudeSkills(params.ctx.directory)
+      : Promise.resolve([]),
+    discovery.project_agents
       ? discoverProjectAgentsSkills(params.ctx.directory)
       : Promise.resolve([]),
-    discoverOpencodeGlobalSkills(),
-    discoverOpencodeProjectSkills(params.ctx.directory),
-    includeClaudeSkillsForAwareness ? discoverGlobalAgentsSkills() : Promise.resolve([]),
+    discovery.global_opencode ? discoverOpencodeGlobalSkills() : Promise.resolve([]),
+    discovery.project_opencode ? discoverOpencodeProjectSkills(params.ctx.directory) : Promise.resolve([]),
+    discovery.global_agents ? discoverGlobalAgentsSkills() : Promise.resolve([]),
   ]);
 
   const allDiscoveredSkills = [
+    ...discoveredManagedPluginSkills,
     ...discoveredConfigSourceSkills,
     ...discoveredOpencodeProjectSkills,
     ...discoveredProjectSkills,

package/src/plugin-handlers/command-config-handler.ts

@@ -12,6 +12,7 @@ import {
 import { loadBuiltinCommands } from "../features/builtin-commands";
 import {
   discoverConfigSourceSkills,
+  loadManagedPluginSkills,
   loadGlobalAgentsSkills,
   loadProjectAgentsSkills,
   loadUserSkills,
@@ -26,6 +27,7 @@ import {
   log,
 } from "../shared";
 import type { PluginComponents } from "./plugin-components-loader";
+import { resolveSkillDiscoveryConfig } from "../plugin/skill-discovery-config";
 
 export async function applyCommandConfig(params: {
   config: Record<string, unknown>;
@@ -39,10 +41,13 @@ export async function applyCommandConfig(params: {
   const systemCommands = (params.config.command as Record<string, unknown>) ?? {};
 
   const includeClaudeCommands = params.pluginConfig.claude_code?.commands ?? true;
-  const includeClaudeSkills = params.pluginConfig.claude_code?.skills ?? true;
+  const discovery = resolveSkillDiscoveryConfig(params.pluginConfig);
 
   const externalSkillPlugin = detectExternalSkillPlugin(params.ctx.directory);
-  if (includeClaudeSkills && externalSkillPlugin.detected) {
+  if (
+    (discovery.project_claude || discovery.global_claude || discovery.global_opencode) &&
+    externalSkillPlugin.detected
+  ) {
     log(getSkillPluginConflictWarning(externalSkillPlugin.pluginName!));
   }
 
@@ -52,6 +57,7 @@ export async function applyCommandConfig(params: {
     projectCommands,
     opencodeGlobalCommands,
     opencodeProjectCommands,
+    managedPluginSkills,
     userSkills,
     globalAgentsSkills,
     projectSkills,
@@ -59,24 +65,28 @@ export async function applyCommandConfig(params: {
     opencodeGlobalSkills,
     opencodeProjectSkills,
   ] = await Promise.all([
-    discoverConfigSourceSkills({
-      config: params.pluginConfig.skills,
-      configDir: params.ctx.directory,
-    }),
+    discovery.config_sources
+      ? discoverConfigSourceSkills({
+        config: params.pluginConfig.skills,
+        configDir: params.ctx.directory,
+      })
+      : Promise.resolve([]),
     includeClaudeCommands ? loadUserCommands() : Promise.resolve({}),
     includeClaudeCommands ? loadProjectCommands(params.ctx.directory) : Promise.resolve({}),
     loadOpencodeGlobalCommands(),
     loadOpencodeProjectCommands(params.ctx.directory),
-    includeClaudeSkills ? loadUserSkills() : Promise.resolve({}),
-    includeClaudeSkills ? loadGlobalAgentsSkills() : Promise.resolve({}),
-    includeClaudeSkills ? loadProjectSkills(params.ctx.directory) : Promise.resolve({}),
-    includeClaudeSkills ? loadProjectAgentsSkills(params.ctx.directory) : Promise.resolve({}),
-    loadOpencodeGlobalSkills(),
-    loadOpencodeProjectSkills(params.ctx.directory),
+    loadManagedPluginSkills(),
+    discovery.global_claude ? loadUserSkills() : Promise.resolve({}),
+    discovery.global_agents ? loadGlobalAgentsSkills() : Promise.resolve({}),
+    discovery.project_claude ? loadProjectSkills(params.ctx.directory) : Promise.resolve({}),
+    discovery.project_agents ? loadProjectAgentsSkills(params.ctx.directory) : Promise.resolve({}),
+    discovery.global_opencode ? loadOpencodeGlobalSkills() : Promise.resolve({}),
+    discovery.project_opencode ? loadOpencodeProjectSkills(params.ctx.directory) : Promise.resolve({}),
   ]);
 
   params.config.command = {
     ...builtinCommands,
+    ...managedPluginSkills,
     ...skillsToCommandDefinitionRecord(configSourceSkills),
     ...userCommands,
     ...userSkills,

package/src/shared/migration/agent-names.ts

@@ -64,10 +64,10 @@ export const AGENT_NAME_MAP: Record<string, string> = {
   // Designer
   designer: "designer",
 
-  // Multimodal (runtime key remains "ui" for compatibility)
-  ui: "ui",
-  vision: "ui",
-  multimodal: "ui",
+  // Multimodal / Vision
+  ui: "multimodal",
+  vision: "multimodal",
+  multimodal: "multimodal",
 }
 
 export const BUILTIN_AGENT_NAMES = new Set([
@@ -77,7 +77,7 @@ export const BUILTIN_AGENT_NAMES = new Set([
   "critic",
   "designer",
   "researcher",
-  "ui",
+  "multimodal",
   "platform-manager",
   "guard",
 ])

package/src/shared/startup-diagnostics.ts

@@ -0,0 +1,77 @@
+import { existsSync, readFileSync } from "node:fs"
+import { join } from "node:path"
+
+import type { HiaiOpenCodeConfig, HiaiOpencodeConfig } from "../config"
+import { HIAI_MCP_REGISTRY } from "../mcp/registry"
+import { parseJsoncSafe } from "./jsonc-parser"
+import { getOpenCodeConfigPaths } from "./opencode-config-dir"
+import { PLUGIN_NAME } from "./plugin-identity"
+
+interface OpenCodeConfig {
+  plugin?: Array<string | [string, ...unknown[]]>
+}
+
+function readPlugins(configPath: string): string[] {
+  if (!existsSync(configPath)) return []
+
+  try {
+    const content = readFileSync(configPath, "utf-8")
+    const parsed = parseJsoncSafe<OpenCodeConfig>(content)
+    return (parsed.data?.plugin ?? [])
+      .map((entry) => typeof entry === "string" ? entry : Array.isArray(entry) ? entry[0] : "")
+      .filter((entry): entry is string => typeof entry === "string" && entry.trim().length > 0)
+  } catch {
+    return []
+  }
+}
+
+export function warnIfListPluginEntry(directory: string): void {
+  const globalPaths = getOpenCodeConfigPaths({ binary: "opencode", version: null })
+  const candidates = [
+    join(directory, ".opencode", "opencode.json"),
+    join(directory, ".opencode", "opencode.jsonc"),
+    globalPaths.configJson,
+    globalPaths.configJsonc,
+  ]
+
+  for (const configPath of candidates) {
+    const plugins = readPlugins(configPath)
+    if (!plugins.includes("list")) continue
+
+    console.warn(`[hiai-opencode] WARNING: ${configPath} contains plugin: ["list"].`)
+    console.warn("[hiai-opencode] This can prevent hiai-opencode MCP servers from loading from that config scope.")
+    console.warn(`[hiai-opencode] Update it to: plugin: ["${PLUGIN_NAME}"]`)
+  }
+}
+
+function hasConfigAuthFallback(pluginConfig: HiaiOpenCodeConfig, envName: string): boolean {
+  if (envName === "FIRECRAWL_API_KEY") return !!pluginConfig.auth?.firecrawl?.trim()
+  if (envName === "STITCH_AI_API_KEY") return !!pluginConfig.auth?.stitch?.trim()
+  if (envName === "CONTEXT7_API_KEY") return !!pluginConfig.auth?.context7?.trim()
+  return false
+}
+
+export function warnMissingRequiredMcpEnv(args: {
+  pluginConfig: HiaiOpenCodeConfig
+  platformConfig: HiaiOpencodeConfig
+}): void {
+  const disabled = new Set(args.pluginConfig.disabled_mcps ?? [])
+  const mcpConfig = args.platformConfig.mcp ?? {}
+
+  for (const [name, entry] of Object.entries(HIAI_MCP_REGISTRY)) {
+    if (disabled.has(name)) continue
+    if (mcpConfig[name]?.enabled === false) continue
+    if (!entry.requiredEnv || entry.requiredEnv.length === 0) continue
+
+    const missing = entry.requiredEnv.filter((envName) =>
+      !process.env[envName]?.trim() && !hasConfigAuthFallback(args.pluginConfig, envName)
+    )
+
+    if (missing.length === 0) continue
+
+    console.warn(
+      `[hiai-opencode] MCP "${name}" is enabled but missing required env: ${missing.join(", ")}.`
+      + " The plugin will continue to load; set the key or disable this MCP in hiai-opencode.json.",
+    )
+  }
+}

package/src/config/models.ts

@@ -1,32 +0,0 @@
-export const MODEL_ROLE_GUIDE = [
-  "fast: cheap/default for bounded helpers, researcher-style scans, platform chores",
-  "mid: balanced default for steady execution/review work",
-  "high: stronger general-purpose model for primary implementation and planning",
-  "ultrahigh: highest-cost/high-accuracy slot for hard architecture or critical decisions",
-  "vision: preferred for UI/media/multimodal interpretation and visual work",
-  "reasoning: preferred for deeper multi-step reasoning when latency/cost are acceptable",
-] as const;
-
-export const PROVIDER_MODEL_RULES = [
-  "openai: use `openai/<model>` for direct OpenAI calls, e.g. `openai/gpt-5` or `openai/o1`",
-  "anthropic: use `anthropic/<model>`, e.g. `anthropic/claude-3.5-sonnet`",
-  "deepseek: use `deepseek/<model>` when connected directly",
-  "glm: use `z-ai/<model>` or the provider id exposed by your gateway/client",
-  "minimax: use `minimax/<model>`",
-  "qwen: use `qwen/<model>`",
-  "ollama: use the native local model id in Ollama config, e.g. `qwen3.5:4b`",
-  "openrouter: use `openrouter/<vendor>/<model>`, e.g. `openrouter/anthropic/claude-3.5-sonnet`",
-  "rule: store fully qualified model ids in config; avoid local aliases like `fast`, `sonnet`, or provider-less ids",
-] as const;
-
-export const MODEL_PRESETS = {
-  fast: "openrouter/google/gemini-2.0-flash",
-  mid: "openrouter/anthropic/claude-3.5-sonnet",
-  high: "openrouter/anthropic/claude-3.5-opus",
-  ultrahigh: "openrouter/openai/gpt-4o",
-  vision: "openrouter/google/gemini-2.0-pro-exp-02-05",
-  reasoning: "openrouter/openai/o1",
-  strategist: "openrouter/z-ai/glm-5.1",
-  critic: "openrouter/qwen/qwen2.5-72b-instruct",
-  writing: "openrouter/kimi/kimi-latest",
-} as const;