opencode-hive 1.3.1 → 1.3.2

package/dist/hive-core/src/types.d.ts

@@ -0,0 +1,221 @@
+export type FeatureStatusType = 'planning' | 'approved' | 'executing' | 'completed';
+export interface FeatureJson {
+    name: string;
+    status: FeatureStatusType;
+    ticket?: string;
+    sessionId?: string;
+    createdAt: string;
+    approvedAt?: string;
+    completedAt?: string;
+}
+export interface FeatureDirectoryInfo {
+    directoryName: string;
+    logicalName: string;
+    index: number | null;
+}
+export type TaskStatusType = 'pending' | 'in_progress' | 'done' | 'cancelled' | 'blocked' | 'failed' | 'partial';
+export type TaskOrigin = 'plan' | 'manual';
+export type SubtaskType = 'test' | 'implement' | 'review' | 'verify' | 'research' | 'debug' | 'custom';
+export interface Subtask {
+    id: string;
+    name: string;
+    folder: string;
+    status: TaskStatusType;
+    type?: SubtaskType;
+    createdAt?: string;
+    completedAt?: string;
+}
+export interface SubtaskStatus {
+    status: TaskStatusType;
+    type?: SubtaskType;
+    createdAt: string;
+    completedAt?: string;
+}
+/** Worker session information for background task execution */
+export interface WorkerSession {
+    /** Background task ID from OMO-Slim */
+    taskId?: string;
+    /** Unique session identifier */
+    sessionId: string;
+    /** Worker instance identifier */
+    workerId?: string;
+    /** Agent type handling this task */
+    agent?: string;
+    /** Execution mode: inline (same session) or delegate (background) */
+    mode?: 'inline' | 'delegate';
+    /** ISO timestamp of last heartbeat */
+    lastHeartbeatAt?: string;
+    /** Current attempt number (1-based) */
+    attempt?: number;
+    /** Number of messages exchanged in session */
+    messageCount?: number;
+}
+export interface TaskStatus {
+    /** Schema version for forward compatibility (default: 1) */
+    schemaVersion?: number;
+    status: TaskStatusType;
+    origin: TaskOrigin;
+    planTitle?: string;
+    summary?: string;
+    startedAt?: string;
+    completedAt?: string;
+    baseCommit?: string;
+    subtasks?: Subtask[];
+    /** Idempotency key for safe retries */
+    idempotencyKey?: string;
+    /** Worker session info for background execution */
+    workerSession?: WorkerSession;
+    /**
+     * Task dependencies expressed as task folder names (e.g., '01-setup', '02-core-api').
+     * A task cannot start until all its dependencies have status 'done'.
+     * Resolved from plan.md dependency annotations during hive_tasks_sync.
+     */
+    dependsOn?: string[];
+}
+export type ReviewDocument = 'plan' | 'overview';
+export interface ReviewThread {
+    id: string;
+    line: number;
+    body: string;
+    replies: string[];
+}
+export interface CommentsJson {
+    threads: ReviewThread[];
+}
+export interface ReviewCounts {
+    plan: number;
+    overview: number;
+}
+export type PlanComment = ReviewThread;
+export interface PlanReadResult {
+    content: string;
+    status: FeatureStatusType;
+    comments: ReviewThread[];
+}
+export interface TasksSyncResult {
+    created: string[];
+    removed: string[];
+    kept: string[];
+    manual: string[];
+}
+export interface TaskInfo {
+    folder: string;
+    name: string;
+    status: TaskStatusType;
+    origin: TaskOrigin;
+    planTitle?: string;
+    summary?: string;
+}
+export interface FeatureInfo {
+    name: string;
+    status: FeatureStatusType;
+    tasks: TaskInfo[];
+    hasPlan: boolean;
+    hasOverview: boolean;
+    commentCount: number;
+    reviewCounts: ReviewCounts;
+}
+export interface ContextFile {
+    name: string;
+    content: string;
+    updatedAt: string;
+}
+export interface SessionInfo {
+    sessionId: string;
+    taskFolder?: string;
+    startedAt: string;
+    lastActiveAt: string;
+    messageCount?: number;
+}
+export interface SessionsJson {
+    master?: string;
+    sessions: SessionInfo[];
+}
+export interface TaskSpec {
+    taskFolder: string;
+    featureName: string;
+    planSection: string;
+    context: string;
+    priorTasks: Array<{
+        folder: string;
+        summary?: string;
+    }>;
+}
+/** Agent model/temperature configuration */
+export interface AgentModelConfig {
+    /** Model to use - format: "provider/model-id" (e.g., 'anthropic/claude-sonnet-4-20250514') */
+    model?: string;
+    /** Temperature for generation (0-2) */
+    temperature?: number;
+    /** Skills to enable for this agent */
+    skills?: string[];
+    /** Skills to auto-load for this agent */
+    autoLoadSkills?: string[];
+    /** Variant key for model reasoning/effort level (e.g., 'low', 'medium', 'high', 'max') */
+    variant?: string;
+}
+export declare const BUILT_IN_AGENT_NAMES: readonly ["hive-master", "architect-planner", "swarm-orchestrator", "scout-researcher", "forager-worker", "hygienic-reviewer"];
+export type BuiltInAgentName = (typeof BUILT_IN_AGENT_NAMES)[number];
+export declare const CUSTOM_AGENT_BASES: readonly ["forager-worker", "hygienic-reviewer"];
+export type CustomAgentBase = (typeof CUSTOM_AGENT_BASES)[number];
+export declare const CUSTOM_AGENT_RESERVED_NAMES: readonly ["hive-master", "architect-planner", "swarm-orchestrator", "scout-researcher", "forager-worker", "hygienic-reviewer", "hive", "architect", "swarm", "scout", "forager", "hygienic", "receiver", "build", "plan", "code"];
+export interface CustomAgentConfig {
+    baseAgent: CustomAgentBase;
+    description: string;
+    model?: string;
+    temperature?: number;
+    variant?: string;
+    autoLoadSkills?: string[];
+}
+export interface ResolvedCustomAgentConfig extends AgentModelConfig {
+    baseAgent: CustomAgentBase;
+    description: string;
+}
+export interface HiveConfig {
+    /** Schema reference for config file */
+    $schema?: string;
+    /** Enable hive tools for specific features */
+    enableToolsFor?: string[];
+    /** Globally disable specific skills (won't appear in hive_skill tool) */
+    disableSkills?: string[];
+    /** Globally disable specific MCP servers. Available: websearch, context7, grep_app, ast_grep */
+    disableMcps?: string[];
+    /** Enable OMO-Slim delegation (optional integration) */
+    omoSlimEnabled?: boolean;
+    /** Choose between unified or dedicated agent modes */
+    agentMode?: 'unified' | 'dedicated';
+    /** Agent configuration */
+    agents?: {
+        /** Hive Master (hybrid planner + orchestrator) */
+        'hive-master'?: AgentModelConfig;
+        /** Architect Planner (planning-only) */
+        'architect-planner'?: AgentModelConfig;
+        /** Swarm Orchestrator */
+        'swarm-orchestrator'?: AgentModelConfig;
+        /** Scout Researcher */
+        'scout-researcher'?: AgentModelConfig;
+        /** Forager Worker */
+        'forager-worker'?: AgentModelConfig;
+        /** Hygienic Reviewer */
+        'hygienic-reviewer'?: AgentModelConfig;
+    };
+    customAgents?: Record<string, CustomAgentConfig>;
+    /** Sandbox mode for worker isolation */
+    sandbox?: 'none' | 'docker';
+    /** Docker image to use when sandbox is 'docker' (optional explicit override) */
+    dockerImage?: string;
+    /** Reuse Docker containers per worktree (default: true when sandbox is 'docker') */
+    persistentContainers?: boolean;
+    /** Hook execution cadence (number of turns between hook invocations). Key = hook name, Value = cadence (1 = every turn, 3 = every 3rd turn) */
+    hook_cadence?: Record<string, number>;
+}
+/** Default models for Hive agents */
+export declare const DEFAULT_AGENT_MODELS: {
+    readonly 'hive-master': "github-copilot/claude-opus-4.5";
+    readonly 'architect-planner': "github-copilot/gpt-5.2-codex";
+    readonly 'swarm-orchestrator': "github-copilot/claude-opus-4.5";
+    readonly 'scout-researcher': "zai-coding-plan/glm-4.7";
+    readonly 'forager-worker': "github-copilot/gpt-5.2-codex";
+    readonly 'hygienic-reviewer': "github-copilot/gpt-5.2-codex";
+};
+export declare const DEFAULT_HIVE_CONFIG: HiveConfig;

