@walwal-harness/cli 5.3.0 → 5.3.2

package/assets/templates/memory.md

@@ -1,3 +1,17 @@
+---
+docmeta:
+  id: memory
+  title: Harness Memory — 공유 학습 기록
+  type: input
+  createdAt: 2026-04-20T00:00:00Z
+  updatedAt: 2026-04-20T00:00:00Z
+  source:
+    producer: user
+    skillId: harness
+  inputs: []
+  tags: [harness, memory, template]
+---
+
 # Harness Memory — 공유 학습 기록
 
 > Dispatcher가 관리. **모든 에이전트**는 세션 시작 시 이 파일을 읽고 학습된 규칙을 따릅니다.
@@ -24,3 +38,17 @@
 - 항목이 15개 초과 시 가장 오래된 unverified 항목부터 정리
 
 <!-- 항목이 추가되면 아래에 기록됩니다 -->
+
+### [M-001] progress.log 가독성 — 상세 로그 필수
+- **Date**: 2026-04-20
+- **Status**: verified
+- **TTL**: 영구
+- **Lesson**: Team Worker와 Evaluator가 progress.log에 남기는 로그는 대시보드만 보고도 "무슨 일을 시작했는가 / 무엇을 만들었는가 / 무엇을 어떻게 검증하는가"를 알 수 있어야 한다. 다음 원칙을 반드시 따른다:
+  1. `gen-start`에 Feature **제목과 목표**를 함께 기록 ("F-001 \"사용자 회원가입 API\" start — goal=POST /users, 6 AC"). ID만 기록 금지.
+  2. `gen-write`는 **변경 파일마다 1건씩** 기록 (경로 + LOC + create/edit/delete). "2 files" 같은 개수 요약 금지.
+  3. `gen-done`은 **변경 파일 전체 목록**을 나열. "7 files"처럼 개수만 기록 금지.
+  4. `eval-ac`로 **AC 원문**을 먼저 선언 ("AC-3: \"POST /users returns 201 with created user id\""), 그 후 `eval-check`로 증거·판정 기록. "AC-1 count=0" 같은 수치 단독 금지.
+  5. `result PASS`는 **SCORE ≥ 2.80**인 경우에만 기록. score=1.00을 PASS로 기록 금지.
+  6. 각 단계마다 **어떤 도구/방법으로 검증했는지**(tsc/eslint/curl/playwright 등) 명시.
+- **Context**: 사용자가 대시보드 로그만 보고 진행 상황을 파악해야 하는데, 기존 축약 로그로는 4대 질문에 답이 안 보인다는 피드백.
+- **Applies to**: Team Worker(Generator + Evaluator), Solo Mode Generator/Evaluator, 모든 `logev` 호출 지점.

package/package.json

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

package/scripts/harness-gotcha-memory.sh

@@ -30,6 +30,23 @@ BG_YELLOW="\033[43m"
 REFRESH_SEC="${HARNESS_REFRESH:-5}"
 RECENT_N="${HARNESS_GOTCHA_RECENT:-3}"
 
+# 렌더 캐시 — 내용이 바뀌지 않으면 redraw 스킵
+LAST_SIG=""
+
+# 입력 시그니처: gotchas + memory + 활성 에이전트의 mtime/size 해시
+compute_signature() {
+  {
+    [ -f "$PROGRESS" ] && stat -f '%m %z' "$PROGRESS" 2>/dev/null
+    [ -f "$MEMORY_FILE" ] && stat -f '%m %z' "$MEMORY_FILE" 2>/dev/null
+    if [ -d "$GOTCHAS_DIR" ]; then
+      for f in "$GOTCHAS_DIR"/*.md; do
+        [ -e "$f" ] || continue
+        stat -f '%N %m %z' "$f" 2>/dev/null
+      done
+    fi
+  } | md5 -q 2>/dev/null || echo "$RANDOM"
+}
+
 # 활성 에이전트 결정: current_agent > next_agent
 get_active_agent() {
   [ -f "$PROGRESS" ] || { echo ""; return; }
@@ -116,7 +133,8 @@ render_memory_summary() {
 }
 
 render() {
-  clear
+  # clear 대신 커서 홈 + 화면 끝까지 지우기 — 깜빡임 최소화
+  printf '\033[H\033[2J\033[3J'
   local cols hr
   cols=$(tput cols 2>/dev/null || echo 80)
   hr=$(printf '─%.0s' $(seq 1 "$cols"))
@@ -160,6 +178,10 @@ render() {
 trap 'exit 0' INT TERM
 
 while true; do
-  render
+  sig=$(compute_signature)
+  if [ "$sig" != "$LAST_SIG" ]; then
+    render
+    LAST_SIG="$sig"
+  fi
   sleep "$REFRESH_SEC"
 done