codeharbor 0.1.9 → 0.1.11

package/.env.example

@@ -17,6 +17,11 @@ CODEX_EXTRA_ARGS=
 # Optional JSON object for additional environment variables passed to codex child process.
 CODEX_EXTRA_ENV_JSON=
 
+# Multi-agent workflow (Phase B, opt-in).
+AGENT_WORKFLOW_ENABLED=false
+# Auto-repair rounds after reviewer rejects output.
+AGENT_WORKFLOW_AUTO_REPAIR_MAX_ROUNDS=1
+
 # SQLite state database path.
 STATE_DB_PATH=data/state.db
 # Legacy JSON path for one-time migration import.

package/README.md

@@ -67,27 +67,33 @@ curl -fsSL https://raw.githubusercontent.com/biglone/CodeHarbor/main/scripts/ins
 Install first, then enable systemd service with one command:
 
 ```bash
-sudo "$(command -v codeharbor)" service install
+codeharbor service install
 ```
 
 Install + enable main and admin services:
 
 ```bash
-sudo "$(command -v codeharbor)" service install --with-admin
+codeharbor service install --with-admin
 ```
 
 Restart installed service(s):
 
 ```bash
-sudo "$(command -v codeharbor)" service restart --with-admin
+codeharbor service restart --with-admin
 ```
 
 Remove installed services:
 
 ```bash
-sudo "$(command -v codeharbor)" service uninstall --with-admin
+codeharbor service uninstall --with-admin
 ```
 
+Notes:
+
+- Service commands auto-elevate with `sudo` when root privileges are required.
+- If your environment blocks interactive `sudo`, use explicit fallback:
+  - `sudo <node-bin> <codeharbor-cli-script> service ...`
+
 Enable Admin service at install time:
 
 ```bash
@@ -347,9 +353,10 @@ Note: `PUT /api/admin/config/global` writes to `.env` and marks changes as resta
 1. Start server: `codeharbor admin serve`.
 2. Open `/settings/global`, set `Admin Token` (if enabled), then click `Save Auth`.
 3. Adjust global fields and click `Save Global Config` (UI shows restart-required warning).
-4. Open `/settings/rooms`, fill `Room ID + Workdir`, then `Save Room`.
-5. Open `/health` to run connectivity checks (`codex` + Matrix).
-6. Open `/audit` to verify config revisions (actor/summary/payload).
+4. Use `Restart Main Service` or `Restart Main + Admin` buttons for one-click restart from Admin UI (requires root-capable service context).
+5. Open `/settings/rooms`, fill `Room ID + Workdir`, then `Save Room`.
+6. Open `/health` to run connectivity checks (`codex` + Matrix).
+7. Open `/audit` to verify config revisions (actor/summary/payload).
 
 ## Standalone Admin Deployment
 
@@ -391,6 +398,17 @@ If any check fails, it prints actionable fix commands (for example `codeharbor i
   - `/status` show session + limiter + metrics + runtime worker status
   - `/reset` clear bound Codex session and keep conversation active
   - `/stop` cancel in-flight execution (if running) and reset session context
+  - `/agents status` show multi-agent workflow status for current session (when enabled)
+  - `/agents run <objective>` run Planner -> Executor -> Reviewer workflow (when enabled)
+
+### Multi-Agent Workflow (Phase B, Opt-In)
+
+- `AGENT_WORKFLOW_ENABLED=true`
+  - enable `/agents` workflow commands
+- `AGENT_WORKFLOW_AUTO_REPAIR_MAX_ROUNDS`
+  - reviewer reject loop upper bound (default `1`)
+
+Default is disabled to keep legacy behavior unchanged.
 
 ## CLI Compatibility Mode