opencode-hive 0.8.2 → 0.9.0

package/dist/skills/builtin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Builtin Skills for Hive
+ *
+ * Following OMO-Slim pattern - skills are loaded from generated registry.
+ * This file provides the infrastructure to load builtin skills.
+ */
+import type { SkillDefinition, SkillLoadResult } from './types.js';
+import { BUILTIN_SKILL_NAMES, BUILTIN_SKILLS } from './registry.generated.js';
+export { BUILTIN_SKILL_NAMES, BUILTIN_SKILLS };
+/**
+ * Type for builtin skill names.
+ */
+export type BuiltinSkillName = typeof BUILTIN_SKILL_NAMES[number];
+/**
+ * Load a builtin skill by name.
+ */
+export declare function loadBuiltinSkill(name: string): SkillLoadResult;
+/**
+ * Get all builtin skills.
+ */
+export declare function getBuiltinSkills(): SkillDefinition[];
+/**
+ * Get skill metadata for tool description (XML format).
+ * Uses (hive - Skill) prefix for consistency with formatSkillsXml in index.ts.
+ */
+export declare function getBuiltinSkillsXml(): string;

package/dist/skills/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hive Skills System
+ *
+ * Export skill infrastructure for use in hive_skill tool.
+ */
+export type { SkillDefinition, SkillLoadResult } from './types.js';
+export { BUILTIN_SKILLS, loadBuiltinSkill, getBuiltinSkills, getBuiltinSkillsXml, type BuiltinSkillName } from './builtin.js';

package/dist/skills/registry.generated.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ * Generated by: scripts/generate-skills.ts
+ * Run: bun run scripts/generate-skills.ts
+ */
+import type { SkillDefinition } from './types.js';
+/**
+ * List of builtin skill names.
+ */
+export declare const BUILTIN_SKILL_NAMES: readonly ["hive", "hive-execution"];
+/**
+ * All builtin skill definitions.
+ */
+export declare const BUILTIN_SKILLS: SkillDefinition[];

package/dist/skills/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hive Skill System Types
+ *
+ * Following OMO-Slim pattern for skill definitions.
+ */
+/**
+ * Definition of a skill that can be loaded by agents.
+ */
+export interface SkillDefinition {
+    /** Unique identifier for the skill */
+    name: string;
+    /** Brief description shown in available_skills list */
+    description: string;
+    /** Markdown content with detailed instructions */
+    template: string;
+}
+/**
+ * Result returned when loading a skill.
+ */
+export interface SkillLoadResult {
+    /** Whether the skill was found */
+    found: boolean;
+    /** The loaded skill definition if found */
+    skill?: SkillDefinition;
+    /** Error message if not found */
+    error?: string;
+    /** Source of the skill (builtin or file path) */
+    source?: 'builtin' | string;
+}

package/dist/utils/agent-selector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Agent selection for OMO-Slim delegation.
+ * Maps task content patterns to specialized agent types.
+ *
+ * Available agents in OMO-Slim config:
+ * - orchestrator: Main orchestrator (not for delegation)
+ * - oracle: Architecture decisions, complex debugging, code review
+ * - librarian: External docs, library research, GitHub examples
+ * - explorer: Fast codebase search, pattern matching
+ * - designer: UI/UX, styling, component architecture
+ * - fixer: Fast implementation, receives context and executes
+ */
+export type OmoSlimAgent = 'fixer' | 'explorer' | 'librarian' | 'oracle' | 'designer';
+/**
+ * Select the best OMO-Slim agent for a task based on content analysis.
+ *
+ * @param taskName - The task name/title
+ * @param spec - The task specification/description
+ * @returns The selected agent type
+ */
+export declare function selectAgent(taskName: string, spec: string): OmoSlimAgent;
+/**
+ * Get a human-readable description of an agent's purpose.
+ */
+export declare function getAgentDescription(agent: OmoSlimAgent): string;
+/**
+ * Get all available agent types.
+ */
+export declare function getAvailableAgents(): OmoSlimAgent[];

