@walwal-harness/cli 6.1.4 → 6.1.6

package/scripts/harness-session-start.sh

@@ -32,7 +32,7 @@ sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
 current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
 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 // "team"' "$PROGRESS" 2>/dev/null)
+mode=$(jq -r '.mode // "company"' "$PROGRESS" 2>/dev/null)
 conductor_state=$(jq -r '.conductor.state // "idle"' "$PROGRESS" 2>/dev/null)
 task_stop_active=$(jq -r '.task_stop.active // false' "$PROGRESS" 2>/dev/null)
 task_stop_reason=$(jq -r '.task_stop.reason // "null"' "$PROGRESS" 2>/dev/null)
@@ -53,32 +53,65 @@ now_epoch() {
 }
 
 # ─────────────────────────────────────────
-# Auto-heal mode drift — Team 상태 유실 복구
-#   feature-queue.json 에 활성 작업(in_progress)이 있는데 mode 가 solo/paused 면
-#   누군가 progress.json 을 통째로 덮어써서 team_state 를 날린 것. mode=team 으로
-#   자동 복원하고 경고 로그 남김.
+# Normalize legacy mode drift — v6.3+ always runs company mode.
 # ─────────────────────────────────────────
 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
+if [ "$mode" != "company" ]; then
+  bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
+    '.mode = "company" |
+     .mode_decision.owner = "conductor" |
+     .mode_decision.policy = "always_company_parallel" |
+     .mode_decision.user_override = null |
+     .mode_decision.decided_at = (now | todate) |
+     .mode_decision.rationale = "legacy mode normalized to always-on company mode"' \
+    2>/dev/null || true
+  mode="company"
+  [ -f "$PROJECT_ROOT/.harness/progress.log" ] && echo "$(date +'%Y-%m-%d %H:%M') | system | heal | mode | normalized legacy mode to company" >> "$PROJECT_ROOT/.harness/progress.log"
+fi
+
+# ─────────────────────────────────────────
+# Truthful Logging Heal — strip future-dated progress.log entries
+# ─────────────────────────────────────────
+PROGRESS_LOG="$PROJECT_ROOT/.harness/progress.log"
+if [ -f "$PROGRESS_LOG" ]; then
+  NOW_KST=$(date "+%Y-%m-%d %H:%M")
+  NOW_UTC_MIN=$(date -u "+%Y-%m-%d %H:%M")
+  QUARANTINE_FILE="$PROGRESS_LOG.future-quarantine.$(date +%s)"
+  KEEP_FILE="$PROGRESS_LOG.tmp.$$"
+
+  # 미래 시각으로 시작하는 라인 격리. KST(YYYY-MM-DD HH:MM) 와 ISO(YYYY-MM-DDTHH:MM:SSZ) 둘 다 처리.
+  awk -v now_kst="$NOW_KST" -v now_utc="$NOW_UTC_MIN" -v qfile="$QUARANTINE_FILE" '
+    function iso_to_minute(s) {
+      gsub("\\[", "", s); gsub("T", " ", s); gsub("Z", "", s)
+      return substr(s, 1, 16)
+    }
+    {
+      future=0
+      if (match($0, /^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}/)) {
+        ts = substr($0, RSTART, RLENGTH)
+        if (ts > now_kst) future=1
+      } else if (match($0, /^\[?[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}/)) {
+        ts_min = iso_to_minute(substr($0, RSTART, RLENGTH+5))
+        if (ts_min > now_utc) future=1
+      }
+      if (future) print >> qfile
+      else print
+    }
+  ' "$PROGRESS_LOG" > "$KEEP_FILE"
+
+  if [ -f "$QUARANTINE_FILE" ] && [ -s "$QUARANTINE_FILE" ]; then
+    QCOUNT=$(wc -l < "$QUARANTINE_FILE" | tr -d ' ')
+    mv "$KEEP_FILE" "$PROGRESS_LOG"
+    echo "$(date +'%Y-%m-%d %H:%M') | system | heal | log | quarantined ${QCOUNT} future-dated lines → $(basename "$QUARANTINE_FILE")" >> "$PROGRESS_LOG"
+  else
+    rm -f "$KEEP_FILE" "$QUARANTINE_FILE" 2>/dev/null
   fi
 fi
 
 # ─────────────────────────────────────────
-# Team Mode — 팀이 자율 실행 중이면 오케스트레이터 안내
+# Company Mode — autonomous parallel company loop
 # ─────────────────────────────────────────
