@walwal-harness/cli 6.1.6 → 7.1.1

package/gotchas/ops.md

@@ -0,0 +1,17 @@
+# OPS Gotchas
+
+## Good-case-only Logging
+
+Do not log only successful service cases. Non-good-case outcomes are the operational evidence that matters.
+
+## Unclassified Emergency
+
+Do not raise an emergency without first classifying likely owner: backend, frontend, platform, external API, or unknown.
+
+## Unmapped Service
+
+Do not monitor a production/service endpoint as live until the Owner-provided server mapping is recorded: environment type, host, port, health path, log path, and source/contact.
+
+## Port Drift
+
+Do not let CXX agents choose arbitrary ports. CEO must set `HARNESS_BASE_PORT` as a `{xx}000` value in `.env`, and services must derive their ports above that base.

package/gotchas/resource-manager.md

@@ -0,0 +1,9 @@
+# Resource Manager Gotchas
+
+## Vague Trigger Wording
+
+Do not register broad aliases that can accidentally invoke the wrong worker.
+
+## False Availability
+
+Do not answer that a worker is available unless it exists in the hired roster and installed skill paths.

package/gotchas/shared.md

@@ -0,0 +1,13 @@
+# Shared Gotchas
+
+## Default Engine Impersonation
+
+Do not let a missing CXX or specialist silently run as the default AI engine. Hire first.
+
+## Command Misuse
+
+Do not add internal slash commands for CXX or workers. Commands are Owner entrypoints only.
+
+## Runtime State In Package Repo
+
+Do not create or commit project runtime `.harness/` state in this package repository.

package/init.sh

