42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
# src/ — Plugin Source
|
|
|
|
**Generated:** 2026-02-21
|
|
|
|
## OVERVIEW
|
|
|
|
Root source directory. Entry point `index.ts` orchestrates 4-step initialization: config → managers → tools → hooks → plugin interface.
|
|
|
|
## KEY FILES
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `index.ts` | Plugin entry, exports `OhMyOpenCodePlugin` |
|
|
| `plugin-config.ts` | JSONC parse, multi-level merge (user → project → defaults), Zod validation |
|
|
| `create-managers.ts` | TmuxSessionManager, BackgroundManager, SkillMcpManager, ConfigHandler |
|
|
| `create-tools.ts` | SkillContext + AvailableCategories + ToolRegistry |
|
|
| `create-hooks.ts` | 3-tier hook composition: Core(35) + Continuation(7) + Skill(2) |
|
|
| `plugin-interface.ts` | Assembles 8 OpenCode hook handlers into PluginInterface |
|
|
|
|
## CONFIG LOADING
|
|
|
|
```
|
|
loadPluginConfig(directory, ctx)
|
|
1. User: ~/.config/opencode/oh-my-opencode.jsonc
|
|
2. Project: .opencode/oh-my-opencode.jsonc
|
|
3. mergeConfigs(user, project) → deepMerge for agents/categories, Set union for disabled_*
|
|
4. Zod safeParse → defaults for omitted fields
|
|
5. migrateConfigFile() → legacy key transformation
|
|
```
|
|
|
|
## HOOK COMPOSITION
|
|
|
|
```
|
|
createHooks()
|
|
├─→ createCoreHooks() # 35 hooks
|
|
│ ├─ createSessionHooks() # 21: contextWindowMonitor, thinkMode, ralphLoop, sessionRecovery, jsonErrorRecovery, sisyphusGptHephaestusReminder, anthropicEffort...
|
|
│ ├─ createToolGuardHooks() # 10: commentChecker, rulesInjector, writeExistingFileGuard, hashlineEditDiffEnhancer...
|
|
│ └─ createTransformHooks() # 4: claudeCodeHooks, keywordDetector, contextInjector, thinkingBlockValidator
|
|
├─→ createContinuationHooks() # 7: todoContinuationEnforcer, atlas, stopContinuationGuard...
|
|
└─→ createSkillHooks() # 2: categorySkillReminder, autoSlashCommand
|
|
```
|