@osfactory/har 0.20.0 → 0.21.0

package/dist/templates/agent-skills/har-wt.md

@@ -21,6 +21,17 @@ har env launch <id>   # or ./.har/launch.sh <id>
 
 Launch creates a fresh session worktree from HEAD and prints its **work dir** (also recorded in `.har/slots/agent-<id>.json`, path like `~/worktrees/<base>-<sha4>-har-agent-<id>-<rand4>`). If a previous launch failed partway, retry with `--resume` instead of replacing.
 
+If the task already has a stable issue or ticket ID, bind it without changing the
+methodology that produced it:
+
+```bash
+har env launch <id> --work-id "<provider-neutral-id>" --work-title "<title>"
+```
+
+External planning/TDD/review skills remain in control of implementation strategy.
+They must delegate worktree creation, runtime launch, final verification, and
+completion to HAR.
+
 ## 3. Do ALL work in the work dir
 
 - `cd` into the work dir; every read-modify-write of project files happens there.

package/dist/templates/har-boilerplate/agent-slot.sh

@@ -447,7 +447,7 @@ try {
 #   required: SLOT_AGENT_ID, SLOT_MODE (worktree|root), SLOT_WORK_DIR
 #   optional: SLOT_SUFFIX, SLOT_WORKTREE_PATH, SLOT_BRANCH, SLOT_BASE_BRANCH,
 #             SLOT_BASE_COMMIT, SLOT_PORTS_JSON, SLOT_PREVIEW_URLS_JSON,
-#             SLOT_STATUS, SLOT_LAST_ERROR
+#             SLOT_STATUS, SLOT_LAST_ERROR, SLOT_WORK_UNIT_ID, SLOT_ATTEMPT_ID
 write_slot_registry() {
   local file
   file="$(slot_registry_file "$SLOT_AGENT_ID")"
@@ -470,6 +470,8 @@ if (e.SLOT_BRANCH) entry.branch = e.SLOT_BRANCH;
 if (e.SLOT_BASE_BRANCH) entry.baseBranch = e.SLOT_BASE_BRANCH;
 if (e.SLOT_BASE_COMMIT) entry.baseCommit = e.SLOT_BASE_COMMIT;
 if (e.SLOT_LAST_ERROR) entry.lastError = e.SLOT_LAST_ERROR;
+if (e.SLOT_WORK_UNIT_ID) entry.workUnitId = e.SLOT_WORK_UNIT_ID;
+if (e.SLOT_ATTEMPT_ID) entry.attemptId = e.SLOT_ATTEMPT_ID;
 for (const [key, env] of [["ports", "SLOT_PORTS_JSON"], ["previewUrls", "SLOT_PREVIEW_URLS_JSON"]]) {
   if (e[env]) try { entry[key] = JSON.parse(e[env]); } catch {}
 }

package/dist/templates/har-boilerplate/gitignore.template

@@ -2,6 +2,9 @@
 logs/
 runs/
 validations/
+work-units/
+work-attempts/
+validation-bindings/
 artifacts/
 state/
 maintain/

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

@@ -20,6 +20,8 @@ USE_CLAUDE=false
 FORCE=false
 REPLACE=false
 RESUME=false
+WORK_UNIT_ID="${HAR_WORK_UNIT_ID:-}"
+ATTEMPT_ID="${HAR_ATTEMPT_ID:-}"
 
 for arg in "$@"; do
   case "$arg" in
@@ -29,9 +31,17 @@ for arg in "$@"; do
     --replace)  REPLACE=true ;;
     --force)    FORCE=true ;;
     --resume)   RESUME=true ;;
+    --work-id=*) WORK_UNIT_ID="${arg#*=}" ;;
+    --attempt-id=*) ATTEMPT_ID="${arg#*=}" ;;
   esac
 done
 
+if [[ -n "$WORK_UNIT_ID" && -z "$ATTEMPT_ID" ]]; then
+  ATTEMPT_ID="$(node -e 'process.stdout.write(require("crypto").randomUUID())')"
+fi
+export SLOT_WORK_UNIT_ID="$WORK_UNIT_ID"
+export SLOT_ATTEMPT_ID="$ATTEMPT_ID"
+
 if [[ -z "$AGENT_ID" ]]; then
   har_load_agent_slot_limits
   echo "Usage: $0 <agent-id> [--no-worktree] [--claude] [--replace] [--force] [--resume] " >&2

package/dist/templates/har-boilerplate-cli/agent-slot.sh

