dartograph 0.4.0

0.4.0

• affected <git-ref> <package-root>: Git 기준점 이후 변경된 라이브러리와 그에 전이적으로 의존하는 라이브러리를 답합니다. 각 피영향 라이브러리에는 가장 가까운 변경 라이브러리까지의 최단 의존 사슬 path와 depth 근거가 붙습니다(라이브러리 수준 관측).
• graph --format html: 외부 CDN·스크립트·폰트 참조가 전혀 없는 단일 자기완결 파일입니다. 네트워크가 막힌 사내망·CI 아티팩트에서도 열리며 캔버스 힘 기반 배치·검색·팬·줌으로 렌더링됩니다. 400정점을 넘으면 연결이 많은 정점부터 남기고 truncatedFrom과 페이지 알림으로 정직하게 보고합니다(전체 그래프는 --format dot).
• graph --level file|type|symbol·--collapse <n>: 그릴 해상도를 고릅니다. file은 선언을 소속 라이브러리로, type은 멤버를 최상위 선언으로 접고, symbol(기본)은 기존 출력을 byte-for-byte 보존합니다. --collapse는 파일 수준 그래프를 경로 앞 n세그먼트 폴더로 요약합니다.
• // dartograph:ignore 인라인 주석: 주석이 위에 오는 선언의 dead 보고를 억제합니다(retentionReason: inlineIgnore). 같은 줄 꼬리 주석은 다음 선언의 억제로 해석되지 않고, 산문의 마커 언급은 오발하지 않습니다. 억제된 선언은 보존 루트라 참조하는 것도 보고에서 함께 사라집니다 — 단일 finding 억제는 baseline을 쓰십시오.
• dead --report-test-only: 테스트에서만 도달되는 프로덕션 선언을 관찰합니다("테스트가 유일한 호출자" 관측, info 심각도 — finding이 있어도 종료 코드 0).
• cycles --explain <id>·rules --explain <id>: 한 정점이 참여하는 순환과 breakCandidate, 레이어 배치와 matchedPattern·matchedCandidate 근거를 JSON으로 답합니다. 그래프에 없는 ID는 known: false와 종료 코드 64입니다.
• query --depth <n>·--limit <n>: 사용 관계를 n단계 BFS로 따라가며 이웃별 depth와 간선 종류 전부를 보고합니다. --limit으로 생략하면 해당 방향 truncated가 서고 생략된 이웃은 더 확장하지 않습니다(좁은 파괴적 변경: 재귀처럼 자기 자신으로 향하는 사용 간선은 모든 depth에서 자기 자신의 이웃에서 제외됩니다 — 옛 1-hop은 포함했습니다).
• 사용 중인 operator 선언이 dead로 보고되던 오탐을 수정했습니다. 연산자 구문(a + b·a[i]·-a·a++·m[i] += v)이 클래스·extension type 모두에서 사용 간선으로 기록됩니다.
• 입력 오류 메시지를 원인별로 구분했습니다: baseline 부재, rules --config 실패, baseline --write 쓰기 실패를 "unable to index the package"로 답하지 않습니다.
• Mermaid 출력이 자체 노드 ID의 <·>·&·"·\·#를 HTML 엔티티 코드로 escape합니다 — 따옴표 포함 파일명이 라벨 구조를 깨지 않습니다.
• 퍼센트 인코딩된 파일명의 dead file finding이 파일 수준 한계를 유지합니다.

분석 한계는 파일 단위 관측이며 완전성이나 삭제 안전성을 보증하지 않습니다. affected의 영향 반경은 라이브러리 수준이라 나열되지 않은 선언의 무영향 증명이 아닙니다. html 그래프의 400정점 초과 truncation은 페이지에 알림이 남습니다. bridge 심볼은 어휘적 이름이며 컴파일러 USR를 생성하지 않습니다.