@walwal-harness/cli 6.1.5 → 7.1.0

package/scripts/play.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# play.sh — Start walwal harness play build mode.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="$(resolve_harness_root "${HARNESS_PROJECT_ROOT:-.}")" || exit 1
+HARNESS_DIR="$PROJECT_ROOT/.harness"
+CONFIG="$HARNESS_DIR/config.json"
+PROGRESS="$HARNESS_DIR/progress.json"
+RUNTIME_DIR="$HARNESS_DIR/runtime"
+LOG_DIR="$HARNESS_DIR/logs/$(date -u +%Y-%m-%d)"
+
+[ -d "$HARNESS_DIR" ] || { echo "ERROR: .harness/ not found" >&2; exit 1; }
+[ -f "$PROGRESS" ] || { echo "ERROR: .harness/progress.json not found" >&2; exit 1; }
+[ -f "$CONFIG" ] || { echo "ERROR: .harness/config.json not found" >&2; exit 1; }
+command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required" >&2; exit 1; }
+
+mkdir -p "$RUNTIME_DIR" "$LOG_DIR"
+
+MODE_FILE="$RUNTIME_DIR/harness-mode"
+PID_FILE="$RUNTIME_DIR/play.pid"
+LOG_FILE="$LOG_DIR/play-harness.log"
+ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+ENV_FILE="$PROJECT_ROOT/.env"
+
+active_mode=""
+[ -f "$MODE_FILE" ] && active_mode="$(cat "$MODE_FILE" 2>/dev/null || true)"
+if [ -n "$active_mode" ] && [ "$active_mode" != "play" ]; then
+  echo "ERROR: $active_mode mode is active. Run /stop-harness before /play-harness." >&2
+  exit 2
+fi
+
+if [ -f "$PID_FILE" ]; then
+  old_pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+  if [ -n "$old_pid" ] && kill -0 "$old_pid" 2>/dev/null; then
+    echo "ERROR: play mode is already active with pid $old_pid" >&2
+    exit 2
+  fi
+fi
+
+cmd="$(jq -r '.runtime.play.command // empty' "$CONFIG" 2>/dev/null || true)"
+if [ -z "$cmd" ] || [ "$cmd" = "null" ]; then
+  cmd="$(jq -r '.runtime.build.commands[0].command // empty' "$CONFIG" 2>/dev/null || true)"
+fi
+[ -n "$cmd" ] || { echo "ERROR: runtime.play.command or runtime.build.commands[0].command must be configured" >&2; exit 1; }
+
+cwd="$(jq -r '.runtime.play.cwd // .runtime.build.commands[0].cwd // "."' "$CONFIG" 2>/dev/null || echo ".")"
+run_dir="$PROJECT_ROOT/$cwd"
+[ -d "$run_dir" ] || { echo "ERROR: play cwd does not exist: $cwd" >&2; exit 1; }
+
+env_base_port=""
+if [ -f "$ENV_FILE" ]; then
+  env_base_port="$(grep -E '^HARNESS_BASE_PORT=[0-9]' "$ENV_FILE" 2>/dev/null | tail -1 | cut -d= -f2- | tr -d '"' || true)"
+fi
+config_base_port="$(jq -r 'if .runtime.ports.base == null then "" else (.runtime.ports.base|tostring) end' "$CONFIG" 2>/dev/null || true)"
+base_port="${env_base_port:-$config_base_port}"
+
+(
+  cd "$run_dir" || exit 1
+  nohup bash -lc "$cmd $*" >> "$LOG_FILE" 2>&1 &
+  echo "$!"
+) > "$RUNTIME_DIR/play.pid.tmp"
+pid="$(cat "$RUNTIME_DIR/play.pid.tmp" 2>/dev/null || true)"
+rm -f "$RUNTIME_DIR/play.pid.tmp"
+[ -n "$pid" ] || { echo "ERROR: failed to start play command" >&2; exit 1; }
+
+printf '%s\n' "play" > "$MODE_FILE"
+printf '%s\n' "$pid" > "$PID_FILE"
+
+tmp_config="$(mktemp)"
+jq --arg log "$LOG_FILE" --arg cmd "$cmd" --arg cwd "$cwd" --arg base "$base_port" '
+  .runtime.build.live = true |
+  .runtime.production.live = false |
+  .runtime.build.commands[0].command = ((.runtime.build.commands[0].command // $cmd) | if . == "" then $cmd else . end) |
+  .runtime.build.commands[0].cwd = ((.runtime.build.commands[0].cwd // $cwd) | if . == "" then $cwd else . end) |
+  .runtime.build.commands[0].log_path = $log |
+  if ($base | length) > 0 then
+    .runtime.ports.base = (($base|tonumber?) // .runtime.ports.base) |
+    .runtime.build.commands[0].expected_port = ((.runtime.build.commands[0].expected_port // (($base|tonumber?) // null)))
+  else
+    .
+  end
+' "$CONFIG" > "$tmp_config" && mv "$tmp_config" "$CONFIG" || rm -f "$tmp_config"
+
+tmp="$(mktemp)"
+jq --arg ts "$ts" --arg pid "$pid" --arg log "$LOG_FILE" --arg cmd "$cmd" '
+  .runtime_state.mode = "play" |
+  .runtime_state.started_at = $ts |
+  .runtime_state.pid = ($pid|tonumber) |
+  .runtime_state.log_path = $log |
+  .runtime_state.command = $cmd |
+  .service_ops.requested_mode = "monitor" |
+  .service_ops.monitor.stream_active = true |
+  .runtime.build.live = true |
+  .runtime.production.live = false
+' "$PROGRESS" > "$tmp" && mv "$tmp" "$PROGRESS" || rm -f "$tmp"
+
+ops_report="$(bash "$SCRIPT_DIR/harness-service-ops-monitor.sh" "$PROJECT_ROOT" 2>/dev/null || true)"
+echo "play pid: $pid"
+echo "play log: $LOG_FILE"
+[ -n "$ops_report" ] && echo "ops report: $ops_report"

package/scripts/release.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# release.sh — Start walwal harness release operation mode.
+
+set -uo pipefail
+
+mode="${1:-release}"
+if [ "$mode" = "release" ]; then
+  shift || true
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/lib/harness-render-progress.sh"
+
+PROJECT_ROOT="$(resolve_harness_root "${HARNESS_PROJECT_ROOT:-.}")" || exit 1
+HARNESS_DIR="$PROJECT_ROOT/.harness"
+CONFIG="$HARNESS_DIR/config.json"
+PROGRESS="$HARNESS_DIR/progress.json"
+RUNTIME_DIR="$HARNESS_DIR/runtime"
+LOG_DIR="$HARNESS_DIR/logs/$(date -u +%Y-%m-%d)"
+
+[ -d "$HARNESS_DIR" ] || { echo "ERROR: .harness/ not found" >&2; exit 1; }
+[ -f "$PROGRESS" ] || { echo "ERROR: .harness/progress.json not found" >&2; exit 1; }
+[ -f "$CONFIG" ] || { echo "ERROR: .harness/config.json not found" >&2; exit 1; }
+command -v jq >/dev/null 2>&1 || { echo "ERROR: jq is required" >&2; exit 1; }
+
+mkdir -p "$RUNTIME_DIR" "$LOG_DIR"
+
+MODE_FILE="$RUNTIME_DIR/harness-mode"
+PID_FILE="$RUNTIME_DIR/release.pid"
+LOG_FILE="$LOG_DIR/release-harness.log"
+ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+
+active_mode=""
+[ -f "$MODE_FILE" ] && active_mode="$(cat "$MODE_FILE" 2>/dev/null || true)"
+if [ -n "$active_mode" ] && [ "$active_mode" != "release" ]; then
+  echo "ERROR: $active_mode mode is active. Run /stop-harness before /release-harness." >&2
+  exit 2
+fi
+
+if [ -f "$PID_FILE" ]; then
+  old_pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+  if [ -n "$old_pid" ] && kill -0 "$old_pid" 2>/dev/null; then
+    echo "ERROR: release mode is already active with pid $old_pid" >&2
+    exit 2
+  fi
+fi
+
+cmd="$(jq -r '.runtime.release.command // empty' "$CONFIG" 2>/dev/null || true)"
+[ -n "$cmd" ] && [ "$cmd" != "null" ] || { echo "ERROR: runtime.release.command must be configured" >&2; exit 1; }
+
+cwd="$(jq -r '.runtime.release.cwd // "."' "$CONFIG" 2>/dev/null || echo ".")"
+run_dir="$PROJECT_ROOT/$cwd"
+[ -d "$run_dir" ] || { echo "ERROR: release cwd does not exist: $cwd" >&2; exit 1; }
+
+(
+  cd "$run_dir" || exit 1
+  nohup bash -lc "$cmd $*" >> "$LOG_FILE" 2>&1 &
+  echo "$!"
+) > "$RUNTIME_DIR/release.pid.tmp"
+pid="$(cat "$RUNTIME_DIR/release.pid.tmp" 2>/dev/null || true)"
+rm -f "$RUNTIME_DIR/release.pid.tmp"
+[ -n "$pid" ] || { echo "ERROR: failed to start release command" >&2; exit 1; }
+
+printf '%s\n' "release" > "$MODE_FILE"
+printf '%s\n' "$pid" > "$PID_FILE"
+
+tmp_config="$(mktemp)"
+jq '
+  .runtime.build.live = false |
+  .runtime.production.live = true
+' "$CONFIG" > "$tmp_config" && mv "$tmp_config" "$CONFIG" || rm -f "$tmp_config"
+
+tmp="$(mktemp)"
+jq --arg ts "$ts" --arg pid "$pid" --arg log "$LOG_FILE" --arg cmd "$cmd" '
+  .runtime_state.mode = "release" |
+  .runtime_state.started_at = $ts |
+  .runtime_state.pid = ($pid|tonumber) |
+  .runtime_state.log_path = $log |
+  .runtime_state.command = $cmd |
+  .service_ops.requested_mode = "monitor" |
+  .service_ops.monitor.stream_active = true |
+  .runtime.build.live = false |
+  .runtime.production.live = true
+' "$PROGRESS" > "$tmp" && mv "$tmp" "$PROGRESS" || rm -f "$tmp"
+
+ops_report="$(bash "$SCRIPT_DIR/harness-service-ops-monitor.sh" "$PROJECT_ROOT" 2>/dev/null || true)"
+echo "release pid: $pid"
+echo "release log: $LOG_FILE"
+[ -n "$ops_report" ] && echo "ops report: $ops_report"

package/conventions/conductor.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-conductor
-  title: Conventions — uconductor
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - conductor
----
-
-# Conventions — uconductor
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 uconductor 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/coo-developer.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-coo-developer
-  title: Conventions — ucoo-udeveloper
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - coo-developer
----
-
-# Conventions — ucoo-udeveloper
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 ucoo-udeveloper 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/dispatcher.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-dispatcher
-  title: Conventions — udispatcher
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - dispatcher
----
-
-# Conventions — udispatcher
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 udispatcher 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/documentationer.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-documentationer
-  title: Conventions — udocumentationer
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - documentationer
----
-
-# Conventions — udocumentationer
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 udocumentationer 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/evaluator-architecture.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-evaluator-architecture
-  title: Conventions — uevaluator-uarchitecture
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - evaluator-architecture
----
-
-# Conventions — uevaluator-uarchitecture
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 uevaluator-uarchitecture 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/evaluator-code-quality.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-evaluator-code-quality
-  title: Conventions — evaluator-code-quality
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - evaluator-code-quality
----
-
-# Conventions — evaluator-code-quality
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/evaluator-code-quality.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/evaluator-functional.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-evaluator-functional
-  title: Conventions — evaluator-functional
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - evaluator-functional
----
-
-# Conventions — evaluator-functional
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/evaluator-functional.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/evaluator-security.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-evaluator-security
-  title: Conventions — uevaluator-usecurity
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - evaluator-security
----
-
-# Conventions — uevaluator-usecurity
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 uevaluator-usecurity 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/evaluator-visual.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-evaluator-visual
-  title: Conventions — evaluator-visual
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - evaluator-visual
----
-
-# Conventions — evaluator-visual
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/evaluator-visual.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/generator-backend.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-generator-backend
-  title: Conventions — generator-backend
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - generator-backend
----
-
-# Conventions — generator-backend
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/generator-backend.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/generator-designer.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-generator-designer
-  title: Conventions — ugenerator-udesigner
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - generator-designer
----
-
-# Conventions — ugenerator-udesigner
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 ugenerator-udesigner 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/generator-devops.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-generator-devops
-  title: Conventions — ugenerator-udevops
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - generator-devops
----
-
-# Conventions — ugenerator-udevops
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 ugenerator-udevops 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/generator-frontend.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-generator-frontend
-  title: Conventions — generator-frontend
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - generator-frontend
----
-
-# Conventions — generator-frontend
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/generator-frontend.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/meeting-manager.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-meeting-manager
-  title: Conventions — umeeting-umanager
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - meeting-manager
----
-
-# Conventions — umeeting-umanager
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 umeeting-umanager 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/planner.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-planner
-  title: Conventions — planner
-  type: input
-  createdAt: 2026-04-22T00:00:00Z
-  updatedAt: 2026-04-22T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - planner
----
-
-# Conventions — planner
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기(`.harness/conventions/planner.md`)는 역할 국한 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `.harness/conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/conventions/service-ops.md

@@ -1,24 +0,0 @@
----
-docmeta:
-  id: conventions-service-ops
-  title: Conventions — uservice-uops
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  tags:
-    - conventions
-    - service-ops
----
-
-# Conventions — uservice-uops
-
-> **세션 시작 시 이 파일이 비어있더라도 루트 `CONVENTIONS.md` 는 반드시 먼저 읽으시오.**
-> 여기는 uservice-uops 스코프의 긍정 규범만 누적되며, 프로젝트 전체 원칙은 루트에 있습니다.
->
-> Dispatcher 가 긍정 가이드("~해야 해", "~이렇게 해줘") 를 감지해 여기에 `### [C-NNN]` 엔트리를 추가합니다.
-> 사용자가 직접 편집해도 무방합니다. 항목 형식은 `conventions/README.md` 참고.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/gotchas/conductor.md

@@ -1,38 +0,0 @@
----
-docmeta:
-  id: gotchas-conductor
-  title: Gotchas — uconductor
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, conductor]
----
-
-# Gotchas — uconductor
-
-> Dispatcher 가 관리. uconductor 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->
-
-### [G-001] Team mode 큐 누락 금지
-
-- Status: verified
-- Date: 2026-05-08
-- Trigger: `progress.json.mode == "team"` 인데 `.harness/actions/feature-queue.json` 이 없거나 teams 가 모두 idle 인 채 단일 `next_agent` 만 진행
-- Rule: Team mode 진입 시 반드시 `scripts/harness-queue-manager.sh init|recover` 로 queue 를 준비하고, `auto-dispatch` 결과의 모든 pair 를 background worker 로 spawn 해야 한다. tmux monitor 만 띄우고 worker spawn 없이 종료하면 실패다.
-- Evidence: okx/seller 최신 배포본에서 `mode=team` 이지만 `feature-queue.json` 이 없어 병렬 worker 가 시작될 수 없었다.
-
-### [G-002] Parallel tracks 직렬화 금지
-
-- Status: verified
-- Date: 2026-05-08
-- Trigger: `tracks.length >= 2` 인 회의 결정 후 첫 트랙만 running, 나머지는 pending 으로 두고 완료 후 다음 트랙을 dispatch
-- Rule: parallel tracks 는 같은 tick 에 모든 독립 트랙을 running/spawn 대상으로 노출해야 한다. 완료 순서만 rendezvous 에서 join 하며, dispatch 자체를 sequence 로 만들면 안 된다.
-- Evidence: v6.2 fork-join 문서와 달리 conductor 구현/meeting-manager 문구가 “첫 번째 트랙 완료 후 다음 pending” 형태로 남아 있었다.

package/gotchas/coo-developer.md

@@ -1,22 +0,0 @@
----
-docmeta:
-  id: gotchas-coo-developer
-  title: Gotchas — ucoo-udeveloper
-  type: input
-  createdAt: 2026-05-08T00:00:00Z
-  updatedAt: 2026-05-08T00:00:00Z
-  source:
-    producer: user
-    skillId: harness-dispatcher
-  inputs: []
-  tags: [gotchas, coo-developer]
----
-
-# Gotchas — ucoo-udeveloper
-
-> Dispatcher 가 관리. ucoo-udeveloper 는 세션 시작 시 이 파일을 읽고 같은 실수를 반복하지 않습니다.
-> 
-> 항목 형식은 `gotchas/README.md` 참조. Dispatcher 가 사용자의 실수 지적을 감지하면 자동으로
-> `### [G-NNN]` 항목을 append 합니다. 사용자가 직접 편집해도 무방합니다.
-
-<!-- 항목이 추가되면 아래에 기록됩니다 -->