@walwal-harness/cli 7.1.7 → 7.1.9

package/apps/harness-dashboard/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@walwal-harness/dashboard",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Brick Office — walwal-harness 라이브 대시보드 (Phase C)",
+  "scripts": {
+    "dev:dashboard": "next dev -p 3001",
+    "build": "next build",
+    "start": "next start -p 3001",
+    "lint": "next lint",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "e2e": "playwright test"
+  },
+  "dependencies": {
+    "@react-three/drei": "^10.7.7",
+    "@react-three/fiber": "^9.6.1",
+    "chokidar": "^4.0.0",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "three": "^0.184.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.48.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/three": "^0.184.1",
+    "@vitest/ui": "^2.1.0",
+    "autoprefixer": "^10.4.0",
+    "postcss": "^8.4.0",
+    "tailwindcss": "^3.4.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}

package/apps/harness-dashboard/playwright.config.ts

@@ -0,0 +1,23 @@
+import { defineConfig, devices } from "@playwright/test";
+
+export default defineConfig({
+  testDir: "./e2e",
+  timeout: 30_000,
+  expect: { timeout: 5_000 },
+  fullyParallel: false,
+  retries: 0,
+  reporter: [["list"]],
+  use: {
+    baseURL: "http://localhost:3001",
+    trace: "off",
+  },
+  webServer: {
+    command: "npm run dev:dashboard",
+    url: "http://localhost:3001",
+    reuseExistingServer: true,
+    timeout: 60_000,
+  },
+  projects: [
+    { name: "chromium", use: { ...devices["Desktop Chrome"] } },
+  ],
+});

package/apps/harness-dashboard/postcss.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

package/apps/harness-dashboard/tailwind.config.ts

@@ -0,0 +1,49 @@
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+  content: [
+    "./app/**/*.{ts,tsx}",
+    "./components/**/*.{ts,tsx}",
+    "./hooks/**/*.{ts,tsx}",
+    "./lib/**/*.{ts,tsx}",
+  ],
+  theme: {
+    extend: {
+      colors: {
+        "brick-bg": "#0b1020",
+        "brick-floor": "#1a2236",
+        "brick-wall": "#2a3450",
+        "aura-idle": "#4b5563",
+        "aura-typing": "#22d3ee",
+        "aura-talking": "#fbbf24",
+        "aura-alert": "#ef4444",
+      },
+      fontFamily: {
+        mono: ["ui-monospace", "Menlo", "monospace"],
+      },
+      keyframes: {
+        "aura-pulse": {
+          "0%, 100%": { opacity: "0.6" },
+          "50%": { opacity: "1" },
+        },
+        "aura-blink": {
+          "0%, 100%": { opacity: "0.4" },
+          "50%": { opacity: "1" },
+        },
+        "alert-shake": {
+          "0%, 100%": { transform: "translateX(0)" },
+          "25%": { transform: "translateX(-1px)" },
+          "75%": { transform: "translateX(1px)" },
+        },
+      },
+      animation: {
+        "aura-pulse": "aura-pulse 1.4s ease-in-out infinite",
+        "aura-blink": "aura-blink 0.8s ease-in-out infinite",
+        "alert-shake": "alert-shake 0.3s ease-in-out infinite",
+      },
+    },
+  },
+  plugins: [],
+};
+
+export default config;

package/apps/harness-dashboard/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    },
+    "types": ["node", "vitest/globals"]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/apps/harness-dashboard/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from "vitest/config";
+import path from "node:path";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: true,
+    include: ["lib/**/*.test.ts", "lib/__tests__/**/*.test.ts"],
+  },
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "."),
+    },
+  },
+});

package/assets/templates/AGENTS-ko /341/204/207/341/205/251/341/206/250/341/204/211/341/205/241/341/204/207/341/205/251/341/206/253.md"

