refactor: extension.ts 모놀리스를 모듈로 분리 (21,836 → 18,910줄, 동작 보존)

[vip7612-maker]

무엇을 / 왜

src/extension.ts 단일 파일이 21,836줄까지 비대해져 코드 리뷰·충돌·온보딩이 어려운 상태였습니다. 코드 주석에도 "25,000줄에 묻혀있다"는 자조가 남아 있을 정도입니다. 이 PR은 동작을 100% 보존하면서 응집도 높은 모듈로 분리합니다.

• extension.ts: 21,836 → 18,910줄 (−2,926, 약 −13.4%)
• 신규 모듈 15개 (core 5 · config · runtime-state · company 3 · git-sync · tracker · panels 2 · 검증 하네스)

원칙 (동작 보존 리팩토링)

• 순수 이동: 기능 변경 없음. 함수를 export로 옮기고 extension.ts는 import만.
• 번들 무비용: 빌드가 esbuild --bundle 단일 번들이라 모듈 분리에 런타임/패키징 변화 0. (out/extension.js 1.4MB 동일)
• 점진적·검증 가능: 한 커밋 = 한 도메인. 매 단계 tsc --noEmit(strict) + esbuild 번들이 둘 다 그린임을 확인 후 커밋(롤백 지점 확보).

모듈 구성

영역	파일	내용
잎 유틸	core/{git,fs-safe,search,proc,bridge}.ts	git 호출·경로 안전·glob/grep·Python 실행·포트 브리지
설정	config.ts	getConfig·프롬프트/툴시드 로더·_ensureBrainDir
런타임 상태	runtime-state.ts	교차 모듈 싱글톤 holder(extCtx·autoSyncRunning)
회사	company/{company,agents-state,orchestration}.ts	회사 상태·마이그레이션 / 에이전트 채용·활성 / 모델 오케스트레이션
동기화	git-sync.ts	두뇌·회사 GitHub 자동 동기화
할일	tracker.ts	추적 데이터 레이어(CRUD·이벤트·마크다운)
패널	panels/{brain-network,task-tree}.ts	지식 그래프 빌더+웹뷰 HTML / 사이드바 할일 트리뷰

리뷰어가 알아두면 좋은 점

• 싱글톤 처리: _extCtx·_autoSyncRunning은 여러 모듈이 공유 → runtime-state.ts의 holder 객체로 노출. getter 함수가 아닌 객체 속성(runtime.extCtx)으로 둔 이유는 strict 모드의 null-narrowing(if (runtime.extCtx) { runtime.extCtx.x })을 보존하기 위함입니다.
• tracker ↔ calendar 순환 결합 차단 (유일한 구조 변경): addTrackerTask/updateTrackerTask가 구글 캘린더 함수를 직접 호출하고 캘린더 함수는 TrackerTask 타입을 받아 순환이었습니다. DI 훅(setTrackerCalendarHooks)으로 의존성을 역전 — activate()에서 실제 캘린더 함수를 주입합니다. 동작은 동일하며, tsc strict가 훅 시그니처 일치를 검증합니다.
• 순수 로직만 분리: showBrainNetwork(싱글톤 의존)·_taskTreeProvider(싱글톤)·tracker 인라인 명령은 의도적으로 extension.ts에 남겼습니다.
• 함수 본문은 awk 바이트 추출 + perl export 부착으로 옮겨 regex 많은 로직(마이그레이션 등)이 한 글자도 변경되지 않음을 보장했습니다.
• package-lock.json의 npm 정규화 변경은 리팩토링과 무관해 제외했습니다.

검증

매 커밋마다 아래 하네스(scripts/verify-refactor.sh)가 그린:

tsc --noEmit (strict)  → exit 0
esbuild --bundle        → out/extension.js 1.4mb, exit 0
✅ VERIFY PASS

참고: 이 PR은 extension.ts 분리 1차분입니다. 남은 큰 덩어리(calendar·approvals·schedulers·telegram·server·OfficePanel·SidebarChatProvider)는 같은 방식으로 후속 진행 가능합니다.

🤖 Generated with Claude Code