opencode-ultra 0.2.0

package/README.md

@@ -0,0 +1,419 @@
+# opencode-ultra
+
+[oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) をベースにした OpenCode 1.2.x プラグイン。
+マルチエージェントオーケストレーション・キーワード駆動モード切替・ルール注入を軽量な単一プラグインで実現する。
+
+## oh-my-opencode との違い
+
+| | oh-my-opencode | opencode-ultra |
+|---|---|---|
+| 構成 | フルスタック (LSP, AST-Grep, MCP, Hook 25+, Ralph Loop, Comment Checker...) | **オーケストレーション特化** — 同等機能を軽量に再実装 |
+| エージェント表 | ハードコード | **設定から動的生成** — `oh-my-opencode.json` のオーバーライドが Sisyphus のプロンプトに自動反映 |
+| プラン承認 | なし (即実行) | **Plan-First Protocol** — spawn_agent 前に Phase 形式のプランを提示、ユーザー承認を待つ |
+| 並列制御 | バックグラウンドタスク API | **Semaphore ベース** — グローバル/プロバイダー/モデル単位で同時実行制限 |
+| Categories | ハードコード | **設定可能** — カテゴリでモデル/バリアントを一括切替 |
+| Ralph Loop | 外部ツール依存 | **ビルトインツール** — `<promise>DONE</promise>` マーカーで完了検知 |
+| Comment Checker | 外部バイナリ (AST-Grep) | **正規表現ベース** — AIスロップパターン検知 |
+| Todo Enforcer | `tool.execute.after` 方式 | **`session.idle` イベント方式** — セッション idle 時に未完了 TODO を検査 |
+| MCP | Exa, Context7, grep_app | **Context7 のみ** (API キー不要で動作、キーありでレートリミット緩和) |
+| 依存 | 多数 (Exa, tmux...) | **最小限** (`@opencode-ai/plugin`, `jsonc-parser`, `zod`) |
+| 設定形式 | JSON | **JSONC** (コメント・末尾カンマ対応) |
+
+## アーキテクチャ
+
+```
+User
+  │
+  │  "ultrawork" / "ulw" キーワード
+  │
+  ▼
+┌──────────────────────────────────────────────┐
+│  opencode-ultra plugin                       │
+│                                              │
+│  chat.message hook                           │
+│  ├─ keyword-detector                         │
+│  │  └─ ultrawork / search / analyze          │
+│  └─ ultrawork → variant: "max"               │
+│                                              │
+│  system.transform hook                       │
+│  ├─ keyword message injection                │
+│  └─ rules-injector (.opencode/rules.md)      │
+│                                              │
+│  tool.execute.after hook                     │
+│  └─ comment-checker (Write/Edit 後に検査)     │
+│                                              │
+│  event hook                                  │
+│  ├─ session cleanup                          │
+│  └─ todo-enforcer (session.idle 時に検査)     │
+│                                              │
+│  config hook                                 │
+│  └─ register agents to OpenCode              │
+│                                              │
+│  tools                                       │
+│  ├─ spawn_agent (並列実行 + 並列制御)         │
+│  ├─ ralph_loop (自律ループ実行)               │
+│  └─ cancel_ralph (ループキャンセル)           │
+│                                              │
+│  MCP registration                            │
+│  └─ context7 (自動登録)                       │
+└──────────────┬───────────────────────────────┘
+               │
+               │  spawn_agent({ agents: [...] })
+               │
+     ┌─────────┼─────────┐
+     ▼         ▼         ▼
+  Session   Session   Session   (ephemeral)
+  Agent A   Agent B   Agent C
+     │         │         │
+     ▲         ▲         ▲
+     └── ConcurrencyPool ┘
+         (Semaphore制御)
+```
+
+## エージェント構成
+
+Sisyphus (オーケストレーター) が直接ツールを使わず、全てを spawn_agent 経由でサブエージェントに委任する。
+
+### ビルトインデフォルト
+
+| Agent | 役割 | デフォルトモデル | モード |
+|-------|------|-----------------|--------|
+| **sisyphus** | オーケストレーター — 分析・計画・委任 | anthropic/claude-opus-4-5 | primary |
+| **oracle** | 設計・デバッグ・アーキテクチャ判断 | openai/gpt-5.2 | subagent |
+| **explore** | 高速コードベース偵察 | anthropic/claude-haiku-4-5 | subagent |
+| **librarian** | ドキュメント・ベストプラクティス調査 | anthropic/claude-sonnet-4-5 | subagent |
+| **metis** | タスク分解・並列実行計画 | anthropic/claude-sonnet-4-5 | subagent |
+| **hephaestus** | 自律型実装ワーカー | openai/gpt-5.2 | subagent |
+| **momus** | コードレビュー・品質チェック | anthropic/claude-sonnet-4-5 | subagent |
+| **atlas** | タスク管理・進捗追跡 | anthropic/claude-sonnet-4-5 | subagent |
+| **multimodal-looker** | 画像・スクリーンショット解析 | anthropic/claude-sonnet-4-5 | subagent |
+
+**全てのモデルは `oh-my-opencode.json` でオーバーライド可能。** Sisyphus のプロンプト内エージェント表にはオーバーライド後の実際のモデル名が動的に埋め込まれる。
+
+### Sisyphus の制約
+
+Sisyphus は以下のツールが**物理的に無効化**されている:
+
+```
+Grep: false, Glob: false, Read: false,
+Write: false, Edit: false, Bash: false
+```
+
+使えるのは `spawn_agent`、`ralph_loop`、`cancel_ralph` と TODO 系ツールのみ。これにより高コストな Orchestrator トークンの浪費を防ぎ、適切なモデルへの委任を強制する。
+
+## Plan-First Protocol
+
+Sisyphus は spawn_agent を呼ぶ前に、必ず以下の形式でプランを提示する:
+
+```
+## Execution Plan
+
+### Phase 1: 偵察 (parallel)
+- [ ] API ルート探索 → explore (gpt-5.3-codex-spark)
+- [ ] フレームワーク仕様調査 → librarian (glm-4.7)
+
+### Phase 2: 実装 (after Phase 1)
+- [ ] エンドポイント実装 → hephaestus (gpt-5.2)
+
+### Phase 3: Review
+- [ ] コードレビュー → momus (gpt-5.3-codex)
+
+Estimated agents: 4 | Phases: 3
+```
+
+- 独立タスクは同一 Phase にグループ化 (並列実行)
+- 依存関係があるタスクは別 Phase
+- エージェント名 + 実際のモデル名を表示
+- **「このプランで進めますか？」で承認待ち — OK するまで実行しない**
+
+## spawn_agent ツール
+
+Sisyphus が使う並列エージェント実行ツール。
+
+```typescript
+spawn_agent({
+  agents: [
+    { agent: "explore", prompt: "Find all API routes in src/", description: "Route discovery" },
+    { agent: "librarian", prompt: "Research Express middleware best practices", description: "Middleware docs" },
+    { agent: "hephaestus", prompt: "Implement the feature", description: "Implementation", category: "deep" }
+  ]
+})
+```
+
+- 複数エージェントは **Promise.all で並列実行**（ConcurrencyPool による同時実行制御付き）
+- 各エージェントは**エフェメラルセッション**で起動 — 完了後に自動削除
+- 内部セッションには `internalSessions` フラグを付与し、**フックの再帰を防止**
+- 進捗は `toolCtx.metadata({ title })` でステータスバーに表示
+- Toast 通知で個別エージェントの完了を通知
+- **`category` パラメータ**でモデル/バリアントをカテゴリから自動解決
+
+### 並列制御 (Concurrency)
+
+`background_task` が設定されていると、Semaphore ベースの並列制御が有効になる。
+
+```
+spawn_agent に 5 エージェント渡す
+  → defaultConcurrency: 3 なら同時 3 個まで
+  → 残りは空きを待って順次実行
+```
+
+| 設定フィールド | 目的 | 動作 |
+|---------------|------|------|
+| `defaultConcurrency` | 全体の同時実行上限 | 全エージェント合計で N 個まで同時実行 |
+| `providerConcurrency` | プロバイダー別上限 (例: openai: 8) | 同一プロバイダーのエージェントを N 個に制限 |
+| `modelConcurrency` | モデル別上限 (例: gpt-5.2: 2) | 同一モデルのエージェントを N 個に制限 |
+
+セマフォは model → provider → global の順で acquire し、global → provider → model の順で release する。エラー時も確実に release される。
+
+`background_task` 未設定の場合は制限なし（従来通り全エージェント同時発火）。
+
+## Categories
+
+spawn_agent の `category` パラメータでモデル/バリアントを一括切替できる。
+
+### ビルトインカテゴリ
+
+| カテゴリ | 用途 | デフォルトモデル | バリアント |
+|---------|------|-----------------|-----------|
+| `visual-engineering` | フロントエンド/UI実装 | google/gemini-3-pro | — |
+| `ultrabrain` | 最高精度タスク | openai/gpt-5.3-codex | xhigh |
+| `deep` | 深い分析・複雑ロジック | openai/gpt-5.3-codex | medium |
+| `quick` | 高速・低コストタスク | anthropic/claude-haiku-4-5 | — |
+| `writing` | ドキュメント・文章 | zai-coding-plan/glm-4.7 | — |
+
+設定ファイルでカスタムカテゴリの追加やビルトインの上書きが可能:
+
+```jsonc
+{
+  "categories": {
+    "quick": { "model": "openai/gpt-4o-mini" },
+    "my-custom": { "model": "custom/model", "variant": "high" }
+  }
+}
+```
+
+## Ralph Loop
+
+自律ループ実行ツール。エージェントが `<promise>DONE</promise>` を出力するか、最大イテレーション数に達するまで繰り返し実行する。
+
+```typescript
+ralph_loop({
+  prompt: "Implement all unit tests for the auth module",
+  agent: "hephaestus",     // default
+  maxIterations: 10         // default
+})
+```
+
+- 各イテレーションで前回の進捗をレビューし、続きから再開するよう指示
+- ステータスバーに `Ralph Loop [3/10] — hephaestus` のように進捗表示
+- `cancel_ralph` ツールで実行中のループを全てキャンセル可能
+
+## Todo Enforcer
+
+セッションが idle になったとき、最後の assistant メッセージに未完了の TODO（`- [ ]`）がある場合、強制継続プロンプトを送信する。
+
+- **最大 5 回**（デフォルト）の強制で無限ループを防止
+- spawn_agent のサブセッションには適用されない
+- `disabled_hooks: ["todo-enforcer"]` で無効化可能
+- 設定で最大回数を変更可能: `"todo_enforcer": { "maxEnforcements": 3 }`
+
+## Comment Checker
+
+Write / Edit ツール実行後に、書き込まれたファイルのコメント品質を検査する。
+
+### 検出するパターン
+
+- コメント比率が 30% を超えるファイル
+- 80 文字超の行コメント (`// This function does...`)
+- 説明的すぎる冒頭 (`// This`, `// The`, `// We`, `// Here`, `// Note:`)
+- AI プレースホルダー (`// TODO: implement`)
+- lint 回避コメント (`// eslint-disable`)
+- 300 文字超の巨大 JSDoc
+
+閾値超えの場合、ツール出力に `[Comment Checker]` 警告を追加する。
+
+```jsonc
+{
+  "comment_checker": {
+    "maxRatio": 0.3,       // コメント比率閾値 (default: 0.3)
+    "slopThreshold": 3     // AIスロップパターン数閾値 (default: 3)
+  }
+}
+```
+
+## MCP 自動登録
+
+プラグイン初期化時に以下の MCP サーバーを自動登録する:
+
+| MCP | パッケージ | API キー |
+|-----|-----------|----------|
+| **Context7** | `@upstash/context7-mcp` | オプション（あるとレートリミット緩和） |
+
+API キーの渡し方:
+
+```jsonc
+{
+  "mcp_api_keys": {
+    "context7": "ctx7sk-..."
+  }
+}
+```
+
+または環境変数 `CONTEXT7_API_KEY` を設定。
+
+`disabled_mcps: ["context7"]` で無効化可能。
+
+## キーワード検知
+
+ユーザーのプロンプトからキーワードを検知し、system prompt に動作モード指示を注入する。
+コードブロック (`` ``` `` / `` ` ``) 内のキーワードは無視する。
+
+| キーワード | モード | 効果 |
+|-----------|--------|------|
+| `ultrawork` / `ulw` | ultrawork | variant を "max" に設定。全エージェント活用・並列実行・TODO 追跡を強制。ユーザーメッセージからキーワードを除去 |
+| `search` / `find` / `探して` / `検索` 等 | search | 複数 explore + librarian エージェントを並列起動。網羅的検索を強制 |
+| `analyze` / `調査` / `なぜ` / `debug` 等 | analyze | コンテキスト収集フェーズを実行。複雑な場合は Oracle に委任 |
+
+日本語・中国語キーワードにも対応。
+
+## ルール注入
+
+`<project>/.opencode/rules.md` が存在する場合、その内容を system prompt に `## Project Rules` として自動注入する。ファイルの mtime でキャッシュし、変更時のみ再読み込み。
+
+## 設定
+
+2 段階の設定マージ:
+
+1. **ユーザー設定**: `~/.config/opencode/oh-my-opencode.json[c]`
+2. **プロジェクト設定**: `<project>/.opencode/oh-my-opencode.json[c]`
+
+プロジェクト設定がユーザー設定をオーバーライドする。
+
+### 設定スキーマ
+
+```jsonc
+{
+  // エージェントごとのモデル・プロンプトオーバーライド
+  "agents": {
+    "sisyphus": { "model": "openai/gpt-5.2" },
+    "oracle": { "model": "zai-coding-plan/glm-5" },
+    "explore": { "model": "openai/gpt-5.3-codex-spark" }
+  },
+
+  // カテゴリ (spawn_agent の category パラメータで使用)
+  "categories": {
+    "quick": { "model": "openai/gpt-4o-mini" }
+  },
+
+  // 無効化
+  "disabled_agents": [],
+  "disabled_hooks": ["keyword-detector", "rules-injector", "todo-enforcer", "comment-checker"],
+  "disabled_tools": ["ralph_loop", "cancel_ralph", "spawn_agent"],
+  "disabled_mcps": ["context7"],
+
+  // 並列制御
+  "background_task": {
+    "defaultConcurrency": 3,
+    "providerConcurrency": {
+      "openai": 8,
+      "zai-coding-plan": 10
+    },
+    "modelConcurrency": {
+      "openai/gpt-5.2": 2
+    }
+  },
+
+  // Comment Checker 設定
+  "comment_checker": {
+    "maxRatio": 0.3,
+    "slopThreshold": 3
+  },
+
+  // Todo Enforcer 設定
+  "todo_enforcer": {
+    "maxEnforcements": 5
+  },
+
+  // MCP API キー
+  "mcp_api_keys": {
+    "context7": "ctx7sk-..."
+  }
+}
+```
+
+### エージェントオーバーライドで使えるフィールド
+
+| フィールド | 型 | 説明 |
+|-----------|---|------|
+| `model` | string | 使用モデル (provider/model 形式) |
+| `description` | string | エージェントの説明 |
+| `prompt` | string | システムプロンプト全体を差し替え |
+| `prompt_append` | string | プロンプト末尾に追記 |
+| `disable` | boolean | 個別に無効化 |
+| `mode` | `"subagent"` / `"primary"` / `"all"` | 実行モード |
+| `maxTokens` | number | 最大出力トークン |
+| `thinking` | `{ type, budgetTokens }` | 思考トークン設定 |
+| `reasoningEffort` | `"low"` / `"medium"` / `"high"` / `"xhigh"` | 推論レベル |
+| `temperature` | number (0-2) | サンプリング温度 |
+| `top_p` | number (0-1) | Top-p |
+| `category` | string | デフォルトカテゴリ |
+| `variant` | string | モデルバリアント |
+
+## フック再帰防止
+
+spawn_agent / ralph_loop で生成されたエフェメラルセッションは `internalSessions` Set で追跡される。`chat.message`、`system.transform`、`tool.execute.after`、`event` の各フックは内部セッションに対してスキップされ、キーワード検知・ルール注入・Comment Checker・Todo Enforcer がサブエージェントに二重適用されることを防ぐ。
+
+## プロジェクト構成
+
+```
+opencode-ultra/
+├── src/
+│   ├── index.ts                  # プラグインエントリポイント (hook/tool/MCP 統合)
+│   ├── config.ts                 # 設定ロード・マージ・バリデーション (Zod)
+│   ├── agents/
+│   │   ├── types.ts              # AgentDef 型定義
+│   │   └── index.ts              # ビルトインエージェント定義 + 動的プロンプト生成
+│   ├── hooks/
+│   │   ├── keyword-detector.ts   # ultrawork/search/analyze キーワード検知
+│   │   ├── rules-injector.ts     # .opencode/rules.md 注入 (mtime キャッシュ)
+│   │   ├── todo-enforcer.ts      # session.idle 時の未完了 TODO 強制継続
+│   │   └── comment-checker.ts    # Write/Edit 後の AI スロップ検知
+│   ├── tools/
+│   │   ├── spawn-agent.ts        # spawn_agent ツール (並列実行 + 並列制御 + カテゴリ)
+│   │   └── ralph-loop.ts         # ralph_loop / cancel_ralph ツール (自律ループ)
+│   ├── concurrency/
+│   │   ├── semaphore.ts          # 汎用セマフォ
+│   │   ├── pool.ts               # ConcurrencyPool (global/provider/model 三層制御)
+│   │   └── index.ts              # バレルエクスポート
+│   ├── categories/
+│   │   └── index.ts              # ビルトインカテゴリ + resolveCategory
+│   ├── mcp/
+│   │   ├── servers.ts            # ビルトイン MCP サーバー定義
+│   │   └── index.ts              # MCP 登録ロジック
+│   └── shared/
+│       ├── paths.ts              # XDG パス解決
+│       ├── jsonc.ts              # JSONC パーサー
+│       ├── log.ts                # [opencode-ultra] プレフィックスログ
+│       └── index.ts              # バレルエクスポート
+├── __test__/                     # Bun テスト (70 tests)
+├── package.json
+├── tsconfig.json
+└── .gitignore
+```
+
+## ビルド・テスト
+
+```bash
+# 依存インストール
+bun install
+
+# ビルド
+bun build src/index.ts --outdir dist --target bun --format esm
+
+# テスト
+bun test
+```
+
+## ライセンス
+
+MIT

