@revealui/harnesses 0.1.0 → 0.1.3

package/dist/types/index.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Core types for the AI harness integration system.
+ * Mirrors packages/editors/src/types/core.ts for the harness domain.
+ */
+interface HarnessCapabilities {
+    /** Can generate code from a prompt */
+    generateCode: boolean;
+    /** Can analyze/explain existing code */
+    analyzeCode: boolean;
+    /** Can apply inline code edits */
+    applyEdit: boolean;
+    /** Can sync configuration files */
+    applyConfig: boolean;
+    /** Can query workboard state */
+    readWorkboard: boolean;
+    /** Can write workboard state */
+    writeWorkboard: boolean;
+}
+type ConfigSyncDirection = 'push' | 'pull';
+type HarnessCommand = {
+    type: 'generate-code';
+    prompt: string;
+    context?: string;
+    language?: string;
+} | {
+    type: 'analyze-code';
+    filePath: string;
+    question?: string;
+} | {
+    type: 'apply-edit';
+    filePath: string;
+    diff: string;
+} | {
+    type: 'apply-config';
+    configPath: string;
+    content: string;
+} | {
+    type: 'get-status';
+} | {
+    type: 'get-running-instances';
+} | {
+    type: 'sync-config';
+    direction: ConfigSyncDirection;
+} | {
+    type: 'diff-config';
+} | {
+    type: 'read-workboard';
+} | {
+    type: 'update-workboard';
+    sessionId: string;
+    task?: string;
+    files?: string[];
+} | {
+    type: 'headless-prompt';
+    prompt: string;
+    maxTurns?: number;
+    timeoutMs?: number;
+};
+interface HarnessCommandResult {
+    success: boolean;
+    command: HarnessCommand['type'];
+    message?: string;
+    data?: unknown;
+}
+type HarnessEvent = {
+    type: 'harness-connected';
+    harnessId: string;
+} | {
+    type: 'harness-disconnected';
+    harnessId: string;
+} | {
+    type: 'generation-started';
+    taskId: string;
+} | {
+    type: 'generation-completed';
+    taskId: string;
+    output: string;
+} | {
+    type: 'error';
+    harnessId: string;
+    message: string;
+};
+interface HarnessInfo {
+    id: string;
+    name: string;
+    version?: string;
+    capabilities: HarnessCapabilities;
+}
+interface HarnessProcessInfo {
+    pid: number;
+    command: string;
+    harnessId: string;
+}
+interface ConfigSyncResult {
+    success: boolean;
+    harnessId: string;
+    direction: ConfigSyncDirection;
+    message?: string;
+}
+interface ConfigDiffEntry {
+    harnessId: string;
+    localExists: boolean;
+    ssdExists: boolean;
+    identical: boolean;
+}
+interface HealthCheckResult {
+    healthy: boolean;
+    timestamp: string;
+    registeredHarnesses: Array<{
+        harnessId: string;
+        available: boolean;
+    }>;
+    workboard: {
+        readable: boolean;
+        sessionCount: number;
+        staleSessionIds: string[];
+    };
+    diagnostics: string[];
+}
+
+/**
+ * Contract every AI harness adapter must satisfy.
+ * Mirrors EditorAdapter from packages/editors.
+ *
+ * AI tools are external executables — never linked libraries.
+ * Communication is data-only: commands in, results out.
+ */
+interface HarnessAdapter {
+    /** Unique stable identifier, e.g. "claude-code", "cursor", "copilot" */
+    readonly id: string;
+    /** Human-readable display name */
+    readonly name: string;
+    /** Returns the static capability set for this harness */
+    getCapabilities(): HarnessCapabilities;
+    /** Returns live info (version, etc.) — may shell out */
+    getInfo(): Promise<HarnessInfo>;
+    /** True if the harness executable is on PATH and accessible */
+    isAvailable(): Promise<boolean>;
+    /** Execute a typed command against this harness */
+    execute(command: HarnessCommand): Promise<HarnessCommandResult>;
+    /** Subscribe to harness events; returns an unsubscribe function */
+    onEvent(handler: (event: HarnessEvent) => void): () => void;
+    /** Release all resources held by this adapter */
+    dispose(): Promise<void>;
+    /** Called by the registry after this adapter has been registered. */
+    notifyRegistered?(): void;
+    /** Called by the registry just before this adapter is unregistered. */
+    notifyUnregistering?(): void;
+}
+
+export type { ConfigDiffEntry, ConfigSyncDirection, ConfigSyncResult, HarnessAdapter, HarnessCapabilities, HarnessCommand, HarnessCommandResult, HarnessEvent, HarnessInfo, HarnessProcessInfo, HealthCheckResult };

package/dist/types/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/workboard/index.d.ts

