@meego-harness/mara-worker 0.8.0

package/README.md

@@ -0,0 +1,56 @@
+# `@meego-harness/mara-worker`
+
+Standalone Mira CLI worker bridge for `meego-harness`.
+
+It logs into a `WorkerServerSDK` endpoint as a `coder` worker, executes tasks through the local Mira installation, and reuses one persisted Mira conversation per harness `contextId`.
+
+## What You Need First
+
+Before installing this package, make sure all of the following are already true:
+
+1. Node.js and `pnpm` are available.
+2. Mira CLI is already installed separately and `mira --help` succeeds in your shell.
+3. `python3` is available, because the bridge invokes Mira's local Python implementation.
+4. A target worker server is already running.
+5. You already have an absolute workspace directory on disk.
+
+## Command Summary
+
+```bash
+meego-mara-worker setup
+meego-mara-worker start --worker <workerId> [--tmux]
+meego-mara-worker stop --worker <workerId>
+meego-mara-worker stop-all
+meego-mara-worker enable --worker <workerId>
+meego-mara-worker disable --worker <workerId>
+meego-mara-worker uninstall --worker <workerId>
+```
+
+## Install
+
+```bash
+pnpm add @meego-harness/mara-worker
+pnpm exec meego-mara-worker setup
+```
+
+## Runtime Model
+
+- First message in one harness `contextId` starts a new Mira conversation and persists its `conv_id`.
+- Later messages in the same context reload that saved conversation so Mira can continue from prior context.
+- Repo routing is driven by `task.metadata.repo`.
+- Remote MCP tools and remote skills are disabled inside worker mode to keep routing deterministic and focused on local coding work.
+- Structured project-node output supports `completed` and `input_required` JSON responses, with one retry when the first response is invalid.
+
+## Local Files Written By This Package
+
+Config file:
+
+```text
+~/.meego-harness/mara-worker/<workerId>.json
+```
+
+Per-context state file:
+
+```text
+~/.meego-harness/mara-worker/<workerId>.state.json
+```

package/bin/meego-mara-worker.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+import process from 'node:process'
+import { runMiraWorkerCli } from '../dist/cli.js'
+
+runMiraWorkerCli().catch((error) => {
+  console.error(error instanceof Error ? error.message : 'Mira CLI worker CLI failed')
+  process.exitCode = 1
+})