@osfactory/har 0.3.0 → 0.5.0

package/README.md

@@ -39,11 +39,37 @@ npm install && npm run build && npm link
 
 See [AGENT.md](./AGENT.md) for architecture and coding-agent guidance, and [CONTRIBUTING.md](./CONTRIBUTING.md) for the full development workflow, testing on sample projects, and project layout. To report security issues, see [SECURITY.md](./SECURITY.md).
 
+## Harness profiles
+
+`har env init` scaffolds `.har/` from a boilerplate profile. Pick the one that matches what agents need to run — you only choose this once at init time.
+
+| Profile | Best for | What you get |
+|---------|----------|--------------|
+| `default` | Web apps (Next.js, Rails, Django, etc.) | Docker Compose for shared infra, PM2 for the primary app, per-slot ports and preview URLs |
+| `cli` | CLI tools, libraries, npm packages | No PM2 or port wiring — agents run project commands in an isolated git worktree; optional Docker for databases |
+| `ios` | iOS / Swift mobile apps | xcodebuild + iOS Simulator; configure scheme, project, and simulator in `harness.env` |
+
+```bash
+# Web app (default — omit --profile)
+cd my-web-app && har env init
+
+# CLI tool or library
+cd my-cli && har env init --profile cli
+
+# iOS app
+cd MyApp && har env init --profile ios
+har env add-stage rocketsim   # optional: UI flow validation on the simulator
+```
+
+After init, paste the printed adaptation prompt into your coding agent to tailor scripts to your stack. For built-in Claude adaptation: `har env init --auto` (requires `ANTHROPIC_API_KEY`).
+
+Optional stage templates depend on the profile: `har env add-stage playwright` for browser E2E on web apps, `har env add-stage rocketsim` for simulator user-flow checks on iOS.
+
 ## Quick start
 
 ```bash
 cd my-app
-har env init
+har env init                  # or --profile cli / --profile ios
 
 # Paste the printed prompt into your coding agent to adapt .har/ and AGENT.md
 git add .har/ AGENT.md
@@ -55,7 +81,7 @@ har env verify 1
 
 Shell fallback when the CLI is not installed: `./.har/setup-infra.sh`, `./.har/launch.sh 1`, `./.har/verify.sh 1`.
 
-For built-in Claude adaptation (requires `ANTHROPIC_API_KEY`): `har env init --auto`.
+See [Harness profiles](#harness-profiles) above if your repo is a CLI/library or iOS app rather than a web app.
 
 ## Repo layout after init
 
@@ -114,7 +140,7 @@ 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 cli`
+Options: `--force`, `--auto` (built-in Claude adaptation), `--smoke`, `--yes` (auto-apply AGENT.md with `--auto`), `--verbose`, `--profile <default|cli|ios>`
 
 ## MCP Surface
 

package/dist/index.js