@@ -67,17 +67,22 @@ interface ConflictResult {
  *
  * This class provides programmatic access to the Sessions table and Recent list.
  * Plans, Context, and Plan Reference are treated as opaque strings.
+ *
+ * All mutating methods use file locking (O_EXCL) to prevent race conditions
+ * when multiple harness instances write concurrently. Writes are atomic
+ * (tmp file + rename).
  */
 declare class WorkboardManager {
     private readonly workboardPath;
+    private readonly lockPath;
     constructor(workboardPath: string);
     /** Read and parse the workboard. */
     read(): WorkboardState;
-    /** Write a workboard state back to disk. */
+    /** Write a workboard state back to disk (locked + atomic). */
     write(state: WorkboardState): void;
     /** Read and parse the workboard asynchronously. */
     readAsync(): Promise<WorkboardState>;
-    /** Write a workboard state back to disk asynchronously. */
+    /** Write a workboard state back to disk asynchronously (locked + atomic). */
     writeAsync(state: WorkboardState): Promise<void>;
     /** Register a new session, replacing any existing row with the same id. */
     registerSession(session: WorkboardSession): void;
@@ -98,8 +103,44 @@ declare class WorkboardManager {
      * Returns a ConflictResult describing any overlaps found.
      */
     checkConflicts(mySessionId: string, files: string[]): ConflictResult;
+    private readUnlocked;
+    private writeUnlocked;
 }
 
+/**
+ * Acquire an exclusive file lock using O_EXCL (kernel-level atomic create).
+ * Writes the current PID to the lock file for dead-holder detection.
+ *
+ * Spins with a 50ms interval until timeout. If the current lock holder
+ * is dead (process no longer running), the lock is stolen.
+ *
+ * @returns true if the lock was acquired, false on timeout
+ */
+declare function acquireLock(lockPath: string, timeoutMs?: number): boolean;
+/**
+ * Release a file lock. Swallows ENOENT (already released).
+ */
+declare function releaseLock(lockPath: string): void;
+/**
+ * Execute a synchronous function while holding the file lock.
+ * The lock is always released, even if fn throws.
+ */
+declare function withLock<T>(lockPath: string, fn: () => T, timeoutMs?: number): T;
+/**
+ * Execute an async function while holding the file lock.
+ * The lock is always released, even if fn throws.
+ */
+declare function withLockAsync<T>(lockPath: string, fn: () => Promise<T>, timeoutMs?: number): Promise<T>;
+/**
+ * Write a file atomically: write to a temporary file, then rename.
+ * rename() on the same filesystem is atomic at the kernel level.
+ */
+declare function atomicWriteSync(filePath: string, content: string): void;
+/**
+ * Derive a lock path from a workboard path (.md → .lock).
+ */
+declare function lockPathFor(workboardPath: string): string;
+
 /** Type of session detected from the runtime environment. */
 type SessionType = 'zed' | 'cursor' | 'terminal';
 /**
@@ -117,4 +158,4 @@ declare function detectSessionType(): SessionType;
  */
 declare function deriveSessionId(type: SessionType, existingIds: string[]): string;
 
-export { type ConflictResult, type SessionType, type WorkboardEntry, WorkboardManager, type WorkboardSession, type WorkboardState, deriveSessionId, detectSessionType };
+export { type ConflictResult, type SessionType, type WorkboardEntry, WorkboardManager, type WorkboardSession, type WorkboardState, acquireLock, atomicWriteSync, deriveSessionId, detectSessionType, lockPathFor, releaseLock, withLock, withLockAsync };

package/dist/workboard/index.js

@@ -1,12 +1,24 @@
-import "../chunk-JUNNIQS3.js";
 import {
   WorkboardManager,
+  acquireLock,
+  atomicWriteSync,
   deriveSessionId,
-  detectSessionType
-} from "../chunk-PG4RAOWS.js";
+  detectSessionType,
+  lockPathFor,
+  releaseLock,
+  withLock,
+  withLockAsync
+} from "../chunk-FJGN6DTH.js";
+import "../chunk-DGUM43GV.js";
 export {
   WorkboardManager,
+  acquireLock,
+  atomicWriteSync,
   deriveSessionId,
-  detectSessionType
+  detectSessionType,
+  lockPathFor,
+  releaseLock,
+  withLock,
+  withLockAsync
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,12 +1,27 @@
 {
   "name": "@revealui/harnesses",
-  "version": "0.1.0",
-  "description": "AI harness integration system - adapters, daemon, workboard coordination, and JSON-RPC server",
+  "version": "0.1.3",
+  "description": "[Pro] AI harness integration system - adapters, daemon, workboard coordination, and JSON-RPC server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RevealUIStudio/revealui.git",
+    "directory": "packages/harnesses"
+  },
   "license": "SEE LICENSE IN ../../LICENSE.commercial",
-  "type": "module",
   "bin": {
     "revealui-harnesses": "./dist/cli.js"
   },
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@revealui/core": "0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.0.18",
+    "dev": "0.0.1"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,35 +34,35 @@
     "./workboard": {
       "types": "./dist/workboard/index.d.ts",
       "import": "./dist/workboard/index.js"
+    },
+    "./content": {
+      "types": "./dist/content/index.d.ts",
+      "import": "./dist/content/index.js"
     }
   },
   "files": [
     "dist"
   ],
-  "dependencies": {
-    "@revealui/core": "0.2.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.3.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18",
-    "dev": "0.0.1"
+  "funding": {
+    "type": "commercial",
+    "url": "https://revealui.com/pro"
   },
+  "main": "./dist/index.js",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "type": "module",
+  "types": "./dist/index.d.ts",
   "scripts": {
     "build": "tsup",
+    "clean": "rm -rf dist",
     "dev": "tsup --watch",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
     "start": "node dist/cli.js",
-    "typecheck": "tsc --noEmit",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
-    "lint": "biome check .",
-    "lint:fix": "biome check --write .",
-    "clean": "rm -rf dist"
+    "typecheck": "tsc --noEmit"
   }
 }