@osfactory/har 0.42.0 → 0.43.0

package/dist/templates/AGENT.md.template

@@ -29,9 +29,10 @@ Prefer **HAR MCP tools** (Cursor) or **`har env launch/verify/complete`** — th
 Use `./.har/*.sh` only when the CLI is not installed.
 
 When the work is done: full verify, commit in the session worktree, then present a
-**session handoff** and wait for the user before `har env complete <id>` /
-`har_complete_environment` (recommended finish: validation + teardown, branch kept),
-push, or opening a PR. See `.cursor/rules/har-workflow.mdc` for the handoff template.
+**session handoff** and wait for the user. The **default recommendation** is
+complete + open a PR when `gh`/GitHub MCP is available (still requires approval);
+alternatives are complete-only or something else. See
+`.cursor/rules/har-workflow.mdc` for the handoff template.
 
 ## Commit gate
 

package/dist/templates/cursor-rule.mdc.template

@@ -64,13 +64,15 @@ UI changes with Playwright: update specs under `tests/` (full verify includes br
 ## Session handoff (required)
 
 After full verify and commit, stop. Include summary, session branch
-(`.har/slots/agent-<id>.json`), and preview URLs. Propose: (1) complete the slot
-(`har env complete` / `har_complete_environment` — branch kept), (2) open a PR if
-`gh`/GitHub MCP is available, or (3) something else. Wait for the user — never
-autonomously complete, teardown, push, or open a PR.
+(`.har/slots/agent-<id>.json`), and preview URLs. Wait — never autonomously
+complete, teardown, push, or open a PR. **Default (1 is the default):** when
+`gh`/GitHub MCP is available, recommend **Complete + open a PR** — push → open
+PR → `har env complete` / `har_complete_environment` (branch kept). Still needs
+approval. Alternatives: **Complete only**, or **Something else**. Without PR
+tooling, recommend **Complete only** and give the session branch for a manual push.
 
 ## Commit gate
 
 Full verify records a tree hash under `.har/validations/`. With `har hooks install`,
-commits must match a passing full verify. Re-verify after any edit; `git add -A` the
-verified tree. Do not bypass (`--no-verify`, `HAR_SKIP_GATE=1`).
+commits must match a passing full verify. Re-verify after any edit; `git add -A`.
+Do not bypass (`--no-verify`, `HAR_SKIP_GATE=1`).

package/dist/templates/har-boilerplate/CLAUDE.agent.md

@@ -44,15 +44,17 @@ is alive; it does not automatically mean an agent can use the app.
 - [ ] Changes committed **in the session worktree** with a clear message
 - [ ] The user got the preview URLs to test the app themselves
 - [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
-- [ ] On user approval: `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
+- [ ] On user approval of the default: push + open PR (when `gh`/GitHub MCP available), then `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
 
 ### Session handoff
 
 After full verify and commit, stop and propose next steps. Never autonomously run
-`complete`, `teardown`, `git push`, or open a PR. Prefer `complete` over bare
-`teardown` when the work succeeded. Offer a PR only if `gh` or GitHub MCP is
-available (and only after explicit approval); otherwise report the session branch
-for a manual push. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
+`complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
+`gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
+`har env complete` / `har_complete_environment`). Offer complete-only or something
+else as alternatives. If PR tooling is unavailable, recommend complete and report
+the session branch for a manual push. Prefer `complete` over bare `teardown` when
+the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
 
 Quick loop during development: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}` (smoke + health only; `--full` adds the registered verification stages).
 

package/dist/templates/har-boilerplate-cli/CLAUDE.agent.md

@@ -30,15 +30,17 @@ workflow, document the required credentials/default data and wire a smoke into
 - [ ] New behavior has automated test coverage
 - [ ] Changes committed **in the session worktree** with a clear message
 - [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
-- [ ] On user approval: `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
+- [ ] On user approval of the default: push + open PR (when `gh`/GitHub MCP available), then `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
 
 ### Session handoff
 
 After full verify and commit, stop and propose next steps. Never autonomously run
-`complete`, `teardown`, `git push`, or open a PR. Prefer `complete` over bare
-`teardown` when the work succeeded. Offer a PR only if `gh` or GitHub MCP is
-available (and only after explicit approval); otherwise report the session branch
-for a manual push. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
+`complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
+`gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
+`har env complete` / `har_complete_environment`). Offer complete-only or something
+else as alternatives. If PR tooling is unavailable, recommend complete and report
+the session branch for a manual push. Prefer `complete` over bare `teardown` when
+the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
 
 Quick loop: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}`
 

package/dist/templates/har-boilerplate-ios/CLAUDE.agent.md

@@ -32,15 +32,17 @@ seeded data, or a simulator flow, document it here and wire the smoke into
 - [ ] New behavior has automated test coverage (unit tests via XCTest)
 - [ ] Changes committed **in the session worktree** with a clear message
 - [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
-- [ ] On user approval: `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
+- [ ] On user approval of the default: push + open PR (when `gh`/GitHub MCP available), then `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
 
 ### Session handoff
 
 After full verify and commit, stop and propose next steps. Never autonomously run
-`complete`, `teardown`, `git push`, or open a PR. Prefer `complete` over bare
-`teardown` when the work succeeded. Offer a PR only if `gh` or GitHub MCP is
-available (and only after explicit approval); otherwise report the session branch
-for a manual push. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
+`complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
+`gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
+`har env complete` / `har_complete_environment`). Offer complete-only or something
+else as alternatives. If PR tooling is unavailable, recommend complete and report
+the session branch for a manual push. Prefer `complete` over bare `teardown` when
+the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
 
 Quick loop: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "LLM-powered CLI for reproducible agent development environments",
   "keywords": [
     "har",