oh-my-opencode-beads 0.0.1

package/dist/features/builtin-commands/templates/refactor.d.ts

@@ -0,0 +1 @@
+export declare const REFACTOR_TEMPLATE = "# Intelligent Refactor Command\n\n## Usage\n```\n/refactor <refactoring-target> [--scope=<file|module|project>] [--strategy=<safe|aggressive>]\n\nArguments:\n  refactoring-target: What to refactor. Can be:\n    - File path: src/auth/handler.ts\n    - Symbol name: \"AuthService class\"\n    - Pattern: \"all functions using deprecated API\"\n    - Description: \"extract validation logic into separate module\"\n\nOptions:\n  --scope: Refactoring scope (default: module)\n    - file: Single file only\n    - module: Module/directory scope\n    - project: Entire codebase\n\n  --strategy: Risk tolerance (default: safe)\n    - safe: Conservative, maximum test coverage required\n    - aggressive: Allow broader changes with adequate coverage\n```\n\n## What This Command Does\n\nPerforms intelligent, deterministic refactoring with full codebase awareness. Unlike blind search-and-replace, this command:\n\n1. **Understands your intent** - Analyzes what you actually want to achieve\n2. **Maps the codebase** - Builds a definitive codemap before touching anything\n3. **Assesses risk** - Evaluates test coverage and determines verification strategy\n4. **Breaks down the work** - Creates beads issues for each refactoring step\n5. **Executes precisely** - Step-by-step refactoring with LSP and AST-grep\n6. **Verifies constantly** - Runs tests after each change to ensure zero regression\n\n---\n\n# PHASE 0: INTENT GATE (MANDATORY FIRST STEP)\n\n**BEFORE ANY ACTION, classify and validate the request.**\n\n## Step 0.1: Parse Request Type\n\n| Signal | Classification | Action |\n|--------|----------------|--------|\n| Specific file/symbol | Explicit | Proceed to codebase analysis |\n| \"Refactor X to Y\" | Clear transformation | Proceed to codebase analysis |\n| \"Improve\", \"Clean up\" | Open-ended | **MUST ask**: \"What specific improvement?\" |\n| Ambiguous scope | Uncertain | **MUST ask**: \"Which modules/files?\" |\n| Missing context | Incomplete | **MUST ask**: \"What's the desired outcome?\" |\n\n## Step 0.2: Validate Understanding\n\nBefore proceeding, confirm:\n- [ ] Target is clearly identified\n- [ ] Desired outcome is understood\n- [ ] Scope is defined (file/module/project)\n- [ ] Success criteria can be articulated\n\n**If ANY of above is unclear, ASK CLARIFYING QUESTION:**\n\n```\nI want to make sure I understand the refactoring goal correctly.\n\n**What I understood**: [interpretation]\n**What I'm unsure about**: [specific ambiguity]\n\nOptions I see:\n1. [Option A] - [implications]\n2. [Option B] - [implications]\n\n**My recommendation**: [suggestion with reasoning]\n\nShould I proceed with [recommendation], or would you prefer differently?\n```\n\n## Step 0.3: Create Initial Issues\n\n**IMMEDIATELY after understanding the request, create beads issues:**\n\n```\nbd create --title=\"PHASE 1: Codebase Analysis - launch parallel explore agents\" --type=task --priority=1\nbd create --title=\"PHASE 2: Build Codemap - map dependencies and impact zones\" --type=task --priority=1\nbd create --title=\"PHASE 3: Test Assessment - analyze test coverage and verification strategy\" --type=task --priority=1\nbd create --title=\"PHASE 4: Refactoring Breakdown - decompose into atomic steps\" --type=task --priority=1\nbd create --title=\"PHASE 5: Execute Refactoring - step-by-step with continuous verification\" --type=task --priority=1\nbd create --title=\"PHASE 6: Final Verification - full test suite and regression check\" --type=task --priority=1\n```\n\n---\n\n# PHASE 1: CODEBASE ANALYSIS (PARALLEL EXPLORATION)\n\n**Mark Phase 1 issue as in_progress: `bd update <phase-1-id> --status=in_progress`.**\n\n## 1.1: Launch Parallel Explore Agents (BACKGROUND)\n\nFire ALL of these simultaneously using `call_omo_agent`:\n\n```\n// Agent 1: Find the refactoring target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all occurrences and definitions of [TARGET]. \n  Report: file paths, line numbers, usage patterns.\"\n)\n\n// Agent 2: Find related code\ncall_omo_agent(\n  subagent_type=\"explore\", \n  run_in_background=true,\n  prompt=\"Find all code that imports, uses, or depends on [TARGET].\n  Report: dependency chains, import graphs.\"\n)\n\n// Agent 3: Find similar patterns\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find similar code patterns to [TARGET] in the codebase.\n  Report: analogous implementations, established conventions.\"\n)\n\n// Agent 4: Find tests\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find all test files related to [TARGET].\n  Report: test file paths, test case names, coverage indicators.\"\n)\n\n// Agent 5: Architecture context\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=true,\n  prompt=\"Find architectural patterns and module organization around [TARGET].\n  Report: module boundaries, layer structure, design patterns in use.\"\n)\n```\n\n## 1.2: Direct Tool Exploration (WHILE AGENTS RUN)\n\nWhile background agents are running, use direct tools:\n\n### LSP Tools for Precise Analysis:\n\n```typescript\n// Find definition(s)\nLspGotoDefinition(filePath, line, character)  // Where is it defined?\n\n// Find ALL usages across workspace\nLspFindReferences(filePath, line, character, includeDeclaration=true)\n\n// Get file structure\nLspDocumentSymbols(filePath)  // Hierarchical outline\nLspWorkspaceSymbols(filePath, query=\"[target_symbol]\")  // Search by name\n\n// Get current diagnostics\nlsp_diagnostics(filePath)  // Errors, warnings before we start\n```\n\n### AST-Grep for Pattern Analysis:\n\n```typescript\n// Find structural patterns\nast_grep_search(\n  pattern=\"function $NAME($$$) { $$$ }\",  // or relevant pattern\n  lang=\"typescript\",  // or relevant language\n  paths=[\"src/\"]\n)\n\n// Preview refactoring (DRY RUN)\nast_grep_replace(\n  pattern=\"[old_pattern]\",\n  rewrite=\"[new_pattern]\",\n  lang=\"[language]\",\n  dryRun=true  // ALWAYS preview first\n)\n```\n\n### Grep for Text Patterns:\n\n```\ngrep(pattern=\"[search_term]\", path=\"src/\", include=\"*.ts\")\n```\n\n## 1.3: Collect Background Results\n\n```\nbackground_output(task_id=\"[agent_1_id]\")\nbackground_output(task_id=\"[agent_2_id]\")\n...\n```\n\n**Close Phase 1 issue: `bd close <phase-1-id>` after all results collected.**\n\n---\n\n# PHASE 2: BUILD CODEMAP (DEPENDENCY MAPPING)\n\n**Mark Phase 2 issue as in_progress: `bd update <phase-2-id> --status=in_progress`.**\n\n## 2.1: Construct Definitive Codemap\n\nBased on Phase 1 results, build:\n\n```\n## CODEMAP: [TARGET]\n\n### Core Files (Direct Impact)\n- `path/to/file.ts:L10-L50` - Primary definition\n- `path/to/file2.ts:L25` - Key usage\n\n### Dependency Graph\n```\n[TARGET] \n\u251C\u2500\u2500 imports from: \n\u2502   \u251C\u2500\u2500 module-a (types)\n\u2502   \u2514\u2500\u2500 module-b (utils)\n\u251C\u2500\u2500 imported by:\n\u2502   \u251C\u2500\u2500 consumer-1.ts\n\u2502   \u251C\u2500\u2500 consumer-2.ts\n\u2502   \u2514\u2500\u2500 consumer-3.ts\n\u2514\u2500\u2500 used by:\n    \u251C\u2500\u2500 handler.ts (direct call)\n    \u2514\u2500\u2500 service.ts (dependency injection)\n```\n\n### Impact Zones\n| Zone | Risk Level | Files Affected | Test Coverage |\n|------|------------|----------------|---------------|\n| Core | HIGH | 3 files | 85% covered |\n| Consumers | MEDIUM | 8 files | 70% covered |\n| Edge | LOW | 2 files | 50% covered |\n\n### Established Patterns\n- Pattern A: [description] - used in N places\n- Pattern B: [description] - established convention\n```\n\n## 2.2: Identify Refactoring Constraints\n\nBased on codemap:\n- **MUST follow**: [existing patterns identified]\n- **MUST NOT break**: [critical dependencies]\n- **Safe to change**: [isolated code zones]\n- **Requires migration**: [breaking changes impact]\n\n**Close Phase 2 issue: `bd close <phase-2-id>`.**\n\n---\n\n# PHASE 3: TEST ASSESSMENT (VERIFICATION STRATEGY)\n\n**Mark Phase 3 issue as in_progress: `bd update <phase-3-id> --status=in_progress`.**\n\n## 3.1: Detect Test Infrastructure\n\n```bash\n# Check for test commands\ncat package.json | jq '.scripts | keys[] | select(test(\"test\"))'\n\n# Or for Python\nls -la pytest.ini pyproject.toml setup.cfg\n\n# Or for Go\nls -la *_test.go\n```\n\n## 3.2: Analyze Test Coverage\n\n```\n// Find all tests related to target\ncall_omo_agent(\n  subagent_type=\"explore\",\n  run_in_background=false,  // Need this synchronously\n  prompt=\"Analyze test coverage for [TARGET]:\n  1. Which test files cover this code?\n  2. What test cases exist?\n  3. Are there integration tests?\n  4. What edge cases are tested?\n  5. Estimated coverage percentage?\"\n)\n```\n\n## 3.3: Determine Verification Strategy\n\nBased on test analysis:\n\n| Coverage Level | Strategy |\n|----------------|----------|\n| HIGH (>80%) | Run existing tests after each step |\n| MEDIUM (50-80%) | Run tests + add safety assertions |\n| LOW (<50%) | **PAUSE**: Propose adding tests first |\n| NONE | **BLOCK**: Refuse aggressive refactoring |\n\n**If coverage is LOW or NONE, ask user:**\n\n```\nTest coverage for [TARGET] is [LEVEL].\n\n**Risk Assessment**: Refactoring without adequate tests is dangerous.\n\nOptions:\n1. Add tests first, then refactor (RECOMMENDED)\n2. Proceed with extra caution, manual verification required\n3. Abort refactoring\n\nWhich approach do you prefer?\n```\n\n## 3.4: Document Verification Plan\n\n```\n## VERIFICATION PLAN\n\n### Test Commands\n- Unit: `bun test` / `npm test` / `pytest` / etc.\n- Integration: [command if exists]\n- Type check: `tsc --noEmit` / `pyright` / etc.\n\n### Verification Checkpoints\nAfter each refactoring step:\n1. lsp_diagnostics \u2192 zero new errors\n2. Run test command \u2192 all pass\n3. Type check \u2192 clean\n\n### Regression Indicators\n- [Specific test that must pass]\n- [Behavior that must be preserved]\n- [API contract that must not change]\n```\n\n**Close Phase 3 issue: `bd close <phase-3-id>`.**\n\n---\n\n# PHASE 4: REFACTORING BREAKDOWN (ISSUE DECOMPOSITION)\n\n**Mark Phase 4 issue as in_progress: `bd update <phase-4-id> --status=in_progress`.**\n\n## 4.1: Decompose Refactoring Steps\n\nBased on the codemap and test assessment, break the refactoring into atomic steps.\nUse an oracle agent for complex architectural decisions if needed:\n\n```\ncall_omo_agent(\n  subagent_type=\"oracle\",\n  run_in_background=false,\n  prompt=\"Given the codemap and test coverage, decompose this refactoring into atomic steps:\n\n  ## Refactoring Goal\n  [User's original request]\n\n  ## Codemap (from Phase 2)\n  [Insert codemap here]\n\n  ## Test Coverage (from Phase 3)\n  [Insert verification plan here]\n\n  ## Constraints\n  - MUST follow existing patterns: [list]\n  - MUST NOT break: [critical paths]\n  - MUST run tests after each step\n\n  ## Requirements\n  1. Break down into atomic refactoring steps\n  2. Each step must be independently verifiable\n  3. Order steps by dependency (what must happen first)\n  4. Specify exact files and line ranges for each step\n  5. Include rollback strategy for each step\n  6. Define commit checkpoints\"\n)\n```\n\n## 4.2: Review and Validate Breakdown\n\nAfter receiving the decomposition:\n\n1. **Verify completeness**: All identified files addressed?\n2. **Verify safety**: Each step reversible?\n3. **Verify order**: Dependencies respected?\n4. **Verify verification**: Test commands specified?\n\n## 4.3: Register Step Issues\n\nCreate beads issues for each refactoring step, with dependencies:\n\n```\nbd create --title=\"Step 1: [description]\" --type=task --priority=1\nbd create --title=\"Verify Step 1: run tests\" --type=task --priority=1\nbd dep add <verify-1-id> <step-1-id>  // verification depends on step completion\nbd create --title=\"Step 2: [description]\" --type=task --priority=2\nbd create --title=\"Verify Step 2: run tests\" --type=task --priority=2\nbd dep add <verify-2-id> <step-2-id>\n// ... continue for all steps\n```\n\n**Close Phase 4 issue: `bd close <phase-4-id>`.**\n\n---\n\n# PHASE 5: EXECUTE REFACTORING (DETERMINISTIC EXECUTION)\n\n**Mark Phase 5 issue as in_progress: `bd update <phase-5-id> --status=in_progress`.**\n\n## 5.1: Execution Protocol\n\nFor EACH refactoring step:\n\n### Pre-Step\n1. Mark step issue as in_progress: `bd update <step-id> --status=in_progress`\n2. Read current file state\n3. Verify lsp_diagnostics is baseline\n\n### Execute Step\nUse appropriate tool:\n\n**For Symbol Renames:**\n```typescript\nlsp_prepare_rename(filePath, line, character)  // Validate rename is possible\nlsp_rename(filePath, line, character, newName)  // Execute rename\n```\n\n**For Pattern Transformations:**\n```typescript\n// Preview first\nast_grep_replace(pattern, rewrite, lang, dryRun=true)\n\n// If preview looks good, execute\nast_grep_replace(pattern, rewrite, lang, dryRun=false)\n```\n\n**For Structural Changes:**\n```typescript\n// Use Edit tool for precise changes\nedit(filePath, oldString, newString)\n```\n\n### Post-Step Verification (MANDATORY)\n\n```typescript\n// 1. Check diagnostics\nlsp_diagnostics(filePath)  // Must be clean or same as baseline\n\n// 2. Run tests\nbash(\"bun test\")  // Or appropriate test command\n\n// 3. Type check\nbash(\"tsc --noEmit\")  // Or appropriate type check\n```\n\n### Step Completion\n1. If verification passes \u2192 Close step issue: `bd close <step-id>`\n2. If verification fails \u2192 **STOP AND FIX**\n\n## 5.2: Failure Recovery Protocol\n\nIf ANY verification fails:\n\n1. **STOP** immediately\n2. **REVERT** the failed change\n3. **DIAGNOSE** what went wrong\n4. **OPTIONS**:\n   - Fix the issue and retry\n   - Skip this step (if optional)\n   - Consult oracle agent for help\n   - Ask user for guidance\n\n**NEVER proceed to next step with broken tests.**\n\n## 5.3: Commit Checkpoints\n\nAfter each logical group of changes:\n\n```bash\ngit add [changed-files]\ngit commit -m \"refactor(scope): description\n\n[details of what was changed and why]\"\n```\n\n**Close Phase 5 issue when all refactoring steps done: `bd close <phase-5-id>`.**\n\n---\n\n# PHASE 6: FINAL VERIFICATION (REGRESSION CHECK)\n\n**Mark Phase 6 issue as in_progress: `bd update <phase-6-id> --status=in_progress`.**\n\n## 6.1: Full Test Suite\n\n```bash\n# Run complete test suite\nbun test  # or npm test, pytest, go test, etc.\n```\n\n## 6.2: Type Check\n\n```bash\n# Full type check\ntsc --noEmit  # or equivalent\n```\n\n## 6.3: Lint Check\n\n```bash\n# Run linter\neslint .  # or equivalent\n```\n\n## 6.4: Build Verification (if applicable)\n\n```bash\n# Ensure build still works\nbun run build  # or npm run build, etc.\n```\n\n## 6.5: Final Diagnostics\n\n```typescript\n// Check all changed files\nfor (file of changedFiles) {\n  lsp_diagnostics(file)  // Must all be clean\n}\n```\n\n## 6.6: Generate Summary\n\n```markdown\n## Refactoring Complete\n\n### What Changed\n- [List of changes made]\n\n### Files Modified\n- `path/to/file.ts` - [what changed]\n- `path/to/file2.ts` - [what changed]\n\n### Verification Results\n- Tests: PASSED (X/Y passing)\n- Type Check: CLEAN\n- Lint: CLEAN\n- Build: SUCCESS\n\n### No Regressions Detected\nAll existing tests pass. No new errors introduced.\n```\n\n**Close Phase 6 issue: `bd close <phase-6-id>`.**\n\n---\n\n# CRITICAL RULES\n\n## NEVER DO\n- Skip lsp_diagnostics check after changes\n- Proceed with failing tests\n- Make changes without understanding impact\n- Use `as any`, `@ts-ignore`, `@ts-expect-error`\n- Delete tests to make them pass\n- Commit broken code\n- Refactor without understanding existing patterns\n\n## ALWAYS DO\n- Understand before changing\n- Preview before applying (ast_grep dryRun=true)\n- Verify after every change\n- Follow existing codebase patterns\n- Keep beads issues updated in real-time\n- Commit at logical checkpoints\n- Report issues immediately\n\n## ABORT CONDITIONS\nIf any of these occur, **STOP and consult user**:\n- Test coverage is zero for target code\n- Changes would break public API\n- Refactoring scope is unclear\n- 3 consecutive verification failures\n- User-defined constraints violated\n\n---\n\n# Tool Usage Philosophy\n\nYou already know these tools. Use them intelligently:\n\n## LSP Tools\nLeverage LSP tools for precision analysis. Key patterns:\n- **Understand before changing**: `LspGotoDefinition` to grasp context\n- **Impact analysis**: `LspFindReferences` to map all usages before modification\n- **Safe refactoring**: `lsp_prepare_rename` \u2192 `lsp_rename` for symbol renames\n- **Continuous verification**: `lsp_diagnostics` after every change\n\n## AST-Grep\nUse `ast_grep_search` and `ast_grep_replace` for structural transformations.\n**Critical**: Always `dryRun=true` first, review, then execute.\n\n## Agents\n- `explore`: Parallel codebase pattern discovery\n- `oracle`: Architectural decisions, complex debugging, and refactoring decomposition\n- `librarian`: **Use proactively** when encountering deprecated methods or library migration tasks. Query official docs and OSS examples for modern replacements.\n\n## Deprecated Code & Library Migration\nWhen you encounter deprecated methods/APIs during refactoring:\n1. Fire `librarian` to find the recommended modern alternative\n2. **DO NOT auto-upgrade to latest version** unless user explicitly requests migration\n3. If user requests library migration, use `librarian` to fetch latest API docs before making changes\n\n---\n\n**Remember: Refactoring without tests is reckless. Refactoring without understanding is destructive. This command ensures you do neither.**\n\n<user-request>\n$ARGUMENTS\n</user-request>\n";

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -0,0 +1 @@
+export declare const START_WORK_TEMPLATE = "You are starting a beads-driven work session.\n\n## WHAT TO DO\n\n1. **Check for in-progress issues**: Run `bd list --status=in_progress --json` to find work already claimed\n\n2. **Find available work**: Run `bd ready --json` to list issues with no blockers\n\n3. **Decision logic**:\n   - If there are in-progress issues:\n     - Resume work on the first in-progress issue\n   - If no in-progress issues but ready issues exist:\n     - If ONE ready issue: auto-select it\n     - If MULTIPLE ready issues: show list with priorities, ask user to select\n   - If no ready issues:\n     - Check `bd blocked --json` for blocked work\n     - Report status and ask user what to create or unblock\n\n4. **Claim work**: Run `bd update <id> --status=in_progress` to claim the selected issue\n\n5. **Read issue details** with `bd show <id> --json` and start executing the work\n\n## OUTPUT FORMAT\n\nWhen listing issues for selection:\n```\nAvailable Work (beads ready)\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [{issue-id}] P{priority} - {title}\n2. [{issue-id}] P{priority} - {title}\n\nWhich issue would you like to work on? (Enter number or issue ID)\n```\n\nWhen resuming in-progress work:\n```\nResuming Work Session\n\nActive Issue: [{issue-id}] {title}\nPriority: P{priority}\nStatus: in_progress\n\nReading issue details and continuing work...\n```\n\nWhen auto-selecting single issue:\n```\nStarting Work Session\n\nIssue: [{issue-id}] {title}\nSession ID: {session_id}\nStarted: {timestamp}\n\nClaiming issue and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always claim the issue with `bd update` BEFORE starting work\n- Read the FULL issue details with `bd show` before beginning\n- Close issues with `bd close <id>` when work is complete";

