@walwal-harness/cli 6.0.4 → 6.0.5

package/CHANGELOG.md

@@ -29,6 +29,27 @@ docmeta:
 
 # Changelog
 
+## 6.0.5 — migrate 가 gotcha entry / bundle version 까지 sync (2026-05-07)
+
+### Why
+Owner 보고 — `npm install @walwal-harness/cli@latest && npx walwal-harness migrate` 가 "이미 최신 버전입니다" 로 종료. 그러나 v6.0.4 에서 새로 추가된 `gotchas/conductor.md` 의 [G-005], [G-006], `gotchas/service-ops.md`, `gotchas/generator-frontend.md [G-001]` 가 사용자 프로젝트에 merge 되지 않음. **존재 여부 (3 항목 — progress v4 / config.mode_selection / M-NEXUS-P3) 만 확인하고 콘텐츠는 비교 안 함** → 본질적 버그.
+
+### Changes
+- **bin/init.js `detectMigrationNeeded`** — 두 신규 시그널 추가:
+  - `gotchaMissingEntries`: `gotchas/*.md` 별로 패키지 → 사용자 [G-NNN] entry 차이 산출 (memory.md 패턴과 동일)
+  - `bundleVersionStale`: `.harness/.bundle-version` 스탬프와 패키지 버전 비교
+- **bin/init.js `runMigrate`** — gotcha entry append + bundle stamp 갱신 단계 추가. 사용자가 직접 추가한 [G-NNN] entry 는 절대 건드리지 않으며, 패키지의 신규 시스템 entry 만 끝에 추가.
+- **bin/init.js `extractGotchaEntryBlock` / `extractEntryBlock`** — JS 정규식 `\Z` 미지원 fix. 마지막 entry 가 추출 누락되던 버그 동시 해결 (v6.0.2 부터 잠재).
+- **bin/init.js main flow** — 콘텐츠 드리프트 없이 stamp 만 누락된 경우 init 종료 시 자동 갱신. stamp 만으로 매번 migrate 권유 알림이 뜨는 것 방지.
+
+### Migration
+```bash
+npm install @walwal-harness/cli@latest
+npx walwal-harness migrate     # gotchas/conductor.md G-005/G-006, gotchas/service-ops.md, gotchas/generator-frontend.md G-001 자동 append + stamp 갱신
+npx walwal-harness verify
+```
+사용자 [G-NNN] entry 는 보존되고 시스템 entry 만 끝에 append. 변경 전 `.harness/archive/migration-<ts>/gotchas-<file>` 백업.
+
 ## 6.0.4 — Sub-skill 협업 + Service-Ops 상시 + Team 병렬 spawn (2026-05-07)
 
 ### Why

package/bin/init.js

@@ -988,7 +988,41 @@ function detectMigrationNeeded() {
     progressV3toV4: false,
     configMissingModeSelection: false,
     memoryMissingSystemEntries: [],
+    gotchaMissingEntries: {},   // { "<filename>": [G-IDs...] }
+    bundleVersionStale: null,    // { current, installed }
   };
