@revealui/harnesses 0.1.8 → 0.1.9

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   HarnessCoordinator,
   checkHarnessesLicense
-} from "./chunk-6E2BKO6U.js";
+} from "./chunk-YYAYTCRM.js";
 import {
   buildManifest,
   diffContent,
@@ -10,12 +10,12 @@ import {
   listContent,
   listGenerators,
   validateManifest
-} from "./chunk-PROC6EJC.js";
-import "./chunk-DGQ5OB6L.js";
+} from "./chunk-ZNIQELKZ.js";
+import "./chunk-ANX4L2PF.js";
 import {
   WorkboardManager
-} from "./chunk-4F4ANKIZ.js";
-import "./chunk-DGUM43GV.js";
+} from "./chunk-Y4FFO3TO.js";
+import "./chunk-3RG5ZIWI.js";
 
 // src/cli.ts
 import { mkdirSync, unlinkSync, writeFileSync } from "fs";
@@ -572,4 +572,3 @@ main().catch((err) => {
 `);
   process.exit(1);
 });
-//# sourceMappingURL=cli.js.map

package/dist/content/index.d.ts

@@ -192,7 +192,7 @@ declare function resolveTemplate(template: string, ctx: ResolverContext): string
 declare function listResolvers(): string[];
 
 /**
- * @revealui/harnesses/content — Canonical Content Layer
+ * @revealui/harnesses/content  -  Canonical Content Layer
  *
  * Tool-agnostic definitions for AI guidance content (rules, commands, agents, skills).
  * Generators produce tool-specific output (Claude Code, Cursor, etc.) from canonical definitions.

package/dist/content/index.js

@@ -16,8 +16,8 @@ import {
   registerResolver,
   resolveTemplate,
   validateManifest
-} from "../chunk-PROC6EJC.js";
-import "../chunk-DGUM43GV.js";
+} from "../chunk-ZNIQELKZ.js";
+import "../chunk-3RG5ZIWI.js";
 export {
   AgentSchema,
   CommandSchema,
@@ -37,4 +37,3 @@ export {
   resolveTemplate,
   validateManifest
 };
-//# sourceMappingURL=index.js.map

package/dist/index-w5ashbfb.d.ts

@@ -0,0 +1,266 @@
+/**
+ * PGlite schema for the RevDev Harness daemon.
+ *
+ * Five tables provide persistent state for multi-agent coordination:
+ *   - agent_sessions: active and historical agent sessions
+ *   - agent_messages: inter-agent mailbox (point-to-point + broadcast)
+ *   - file_reservations: advisory file locks with CAS semantics
+ *   - tasks: claimable work items with CAS ownership
+ *   - events: append-only event log for audit trail
+ *
+ * Uses raw SQL (no Drizzle ORM) to keep the daemon dependency-free.
+ * PGlite runs in-process  -  no external database needed.
+ */
+/** SQL statements to initialize the daemon database. */
+declare const SCHEMA_SQL = "\n  CREATE TABLE IF NOT EXISTS agent_sessions (\n    id            TEXT PRIMARY KEY,\n    env           TEXT NOT NULL DEFAULT '',\n    task          TEXT NOT NULL DEFAULT '(starting)',\n    files         TEXT NOT NULL DEFAULT '',\n    pid           INTEGER,\n    started_at    TIMESTAMP NOT NULL DEFAULT NOW(),\n    updated_at    TIMESTAMP NOT NULL DEFAULT NOW(),\n    ended_at      TIMESTAMP,\n    exit_summary  TEXT\n  );\n\n  CREATE TABLE IF NOT EXISTS agent_messages (\n    id            SERIAL PRIMARY KEY,\n    from_agent    TEXT NOT NULL,\n    to_agent      TEXT NOT NULL,\n    subject       TEXT NOT NULL DEFAULT '',\n    body          TEXT NOT NULL DEFAULT '',\n    read          BOOLEAN NOT NULL DEFAULT FALSE,\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_messages_to_unread\n    ON agent_messages (to_agent, read) WHERE read = FALSE;\n\n  CREATE TABLE IF NOT EXISTS file_reservations (\n    file_path     TEXT PRIMARY KEY,\n    agent_id      TEXT NOT NULL,\n    reserved_at   TIMESTAMP NOT NULL DEFAULT NOW(),\n    expires_at    TIMESTAMP NOT NULL,\n    reason        TEXT NOT NULL DEFAULT ''\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_reservations_agent\n    ON file_reservations (agent_id);\n\n  CREATE TABLE IF NOT EXISTS tasks (\n    id            TEXT PRIMARY KEY,\n    description   TEXT NOT NULL DEFAULT '',\n    status        TEXT NOT NULL DEFAULT 'open',\n    owner         TEXT,\n    claimed_at    TIMESTAMP,\n    completed_at  TIMESTAMP,\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_tasks_status\n    ON tasks (status);\n\n  CREATE INDEX IF NOT EXISTS idx_tasks_owner\n    ON tasks (owner) WHERE owner IS NOT NULL;\n\n  CREATE TABLE IF NOT EXISTS events (\n    id            SERIAL PRIMARY KEY,\n    agent_id      TEXT NOT NULL,\n    event_type    TEXT NOT NULL,\n    payload       JSONB NOT NULL DEFAULT '{}',\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_events_agent\n    ON events (agent_id, created_at DESC);\n\n  CREATE TABLE IF NOT EXISTS worktrees (\n    agent_id      TEXT PRIMARY KEY,\n    branch        TEXT NOT NULL,\n    worktree_path TEXT NOT NULL,\n    base_branch   TEXT NOT NULL DEFAULT 'test',\n    status        TEXT NOT NULL DEFAULT 'active',\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE TABLE IF NOT EXISTS agent_memory (\n    id            SERIAL PRIMARY KEY,\n    agent_id      TEXT NOT NULL,\n    memory_type   TEXT NOT NULL,\n    content       TEXT NOT NULL,\n    metadata      JSONB NOT NULL DEFAULT '{}',\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_memory_agent_type\n    ON agent_memory (agent_id, memory_type, created_at DESC);\n\n  CREATE TABLE IF NOT EXISTS merge_requests (\n    id            TEXT PRIMARY KEY,\n    agent_id      TEXT NOT NULL,\n    task_id       TEXT,\n    source_branch TEXT NOT NULL,\n    base_branch   TEXT NOT NULL DEFAULT 'test',\n    status        TEXT NOT NULL DEFAULT 'pending',\n    pr_number     INTEGER,\n    pr_url        TEXT,\n    retry_count   INTEGER NOT NULL DEFAULT 0,\n    error_message TEXT,\n    ci_output     TEXT,\n    created_at    TIMESTAMP NOT NULL DEFAULT NOW(),\n    updated_at    TIMESTAMP NOT NULL DEFAULT NOW()\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_merge_requests_agent\n    ON merge_requests (agent_id, status);\n\n  CREATE INDEX IF NOT EXISTS idx_merge_requests_branch\n    ON merge_requests (source_branch);\n\n  CREATE INDEX IF NOT EXISTS idx_merge_requests_pr\n    ON merge_requests (pr_number) WHERE pr_number IS NOT NULL;\n";
+/** Session row shape. */
+interface AgentSession {
+    id: string;
+    env: string;
+    task: string;
+    files: string;
+    pid: number | null;
+    started_at: string;
+    updated_at: string;
+    ended_at: string | null;
+    exit_summary: string | null;
+}
+/** Message row shape. */
+interface AgentMessage {
+    id: number;
+    from_agent: string;
+    to_agent: string;
+    subject: string;
+    body: string;
+    read: boolean;
+    created_at: string;
+}
+/** File reservation row shape. */
+interface FileReservation {
+    file_path: string;
+    agent_id: string;
+    reserved_at: string;
+    expires_at: string;
+    reason: string;
+}
+/** Task row shape. */
+interface AgentTask {
+    id: string;
+    description: string;
+    status: 'open' | 'claimed' | 'completed';
+    owner: string | null;
+    claimed_at: string | null;
+    completed_at: string | null;
+    created_at: string;
+}
+/** Event row shape. */
+interface DaemonEvent {
+    id: number;
+    agent_id: string;
+    event_type: string;
+    payload: Record<string, unknown>;
+    created_at: string;
+}
+/** Worktree row shape. */
+interface AgentWorktree {
+    agent_id: string;
+    branch: string;
+    worktree_path: string;
+    base_branch: string;
+    status: 'active' | 'merged' | 'abandoned';
+    created_at: string;
+}
+/** Merge request row shape. */
+interface MergeRequest {
+    id: string;
+    agent_id: string;
+    task_id: string | null;
+    source_branch: string;
+    base_branch: string;
+    status: 'pending' | 'merging' | 'pr_created' | 'ci_running' | 'merged' | 'ci_failed' | 'conflict' | 'escalated';
+    pr_number: number | null;
+    pr_url: string | null;
+    retry_count: number;
+    error_message: string | null;
+    ci_output: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/** Memory row shape. */
+interface AgentMemoryEntry {
+    id: number;
+    agent_id: string;
+    memory_type: 'thought' | 'action' | 'result' | 'decision' | 'disagreement';
+    content: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+
+/**
+ * DaemonStore  -  persistent state for the RevDev Harness daemon.
+ *
+ * Backed by PGlite (in-process PostgreSQL). The database file lives at
+ * ~/.local/share/revealui/harness.db and survives daemon restarts.
+ *
+ * All methods are async (PGlite queries return promises).
+ */
+
+/** Configuration for DaemonStore. */
+interface DaemonStoreConfig {
+    /** PGlite data directory (default: ~/.local/share/revealui/harness.db) */
+    dataDir: string;
+}
+declare class DaemonStore {
+    private db;
+    private readonly dataDir;
+    constructor(config: DaemonStoreConfig);
+    /** Initialize PGlite and create tables. */
+    init(): Promise<void>;
+    /** Shut down the database. */
+    close(): Promise<void>;
+    private getDb;
+    /** Register or update an agent session. */
+    registerSession(session: {
+        id: string;
+        env: string;
+        task?: string;
+        pid?: number;
+    }): Promise<AgentSession>;
+    /** Update a session's task and/or files. */
+    updateSession(id: string, updates: {
+        task?: string;
+        files?: string;
+    }): Promise<AgentSession | null>;
+    /** End a session (mark ended_at, record exit summary). */
+    endSession(id: string, exitSummary?: string): Promise<void>;
+    /** Get all active sessions (ended_at IS NULL). */
+    getActiveSessions(): Promise<AgentSession[]>;
+    /** Get session history for an agent (most recent first). */
+    getSessionHistory(agentId: string, limit: number): Promise<AgentSession[]>;
+    /** Send a message from one agent to another. */
+    sendMessage(msg: {
+        fromAgent: string;
+        toAgent: string;
+        subject: string;
+        body?: string;
+    }): Promise<AgentMessage>;
+    /** Broadcast a message to all active agents (except sender). */
+    broadcastMessage(msg: {
+        fromAgent: string;
+        subject: string;
+        body?: string;
+    }): Promise<number>;
+    /** Get unread messages for an agent. */
+    getInbox(agentId: string, unreadOnly: boolean): Promise<AgentMessage[]>;
+    /** Mark messages as read. */
+    markRead(messageIds: number[]): Promise<void>;
+    /** Reserve a file for an agent (CAS: fails if already reserved by another). */
+    reserveFile(reservation: {
+        filePath: string;
+        agentId: string;
+        ttlSeconds: number;
+        reason?: string;
+    }): Promise<{
+        success: boolean;
+        holder?: string;
+    }>;
+    /** Check who holds a file reservation. */
+    checkReservation(filePath: string): Promise<FileReservation | null>;
+    /** Release all reservations held by an agent. */
+    releaseAllReservations(agentId: string): Promise<number>;
+    /** Get all reservations for an agent. */
+    getReservations(agentId: string): Promise<FileReservation[]>;
+    /** Create a new task. */
+    createTask(task: {
+        id: string;
+        description: string;
+    }): Promise<AgentTask>;
+    /** Claim a task atomically (CAS: fails if already claimed by another agent). */
+    claimTask(taskId: string, agentId: string): Promise<{
+        success: boolean;
+        owner?: string;
+    }>;
+    /** Complete a task (only the owner can complete it). */
+    completeTask(taskId: string, agentId: string): Promise<boolean>;
+    /** Release a claimed task back to open (only the owner can release). */
+    releaseTask(taskId: string, agentId: string): Promise<boolean>;
+    /** List tasks, optionally filtered by status and/or owner. */
+    listTasks(filter?: {
+        status?: string;
+        owner?: string;
+    }): Promise<AgentTask[]>;
+    /** Append an event to the audit log. */
+    logEvent(event: {
+        agentId: string;
+        eventType: string;
+        payload?: Record<string, unknown>;
+    }): Promise<DaemonEvent>;
+    /** Get recent events (newest first). */
+    getRecentEvents(limit: number): Promise<DaemonEvent[]>;
+    /** Prune events older than a given number of days. */
+    pruneEvents(olderThanDays: number): Promise<number>;
+    /** Register a worktree for an agent. */
+    registerWorktree(wt: {
+        agentId: string;
+        branch: string;
+        worktreePath: string;
+        baseBranch?: string;
+    }): Promise<AgentWorktree>;
+    /** Get a worktree by agent ID. */
+    getWorktree(agentId: string): Promise<AgentWorktree | null>;
+    /** List all active worktrees. */
+    getActiveWorktrees(): Promise<AgentWorktree[]>;
+    /** Update worktree status (active → merged | abandoned). */
+    updateWorktreeStatus(agentId: string, status: 'merged' | 'abandoned'): Promise<boolean>;
+    /** Remove a worktree record. */
+    removeWorktree(agentId: string): Promise<boolean>;
+    /** Store a memory entry. */
+    storeMemory(entry: {
+        agentId: string;
+        memoryType: AgentMemoryEntry['memory_type'];
+        content: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<AgentMemoryEntry>;
+    /** Recall memory entries by agent and type (newest first). */
+    recallMemory(query: {
+        agentId?: string;
+        memoryType?: AgentMemoryEntry['memory_type'];
+        keyword?: string;
+        limit?: number;
+    }): Promise<AgentMemoryEntry[]>;
+    /** Get a summary of recent memory (last N per type for context injection). */
+    summarizeMemory(agentId: string, perType: number): Promise<AgentMemoryEntry[]>;
+    /** Prune old memory entries (keep last N per agent). */
+    pruneMemory(keepPerAgent: number): Promise<number>;
+    /** Create a merge request for an agent's branch. */
+    createMergeRequest(mr: {
+        id: string;
+        agentId: string;
+        taskId?: string;
+        sourceBranch: string;
+        baseBranch?: string;
+    }): Promise<MergeRequest>;
+    /** Get a merge request by ID. */
+    getMergeRequest(id: string): Promise<MergeRequest | null>;
+    /** Get a merge request by source branch. */
+    getMergeRequestByBranch(branch: string): Promise<MergeRequest | null>;
+    /** Get a merge request by PR number. */
+    getMergeRequestByPr(prNumber: number): Promise<MergeRequest | null>;
+    /** Update a merge request's fields. */
+    updateMergeRequest(id: string, updates: {
+        status?: MergeRequest['status'];
+        prNumber?: number;
+        prUrl?: string;
+        errorMessage?: string;
+        ciOutput?: string;
+    }): Promise<MergeRequest | null>;
+    /** Increment the retry count for a merge request. */
+    incrementMergeRetry(id: string): Promise<number>;
+    /** List merge requests, optionally filtered by status and/or agent. */
+    listMergeRequests(filter?: {
+        status?: string;
+        agentId?: string;
+    }): Promise<MergeRequest[]>;
+}
+
+export { type AgentMessage as A, DaemonStore as D, type FileReservation as F, type MergeRequest as M, SCHEMA_SQL as S, type AgentSession as a, type AgentTask as b, type DaemonEvent as c, type DaemonStoreConfig as d };