kjh2064 472853826c feat: GAS 자동 배포 스크립트 작성 및 커밋/PR 시 원격 배포 하드 룰 추가 (2026-06-13)
주요 변경 사항:
- tools/deploy_gas.py 추가:
  * clasp를 사용하여 로컬의 8개 .gs 스크립트 파일과 appsscript.json을 원격 Apps Script 프로젝트에 강제 푸시(clasp push -f)하는 자동화 스크립트 작성
- AGENTS.md 수정:
  * 3. 하드 룰 섹션에 커밋, 푸쉬, PR 작업 시 반드시 로컬 .gs 파일을 원격 프로젝트에 업로드하고 사용자가 스프레드시트 상의 스크립트(runDataFeed 등)를 직접 실행해 검증하도록 가이드하는 하드 룰 명시
- 검증 결과: python tools/deploy_gas.py 원격 배포(9개 파일 push) 정상 검증 완료

Co-Authored-By: Antigravity AI <noreply@google.com>
2026-06-13 14:19:18 +09:00

Core/Satellite Collector v4

은퇴자산용 코어/위성 후보 데이터 수집기입니다.

v4 기본 정책

  • 파라미터 없이 실행
  • 1차 유니버스: KOSPI 160개 + KOSDAQ 40개
  • 최종 후보: 100개
  • 최종 후보 내 KOSDAQ: 최대 20개
  • 1차 탐색 총량은 v3와 동일한 200개로 유지하여 호출 수 증가를 막습니다.

설치

npm install
node core_satellite_collector.js

OpenDART 공시까지 확인하려면:

$env:DART_API_KEY="발급받은키"
node core_satellite_collector.js

운영 표준

하네스/보고서/동기화까지 포함한 최종 게이트는 아래 순서를 사용합니다.

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와 데이터 샘플 검증까지 포함한 전체 엄격 검증은 아래를 사용합니다.

npm run validate-engine-strict

proposal 평가 이력까지 갱신하는 일일 실행은 아래를 사용합니다.

npm run daily-feedback-report

백필 누적 원장(backdata_feature_bank) 상태를 즉시 검증하려면 아래를 사용합니다.

npm run validate-backdata-migration-state

Outcome/Evaluation 복구 파이프라인(YOLO)을 한 번에 실행하려면 아래를 사용합니다.

npm run yolo-outcome-recovery

GAS 함수 정의/호출 인자 수 불일치만 단독 점검하려면 아래를 사용합니다.

npm run validate-gas-call-arity

사용자 판단용 제안표 하네스 출력이 실제로 존재하는지 점검하려면 아래를 사용합니다.

npm run validate-proposal-reference

GAS runHarnessRefresh_() 반영 후에는 아래 강제 검증으로 올릴 수 있습니다.

npm run validate-proposal-reference:strict

GAS 반영 후 proposal_reference_json까지 포함한 최종 엄격 게이트는 아래를 사용합니다.

npm run full-gate:proposal-strict

spec/데이터 샘플까지 포함한 전체 엄격 검증은 아래를 사용합니다.

npm run validate-engine-proposal-strict

GAS 반영 체크리스트

proposal_reference_json을 실제 하네스 출력으로 승격하려면 아래 순서를 따릅니다.

  1. Apps Script에 최신 gas_harness_rows.gs 반영
  2. Apps Script에서 runHarnessRefresh_() 실행
  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 기준으로 사용

운영 리포트 계약

운영 리포트는 사람이 읽는 Temp/operational_report.md와 기계 검증용 Temp/operational_report.json을 함께 생성합니다.

  • operational_report.json이 canonical 계약입니다.
  • operational_report.md는 표시용 렌더입니다.
  • JSON 스키마는 schemas/operational_report.schema.json을 사용합니다.
  • 계약 드리프트 검사는 npm run validate-operational-report-contract로 수행합니다.
  • 전체 게이트에는 render-report-json -> validate-report-json -> validate-report-quality -> validate-report-sync 순서가 포함됩니다.

전환 기준:

  • validate-proposal-referenceSKIP이면 아직 GAS 산출물 미반영 상태
  • validate-proposal-reference:strictPASS여야 proposal 하네스 strict 전환 완료
S
Description
퀀트 투자 엔진
Readme 28 MiB
Languages
Python 63.5%
JavaScript 31.8%
C# 3.7%
HTML 0.4%
PowerShell 0.2%
Other 0.4%