@shanesaravia/hive 0.1.0

package/node_modules/@hive/shared/dist/types.d.ts

@@ -0,0 +1,384 @@
+export type SessionStatus = "idle" | "waiting" | "busy";
+/** One entry per live `claude` CLI process, read from ~/.claude/sessions/<pid>.json */
+export interface ClaudeSession {
+    pid: number;
+    sessionId: string;
+    cwd: string;
+    startedAt: number;
+    procStart?: string;
+    version?: string;
+    peerProtocol?: number;
+    kind?: string;
+    entrypoint?: string;
+    messagingSocketPath?: string;
+    name?: string;
+    agent?: string;
+    jobId?: string;
+    status: SessionStatus;
+    updatedAt: number;
+    statusUpdatedAt?: number;
+    waitingFor?: string;
+}
+export interface JobFanEntry {
+    id: string;
+    kind: string;
+    label: string;
+    startedAt: number;
+    doneAt?: number;
+    /** Optional telemetry exposed by newer provider/job records. */
+    updatedAt?: number;
+    tokens?: number;
+    terminationReason?: string;
+}
+export interface JobChild {
+    id: string;
+    href: string;
+    kind: string;
+}
+/** One entry per background job, read from ~/.claude/jobs/<jobId>/state.json */
+export interface ClaudeJob {
+    state: string;
+    detail?: string;
+    tempo?: string;
+    inFlight?: {
+        tasks: number;
+        queued: number;
+        kinds: string[];
+    };
+    fan: JobFanEntry[];
+    tokens?: number;
+    needs?: string;
+    output?: unknown;
+    /**
+     * Hive-augmented (not part of the daemon's state.json): the latest assistant
+     * text from timeline.jsonl. Blocked turns keep only a terse question in
+     * needs/detail — the full conversational reply lives in the timeline.
+     */
+    lastText?: string;
+    children: JobChild[];
+    intent?: string;
+    name?: string;
+    nameSource?: string;
+    sessionId?: string;
+    resumeSessionId?: string;
+    daemonShort?: string;
+    cliVersion?: string;
+    cwd?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    worktreePath?: string;
+    worktreeBranch?: string;
+    originCwd?: string;
+    backend?: string;
+    template?: string;
+}
+export interface MissionMessage {
+    id: string;
+    role: "user" | "assistant";
+    text: string;
+    createdAt: number;
+    jobId: string;
+}
+/** @deprecated Use MissionMessage. */
+export type ThreadMessage = MissionMessage;
+export interface WorkerActivity extends JobFanEntry {
+    jobId: string;
+    jobState: string;
+    jobUpdatedAt?: number;
+}
+export interface MissionSummary {
+    id: string;
+    objective: string;
+    acceptanceCriteria: string[];
+    repository?: string;
+    compactSummary?: string;
+    currentState?: string;
+    lifecycleStatus: MissionLifecycleStatus;
+    mode: MissionMode;
+    budgets?: MissionBudgets;
+    template?: {
+        id: string;
+        name: string;
+        version: number;
+        source: "built-in" | "user" | "repository";
+    };
+    policy?: MissionPolicy;
+    provider?: MissionProvider;
+    model?: string;
+    /** Repositories beyond the working directory this mission also touches; each grants --add-dir access on every turn. */
+    additionalRepositories?: string[];
+}
+export type MissionProvider = "claude" | "codex";
+export interface MissionPolicy {
+    allowedRoots: string[];
+    allowedTools: string[];
+    networkAccess: boolean;
+    commits: boolean;
+    pushes: boolean;
+    pullRequests: boolean;
+    releases: boolean;
+    destructiveActions: boolean;
+}
+export interface MissionBudgets {
+    maxWorkers?: number;
+    maxConcurrentWorkers?: number;
+    maxTokens?: number;
+    maxElapsedMinutes?: number;
+}
+export interface MissionTemplate {
+    id: string;
+    name: string;
+    description: string;
+    version: number;
+    source: "built-in" | "user" | "repository";
+    mode: MissionMode;
+    worktree: boolean;
+    managerInstructions: string;
+    stages: Array<{
+        id: string;
+        title: string;
+        role: WorkerRole;
+        dependsOn?: string[];
+    }>;
+    gates: CompletionGate[];
+    budgets?: MissionBudgets;
+    permissions: {
+        commits: boolean;
+        pushes: boolean;
+        pullRequests: boolean;
+        releases: boolean;
+        destructiveActions: boolean;
+        network: boolean;
+    };
+}
+export type MissionMode = "orchestrated" | "direct";
+export type MissionControlAction = "status_summary" | "plan_revision" | "review" | "test_pass";
+export type TaskControlAction = "retry" | "cancel" | "replace_worker" | "reassign" | "priority";
+export interface ClaudeSkillSummary {
+    name: string;
+    description?: string;
+    argumentHint?: string;
+    source: "project" | "user" | "plugin" | "built-in" | "claude";
+}
+export interface NativeCommand {
+    name: string;
+    description: string;
+    /** account: runs standalone; session: resumes the mission's session (forked) to inspect it. */
+    scope: "account" | "session";
+}
+/**
+ * Native Claude CLI slash commands Hive supports mid-conversation. They hang
+ * when sent as a background-session prompt (they open interactive dialogs),
+ * so the server intercepts them and runs `claude -p` out-of-band instead.
+ * Only commands verified to print a text report in headless mode belong here.
+ */
+export declare const NATIVE_COMMANDS: NativeCommand[];
+export type MissionLifecycleStatus = "active" | "ready_for_review" | "paused" | "completed" | "failed" | "archived";
+export interface MissionMessagesPage {
+    messages: MissionMessage[];
+    hasMore: boolean;
+    nextBefore?: number;
+}
+export type PlanItemStatus = "queued" | "working" | "blocked" | "reviewing" | "completed" | "failed" | "cancelled";
+export type WorkerRole = "investigation" | "implementation" | "testing" | "review" | "browser_qa" | "documentation" | "custom";
+export interface MissionPlanTask {
+    id: string;
+    title: string;
+    description?: string;
+    assignment?: string;
+    context?: string;
+    role?: WorkerRole;
+    blocker?: string;
+    unblock?: string;
+    status: PlanItemStatus;
+    weight: number;
+    dependsOn: string[];
+    workerId?: string;
+    owner?: string;
+    startedAt?: number;
+    updatedAt?: number;
+    branch?: string;
+    worktree?: string;
+    changedFiles?: string[];
+    testState?: "not_run" | "running" | "passed" | "failed";
+    subtasks?: MissionPlanTask[];
+    evidence: string[];
+}
+export interface MissionPlanPhase {
+    id: string;
+    title: string;
+    description?: string;
+    milestone?: string;
+    status: PlanItemStatus;
+    acceptanceCriteria: string[];
+    dependsOn: string[];
+    tasks: MissionPlanTask[];
+}
+export interface MissionPlanProgress {
+    completedWeight: number;
+    totalWeight: number;
+    percent?: number;
+    completedTasks: number;
+    totalTasks: number;
+}
+export type CompletionGateType = "test" | "typecheck" | "lint" | "ci" | "review" | "pr" | "screenshot" | "documentation" | "user_approval" | "custom";
+export type CompletionGateStatus = "pending" | "satisfied" | "failed" | "waived";
+export interface CompletionGate {
+    id: string;
+    label: string;
+    type: CompletionGateType;
+    status: CompletionGateStatus;
+    required: boolean;
+    evidence: string[];
+    waiver?: {
+        reason: string;
+        waivedAt: number;
+    };
+}
+export interface MissionPlan {
+    missionId: string;
+    revision: number;
+    updatedAt: number;
+    phases: MissionPlanPhase[];
+    gates: CompletionGate[];
+    layout: "flat" | "phased";
+    approvalStatus: "proposed" | "approved" | "rejected";
+    approvalReason?: string;
+    progress: MissionPlanProgress;
+}
+export type DerivedStatus = "working" | "idle" | "stalled" | "offline" | "waiting_on_you" | "error" | "done";
+export type HiveEventSource = "hook" | "custom";
+export type HiveActivityKind = "file_read" | "file_write" | "command" | "test" | "agent" | "decision" | "output" | "tool" | "lifecycle";
+export type DecisionKind = "product" | "permission" | "destructive" | "merge" | "scope" | "question";
+export interface MissionDecision {
+    id: string;
+    missionId: string;
+    missionName: string;
+    kind: DecisionKind;
+    question: string;
+    context?: string;
+    choices: string[];
+    recommendation?: string;
+    impact?: string;
+    /** Present for historical/resolved decisions; pending inbox items omit it. */
+    answer?: string;
+    /** Mission context so an inbox answer can be given knowing what it's for. */
+    missionObjective?: string;
+    repository?: string;
+    createdAt: number;
+}
+export interface MissionAlert {
+    id: string;
+    severity: "info" | "warning" | "critical";
+    title: string;
+    explanation: string;
+    evidence: string;
+    recovery: string;
+    workerId?: string;
+}
+/** Merged timeline entry — either a raw Claude Code hook firing or a Hive custom lifecycle event. */
+export interface HiveEvent {
+    ts: number;
+    sessionId: string;
+    jobId?: string;
+    source: HiveEventSource;
+    /** For source: 'hook' — the raw hook event name (PreToolUse, PostToolUse, Stop, ...). */
+    hookEventName?: string;
+    toolName?: string;
+    activityKind?: HiveActivityKind;
+    filePath?: string;
+    command?: string;
+    artifactPath?: string;
+    outcome?: "success" | "failure";
+    /** For source: 'custom' — one of the orchestrator lifecycle phases. */
+    phase?: "delegating" | "worker_started" | "worker_reported" | "reviewing" | "blocked_on_user" | "ready_for_review" | "plan_updated" | "decision_resolved" | "resuming" | "custom";
+    detail: string;
+    targetWorker?: string;
+    targetTask?: string;
+    decisionId?: string;
+    decisionKind?: DecisionKind;
+    choices?: string[];
+    recommendation?: string;
+    impact?: string;
+    context?: string;
+    /** Bounded, recursively sanitized source payload for opt-in debugging. */
+    rawPayload?: unknown;
+}
+export interface OrchestratorNode {
+    /** Stable Hive identity, independent of Claude job and process IDs. */
+    missionId: string;
+    /** @deprecated Compatibility alias for clients predating the Mission model. */
+    threadId: string;
+    mission: MissionSummary;
+    jobId: string;
+    jobIds: string[];
+    jobHistory: Array<{
+        jobId: string;
+        sessionId?: string;
+        resumedFrom?: string;
+        state: string;
+        createdAt?: string;
+        updatedAt?: string;
+        tokens: number;
+    }>;
+    sessionId: string;
+    pid: number;
+    name: string;
+    status: DerivedStatus;
+    /** Durable product state, independent of any Claude process or job. */
+    lifecycleStatus: MissionLifecycleStatus;
+    /** Current observed runtime state. `status` is retained as a compatibility alias. */
+    activityStatus: DerivedStatus;
+    /** Latest Claude turn exited normally; the durable mission may still remain active. */
+    turnCompleted: boolean;
+    /** Milliseconds since the last meaningful runtime update. */
+    inactiveForMs: number;
+    waitingFor?: string;
+    worktreePath?: string;
+    worktreeBranch?: string;
+    tokens: number;
+    workers: WorkerActivity[];
+    messages: MissionMessage[];
+    hasMoreMessages: boolean;
+    detail?: string;
+    intent?: string;
+    inFlight: {
+        tasks: number;
+        queued: number;
+        kinds: string[];
+    };
+    recentEvents: HiveEvent[];
+    alerts: MissionAlert[];
+    plan?: MissionPlan;
+    prs: JobChild[];
+    stale: boolean;
+    /** epoch ms — used to sort newest-first in the fleet view */
+    createdAt: number;
+    /** Start of the latest Claude job/turn in this mission. */
+    runStartedAt: number;
+    updatedAt: number;
+}
+export interface SessionNode {
+    jobId?: string;
+    sessionId: string;
+    pid: number;
+    name: string;
+    status: DerivedStatus;
+    waitingFor?: string;
+    cwd: string;
+}
+export interface FleetSnapshot {
+    orchestrators: OrchestratorNode[];
+    decisions: MissionDecision[];
+    other: SessionNode[];
+    generatedAt: number;
+}
+/** Payload accepted by POST /events (emitted by bin/hive-emit.ts). */
+export interface HiveEmitPayload {
+    sessionId: string;
+    jobId?: string;
+    phase: NonNullable<HiveEvent["phase"]>;
+    detail: string;
+    targetWorker?: string;
+    targetTask?: string;
+}

