@walwal-harness/cli 6.1.3 → 6.1.5

package/CHANGELOG.md

@@ -29,6 +29,44 @@ docmeta:
 
 # Changelog
 
+## 6.2.0 — Always-on company runtime + legacy purge (2026-05-08)
+
+### Why
+회사모드 only 정렬. 솔로/팀 모드의 잔재 스크립트와 분기 로직이 SKILL/문서 곳곳에 남아 있어 Owner 가 "지금 어떤 모드인지" 혼동하고, 한 시간이 지나도 자율 활동이 일어나지 않는 (스케줄러 부재) 문제 발생. 추가로 Claude 가 미래 시각으로 progress.log 라인을 미리 적어 가짜 진행을 보고하는 환각이 관찰됨.
+
+### Added
+- **Stop 훅** (`scripts/harness-stop.sh`) — Claude turn 종료 시 conductor 가 running 이면 자동으로 다음 tick 으로 연쇄. `behavior.auto_chain_on_stop=false` 로 비활성, `behavior.auto_chain_max_per_sprint` 로 상한 (기본 200).
+- **launchd hourly wake** (`scripts/harness-wake.sh`, `scripts/harness-wake-install.sh`, `assets/launchd/com.walwal.harness-wake.plist.template`) — 1시간마다 idle ≥ 55분 프로젝트의 tmux 에 wake prompt 송출.
+- **Truthful Logging Heal** — `harness-session-start.sh` 가 `progress.log` 의 미래 시각 라인을 자동으로 `progress.log.future-quarantine.<ts>` 로 격리 + 메인 로그에서 제거.
+- **conductor / dispatcher SKILL 의 정직성 룰** — "미래 시각 progress.log 항목 금지" Inviolable 섹션 추가, Owner "최근 1시간 뭐 했냐" 질문 시 디스크 mtime 으로 정직 답변하도록 명시.
+- **meeting-manager SKILL 의 라이브 가시화 계약** — `meetings.active` 가 평탄한 agent ID 배열이라는 데이터 계약을 명시. convene 시 active=[참석자], dispatch 시 active=[] 로 갱신해야 미니피규어가 회의실로 텔레포트.
+
+### Removed (legacy purge)
+- `scripts/harness-dashboard.sh` — tmux ASCII 대시보드 pane (3D Brick Office 가 대체).
+- `scripts/harness-monitor.sh` — 3-team worker pane (회사모드는 동적 worker pool).
+- `scripts/harness-prompt-history.sh` — tmux Studio 전용 pane.
+- `scripts/harness-gotcha-memory.sh` — tmux Studio 전용 pane.
+- `scripts/harness-tmux.sh` — tmux Studio launcher (회사모드는 단일 Claude CLI + 브라우저 대시보드).
+- `scripts/harness-goal-init.sh`, `scripts/harness-goal-show.sh` — 외부 호출 0 건의 고아.
+- `commands/harness-company.md` — Studio launch 명령 (런타임 자동화로 불필요).
+- `bin/init.js`: `runTeamStudio()` + `company` / `studio` / `studio-v4` / `v4` subcommand 제거.
+
+### Migration
+기존 프로젝트는 `npx walwal-harness --force` 또는 다음만 수동 적용:
+1. `.claude/settings.json` 에 Stop 훅 추가 (matcher: "", command: `bash scripts/harness-stop.sh`).
+2. `bash scripts/harness-wake-install.sh install <project-root>` 로 1시간 안전망 등록 (선택).
+3. `~/<project>/scripts/` 에서 위 7개 legacy 스크립트 제거.
+
+## 6.1.4 — Template + package files alignment with v6 NEXUS (2026-05-08)
+
+### Why
+6.1.3 까지 `assets/templates/HARNESS.md` 와 `assets/templates/config.json` 의 메타 헤더가 v3 시절 "7-Agent Production Harness / 5.6.0" 으로 정지해 있어, `--force` 가 stale 템플릿을 그대로 덮어쓰는 회귀 발생. 또 신규 `conventions/` 디렉토리가 `package.json` "files" 에 누락되어 게시 패키지에 포함되지 않았다.
+
+### Changed
+- `assets/templates/HARNESS.md`: v6 NEXUS 도큐트린 기준으로 전면 재작성 (단일 대화 창구·조직도·디렉토리·실행 흐름·6종 회의·parallel-tracks·Solo/Team/Hypothesis 모드·품질 게이트·자주 쓰는 명령).
+- `assets/templates/config.json`: `harness.name` / `version` / `description` 메타 헤더를 v6.1.4 NEXUS 기준으로 갱신.
+- `package.json` "files": `conventions/` 추가 (이제 게시 tarball 에 포함됨).
+
 ## 6.1.3 — Parallel-tracks fork-join + role gotchas/conventions backfill (2026-05-08)
 
 ### Added