-if [ "$mode" = "team" ]; then
+if [ "$mode" = "company" ]; then
   FEATURE_QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
   passed=0; total=0; in_prog=0; failed=0
   if [ -f "$FEATURE_QUEUE" ]; then
@@ -88,18 +121,9 @@ if [ "$mode" = "team" ]; then
     failed=$(jq '.queue.failed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
   fi
 
-  echo "# Harness Team Mode active"
+  echo "# Harness Company Mode active"
   echo "# Queue: ${passed}/${total} passed, ${in_prog} in progress, ${failed} failed"
-  echo "# Worker pool runs autonomously (Gen-Eval loop, max 5 retries). Control-plane Cxx agents are outside this limit."
-  echo "# Stop: /harness-stop | Emergency fallback: /harness-solo"
-  exit 0
-fi
-
-# ─────────────────────────────────────────
-# Paused Mode — 중단 상태 안내
-# ─────────────────────────────────────────
-if [ "$mode" = "paused" ]; then
-  echo "# Harness paused — resume with /harness-team"
+  echo "# Company loop runs autonomously with parallel workers. Owner input is an interrupt only; do not wait for Owner after the initial GOAL."
   exit 0
 fi
 
@@ -144,9 +168,14 @@ fi
 # init 상태: 첫 안내
 # ─────────────────────────────────────────
 if [ "$sprint_status" = "init" ]; then
+  if [ "$next_agent" != "null" ] && [ "$next_agent" != "none" ] && [ "$next_agent" != "dispatcher" ]; then
+    echo "# Harness Company Mode active"
+    echo "# Sprint is init, but next_agent=${next_agent}; continue the autonomous loop instead of waiting for Owner."
+  else
   echo "# Harness ready — say \"하네스 엔지니어링 시작\" or /harness-dispatcher"
   echo "# 기본 경로는 회사 루프입니다: dispatch -> CEO meeting -> COO/CTO 분배 -> gen/eval -> CQO -> service-ops -> batch meeting."
   exit 0
+  fi
 fi
 
 # ─────────────────────────────────────────

package/scripts/harness-statusline.sh

@@ -1,8 +1,7 @@
 #!/bin/bash
 # harness-statusline.sh — Claude Code statusline hook (v5 unified)
 # 터미널 하단에 항상 고정되는 1줄 compact 상태 표시.
-# Solo: [S1] FULL | solo | >backend | sonnet | 2/5 feat | ctx 45% | $1.23
-# Team: [S1] FULL | team | T1:gen T2:eval T3:idle | 2/5 feat | ctx 45% | $1.23
+# Company: [C1] FULL | company | T1:gen T2:eval T3:idle | 2/5 work | ctx 45% | $1.23
 
 # Read Claude Code session data from stdin
 input=$(cat)
@@ -32,14 +31,13 @@ if [ ! -f "$PROGRESS" ]; then
 fi
 
 # Read harness state
-sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
-sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS" 2>/dev/null)
+cycle_num=$(jq -r '.sprint.number // .cycle.number // 0' "$PROGRESS" 2>/dev/null)
 pipeline=$(jq -r '.pipeline // "?"' "$PROGRESS" 2>/dev/null)
 current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
 agent_status=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null)
 next_agent=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null)
 retry_count=$(jq -r '.sprint.retry_count // 0' "$PROGRESS" 2>/dev/null)
-harness_mode=$(jq -r '.mode // "solo"' "$PROGRESS" 2>/dev/null)
+harness_mode="company"
 
 # Pipeline short name
 case "$pipeline" in
@@ -111,8 +109,8 @@ fi
 # Build compact status line based on mode
 FEATURE_QUEUE="$PROJECT_ROOT/.harness/actions/feature-queue.json"
 
-if [ "$harness_mode" = "team" ] && [ -f "$FEATURE_QUEUE" ]; then
-  # Team mode: show team status instead of single agent
+if [ -f "$FEATURE_QUEUE" ]; then
+  # Company mode: show worker status instead of single agent
   team_info=""
   for i in 1 2 3; do
     t_status=$(jq -r ".teams[\"$i\"].status // \"idle\"" "$FEATURE_QUEUE" 2>/dev/null)