@@ -0,0 +1,114 @@
+# AGENTS.md — {{PROJECT_NAME}}
+# walwal-harness v7.1 | Company Mode
+# 설치일: {{DATE}} | CLAUDE.md는 이 파일의 심볼릭 링크입니다.
+
+---
+
+## 1. 진입점
+
+Owner가 회사에 접근하는 명령은 두 개뿐이다. 그 외의 경로는 없다.
+
+| 명령 | 사용 시점 |
+|---|---|
+| `/goal` | 미션 설정, 수정, 추가 |
+| `/hot-fix` | 활성 goal과 독립된 긴급 수정 |
+
+`/ceo`, `/cto`, `/cqo`, `/coo`, `/cdo`, `/ops`, `/hiring`은 slash command가 아니다.
+내부 라우팅은 agent/skill wiring으로만 처리한다.
+
+---
+
+## 2. 행동 전 확인
+
+가정하지 않는다. 불명확한 것을 숨기지 않는다.
+
+- 구현 전 가정을 명시한다. 불확실하면 질문한다.
+- 여러 접근이 가능하면 모두 제시한다 — 조용히 선택하지 않는다.
+- 요청을 해결하는 최소한의 변경만 한다. 추측성 scope는 금지.
+- 불명확한 부분이 있으면 멈춘다. 무엇이 불명확한지 명시하고 질문한다.
+
+hot-fix: 가장 작은 올바른 패치만. 인접 코드를 "개선"하지 않는다.
+goal: CEO가 CXX에 라우팅하기 전에 검증 가능한 성공 기준을 정의한다.
+
+---
+
+## 3. Company 구조
+
+```
+Owner
+  └─ /goal 또는 /hot-fix
+      └─ harness-ceo          오케스트레이터 — Owner의 유일한 접점
+          ├─ harness-coo      리서치, 가설, 서비스 방향
+          ├─ harness-cdo      브랜딩, UI/UX, 디자인 리뷰
+          ├─ harness-cto      아키텍처, API, 플랫폼, 구현 총괄
+          ├─ harness-cqo      품질 게이트, 회귀, archive, gotcha/convention 관리
+          └─ harness-ops      빌드 모니터링, 로그 분석, 서비스 이벤트
+```
+
+각 CXX는:
+- **독립된 fresh session 컨텍스트**에서 실행된다 — CEO 세션과 메모리를 공유하지 않는다
+- 결정을 `.harness/documents/{mission_name}/{cxx}.md`에 기록한다
+- 모든 전문 작업을 hired worker에게 위임한다 — 직접 실행하지 않는다
+- 필요한 worker가 없으면 `harness-hiring`을 먼저 호출한다
+
+CEO는 worker 기록 없이 완료된 산출물을 포함한 CXX 보고서를 거부한다.
+
+---
+
+## 4. 미션 플로우
+
+### Goal
+
+1. CEO가 Owner 요청을 읽고 판단한다: 브레인스토밍 먼저, 또는 즉시 실행.
+2. CEO가 관련 CXX에게만 범위를 한정한 질문을 전달한다.
+3. 각 CXX가 worker를 고용하고, 위임하고, 결과를 수집하여 `{cxx}.md`에 기록한다.
+4. CEO가 CXX 산출물을 종합하여 다음 CXX에 라우팅하거나 Owner에게 보고한다.
+
+**완료 기준:** `.harness/documents/{mission_name}/ceo.md`에 최종 Owner 보고가 존재한다.
+
+### Hot Fix
+
+1. CEO가 긴급 요청을 받고 즉시 CTO와 CQO를 소집한다.
+2. CTO가 최소 패치 경로를 설계하고 구현 worker를 고용한다.
+3. Worker가 구현한다. CTO가 worker 증거를 검증하고 `cto.md`를 작성한다.
+4. CQO가 회귀 게이트를 실행한다. `.harness/gotchas/` 또는 `.harness/conventions/`에 교훈을 등록하고 `cqo.md`를 작성한다.
+5. CQO 판정 **PASS** 이후에만 archive한다.
+
+**완료 기준:** `cto.md`, `cqo.md`, 그리고 최소 하나의 신규 gotcha 또는 convention 항목이 존재한다.
+
+주의: harness 문서(ceo.md, cto.md, cqo.md, worker 보고서)에 대한 docmeta skip 판단은 미션 프로토콜 단계를 건너뛸 권한을 부여하지 않는다. 이 파일들은 분석 산출물이 아니라 미션 기록이다.
+
+---
+
+## 5. 하네스 런타임
+
+| 경로 | 역할 |
+|---|---|
+| `.harness/documents/{mission}/` | 미션별 CXX 결정 기록 및 worker 보고서 |
+| `.harness/conventions/` | 지속 규칙 (CQO가 작성, 미션을 넘어 유지) |
+| `.harness/gotchas/` | 재발 방지 기록 (CQO가 hot-fix마다 작성) |
+| `.harness/memories/` | 장기 공유 컨텍스트 |
+| `.harness/shared/HR-Resource/` | 채용 가능한 worker skill pool |
+| `.harness/archive/` | CQO 승인 완료 미션 (불변) |
+| `.harness/logs/YYYY-MM-DD/` | OPS 예외 로그 (비정상 케이스만) |
+
+`.harness/`는 미션 상태 저장소다. 빌드 산출물이 아니다. 삭제하지 않는다.
+
+---
+
+## 6. 금지 규칙
+
+1. **`{mission}/cto.md` 없이 소스 코드 편집 금지** — CTO의 범위 승인이 있어야 소스 파일을 수정할 수 있다.
+2. **CXX 사칭 금지** — 현재 모델이 CEO/CTO/CQO를 인라인으로 대행하지 않는다. 설치된 harness skill을 fresh session에서 사용한다.
+3. **이름 없는 worker 금지** — 모든 전문 작업은 `harness-hiring` → `harness-resource-manager`를 거친다.
+4. **CQO 판정 없이 archive 금지** — 명시적 PASS가 담긴 `{mission}/cqo.md`가 존재해야 한다.
+5. **gotcha 등록 생략 금지** — 모든 hot-fix는 `.harness/gotchas/` 또는 `.harness/conventions/`에 최소 하나의 항목을 만든다.
+6. **미션 중 이 파일 편집 금지** — AGENTS.md를 수정하려면 별도 `/goal`을 제출한다.
+
+---
+
+## 7. 프로젝트 컨텍스트
+
+- **기술 스택**: {{TECH_STACK}}
+- **프로젝트 구조**: {{PROJECT_STRUCTURE}}
+- **하네스 설치일**: {{DATE}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "7.1.7",
+  "version": "7.1.9",
   "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"
@@ -43,6 +43,16 @@
   "files": [
     "bin/",
     "HR-Resource/",
+    "apps/harness-dashboard/app/",
+    "apps/harness-dashboard/components/",
+    "apps/harness-dashboard/hooks/",
+    "apps/harness-dashboard/lib/",
+    "apps/harness-dashboard/public/",
+    "apps/harness-dashboard/*.json",
+    "apps/harness-dashboard/*.js",
+    "apps/harness-dashboard/*.mjs",
+    "apps/harness-dashboard/*.ts",
+    "apps/harness-dashboard/*.tsx",
     "scripts/",
     "commands/",
     "assets/",

package/scripts/harness-dashboard-up.sh

@@ -2,9 +2,9 @@
 # walwal-harness — Brick Office dashboard launcher
 #
 # 처음 쓰는 사용자도 한 줄로 대시보드를 띄워볼 수 있게 만든 helper.
-# walwal-harness CLI 패키지에는 R3F + Next.js 무게 때문에 dashboard 가 미포함이고,
-# 본 스크립트가 git sparse-checkout 으로 apps/harness-dashboard/ 만 가져와서
-# 사용자 프로젝트 외부 (~/.walwal-harness/dashboard/<project-key>) 에 격리 설치 후 dev 실행한다.
+# npm 패키지에 포함된 apps/harness-dashboard 를 사용자 프로젝트 외부
+# (~/.walwal-harness/dashboard/<project-key>) 에 격리 복사 후 dev 실행한다.
+# 구버전 호환을 위해 패키지에 dashboard 가 없으면 git sparse-checkout 으로 fallback 한다.
 #
 # Usage:
 #   bash scripts/harness-dashboard-up.sh                 # install + dev (port 3001)
@@ -16,6 +16,7 @@ REPO_URL="${WALWAL_HARNESS_REPO:-https://github.com/30eggis/walwal-harness.git}"
 DASHBOARD_PATH="apps/harness-dashboard"
 PORT="${PORT:-3001}"
 REINSTALL=false
+PACKAGE_VERSION="unknown"
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -40,6 +41,13 @@ fi
 PROJECT_KEY="$(printf '%s' "${HARNESS_ROOT}" | shasum -a 1 | awk '{print substr($1,1,12)}')"
 PROJECT_NAME="$(basename "${HARNESS_ROOT}")"
 LOCAL_DIR="${HOME}/.walwal-harness/dashboard/${PROJECT_NAME}-${PROJECT_KEY}"
+VERSION_FILE="${LOCAL_DIR}/.walwal-dashboard-version"
+
+PACKAGE_ROOT="${HARNESS_ROOT}/node_modules/@walwal-harness/cli"
+PACKAGED_DASHBOARD="${PACKAGE_ROOT}/${DASHBOARD_PATH}"
+if [[ -f "${PACKAGE_ROOT}/package.json" ]]; then
+  PACKAGE_VERSION="$(node -p "require('${PACKAGE_ROOT}/package.json').version" 2>/dev/null || echo unknown)"
+fi
 
 if [[ "$REINSTALL" == "true" ]]; then
   rm -rf "$LOCAL_DIR"
@@ -48,7 +56,19 @@ fi
 echo "[brick-office] HARNESS_ROOT = ${HARNESS_ROOT}"
 echo "[brick-office] dashboard 격리 경로 = ${LOCAL_DIR}"
 
-if [[ ! -d "${LOCAL_DIR}/${DASHBOARD_PATH}" ]]; then
+if [[ -d "${PACKAGED_DASHBOARD}" ]]; then
+  INSTALLED_VERSION=""
+  if [[ -f "${VERSION_FILE}" ]]; then
+    INSTALLED_VERSION="$(cat "${VERSION_FILE}" 2>/dev/null || true)"
+  fi
+  if [[ ! -d "${LOCAL_DIR}/${DASHBOARD_PATH}" || "${INSTALLED_VERSION}" != "${PACKAGE_VERSION}" ]]; then
+    echo "[brick-office] dashboard sync from npm package @walwal-harness/cli@${PACKAGE_VERSION}"
+    rm -rf "${LOCAL_DIR:?}/${DASHBOARD_PATH}"
+    mkdir -p "${LOCAL_DIR}/apps"
+    cp -R "${PACKAGED_DASHBOARD}" "${LOCAL_DIR}/apps/"
+    printf '%s\n' "${PACKAGE_VERSION}" > "${VERSION_FILE}"
+  fi
+elif [[ ! -d "${LOCAL_DIR}/${DASHBOARD_PATH}" ]]; then
   echo "[brick-office] 첫 실행 — git sparse-checkout 으로 dashboard 만 가져옵니다 (~5MB)."
   mkdir -p "${LOCAL_DIR}"
   cd "${LOCAL_DIR}"