chore(release): 0.4.0

[ictechgy]

요약

rustograph 0.4.0 릴리스 준비 PR입니다. 태그·Release·homebrew 탭 갱신은 머지 뒤 별도 승인으로 진행합니다(이 PR은 태그·발행을 하지 않습니다).

두 커밋입니다.

1. feat(cli): --version 최상위 플래그 추가: isthmus scripts/verify-installed-compatibility.mjs는 설치된 생산자마다 <tool> --version을 실행하고 출력의 마지막 semver를 compatibility.json과 대조합니다. 지금까지는 version 하위 명령만 있어서 unknown command --version(종료 2)으로 실패했습니다. 이제 --version은 version의 별칭이고, 출력(rustograph X.Y.Z)도 같습니다. 두 출력이 같은지는 단위 테스트와 verify-cli-contract.sh가 확인합니다. release.yml의 패키지 바이너리 검증에도 --version 확인을 넣었습니다.
2. chore(release): 0.4.0: Cargo.toml, Cargo.lock 자기 항목(cargo update 없이 손으로 수정해 ra_ap 핀을 유지했고 cargo build --locked로 확인), README/README.ko 설치 태그, HANDOFF 릴리스 노트, docs/HTTP-ROUTES.md의 알려진 결함을 바꿨습니다.

릴리스 노트 (v0.3.0 이후)

• 새 명령
  • routes --role server: axum 0.7·0.8, actix-web 4에서 isthmus http route-decl을 냅니다.
  • routes --role client: reqwest·ureq, --wrappers(http-wrappers v1), --service에서 route-call을 냅니다.
  • reach, impact --format language-traversal: language-traversal v1을 냅니다. root 여러 개를 한 번에 순회합니다.
  • 최상위 --version
• 출력 변경
  • schema 사실에 symbol: {qualifiedName, usr}가 붙습니다.
  • 읽지 못한 cfg_attr 속성 목록을 세어 limitation으로 보고합니다.
• 동작 변경: 수확할 때 지역 바인딩의 스코프를 잘못 해석하던 문제를 고쳤습니다. 지역 변수나 매개변수를 같은 이름의 모듈·함수로 읽어 생기던 거짓 간선이 사라집니다(자기 분석 기준 109개). 그래서 graph, dead, cycles, query, impact 결과가 달라질 수 있습니다.
• 소비자 요건: route-decl, route-call, language-traversal 문서는 isthmus 3a45450 이후 버전(차기 isthmus-cli 0.10.0)에서만 받습니다. 발행된 0.9.0은 거부합니다. 벤더링한 벡터 lock은 3a45450입니다.
• 알려진 결함: 서버 route-decl의 위치 열을 UTF-16 코드 단위로 셉니다. GRAPH-EXCHANGE는 UTF-8 바이트를 요구하므로, 경로 인자 앞에 비ASCII 문자가 있는 줄에서는 열이 어긋납니다. 클라이언트 route-call은 UTF-8 바이트로 셉니다.

검증 (로컬, 이 브랜치 HEAD)

• cargo fmt --check 통과
• cargo test --locked: 203개 통과
• cargo test --locked --features semantic: 250개 통과
• scripts/coverage.sh: 92.18% (게이트 90%)
• scripts/verify-cli-contract.sh: debug 바이너리와 release 바이너리 모두 OK
• cargo clippy --locked --all-targets -- -D warnings: 경고 0
• 도그푸딩: rules --strict 위반 0, cycles --level symbol --strict 순환 0
• cargo build --locked, cargo build --locked --features semantic: 둘 다 통과
• isthmus의 semver 정규식으로 target/release/rustograph --version을 파싱하면 0.4.0이 나옵니다.
• 변경 전 바이너리로 rustograph --version을 실행하면 종료 코드 2가 나오는 것을 확인했습니다. 새 계약 검사가 실제로 회귀를 잡는다는 뜻입니다.

머지 후 릴리스 단계

• merge SHA에 v0.4.0 태그를 push하면 release.yml이 돌아 5개 플랫폼과 패키지 바이너리 계약을 검증합니다.
• HOMEBREW_TAP_TOKEN 시크릿이 없으므로 탭 Formula/rustograph.rb는 게시된 checksums.txt로 대조해 수동으로 갱신해야 합니다.

🤖 Generated with Claude Code