@osfactory/har 0.4.0 → 0.5.0

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.4.0",
+  "version": "0.5.0",
   "description": "LLM-powered CLI for reproducible agent development environments",
   "keywords": [
     "har",