@walwal-harness/cli 6.0.4 → 6.1.0

package/CHANGELOG.md

@@ -29,6 +29,69 @@ docmeta:
 
 # Changelog
 
+## 6.1.0 — document-driven company loop + task-session isolation (2026-05-08)
+
+### Why
+v6.0.x 는 회사형 조직 비유와 Cxx 라우팅을 문서로는 설명했지만, 실제 런타임은 여전히 얕았다. 특히 다음 두 결함이 컸다.
+
+- 회의 결과가 `누가 다음 owner 인가` 를 구조적으로 기록하지 않음
+- `goal_adherence` 하락 시 원인 분류 없이 Planner로 보내는 경향이 있음
+
+또한 agent 간 자기강화 편향을 줄이기 위한 문서 중심 task session 분리도 충분히 강제되지 않았다.
+
+### Changes
+- **document-driven meeting decision**
+  - `meeting-manager` 가 `notice.md`, `prep-*.md`, `meeting-<id>.md` skeleton 을 자동 생성
+  - 회의 기록에 `decision.owner`, `action_type`, `rationale`, `evidence`, `drift_classification` JSON 블록 추가
+  - `conductor-tick` 은 더 이상 `meeting_reason` 문자열만 보지 않고 회의 decision 문서를 우선 읽어 다음 owner 를 결정
+- **goal drift classification**
+  - `implementation_drift | planning_drift | ops_drift | goal_drift` 분류 추가
+  - 분류별 기본 라우팅:
+    - `implementation_drift -> cto`
+    - `planning_drift -> planner`
+    - `ops_drift -> service-ops`
+    - `goal_drift -> dispatcher`
+- **task-session isolation**
+  - `harness-next` 가 다음 agent 마다 `.harness/actions/task-sessions/<agent>/<id>.md` 생성
+  - `handoff.json` 에 `task_session_path` 추가
+  - `UserPromptSubmit` 가 running agent 와 다른 `/harness-*` 호출을 경고가 아니라 **hard block**
+- **direct invocation policy**
+  - 모든 harness skill 의 `disable-model-invocation` 을 `false` 로 통일
+  - orchestration/control-plane 과 worker/evaluator 모두 직접 호출 가능 상태로 정리
+- **archive reset hardening**
+  - archive 시 `workflow`, `meetings.decision`, `service_ops.drift_classification`, `task_sessions.current` 초기화
+
+### Validation
+- `bash -n` 으로 주요 스크립트 문법 검증
+- `jq empty` 로 `config.json`, `progress.json` 검증
+- `/private/tmp` 샌드박스에서:
+  - `dispatcher -> meeting-manager` 시 회의 문서 자동 생성 확인
+  - 회의 decision 편집 후 `dispatcher / planner / cto` 로 문서 기반 재라우팅 확인
+  - `goal_adherence` 하락 시 drift classification 반영 확인
+  - context isolation hard block 확인
+  - `task_session_path` 생성 확인
+
+## 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/commands/harness-solo.md

@@ -1,7 +1,7 @@
 ---
 docmeta:
   id: harness-solo
-  title: /harness-solo — Solo Mode 시작/전환
+  title: /harness-solo — 비상용 Single-Agent Fallback
   type: input
   createdAt: 2026-04-20T00:00:00Z
   updatedAt: 2026-05-07T00:00:00Z
@@ -24,14 +24,14 @@ docmeta:
   tags: [harness, solo-mode, command, override, v6]
 ---
 
-# /harness-solo — Solo Mode 사용자 Override (v6.0+)
+# /harness-solo — 비상용 Single-Agent Fallback (v6.0+)
 
-> v6.0 부터 모드 결정은 **Conductor 가 자동**으로 합니다 (config.json `mode_selection.rules`). 본 명령은 Conductor 의 자동 결정을 사용자가 강제로 덮어쓰는 **override** 입니다.
+> v6.0 의 정상 경로는 회사형 자동 루프입니다. 본 명령은 그 루프를 일시적으로 벗어나는 **비상용 override** 입니다.
 >
 > **효과**: `progress.json.mode = "solo"` 강제 + `mode_decision.user_override = "solo"` 기록. 현재 sprint 끝까지 유지. 다음 sprint 진입 시 Conductor 가 재자동결정. **Auto 복귀**: 사용자 발화 "auto 로 돌려" 또는 "Conductor 결정으로".
 
-프롬프트 기반으로 하네스 파이프라인을 순차 진행합니다.
-Team 모드에서 전환 시, 진행 중이던 피처의 상태를 보존하고 Solo로 이어갑니다.
+디버깅, 스크립트 장애, 수동 hotfix 같은 예외 상황에서만 사용합니다.
+회사 루프에서 전환 시, 진행 중이던 피처의 상태를 보존하고 단일 에이전트 fallback 으로 이어갑니다.
 
 ## 실행 절차
 
@@ -49,12 +49,12 @@ echo "현재 모드: $MODE"
 bash scripts/harness-queue-manager.sh recover .
 
 # mode를 solo로 설정