package/node_modules/@hive/shared/dist/types.js

@@ -0,0 +1,14 @@
+// Shapes below are derived from live inspection of real ~/.claude/sessions/<pid>.json
+// and ~/.claude/jobs/<jobId>/state.json files on 2026-08-19/20. Fields marked optional
+// were absent on at least one real record; treat unknown fields defensively.
+/**
+ * Native Claude CLI slash commands Hive supports mid-conversation. They hang
+ * when sent as a background-session prompt (they open interactive dialogs),
+ * so the server intercepts them and runs `claude -p` out-of-band instead.
+ * Only commands verified to print a text report in headless mode belong here.
+ */
+export const NATIVE_COMMANDS = [
+    { name: "usage", description: "Show subscription usage limits and what is consuming them", scope: "account" },
+    { name: "cost", description: "Show the cost and duration breakdown for Claude usage", scope: "account" },
+    { name: "context", description: "Show this mission session's context window usage", scope: "session" },
+];

package/node_modules/@hive/shared/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@hive/shared",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "src/index.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0"
+  }
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@shanesaravia/hive",
+  "private": false,
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Provider-neutral local mission control for Claude Code, Codex, and agent fleets.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shanesaravia/hive.git"
+  },
+  "homepage": "https://github.com/shanesaravia/hive#readme",
+  "bugs": {
+    "url": "https://github.com/shanesaravia/hive/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "bin": {
+    "hive": "./dist/bin/hive.js",
+    "hive-emit": "./dist/bin/hive-emit.js"
+  },
+  "files": [
+    "dist/bin/*.js",
+    "packages/server/dist/**/*.js",
+    "packages/web/dist/**",
+    "templates/agents/*.md",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "bundledDependencies": [
+    "@hive/shared"
+  ],
+  "scripts": {
+    "predev": "npm run build --workspace=@hive/shared",
+    "dev": "npm run dev --workspace=packages/server & npm run dev --workspace=packages/web",
+    "prebuild": "node scripts/clean-build.mjs",
+    "build": "npm run build --workspaces --if-present",
+    "postbuild": "npm run build:cli",
+    "build:cli": "tsc -p tsconfig.bin.json",
+    "package:check": "node scripts/check-package.mjs",
+    "smoke:package": "node scripts/smoke-package.mjs",
+    "prepack": "npm run build && npm run package:check",
+    "start": "node packages/server/dist/index.js",
+    "pretest": "npm run build --workspace=@hive/shared",
+    "test": "npm run test --workspaces --if-present",
+    "posttest": "npm run test:cli",
+    "test:cli": "tsx --test bin/*.test.ts",
+    "typecheck": "npm run typecheck --workspaces --if-present && tsc -p tsconfig.bin.json --noEmit",
+    "hive": "tsx bin/hive.ts"
+  },
+  "dependencies": {
+    "@fastify/cors": "^10.0.0",
+    "@fastify/static": "^10.1.3",
+    "@fastify/websocket": "^11.0.0",
+    "@hive/shared": "*",
+    "better-sqlite3": "^12.11.1",
+    "fastify": "^5.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "tsx": "^4.19.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}