package/dist/features/builtin-commands/templates/stop-continuation.d.ts

@@ -0,0 +1 @@
+export declare const STOP_CONTINUATION_TEMPLATE = "Stop all continuation mechanisms for the current session.\n\nThis command will:\n1. Stop the beads-continuation-enforcer from automatically continuing incomplete issues\n2. Cancel any active Ralph Loop\n3. Clear the active beads work state for the current project\n\nAfter running this command:\n- The session will not auto-continue when idle\n- You can manually continue work when ready\n- The stop state is per-session and clears when the session ends\n\nUse this when you need to pause automated continuation and take manual control.";

package/dist/features/builtin-commands/types.d.ts

@@ -0,0 +1,6 @@
+import type { CommandDefinition } from "../claude-code-command-loader";
+export type BuiltinCommandName = "init-deep" | "ralph-loop" | "cancel-ralph" | "ulw-loop" | "refactor" | "start-work" | "stop-continuation" | "handoff";
+export interface BuiltinCommandConfig {
+    disabled_commands?: BuiltinCommandName[];
+}
+export type BuiltinCommands = Record<string, CommandDefinition>;

package/dist/features/builtin-skills/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { createBuiltinSkills, type CreateBuiltinSkillsOptions } from "./skills";

package/dist/features/builtin-skills/skills/dev-browser.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinSkill } from "../types";
+export declare const devBrowserSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/frontend-ui-ux.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinSkill } from "../types";
+export declare const frontendUiUxSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/git-master-skill-metadata.d.ts

