@osfactory/har 0.10.0 → 0.11.0

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

@@ -5,7 +5,8 @@
 # Usage: ./.har/verify.sh <agent-id> [--full]
 #
 # Quick (default): build smoke (compile-only)
-# Full (--full):   + unit tests, lint (SwiftLint), rocketsim-flows (if installed)
+# Full (--full):   + unit tests, lint (SwiftLint), and every registered stage
+#                  in stages.json verificationStages (see .har/STAGES.md)
 # Step lists are examples — not exhaustive. Adapt commands to this repo's stack.
 set -euo pipefail
 
@@ -150,8 +151,13 @@ if [ -n "$FULL" ]; then
 
   run_step "readiness" "run_readiness_if_configured \"$AGENT_ID\"" || true
 
-  # RocketSim user-flow validation — installed via: har env add-stage rocketsim
-  run_rocketsim_flows_if_present "$SCRIPT_DIR" "$AGENT_ID" || true
+  # Registered verification stages from .har/stages.json (see .har/STAGES.md).
+  # Every stage listed in verificationStages with a registered script/command
+  # runs here -- stage templates and custom stages alike.
+  while IFS=$'\t' read -r STAGE_ID STAGE_CMD; do
+    [ -n "$STAGE_ID" ] || continue
+    run_step "$STAGE_ID" "$STAGE_CMD" || true
+  done < <(list_registered_verification_stage_commands "$SCRIPT_DIR" "$AGENT_ID")
 fi
 
 END_TOTAL=$(now_ms)

package/dist/templates/stage-templates/custom-stage-skeleton.sh

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# __STAGE_DESCRIPTION__
+# Custom HAR stage: __STAGE_ID__ (kind: __STAGE_KIND__)
+#
+# Stage script contract (full reference: .har/STAGES.md):
+#   - stdout: a single JSON result object (status, stageId, agent_id, ...)
+#   - stderr: human-readable progress
+#   - $1: agent slot id; extra args may follow
+#   - artifacts: write reports/screenshots/logs under .har/artifacts/__STAGE_ID__/
+#   - exit code: the real status (0 = pass)
+#
+# Usage: ./.har/stages/__STAGE_ID__.sh <agent-id> [extra args...]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HARNESS_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+REPO_ROOT="$(cd "$HARNESS_DIR/.." && pwd)"
+
+# shellcheck source=/dev/null
+source "$HARNESS_DIR/harness.env"
+# shellcheck source=/dev/null
+source "$HARNESS_DIR/agent-slot.sh"
+
+AGENT_ID="${1:?Usage: __STAGE_ID__.sh <agent-id> [extra args...]}"
+validate_agent_id "$AGENT_ID"
+
+ENV_FILE="$(resolve_agent_env_file "$AGENT_ID" "$REPO_ROOT")" || {
+  echo "No .env.agent.${AGENT_ID} found. Run: ./.har/launch.sh ${AGENT_ID}" >&2
+  exit 1
+}
+set -a
+# shellcheck source=/dev/null
+source "$ENV_FILE"
+set +a
+
+WORK_DIR="$(resolve_agent_work_dir "$ENV_FILE")"
+ARTIFACTS_DIR="$HARNESS_DIR/artifacts/__STAGE_ID__"
+mkdir -p "$ARTIFACTS_DIR"
+
+echo "==> [__STAGE_ID__ agent-${AGENT_ID}] running in ${WORK_DIR}" >&2
+START=$(now_ms)
+
+# ── TODO: implement the stage ────────────────────────────────────────────────
+# Run your checks from $WORK_DIR (the agent's isolated checkout); the slot's
+# ports and env are loaded from $ENV_FILE. Save artifacts to $ARTIFACTS_DIR.
+set +e
+OUTPUT=$(cd "$WORK_DIR" && echo "TODO: implement .har/stages/__STAGE_ID__.sh" && false)
+EXIT_CODE=$?
+set -e
+
+END=$(now_ms)
+STATUS="fail"
+[ "$EXIT_CODE" = "0" ] && STATUS="pass"
+OUTPUT_JSON=$(escape_step_output "$OUTPUT")
+
+node -e "process.stdout.write(JSON.stringify({
+  status: '$STATUS',
+  stageId: '__STAGE_ID__',
+  kind: '__STAGE_KIND__',
+  agent_id: $AGENT_ID,
+  total_ms: $(( END - START )),
+  output: $OUTPUT_JSON
+}, null, 2) + '\n');"
+
+exit "$EXIT_CODE"

package/dist/templates/stage-templates/playwright/template.manifest.json

@@ -40,5 +40,13 @@
   ],
   "merge": {
     "package.json": "package.fragment.json"
-  }
+  },
+  "nextSteps": [
+    "npm install",
+    "npx playwright install",
+    "./.har/launch.sh 1",
+    "./.har/stages/browser-e2e.sh 1",
+    "npx playwright show-report .har/artifacts/browser-e2e/playwright-report"
+  ],
+  "docsPath": ".har/stages/PLAYWRIGHT.md"
 }

package/dist/templates/stage-templates/rocketsim/template.manifest.json

@@ -34,5 +34,6 @@
     "./.har/stages/rocketsim-flows.sh 1",
     "Open .har/artifacts/rocketsim-flows/ for screenshots and per-flow results",
     "Add new flows in flows/ — read .har/stages/ROCKETSIM.md for the authoring guide"
-  ]
+  ],
+  "docsPath": ".har/stages/ROCKETSIM.md"
 }

package/package.json

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