fix: externalize @ast-grep/napi for cross-platform support, add installation docs

AGENTS.md

@@ -0,0 +1,92 @@
+# PROJECT KNOWLEDGE BASE
+
+**Generated:** 2025-12-05T01:16:20+09:00
+**Commit:** 6c9a2ee
+**Branch:** master
+
+## OVERVIEW
+
+OpenCode plugin distribution implementing Claude Code/AmpCode features. Provides multi-model agent orchestration, LSP tools, AST-Grep search, and safe-grep utilities.
+
+## STRUCTURE
+
+```
+oh-my-opencode/
+├── src/
+│   ├── agents/        # AI agent definitions (oracle, librarian, explore, etc.)
+│   ├── hooks/         # Plugin lifecycle hooks
+│   ├── tools/         # LSP, AST-Grep, Safe-Grep tool implementations
+│   │   ├── lsp/       # 11 LSP tools (hover, definition, references, etc.)
+│   │   ├── ast-grep/  # AST-aware code search
+│   │   └── safe-grep/ # Safe grep with limits
+│   └── features/      # Terminal features
+├── dist/              # Build output (bun + tsc declarations)
+└── test-rule.yml      # AST-Grep test rules
+```
+
+## WHERE TO LOOK
+
+| Task | Location | Notes |
+|------|----------|-------|
+| Add new agent | `src/agents/` | Export from index.ts |
+| Add new hook | `src/hooks/` | Export from index.ts |
+| Add new tool | `src/tools/` | Follow lsp/ pattern: index, types, tools, utils |
+| Modify LSP behavior | `src/tools/lsp/` | client.ts for connection logic |
+| AST-Grep patterns | `src/tools/ast-grep/` | napi.ts for @ast-grep/napi |
+| Terminal features | `src/features/terminal/` | title.ts |
+
+## CONVENTIONS
+
+- **Package manager**: Bun only (not npm/yarn)
+- **Build**: Dual output - `bun build` + `tsc --emitDeclarationOnly`
+- **Types**: bun-types (not @types/node)
+- **Exports**: Barrel pattern - `export * from "./module"` in index.ts
+- **Module structure**: index.ts, types.ts, constants.ts, utils.ts, tools.ts per tool
+
+## ANTI-PATTERNS (THIS PROJECT)
+
+- **Bash file operations**: Never use mkdir/touch/rm/cp/mv for file creation
+- **npm/yarn**: Use bun exclusively
+- **@types/node**: Use bun-types instead
+- **Generic AI aesthetics**: No Space Grotesk, avoid typical AI-generated UI patterns
+- **Rush completion**: Never mark tasks complete without verification
+- **Interrupting work**: Complete tasks fully before stopping
+
+## UNIQUE STYLES
+
+- **Directory naming**: kebab-case (`ast-grep/`, `safe-grep/`)
+- **Tool organization**: Each tool has cli.ts, constants.ts, index.ts, napi.ts/tools.ts, types.ts, utils.ts
+- **Platform handling**: Union type `"darwin" | "linux" | "win32" | "unsupported"`
+- **Error handling**: Consistent try/catch with async/await
+- **Optional props**: Extensive use of `?` for optional interface properties
+- **Flexible objects**: `Record<string, unknown>` for dynamic configs
+
+## AGENT MODELS
+
+| Agent | Model | Purpose |
+|-------|-------|---------|
+| oracle | GPT-5.1 | Code review, strategic planning |
+| librarian | Claude Haiku | Documentation, example lookup |
+| explore | Grok | File/codebase exploration |
+| frontend-ui-ux-engineer | Gemini | UI generation |
+| document-writer | Gemini | Documentation writing |
+
+## COMMANDS
+
+```bash
+# Type check
+bun run typecheck
+
+# Build
+bun run build
+
+# Clean + Build
+bun run rebuild
+```
+
+## NOTES
+
+- **No tests**: Test framework not configured
+- **No CI/CD**: GitHub workflows not present
+- **Version requirement**: OpenCode >= 1.0.132 (earlier versions have config bugs)
+- **Multi-language docs**: README.md, README.en.md, README.ko.md