package/dist/hive-core/src/utils/detection.d.ts

@@ -0,0 +1,14 @@
+import type { FeatureJson } from '../types.js';
+export interface DetectionResult {
+    projectRoot: string;
+    feature: string | null;
+    task: string | null;
+    isWorktree: boolean;
+    mainProjectRoot: string | null;
+}
+export declare function detectContext(cwd: string): DetectionResult;
+export declare function listFeatures(projectRoot: string): string[];
+export declare function getActiveFeatureName(projectRoot: string): string | null;
+export declare function resolveActiveFeatureName(projectRoot: string): string | null;
+export declare function getFeatureData(projectRoot: string, featureName: string): FeatureJson | null;
+export declare function findProjectRoot(startDir: string): string | null;

package/dist/hive-core/src/utils/paths.d.ts

@@ -0,0 +1,105 @@
+import type { FeatureDirectoryInfo, ReviewDocument } from '../types.js';
+export declare function normalizePath(filePath: string): string;
+export declare function getHivePath(projectRoot: string): string;
+export declare function getFeaturesPath(projectRoot: string): string;
+export declare function getActiveFeaturePath(projectRoot: string): string;
+export declare function listFeatureDirectories(projectRoot: string): FeatureDirectoryInfo[];
+export declare function resolveFeatureDirectoryName(projectRoot: string, featureName: string): string;
+export declare function getNextIndexedFeatureDirectoryName(projectRoot: string, featureName: string): string;
+export declare function getFeaturePath(projectRoot: string, featureName: string): string;
+export declare function getPlanPath(projectRoot: string, featureName: string): string;
+export declare function getCommentsPath(projectRoot: string, featureName: string): string;
+export declare function getReviewCommentsPath(projectRoot: string, featureName: string, document: ReviewDocument): string;
+export declare function getFeatureJsonPath(projectRoot: string, featureName: string): string;
+export declare function getContextPath(projectRoot: string, featureName: string): string;
+export declare function getOverviewPath(projectRoot: string, featureName: string): string;
+export declare function getTasksPath(projectRoot: string, featureName: string): string;
+export declare function getTaskPath(projectRoot: string, featureName: string, taskFolder: string): string;
+export declare function getTaskStatusPath(projectRoot: string, featureName: string, taskFolder: string): string;
+export declare function getTaskReportPath(projectRoot: string, featureName: string, taskFolder: string): string;
+export declare function getTaskSpecPath(projectRoot: string, featureName: string, taskFolder: string): string;
+export declare function getApprovedPath(projectRoot: string, featureName: string): string;
+export declare function getSubtasksPath(projectRoot: string, featureName: string, taskFolder: string): string;
+export declare function getSubtaskPath(projectRoot: string, featureName: string, taskFolder: string, subtaskFolder: string): string;
+export declare function getSubtaskStatusPath(projectRoot: string, featureName: string, taskFolder: string, subtaskFolder: string): string;
+export declare function getSubtaskSpecPath(projectRoot: string, featureName: string, taskFolder: string, subtaskFolder: string): string;
+export declare function getSubtaskReportPath(projectRoot: string, featureName: string, taskFolder: string, subtaskFolder: string): string;
+export declare function ensureDir(dirPath: string): void;
+export declare function fileExists(filePath: string): boolean;
+export declare function readJson<T>(filePath: string): T | null;
+export declare function writeJson<T>(filePath: string, data: T): void;
+/** Lock acquisition options */
+export interface LockOptions {
+    /** Maximum time to wait for lock acquisition (ms). Default: 5000 */
+    timeout?: number;
+    /** Time between lock acquisition attempts (ms). Default: 50 */
+    retryInterval?: number;
+    /** Time after which a stale lock is broken (ms). Default: 30000 */
+    staleLockTTL?: number;
+}
+/**
+ * Get the lock file path for a given file
+ */
+export declare function getLockPath(filePath: string): string;
+/**
+ * Acquire an exclusive lock on a file.
+ * Uses exclusive file creation (O_EXCL) for atomic lock acquisition.
+ *
+ * @param filePath - Path to the file to lock
+ * @param options - Lock acquisition options
+ * @returns A release function to call when done
+ * @throws Error if lock cannot be acquired within timeout
+ */
+export declare function acquireLock(filePath: string, options?: LockOptions): Promise<() => void>;
+/**
+ * Synchronous version of acquireLock for simpler use cases
+ */
+export declare function acquireLockSync(filePath: string, options?: LockOptions): () => void;
+/**
+ * Write a file atomically using write-to-temp-then-rename pattern.
+ * This ensures no partial writes are visible to readers.
+ *
+ * @param filePath - Destination file path
+ * @param content - Content to write
+ */
+export declare function writeAtomic(filePath: string, content: string): void;
+/**
+ * Write JSON atomically
+ */
+export declare function writeJsonAtomic<T>(filePath: string, data: T): void;
+/**
+ * Write JSON with exclusive lock (async version).
+ * Ensures only one process writes at a time and writes are atomic.
+ *
+ * @param filePath - Path to JSON file
+ * @param data - Data to write
+ * @param options - Lock options
+ */
+export declare function writeJsonLocked<T>(filePath: string, data: T, options?: LockOptions): Promise<void>;
+/**
+ * Synchronous version of writeJsonLocked
+ */
+export declare function writeJsonLockedSync<T>(filePath: string, data: T, options?: LockOptions): void;
+/**
+ * Deep merge utility that explicitly handles nested objects.
+ * - Arrays are replaced, not merged
+ * - Undefined values in patch are ignored (don't delete existing keys)
+ * - Null values explicitly set to null
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, patch: Partial<T>): T;
+/**
+ * Read-modify-write JSON with lock protection.
+ * Reads current content, applies patch via deep merge, writes atomically.
+ *
+ * @param filePath - Path to JSON file
+ * @param patch - Partial update to merge
+ * @param options - Lock options
+ * @returns The merged result
+ */
+export declare function patchJsonLocked<T extends object>(filePath: string, patch: Partial<T>, options?: LockOptions): Promise<T>;
+/**
+ * Synchronous version of patchJsonLocked
+ */
+export declare function patchJsonLockedSync<T extends object>(filePath: string, patch: Partial<T>, options?: LockOptions): T;
+export declare function readText(filePath: string): string | null;
+export declare function writeText(filePath: string, content: string): void;