-jq '.mode = "solo" | .team_state.active_teams = 0 | .team_state.paused_at = (now | todate)' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+jq '.mode = "solo" | .mode_decision.user_override = "solo" | .team_state.active_teams = 0 | .team_state.paused_at = (now | todate)' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
 ```
 
 **paused → solo 전환 시:**
 ```bash
-jq '.mode = "solo"' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+jq '.mode = "solo" | .mode_decision.user_override = "solo"' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
 ```
 
 ### Step 2: 현재 진행 상태 표시
@@ -75,29 +75,29 @@ fi
 progress.json의 `next_agent` 필드를 확인하여 다음 단계를 안내합니다:
 
 - **next_agent = "dispatcher"** → "프롬프트로 요구사항을 입력하면 자동으로 dispatcher가 분석합니다."
-- **next_agent = "planner"** → "/harness-planner 를 호출하거나, 계획을 요청하세요."
-- **next_agent = "generator-backend"** → "/harness-generator-backend 를 호출하세요."
-- **next_agent = "generator-frontend"** → "/harness-generator-frontend 를 호출하세요."
-- **next_agent = "evaluator-functional"** → "/harness-evaluator-functional 를 호출하세요."
-- **next_agent = "evaluator-visual"** → "/harness-evaluator-visual 를 호출하세요."
+- **next_agent = "planner"** → Planner 단계가 다음입니다. SessionStart / 내부 handoff가 연결돼 있으면 자동 진입, 아니면 해당 스킬을 수동 호출합니다.
+- **next_agent = "generator-backend"** → Backend generator 단계가 다음입니다.
+- **next_agent = "generator-frontend"** → Frontend generator 단계가 다음입니다.
+- **next_agent = "evaluator-functional"** → Functional evaluator 단계가 다음입니다.
+- **next_agent = "evaluator-visual"** → Visual evaluator 단계가 다음입니다.
 
 ### Step 4: Solo 모드 진행
 
-각 에이전트는 완료 즉시 **`/harness-next` 슬래시 명령을 자동 호출** 하여 다음 에이전트로 핸드오프합니다 (사용자가 매번 bash 명령을 칠 필요 없음).
+각 에이전트는 완료 즉시 **내부 handoff(`harness-next.sh` 또는 SessionStart hook)** 로 다음 에이전트에 넘겨집니다. Owner가 `/harness-next` 를 직접 다룬다는 전제는 6.0 회사 모델과 맞지 않습니다.
 
 **예외 — 사용자 승인 게이트가 있는 단계:**
-- **Brainstorming**: brainstorm-spec.md 완성 후 사용자 승인 대기 → 승인 시 자동 `/harness-next`
-- **Planner**: plan.md / api-contract.json 완성 후 사용자 승인 대기 → 승인 시 자동 `/harness-next`
+- **Brainstorming**: brainstorm-spec.md 완성 후 사용자 승인 대기 → 승인 시 내부 handoff
+- **Planner**: plan.md / api-contract.json 완성 후 사용자 승인 대기 → 승인 시 내부 handoff
 
-흐름이 멈췄거나 수동으로 다음 단계를 트리거하고 싶으면 사용자가 직접 `/harness-next` 입력 가능.
+흐름이 멈췄다면 원인은 보통 내부 handoff 스크립트/훅 미설치 또는 `next_agent` 불일치입니다. 이 경우 상태 파일과 hook 설치 상태를 먼저 점검합니다.
 
 feature-queue.json이 존재하는 경우:
 - 피처 완료(evaluator PASS) 시 `bash scripts/harness-queue-manager.sh pass {FEATURE_ID} .`를 호출하여 공유 상태 업데이트
 - Team 모드로 전환해도 이미 완료된 피처는 skip됨
 
-## Solo 모드에서 가능한 작업
+## 사용 권장 상황
 
 - 프롬프트로 각 에이전트 순차 실행
-- 코드 직접 수정 및 디버깅
-- 피처 단위 작업 선택
-- Team 모드로 언제든 전환: `/harness-team`
+- 내부 handoff 스크립트 장애 시 응급 복구
+- 아주 짧은 수동 hotfix / 상태 수선
+- 정상 회사 루프로 복귀: `/harness-team`

package/commands/harness-team.md

@@ -54,7 +54,7 @@ Planner가 완료한 feature-list.json의 피처들을 최대 3개 팀이 병렬
 
 ```bash
 # progress.json에 mode=team 설정
-jq '.mode = "team" | .team_state.active_teams = 3 | .team_state.paused_at = null' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
+jq '.mode = "team" | .mode_decision.user_override = "team" | .team_state.active_teams = 3 | .team_state.paused_at = null' .harness/progress.json > /tmp/progress_tmp.json && mv /tmp/progress_tmp.json .harness/progress.json
 
 # Queue 초기화 또는 복구
 if [ ! -f .harness/actions/feature-queue.json ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "6.0.4",
+  "version": "6.1.0",
   "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"