@@ -0,0 +1,208 @@
+#!/bin/bash
+# Harness Init Script — 적응형(adaptive) 하네스 진입점 허브
+#
+# 서브커맨드:
+#   help                               — 사용법 출력
+#   check         (default · 무인자)   — 환경 확인 + scan + ref 상태 출력 (기존 동작)
+#   init          [project_root]       — 신규 프로젝트 초기화 (scan → ref placeholder → AGENTS.md → migration preview)
+#   migrate       [project_root]       — v7.1 마이그레이션 적용
+#   refresh-ref   <role> <stack>       — 기존 ref 파일 archive 백업 후 재생성 유도
+#
+# 스택별 서버 기동은 scan-result.json.tech_stack 과 .harness/ref/<role>-<stack>.md.runner 에서
+# 가져온다. NestJS/React 하드코딩은 제거되었다.
+
+set -e
+
+SUBCOMMAND="${1:-check}"
+shift || true
+
+usage() {
+  cat <<'USAGE'
+Harness Init — 적응형 하네스 진입점
+
+Usage:
+  bash init.sh help                                 — 이 메시지
+  bash init.sh check         [project_root]         — 환경 확인 + scan + ref 상태 (기본)
+  bash init.sh init          [project_root]         — scan + ref placeholder 생성 + AGENTS.md + migration dry-run
+  bash init.sh init          [project_root] --apply-migration
+                                                    — init 후 v7.1 마이그레이션까지 적용
+  bash init.sh migrate       [project_root]         — v7.1 마이그레이션 적용
+  bash init.sh migrate       [project_root] --dry-run
+                                                    — v7.1 마이그레이션 미리보기
+  bash init.sh refresh-ref   <role> <stack> [path]  — 기존 ref 파일 백업 후 재생성 안내
+
+스택 독립: 개발 서버 기동 명령은 .harness/ref/<role>-<stack>.md 의 runner.dev_command 에서 조회한다.
+USAGE
+}
+
+run_walwal_cli() {
+  local project_root="$1"
+  shift || true
+  local script_dir
+  script_dir="$(cd "$(dirname "$0")" && pwd)"
+  local cli_path="${script_dir}/bin/init.js"
+
+  if [ -f "$cli_path" ]; then
+    (cd "$project_root" && node "$cli_path" "$@")
+  else
+    (cd "$project_root" && npx walwal-harness "$@")
+  fi
+}
+
+run_migrate() {
+  local project_root="."
+  local mode=""
+
+  if [ "${1:-}" = "--dry-run" ]; then
+    mode="--dry-run"
+  else
+    project_root="${1:-.}"
+    mode="${2:-}"
+  fi
+
+  echo "=== Harness Migration: ${project_root} ==="
+  if [ "$mode" = "--dry-run" ]; then
+    run_walwal_cli "$project_root" migrate --dry-run
+  else
+    run_walwal_cli "$project_root" migrate
+  fi
+}
+
+run_check() {
+  local project_root="${1:-.}"
+  echo "=== Harness Environment Check ==="
+  echo "Working Directory: $(pwd)"
+  echo "Date: $(date)"
+  echo ""
+
+  # Git 상태
+  echo "--- Git Status ---"
+  if [ -d "${project_root}/.git" ]; then
+    git -C "$project_root" log --oneline -5 2>/dev/null || echo "No commits yet"
+    echo ""
+    git -C "$project_root" status --short
+  else
+    echo "Not a git repository — run: git init"
+  fi
+  echo ""
+
+  # Harness 상태
+  echo "--- Harness Status ---"
+  if [ -f "${project_root}/.harness/progress.json" ]; then
+    if [ -f "${project_root}/scripts/lib/harness-render-progress.sh" ]; then
+      (cd "$project_root" && source scripts/lib/harness-render-progress.sh && render_progress "." 2>/dev/null) || cat "${project_root}/.harness/progress.json"
+    else
+      cat "${project_root}/.harness/progress.json"
+    fi
+  else
+    echo "progress.json not found — run: bash init.sh init"
+  fi
+  echo ""
+
+  # scan 상태
+  echo "--- Scan Result ---"
+  if [ -f "${project_root}/.harness/actions/scan-result.json" ]; then
+    jq '{tech_stack, tech_stack_confidence, recommendation}' "${project_root}/.harness/actions/scan-result.json"
+  else
+    echo "scan-result.json not found — run: bash scripts/scan-project.sh ${project_root}"
+  fi
+  echo ""
+
+  # ref 상태
+  echo "--- Ref Docs ---"
+  if [ -d "${project_root}/.harness/ref" ]; then
+    ls -1 "${project_root}/.harness/ref/" 2>/dev/null | grep -v '^\.generated' | sed 's/^/  /' || echo "  (none)"
+  else
+    echo "  .harness/ref/ not present — run: bash init.sh init"
+  fi
+  echo ""
+
+  echo "=== Harness Ready ==="
+}
+
+run_init() {
+  local project_root="."
+  local migration_mode="--dry-run"
+  if [ "${1:-}" = "--apply-migration" ]; then
+    migration_mode="--apply-migration"
+  else
+    project_root="${1:-.}"
+    if [ "${2:-}" = "--apply-migration" ]; then
+      migration_mode="--apply-migration"
+    fi
+  fi
+  echo "=== Harness Init: ${project_root} ==="
+
+  # 1. scan
+  echo "[1/4] scan-project.sh"
+  bash "$(dirname "$0")/scripts/scan-project.sh" "$project_root"
+  echo ""
+
+  # 2. ref placeholder 생성 (감지된 스택 전체)
+  echo "[2/4] init-ref-docs.sh (placeholder)"
+  bash "$(dirname "$0")/scripts/init-ref-docs.sh" --yes --placeholder "$project_root"
+  echo ""
+
+  # 3. AGENTS.md 동적 생성
+  if [ -f "$(dirname "$0")/scripts/init-agents-md.sh" ]; then
+    echo "[3/4] init-agents-md.sh"
+    bash "$(dirname "$0")/scripts/init-agents-md.sh" "$project_root"
+  else
+    echo "[3/4] init-agents-md.sh — skip (not found)"
+  fi
+  echo ""
+
+  # 4. v7.1 migration preview/apply
+  if [ "$migration_mode" = "--apply-migration" ]; then
+    echo "[4/4] walwal-harness migrate"
+    run_walwal_cli "$project_root" migrate
+  else
+    echo "[4/4] walwal-harness migrate --dry-run"
+    run_walwal_cli "$project_root" migrate --dry-run
+  fi
+  echo ""
+
+  echo "=== Init Complete ==="
+  echo "다음 단계:"
+  echo "  1. 각 .harness/ref/<role>-<stack>.md 를 실제 컨텐츠로 채우려면:"
+  echo "     bash init.sh refresh-ref <role> <stack> $project_root"
+  echo "  2. 그 결과 프롬프트를 Claude 세션에 붙여 WebSearch + WebFetch 로 ref 작성"
+  if [ "$migration_mode" != "--apply-migration" ]; then
+    echo "  3. 마이그레이션 미리보기가 적절하면 적용:"
+    echo "     bash init.sh migrate $project_root"
+  fi
+}
+
+run_refresh_ref() {
+  local role="$1" stack="$2" project_root="${3:-.}"
+  if [ -z "$role" ] || [ -z "$stack" ]; then
+    echo "ERROR: bash init.sh refresh-ref <role> <stack> [project_root]" >&2
+    exit 1
+  fi
+
+  local ref_path="${project_root}/.harness/ref/${role}-${stack}.md"
+  local archive_dir="${project_root}/.harness/archive"
+  mkdir -p "$archive_dir"
+
+  if [ -f "$ref_path" ]; then
+    local backup="${archive_dir}/ref-${role}-${stack}-$(date +%Y%m%d%H%M%S).md"
+    mv "$ref_path" "$backup"
+    echo "archive: $backup"
+  fi
+
+  echo ""
+  bash "$(dirname "$0")/scripts/init-ref-docs.sh" --claude-prompt --stack "$stack" --role "$role" "$project_root"
+}
+
+case "$SUBCOMMAND" in
+  help|-h|--help)      usage ;;
+  check)               run_check "$@" ;;
+  init)                run_init "$@" ;;
+  migrate)             run_migrate "$@" ;;
+  refresh-ref)         run_refresh_ref "$@" ;;
+  *)
+    echo "ERROR: unknown subcommand '$SUBCOMMAND'" >&2
+    usage
+    exit 1
+    ;;
+esac

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.1.6",
-  "description": "Production harness for AI agent engineering — NEXUS-adapted company metaphor (Dispatcher/CEO + Conductor + Meeting-Manager + COO/Planner + CTO + CQO + Service-Ops). Always-on company mode, parallel worker pool, Brainstormer, Planner, Generator(BE/FE/Designer/DevOps), Evaluator chain (Code-Quality → Functional → Visual + Architecture/Security). Supports React, Next.js, and Flutter FE stacks.",
+  "version": "7.1.1",
+  "description": "Company-style AI agent harness for Claude and Codex. Installs commands, CXX agents, skills, HR-Resource hiring pool, and project-local .harness runtime state.",
   "bin": {
     "walwal-harness": "bin/init.js"
   },
   "scripts": {
-    "postinstall": "node bin/init.js --auto",
     "init": "node bin/init.js",
     "scan": "bash scripts/scan-project.sh .",
+    "import:agency-agents": "node scripts/import-agency-agents.js",
     "reset": "node bin/init.js --force"
   },
   "keywords": [
@@ -19,22 +19,16 @@
     "skill",
     "command",
     "company-mode",
-    "parallel-workers",
-    "brainstorming",
-    "planner",
-    "generator",
-    "evaluator",
-    "nexus",
+    "hr-resource",
+    "hiring",
+    "resource-manager",
     "ceo",
+    "coo",
+    "cdo",
     "cto",
     "cqo",
-    "conductor",
-    "meeting-manager",
-    "service-ops",
-    "nestjs",
-    "react",
-    "flutter",
-    "playwright"
+    "ops",
+    "brick-office"
   ],
   "author": "",
   "license": "MIT",
