moai harness 하네스
moai harness 은 SPEC 복잡도 라우팅과 하네스 학습 서브시스템을 관리하는 통합 커맨드 트리입니다. 라우팅, 검증, 라이프사이클, 제안 관리, v4 하네스 라이프사이클, 관찰 기록(ledger) 하위 명령어를 제공합니다.
SPEC 규모에 따라 어느 정도의 하네스(harness) 게이트가 필요한지를 판정하는 일은 관리자 에이전트가 매번 반복해야 하는 결정이기 때문에, 이 커맨드는 관찰 기록(ledger) 을 누적하면서 라우팅 규칙이 실제로 어떻게 쓰이는지를 추적합니다. 따라서 라우팅 부정확이 반복될 때 원인을 추적할 수 있는 단일 근거가 됩니다.
공통 플래그로 --project-root <path> (기본: 현재 디렉터리)를 받습니다.
| 명령어 | 설명 |
|---|---|
moai harness route --spec <id> | SPEC을 minimal/standard/thorough 하네스 레벨로 라우팅 |
moai harness validate | harness.yaml을 스키마·불변조건 기준으로 검증 |
route 는 --json (JSON 출력), --path <harness.yaml>, --base-dir <dir> 플래그를 받습니다.
| 명령어 | 설명 |
|---|---|
moai harness status | 관찰/티어/진화 요약 표시 |
moai harness apply | 대기 중인 제안을 오케스트레이터에 반환 (또는 --execute 로 Go apply 경로 실행) |
moai harness rollback <date> | 지정 날짜의 스냅샷 복원 |
moai harness disable | 학습 서브시스템 비활성화 (learning.enabled: false) |
| 명령어 | 설명 |
|---|---|
moai harness mute | 제안 카테고리 음소거 (workflow.yaml) |
moai harness mute-list | 현재 음소거된 카테고리 출력 |
moai harness unmute | 카테고리를 음소거 목록에서 제거 |
moai harness verify | 하네스 결정성 검증 |
| 명령어 | 설명 |
|---|---|
moai harness list | 모든 v4 하네스 나열 (이름 + 도메인 + 진입 커맨드) |
moai harness edit <name> | v4 하네스 manifest + specialist 편집 경로 표시 |
moai harness remove <name> | v4 하네스 원자적 제거 (커맨드 + workflow + specialist + skill + manifest) |
moai harness doctor | 하네스 설치 상태 진단 |
list, edit 는 --json 플래그를 받습니다.
moai harness ledger 는 라우팅 관찰 기록을 관리합니다.
| 명령어 | 설명 |
|---|---|
moai harness ledger record | dispatch 시점 라우팅 결정 기록 (pending row) |
moai harness ledger annotate | 이미 존재하는 pending row 에 라우팅 메타데이터를 패치 |
moai harness ledger evidence | pending row에 기계 증거 ref (또는 위임 항목) 추가 |
moai harness ledger list | 필터로 최종 원장 row 나열 |
ledger record와ledger evidence는 결과(outcome)를 위조할 수 없도록--outcome플래그를 노출하지 않습니다. 결과는 기계 증거에서 도출됩니다.
moai harness delegation 은 관찰된 라우팅 기록으로부터 위임 맵(delegation map) 분석을 다룹니다.
| 명령어 | 설명 |
|---|---|
moai harness delegation analyze | 관찰된 위임 내역을 분석해 위임 맵 제안 생성 |