@@ -427,7 +427,7 @@ try {
 #   required: SLOT_AGENT_ID, SLOT_MODE (worktree|root), SLOT_WORK_DIR
 #   optional: SLOT_SUFFIX, SLOT_WORKTREE_PATH, SLOT_BRANCH, SLOT_BASE_BRANCH,
 #             SLOT_BASE_COMMIT, SLOT_PORTS_JSON, SLOT_PREVIEW_URLS_JSON,
-#             SLOT_STATUS, SLOT_LAST_ERROR
+#             SLOT_STATUS, SLOT_LAST_ERROR, SLOT_WORK_UNIT_ID, SLOT_ATTEMPT_ID
 write_slot_registry() {
   local file
   file="$(slot_registry_file "$SLOT_AGENT_ID")"
@@ -450,6 +450,8 @@ if (e.SLOT_BRANCH) entry.branch = e.SLOT_BRANCH;
 if (e.SLOT_BASE_BRANCH) entry.baseBranch = e.SLOT_BASE_BRANCH;
 if (e.SLOT_BASE_COMMIT) entry.baseCommit = e.SLOT_BASE_COMMIT;
 if (e.SLOT_LAST_ERROR) entry.lastError = e.SLOT_LAST_ERROR;
+if (e.SLOT_WORK_UNIT_ID) entry.workUnitId = e.SLOT_WORK_UNIT_ID;
+if (e.SLOT_ATTEMPT_ID) entry.attemptId = e.SLOT_ATTEMPT_ID;
 for (const [key, env] of [["ports", "SLOT_PORTS_JSON"], ["previewUrls", "SLOT_PREVIEW_URLS_JSON"]]) {
   if (e[env]) try { entry[key] = JSON.parse(e[env]); } catch {}
 }

package/dist/templates/har-boilerplate-cli/gitignore.template

@@ -2,6 +2,9 @@
 logs/
 runs/
 validations/
+work-units/
+work-attempts/
+validation-bindings/
 artifacts/
 state/
 maintain/

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

@@ -19,6 +19,8 @@ USE_WORKTREE="${HARNESS_USE_WORKTREE:-true}"
 FORCE=false
 REPLACE=false
 RESUME=false
+WORK_UNIT_ID="${HAR_WORK_UNIT_ID:-}"
+ATTEMPT_ID="${HAR_ATTEMPT_ID:-}"
 
 for arg in "$@"; do
   case "$arg" in
@@ -27,9 +29,17 @@ for arg in "$@"; do
     --replace)  REPLACE=true ;;
     --force)    FORCE=true ;;
     --resume)   RESUME=true ;;
+    --work-id=*) WORK_UNIT_ID="${arg#*=}" ;;
+    --attempt-id=*) ATTEMPT_ID="${arg#*=}" ;;
   esac
 done
 
+if [[ -n "$WORK_UNIT_ID" && -z "$ATTEMPT_ID" ]]; then
+  ATTEMPT_ID="$(node -e 'process.stdout.write(require("crypto").randomUUID())')"
+fi
+export SLOT_WORK_UNIT_ID="$WORK_UNIT_ID"
+export SLOT_ATTEMPT_ID="$ATTEMPT_ID"
+
 if [[ -z "$AGENT_ID" ]]; then
   har_load_agent_slot_limits
   echo "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] [--resume] " >&2

package/dist/templates/har-boilerplate-ios/agent-slot.sh

@@ -88,7 +88,7 @@ try {
 #   required: SLOT_AGENT_ID, SLOT_MODE (worktree|root), SLOT_WORK_DIR
 #   optional: SLOT_SUFFIX, SLOT_WORKTREE_PATH, SLOT_BRANCH, SLOT_BASE_BRANCH,
 #             SLOT_BASE_COMMIT, SLOT_PORTS_JSON, SLOT_PREVIEW_URLS_JSON,
-#             SLOT_STATUS, SLOT_LAST_ERROR
+#             SLOT_STATUS, SLOT_LAST_ERROR, SLOT_WORK_UNIT_ID, SLOT_ATTEMPT_ID
 write_slot_registry() {
   local file
   file="$(slot_registry_file "$SLOT_AGENT_ID")"
@@ -111,6 +111,8 @@ if (e.SLOT_BRANCH) entry.branch = e.SLOT_BRANCH;
 if (e.SLOT_BASE_BRANCH) entry.baseBranch = e.SLOT_BASE_BRANCH;
 if (e.SLOT_BASE_COMMIT) entry.baseCommit = e.SLOT_BASE_COMMIT;
 if (e.SLOT_LAST_ERROR) entry.lastError = e.SLOT_LAST_ERROR;
+if (e.SLOT_WORK_UNIT_ID) entry.workUnitId = e.SLOT_WORK_UNIT_ID;
+if (e.SLOT_ATTEMPT_ID) entry.attemptId = e.SLOT_ATTEMPT_ID;
 for (const [key, env] of [["ports", "SLOT_PORTS_JSON"], ["previewUrls", "SLOT_PREVIEW_URLS_JSON"]]) {
   if (e[env]) try { entry[key] = JSON.parse(e[env]); } catch {}
 }

package/dist/templates/har-boilerplate-ios/gitignore.template

@@ -2,6 +2,9 @@
 logs/
 runs/
 validations/
+work-units/
+work-attempts/
+validation-bindings/
 artifacts/
 AGENT.md.proposed
 AGENT.md.proposed.meta.json

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

@@ -18,6 +18,8 @@ AGENT_ID="${1:-}"
 USE_WORKTREE="${HARNESS_USE_WORKTREE:-true}"
 FORCE=false
 REPLACE=false
+WORK_UNIT_ID="${HAR_WORK_UNIT_ID:-}"
+ATTEMPT_ID="${HAR_ATTEMPT_ID:-}"
 
 for arg in "$@"; do
   case "$arg" in
@@ -25,9 +27,17 @@ for arg in "$@"; do
     --worktree) USE_WORKTREE=true ;;
     --replace)  REPLACE=true ;;
     --force)    FORCE=true ;;
+    --work-id=*) WORK_UNIT_ID="${arg#*=}" ;;
+    --attempt-id=*) ATTEMPT_ID="${arg#*=}" ;;
   esac
 done
 
+if [[ -n "$WORK_UNIT_ID" && -z "$ATTEMPT_ID" ]]; then
+  ATTEMPT_ID="$(node -e 'process.stdout.write(require("crypto").randomUUID())')"
+fi
+export SLOT_WORK_UNIT_ID="$WORK_UNIT_ID"
+export SLOT_ATTEMPT_ID="$ATTEMPT_ID"
+
 if [[ -z "$AGENT_ID" ]]; then
   har_load_agent_slot_limits
   echo "Usage: $0 <agent-id> [--no-worktree] [--replace] [--force] " >&2

package/package.json

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