@@ -0,0 +1,2 @@
+export declare const GIT_MASTER_SKILL_NAME = "git-master";
+export declare const GIT_MASTER_SKILL_DESCRIPTION = "MUST USE for ANY git operations. Atomic commits, rebase/squash, history search (blame, bisect, log -S). STRONGLY RECOMMENDED: Use with task(category='quick', load_skills=['git-master'], ...) to save context. Triggers: 'commit', 'rebase', 'squash', 'who wrote', 'when was X added', 'find the commit that'.";

package/dist/features/builtin-skills/skills/git-master.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinSkill } from "../types";
+export declare const gitMasterSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills/index.d.ts

@@ -0,0 +1,4 @@
+export { playwrightSkill, agentBrowserSkill } from "./playwright";
+export { frontendUiUxSkill } from "./frontend-ui-ux";
+export { gitMasterSkill } from "./git-master";
+export { devBrowserSkill } from "./dev-browser";

package/dist/features/builtin-skills/skills/playwright.d.ts

@@ -0,0 +1,3 @@
+import type { BuiltinSkill } from "../types";
+export declare const playwrightSkill: BuiltinSkill;
+export declare const agentBrowserSkill: BuiltinSkill;

package/dist/features/builtin-skills/skills.d.ts

@@ -0,0 +1,7 @@
+import type { BuiltinSkill } from "./types";
+import type { BrowserAutomationProvider } from "../../config/schema";
+export interface CreateBuiltinSkillsOptions {
+    browserProvider?: BrowserAutomationProvider;
+    disabledSkills?: Set<string>;
+}
+export declare function createBuiltinSkills(options?: CreateBuiltinSkillsOptions): BuiltinSkill[];