package/README.md

@@ -224,74 +224,27 @@ bash scripts/harness-token-limit.sh . mark 300
 
 핵심은 운영 품질이 아니라 빠른 사실 확인입니다.
 
-## 런타임 모드
+## 런타임 (회사모드 always-on)
 
-`progress.mode` 는 회사 실행 상태를 뜻합니다. 회의 결정의 `tracks[]` 와는 별개이며, fork-join 은 `tracks.length` 로만 판단합니다.
+회사모드는 유일한 런타임이며 항상 켜져 있습니다. `progress.mode == "company"` 가 항상 참이고, 별도 모드 전환 명령은 없습니다.
 
-### Company / Team
+자율 진행은 두 메커니즘으로 유지됩니다:
 
-기본 경로입니다. Conductor 가 `progress.mode=auto` 에서 선택합니다.
+- **Stop 훅** — Claude 가 한 turn 을 끝내려는 시점에 발화. `conductor.state == "running"` 이고 다음 부서가 있으면 자동으로 turn 을 한 번 더 굴려 끊김 없이 연쇄.
+- **launchd hourly wake (선택)** — 1시간마다 macOS 가 `scripts/harness-wake.sh` 를 호출. idle ≥ 55분이고 `paused/completed/escalated` 가 아닌 프로젝트만 깨움.
 
-특징:
-
-- 회사형 루프 유지
-- control-plane 과 worker-plane 분리
-- feature queue 기반 병렬 처리
-- tmux studio 사용 가능
-
-강제 전환:
-
-```text
-/harness-team
-```
-
-### Solo
-
-비상용 fallback 입니다.
-
-사용 시점:
-
-- 디버깅
-- 스크립트 장애
-- 짧은 수동 복구
-
-강제 전환:
-
-```text
-/harness-solo
-```
-
-### Stop
-
-Team 모드를 안전하게 멈추고 진행 중이던 feature 를 ready 로 복구합니다.
-
-```text
-/harness-stop
-```
-
-## Team Studio
-
-Team 모드에서는 tmux 기반 Studio 레이아웃을 사용합니다.
-
-시작:
-
-```text
-/harness-team
-```
+```bash
+# 1시간 안전망 wake 등록
+bash scripts/harness-wake-install.sh install .
 
-또는:
+# 상태 확인
+bash scripts/harness-wake-install.sh status
 
-```bash
-npx walwal-harness team
+# 즉시 한 번 발화 (테스트)
+bash scripts/harness-wake-install.sh run-now
 ```
 
-Team Studio 는 보통 다음을 보여줍니다.
-
-- Dashboard
-- Gotchas
-- Conventions
-- Memory
-- Team 1~3 worker pane
+회의 결정의 `tracks[]` 는 진행 흐름의 fork-join 단위이며 런타임 모드와는 별개입니다 (`tracks.length ≥ 2` 일 때 parallel).
 - Archive prompt
 
 Queue 관련 유용한 명령:
@@ -345,15 +298,22 @@ bash scripts/harness-queue-manager.sh idle-slots .
 
 | 스크립트 | 역할 |
 |---|---|
-| `scripts/harness-next.sh` | handoff 생성과 다음 agent 결정 |
-| `scripts/conductor-tick.sh` | company loop 라우팅 |
-| `scripts/harness-session-start.sh` | 새 세션 시작 시 자동 안내 |
-| `scripts/harness-user-prompt-submit.sh` | prompt 훅 주입/차단 |
-| `scripts/harness-task-session.sh` | agent 별 task session 생성 |
-| `scripts/harness-token-limit.sh` | TokenLimit hold/resume 마킹 |
-| `scripts/harness-queue-manager.sh` | team queue 관리 |
-| `scripts/harness-dashboard.sh` | dashboard 렌더 |
+| `scripts/conductor-tick.sh` | 회사 루프 라우터 — 다음 부서 결정 |
+| `scripts/harness-next.sh` | turn 종료 후 handoff 생성 + gotcha/convention 자동 등록 + audit gate |
+| `scripts/harness-progress-set.sh` | progress.json partial update 헬퍼 |
+| `scripts/harness-session-start.sh` | SessionStart 훅 (+ future-dated 라인 자동 격리) |
+| `scripts/harness-user-prompt-submit.sh` | UserPromptSubmit 훅 |
+| `scripts/harness-stop.sh` | Stop 훅 — turn 종료 시 자동 연쇄 |
+| `scripts/harness-wake.sh` | 1시간 안전망 wake (launchd 가 호출) |
+| `scripts/harness-wake-install.sh` | launchd 등록/관리 CLI |
+| `scripts/harness-statusline.sh` | 1줄 statusLine 렌더 |
+| `scripts/harness-queue-manager.sh` | feature queue 관리 |
 | `scripts/harness-meeting-doc.sh` | 회의 문서 skeleton / decision 처리 |
+| `scripts/harness-task-session.sh` | agent 별 task session (TokenLimit) |
+| `scripts/harness-token-limit.sh` | TokenLimit hold/resume 마킹 |
+| `scripts/harness-archive.sh` | sprint 종료 archive |
+| `scripts/harness-gotcha-register.sh` | evaluator output 의 gotcha_candidates 자동 등록 |
+| `scripts/harness-dashboard-up.sh` | Brick Office (브라우저 3D 대시보드) 기동 |
 
 ## 디렉토리 구조
 
@@ -414,17 +374,26 @@ cat .harness/progress.json | jq '.task_stop'
 bash scripts/harness-queue-manager.sh status .
 ```
 
