Files

YeonGyu-Kim aac79f03b5 docs: regenerate all AGENTS.md files from comprehensive codebase exploration

- Fired 33 parallel explore agents across all major directories
- Analyzed 1164 TS files, 133k LOC, 41 hooks, 26 tools, 11 agents, 18 features
- Regenerated 13 AGENTS.md files with 905 total lines
- Root: plugin architecture, initialization flow, 7 OpenCode hook handlers
- src/: entry point orchestration, hook composition pipeline
- agents/: 11 agent inventory with tool restrictions and factory patterns
- hooks/: 41 hooks organized by 5 tiers, key complex hooks documented
- tools/: 26 tools across 14 directories, delegation categories
- features/: 18 modules mapped by complexity (HIGH/MEDIUM/LOW)
- shared/: 101 utilities in 13 categories, model resolution pipeline
- config/: 22 schema files, Zod v4 validation system
- cli/: 5 commands, doctor checks, model fallback system
- mcp/: 3-tier MCP system architecture
- plugin-handlers/: 6-phase config loading pipeline
- claude-code-hooks/: CC settings.json compatibility layer
- claude-tasks/: task schema + file-based persistence

🤖 Generated with assistance of oh-my-opencode

2026-02-17 11:17:01 +09:00

2.3 KiB

Raw Blame History

src/plugin-handlers/ — 6-Phase Config Loading Pipeline

Generated: 2026-02-17

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 merged
disabled_* arrays: Set union

2.3 KiB Raw Blame History