package/dist/features/builtin-skills/types.d.ts

@@ -0,0 +1,15 @@
+import type { SkillMcpConfig } from "../skill-mcp-manager/types";
+export interface BuiltinSkill {
+    name: string;
+    description: string;
+    template: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, unknown>;
+    allowedTools?: string[];
+    agent?: string;
+    model?: string;
+    subtask?: boolean;
+    argumentHint?: string;
+    mcpConfig?: SkillMcpConfig;
+}

package/dist/features/claude-code-agent-loader/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./loader";

package/dist/features/claude-code-agent-loader/loader.d.ts

@@ -0,0 +1,3 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export declare function loadUserAgents(): Record<string, AgentConfig>;
+export declare function loadProjectAgents(directory?: string): Record<string, AgentConfig>;

package/dist/features/claude-code-agent-loader/types.d.ts

@@ -0,0 +1,14 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+export type AgentScope = "user" | "project";
+export interface AgentFrontmatter {
+    name?: string;
+    description?: string;
+    model?: string;
+    tools?: string;
+}
+export interface LoadedAgent {
+    name: string;
+    path: string;
+    config: AgentConfig;
+    scope: AgentScope;
+}

package/dist/features/claude-code-command-loader/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./loader";

package/dist/features/claude-code-command-loader/loader.d.ts