@@ -27244,7 +27244,7 @@ function patchStageRegistry(repoPath, manifest, force) {
   if (verifyIdx >= 0) {
     stages[verifyIdx] = {
       ...stages[verifyIdx],
-      description: "Verification pipeline (quick by default; --full adds lint and browser-e2e when installed)",
+      description: "Verification pipeline (quick smoke by default; --full adds tests, lint, and browser-e2e when installed)",
       acceptsArgs: ["--full"]
     };
   }

package/dist/templates/adaptation-prompt-init.md

@@ -42,7 +42,21 @@ Primary app, ports, `HARNESS_INFRA_SERVICES`, migrate/seed commands, health chec
 PM2 processes for the primary application only, matching how it runs in dev. Skip entirely for the CLI profile.
 
 ### `.har/verify.sh`
-Real typecheck, lint, test, and health check commands — replace all TODOs.
+Adapt verification for this repository's toolchain. Step lists in the template are
+**examples, not exhaustive** — add, remove, or reorder `run_step` calls to match
+how this project is built and tested.
+
+**Tier contract:**
+
+| Mode | Command | Intent |
+|------|---------|--------|
+| Quick (default) | `har env verify 1` | Smoke — compile / import / build / health only |
+| Full | `har env verify 1 --full` | Stricter — unit tests, lint, readiness, optional browser-e2e |
+
+- **Quick** must stay fast and minimal (syntax, compile, import smoke) — not the full test suite.
+- **Full** holds unit tests, lint, and heavier checks; optional Playwright runs on `--full` when installed.
+- Reuse real commands from `package.json`, `Makefile`, CI, `pyproject.toml`, etc.
+- Replace all TODO placeholders in both tiers.
 
 ### Readiness vs liveness (required)
 Do not treat a passing health check as adaptation complete. Before finishing,

package/dist/templates/har-boilerplate/README.md

@@ -20,7 +20,7 @@ Generated and maintained by [`har`](https://github.com/antoineFrau/har). Run `ha
 | `agent-slot.sh` | Shared agent-id validation (reads limits from `harness.env`) |
 | `setup-infra.sh` | Start shared Docker infra + create template database |
 | `launch.sh` | Launch one agent slot (ports, DB clone, PM2 processes) |
-| `verify.sh` | Verification pipeline (typecheck, tests, health) |
+| `verify.sh` | Verification pipeline (smoke by default; --full adds tests, lint, e2e) |
 | `teardown.sh` | Tear down one agent slot |
 | `agent-cli.sh` | Manage a running agent (status, logs, psql, health) |
 | `attach.sh` | Attach to agent tmux session |
@@ -49,8 +49,8 @@ In Cursor with HAR MCP configured: use `har_launch_environment`, `har_run_verifi
 ```bash
 ./.har/setup-infra.sh          # when HARNESS_INFRA_SERVICES is non-empty
 ./.har/launch.sh 1
-./.har/verify.sh 1             # quick: typecheck, tests, health
-./.har/verify.sh 1 --full      # done gate: + lint + browser-e2e (if Playwright stage installed)
+./.har/verify.sh 1             # quick: smoke (typecheck + health)
+./.har/verify.sh 1 --full      # + unit tests, lint, browser-e2e (if Playwright stage installed)
 ./.har/teardown.sh 1
 ```
 
@@ -58,10 +58,14 @@ Read **`stages.json`** for registered stages and **`verificationStages`** for th
 
 ## Verification contract
 
+Steps in `verify.sh` are **project-specific examples** — adapt them to your stack
+during `har env init` / `har env maintain`. The table describes each tier's intent,
+not a fixed command list.
+
 | Mode | Command | Typical steps |
 |------|---------|---------------|
-| Quick | `har env verify <id>` or `verify.sh <id>` | Project checks in `verify.sh` (stops early on failure) |
-| Full | `har env verify <id> --full` or `verify.sh <id> --full` | Quick steps + lint + optional readiness smoke + **`browser-e2e`** when `.har/stages/browser-e2e.sh` exists |
+| Quick | `har env verify <id>` or `verify.sh <id>` | Smoke: compile / typecheck / health (stops early on failure) |
+| Full | `har env verify <id> --full` or `verify.sh <id> --full` | + unit tests, lint, optional readiness smoke + **`browser-e2e`** when `.har/stages/browser-e2e.sh` exists |
 
 Install Playwright stage: `har env add-stage playwright` (optional). UI changes should add or update specs under `tests/`.
 

package/dist/templates/har-boilerplate/verify.sh

@@ -3,6 +3,10 @@
 # Outputs JSON to stdout, human-readable progress to stderr.
 #
 # Usage: ./.har/verify.sh <agent-id> [--full]
+#
+# Quick (default): smoke — compile / typecheck / health only
+# Full (--full):   + unit tests, lint, optional readiness + browser-e2e
+# Step lists are examples — not exhaustive. Adapt commands to this repo's stack.
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -133,14 +137,16 @@ process.stdout.write(JSON.stringify(arr));
 }
 
 # ── Verification stages ─────────────────────────────────────────────────────
-# TODO: Customize these steps for your project.
+# Customize these steps for your project — lists below are examples, not exhaustive.
 # Edit this section directly — do not use a separate config file.
 
+# Quick (default): smoke — prove the slot can compile/load, not full test suites.
 run_step "typecheck" "echo 'TODO: npm run typecheck'" || { [ -z "$FULL" ] && true; }
-run_step "unit-tests" "echo 'TODO: npm test'" || { [ -z "$FULL" ] && true; }
 run_http_step "api-health" "http://localhost:${API_PORT}${HARNESS_HEALTH_CHECK_PATH}" || { [ -z "$FULL" ] && true; }
 
 if [ -n "$FULL" ]; then
+  # Full: project-specific checks — add/remove/reorder steps for this repo.
+  run_step "unit-tests" "echo 'TODO: npm test'" || true
   run_step "lint" "echo 'TODO: npm run lint'" || true
   run_step "readiness" "run_readiness_if_configured \"$AGENT_ID\"" || true
   run_step "browser-e2e" "run_browser_e2e_if_present \"$SCRIPT_DIR\" \"$AGENT_ID\"" || true

package/dist/templates/har-boilerplate-cli/README.md

@@ -20,7 +20,7 @@ Generated and maintained by [`har`](https://github.com/antoineFrau/har). Run `ha
 | `agent-slot.sh` | Shared agent-id validation (reads limits from `harness.env`) |
 | `setup-infra.sh` | Start optional Docker Compose stack + template database |
 | `launch.sh` | Launch one agent slot (git worktree by default, deps, env file) |
-| `verify.sh` | Verification pipeline (typecheck, tests, lint, build) |
+| `verify.sh` | Verification pipeline (smoke by default; --full adds tests, lint, e2e) |
 | `teardown.sh` | Tear down one agent slot (worktree + env file) |
 | `agent-cli.sh` | Inspect slot status, run commands in the work dir |
 | `docker-compose.agent.yml` | Shared infrastructure containers (services listed in `HARNESS_INFRA_SERVICES`) |
@@ -47,8 +47,8 @@ In Cursor with HAR MCP configured: use `har_launch_environment`, `har_run_verifi
 ```bash
 ./.har/setup-infra.sh          # when HARNESS_INFRA_SERVICES is non-empty
 ./.har/launch.sh 1
-./.har/verify.sh 1
-./.har/verify.sh 1 --full      # + lint, build, browser-e2e (if Playwright installed)
+./.har/verify.sh 1             # quick: smoke (typecheck + build)
+./.har/verify.sh 1 --full      # + unit tests, lint, browser-e2e (if Playwright installed)
 ./.har/teardown.sh 1
 ```
 
@@ -56,10 +56,14 @@ Read **`stages.json`** and **`verificationStages`**. Optional: `har env add-stag
 
 ## Verification contract
 
+Steps in `verify.sh` are **project-specific examples** — adapt them to your stack
+during `har env init` / `har env maintain` / benchmark setup. The table describes
+each tier's intent, not a fixed command list.
+
 | Mode | Command | Typical steps |
 |------|---------|---------------|
-| Quick | `har env verify <id>` or `verify.sh <id>` | typecheck, unit tests |
-| Full | `har env verify <id> --full` or `verify.sh <id> --full` | + lint, optional readiness smoke, **browser-e2e** when `stages/browser-e2e.sh` exists |
+| Quick | `har env verify <id>` or `verify.sh <id>` | Smoke: compile / typecheck / build (language-agnostic) |
+| Full | `har env verify <id> --full` or `verify.sh <id> --full` | + unit tests, lint, optional readiness smoke, **browser-e2e** when `stages/browser-e2e.sh` exists |
 
 For repos that need runtime services, distinguish health from usability. If the
 harness skips slow local-dev setup, document the skipped steps and add a minimal

package/dist/templates/har-boilerplate-cli/verify.sh

@@ -1,8 +1,12 @@
 #!/usr/bin/env bash
-# Verification pipeline for CLI/library repos — typecheck, test, lint, build.
+# Verification pipeline for CLI/library repos.
 # Outputs JSON to stdout, human-readable progress to stderr.
 #
 # Usage: ./.har/verify.sh <agent-id> [--full]
+#
+# Quick (default): smoke — compile / typecheck / build only
+# Full (--full):   + unit tests, lint, optional readiness + browser-e2e
+# Step lists are examples — not exhaustive. Adapt commands to this repo's stack.
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -89,12 +93,15 @@ process.stdout.write(JSON.stringify(arr));
   fi
 }
 
+# ── Quick (default): smoke only ──────────────────────────────────────────────
+# Customize for this repo: compile / import / build — not the full test suite.
 run_step "typecheck" "npm run typecheck" || { [ -z "$FULL" ] && true; }
 # Some unit tests exec dist/index.js (e.g. stage-templates CLI add-stage).
 run_step "build" "npm run build" || { [ -z "$FULL" ] && true; }
-run_step "unit-tests" "npm test" || { [ -z "$FULL" ] && true; }
 
 if [ -n "$FULL" ]; then
+  # ── Full: project-specific checks (examples — add/remove/reorder as needed) ─
+  run_step "unit-tests" "npm test" || true
   run_step "lint" "npm run lint" || true
   run_step "readiness" "run_readiness_if_configured \"$AGENT_ID\"" || true
   run_step "browser-e2e" "run_browser_e2e_if_present \"$SCRIPT_DIR\" \"$AGENT_ID\"" || true

package/dist/templates/har-boilerplate-ios/README.md

@@ -20,7 +20,7 @@ Generated and maintained by [`har`](https://github.com/antoineFrau/har). Run `ha
 | `agent-slot.sh` | Shared agent-id validation and slot registry helpers |
 | `setup-infra.sh` | Boot the iOS Simulator; start optional Docker services |
 | `launch.sh` | Launch one agent slot (git worktree, CocoaPods/SPM deps, env file) |
-| `verify.sh` | Verification pipeline (build + unit-tests; --full adds lint + user-flow validation) |
+| `verify.sh` | Verification pipeline (build smoke by default; --full adds tests, lint, flows) |
 | `teardown.sh` | Tear down one agent slot (worktree + env file) |
 | `agent-cli.sh` | Inspect slot status, run xcodebuild commands, install/launch app |
 | `docker-compose.agent.yml` | Optional shared backend services |
@@ -47,8 +47,8 @@ In Cursor with HAR MCP configured: use `har_launch_environment`, `har_run_verifi
 ```bash
 ./.har/setup-infra.sh          # boots the iOS Simulator
 ./.har/launch.sh 1
-./.har/verify.sh 1             # build + unit-tests
-./.har/verify.sh 1 --full      # + lint + rocketsim-flows (if installed)
+./.har/verify.sh 1             # quick: build smoke (compile-only)
+./.har/verify.sh 1 --full      # + unit tests, lint, rocketsim-flows (if installed)
 ./.har/teardown.sh 1
 ```
 
@@ -64,10 +64,13 @@ This installs `.har/stages/rocketsim-flows.sh` and a `flows/` directory. Add flo
 
 ## Verification contract
 
+Steps in `verify.sh` are **project-specific examples** — adapt them to your stack.
+The table describes each tier's intent, not a fixed command list.
+
 | Mode | Command | Typical steps |
 |------|---------|---------------|
-| Quick | `har env verify <id>` | build, unit-tests |
-| Full | `har env verify <id> --full` | + lint, optional readiness smoke, **rocketsim-flows** when installed |
+| Quick | `har env verify <id>` | build smoke (compile-only) |
+| Full | `har env verify <id> --full` | + unit tests, lint, optional readiness smoke, **rocketsim-flows** when installed |
 
 For apps that depend on local backends, auth, seeded state, or simulator flows,
 distinguish build/test health from agent usability. Document any skipped full

package/dist/templates/har-boilerplate-ios/verify.sh

@@ -4,8 +4,9 @@
 #
 # Usage: ./.har/verify.sh <agent-id> [--full]
 #
-# Quick (default): build + unit-tests
-# Full (--full):   + lint (SwiftLint) + rocketsim-flows (if installed)
+# Quick (default): build smoke (compile-only)
+# Full (--full):   + unit tests, lint (SwiftLint), rocketsim-flows (if installed)
+# Step lists are examples — not exhaustive. Adapt commands to this repo's stack.
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -114,7 +115,7 @@ process.stdout.write(JSON.stringify(arr));
   fi
 }
 
-# Build (compile-only — catches syntax errors and missing symbols)
+# Quick (default): compile-only — catches syntax errors and missing symbols
 run_step "build" "xcodebuild build \
   ${XC_FLAGS} \
   -scheme \"${XC_SCHEME}\" \
@@ -128,21 +129,21 @@ run_step "build" "xcodebuild build \
     -derivedDataPath \"${XC_DERIVED}\" \
     CODE_SIGNING_ALLOWED=NO" || { [ -z "$FULL" ] && true; }
 
-# Unit tests
-run_step "unit-tests" "xcodebuild test \
-  ${XC_FLAGS} \
-  -scheme \"${XC_SCHEME}\" \
-  -destination \"${XC_DESTINATION}\" \
-  -derivedDataPath \"${XC_DERIVED}\" \
-  CODE_SIGNING_ALLOWED=NO \
-  | xcbeautify 2>/dev/null || xcodebuild test \
+if [ -n "$FULL" ]; then
+  # Full: project-specific checks — add/remove/reorder steps for this repo.
+  run_step "unit-tests" "xcodebuild test \
     ${XC_FLAGS} \
     -scheme \"${XC_SCHEME}\" \
     -destination \"${XC_DESTINATION}\" \
     -derivedDataPath \"${XC_DERIVED}\" \
-    CODE_SIGNING_ALLOWED=NO" || { [ -z "$FULL" ] && true; }
+    CODE_SIGNING_ALLOWED=NO \
+    | xcbeautify 2>/dev/null || xcodebuild test \
+      ${XC_FLAGS} \
+      -scheme \"${XC_SCHEME}\" \
+      -destination \"${XC_DESTINATION}\" \
+      -derivedDataPath \"${XC_DERIVED}\" \
+      CODE_SIGNING_ALLOWED=NO" || true
 
-if [ -n "$FULL" ]; then
   # SwiftLint — optional, skip gracefully when not installed
   run_step "lint" "command -v \"${HARNESS_SWIFTLINT_CMD:-swiftlint}\" >/dev/null 2>&1 && \
     \"${HARNESS_SWIFTLINT_CMD:-swiftlint}\" --quiet 2>&1 || echo 'swiftlint not installed — skipping'" || true

package/package.json

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