73453a7191
- Update root AGENTS.md: hook count 44→46, commit fcb90d92, generated 2026-02-24
- Update src/AGENTS.md: core hooks 35→37, session hooks 21→23
- Update src/hooks/AGENTS.md: 46 hooks total, add modelFallback/noSisyphusGpt/noHephaestusNonGpt/runtimeFallback, jsonErrorRecovery moved to tool-guard (tier 2)
- Create src/tools/hashline-edit/AGENTS.md (93 lines): documents three-op model, LINE#ID format, execution pipeline
- Refresh timestamps: 2026-02-21→2026-02-24 on 28 files
- Update plugin/AGENTS.md hook composition counts
🤖 Generated with assistance of [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
2.3 KiB
2.3 KiB
src/plugin-handlers/ — 6-Phase Config Loading Pipeline
Generated: 2026-02-24
OVERVIEW
13 non-test files implementing the ConfigHandler — the config hook handler. Executes 6 sequential phases to register agents, tools, MCPs, and commands with OpenCode.
6-PHASE PIPELINE
| Phase | Handler | Purpose |
|---|---|---|
| 1 | applyProviderConfig |
Cache model context limits, detect anthropic-beta headers |
| 2 | loadPluginComponents |
Discover Claude Code plugins (10s timeout, error isolation) |
| 3 | applyAgentConfig |
Load agents from 5 sources, skill discovery, plan demotion |
| 4 | applyToolConfig |
Agent-specific tool permissions |
| 5 | applyMcpConfig |
Merge builtin + CC + plugin MCPs |
| 6 | applyCommandConfig |
Merge commands/skills from 9 parallel sources |
FILES
| File | Lines | Purpose |
|---|---|---|
config-handler.ts |
~200 | Main orchestrator, 6-phase sequential |
plugin-components-loader.ts |
~100 | CC plugin discovery (10s timeout) |
agent-config-handler.ts |
~300 | Agent loading + skill discovery from 5 sources |
mcp-config-handler.ts |
~150 | Builtin + CC + plugin MCP merge |
command-config-handler.ts |
~200 | 9 parallel sources for commands/skills |
tool-config-handler.ts |
~100 | Agent-specific tool grants/denials |
provider-config-handler.ts |
~80 | Provider config + model cache |
prometheus-agent-config-builder.ts |
~100 | Prometheus config with model resolution |
plan-model-inheritance.ts |
28 | Plan demotion logic |
agent-priority-order.ts |
~30 | sisyphus, hephaestus, prometheus, atlas first |
agent-key-remapper.ts |
~30 | Agent key → display name |
category-config-resolver.ts |
~40 | User vs default category lookup |
index.ts |
~10 | Barrel exports |
TOOL PERMISSIONS
| Agent | Granted | Denied |
|---|---|---|
| Librarian | grep_app_* | — |
| Atlas, Sisyphus, Prometheus | task, task_*, teammate | — |
| Hephaestus | task | — |
| Default (all others) | — | grep_app_, task_, teammate, LSP |
MULTI-LEVEL CONFIG MERGE
User (~/.config/opencode/oh-my-opencode.jsonc)
↓ deepMerge
Project (.opencode/oh-my-opencode.jsonc)
↓ Zod defaults
Final Config
agents,categories,claude_code: deep mergeddisabled_*arrays: Set union