@@ -0,0 +1,6 @@
+import type { CommandDefinition } from "./types";
+export declare function loadUserCommands(): Promise<Record<string, CommandDefinition>>;
+export declare function loadProjectCommands(directory?: string): Promise<Record<string, CommandDefinition>>;
+export declare function loadOpencodeGlobalCommands(): Promise<Record<string, CommandDefinition>>;
+export declare function loadOpencodeProjectCommands(directory?: string): Promise<Record<string, CommandDefinition>>;
+export declare function loadAllCommands(directory?: string): Promise<Record<string, CommandDefinition>>;

package/dist/features/claude-code-command-loader/types.d.ts

@@ -0,0 +1,42 @@
+export type CommandScope = "user" | "project" | "opencode" | "opencode-project";
+/**
+ * Handoff definition for command workflows.
+ * Based on speckit's handoff pattern for multi-agent orchestration.
+ * @see https://github.com/github/spec-kit
+ */
+export interface HandoffDefinition {
+    /** Human-readable label for the handoff action */
+    label: string;
+    /** Target agent/command identifier (e.g., "speckit.tasks") */
+    agent: string;
+    /** Pre-filled prompt text for the handoff */
+    prompt: string;
+    /** If true, automatically executes after command completion; if false, shows as suggestion */
+    send?: boolean;
+}
+export interface CommandDefinition {
+    name: string;
+    description?: string;
+    template: string;
+    agent?: string;
+    model?: string;
+    subtask?: boolean;
+    argumentHint?: string;
+    /** Handoff definitions for workflow transitions */
+    handoffs?: HandoffDefinition[];
+}
+export interface CommandFrontmatter {
+    description?: string;
+    "argument-hint"?: string;
+    agent?: string;
+    model?: string;
+    subtask?: boolean;
+    /** Handoff definitions for workflow transitions */
+    handoffs?: HandoffDefinition[];
+}
+export interface LoadedCommand {
+    name: string;
+    path: string;
+    definition: CommandDefinition;
+    scope: CommandScope;
+}

