@walwal-harness/cli 6.1.1 → 6.1.3

package/scripts/harness-meeting-doc.sh

@@ -21,6 +21,13 @@ ops_report=$(jq -r '.service_ops.auto_retro.last_report // empty' "$PROGRESS")
 cqo_audit=$(jq -r '.cqo.audit_path // empty' "$PROGRESS")
 cto_review=$(jq -r '.cto.review_path // empty' "$PROGRESS")
 current_path=$(jq -r '.meetings.current_record_path // empty' "$PROGRESS")
+# v6.2 — parallel tracks hints (set by conductor before convene). length >= 2 = fork.
+requested_tracks=$(jq -c '.meetings.requested_tracks // []' "$PROGRESS")
+requested_rendezvous=$(jq -c '.meetings.requested_rendezvous // null' "$PROGRESS")
+fork_context=$(jq -c '.meetings.fork_context // null' "$PROGRESS")
+fallback_fork_meeting_id=$(jq -r '.meetings.fork_meeting_id // .conductor.fork_meeting_id // ""' "$PROGRESS")
+fallback_conductor_tracks=$(jq -c '.conductor.tracks // []' "$PROGRESS")
+fallback_decision_tracks=$(jq -c '.meetings.decision.tracks // []' "$PROGRESS")
 
 default_decision_json() {
   local owner="planner"
@@ -35,6 +42,33 @@ default_decision_json() {
     owner="planner"
     action_type="goal-alignment"
   fi
+
+  # v6.2 — Tracks 가 단일 진실: length >= 2 → fork-join, length == 1 → single.
+  # legacy {owner, action_type} 만 들어와도 1-element tracks[] 로 합성.
+  local tracks_json="[]"
+  local rendezvous_json="null"
+  if [ "$(jq 'length' <<<"$requested_tracks")" -gt 1 ]; then
+    tracks_json=$(jq -c '
+      [ to_entries[] | (.value + {
+          id: ((.value.id // null) // ("track-" + ((.key + 1) | tostring))),
+          deliverable: (.value.deliverable // "report"),
+          deliverable_path: (.value.deliverable_path // null),
+          status: (.value.status // "pending")
+        })
+      ]
+    ' <<<"$requested_tracks")
+    rendezvous_json=$(jq -c '. // {type:"followup-review", when:"next_cadence"}' <<<"$requested_rendezvous")
+    # primary owner = first track owner (편의 미러)
+    owner=$(jq -r '.[0].owner // "planner"' <<<"$tracks_json")
+    action_type=$(jq -r '.[0].action_type // "triage"' <<<"$tracks_json")
+  else
+    # single — derive a 1-element tracks[] (backward compat 도 동시에 처리)
+    tracks_json=$(jq -c -n \
+      --arg owner "$owner" \
+      --arg action_type "$action_type" \
+      '[ {id:"track-1", owner:$owner, action_type:$action_type, deliverable:"report", deliverable_path:null, status:"pending"} ]')
+  fi
+
   jq -n \
     --arg owner "$owner" \
     --arg action_type "$action_type" \
@@ -42,7 +76,9 @@ default_decision_json() {
     --arg drift_classification "$1" \
     --arg ops_report "$ops_report" \
     --arg cqo_audit "$cqo_audit" \
-    --arg cto_review "$cto_review" '
+    --arg cto_review "$cto_review" \
+    --argjson tracks "$tracks_json" \
+    --argjson rendezvous "$rendezvous_json" '
     {
       owner: $owner,
       action_type: $action_type,
@@ -54,26 +90,70 @@ default_decision_json() {
           (if $cto_review != "" then {source:$cto_review, kind:"cto-review"} else empty end)
         ]
       ),
-      drift_classification: $drift_classification
+      drift_classification: $drift_classification,
+      tracks: $tracks,
+      rendezvous: $rendezvous
     }'
 }
 
+resolve_followup_fork_context() {
+  local resolved="$fork_context"
+  if [ "$requested_type" != "followup-review" ]; then
+    echo "$resolved"
+    return
+  fi
+
+  if [ "$resolved" != "null" ] && [ -n "$resolved" ]; then
+    echo "$resolved"
+    return
+  fi
+
+  local fallback_tracks="$fallback_conductor_tracks"
+  if [ "$(jq 'length' <<<"$fallback_tracks")" -eq 0 ] && [ "$(jq 'length' <<<"$fallback_decision_tracks")" -gt 0 ]; then
+    fallback_tracks="$fallback_decision_tracks"
+  fi
+
+  if [ "$(jq 'length' <<<"$fallback_tracks")" -eq 0 ]; then
+    echo "null"
+    return
+  fi
+
+  jq -c -n \
+    --arg fork_meeting_id "$fallback_fork_meeting_id" \
+    --argjson prior_tracks "$fallback_tracks" \
+    '{fork_meeting_id:$fork_meeting_id, prior_tracks:$prior_tracks, sealed_at:(now | todate)}'
+}
+
 if [ "$MODE" = "prepare" ]; then
   meeting_id="M-$(date -u +%Y%m%dT%H%M%SZ)"
   meeting_dir="$MEETINGS_ROOT/$meeting_id"
   mkdir -p "$meeting_dir"
   record="$meeting_dir/meeting-$meeting_id.md"
 
+  # v6.2 — Notice surfaces tracks/rendezvous for visibility (length >= 2 = fork)
+  tracks_summary="(single owner)"
+  rendezvous_summary="-"
+  is_fork="false"
+  if [ "$(jq 'length' <<<"$requested_tracks")" -gt 1 ]; then
+    is_fork="true"
+    tracks_summary=$(jq -r '[.[] | "\(.id // "?"):\(.owner)/\(.action_type)→\(.deliverable // "report")"] | join(", ")' <<<"$requested_tracks")
+    rendezvous_summary=$(jq -r '"\(.type // "followup-review")@\(.when // "next_cadence")"' <<<"$requested_rendezvous")
+  fi
   cat > "$meeting_dir/notice.md" <<EOF
 # Notice — $meeting_id
 
 - type: $requested_type
 - reason: $requested_reason
 - goal_adherence: $goal_adherence
+- fork: $is_fork
+- tracks: $tracks_summary
+- rendezvous: $rendezvous_summary
 
 ## Request
 "$requested_reason" 요청이 접수되었습니다. 참석자들은 각자의 전문 시각에서 사실·증거를 제출하고,
 다음 owner와 action_type을 evidence 중심으로 결정하십시오.
+
+> **Parallel tracks (v6.2)**: \`tracks[]\` 의 길이 ≥ 2 면 fork-join. \`rendezvous\` 시점에 followup-review 로 합쳐집니다. 단일 트랙 회의는 기존과 동일하게 동작합니다.
 EOF
 
   cat > "$meeting_dir/prep-dispatcher.md" <<'EOF'
@@ -108,6 +188,26 @@ EOF
 EOF
 
   decision_json="$(default_decision_json "$drift")"
+
+  # v6.2 — followup-review: surface prior_tracks + fork_meeting_id from fork_context
+  resolved_fork_context="$(resolve_followup_fork_context)"
+
+  fork_section=""
+  if [ "$requested_type" = "followup-review" ] && [ "$resolved_fork_context" != "null" ] && [ -n "$resolved_fork_context" ]; then
+    fork_id=$(jq -r '.fork_meeting_id // ""' <<<"$resolved_fork_context")
+    fork_section="
+
+## Fork Context (v6.2)
+- fork_meeting_id: $fork_id
+- prior_tracks (rendezvous 입력):
+
+\`\`\`json
+$(jq '.prior_tracks' <<<"$resolved_fork_context")
+\`\`\`
+
+> 결정자(기본 CTO) 는 위 트랙별 deliverable 을 통합 검토 후 \`apply-now / backlog / more-validation\` 중 하나를 선택해 아래 Decision JSON 의 \`tracks\` 를 비우고 \`owner / action_type\` 만 채운다 (followup 에서 또 fork 금지)."
+  fi
+
   cat > "$record" <<EOF
 # Meeting Record — $meeting_id
 
@@ -115,6 +215,7 @@ EOF
 - type: $requested_type
 - reason: $requested_reason
 - goal_adherence: $goal_adherence
+$fork_section
 
 ## Decision JSON
 \`\`\`json
@@ -135,6 +236,10 @@ EOF
        jq -n --arg meeting_id "$meeting_id" --arg type "$requested_type" --arg reason "$requested_reason" --arg source_path "${record#$PROJECT_ROOT/}" --argjson decision "$decision_json" '{meeting_id:$meeting_id,type:$type,reason:$reason,decision:($decision + {source_path:$source_path})}'
      )"))" >/dev/null
 
+  if [ "$requested_type" = "followup-review" ] && [ "$resolved_fork_context" != "null" ] && [ -n "$resolved_fork_context" ]; then
+    bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" ".meetings.fork_context = $resolved_fork_context" >/dev/null
+  fi
+
   echo "${record#$PROJECT_ROOT/}"
   exit 0
 fi
@@ -150,4 +255,43 @@ if [ "$MODE" = "read-decision" ]; then
   exit 0
 fi
 
+# v6.2 — read-tracks: emit normalized tracks[] (length>=2 = fork, length==1 = single).
+# Legacy decisions without tracks → synthesize 1-element tracks[] from {owner, action_type}.
+if [ "$MODE" = "read-tracks" ]; then
+  jq -c '
+    if ((.meetings.decision.tracks // []) | length) > 0 then
+      .meetings.decision.tracks
+    elif ((.meetings.fork_context.prior_tracks // []) | length) > 0 then
+      .meetings.fork_context.prior_tracks
+    elif ((.conductor.tracks // []) | length) > 0 then
+      .conductor.tracks
+    else
+      [ {
+          id: "track-1",
+          owner: (.meetings.decision.owner // "planner"),
+          action_type: (.meetings.decision.action_type // "triage"),
+          deliverable: "report",
+          deliverable_path: null,
+          status: "pending"
+        }
+      ]
+    end
+  ' "$PROGRESS"
+  exit 0
+fi
+
+# v6.2 — read-rendezvous: emit rendezvous{} or null
+if [ "$MODE" = "read-rendezvous" ]; then
+  jq -c '.meetings.decision.rendezvous // .conductor.rendezvous // null' "$PROGRESS"
+  exit 0
+fi
+
+# v6.2 — read-fork: "true" if tracks.length >= 2, else "false"
+if [ "$MODE" = "read-fork" ]; then
+  decision="$(bash "$0" "$PROJECT_ROOT" read-decision 2>/dev/null || true)"
+  if [ -z "$decision" ]; then decision='{}'; fi
+  jq -r '((.tracks // []) | length) > 1' <<<"$decision"
+  exit 0
+fi
+
 exit 2

package/scripts/harness-session-start.sh

@@ -8,10 +8,12 @@
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 LIB="$SCRIPT_DIR/lib/harness-render-progress.sh"
 AUDIT_LIB="$SCRIPT_DIR/lib/harness-audit.sh"
+MIGRATE_LIB="$SCRIPT_DIR/lib/harness-progress-migrate.sh"
 
 if [ ! -f "$LIB" ]; then exit 0; fi
 source "$LIB"
 [ -f "$AUDIT_LIB" ] && source "$AUDIT_LIB"
+[ -f "$MIGRATE_LIB" ] && source "$MIGRATE_LIB"
 command -v jq &>/dev/null || exit 0
 
 PROJECT_ROOT="$(resolve_harness_root "." 2>/dev/null)" || exit 0
@@ -20,6 +22,11 @@ CONFIG="$PROJECT_ROOT/.harness/config.json"
 HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
 [ -f "$PROGRESS" ] || exit 0
 
+# v6.2 — idempotent schema migration (parallel tracks fields, etc.)
+if declare -f migrate_progress_schema >/dev/null 2>&1; then
+  migrate_progress_schema "$PROGRESS" || true
+fi
+
 sprint_status=$(jq -r '.sprint.status // "init"' "$PROGRESS" 2>/dev/null)
 sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS" 2>/dev/null)
 current_agent=$(jq -r '.current_agent // "none"' "$PROGRESS" 2>/dev/null)
@@ -27,6 +34,23 @@ 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)
 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)
+task_stop_resume_after=$(jq -r '.task_stop.resume_after // "null"' "$PROGRESS" 2>/dev/null)
+task_stop_notified_at=$(jq -r '.task_stop.resume_notified_at // "null"' "$PROGRESS" 2>/dev/null)
+task_stop_wake_target=$(jq -r '.task_stop.wake_target // .next_agent // "none"' "$PROGRESS" 2>/dev/null)
+task_stop_task_session=$(jq -r '.task_stop.task_session_path // "null"' "$PROGRESS" 2>/dev/null)
+
+parse_iso_epoch() {
+  local iso="${1:-}"
+  [ -n "$iso" ] && [ "$iso" != "null" ] || return 1
+  date -u -j -f "%Y-%m-%dT%H:%M:%SZ" "$iso" "+%s" 2>/dev/null \
+    || date -u -d "$iso" "+%s" 2>/dev/null
+}
+
+now_epoch() {
+  date -u "+%s"
+}
 
 # ─────────────────────────────────────────
 # Auto-heal mode drift — Team 상태 유실 복구
@@ -79,6 +103,43 @@ if [ "$mode" = "paused" ]; then
   exit 0
 fi
 
+# ─────────────────────────────────────────
+# TokenLimit hold — zero-token resume reminder
+# ─────────────────────────────────────────
+if [ "$task_stop_active" = "true" ] && [ "$task_stop_reason" = "TokenLimit" ]; then
+  retry_interval=$(jq -r '.token_limit.re_notify_every_seconds // 3600' "$CONFIG" 2>/dev/null || echo 3600)
+  resume_after_epoch=$(parse_iso_epoch "$task_stop_resume_after" || echo 0)
+  now_ts=$(now_epoch)
+  notified_epoch=$(parse_iso_epoch "$task_stop_notified_at" || echo 0)
+
+  if [ "$now_ts" -lt "$resume_after_epoch" ]; then
+    echo "# Harness paused — TokenLimit hold"
+    echo "# Wake target: /harness-${task_stop_wake_target}"
+    echo "# Retry after: ${task_stop_resume_after}"
+    if [ "$task_stop_task_session" != "null" ] && [ -n "$task_stop_task_session" ]; then
+      echo "# Task session: ${task_stop_task_session}"
+    fi
+    exit 0
+  fi
+
+  if [ "$notified_epoch" -eq 0 ] || [ $((now_ts - notified_epoch)) -ge "$retry_interval" ]; then
+    bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" \
+      ".agent_status = \"pending\" |
+       .current_agent = null |
+       .next_agent = \"${task_stop_wake_target}\" |
+       .task_stop.active = false |
+       .task_stop.resume_ready = true |
+       .task_stop.resume_notified_at = (now | todate)" \
+      >/dev/null 2>&1 || true
+    echo "# Harness resume ready — TokenLimit hold expired"
+    echo "# Resume target: /harness-${task_stop_wake_target}"
+    if [ "$task_stop_task_session" != "null" ] && [ -n "$task_stop_task_session" ]; then
+      echo "# Resume with task session: ${task_stop_task_session}"
+    fi
+    exit 0
+  fi
+fi
+
 # ─────────────────────────────────────────
 # init 상태: 첫 안내
 # ─────────────────────────────────────────

package/scripts/harness-token-limit.sh

@@ -0,0 +1,99 @@
+#!/bin/bash
+# harness-token-limit.sh — mark/resume token-limit interruptions
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="$(resolve_harness_root "${1:-.}")" || exit 1
+CMD="${2:-mark}"
+
+PROGRESS="$PROJECT_ROOT/.harness/progress.json"
+CONFIG="$PROJECT_ROOT/.harness/config.json"
+
+[ -f "$PROGRESS" ] || exit 1
+command -v jq >/dev/null 2>&1 || exit 1
+
+parse_iso_epoch() {
+  local iso="${1:-}"
+  [ -n "$iso" ] && [ "$iso" != "null" ] || return 1
+  date -u -j -f "%Y-%m-%dT%H:%M:%SZ" "$iso" "+%s" 2>/dev/null \
+    || date -u -d "$iso" "+%s" 2>/dev/null
+}
+
+mark_token_limit() {
+  local retry_secs current next task_path target stop_reason
+  retry_secs="${3:-$(jq -r '.token_limit.retry_after_seconds // 3600' "$CONFIG" 2>/dev/null || echo 3600)}"
+  stop_reason=$(jq -r '.token_limit.stop_reason_flag // "TokenLimit"' "$CONFIG" 2>/dev/null || echo "TokenLimit")
+  current=$(jq -r '.current_agent // "null"' "$PROGRESS")
+  next=$(jq -r '.next_agent // "null"' "$PROGRESS")
+  task_path=$(jq -r '.task_sessions.current.path // "null"' "$PROGRESS")
+  target="$current"
+  if [ "$target" = "null" ] || [ -z "$target" ]; then
+    target="$next"
+  fi
+  [ "$target" != "null" ] || target="dispatcher"
+
+  local stopped_at resume_after
+  stopped_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  resume_after="$(date -u -v+"${retry_secs}"S +%Y-%m-%dT%H:%M:%SZ 2>/dev/null \
+    || date -u -d "+${retry_secs} seconds" +%Y-%m-%dT%H:%M:%SZ)"
+
+  bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" "
+    .agent_status = \"paused\" |
+    .next_agent = \"$target\" |
+    .task_stop.active = true |
+    .task_stop.reason = \"$stop_reason\" |
+    .task_stop.stopped_at = \"$stopped_at\" |
+    .task_stop.resume_after = \"$resume_after\" |
+    .task_stop.resume_ready = false |
+    .task_stop.resume_notified_at = null |
+    .task_stop.wake_target = \"$target\" |
+    .task_stop.stopped_agent = $(jq -Rn --arg v "$current" '$v') |
+    .task_stop.stopped_next_agent = $(jq -Rn --arg v "$next" '$v') |
+    .task_stop.task_session_path = $(jq -Rn --arg v "$task_path" '$v') |
+    .task_stop.hold_count = ((.task_stop.hold_count // 0) + 1)
+  " >/dev/null
+
+  echo "[token-limit] marked: target=$target resume_after=$resume_after"
+}
+
+resume_probe() {
+  local active reason resume_after wake_target
+  active=$(jq -r '.task_stop.active // false' "$PROGRESS")
+  reason=$(jq -r '.task_stop.reason // "null"' "$PROGRESS")
+  resume_after=$(jq -r '.task_stop.resume_after // "null"' "$PROGRESS")
+  wake_target=$(jq -r '.task_stop.wake_target // .next_agent // "null"' "$PROGRESS")
+
+  if [ "$active" != "true" ] || [ "$reason" != "TokenLimit" ]; then
+    echo "[token-limit] no active TokenLimit hold"
+    exit 0
+  fi
+
+  local resume_epoch now_ts
+  resume_epoch=$(parse_iso_epoch "$resume_after" || echo 0)
+  now_ts=$(date -u "+%s")
+  if [ "$now_ts" -lt "$resume_epoch" ]; then
+    echo "[token-limit] still held until $resume_after"
+    exit 1
+  fi
+
+  bash "$SCRIPT_DIR/harness-progress-set.sh" "$PROJECT_ROOT" "
+    .agent_status = \"pending\" |
+    .current_agent = null |
+    .next_agent = \"$wake_target\" |
+    .task_stop.active = false |
+    .task_stop.resume_ready = true |
+    .task_stop.resume_notified_at = (now | todate)
+  " >/dev/null
+  echo "[token-limit] resume ready: wake_target=$wake_target"
+}
+
+case "$CMD" in
+  mark) mark_token_limit "$@" ;;
+  resume-probe) resume_probe ;;
+  *)
+    echo "usage: $0 <project-root> <mark|resume-probe> [retry_seconds]" >&2
+    exit 2
+    ;;
+esac

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

@@ -42,6 +42,17 @@ if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
   AGENT_STATUS=$(jq -r '.agent_status // "pending"' "$CWD/.harness/progress.json" 2>/dev/null || echo "pending")
 fi
 
+TASK_STOP_ACTIVE="false"
+TASK_STOP_REASON="null"
+TASK_STOP_RESUME_AFTER="null"
+TASK_STOP_WAKE_TARGET="none"
+if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then
+  TASK_STOP_ACTIVE=$(jq -r '.task_stop.active // false' "$CWD/.harness/progress.json" 2>/dev/null || echo "false")
+  TASK_STOP_REASON=$(jq -r '.task_stop.reason // "null"' "$CWD/.harness/progress.json" 2>/dev/null || echo "null")
+  TASK_STOP_RESUME_AFTER=$(jq -r '.task_stop.resume_after // "null"' "$CWD/.harness/progress.json" 2>/dev/null || echo "null")
+  TASK_STOP_WAKE_TARGET=$(jq -r '.task_stop.wake_target // .next_agent // "none"' "$CWD/.harness/progress.json" 2>/dev/null || echo "none")
+fi
+
 # ── 명령 히스토리 기록 (모든 모드 공통) ──
 PROGRESS_LOG="$CWD/.harness/progress.log"
 if [ -n "$PROMPT" ] && [ -d "$CWD/.harness" ]; then
@@ -79,6 +90,18 @@ EOF
   exit 0
 fi
 
+if [ "$TASK_STOP_ACTIVE" = "true" ] && [ "$TASK_STOP_REASON" = "TokenLimit" ]; then
+  cat <<EOF
+[harness] token-limit hold | wake_target=${TASK_STOP_WAKE_TARGET}
+## TokenLimit Hold
+- 모든 작업은 일시중지 상태입니다.
+- 재개 대상: /harness-${TASK_STOP_WAKE_TARGET}
+- retry_after: ${TASK_STOP_RESUME_AFTER}
+- 이 상태는 문서 기반으로만 복구되며, 별도 모델 probe는 수행하지 않습니다.
+EOF
+  exit 0
+fi
+
 # ── Mode 기반 분기 ──
 MODE="team"
 if [ -f "$CWD/.harness/progress.json" ] && command -v jq >/dev/null 2>&1; then

package/scripts/lib/harness-progress-migrate.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# harness-progress-migrate.sh — Idempotent progress.json normalizer.
+#
+# 목적: 새 스키마 필드를 누락하지 않도록 SessionStart 마다 안전하게 채운다.
+# 항상 jq 의 alternative operator(`//`) 또는 `if has` 패턴으로 작성하여
+# 기존 값을 절대 덮어쓰지 않는다.
+#
+# Usage (sourced):
+#   source "$SCRIPT_DIR/lib/harness-progress-migrate.sh"
+#   migrate_progress_schema "$PROGRESS"
+#
+# Usage (standalone):
+#   bash scripts/lib/harness-progress-migrate.sh /path/to/.harness/progress.json
+
+migrate_progress_schema() {
+  local progress="$1"
+  [ -f "$progress" ] || return 0
+  command -v jq >/dev/null 2>&1 || return 0
+
+  # v6.2 — Parallel tracks (fork-join) fields. tracks.length >= 2 → fork.
+  # Note: there is intentionally NO `meetings.decision.mode` field — single/parallel is derived
+  # from tracks.length. Runtime progress.mode is preserved because it still governs solo/team/paused.
+  local filter='
+    .conductor.tracks           = (.conductor.tracks // [])
+    | .conductor.rendezvous       = (.conductor.rendezvous // null)
+    | .conductor.fork_meeting_id  = (.conductor.fork_meeting_id // null)
+
+    | .meetings                   = (.meetings // {})
+    | .meetings.requested_tracks  = (.meetings.requested_tracks // [])
+    | .meetings.requested_rendezvous = (.meetings.requested_rendezvous // null)
+    | .meetings.fork_meeting_id   = (.meetings.fork_meeting_id // null)
+
+    | .meetings.decision          = (.meetings.decision // {})
+    | .meetings.decision.tracks   = (.meetings.decision.tracks // [])
+    | .meetings.decision.rendezvous = (.meetings.decision.rendezvous // null)
+    | del(.meetings.decision.mode)
+    | del(.meetings.requested_mode)
+  '
+
+  local tmp
+  tmp="$(mktemp)" || return 1
+  if jq "$filter" "$progress" > "$tmp" 2>/dev/null; then
+    mv "$tmp" "$progress"
+  else
+    rm -f "$tmp"
+    return 1
+  fi
+}
+
+# Standalone invocation
+if [ "${BASH_SOURCE[0]}" = "$0" ]; then
+  target="${1:-}"
+  if [ -z "$target" ]; then
+    echo "usage: $0 <path/to/.harness/progress.json>" >&2
+    exit 2
+  fi
+  migrate_progress_schema "$target"
+fi

package/skills/conductor/SKILL.md

@@ -152,6 +152,7 @@ idle ─► running ─► (waiting_meeting | waiting_owner | running) ─► co
 - 리서치·정리 중심 → `documentationer`
 - 빠른 실험·백데이터 코드 중심 → `coo-developer`
 - 둘 다 필요 → 같은 tick 에 2명 병렬 spawn 가능
+- `hypothesis-verdict` 는 terminal 단계이며 완료 시 `meeting-manager` / followup-review 로 되돌린다.
 
 ### 5.1 Team mode 병렬 spawn (G-005)
 

package/skills/coo-developer/SKILL.md

@@ -21,12 +21,20 @@ disable-model-invocation: false
 - Planner의 `requested_mode = "hypothesis"`
 - 기존 코드베이스, 로컬 데이터, 백데이터, 샘플 CSV/JSON/DB dump
 
-## 3. 출력
+## 3. 출력 (산출물 경로 표준)
 
-- 실험 코드 또는 스크립트
-- 재현 절차
-- 관찰 결과와 한계
-- "가설 지지 / 반박 / 추가 데이터 필요" 3분류 결론
+- `.harness/actions/hypothesis/<id>/spike/` — 실험 코드 또는 스크립트
+- `.harness/actions/hypothesis/<id>/repro.md` — 재현 절차
+- `.harness/actions/hypothesis/<id>/observations.md` — 관찰 결과와 한계
+- `<id>` 는 `H-YYYYMMDDTHHMMSSZ` 형식. Planner 가 fork 시점에 발급.
+
+`progress.json` 업데이트 (완료 시):
+
+```bash
+bash scripts/harness-progress-set.sh . \
+  '.coo_developer.last_spike_path = "actions/hypothesis/<id>/spike/" |
+   .coo_developer.last_observations = "actions/hypothesis/<id>/observations.md"'
+```
 
 ## 4. 작업 원칙
 
@@ -40,3 +48,25 @@ disable-model-invocation: false
 - 실험 결과만으로 운영 가능 판정
 - 정규 팀 평가 없이 배포 코드로 승격
 - 근거 없는 직감성 결론
+
+## 6. Parallel-Tracks 컨텍스트 (v6.2)
+
+Hypothesis Cell 은 fork 회의 (결정 JSON 의 `tracks[]` 길이 ≥ 2) 에서 **track-N** 의 owner 로 지명되어 활동한다 (보통 `track-2: planner/hypothesis-validation` 의 sub-step).
+
+- 자기 활동이 fork 회의에서 시작되었는지는 `progress.json.conductor.fork_meeting_id` 와 `progress.json.conductor.tracks[]` 에서 확인.
+- 형제 트랙 (예: `track-1: cto/bugfix`) 의 진행은 차단 사유가 아니다 — 평행 진행.
+- 완료 시 spike/observations 경로를 documentationer 에 인계 (Planner 가 이어 받아 followup-review 산출물 `validation-report` 로 정리).
+- followup-review 결정 = `apply-now` 면 spike 경로의 일부가 sprint artifact 로 승격될 수 있다. 그 시점부터는 정규 Generator 가 다시 짠다 — Hypothesis Cell 코드는 SoT 가 아니다.
+
+## 7. Session Boundary
+
+### On Start
+1. `.harness/progress.json` 읽기 — `conductor.fork_meeting_id` / `conductor.tracks[]` / `planner.last_brief` 확인
+2. 자기 트랙 식별 (owner 가 `coo-developer` 또는 `planner` + brief=`hypothesis:experiment`)
+3. `.harness/conventions/coo-developer.md`, `.harness/gotchas/coo-developer.md` 읽기
+4. (v6.2) parallel 모드면 형제 트랙 owner 의 gotcha 도 한 번 훑기
+
+### On Complete
+1. `actions/hypothesis/<id>/` 산출물 경로 확정
+2. partial update: `coo_developer.last_spike_path`, `agent_status = "completed"`
+3. `next_agent = "documentationer"` (Planner 의 hypothesis 흐름이 활성화된 경우)

package/skills/documentationer/SKILL.md

@@ -22,25 +22,71 @@ disable-model-invocation: false
 - `coo-developer`의 실험 결과
 - 필요 시 외부 리서치 소스
 
-## 3. 출력
+## 3. 출력 (산출물 경로 표준)
 
-- `hypothesis-brief`
-- `validation-report`
-- `evidence-summary`
-- 다음 액션 제안:
-  - 정규 Sprint로 승격
-  - 추가 실험 필요
-  - 폐기
+- `.harness/actions/hypothesis/<id>/brief.md` — `hypothesis-brief` (사전 리서치)
+- `.harness/actions/hypothesis/<id>/report.md` — `validation-report` (실험 후 통합)
+- `.harness/actions/hypothesis/<id>/evidence/` — 출처 스냅샷·캡처
+- `.harness/actions/hypothesis/<id>/verdict.json` — 기계 판독 판정
+
+`verdict.json` 스키마 (필수 필드):
+
+```json
+{
+  "id": "H-...",
+  "hypothesis": "한 줄 가설",
+  "verdict": "supported | refuted | inconclusive",
+  "confidence": 0.0,
+  "key_evidence": [
+    {"source": "actions/hypothesis/<id>/spike/run.log", "kind": "experiment"},
+    {"source": "https://...", "kind": "external-research"}
+  ],
+  "next_action": "promote-to-sprint | additional-experiment | discard",
+  "rationale": "왜 이 판정인가 — evidence 와 직접 연결",
+  "open_questions": ["..."],
+  "limitations": ["..."]
+}
+```
+
+`progress.json` 업데이트 (완료 시):
+
+```bash
+bash scripts/harness-progress-set.sh . \
+  '.documentationer.last_report = "actions/hypothesis/<id>/report.md" |
+   .documentationer.last_verdict = "actions/hypothesis/<id>/verdict.json"'
+```
 
 ## 4. 보고서 규칙
 
 - 결론 먼저, 근거 다음
-- 주장마다 evidence 출처 명시
+- 주장마다 evidence 출처 명시 (URI 또는 artifact path)
 - 운영팀/CTO/CQO가 바로 이어받을 수 있게 열린 질문을 분리
 - "왜 아직 확실하지 않은가"도 반드시 적을 것
+- `verdict` 는 supported / refuted / inconclusive 셋 중 하나로만 — 모호한 표현 금지
 
 ## 5. 금지
 
 - evidence 없는 유효 판정
 - CTO/CQO 검증을 대신했다고 표현
 - 실험 로그를 정제 없이 그대로 보고서로 제출
+
+## 6. Parallel-Tracks 컨텍스트 (v6.2)
+
+`validation-report` 는 followup-review 회의에서 **track deliverable** 로 사용된다.
+
+- followup-review 의 Meeting-Manager 는 `prior_tracks[].deliverable_path` 를 통해 이 보고서를 읽는다.
+- `verdict.json` 의 `next_action` 이 `promote-to-sprint` 면 followup 결정은 보통 `apply-now`, `additional-experiment` 면 `more-validation`, `discard` 면 `backlog` 또는 종결.
+- 형제 트랙 (예: `track-1: cto/bugfix`) 의 결과는 별도 deliverable. 둘을 함께 보고 결정자(CTO 또는 CEO) 가 통합한다 — Documentationer 가 직접 통합 결정을 내리지 않는다.
+
+## 7. Session Boundary
+
+### On Start
+1. `.harness/progress.json` 읽기 — `planner.last_brief` 확인 (`hypothesis:research` 또는 `hypothesis:report`)
+2. brief=research 면 `brief.md` 작성, brief=report 면 `coo-developer` 의 spike 결과를 `report.md` 로 통합
+3. `.harness/conventions/documentationer.md`, `.harness/gotchas/documentationer.md` 읽기
+4. (v6.2) parallel 모드면 형제 트랙 owner 의 gotcha 도 한 번 훑기
+
+### On Complete
+1. `report.md` + `verdict.json` 작성 완료
+2. partial update: `documentationer.last_report`, `documentationer.last_verdict`, `agent_status = "completed"`
+3. `next_agent = "planner"` (hypothesis-verdict 종합)