package/dist/agents/index.d.ts

@@ -0,0 +1,15 @@
+import type { AgentDef } from "./types";
+export type { AgentDef } from "./types";
+export declare const BUILTIN_AGENTS: Record<string, AgentDef>;
+type AgentOverride = {
+    model?: string;
+    description?: string;
+    prompt?: string;
+    [key: string]: unknown;
+};
+type MinimalPluginConfig = {
+    agents?: Record<string, AgentOverride | undefined>;
+    disabled_agents?: string[];
+    [key: string]: unknown;
+};
+export declare function buildAgents(config: Partial<MinimalPluginConfig>): Record<string, AgentDef>;

package/dist/agents/types.d.ts

@@ -0,0 +1,13 @@
+export interface AgentDef {
+    model: string;
+    description: string;
+    prompt: string;
+    mode?: "subagent" | "primary" | "all";
+    maxTokens?: number;
+    thinking?: {
+        type: "enabled" | "disabled";
+        budgetTokens?: number;
+    };
+    reasoningEffort?: "low" | "medium" | "high" | "xhigh";
+    tools?: Record<string, boolean>;
+}

package/dist/categories/index.d.ts

@@ -0,0 +1,8 @@
+export interface CategoryDef {
+    description: string;
+    model: string;
+    variant?: string;
+}
+export type CategoryConfig = Partial<CategoryDef>;
+export declare const DEFAULT_CATEGORIES: Record<string, CategoryDef>;
+export declare function resolveCategory(categoryName: string, configCategories?: Record<string, CategoryConfig>): CategoryDef | undefined;