package/dist/features/claude-code-mcp-loader/env-expander.d.ts

@@ -0,0 +1,2 @@
+export declare function expandEnvVars(value: string): string;
+export declare function expandEnvVarsInObject<T>(obj: T): T;

package/dist/features/claude-code-mcp-loader/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Configuration Loader
+ *
+ * Loads Claude Code .mcp.json format configurations from multiple scopes
+ * and transforms them to OpenCode SDK format
+ */
+export * from "./types";
+export * from "./loader";
+export * from "./transformer";
+export * from "./env-expander";

package/dist/features/claude-code-mcp-loader/loader.d.ts

@@ -0,0 +1,4 @@
+import type { LoadedMcpServer, McpLoadResult } from "./types";
+export declare function getSystemMcpServerNames(): Set<string>;
+export declare function loadMcpConfigs(): Promise<McpLoadResult>;
+export declare function formatLoadedServersForToast(loadedServers: LoadedMcpServer[]): string;

package/dist/features/claude-code-mcp-loader/transformer.d.ts

@@ -0,0 +1,2 @@
+import type { ClaudeCodeMcpServer, McpServerConfig } from "./types";
+export declare function transformMcpServer(name: string, server: ClaudeCodeMcpServer): McpServerConfig;

package/dist/features/claude-code-mcp-loader/types.d.ts

@@ -0,0 +1,39 @@
+export type McpScope = "user" | "project" | "local";
+export interface ClaudeCodeMcpServer {
+    type?: "http" | "sse" | "stdio";
+    url?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+    oauth?: {
+        clientId?: string;
+        scopes?: string[];
+    };
+    disabled?: boolean;
+}
+export interface ClaudeCodeMcpConfig {
+    mcpServers?: Record<string, ClaudeCodeMcpServer>;
+}
+export interface McpLocalConfig {
+    type: "local";
+    command: string[];
+    environment?: Record<string, string>;
+    enabled?: boolean;
+}
+export interface McpRemoteConfig {
+    type: "remote";
+    url: string;
+    headers?: Record<string, string>;
+    enabled?: boolean;
+}
+export type McpServerConfig = McpLocalConfig | McpRemoteConfig;
+export interface LoadedMcpServer {
+    name: string;
+    scope: McpScope;
+    config: McpServerConfig;
+}
+export interface McpLoadResult {
+    servers: Record<string, McpServerConfig>;
+    loadedServers: LoadedMcpServer[];
+}

package/dist/features/claude-code-plugin-loader/agent-loader.d.ts

@@ -0,0 +1,3 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { LoadedPlugin } from "./types";
+export declare function loadPluginAgents(plugins: LoadedPlugin[]): Record<string, AgentConfig>;

package/dist/features/claude-code-plugin-loader/command-loader.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from "../claude-code-command-loader/types";
+import type { LoadedPlugin } from "./types";
+export declare function loadPluginCommands(plugins: LoadedPlugin[]): Record<string, CommandDefinition>;

package/dist/features/claude-code-plugin-loader/discovery.d.ts

@@ -0,0 +1,2 @@
+import type { PluginLoadResult, PluginLoaderOptions } from "./types";
+export declare function discoverInstalledPlugins(options?: PluginLoaderOptions): PluginLoadResult;

package/dist/features/claude-code-plugin-loader/hook-loader.d.ts

@@ -0,0 +1,2 @@
+import type { HooksConfig, LoadedPlugin } from "./types";
+export declare function loadPluginHooksConfigs(plugins: LoadedPlugin[]): HooksConfig[];

package/dist/features/claude-code-plugin-loader/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./types";
+export * from "./loader";
+export * from "./discovery";
+export * from "./plugin-path-resolver";
+export * from "./command-loader";
+export * from "./skill-loader";
+export * from "./agent-loader";
+export * from "./mcp-server-loader";
+export * from "./hook-loader";
+export type { PluginLoaderOptions, ClaudeSettings } from "./types";

package/dist/features/claude-code-plugin-loader/loader.d.ts

