@osfactory/har 0.42.0 → 0.43.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -29,9 +29,10 @@ Prefer **HAR MCP tools** (Cursor) or **`har env launch/verify/complete`** — th
29
29
  Use `./.har/*.sh` only when the CLI is not installed.
30
30
 
31
31
  When the work is done: full verify, commit in the session worktree, then present a
32
- **session handoff** and wait for the user before `har env complete <id>` /
33
- `har_complete_environment` (recommended finish: validation + teardown, branch kept),
34
- push, or opening a PR. See `.cursor/rules/har-workflow.mdc` for the handoff template.
32
+ **session handoff** and wait for the user. The **default recommendation** is
33
+ complete + open a PR when `gh`/GitHub MCP is available (still requires approval);
34
+ alternatives are complete-only or something else. See
35
+ `.cursor/rules/har-workflow.mdc` for the handoff template.
35
36
 
36
37
  ## Commit gate
37
38
 
@@ -64,13 +64,15 @@ UI changes with Playwright: update specs under `tests/` (full verify includes br
64
64
  ## Session handoff (required)
65
65
 
66
66
  After full verify and commit, stop. Include summary, session branch
67
- (`.har/slots/agent-<id>.json`), and preview URLs. Propose: (1) complete the slot
68
- (`har env complete` / `har_complete_environment` — branch kept), (2) open a PR if
69
- `gh`/GitHub MCP is available, or (3) something else. Wait for the user — never
70
- autonomously complete, teardown, push, or open a PR.
67
+ (`.har/slots/agent-<id>.json`), and preview URLs. Wait — never autonomously
68
+ complete, teardown, push, or open a PR. **Default (1 is the default):** when
69
+ `gh`/GitHub MCP is available, recommend **Complete + open a PR** — push → open
70
+ PR → `har env complete` / `har_complete_environment` (branch kept). Still needs
71
+ approval. Alternatives: **Complete only**, or **Something else**. Without PR
72
+ tooling, recommend **Complete only** and give the session branch for a manual push.
71
73
 
72
74
  ## Commit gate
73
75
 
74
76
  Full verify records a tree hash under `.har/validations/`. With `har hooks install`,
75
- commits must match a passing full verify. Re-verify after any edit; `git add -A` the
76
- verified tree. Do not bypass (`--no-verify`, `HAR_SKIP_GATE=1`).
77
+ commits must match a passing full verify. Re-verify after any edit; `git add -A`.
78
+ Do not bypass (`--no-verify`, `HAR_SKIP_GATE=1`).
@@ -44,15 +44,17 @@ is alive; it does not automatically mean an agent can use the app.
44
44
  - [ ] Changes committed **in the session worktree** with a clear message
45
45
  - [ ] The user got the preview URLs to test the app themselves
46
46
  - [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
47
- - [ ] On user approval: `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
47
+ - [ ] 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
48
48
 
49
49
  ### Session handoff
50
50
 
51
51
  After full verify and commit, stop and propose next steps. Never autonomously run
52
- `complete`, `teardown`, `git push`, or open a PR. Prefer `complete` over bare
53
- `teardown` when the work succeeded. Offer a PR only if `gh` or GitHub MCP is
54
- available (and only after explicit approval); otherwise report the session branch
55
- for a manual push. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
52
+ `complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
53
+ `gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
54
+ `har env complete` / `har_complete_environment`). Offer complete-only or something
55
+ else as alternatives. If PR tooling is unavailable, recommend complete and report
56
+ the session branch for a manual push. Prefer `complete` over bare `teardown` when
57
+ the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
56
58
 
57
59
  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).
58
60
 
@@ -30,15 +30,17 @@ workflow, document the required credentials/default data and wire a smoke into
30
30
  - [ ] New behavior has automated test coverage
31
31
  - [ ] Changes committed **in the session worktree** with a clear message
32
32
  - [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
33
- - [ ] On user approval: `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
33
+ - [ ] 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
34
34
 
35
35
  ### Session handoff
36
36
 
37
37
  After full verify and commit, stop and propose next steps. Never autonomously run
38
- `complete`, `teardown`, `git push`, or open a PR. Prefer `complete` over bare
39
- `teardown` when the work succeeded. Offer a PR only if `gh` or GitHub MCP is
40
- available (and only after explicit approval); otherwise report the session branch
41
- for a manual push. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
38
+ `complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
39
+ `gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
40
+ `har env complete` / `har_complete_environment`). Offer complete-only or something
41
+ else as alternatives. If PR tooling is unavailable, recommend complete and report
42
+ the session branch for a manual push. Prefer `complete` over bare `teardown` when
43
+ the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
42
44
 
43
45
  Quick loop: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}`
44
46
 
@@ -32,15 +32,17 @@ seeded data, or a simulator flow, document it here and wire the smoke into
32
32
  - [ ] New behavior has automated test coverage (unit tests via XCTest)
33
33
  - [ ] Changes committed **in the session worktree** with a clear message
34
34
  - [ ] Present session handoff (summary, branch, preview URLs) and **wait for user** before `complete`, push, or PR
35
- - [ ] On user approval: `har env complete ${AGENT_ID}` (or MCP `har_complete_environment`) — full verify + validation + teardown, branch kept
35
+ - [ ] 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
36
36
 
37
37
  ### Session handoff
38
38
 
39
39
  After full verify and commit, stop and propose next steps. Never autonomously run
40
- `complete`, `teardown`, `git push`, or open a PR. Prefer `complete` over bare
41
- `teardown` when the work succeeded. Offer a PR only if `gh` or GitHub MCP is
42
- available (and only after explicit approval); otherwise report the session branch
43
- for a manual push. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
40
+ `complete`, `teardown`, `git push`, or open a PR. **Default recommendation:** when
41
+ `gh` or GitHub MCP is available, complete the slot **and** open a PR (push → PR →
42
+ `har env complete` / `har_complete_environment`). Offer complete-only or something
43
+ else as alternatives. If PR tooling is unavailable, recommend complete and report
44
+ the session branch for a manual push. Prefer `complete` over bare `teardown` when
45
+ the work succeeded. See `.cursor/rules/har-workflow.mdc` for the handoff shape.
44
46
 
45
47
  Quick loop: MCP `har_run_verification`, `har env verify ${AGENT_ID}`, or `./.har/verify.sh ${AGENT_ID}`
46
48
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@osfactory/har",
3
- "version": "0.42.0",
3
+ "version": "0.43.1",
4
4
  "description": "LLM-powered CLI for reproducible agent development environments",
5
5
  "keywords": [
6
6
  "har",