package/dist/concurrency/index.d.ts

@@ -0,0 +1,2 @@
+export { Semaphore } from "./semaphore";
+export { ConcurrencyPool, extractProvider, type ConcurrencyConfig } from "./pool";

package/dist/concurrency/pool.d.ts

@@ -0,0 +1,14 @@
+export interface ConcurrencyConfig {
+    defaultConcurrency?: number;
+    providerConcurrency?: Record<string, number>;
+    modelConcurrency?: Record<string, number>;
+}
+export declare function extractProvider(model: string): string;
+export declare class ConcurrencyPool {
+    private global;
+    private providers;
+    private models;
+    private config;
+    constructor(config: ConcurrencyConfig);
+    run<T>(model: string, fn: () => Promise<T>): Promise<T>;
+}

package/dist/concurrency/semaphore.d.ts

@@ -0,0 +1,10 @@
+export declare class Semaphore {
+    private max;
+    private queue;
+    private active;
+    constructor(max: number);
+    acquire(): Promise<void>;
+    release(): void;
+    get pending(): number;
+    get running(): number;
+}

package/dist/config.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+declare const PluginConfigSchema: z.ZodObject<{
+    agents: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        category: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        top_p: z.ZodOptional<z.ZodNumber>;
+        prompt: z.ZodOptional<z.ZodString>;
+        prompt_append: z.ZodOptional<z.ZodString>;
+        disable: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            subagent: "subagent";
+            primary: "primary";
+            all: "all";
+        }>>;
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        thinking: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<{
+                enabled: "enabled";
+                disabled: "disabled";
+            }>;
+            budgetTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        reasoningEffort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            xhigh: "xhigh";
+        }>>;
+    }, z.core.$loose>>>>;
+    categories: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    disabled_agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    disabled_hooks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    disabled_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    disabled_mcps: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    background_task: z.ZodOptional<z.ZodObject<{
+        defaultConcurrency: z.ZodOptional<z.ZodNumber>;
+        providerConcurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        modelConcurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        staleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    comment_checker: z.ZodOptional<z.ZodObject<{
+        maxRatio: z.ZodOptional<z.ZodNumber>;
+        slopThreshold: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    todo_enforcer: z.ZodOptional<z.ZodObject<{
+        maxEnforcements: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    mcp_api_keys: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+export type PluginConfig = z.infer<typeof PluginConfigSchema>;
+export declare function parsePluginConfig(raw: unknown): PluginConfig;
+export declare function mergeConfigs(base: PluginConfig, override: PluginConfig): PluginConfig;
+export declare function loadConfig(projectDir: string): PluginConfig;
+export {};

package/dist/hooks/comment-checker.d.ts

@@ -0,0 +1,17 @@
+export interface CommentCheckResult {
+    ratio: number;
+    slopCount: number;
+    shouldWarn: boolean;
+    message: string;
+}
+export declare function isCodeFile(filePath: string): boolean;
+export declare function checkComments(content: string, filePath: string, maxRatio?: number, slopThreshold?: number): CommentCheckResult;
+export declare function createCommentCheckerHook(internalSessions: Set<string>, maxRatio?: number, slopThreshold?: number): (input: {
+    tool: {
+        name: string;
+    };
+    args: Record<string, unknown>;
+    sessionID: string;
+}, output: {
+    output: string;
+}) => void;

package/dist/hooks/keyword-detector.d.ts

@@ -0,0 +1,10 @@
+export interface DetectedKeyword {
+    type: "ultrawork" | "search" | "analyze";
+    message: string;
+}
+export declare function removeCodeBlocks(text: string): string;
+export declare function extractPromptText(parts: Array<{
+    type: string;
+    text?: string;
+}>): string;
+export declare function detectKeywords(text: string): DetectedKeyword[];

package/dist/hooks/rules-injector.d.ts

@@ -0,0 +1,2 @@
+export declare function loadRules(projectDir: string): string | null;
+export declare function clearRulesCache(): void;

package/dist/hooks/todo-enforcer.d.ts

@@ -0,0 +1,14 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+interface Todo {
+    text: string;
+    completed: boolean;
+}
+export declare function createTodoEnforcer(ctx: PluginInput, internalSessions: Set<string>, maxEnforcements?: number): {
+    onEvent(event: {
+        type: string;
+        properties?: unknown;
+    }): Promise<void>;
+    cleanup(sessionID: string): void;
+};
+export declare function extractTodos(text: string): Todo[];
+export {};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const OpenCodeUltra: Plugin;
+export default OpenCodeUltra;
+export type { PluginConfig } from "./config";