@@ -48,12 +42,13 @@
   },
   "files": [
     "bin/",
-    "skills/",
+    "HR-Resource/",
     "scripts/",
     "commands/",
     "assets/",
     "gotchas/",
     "conventions/",
+    "init.sh",
     "CHANGELOG.md"
   ]
 }

package/scripts/harness-runtime-stop.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# harness-runtime-stop.sh — Stop walwal harness play/release runtime 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"
+PROGRESS="$HARNESS_DIR/progress.json"
+CONFIG="$HARNESS_DIR/config.json"
+RUNTIME_DIR="$HARNESS_DIR/runtime"
+
+[ -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; }
+
+MODE_FILE="$RUNTIME_DIR/harness-mode"
+ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+stopped=0
+
+for pid_file in "$RUNTIME_DIR/play.pid" "$RUNTIME_DIR/release.pid"; do
+  [ -f "$pid_file" ] || continue
+  pid="$(cat "$pid_file" 2>/dev/null || true)"
+  if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+    kill "$pid" 2>/dev/null || true
+    sleep 1
+    if kill -0 "$pid" 2>/dev/null; then
+      kill -9 "$pid" 2>/dev/null || true
+    fi
+    stopped=$((stopped + 1))
+  fi
+  rm -f "$pid_file"
+done
+
+rm -f "$MODE_FILE"
+
+tmp_config="$(mktemp)"
+jq '
+  .runtime.build.live = false |
+  .runtime.production.live = false
+' "$CONFIG" > "$tmp_config" && mv "$tmp_config" "$CONFIG" || rm -f "$tmp_config"
+
+tmp="$(mktemp)"
+jq --arg ts "$ts" --arg reason "$*" '
+  .runtime_state.mode = "stopped" |
+  .runtime_state.stopped_at = $ts |
+  .runtime_state.stop_reason = $reason |
+  .runtime_state.pid = null |
+  .service_ops.requested_mode = null |
+  .service_ops.monitor.stream_active = false |
+  .runtime.build.live = false |
+  .runtime.production.live = false
+' "$PROGRESS" > "$tmp" && mv "$tmp" "$PROGRESS" || rm -f "$tmp"
+
+echo "stopped runtime processes: $stopped"