@@ -0,0 +1,20 @@
+import type { AgentConfig } from "@opencode-ai/sdk";
+import type { CommandDefinition } from "../claude-code-command-loader/types";
+import type { McpServerConfig } from "../claude-code-mcp-loader/types";
+import type { HooksConfig, LoadedPlugin, PluginLoadError, PluginLoaderOptions } from "./types";
+export { discoverInstalledPlugins } from "./discovery";
+export { loadPluginCommands } from "./command-loader";
+export { loadPluginSkillsAsCommands } from "./skill-loader";
+export { loadPluginAgents } from "./agent-loader";
+export { loadPluginMcpServers } from "./mcp-server-loader";
+export { loadPluginHooksConfigs } from "./hook-loader";
+export interface PluginComponentsResult {
+    commands: Record<string, CommandDefinition>;
+    skills: Record<string, CommandDefinition>;
+    agents: Record<string, AgentConfig>;
+    mcpServers: Record<string, McpServerConfig>;
+    hooksConfigs: HooksConfig[];
+    plugins: LoadedPlugin[];
+    errors: PluginLoadError[];
+}
+export declare function loadAllPluginComponents(options?: PluginLoaderOptions): Promise<PluginComponentsResult>;

package/dist/features/claude-code-plugin-loader/mcp-server-loader.d.ts

@@ -0,0 +1,3 @@
+import type { McpServerConfig } from "../claude-code-mcp-loader/types";
+import type { LoadedPlugin } from "./types";
+export declare function loadPluginMcpServers(plugins: LoadedPlugin[]): Promise<Record<string, McpServerConfig>>;

package/dist/features/claude-code-plugin-loader/plugin-path-resolver.d.ts

@@ -0,0 +1,2 @@
+export declare function resolvePluginPath(path: string, pluginRoot: string): string;
+export declare function resolvePluginPaths<T>(obj: T, pluginRoot: string): T;

package/dist/features/claude-code-plugin-loader/skill-loader.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from "../claude-code-command-loader/types";
+import type { LoadedPlugin } from "./types";
+export declare function loadPluginSkillsAsCommands(plugins: LoadedPlugin[]): Record<string, CommandDefinition>;

package/dist/features/claude-code-plugin-loader/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Claude Code Plugin Types
+ *
+ * Type definitions for Claude Code plugin system compatibility.
+ * Based on https://code.claude.com/docs/en/plugins-reference
+ */
+export type PluginScope = "user" | "project" | "local" | "managed";
+/**
+ * Plugin installation entry in installed_plugins.json
+ */
+export interface PluginInstallation {
+    scope: PluginScope;
+    installPath: string;
+    version: string;
+    installedAt: string;
+    lastUpdated: string;
+    gitCommitSha?: string;
+    isLocal?: boolean;
+}
+/**
+ * Installed plugins database v1 (legacy)
+ * plugins stored as direct objects
+ */
+export interface InstalledPluginsDatabaseV1 {
+    version: 1;
+    plugins: Record<string, PluginInstallation>;
+}
+/**
+ * Installed plugins database v2 (current)
+ * plugins stored as arrays
+ */
+export interface InstalledPluginsDatabaseV2 {
+    version: 2;
+    plugins: Record<string, PluginInstallation[]>;
+}
+/**
+ * Installed plugins database structure
+ * Located at ~/.claude/plugins/installed_plugins.json
+ */
+export type InstalledPluginsDatabase = InstalledPluginsDatabaseV1 | InstalledPluginsDatabaseV2;
+/**
+ * Plugin author information
+ */
+export interface PluginAuthor {
+    name?: string;
+    email?: string;
+    url?: string;
+}
+/**
+ * Plugin manifest (plugin.json)
+ * Located at <plugin_root>/.claude-plugin/plugin.json
+ */
+export interface PluginManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    author?: PluginAuthor;
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+    commands?: string | string[];
+    agents?: string | string[];
+    skills?: string | string[];
+    hooks?: string | HooksConfig;
+    mcpServers?: string | McpServersConfig;
+    lspServers?: string | LspServersConfig;
+    outputStyles?: string | string[];
+}
+/**
+ * Hooks configuration
+ */
+export interface HookEntry {
+    type: "command" | "prompt" | "agent";
+    command?: string;
+    prompt?: string;
+    agent?: string;
+}
+export interface HookMatcher {
+    matcher?: string;
+    hooks: HookEntry[];
+}
+export interface HooksConfig {
+    hooks?: {
+        PreToolUse?: HookMatcher[];
+        PostToolUse?: HookMatcher[];
+        PostToolUseFailure?: HookMatcher[];
+        PermissionRequest?: HookMatcher[];
+        UserPromptSubmit?: HookMatcher[];
+        Notification?: HookMatcher[];
+        Stop?: HookMatcher[];
+        SubagentStart?: HookMatcher[];
+        SubagentStop?: HookMatcher[];
+        SessionStart?: HookMatcher[];
+        SessionEnd?: HookMatcher[];
+        PreCompact?: HookMatcher[];
+    };
+}
+/**
+ * MCP servers configuration in plugin
+ */
+export interface PluginMcpServer {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    type?: "stdio" | "http" | "sse";
+    disabled?: boolean;
+}
+export interface McpServersConfig {
+    mcpServers?: Record<string, PluginMcpServer>;
+}
+/**
+ * LSP server configuration
+ */
+export interface LspServerConfig {
+    command: string;
+    args?: string[];
+    extensionToLanguage: Record<string, string>;
+    transport?: "stdio" | "socket";
+    env?: Record<string, string>;
+    initializationOptions?: Record<string, unknown>;
+    settings?: Record<string, unknown>;
+    workspaceFolder?: string;
+    startupTimeout?: number;
+    shutdownTimeout?: number;
+    restartOnCrash?: boolean;
+    maxRestarts?: number;
+    loggingConfig?: {
+        args?: string[];
+        env?: Record<string, string>;
+    };
+}
+export interface LspServersConfig {
+    [language: string]: LspServerConfig;
+}
+/**
+ * Loaded plugin with all resolved components
+ */
+export interface LoadedPlugin {
+    name: string;
+    version: string;
+    scope: PluginScope;
+    installPath: string;
+    manifest?: PluginManifest;
+    pluginKey: string;
+    commandsDir?: string;
+    agentsDir?: string;
+    skillsDir?: string;
+    hooksPath?: string;
+    mcpPath?: string;
+    lspPath?: string;
+}
+/**
+ * Plugin load result with all components
+ */
+export interface PluginLoadResult {
+    plugins: LoadedPlugin[];
+    errors: PluginLoadError[];
+}
+export interface PluginLoadError {
+    pluginKey: string;
+    installPath: string;
+    error: string;
+}
+/**
+ * Claude settings from ~/.claude/settings.json
+ */
+export interface ClaudeSettings {
+    enabledPlugins?: Record<string, boolean>;
+    [key: string]: unknown;
+}
+/**
+ * Plugin loader options
+ */
+export interface PluginLoaderOptions {
+    /**
+     * Override enabled plugins from oh-my-opencode config.
+     * Key format: "pluginName@marketplace" (e.g., "shell-scripting@claude-code-workflows")
+     * Value: true = enabled, false = disabled
+     *
+     * This takes precedence over ~/.claude/settings.json enabledPlugins
+     */
+    enabledPluginsOverride?: Record<string, boolean>;
+}

