운영 하네스 문서화

This commit is contained in:
2026-06-18 01:47:50 +09:00
parent 782fe74578
commit 3afca069df
15 changed files with 120 additions and 80 deletions
+24 -75
View File
@@ -26,86 +26,35 @@ node core_satellite_collector.js
## 운영 표준
하네스/보고서/동기화까지 포함한 최종 게이트는 아래 순서를 사용합니다.
릴리즈와 패키징의 기준 진입점은 아래를 사용합니다.
```powershell
npm run ops:release
```
릴리즈 DAG의 엄격 판정이 필요하면 아래를 사용합니다.
```powershell
npm run full-gate
```
이 스크립트는 아래를 직렬로 수행합니다.
- `convert-data-json`
- `validate-gas-call-arity`
- `validate-proposal-reference`
- `validate-harness-context`
- `validate-operational-report-contract`
- `audit-coverage`
- `validate-harness-coverage-auditor`
- `validate-strategy-tests-contract`
- `validate-breakout-gate`
- `validate-anti-whipsaw`
- `validate-cash-raise-route`
- `validate-brt-harness`
- `validate-determinism`
- `validate-alpha-execution-harness:strict`
- `render-report-json`
- `validate-report-json`
- `validate-report-quality`
- `validate-report-sync`
spec와 데이터 샘플 검증까지 포함한 전체 엄격 검증은 아래를 사용합니다.
패키지 생성은 아래를 사용합니다.
```powershell
npm run validate-engine-strict
npm run prepare-upload-zip
```
proposal 평가 이력까지 갱신하는 일일 실행은 아래를 사용합니다.
`ops:release`는 릴리즈 DAG 전체를 실행하고, 일부 `warn_only` 검증은 `PASS_WITH_WARNINGS`로 기록합니다.
`full-gate``validate-engine-strict`는 엄격 모드로 동일한 릴리즈 DAG를 재검증합니다.
```powershell
npm run daily-feedback-report
```
추가 스크립트:
백필 누적 원장(`backdata_feature_bank`) 상태를 즉시 검증하려면 아래를 사용합니다.
```powershell
npm run validate-backdata-migration-state
```
Outcome/Evaluation 복구 파이프라인(YOLO)을 한 번에 실행하려면 아래를 사용합니다.
```powershell
npm run yolo-outcome-recovery
```
GAS 함수 정의/호출 인자 수 불일치만 단독 점검하려면 아래를 사용합니다.
```powershell
npm run validate-gas-call-arity
```
사용자 판단용 제안표 하네스 출력이 실제로 존재하는지 점검하려면 아래를 사용합니다.
```powershell
npm run validate-proposal-reference
```
GAS `runHarnessRefresh_()` 반영 후에는 아래 강제 검증으로 올릴 수 있습니다.
```powershell
npm run validate-proposal-reference:strict
```
GAS 반영 후 `proposal_reference_json`까지 포함한 최종 엄격 게이트는 아래를 사용합니다.
```powershell
npm run full-gate:proposal-strict
```
spec/데이터 샘플까지 포함한 전체 엄격 검증은 아래를 사용합니다.
```powershell
npm run validate-engine-proposal-strict
```
- `npm run ops:package`
- `npm run ops:validate`
- `npm run ops:build`
- `npm run render-report-json`
- `npm run validate-proposal-reference`
- `npm run validate-gas-call-arity`
## GAS 반영 체크리스트
@@ -116,10 +65,10 @@ npm run validate-engine-proposal-strict
3. Google Sheets `harness_context` 시트에 아래 키 생성 확인
- `proposal_reference_json`
- `proposal_reference_lock`
4. 로컬에서 `npm run convert-data-json` 실행
5. `npm run validate-proposal-reference:strict` 실행
6. `npm run full-gate:proposal-strict` 실행
7. 최종 운영 전환 시 `npm run validate-engine-proposal-strict` 기준으로 사용
4. 로컬에서 `npm run ops:prepare` 실행
5. `npm run ops:release` 실행
6. `npm run full-gate` 실행
7. 최종 운영 전환 시 `npm run prepare-upload-zip`로 패키지 생성 여부를 확인
## 운영 리포트 계약
@@ -132,5 +81,5 @@ npm run validate-engine-proposal-strict
- 전체 게이트에는 `render-report-json -> validate-report-json -> validate-report-quality -> validate-report-sync` 순서가 포함됩니다.
전환 기준:
- `validate-proposal-reference``SKIP`이면 아직 GAS 산출물 미반영 상태
- `validate-proposal-reference:strict``PASS`여야 proposal 하네스 strict 전환 완료
- `validate-proposal-reference` 결과와 `ops:release` 결과를 함께 봅니다.
- `prepare-upload-zip``PASS_WITH_WARNINGS`를 출력하면 warn_only 검증 이슈가 남아 있는 상태입니다.