jquery35-local-agent v5 - 명령 예시 모음 ========================================= 도움말: node run-jquery35-v5.js --help 0) 웹 대시보드 UI (PowerShell 명령을 매번 치지 않고 브라우저에서 실행): node run-jquery35-v5.js --mode ui --port 18088 접속: http://127.0.0.1:18088/ Windows: 실행0_웹대시보드.bat 기능: source 지정만으로 TO-BE/report/profile/server-source/verify-source 자동 세팅, S1~S11 단계 실행, Pipeline(S1→S2→S3→S6→S7→S8→S9→S10→Lab), Local Lab 시작/중지, 기존 report HTML 열기 Pipeline은 S3까지 TO-BE를 만들고, S6 이후 검수/AI판정팩/검증/보고서/Local Lab은 verify-source(기본값 TO-BE target)를 기준으로 실행합니다. 주요 보고서: report\index.html, report\voyager_packet.txt, report\ai_verdict_packet.txt, report\verdict_evidence.html, report\runtime_scenarios.html, report\runtime_parity.html, report\runtime_lab_guide.md 1) 분석만 (원본/TO-BE 아무것도 수정 안 함): node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode plan 2) TO-BE 자동수정 (안전 항목만): node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode autofix 3) jQuery 호출부 교체 (기본 3.5.1/Migrate 파일은 도구가 TO-BE WebContent\js 에 자동 배치): node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode patch-jquery 4) Runtime Probe 삽입: node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode probe 5) 로컬 mock lab 서버: node run-jquery35-v5.js --source "C:\work\legacy-app" --target "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode lab --port 18080 접속: http://localhost:18080/_pages 보고서: http://localhost:18080/_report/index.html 6) 운영 반영 전 검증 (TO-BE 또는 반영된 브랜치 작업본을 source로): node run-jquery35-v5.js --source "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5_clean" --mode verify-clean exit code: 0=PASS/WARN, 2=FAIL (CI 게이트로 사용 가능) WARN도 실패로 처리: --warn-as-error 7) PR/CI 보고서: node run-jquery35-v5.js --source "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5_pr" --mode pr-report 8) 복붙 패킷만 재생성: node run-jquery35-v5.js --source "C:\work\legacy-app" --report "C:\work\jquery35_report_v5" --mode packet -> report\voyager_packet.txt 를 통째로 복사해서 외부 AI/Codex에 붙여넣기 -> CSV/Excel 파일은 폐쇄망 내부 증빙용이며 외부 전달 필수 아님 8-1) 1000자 이하 AI 판정팩만 재생성: node run-jquery35-v5.js --source "C:\work\legacy-app_jquery35_tobe" --report "C:\work\jquery35_report_v5" --mode ai-verdict-packet -> report\ai_verdict_packet.txt 를 복사해서 "사람 검수 충분/추가 런타임 필요/IEDriver 검토 필요" 판정을 받기 -> 상세 근거는 report\verdict_evidence.html / verdict_evidence.json 에 남음 9) AI 리뷰팩 + Hermes 로컬 검수팩 생성 (스무고개 반복 학습용, 7절 참고. 같은 --report 폴더로 재실행하면 라운드가 누적됨): node run-jquery35-v5.js --source "C:\work\legacy-app" --report "C:\work\jquery35_report_v5" --mode review-pack -> report\ai_review_pack.txt 를 외부 AI에게 붙여넣고, 답변 JSON을 project-profile.json의 learnedWrappers/learnedFindings 배열에 병합한 뒤 같은 명령을 다시 실행 -> report\hermes_test_plan.md / hermes_review_matrix.csv 로 외부 AI 답변을 로컬에서 검수 -> report\hermes_testbench.html 로 CASE별 모킹 시험장 실행 9-1) 외부 AI 질문보다 로컬 검수팩 의도를 강조하고 싶을 때: node run-jquery35-v5.js --source "C:\work\legacy-app" --report "C:\work\jquery35_report_v5" --mode hermes-pack 9-2) Runtime Parity 확인: report\runtime_parity.html 에서 Local Lab으로 충분한 항목, Spring/Tomcat 실 기동 필요 항목, Edge IE mode 최종 확인 항목을 분리해서 봅니다. 선택 실험: TO-BE WAR를 runtime-lab\inbox\app.war 로 둔 뒤 runtime-lab\run-runtime-lab.bat 실행 Mac/Codex 로컬 Spring 3.2.5 + Tomcat 7 스모크: cd runtime-lab ./run-spring325-tomcat7-local.sh start # 백그라운드 유지가 필요하면: ./run-spring325-tomcat7-local.sh screen-start -> http://127.0.0.1:18089/health.do 10) 폐쇄망 반입 증빙만 생성: node run-jquery35-v5.js --source "C:\work\legacy-app" --report "C:\work\jquery35_report_v5" --mode airgap-manifest 11) 공개 배포용 ZIP 생성 (source 불필요): node run-jquery35-v5.js --report ".\release" --mode release-zip -> .\release\jquery35-local-agent-v5.6.10-public.zip 12) 도구 자체 검증 (회사 코드 불필요, 임시폴더에 샘플 생성 후 전체 체크): node run-jquery35-v5.js --mode self-test 유용한 옵션: --profile "C:\work\legacy-app\project-profile.json" 경로변수/벤더패턴/프로브 대상/학습된 래퍼 커스터마이즈 --rulepack "C:\work\jquery35-rulepack" 웹루트/벤더권고/mock 기본값을 외부 rulepack으로 교체 --server-source "D:\src\legacy-server" Java/Spring 정적 증거 루트 지정 --no-server-scan Java/Spring 정적 증거 추출 생략 --jquery-version 3.5.1 --migrate-version 3.6.0 교체 버전 변경 --inject-probe autofix/patch-jquery 때 프로브도 같이 삽입 --patch-jquery autofix 때 core 교체도 같이 수행 --migrate-trace patch-jquery 때 Migrate 바로 아래 tracing 옵션 삽입 --safe-packet false / --include-snippets assistant_packet에 짧은 코드조각 포함 --max-packet-lines 600 assistant/voyager packet 줄수 제한 조정 --ai-packet-chars 1000 AI 판정팩 글자수 하드캡 --max-review-cases 20 / --context-lines 1 / --max-review-lines 300 review-pack 분량 조절 --no-lab mock_routes.json 생성 생략