@walwal-harness/cli 4.0.0-beta.1 → 4.0.0-beta.3

package/bin/init.js

@@ -129,17 +129,56 @@ function scaffoldHarness() {
     }
   }
 
-  // Copy config.json
+  // config.json — ALWAYS update (harness system file, not user data)
+  // But preserve user's custom settings (pre_eval_gate.frontend_cwd, behavior, etc.)
   const configSrc = path.join(PKG_ROOT, 'assets', 'templates', 'config.json');
   const configDest = path.join(HARNESS_DIR, 'config.json');
-  if (fs.existsSync(configSrc) && (!fileExists(configDest) || isForce)) {
-    copyFile(configSrc, configDest);
+  if (fs.existsSync(configSrc)) {
+    if (fileExists(configDest) && !isForce) {
+      // Merge: keep user's customizations, update harness structure
+      try {
+        const existing = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        const template = JSON.parse(fs.readFileSync(configSrc, 'utf8'));
+        // Preserve user customizations
+        const userPreserve = {
+          behavior: existing.behavior,
+          'flow.pre_eval_gate.frontend_cwd': existing?.flow?.pre_eval_gate?.frontend_cwd,
+          'flow.pre_eval_gate.backend_cwd': existing?.flow?.pre_eval_gate?.backend_cwd,
+          'flow.pre_eval_gate.frontend_checks': existing?.flow?.pre_eval_gate?.frontend_checks,
+          'flow.pre_eval_gate.backend_checks': existing?.flow?.pre_eval_gate?.backend_checks,
+        };
+        // Write template, then re-apply user settings
+        fs.writeFileSync(configDest, JSON.stringify(template, null, 2) + '\n');
+        // Re-apply preserved user settings
+        const merged = JSON.parse(fs.readFileSync(configDest, 'utf8'));
+        if (userPreserve.behavior) merged.behavior = userPreserve.behavior;
+        if (userPreserve['flow.pre_eval_gate.frontend_cwd']) {
+          merged.flow.pre_eval_gate.frontend_cwd = userPreserve['flow.pre_eval_gate.frontend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_cwd']) {
+          merged.flow.pre_eval_gate.backend_cwd = userPreserve['flow.pre_eval_gate.backend_cwd'];
+        }
+        if (userPreserve['flow.pre_eval_gate.frontend_checks']) {
+          merged.flow.pre_eval_gate.frontend_checks = userPreserve['flow.pre_eval_gate.frontend_checks'];
+        }
+        if (userPreserve['flow.pre_eval_gate.backend_checks']) {
+          merged.flow.pre_eval_gate.backend_checks = userPreserve['flow.pre_eval_gate.backend_checks'];
+        }
+        fs.writeFileSync(configDest, JSON.stringify(merged, null, 2) + '\n');
+        log('config.json updated (user settings preserved)');
+      } catch (e) {
+        copyFile(configSrc, configDest);
+        log('config.json replaced (merge failed)');
+      }
+    } else {
+      copyFile(configSrc, configDest);
+    }
   }
 
-  // Copy HARNESS.md
+  // HARNESS.md — ALWAYS update
   const harnessMdSrc = path.join(PKG_ROOT, 'assets', 'templates', 'HARNESS.md');
   const harnessMdDest = path.join(HARNESS_DIR, 'HARNESS.md');
-  if (fs.existsSync(harnessMdSrc) && (!fileExists(harnessMdDest) || isForce)) {
+  if (fs.existsSync(harnessMdSrc)) {
     copyFile(harnessMdSrc, harnessMdDest);
   }
 
@@ -190,16 +229,23 @@ function installSkills() {
     .filter(d => d.isDirectory())
     .map(d => d.name);
 
+  // Remove obsolete skills (cleaned up in v4)
+  const obsoleteSkills = ['harness-generator-frontend-flutter', 'harness-evaluator-functional-flutter', 'harness-team'];
+  for (const obs of obsoleteSkills) {
+    const obsPath = path.join(CLAUDE_SKILLS_DIR, obs);
+    if (fs.existsSync(obsPath)) {
+      fs.rmSync(obsPath, { recursive: true, force: true });
+      log(`  Removed obsolete: ${obs}`);
+    }
+  }
+
   for (const skill of skills) {
     const src = path.join(skillsSrc, skill);
     const dest = path.join(CLAUDE_SKILLS_DIR, `harness-${skill}`);
 
-    if (!fileExists(dest) || isForce) {
-      copyDir(src, dest);
-      log(`  Installed: harness-${skill}`);
-    } else {
-      log(`  Skipped (exists): harness-${skill}`);
-    }
+    // Skills are ALWAYS overwritten — they are harness-managed, not user-editable
+    copyDir(src, dest);
+    log(`  Installed: harness-${skill}`);
   }
 
   log('Skills installation complete');
@@ -214,6 +260,21 @@ function installScripts() {
   const scriptsSrc = path.join(PKG_ROOT, 'scripts');
   const scriptsDest = path.join(PROJECT_ROOT, 'scripts');
 
+  // Remove obsolete scripts from previous versions
+  const obsoleteScripts = [
+    'harness-studio-v4.sh',
+    'harness-control-v4.sh',
+    'harness-prompts-v4.sh',
+    'harness-team-worker.sh',
+  ];
+  for (const obs of obsoleteScripts) {
+    const obsPath = path.join(scriptsDest, obs);
+    if (fs.existsSync(obsPath)) {
+      fs.unlinkSync(obsPath);
+      log(`  Removed obsolete: ${obs}`);
+    }
+  }
+
   // Core scripts are ALWAYS overwritten on update (not user-editable)
   // These contain harness logic that must stay in sync with the CLI version
   const coreScripts = new Set([
@@ -421,6 +482,28 @@ function installUserPromptSubmitHook() {
 // ─────────────────────────────────────────
 // 4. AGENTS.md + CLAUDE.md
 // ─────────────────────────────────────────
+// ─────────────────────────────────────────
+// 3d. Agent Teams env var
+// ─────────────────────────────────────────
+function installAgentTeamsEnv() {
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+  let settings = {};
+  if (fileExists(settingsPath)) {
+    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) {}
+  }
+
+  if (!settings.env) settings.env = {};
+
+  if (settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] !== '1') {
+    settings.env['CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS'] = '1';
+    ensureDir(path.dirname(settingsPath));
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    log('Agent Teams enabled (CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)');
+  } else {
+    log('Agent Teams already enabled');
+  }
+}
+
 function setupAgentsMd() {
   const agentsMd = path.join(PROJECT_ROOT, 'AGENTS.md');
   const claudeMd = path.join(PROJECT_ROOT, 'CLAUDE.md');
@@ -703,6 +786,7 @@ function main() {
   installSessionHook();
   installStatusline();
   installUserPromptSubmitHook();
+  installAgentTeamsEnv();
   setupAgentsMd();
   checkPlaywrightMcp();
   checkRecommendedSkills();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "4.0.0-beta.1",
+  "version": "4.0.0-beta.3",
   "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer (requirements refinement). Supports React and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/skills/team-action/SKILL.md

@@ -1,64 +1,26 @@
 ---
 name: harness-team-action
-description: "v4 Agent Teams 가동. feature-queue를 초기화하고 3개 Teammate를 생성하여 Feature 단위 Gen→Eval 병렬 실행을 시작한다. 트리거: '/harness-team-action', 'team 시작', 'agent team 가동', '팀 시작', '팀 가동'"
+description: "v4 Agent Teams 가동. feature-queue를 초기화하고 3개 Teammate를 생성하여 Feature 병렬 실행. 트리거: '/harness-team-action', 'team 시작', '팀 가동'"
 disable-model-invocation: false
 ---
 
 # /harness-team-action — Agent Teams 가동
 
-## 전제 조건
-
-- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 이 `.claude/settings.json`에 설정되어 있어야 함
-- `.harness/actions/feature-list.json`이 존재해야 함 (Planner가 생성)
-
-## 실행 절차
-
-### Step 1: Feature Queue 초기화
-
-먼저 feature-queue.json을 확인/생성합니다:
+## Step 1: Queue 초기화
 
 ```bash
-if [ ! -f .harness/actions/feature-queue.json ]; then
-  bash scripts/harness-queue-manager.sh init .
-else
-  bash scripts/harness-queue-manager.sh recover .
-fi
-bash scripts/harness-queue-manager.sh status .
+if [ ! -f .harness/actions/feature-queue.json ]; then bash scripts/harness-queue-manager.sh init .; else bash scripts/harness-queue-manager.sh recover .; fi && bash scripts/harness-queue-manager.sh status .
 ```
 
-### Step 2: Teammate 생성
-
-**아래 내용을 그대로 실행합니다** — 3명의 Teammate를 생성하여 Feature Queue에서 작업을 분배합니다.
-
-`.harness/actions/feature-queue.json`의 `ready` 큐에서 최대 3개 Feature를 가져와 각 Teammate에게 할당합니다.
-Teammate가 Feature를 완료하면 queue에서 다음 ready Feature를 가져옵니다.
-
-**Teammate 생성 요청:**
-
-3명의 Teammate를 생성하세요:
-
-1. **team-1** (Generator + Evaluator):
-   - `.harness/actions/feature-queue.json`의 `ready` 배열에서 첫 번째 Feature를 가져옴
-   - 해당 Feature에 대해: 코드 생성 → `tsc --noEmit` + `eslint` 검증 → AC 기반 기능 평가
-   - PASS 시: `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .` 실행 후 다음 Feature
-   - FAIL 시: 최대 3회 재시도, 3회 실패 시 `bash scripts/harness-queue-manager.sh fail {FEATURE_ID} .`
-   - AGENTS.md의 파일 소유권 규칙 준수
-
-2. **team-2** (동일 역할): ready 배열에서 두 번째 Feature
-
-3. **team-3** (동일 역할): ready 배열에서 세 번째 Feature
+## Step 2: Teammate 생성
 
-**각 Teammate 공통 규칙:**
-- `.harness/actions/feature-list.json`에서 자신의 Feature 정보(AC, depends_on) 읽기
-- `.harness/actions/api-contract.json`에서 관련 엔드포인트 확인
-- `CONVENTIONS.md` 존재 시 준수
-- Feature 완료 시 `feature-list.json`의 해당 Feature `passes`에 `["generator-frontend", "evaluator-functional"]` 추가
-- 다른 Teammate의 Feature 코드를 수정하지 않음
-- 완료/실패 시 Lead에게 `SendMessage`로 결과 보고
+Queue의 `ready` 배열에서 Feature를 읽고, **3명의 Teammate를 즉시 생성**하세요.
 
-## 실행 후
+각 Teammate에게 전달할 지시:
+- `.harness/actions/feature-queue.json`의 ready에서 Feature 1개를 담당
+- 해당 Feature의 코드를 생성하고, AC(Acceptance Criteria)를 기준으로 자체 검증
+- PASS 시: `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .` 실행
+- FAIL 시: 재시도 (최대 3회), 3회 실패 시 `bash scripts/harness-queue-manager.sh fail {FEATURE_ID} .`
+- 완료 후 Lead에게 결과 보고
 
-- Lead(이 세션)는 **오케스트레이터** — Teammate 진행 모니터링
-- 상태 확인: `bash scripts/harness-queue-manager.sh status .`
-- 실패 Feature 재큐: `bash scripts/harness-queue-manager.sh requeue F-XXX .`
-- 중지: `/harness-team-stop`
+**Teammate 이름**: team-1, team-2, team-3