@revealui/harnesses 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025-2026 RevealUI Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/LICENSE.commercial

@@ -0,0 +1,112 @@
+RevealUI Commercial License
+Version 1.0, February 2026
+
+Copyright (c) 2025-2026 RevealUI Studio (founder@revealui.com)
+
+TERMS AND CONDITIONS
+
+1. DEFINITIONS
+
+"Software" means the RevealUI source code, documentation, and associated
+files contained in directories and packages designated as commercial,
+including but not limited to: packages/ai, packages/mcp, packages/editors,
+packages/services, packages/harnesses, and any directory named "ee" within
+the repository.
+
+"License Key" means a valid RevealUI license key obtained through an active
+paid subscription at https://revealui.com.
+
+"Licensee" means the individual or organization that holds a valid License
+Key through an active subscription.
+
+"Production Use" means any use of the Software beyond local development and
+evaluation, including but not limited to: deploying the Software to serve
+end users, integrating the Software into a product or service, or using the
+Software in a revenue-generating capacity.
+
+2. GRANT OF RIGHTS
+
+Subject to the terms of this License and a valid License Key, the Licensee
+is granted a non-exclusive, non-transferable, revocable license to:
+
+  (a) Use the Software for internal development and Production Use.
+  (b) Modify the Software for internal use.
+  (c) Deploy the Software on infrastructure controlled by the Licensee.
+
+Enterprise License holders are additionally granted the right to:
+
+  (d) Deploy the Software in a self-hosted environment.
+  (e) Remove or replace RevealUI branding (white-label).
+  (f) Use the Software for multiple tenants within the Licensee's
+      organization or customer base.
+
+3. RESTRICTIONS
+
+The Licensee SHALL NOT:
+
+  (a) Provide the Software, or any portion of it, to third parties as a
+      hosted or managed service that competes with RevealUI.
+  (b) Redistribute, sublicense, sell, or otherwise transfer the Software
+      or any portion of it to third parties.
+  (c) Remove, alter, or circumvent the license key verification
+      functionality of the Software.
+  (d) Use the Software in Production without a valid License Key.
+  (e) Share, publish, or make the License Key available to unauthorized
+      parties.
+
+4. EVALUATION
+
+The Software may be used for evaluation and local development purposes
+without a License Key. Evaluation use does not grant any rights to
+Production Use.
+
+5. SUBSCRIPTION AND PAYMENT
+
+This License is valid only during the term of an active paid subscription.
+Upon cancellation or expiration of the subscription:
+
+  (a) The License terminates automatically.
+  (b) A grace period of fourteen (14) days is provided for the Licensee
+      to transition away from Production Use.
+  (c) After the grace period, the Licensee must cease all Production Use
+      of the Software.
+
+6. INTELLECTUAL PROPERTY
+
+The Software is and remains the intellectual property of RevealUI Studio.
+This License does not grant any ownership rights. Contributions to
+commercial portions of the Software require a Contributor License Agreement.
+
+7. OPEN SOURCE COMPONENTS
+
+This License applies only to files and directories designated as commercial.
+Files under the MIT License (as indicated in the root LICENSE file) are not
+subject to this commercial license and may be used freely under MIT terms.
+
+8. DISCLAIMER OF WARRANTY
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+9. LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL REVEALUI STUDIO BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE, EXCEEDING THE AMOUNT PAID BY THE LICENSEE IN
+THE TWELVE (12) MONTHS PRECEDING THE CLAIM.
+
+10. GOVERNING LAW
+
+This License shall be governed by the laws of the State of California,
+United States of America, without regard to its conflict of law provisions.
+
+11. ENTIRE AGREEMENT
+
+This License constitutes the entire agreement between the parties with
+respect to the commercial portions of the Software and supersedes all
+prior agreements, understandings, and communications.
+
+For licensing inquiries: founder@revealui.com
+For pricing and subscriptions: https://revealui.com/pricing

package/README.md

@@ -0,0 +1,105 @@
+# @revealui/harnesses
+
+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)