@osfactory/har 0.62.2 → 0.64.0
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.
- package/LICENSE +0 -19
- package/README.md +3 -2
- package/dist/index.js +2388 -1211
- package/dist/templates/agent-skills/setup-har.md +20 -6
- package/dist/templates/agent-skills/skills.manifest.json +1 -1
- package/package.json +13 -4
|
@@ -14,7 +14,21 @@ If missing, install it and re-check:
|
|
|
14
14
|
npm install -g @osfactory/har
|
|
15
15
|
```
|
|
16
16
|
|
|
17
|
-
## 2.
|
|
17
|
+
## 2. Check Docker
|
|
18
|
+
|
|
19
|
+
Docker is required: Mission Control runs as a container and harness infrastructure
|
|
20
|
+
(databases, queues, browsers) starts through Docker Compose.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
docker info
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
If the command fails, tell the user Docker must be installed and running
|
|
27
|
+
(https://docs.docker.com/get-started/get-docker/). You can still scaffold the
|
|
28
|
+
harness, but say clearly that Mission Control and containerized infra stay
|
|
29
|
+
unavailable until Docker works.
|
|
30
|
+
|
|
31
|
+
## 3. Pick a harness profile
|
|
18
32
|
|
|
19
33
|
Inspect the repository and choose the profile that matches how agents will run it:
|
|
20
34
|
|
|
@@ -26,7 +40,7 @@ Inspect the repository and choose the profile that matches how agents will run i
|
|
|
26
40
|
|
|
27
41
|
Tell the user which profile you picked and why before continuing.
|
|
28
42
|
|
|
29
|
-
##
|
|
43
|
+
## 4. Initialize the harness
|
|
30
44
|
|
|
31
45
|
```bash
|
|
32
46
|
har env init --profile <profile> # omit --profile for default
|
|
@@ -34,11 +48,11 @@ har env init --profile <profile> # omit --profile for default
|
|
|
34
48
|
|
|
35
49
|
If `.har/` already exists, stop and suggest `/har-maintain` instead.
|
|
36
50
|
|
|
37
|
-
##
|
|
51
|
+
## 5. Perform the adaptation yourself
|
|
38
52
|
|
|
39
53
|
`har env init` prints an adaptation prompt and writes it to `.har/ADAPT-PROMPT.md`. Read that file and **execute its instructions yourself, now, in this session** — tailor `.har/` scripts (`launch.sh`, `verify.sh`, `setup-infra.sh`, `harness.env`, `stages.json`) and `AGENTS.md` to this repository's real stack, ports, and commands.
|
|
40
54
|
|
|
41
|
-
##
|
|
55
|
+
## 6. Register the project's checks as stages
|
|
42
56
|
|
|
43
57
|
Convert the repository's real check commands (test, lint, typecheck, whatever CI runs) into registered stages so they run in `verify --full` and are visible to every agent. Read `.har/STAGES.md` for the contract, then:
|
|
44
58
|
|
|
@@ -49,7 +63,7 @@ har env add-stage unit-tests --custom --kind test --command "npm test" --verific
|
|
|
49
63
|
- Use `--command` for one-liner checks; use `--script` when a check needs the slot's env, ports, or artifacts (then implement the scaffolded `.har/stages/<id>.sh`).
|
|
50
64
|
- Rich integrations ship as **plugins**: `har env add-plugin --list`, then e.g. `har env add-plugin playwright` (web) or `har env add-plugin rocketsim` (iOS). Plugins install stages; agents only talk to the stage registry.
|
|
51
65
|
|
|
52
|
-
##
|
|
66
|
+
## 7. Prove the harness works
|
|
53
67
|
|
|
54
68
|
```bash
|
|
55
69
|
har env launch 1
|
|
@@ -58,7 +72,7 @@ har env verify 1
|
|
|
58
72
|
|
|
59
73
|
Fix the harness scripts until both pass. Then tear down or keep the slot as the user prefers (`har env teardown 1` keeps the branch).
|
|
60
74
|
|
|
61
|
-
##
|
|
75
|
+
## 8. Commit
|
|
62
76
|
|
|
63
77
|
After the user confirms, commit the harness:
|
|
64
78
|
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"name": "setup-har",
|
|
11
11
|
"description": "Install the har CLI and scaffold the .har/ agent harness in this repository (init, adapt, launch, verify, commit). User-invoked onboarding.",
|
|
12
12
|
"disable-model-invocation": true,
|
|
13
|
-
"allowed-tools": "Bash(har *) Bash(npm *) Bash(git *) Read Grep Glob Edit Write"
|
|
13
|
+
"allowed-tools": "Bash(har *) Bash(npm *) Bash(git *) Bash(docker *) Read Grep Glob Edit Write"
|
|
14
14
|
}
|
|
15
15
|
},
|
|
16
16
|
"cursor": { "command": true },
|
package/package.json
CHANGED
|
@@ -1,14 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@osfactory/har",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.64.0",
|
|
4
|
+
"description": "HAR: open agent harness CLI and MCP server for coding agents, isolated worktrees, and software-factory workflows",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"har",
|
|
7
|
+
"harness",
|
|
8
|
+
"agent-harness",
|
|
7
9
|
"cli",
|
|
8
10
|
"mcp",
|
|
11
|
+
"mcp-server",
|
|
9
12
|
"agent",
|
|
10
|
-
"
|
|
11
|
-
"
|
|
13
|
+
"coding-agent",
|
|
14
|
+
"coding-agents",
|
|
15
|
+
"software-factory",
|
|
16
|
+
"worktree",
|
|
17
|
+
"claude-code",
|
|
18
|
+
"cursor",
|
|
19
|
+
"devops",
|
|
20
|
+
"typescript"
|
|
12
21
|
],
|
|
13
22
|
"bin": {
|
|
14
23
|
"har": "dist/index.js"
|