rude — 코드 구조 분석 + 편집 도구

DB: .code.db | 옵션 불확실 시 rude <cmd> --help로 확인

커맨드 요약

편집 커맨드

테스트 코드 추출

rude context validate_fn -s --include-tests

-s로 함수 정의 + 테스트 함수의 전체 소스 코드가 출력됨.
--include-tests로 테스트 함수를 caller에 포함.

모듈 분리 (split-module)

수동 지정:

rude split-module --file watch.rs "watcher.rs:run" "handler.rs:process_changes,update_db"

자동 분리 (call graph 기반):

rude split-module --file watch.rs --auto

동작:

• 파일→디렉토리 변환 (foo.rs → foo/mod.rs)
• 진입점(pub fn) 기준 그룹핑, 공유 유틸은 mod.rs 잔류
• super:: → crate:: 경로 자동 변환
• visibility 자동 조정 (private fn → pub(super))
• cross-module import 자동 생성
• unused import 자동 정리

다른 프로젝트 분석

rude add /path/to/project --db /path/to/project/.code.db
rude context fn_name --db /path/to/project/.code.db

--db로 다른 프로젝트의 DB를 지정. 소스 경로는 자동 resolve.

설정 (.code.db/config.toml)

[split]
min_lines = 300

[cluster]
min_lines = 50

우선순위: CLI args > config.toml > 기본값

필수 규칙

• 코드를 읽을 때 rude context -s를 우선 사용 — Read로 수백줄 읽지 말 것
• 테스트 코드 필요 시 rude context fn -s --include-tests 사용
• rude가 알려준 라인 범위로 Read(offset, limit) 범위 읽기
• 편집 시 --body-file 권장 (MSYS bash에서 --body의 //가 경로로 변환됨)
• cargo run -p rude 금지 — PATH의 rude 직접 사용
• replace/split 결과가 stdout에 출력되므로 확인용 Read 불필요
• 연속 편집 안전 — syn 기반 라인 감지로 DB stale 영향 없음

동시성

• 읽기: 동시 실행 안전
• 편집: .lock exclusive lock — 동시 편집 안전
• DB 쓰기 (add): 동시 실행 피할 것

제약

• nightly rustc 필요 — mir-callgraph가 rustc_private 사용
• blast는 함수/메서드 + struct/enum 지원 (MIR field access 추적)
• 현재 Rust 전용