@osfactory/har 0.9.0 → 0.10.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/README.md +31 -0
- package/dist/index.js +1019 -563
- package/dist/templates/agent-skills/har-maintain.md +34 -0
- package/dist/templates/agent-skills/har-wt.md +47 -0
- package/dist/templates/agent-skills/setup-har.md +59 -0
- package/dist/templates/agent-skills/skills.manifest.json +48 -0
- package/dist/templates/claude-worktree-guard.sh.template +38 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -83,6 +83,34 @@ Shell fallback when the CLI is not installed: `./.har/setup-infra.sh`, `./.har/l
|
|
|
83
83
|
|
|
84
84
|
See [Harness profiles](#harness-profiles) above if your repo is a CLI/library or iOS app rather than a web app.
|
|
85
85
|
|
|
86
|
+
## Agent skills (/setup-har, /har-wt, /har-maintain)
|
|
87
|
+
|
|
88
|
+
`har env init` can scaffold **project-owned skills/commands** for coding agents, so the har workflow is one slash command away for every teammate who clones the repo:
|
|
89
|
+
|
|
90
|
+
| Skill | Who invokes it | What it does |
|
|
91
|
+
|-------|----------------|--------------|
|
|
92
|
+
| `/setup-har` | You, once | Installs har if missing, picks a profile, runs `har env init`, performs the adaptation prompt itself, proves launch + verify, commits |
|
|
93
|
+
| `/har-wt` | The agent, on every coding task | Launches a harness slot, does all edits in the session worktree (never the main checkout), verifies through the harness |
|
|
94
|
+
| `/har-maintain` | You, when the harness drifts | Runs `har env maintain`, applies the adaptation, finalizes and re-verifies |
|
|
95
|
+
|
|
96
|
+
Targets are auto-detected at `init`/`maintain` (or forced with `--agents claude,cursor,codex`); you can also manage them standalone:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
har agents install --claude --cursor # .claude/skills/ + .cursor/commands/ (committed to the repo)
|
|
100
|
+
har agents install --codex # ~/.codex/prompts/ (global — Codex has no per-repo prompts)
|
|
101
|
+
har agents remove --claude
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
Scaffolded files carry a `managed by har` header and are refreshed by `har env maintain`; files you edit by hand are left alone.
|
|
105
|
+
|
|
106
|
+
**Optional enforcement (Claude Code):** make `/har-wt` self-triggering instead of memory-dependent —
|
|
107
|
+
|
|
108
|
+
```bash
|
|
109
|
+
har hooks install --claude
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
installs a `PreToolUse` guard (`.har/hooks/claude-worktree-guard.sh` + an entry in `.claude/settings.json`) that blocks `Edit`/`Write` in the **main checkout** of a har repo and points the agent to `/har-wt`. Edits inside session worktrees pass through. Remove with `har hooks uninstall --claude`; humans can bypass with `HAR_SKIP_WT_GUARD=1`.
|
|
113
|
+
|
|
86
114
|
## Repo layout after init
|
|
87
115
|
|
|
88
116
|
```
|
|
@@ -134,6 +162,9 @@ See `.har/stages/PLAYWRIGHT.md` in the target repo after applying the template.
|
|
|
134
162
|
| `har env runs list` | List persisted run history (`--json`) |
|
|
135
163
|
| `har env runs get <runId>` | Fetch one run record |
|
|
136
164
|
| `har env teardown 1` | Tear down agent slot 1 |
|
|
165
|
+
| `har agents install` | Scaffold agent skills (`/setup-har`, `/har-wt`, `/har-maintain`) for Claude Code / Cursor / Codex |
|
|
166
|
+
| `har agents remove` | Remove har-managed agent skill files |
|
|
167
|
+
| `har hooks install` | Install the git commit gate (`--claude` for the Claude Code worktree guard) |
|
|
137
168
|
| `har control up` | Start local Mission Control dashboard (Docker Compose) |
|
|
138
169
|
| `har control register` | Register a repo with Mission Control |
|
|
139
170
|
| `har control sync` | Sync runs + slot status to Mission Control |
|