package/dist/utils/worker-prompt.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Worker prompt builder for Hive delegated execution.
+ * Builds context-rich prompts for worker agents with all Hive context.
+ */
+export interface ContextFile {
+    name: string;
+    content: string;
+}
+export interface CompletedTask {
+    name: string;
+    summary: string;
+}
+export interface ContinueFromBlocked {
+    status: 'blocked';
+    previousSummary: string;
+    decision: string;
+}
+export interface WorkerPromptParams {
+    feature: string;
+    task: string;
+    taskOrder: number;
+    worktreePath: string;
+    branch: string;
+    plan: string;
+    contextFiles: ContextFile[];
+    spec: string;
+    previousTasks?: CompletedTask[];
+    continueFrom?: ContinueFromBlocked;
+}
+/**
+ * Build a context-rich prompt for a worker agent.
+ *
+ * Includes:
+ * - Assignment details (feature, task, worktree, branch)
+ * - Plan context
+ * - Context files (royal jelly)
+ * - Previous task summaries
+ * - Mission (spec)
+ * - Blocker protocol (NOT question tool)
+ * - Completion protocol
+ */
+export declare function buildWorkerPrompt(params: WorkerPromptParams): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-hive",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "type": "module",
   "description": "OpenCode plugin for Agent Hive - from vibe coding to hive coding",
   "license": "MIT WITH Commons-Clause",
@@ -27,7 +27,8 @@
   "types": "./dist/index.d.ts",
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && bun build src/index.ts --outdir dist --target node --format esm --packages=bundle && tsc --emitDeclarationOnly",
+    "generate-skills": "bun run scripts/generate-skills.ts",
+    "build": "npm run clean && npm run generate-skills && bun build src/index.ts --outdir dist --target node --format esm --packages=bundle && tsc --emitDeclarationOnly",
     "dev": "opencode plugin dev",
     "test": "bun test"
   },
@@ -45,5 +46,9 @@
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0"
   },
-  "files": ["dist/", "README.md"]
+  "files": [
+    "dist/",
+    "skills/",
+    "README.md"
+  ]
 }

package/skills/hive-execution/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: hive-execution
+description: Execute Hive feature tasks with worktree isolation, parallel orchestration, and clean git history. Use when running synced Hive tasks.
+---
+
+# Hive Execution
+
+Quick reference for executing Hive tasks.
+
+## Workflow Summary
+
+1. **Feature create** → Discovery guide injected
+2. **Discovery** → Q&A documented in plan.md
+3. **Plan write** → GATE: requires ## Discovery section
+4. **Approval** → User reviews in VS Code
+5. **Exec start** → Delegation guide (Master), TDD+debugging (Worker)
+6. **Complete** → GATE: requires verification mention
+7. **Merge** → Squash into feature branch
+
+## Gates
+
+| Tool | Gate | Error |
+|------|------|-------|
+| hive_plan_write | ## Discovery section | "BLOCKED: Discovery required" |
+| hive_exec_complete | Verification in summary | "BLOCKED: No verification" |
+
+## Task Lifecycle
+
+```
+hive_exec_start(task)      # Creates worktree
+  ↓
+[implement in worktree]
+  ↓
+hive_exec_complete(task, summary)  # Commits to branch
+  ↓
+hive_merge(task, strategy: "squash")  # Integrates to main
+```
+
+## Quick Reference
+
+| Tool | Purpose |
+|------|---------|
+| hive_status | Check overall progress |
+| hive_worker_status | Check delegated workers |
+| hive_exec_abort | Discard changes, restart |
+| hive_merge | Integrate completed task |
+| hive_worktree_list | See active worktrees |
+
+## Error Recovery
+
+### Task Failed
+```
+hive_exec_abort(task)  # Discards changes
+hive_exec_start(task)  # Fresh start
+```
+
+### Merge Conflicts
+1. Resolve conflicts in worktree
+2. Commit resolution
+3. Run hive_merge again