@osfactory/har 0.19.0 → 0.21.0

package/README.md

@@ -14,6 +14,10 @@ HAR is an open-source CLI and MCP control plane for project-owned development ha
 
 HAR does not own the coding LLM and does not replace CI/CD. It gives agents a stable, machine-readable way to use the workflow your team already trusts.
 
+Planning tools decide what to build. HAR binds that durable work identity to an
+isolated execution attempt and verifiable evidence: runs, artifacts, telemetry,
+and the exact Git tree that passed.
+
 ## How It Works
 
 1. **Project-owned harness** — `.har/` contains editable scripts, docs, environment metadata, logs, artifacts, and optional stage definitions.
@@ -22,6 +26,9 @@ HAR does not own the coding LLM and does not replace CI/CD. It gives agents a st
 4. **Generic stages** — setup, launch, verify, test, inspect, reset, teardown, and custom stages expose normalized status, logs, durations, artifacts, and URLs.
 5. **Configurable agent slots** — parallel environment limits are defined in `.har/stages.json` (`agentSlots`) and `.har/harness.env`, not by the HAR CLI.
 6. **Optional stage templates** — add workflows like Playwright with `har env add-stage playwright`. They compile to generic stages (`test`, `custom`, etc.), not hardcoded HAR APIs.
+7. **Durable work evidence** — optionally launch with `--work-id` so slot sessions, retries, cost, and exact-tree validations remain attributable after teardown.
+
+![Mission Control Factory overview](docs/public/assets/factory-overview.png)
 
 ## Install
 
@@ -80,6 +87,13 @@ har env launch 1
 har env verify 1
 ```
 
+To correlate execution with an issue or ticket:
+
+```bash
+har env launch 1 --work-id "github:acme/widget#123" --work-source github
+har env complete 1
+```
+
 Shell fallback when the CLI is not installed: `./.har/setup-infra.sh`, `./.har/launch.sh 1`, `./.har/verify.sh 1`.
 
 See [Harness profiles](#harness-profiles) above if your repo is a CLI/library or iOS app rather than a web app.
@@ -175,6 +189,7 @@ See `.har/stages/PLAYWRIGHT.md` in the target repo after applying the template.
 | `har env teardown 1` | Tear down agent slot 1 |
 | `har agents install` | Scaffold agent skills (`/setup-har`, `/har-wt`, `/har-maintain`) for Claude Code / Cursor / Codex |
 | `har agents remove` | Remove har-managed agent skill files |
+| `har preferences configure` | Select user defaults for rules, skills, and commit-gate onboarding |
 | `har hooks install` | Install the git commit gate (`--claude` for the Claude Code worktree guard) |
 | `har control up` | Start local Mission Control dashboard (Docker Compose) |
 | `har control register` | Register a repo with Mission Control |
@@ -182,7 +197,8 @@ See `.har/stages/PLAYWRIGHT.md` in the target repo after applying the template.
 | `har control watch` | Continuously sync registered repos |
 | `har mcp` | Start the HAR MCP server (stdio) |
 
-Options: `--force`, `--auto` (built-in Claude adaptation), `--smoke`, `--yes` (auto-apply AGENT.md with `--auto`), `--verbose`, `--profile <default|cli|ios>`
+Options: `--force`, `--auto` (built-in Claude adaptation), `--smoke`, `--yes`
+(accept recommended onboarding actions), `--verbose`, `--profile <default|cli|ios>`
 
 ## MCP Surface