@walwal-harness/cli 5.6.2 → 5.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "5.6.2",
+  "version": "5.6.3",
   "description": "Production harness for AI agent engineering — Solo/Team mode, Planner, Generator(BE/FE), Evaluator chain (Code-Quality → Functional → Visual), optional Brainstormer. Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-progress-set.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# harness-progress-set.sh — Safe partial update to .harness/progress.json
+#
+# Usage:
+#   bash scripts/harness-progress-set.sh <project-root> <jq_filter>
+#
+# The jq filter is a partial assignment expression. All other fields are
+# preserved. NEVER rewrite progress.json as a full JSON blob — mode,
+# team_state, and similar top-level fields will be lost.
+#
+# Example:
+#   bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+set -uo pipefail
+
+PROJECT_ROOT="${1:-.}"
+FILTER="${2:-}"
+
+if [ -z "$FILTER" ]; then
+  echo "[progress-set] usage: $0 <project-root> <jq_filter>" >&2
+  exit 2
+fi
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+
+if [ ! -f "$PROGRESS" ]; then
+  echo "[progress-set] not found: $PROGRESS" >&2
+  exit 1
+fi
+
+# Always add .updated_at = now so callers don't forget
+FINAL_FILTER="$FILTER | .updated_at = (now | todate)"
+
+TMP="${PROGRESS}.tmp.$$"
+if jq "$FINAL_FILTER" "$PROGRESS" > "$TMP" 2>/dev/null; then
+  mv "$TMP" "$PROGRESS"
+else
+  rm -f "$TMP"
+  echo "[progress-set] jq filter failed: $FILTER" >&2
+  exit 1
+fi

package/scripts/harness-session-start.sh

@@ -27,6 +27,29 @@ next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
 agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
 mode=$(jq -r '.mode // "solo"' "$PROGRESS" 2>/dev/null)
 
+# ─────────────────────────────────────────
+# Auto-heal mode drift — Team 상태 유실 복구
+#   feature-queue.json 에 활성 작업(in_progress)이 있는데 mode 가 solo/paused 면
+#   누군가 progress.json 을 통째로 덮어써서 team_state 를 날린 것. mode=team 으로
+#   자동 복원하고 경고 로그 남김.
+# ─────────────────────────────────────────
+FEATURE_QUEUE_HEAL="$PROJECT_ROOT/.harness/actions/feature-queue.json"
+if [ -f "$FEATURE_QUEUE_HEAL" ] && [ "$mode" != "team" ]; then
+  active_count=$(jq -r '(.queue.in_progress | length) // 0' "$FEATURE_QUEUE_HEAL" 2>/dev/null || echo 0)
+  if [ "${active_count:-0}" -gt 0 ]; then
+    heal_teams=$active_count
+    [ "$heal_teams" -gt 3 ] && heal_teams=3
+    bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
+      ".mode = \"team\" | .team_state.active_teams = ${heal_teams} | .team_state.paused_at = null" \
+      2>/dev/null
+    mode="team"
+    echo "# Harness: mode auto-healed to 'team' (feature-queue has ${active_count} active, but mode was drifted)" >&2
+    if [ -f "$PROJECT_ROOT/.harness/progress.log" ]; then
+      echo "$(date +'%Y-%m-%d %H:%M') | system | heal | mode | reset solo→team (queue had ${active_count} in_progress)" >> "$PROJECT_ROOT/.harness/progress.log"
+    fi
+  fi
+fi
+
 # ─────────────────────────────────────────
 # Team Mode — 팀이 자율 실행 중이면 오케스트레이터 안내
 # ─────────────────────────────────────────

package/skills/brainstorming/SKILL.md

@@ -31,6 +31,24 @@ Planner 가 곧바로 plan.md / feature-list.json / api-contract.json 으로 변
 제공하거나 브레인스토밍 불필요를 선언하면 Dispatcher 는 곧바로 `next_agent = planner`
 로 라우팅한다.
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/dispatcher/SKILL.md

@@ -6,6 +6,24 @@ disable-model-invocation: false
 
 # Dispatcher — Pipeline Selector + Gotcha Manager
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/evaluator-code-quality/SKILL.md

@@ -9,6 +9,24 @@ disable-model-invocation: true
 > Functional/Visual 평가자보다 **먼저** 실행된다. 코드가 구조적으로 망가졌으면
 > 동작 테스트는 의미 없다. 이 게이트에서 FAIL 이면 Functional/Visual 은 아예 시작도 하지 않는다.
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/evaluator-functional/SKILL.md

@@ -6,6 +6,24 @@ disable-model-invocation: true
 
 # Evaluator-Functional — Playwright MCP
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/evaluator-visual/SKILL.md

@@ -6,6 +6,24 @@ disable-model-invocation: true
 
 # Evaluator-Visual — Design & Accessibility
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/generator-backend/SKILL.md

@@ -6,6 +6,24 @@ disable-model-invocation: true
 
 # Generator-Backend — Adaptive (Stack-Agnostic)
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/generator-frontend/SKILL.md

@@ -6,6 +6,24 @@ disable-model-invocation: true
 
 # Generator-Frontend — Adaptive (Stack-Agnostic)
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start

package/skills/planner/SKILL.md

@@ -6,6 +6,24 @@ disable-model-invocation: true
 
 # Planner Agent
 
+## progress.json 업데이트 규칙 (v5.6.3+)
+
+⚠️ **절대로 progress.json 을 통째로 재작성하지 마라**. `Write` 도구로 전체 파일을
+덮어쓰면 `mode` / `team_state` / 기타 top-level 필드가 누락되어 Team Mode 가 Solo 로
+되돌아가는 등 런타임 오류가 발생한다.
+
+**올바른 방법** — 반드시 partial update 로 갱신:
+
+```bash
+# 헬퍼 스크립트 (권장)
+bash scripts/harness-progress-set.sh . '.current_agent = "planner" | .agent_status = "running"'
+
+# 또는 직접 jq 로 partial update
+jq '.agent_status = "completed" | .completed_agents += ["planner"]'   .harness/progress.json > .harness/progress.json.tmp &&   mv .harness/progress.json.tmp .harness/progress.json
+```
+
+위 두 방식은 파일의 나머지 필드를 보존한다. Read → 수정 → Write 패턴은 사용 금지.
+
 ## Session Boundary Protocol
 
 ### On Start