@@ -127,13 +125,11 @@ if [ "$harness_mode" = "team" ] && [ -f "$FEATURE_QUEUE" ]; then
   t_passed=$(jq '.queue.passed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
   t_total=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
 
-  echo "[S${sprint_num}] ${pl} | team | ${team_info}| ${t_passed}/${t_total} feat | ctx ${context_pct}% | \$${cost}"
+  echo "[C${cycle_num}] ${pl} | company | ${team_info}| ${t_passed}/${t_total} work | ctx ${context_pct}% | \$${cost}"
 else
-  # Solo/paused mode: show single agent status
-  mode_tag="${harness_mode}"
   if [ -n "$model_short" ]; then
-    echo "[S${sprint_num}] ${pl} | ${mode_tag} | ${status_icon}${agent_short}${retry_str} | ${model_short} | ${completed_features}/${total_features} feat | ctx ${context_pct}% | \$${cost}"
+    echo "[C${cycle_num}] ${pl} | company | ${status_icon}${agent_short}${retry_str} | ${model_short} | ${completed_features}/${total_features} work | ctx ${context_pct}% | \$${cost}"
   else
-    echo "[S${sprint_num}] ${pl} | ${mode_tag} | ${status_icon}${agent_short}${retry_str} | ${completed_features}/${total_features} feat | ctx ${context_pct}% | \$${cost}"
+    echo "[C${cycle_num}] ${pl} | company | ${status_icon}${agent_short}${retry_str} | ${completed_features}/${total_features} work | ctx ${context_pct}% | \$${cost}"
   fi
 fi

package/scripts/harness-stop.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+# harness-stop.sh — Stop hook (v6.2)
+#
+# Claude 가 한 turn 을 끝내려 할 때 발화.
+# conductor.state == "running" 이고 다음 작업이 남아 있으면
+# stdout 으로 {"decision":"block", "reason":"..."} JSON 을 출력해
+# Claude 가 멈추지 않고 다음 tick 으로 자동 연쇄하게 한다.
+#
+# 멈춰야 할 경우 (회사 루프 정지·task_stop 등) 는 그냥 exit 0
+# → Claude 가 정상적으로 turn 을 종료.
+
+set -uo pipefail
+
+INPUT=$(cat 2>/dev/null || echo "{}")
+CWD=$(echo "$INPUT" | jq -r '.cwd // empty' 2>/dev/null || true)
+[ -z "$CWD" ] && CWD="$PWD"
+
+# 하네스 초기화 안 된 곳: no-op
+[ -f "$CWD/.harness/progress.json" ] || exit 0
+[ -f "$CWD/.harness/config.json" ] || exit 0
+command -v jq >/dev/null 2>&1 || exit 0
+
+PROGRESS="$CWD/.harness/progress.json"
+CONFIG="$CWD/.harness/config.json"
+
+# Opt-out
+AUTO_CHAIN=$(jq -r '.behavior.auto_chain_on_stop // true' "$CONFIG" 2>/dev/null || echo "true")
+if [ "$AUTO_CHAIN" != "true" ]; then exit 0; fi
+
+# 무한루프 방지: 한 sprint 안에서 stop_chain_count 가 상한을 넘으면 중단
+STOP_CHAIN_MAX=$(jq -r '.behavior.auto_chain_max_per_sprint // 200' "$CONFIG" 2>/dev/null || echo 200)
+STOP_CHAIN_COUNT=$(jq -r '.conductor.stop_chain_count // 0' "$PROGRESS" 2>/dev/null || echo 0)
+if [ "${STOP_CHAIN_COUNT:-0}" -ge "${STOP_CHAIN_MAX:-200}" ]; then exit 0; fi
+
+# 회사 루프 상태 확인
+CONDUCTOR_STATE=$(jq -r '.conductor.state // "idle"' "$PROGRESS" 2>/dev/null || echo "idle")
+NEXT_AGENT=$(jq -r '.next_agent // "none"' "$PROGRESS" 2>/dev/null || echo "none")
+AGENT_STATUS=$(jq -r '.agent_status // "pending"' "$PROGRESS" 2>/dev/null || echo "pending")
+TASK_STOP_ACTIVE=$(jq -r '.task_stop.active // false' "$PROGRESS" 2>/dev/null || echo "false")
+ESCALATION=$(jq -r '.conductor.escalation // "null"' "$PROGRESS" 2>/dev/null || echo "null")
+SPRINT_STATUS=$(jq -r '.sprint.status // "init"' "$PROGRESS" 2>/dev/null || echo "init")
+
+# stop hook 이 자기 자신에 의해 재진입되지 않도록 hook event 필터링
+HOOK_EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // empty' 2>/dev/null || true)
+if [ "$HOOK_EVENT" = "Stop" ]; then
+  STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false' 2>/dev/null || echo "false")
+  if [ "$STOP_HOOK_ACTIVE" = "true" ]; then exit 0; fi
+fi
+
+# 자동 연쇄 조건:
+#   conductor 가 running
+#   AND task_stop 비활성
+#   AND task_stop 비활성
+#   AND (next_agent 가 명시되어 있거나, agent_status=completed 라서 다음 tick 결정 필요)
+should_chain="false"
+if [ "$CONDUCTOR_STATE" = "running" ] \
+  && [ "$TASK_STOP_ACTIVE" != "true" ]; then
+  if [ "$NEXT_AGENT" != "none" ] && [ "$NEXT_AGENT" != "null" ]; then
+    should_chain="true"
+  elif [ "$AGENT_STATUS" = "completed" ]; then
+    should_chain="true"
+  fi
+fi
+
+if [ "$should_chain" != "true" ]; then exit 0; fi
+
+# stop_chain_count 증가 (느슨한 카운터 — race 허용)
+NEW_COUNT=$((STOP_CHAIN_COUNT + 1))
+TMP=$(mktemp)
+jq --argjson n "$NEW_COUNT" '.conductor.stop_chain_count = $n |
+  .conductor.last_stop_chain_at = (now | todate)' "$PROGRESS" > "$TMP" 2>/dev/null \
+  && mv "$TMP" "$PROGRESS" || rm -f "$TMP"
+
+# Claude 에게 다음 행동 지시
+if [ "$ESCALATION" != "null" ]; then
+  REASON="자율 회사 루프 진행 중. escalation=${ESCALATION} 는 정지 사유가 아니라 meeting-manager/service-ops 공유 대상이다. next_agent=${NEXT_AGENT}, agent_status=${AGENT_STATUS}, conductor=${CONDUCTOR_STATE}. SKILL 에 따라 conductor-tick 을 굴려 meeting-manager 회의로 라우팅하거나 다음 부서를 spawn 하라. progress.log 에는 절대 미래 시각을 쓰지 말 것. 진짜로 끝났을 때만 turn 을 종료하라."
+else
+  REASON="자율 회사 루프 진행 중. next_agent=${NEXT_AGENT}, agent_status=${AGENT_STATUS}, conductor=${CONDUCTOR_STATE}. SKILL 에 따라 다음 부서를 spawn 하거나 conductor-tick 을 한 번 더 굴려라. progress.log 에는 절대 미래 시각을 쓰지 말 것. 진짜로 끝났을 때만 turn 을 종료하라."
+fi
+
+jq -nc \
+  --arg reason "$REASON" \
+  '{decision: "block", reason: $reason}'
+
+exit 0

package/scripts/harness-user-prompt-submit.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 # harness-user-prompt-submit.sh — UserPromptSubmit hook (v5 unified)
-# 핵심 상태 + 라우팅 지시만 주입. 회사 루프 기본, solo는 비상용 override.
+# 핵심 상태 + 라우팅 지시만 주입. 회사 루프는 항상 병렬/자율 진행.
 set -e
 
 INPUT=$(cat)
@@ -102,41 +102,23 @@ EOF
   exit 0
 fi
 
-# ── Mode 기반 분기 ──
-MODE="team"
-if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
-  MODE=$(jq -r '.mode // "team"' "$CWD/.harness/progress.json" 2>/dev/null || echo "team")
-fi
-
-if [ "$MODE" = "team" ]; then
-  FEATURE_QUEUE="$CWD/.harness/actions/feature-queue.json"
-  T_PASSED=0; T_TOTAL=0; T_FAILED=0
-  if [ -f "$FEATURE_QUEUE" ]; then
-    T_PASSED=$(jq '.queue.passed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
-    T_TOTAL=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
-    T_FAILED=$(jq '.queue.failed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
-  fi
-
-  cat <<EOF
-[harness] team | ${T_PASSED}/${T_TOTAL} passed | ${T_FAILED} failed
-
-## Team Mode Active
-- worker pool(기본 3)이 자율적으로 Gen→Eval 루프 실행 중 (max 5 retries)
-- CEO/Meeting/CTO/CQO/Service-Ops control-plane은 이 상한에 포함되지 않음
-- 역할: 모니터링, 실패 대응, Goal 점검
-- /harness-stop → 중단 | /harness-solo → 비상용 단일 에이전트 fallback
-- skip: "harness skip" 시 일반 대화
-EOF
-  exit 0
+FEATURE_QUEUE="$CWD/.harness/actions/feature-queue.json"
+T_PASSED=0; T_TOTAL=0; T_FAILED=0
+if [ -f "$FEATURE_QUEUE" ]; then
+  T_PASSED=$(jq '.queue.passed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  T_TOTAL=$(jq '[.queue.ready, (.queue.blocked | keys), (.queue.in_progress | keys), .queue.passed, .queue.failed] | flatten | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
+  T_FAILED=$(jq '.queue.failed | length' "$FEATURE_QUEUE" 2>/dev/null || echo 0)
 fi
 
-# ── Compact context 주입 (solo/paused mode) ──
 cat <<EOF
-[harness] S${SPRINT_NUM} | ${PIPELINE} | agent=${CURRENT_AGENT} (${AGENT_STATUS}) | next=${NEXT_AGENT}
+[harness] company | S${SPRINT_NUM} | ${PIPELINE} | agent=${CURRENT_AGENT} (${AGENT_STATUS}) | next=${NEXT_AGENT} | queue=${T_PASSED}/${T_TOTAL} passed | failed=${T_FAILED}
 ${CONTEXT_WARNING}
 ## Route
 - pipeline=none/dispatcher 미실행 → harness-dispatcher 스킬 호출
 - 기본 경로는 conductor 중심 회사 루프다: dispatch -> CEO meeting -> planner(COO) -> cto -> gen/eval -> cqo -> service-ops -> batch meeting
+- worker pool(기본 3)이 자율적으로 Gen→Eval 루프 실행 중이며 control-plane은 이 상한에 포함되지 않는다
+- Owner에게 "계속 진행", "진행할까요?", "다음 명령을 입력하세요"를 요구하지 않는다. GOAL이 있고 escalation이 아니면 즉시 next_agent/current_agent 업무를 수행한다
+- Owner 입력은 목표 변경·사고·결과 확인용이지 회사 진행을 펌프하는 신호가 아니다
 - conductor 는 Planner 직행 대신 meeting-manager / cto / cqo / service-ops 로 next_agent를 재작성할 수 있다
 - 기능 요청 → pipeline flow | 실수 지적 → gotcha flow | 메타 질문 → 짧게 응답 (skip)
 - 활성 pipeline → next_agent/current_agent 컨텍스트로 계속

package/scripts/harness-wake-install.sh

@@ -0,0 +1,180 @@
+#!/bin/bash
+# harness-wake-install.sh — launchd hourly wake 설치/관리
+#
+# 사용법:
+#   bash scripts/harness-wake-install.sh install [project-root...]
+#   bash scripts/harness-wake-install.sh add <project-root>
+#   bash scripts/harness-wake-install.sh remove <project-root>
+#   bash scripts/harness-wake-install.sh list
+#   bash scripts/harness-wake-install.sh status
+#   bash scripts/harness-wake-install.sh uninstall
+#
+# install: 등록된 프로젝트를 합치고 launchd job 을 (재)로드. 추가 인자가 있으면 그 경로들을 새로 추가.
+# add/remove: ~/.walwal-harness/projects.list 만 수정.
+# list: 현재 등록 목록 출력.
+# status: launchd 상태 확인.
+# uninstall: plist 언로드 + 제거.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+WAKE_SH="$SCRIPT_DIR/harness-wake.sh"
+HARNESS_DIR="$HOME/.walwal-harness"
+PROJECTS_LIST="$HARNESS_DIR/projects.list"
+LOG_DIR="$HARNESS_DIR/logs"
+LAUNCH_AGENTS_DIR="$HOME/Library/LaunchAgents"
+PLIST_NAME="com.walwal.harness-wake"
+PLIST_PATH="$LAUNCH_AGENTS_DIR/$PLIST_NAME.plist"
+
+# 템플릿 위치 후보 — walwal-harness 패키지 안일 수도, 프로젝트 안일 수도.
+detect_template() {
+  local candidates=(
+    "$SCRIPT_DIR/../assets/launchd/com.walwal.harness-wake.plist.template"
+    "$HOME/project/walwal-harness/assets/launchd/com.walwal.harness-wake.plist.template"
+  )
+  for c in "${candidates[@]}"; do
+    [ -f "$c" ] && { echo "$c"; return 0; }
+  done
+  return 1
+}
+
+ensure_dirs() {
+  mkdir -p "$HARNESS_DIR" "$LOG_DIR" "$LAUNCH_AGENTS_DIR"
+  touch "$PROJECTS_LIST"
+}
+
+abs_path() {
+  local p="$1"
+  if [ -d "$p" ]; then
+    (cd "$p" && pwd)
+  else
+    echo "$p"
+  fi
+}
+
+cmd_add() {
+  ensure_dirs
+  local project
+  project=$(abs_path "$1")
+  if grep -Fxq "$project" "$PROJECTS_LIST" 2>/dev/null; then
+    echo "[wake] already registered: $project"
+    return 0
+  fi
+  echo "$project" >> "$PROJECTS_LIST"
+  echo "[wake] added: $project"
+}
+
+cmd_remove() {
+  ensure_dirs
+  local project
+  project=$(abs_path "$1")
+  if ! grep -Fxq "$project" "$PROJECTS_LIST" 2>/dev/null; then
+    echo "[wake] not registered: $project"
+    return 0
+  fi
+  local tmp
+  tmp=$(mktemp)
+  grep -Fxv "$project" "$PROJECTS_LIST" > "$tmp" || true
+  mv "$tmp" "$PROJECTS_LIST"
+  echo "[wake] removed: $project"
+}
+
+cmd_list() {
+  ensure_dirs
+  if [ ! -s "$PROJECTS_LIST" ]; then
+    echo "(empty)"
+    return 0
+  fi
+  cat "$PROJECTS_LIST"
+}
+
+cmd_status() {
+  if [ -f "$PLIST_PATH" ]; then
+    echo "[wake] plist: $PLIST_PATH (exists)"
+  else
+    echo "[wake] plist: $PLIST_PATH (NOT installed)"
+  fi
+  if launchctl list 2>/dev/null | grep -q "$PLIST_NAME"; then
+    echo "[wake] launchd: loaded"
+    launchctl list | awk -v n="$PLIST_NAME" '$3==n {print "        pid="$1" exit="$2" label="$3}'
+  else
+    echo "[wake] launchd: NOT loaded"
+  fi
+  echo "[wake] projects:"
+  cmd_list | sed 's/^/        /'
+}
+
+cmd_install() {
+  ensure_dirs
+
+  # 추가 인자가 있으면 add
+  shift_count=0
+  for p in "$@"; do
+    cmd_add "$p"
+  done
+
+  local template
+  template=$(detect_template) || {
+    echo "[wake] ERROR: plist template not found" >&2
+    return 1
+  }
+
+  # plist 생성
+  sed \
+    -e "s|{{WAKE_SCRIPT}}|$WAKE_SH|g" \
+    -e "s|{{LOG_DIR}}|$LOG_DIR|g" \
+    -e "s|{{HOME}}|$HOME|g" \
+    "$template" > "$PLIST_PATH"
+
+  # 기존 jobs 언로드 (idempotent)
+  launchctl unload "$PLIST_PATH" 2>/dev/null || true
+
+  # 로드
+  if launchctl load "$PLIST_PATH" 2>/dev/null; then
+    echo "[wake] launchd loaded: $PLIST_PATH"
+  else
+    echo "[wake] WARN: launchctl load 실패. 다음 명령으로 직접 시도해 보세요:" >&2
+    echo "         launchctl load $PLIST_PATH" >&2
+  fi
+
+  cmd_status
+}
+
+cmd_uninstall() {
+  if [ -f "$PLIST_PATH" ]; then
+    launchctl unload "$PLIST_PATH" 2>/dev/null || true
+    rm -f "$PLIST_PATH"
+    echo "[wake] uninstalled: $PLIST_PATH"
+  else
+    echo "[wake] not installed"
+  fi
+}
+
+cmd_run_now() {
+  bash "$WAKE_SH"
+  echo "[wake] run-now done. log:"
+  tail -20 "$LOG_DIR/wake.log" 2>/dev/null || true
+}
+
+case "${1:-}" in
+  install)   shift; cmd_install "$@" ;;
+  add)       shift; cmd_add "${1:-$PWD}" ;;
+  remove)    shift; cmd_remove "${1:-$PWD}" ;;
+  list)      cmd_list ;;
+  status)    cmd_status ;;
+  uninstall) cmd_uninstall ;;
+  run-now)   cmd_run_now ;;
+  *)
+    cat <<USAGE
+harness-wake-install.sh — launchd hourly wake 관리
+
+  install [project-root...]   plist 생성 + 로드 (+ 프로젝트 등록)
+  add <project-root>          프로젝트 등록만
+  remove <project-root>       프로젝트 등록 해제
+  list                        등록된 프로젝트 출력
+  status                      launchd / plist / 등록 상태
+  run-now                     지금 즉시 wake 실행 (테스트)
+  uninstall                   plist 언로드 + 제거
+USAGE
+    ;;
+esac