package/dist/features/claude-code-session-state/index.d.ts

@@ -0,0 +1 @@
+export * from "./state";

package/dist/features/claude-code-session-state/state.d.ts

@@ -0,0 +1,9 @@
+export declare const subagentSessions: Set<string>;
+export declare function setMainSession(id: string | undefined): void;
+export declare function getMainSessionID(): string | undefined;
+/** @internal For testing only */
+export declare function _resetForTesting(): void;
+export declare function setSessionAgent(sessionID: string, agent: string): void;
+export declare function updateSessionAgent(sessionID: string, agent: string): void;
+export declare function getSessionAgent(sessionID: string): string | undefined;
+export declare function clearSessionAgent(sessionID: string): void;

package/dist/features/claude-tasks/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./storage";
+export * from "./session-storage";

package/dist/features/claude-tasks/session-storage.d.ts

@@ -0,0 +1,9 @@
+import type { OhMyOpenCodeConfig } from "../../config/schema";
+export declare function getSessionTaskDir(config: Partial<OhMyOpenCodeConfig>, sessionID: string): string;
+export declare function listSessionTaskFiles(config: Partial<OhMyOpenCodeConfig>, sessionID: string): string[];
+export declare function listAllSessionDirs(config: Partial<OhMyOpenCodeConfig>): string[];
+export interface TaskLocation {
+    path: string;
+    sessionID: string;
+}
+export declare function findTaskAcrossSessions(config: Partial<OhMyOpenCodeConfig>, taskId: string): TaskLocation | null;

package/dist/features/claude-tasks/storage.d.ts

@@ -0,0 +1,14 @@
+import type { z } from "zod";
+import type { OhMyOpenCodeConfig } from "../../config/schema";
+export declare function getTaskDir(config?: Partial<OhMyOpenCodeConfig>): string;
+export declare function sanitizePathSegment(value: string): string;
+export declare function resolveTaskListId(config?: Partial<OhMyOpenCodeConfig>): string;
+export declare function ensureDir(dirPath: string): void;
+export declare function readJsonSafe<T>(filePath: string, schema: z.ZodType<T>): T | null;
+export declare function writeJsonAtomic(filePath: string, data: unknown): void;
+export declare function generateTaskId(): string;
+export declare function listTaskFiles(config?: Partial<OhMyOpenCodeConfig>): string[];
+export declare function acquireLock(dirPath: string): {
+    acquired: boolean;
+    release: () => void;
+};

package/dist/features/claude-tasks/types.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const TaskStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    in_progress: "in_progress";
+    completed: "completed";
+    deleted: "deleted";
+}>;
+export type TaskStatus = z.infer<typeof TaskStatusSchema>;
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    subject: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodEnum<{
+        pending: "pending";
+        in_progress: "in_progress";
+        completed: "completed";
+        deleted: "deleted";
+    }>;
+    activeForm: z.ZodOptional<z.ZodString>;
+    blocks: z.ZodArray<z.ZodString>;
+    blockedBy: z.ZodArray<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+export type Task = z.infer<typeof TaskSchema>;

package/dist/features/context-injector/collector.d.ts

@@ -0,0 +1,11 @@
+import type { PendingContext, RegisterContextOptions } from "./types";
+export declare class ContextCollector {
+    private sessions;
+    register(sessionID: string, options: RegisterContextOptions): void;
+    getPending(sessionID: string): PendingContext;
+    consume(sessionID: string): PendingContext;
+    clear(sessionID: string): void;
+    hasPending(sessionID: string): boolean;
+    private sortEntries;
+}
+export declare const contextCollector: ContextCollector;

package/dist/features/context-injector/index.d.ts

@@ -0,0 +1,3 @@
+export { ContextCollector, contextCollector } from "./collector";
+export { createContextInjectorMessagesTransformHook, } from "./injector";
+export type { ContextSourceType, ContextPriority, ContextEntry, RegisterContextOptions, PendingContext, MessageContext, OutputParts, InjectionStrategy, } from "./types";