@revealui/harnesses 0.0.0-canary-20260409021642

package/LICENSE

@@ -0,0 +1,109 @@
+Functional Source License, Version 1.1, MIT Future License
+
+Abbreviation
+
+FSL-1.1-MIT
+
+Notice
+
+Copyright 2025-2026 RevealUI Studio (founder@revealui.com)
+
+Terms and Conditions
+
+Licensor:             RevealUI Studio
+
+Licensed Work:        @revealui/harnesses
+                      The Licensed Work is copyright 2025-2026 RevealUI Studio.
+
+Change Date:          2028-04-08
+
+Change License:       MIT
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact: founder@revealui.com
+
+License text below is the Functional Source License, Version 1.1, MIT Future
+License, as published at https://fsl.software/FSL-1.1-MIT.template.md
+
+---
+
+## Terms and Conditions
+
+### Acceptance
+
+In order to get any license under these terms, you must agree to them as
+both strict obligations and conditions to all your licenses.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the licensed work, in each case
+subject to the limitations and conditions below.
+
+### Limitations
+
+You may not make the functionality of the licensed work or a modified
+version available to third parties as a service, or distribute the
+licensed work or a modified version in a way that makes the functionality
+of the software available to third parties. Making the functionality of
+the licensed work available to third parties includes, without limitation,
+enabling third parties to interact with the functionality of the licensed
+work remotely through a computer network, offering a service the value of
+which entirely or primarily derives from the value of the licensed work,
+or offering a service that accomplishes for users the primary purpose of
+the licensed work or a modified version.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor
+can license, or becomes able to license, to make, have made, use, sell,
+offer for sale, import and have imported the licensed work, in each case
+subject to the limitations and conditions in this license. This license
+does not cover any patent claims that you cause to be infringed by
+modifications or additions to the licensed work. If you or your company
+make any written claim that the licensed work infringes or contributes to
+infringement of any patent, your patent license for the licensed work
+granted under these terms ends immediately. If your company makes such a
+claim, your patent license ends immediately for work on behalf of your
+company.
+
+### Fair Use
+
+This license is not intended to limit any right of fair use, fair
+dealing, or other applicable copyright exception or limitation.
+
+### No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your
+licenses to anyone else, or prevent the licensor from granting licenses
+to anyone else. These terms do not imply any other licenses.
+
+### Termination
+
+If you use the licensed work in violation of these terms, such use is
+not licensed, and your licenses may be revoked if you do not cure the
+violation.
+
+The licensor may also revoke your licenses if you fail to comply with
+these terms.
+
+### No Liability
+
+***As far as the law allows, the licensed work comes as is, without any
+warranty or condition, and the licensor will not be liable to you for any
+damages arising out of these terms or the use or nature of the licensed
+work, under any kind of legal claim.***
+
+### Change Date
+
+On the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under
+this License, whichever comes first, the Licensor hereby grants you
+rights under the terms of the Change License, and the rights granted in
+the paragraphs above terminate.
+
+### Change License
+
+On the Change Date, the Licensed Work will be made available under the
+Change License specified above (MIT).

package/README.md

@@ -0,0 +1,108 @@
+# @revealui/harnesses
+
+> **Commercial package** — requires a [RevealUI Pro license](https://revealui.com/pro). Free to install and evaluate; a license key is required for production use.
+
+
+AI harness coordination for RevealUI — enables multiple AI coding tools to work on the same codebase safely and in parallel.
+
+## Features
+
+- **Multi-Harness Coordination**: Claude Code, Cursor, Copilot adapters with conflict detection
+- **Workboard Protocol**: Shared `.claude/workboard.md` for session tracking and file reservations
+- **Auto-Detection**: Discovers installed harnesses via PATH and running processes
+- **JSON-RPC 2.0 Server**: Unix domain socket IPC for harness-to-harness communication
+- **Config Sync**: Portable config backup to external drives (DevPod/LTS)
+- **Session Identity**: Detects parent environment (Zed, Cursor, terminal) via process chain
+
+## Architecture
+
+```
+packages/harnesses/src/
+├── adapters/       # AI tool adapters (Claude Code, Copilot)
+├── config/         # Config path resolution and SSD sync
+├── detection/      # Auto-detect installed/running harnesses
+├── registry/       # Lifecycle management of adapters
+├── server/         # JSON-RPC 2.0 over Unix socket
+├── types/          # HarnessAdapter contract, commands, events
+├── workboard/      # Multi-agent workboard coordination
+├── coordinator.ts  # Main orchestrator (start/stop lifecycle)
+└── cli.ts          # CLI daemon and RPC client
+```
+
+## CLI
+
+```bash
+# Start daemon (detect harnesses, register session, start RPC server)
+revealui-harnesses start --project /path/to/repo
+
+# List available harnesses
+revealui-harnesses status
+
+# Sync harness config to/from SSD
+revealui-harnesses sync claude-code push
+
+# Print workboard state
+revealui-harnesses coordinate --print
+```
+
+## Usage
+
+```typescript
+import { HarnessCoordinator } from '@revealui/harnesses'
+
+const coordinator = new HarnessCoordinator({ projectRoot: '/path/to/repo' })
+await coordinator.start()
+
+// Coordinator auto-detects harnesses, registers in workboard, starts RPC server
+// On shutdown:
+await coordinator.stop()
+```
+
+### Workboard Coordination
+
+```typescript
+import { WorkboardManager, deriveSessionId } from '@revealui/harnesses/workboard'
+
+const manager = new WorkboardManager('/path/to/repo/.claude/workboard.md')
+const state = await manager.read()
+
+// Register session
+const sessionId = await deriveSessionId()
+await manager.registerSession({
+  id: sessionId,
+  env: 'Zed/WSL',
+  task: 'implementing feature X',
+  files: ['src/feature.ts'],
+})
+```
+
+## Exports
+
+| Subpath | Contents |
+|---------|----------|
+| `@revealui/harnesses` | Full API: adapters, registry, coordinator, detection, config |
+| `@revealui/harnesses/types` | Type definitions: HarnessAdapter, commands, events, capabilities |
+| `@revealui/harnesses/workboard` | WorkboardManager, deriveSessionId, detectSessionType |
+
+## Development
+
+```bash
+# Run tests
+pnpm --filter @revealui/harnesses test
+
+# Type check
+pnpm --filter @revealui/harnesses typecheck
+
+# Build
+pnpm --filter @revealui/harnesses build
+```
+
+## Related Documentation
+
+- [Coordination Rules](../../.claude/rules/coordination.md) — Multi-instance protocol
+- [Architecture Guide](../../docs/ARCHITECTURE.md) — System architecture
+- [Editors Package](../editors/README.md) — Editor daemon (parallel architecture)
+
+## License
+
+Commercial — see [LICENSE.commercial](../../LICENSE.commercial)