-### mode 강제 전환
+### Stop 훅 자동 연쇄가 안 도는지 점검
 
-```text
-/harness-team
-/harness-solo
-/harness-stop
+```bash
+# config 확인 — auto_chain_on_stop 이 true 여야 함
+jq '.behavior.auto_chain_on_stop // true' .harness/config.json
+
+# stop_chain_count 와 sprint 상한 확인
+jq '{count: .conductor.stop_chain_count, max: 200}' .harness/progress.json
+```
+
+### 1시간 wake 가 발화 안 하는지 점검
+
+```bash
+bash scripts/harness-wake-install.sh status
+tail -30 ~/.walwal-harness/logs/wake.log
 ```
 
 ## 버전 호환성
 
-README 는 v6.1 계열 회사형 하네스를 기준으로 작성되었습니다.
+README 는 v6.x 계열 always-on 회사모드 기준입니다 (solo/team 모드 영구 제거).
 
 이 문서에서 전제하는 기능:
 

package/assets/launchd/com.walwal.harness-wake.plist.template

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.walwal.harness-wake</string>
+
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>{{WAKE_SCRIPT}}</string>
+    </array>
+
+    <key>StartInterval</key>
+    <integer>3600</integer>
+
+    <key>RunAtLoad</key>
+    <false/>
+
+    <key>StandardOutPath</key>
+    <string>{{LOG_DIR}}/wake.stdout.log</string>
+
+    <key>StandardErrorPath</key>
+    <string>{{LOG_DIR}}/wake.stderr.log</string>
+
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+    </dict>
+</dict>
+</plist>

package/assets/templates/CONVENTIONS.md

@@ -14,6 +14,18 @@
 - 모노리스보다 모듈러 아키텍처 선호
 -->
 
+### Walwal-Harness Company Contract
+
+walwal-harness는 단순 작업 파이프라인이 아니라 "회사 구조 + 자율 구조 + 하네스"다.
+
+- Owner는 최초 GOAL과 escalation에만 관여한다. 최초 GOAL 이후 Owner 입력은 interrupt/additional request이며 회사가 대기하는 이유가 아니다.
+- Dispatcher/CEO는 Owner와의 유일한 외부 창구다.
+- Planner/COO는 GOAL을 work package, queue, 가설, plan으로 바꾼다.
+- CTO는 구현, 아키텍처, 기술선택, runtime recovery 책임자다.
+- CQO는 품질, 회귀, evidence, PASS/FAIL 책임자다.
+- Service-Ops는 운영 신호, KPI, incident, monitor cadence 책임자다.
+- Meeting-Manager는 상태표가 아니라 임원 회의록을 남긴다. 회의록에는 CEO/COO/CTO/CQO/Service-Ops의 Position, Evidence, Action이 있어야 한다.
+
 ## Code Style
 
 <!-- 코드 스타일 규칙을 여기에 작성하세요 -->