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 ops:release

릴리즈 DAG의 엄격 판정이 필요하면 아래를 사용합니다.

npm run full-gate

패키지 생성은 아래를 사용합니다.

npm run prepare-upload-zip

ops:release는 릴리즈 DAG 전체를 실행하고, 일부 warn_only 검증은 PASS_WITH_WARNINGS로 기록합니다. full-gate와 validate-engine-strict는 엄격 모드로 동일한 릴리즈 DAG를 재검증합니다.

추가 스크립트:

• 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 반영 체크리스트

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 ops:prepare 실행
5. npm run ops:release 실행
6. npm run full-gate 실행
7. 최종 운영 전환 시 npm run prepare-upload-zip로 패키지 생성 여부를 확인

운영 리포트 계약

운영 리포트는 사람이 읽는 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-reference 결과와 ops:release 결과를 함께 봅니다.
• prepare-upload-zip가 PASS_WITH_WARNINGS를 출력하면 warn_only 검증 이슈가 남아 있는 상태입니다.