+
+  // Gotcha entry-level diff: for each bundled gotcha file, compare entry IDs.
+  // 사용자가 직접 추가한 [G-NNN] 은 절대 건드리지 않으며, 패키지에서 새로
+  // 도입된 시스템 entry 만 append 대상.
+  const gotchasSrc = path.join(PKG_ROOT, 'gotchas');
+  const gotchasDest = path.join(HARNESS_DIR, 'gotchas');
+  if (fs.existsSync(gotchasSrc) && fs.existsSync(gotchasDest)) {
+    const files = fs.readdirSync(gotchasSrc).filter((f) => f.endsWith('.md') && f !== 'README.md');
+    for (const file of files) {
+      const srcPath = path.join(gotchasSrc, file);
+      const destPath = path.join(gotchasDest, file);
+      if (!fs.existsSync(destPath)) continue;  // installSkills/init 이 처리
+      try {
+        const srcIds = extractGotchaEntryIds(fs.readFileSync(srcPath, 'utf8'));
+        const dstIds = new Set(extractGotchaEntryIds(fs.readFileSync(destPath, 'utf8')));
+        const missing = srcIds.filter((id) => !dstIds.has(id));
+        if (missing.length) flags.gotchaMissingEntries[file] = missing;
+      } catch {}
+    }
+  }
+
+  // Bundle version stamp: detects fresh package vs. last-applied bundle.
+  // Even if the 3 schema flags pass, a newer bundle may have introduced new
+  // gotcha/SKILL/template content the user hasn't seen yet.
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
+    const stampPath = path.join(HARNESS_DIR, '.bundle-version');
+    const installed = fs.existsSync(stampPath) ? fs.readFileSync(stampPath, 'utf8').trim() : null;
+    if (installed !== pkg.version) {
+      flags.bundleVersionStale = { current: pkg.version, installed };
+    }
+  } catch {}
   if (fs.existsSync(progressPath)) {
     try {
       const p = JSON.parse(fs.readFileSync(progressPath, 'utf8'));
@@ -1025,7 +1059,29 @@ function extractEntryIds(md) {
 // Extracts a single entry block (heading + body until next ### or EOF) from the template.
 function extractEntryBlock(md, id) {
   const escId = id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  const re = new RegExp(`(^### \\[${escId}\\][\\s\\S]*?)(?=^### \\[|\\Z)`, 'm');
+  const re = new RegExp(`(^### \\[${escId}\\][\\s\\S]*?)(?=^### \\[|$(?![\\s\\S]))`, 'm');
+  const m = md.match(re);
+  return m ? m[1].trimEnd() : null;
+}
+
+// Returns gotcha entry IDs ("[G-001]", "[G-NEXUS-P3]" etc.) found in a markdown body.
+// Supports both `### [G-NNN]` and `## [G-NNN] ...` heading levels.
+function extractGotchaEntryIds(md) {
+  const re = /^#{2,3}\s+\[(G-[A-Z0-9_-]+)\]/gm;
+  const ids = [];
+  let m;
+  while ((m = re.exec(md)) !== null) ids.push(m[1]);
+  return ids;
+}
+
+// Extracts a single gotcha entry block from a markdown body.
+function extractGotchaEntryBlock(md, id) {
+  const escId = id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  // JS lacks \Z; emulate end-of-string via (?![\s\S]) negative lookahead.
+  const re = new RegExp(
+    `(^#{2,3}\\s+\\[${escId}\\][\\s\\S]*?)(?=^#{2,3}\\s+\\[G-|$(?![\\s\\S]))`,
+    'm',
+  );
   const m = md.match(re);
   return m ? m[1].trimEnd() : null;
 }
@@ -1048,6 +1104,17 @@ function showMigrationProposal(flags) {
     console.log('    [' + flags.memoryMissingSystemEntries.join(', ') + ']');
     console.log('    사용자 [M-NNN] entry 는 보존, 시스템 entry 만 끝에 추가.');
   }
+  const gotchaSummary = Object.entries(flags.gotchaMissingEntries || {});
+  if (gotchaSummary.length) {
+    console.log('  • gotchas/: 시스템 entry 누락 — entry-level append 가능 (사용자 [G-NNN] 보존)');
+    for (const [file, ids] of gotchaSummary) {
+      console.log(`    ${file}: [${ids.join(', ')}]`);
+    }
+  }
+  if (flags.bundleVersionStale) {
+    const { current, installed } = flags.bundleVersionStale;
+    console.log(`  • bundle: ${installed ?? '(없음)'} → ${current} 스탬프 갱신 필요`);
+  }
   console.log('');
   console.log('  적용:  npx walwal-harness migrate');
   console.log('  미리보기:  npx walwal-harness migrate --dry-run');
@@ -1060,13 +1127,18 @@ function showMigrationProposal(flags) {
 function runMigrate(opts = {}) {
   const dryRun = opts.dryRun || false;
   const flags = detectMigrationNeeded();
+  const gotchaMissingTotal = Object.values(flags.gotchaMissingEntries || {}).reduce((n, a) => n + a.length, 0);
   if (
     !flags.progressV3toV4 &&
     !flags.configMissingModeSelection &&
-    (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0)
+    (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0) &&
+    gotchaMissingTotal === 0 &&
+    !flags.bundleVersionStale
   ) {
     console.log('');
-    log('이미 최신 버전입니다 (progress v' + TARGET_PROGRESS_VERSION + ' + config.mode_selection + memory 시스템 entry 모두 존재).');
+    let pkgVer = 'unknown';
+    try { pkgVer = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8')).version; } catch {}
+    log(`이미 최신 — bundle v${pkgVer} 일치, progress v${TARGET_PROGRESS_VERSION}, config.mode_selection, memory 시스템 entry, gotcha entry 모두 sync.`);
     return;
   }
 
@@ -1141,6 +1213,39 @@ function runMigrate(opts = {}) {
     }
   }
 
+  // 4. gotcha entry merge — for each bundled gotcha file, append missing
+  //    [G-NNN] entries while preserving everything the user already has.
+  const gotchaMissing = flags.gotchaMissingEntries || {};
+  for (const [file, missingIds] of Object.entries(gotchaMissing)) {
+    if (!missingIds.length) continue;
+    const srcPath = path.join(PKG_ROOT, 'gotchas', file);
+    const destPath = path.join(HARNESS_DIR, 'gotchas', file);
+    if (!fs.existsSync(srcPath) || !fs.existsSync(destPath)) continue;
+    const original = fs.readFileSync(destPath, 'utf8');
+    const tpl = fs.readFileSync(srcPath, 'utf8');
+    const blocks = [];
+    for (const id of missingIds) {
+      const block = extractGotchaEntryBlock(tpl, id);
+      if (block) blocks.push(block);
+    }
+    if (!blocks.length) continue;
+    log(`  gotchas/${file}: 시스템 entry ${blocks.length}개 append (${missingIds.join(', ')})`);
+    if (!dryRun) {
+      fs.writeFileSync(path.join(backupDir, `gotchas-${file}`), original);
+      const sep = original.endsWith('\n') ? '\n' : '\n\n';
+      fs.writeFileSync(destPath, original + sep + blocks.join('\n\n') + '\n');
+    }
+  }
+
+  // 5. Bundle version stamp — record which package version was last applied.
+  if (flags.bundleVersionStale) {
+    const { current, installed } = flags.bundleVersionStale;
+    log(`  .bundle-version: ${installed ?? '(none)'} → ${current}`);
+    if (!dryRun) {
+      fs.writeFileSync(path.join(HARNESS_DIR, '.bundle-version'), current + '\n');
+    }
+  }
+
   console.log('');
   if (dryRun) {
     log('Dry-run 완료 — 실제 변경 적용하려면 `npx walwal-harness migrate` 실행');
@@ -1320,8 +1425,20 @@ function main() {
 
   // v6.0 — propose migration if existing project is on v3
   const migFlags = detectMigrationNeeded();
-  if (migFlags.progressV3toV4 || migFlags.configMissingModeSelection) {
+  const gotchaMissing = Object.keys(migFlags.gotchaMissingEntries || {}).length > 0;
+  const hasContentDrift =
+    migFlags.progressV3toV4 ||
+    migFlags.configMissingModeSelection ||
+    (migFlags.memoryMissingSystemEntries && migFlags.memoryMissingSystemEntries.length) ||
+    gotchaMissing;
+  if (hasContentDrift) {
     showMigrationProposal(migFlags);
+  } else if (migFlags.bundleVersionStale) {
+    // 콘텐츠 드리프트 없이 stamp 만 누락/오래됨 → 정합성 차원에서 직접 갱신.
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
+      fs.writeFileSync(path.join(HARNESS_DIR, '.bundle-version'), pkg.version + '\n');
+    } catch {}
   }
 
   // v6.0 — Brick Office dashboard one-liner

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.0.4",
+  "version": "6.0.5",
   "description": "Production harness for AI agent engineering — NEXUS-adapted company metaphor (Dispatcher/CEO + Conductor + Meeting-Manager + COO/Planner + CTO + CQO + Service-Ops). Solo/Team mode, Brainstormer, Planner, Generator(BE/FE/Designer/DevOps), Evaluator chain (Code-Quality → Functional → Visual + Architecture/Security). Supports React, Next.js, and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/scripts/harness-archive.sh

@@ -1,109 +0,0 @@
-#!/bin/bash
-# harness-archive.sh — 스프린트 종료 시 자동 아카이빙
-#
-# 동작:
-#   1. .harness/actions/ 의 스프린트 산출물을 .harness/archive/D-NNN/S-NNN/ 로 이동
-#   2. progress.json 의 sprint 상태를 초기화 (신규 dispatch 준비)
-#   3. dispatch.id 가 없으면 counter++ 로 새 dispatch 시작
-#
-# 유지되는 파일 (이동하지 않음):
-#   - .harness/gotchas/**, .harness/conventions/**, .harness/ref/**
-#   - .harness/config.json, .harness/memory.md
-#   - .harness/progress.json (초기화만)
-#
-# 호출 주체: harness-next.sh (next_agent="archive" 도달 시 자동)
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-source "$SCRIPT_DIR/lib/harness-render-progress.sh" 2>/dev/null || true
-
-PROJECT_ROOT="${1:-.}"
-PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"
-
-PROGRESS="$PROJECT_ROOT/.harness/progress.json"
-ACTIONS_DIR="$PROJECT_ROOT/.harness/actions"
-ARCHIVE_ROOT="$PROJECT_ROOT/.harness/archive"
-
-if [ ! -f "$PROGRESS" ]; then
-  echo "[archive] ERROR: progress.json not found" >&2
-  exit 1
-fi
-
-command -v jq >/dev/null 2>&1 || { echo "[archive] ERROR: jq required" >&2; exit 1; }
-
-# ── Read current dispatch/sprint numbers ──
-dispatch_counter=$(jq -r '.dispatch.counter // 0' "$PROGRESS")
-dispatch_id=$(jq -r '.dispatch.id // empty' "$PROGRESS")
-sprint_num=$(jq -r '.sprint.number // 0' "$PROGRESS")
-
-# Ensure dispatch id exists (fallback for legacy progress.json without dispatch)
-if [ -z "$dispatch_id" ] || [ "$dispatch_id" = "null" ]; then
-  if [ "$dispatch_counter" -lt 1 ]; then
-    dispatch_counter=1
-  fi
-  dispatch_id=$(printf 'D-%03d' "$dispatch_counter")
-fi
-
-sprint_id=$(printf 'S-%03d' "$sprint_num")
-target_dir="$ARCHIVE_ROOT/$dispatch_id/$sprint_id"
-
-echo ""
-echo "  ── Archive ────────────────────────────"
-echo "  Dispatch : $dispatch_id"
-echo "  Sprint   : $sprint_id"
-echo "  Target   : ${target_dir#$PROJECT_ROOT/}"
-
-# ── Move actions/ contents into archive ──
-if [ -d "$ACTIONS_DIR" ] && [ "$(ls -A "$ACTIONS_DIR" 2>/dev/null)" ]; then
-  mkdir -p "$target_dir"
-  moved=0
-  for f in "$ACTIONS_DIR"/*; do
-    [ -e "$f" ] || continue
-    name="$(basename "$f")"
-    if [ -e "$target_dir/$name" ]; then
-      # Collision — suffix with timestamp to avoid overwrite
-      ts=$(date +%Y%m%d-%H%M%S)
-      mv "$f" "$target_dir/${name%.}.${ts}"
-    else
-      mv "$f" "$target_dir/"
-    fi
-    moved=$((moved + 1))
-  done
-  echo "  Moved    : $moved file(s)"
-else
-  echo "  Moved    : 0 file(s) (actions/ empty)"
-fi
-
-# ── Reset progress.json for next dispatch ──
-# - sprint → init
-# - agents → cleared
-# - artifacts → pending
-# - dispatch.id cleared (next dispatcher run will allocate new D-NNN)
-# - failure → cleared
-jq --arg now "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '
-  .pipeline = null
-  | .dispatch.id = null
-  | .sprint = { number: 0, status: "init", retry_count: 0 }
-  | .current_agent = null
-  | .agent_status = "pending"
-  | .completed_agents = []
-  | .next_agent = "dispatcher"
-  | .failure = { agent: null, location: null, message: null, retry_target: null }
-  | (.artifacts // {}) as $a
-  | .artifacts = ($a | with_entries(
-      if (.value | type) == "object"
-      then .value = { status: "pending", updated_by: null, updated_at: null }
-      else .
-      end))
-  | .updated_at = $now
-' "$PROGRESS" > "${PROGRESS}.tmp" && mv "${PROGRESS}.tmp" "$PROGRESS"
-
-# ── Clear handoff so next session starts fresh ──
-HANDOFF="$PROJECT_ROOT/.harness/handoff.json"
-echo '{}' > "$HANDOFF"
-
-echo "  Status   : archived, progress reset"
-echo ""
-echo "  ✓ 다음 요청은 새로운 dispatch 로 시작합니다."
-echo ""

package/scripts/harness-dashboard-up.sh

@@ -1,72 +0,0 @@
-#!/usr/bin/env bash
-# walwal-harness — Brick Office dashboard launcher
-#
-# 처음 쓰는 사용자도 한 줄로 대시보드를 띄워볼 수 있게 만든 helper.
-# walwal-harness CLI 패키지에는 R3F + Next.js 무게 때문에 dashboard 가 미포함이고,
-# 본 스크립트가 git sparse-checkout 으로 apps/harness-dashboard/ 만 가져와서
-# 사용자 프로젝트 외부 (~/.walwal-harness/dashboard) 에 격리 설치 후 dev 실행한다.
-#
-# Usage:
-#   bash scripts/harness-dashboard-up.sh                 # install + dev (port 3001)
-#   bash scripts/harness-dashboard-up.sh --port 3050     # override port
-#   HARNESS_ROOT=/path/to/project bash ...               # explicit harness root
-set -euo pipefail
-
-REPO_URL="${WALWAL_HARNESS_REPO:-https://github.com/30eggis/walwal-harness.git}"
-DASHBOARD_PATH="apps/harness-dashboard"
-LOCAL_DIR="${HOME}/.walwal-harness/dashboard"
-PORT="${PORT:-3001}"
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --port) PORT="$2"; shift 2 ;;
-    --reinstall) rm -rf "$LOCAL_DIR"; shift ;;
-    --help|-h)
-      sed -n '2,16p' "$0"
-      exit 0 ;;
-    *) echo "[brick-office] unknown arg: $1" >&2; exit 2 ;;
-  esac
-done
-
-if [[ -z "${HARNESS_ROOT:-}" ]]; then
-  HARNESS_ROOT="$(pwd)"
-fi
-if [[ ! -d "${HARNESS_ROOT}/.harness" ]]; then
-  echo "[brick-office] FAIL: ${HARNESS_ROOT} 에 .harness/ 가 없습니다."
-  echo "                먼저 'npx walwal-harness' 로 초기화하세요."
-  exit 3
-fi
-
-echo "[brick-office] HARNESS_ROOT = ${HARNESS_ROOT}"
-echo "[brick-office] dashboard 격리 경로 = ${LOCAL_DIR}"
-
-if [[ ! -d "${LOCAL_DIR}/${DASHBOARD_PATH}" ]]; then
-  echo "[brick-office] 첫 실행 — git sparse-checkout 으로 dashboard 만 가져옵니다 (~5MB)."
-  mkdir -p "${LOCAL_DIR}"
-  cd "${LOCAL_DIR}"
-  git init -q
-  git remote add origin "${REPO_URL}" 2>/dev/null || true
-  git config core.sparseCheckout true
-  echo "${DASHBOARD_PATH}/" > .git/info/sparse-checkout
-  git fetch --depth=1 origin main -q
-  git checkout main -q
-  echo "[brick-office] 다운로드 완료."
-fi
-
-cd "${LOCAL_DIR}/${DASHBOARD_PATH}"
-
-if [[ ! -d node_modules ]]; then
-  echo "[brick-office] npm install (한 번만 실행, ~30s)..."
-  npm install --no-audit --no-fund --loglevel=error
-fi
-
-echo ""
-echo "╔══════════════════════════════════════════════════════════╗"
-echo "║  Brick Office — http://localhost:${PORT}"
-echo "║                                                          ║"
-echo "║  HARNESS_ROOT 이 가리키는 프로젝트의 .harness/ 상태를     ║"
-echo "║  실시간 (SSE) 시각화합니다. Ctrl+C 로 종료.              ║"
-echo "╚══════════════════════════════════════════════════════════╝"
-echo ""
-
-HARNESS_ROOT="${HARNESS_ROOT}" npm run dev:dashboard -- -p "${PORT}"