flutter_ide 기술 분석

파이프라인 fullstack-code-editor Discovery 단계의 부속 산출물. 본 문서는 docs/discovery-fullstack-code-editor.md §4.1 의 전문(全文)이다. 분석 대상 저장소에는 LICENSE 파일이 없다(GitHub API license: null, pubspec.yaml 에 license 키 없음 — README 본문의 "MIT" 문구만 존재). 따라서 이 분석은 코드 복사가 아니라 패턴 학습을 목적으로 하며, 재사용 판정(§8)도 그 전제 위에 있다. 저장소 활동 실측(GitHub API, 2026-09-16): 커밋 22건 · 기여자 2명(19 + 3) · ★35 · 포크 6 · 열린 이슈/PR 6건(#1 설정 화면, #6 Dart LSP, #7 전역 검색↔Monaco, #8 AI 사이드바, #4 README 스크린샷, PR #9 검색 결과 내비게이션) · 최초 커밋 2025-12-11 · 마지막 push 2026-01-05.

flutter_ide (ankurg132) 기술 분석

대상: ankurg132/flutter_ide HEAD 63807f3 (shallow clone — HEAD 1커밋만 조회 가능) · 21 Dart 파일 / 5,030 LOC · 분석일 2026-09-16 방법: lib/·test/ 전 파일, pubspec.yaml/pubspec.lock, README.md, analysis_options.yaml, .metadata, macos/Runner/*.entitlements 정독. 보조 검증: Dart SDK 3.47.3 process_patch.dart(runInShell 인용 처리), pub.dev 메타데이터(flutter_monaco / flutter_pty / webview_flutter 플랫폼). 인용은 파일:행.

1. 개요

• 무엇인가: VS Code 외형을 모방한 단일 창 코드 에디터. Monaco(WebView) 편집기 + 파일 트리 + 탭 + 자동저장 + PTY 터미널 + pub.dev 검색 + 내장 브라우저 탭 + git 사이드바. 저장소 생성 2025-12-11, 마지막 push 2026-01-05(약 4주 활동), 주 저자 1명(커밋 22건 중 19건 · 기여자 2명), 35★.
• 성숙도: 데모/사이드 프로젝트. 근거 — pubspec description: "A new Flutter project."(pubspec.yaml:2), 앱 타이틀 'Flutter Demo'와 템플릿 주석 잔존(main.dart:15,17-31), 유일한 테스트는 템플릿 카운터 테스트의 본문만 지운 빈 껍데기(test/widget_test.dart:8-17), CI 없음(.github/에는 FUNDING.yml뿐), 린트는 기본 flutter_lints 그대로(analysis_options.yaml:10,23-25), README 가 존재하지 않는 flutter_idedemo/ 디렉토리를 안내(README.md:74-77,96), 선언만 하고 import 하지 않는 의존성 6종(§4).
• 플랫폼 디렉토리(실측): linux/, macos/, windows/, web/ 존재 · android/, ios/ 없음. README 의 "Runs on macOS, Windows, Linux, iOS, and Android"(README.md:39)는 사실과 다름. .metadata 의 migration 항목은 root·web 뿐이라 데스크톱 디렉토리는 나중에 수동 추가된 흔적. macOS 는 Debug/Release 모두 com.apple.security.app-sandbox=false(macos/Runner/DebugProfile.entitlements, Release.entitlements) — PTY·임의 파일 접근에 필요하지만 Mac App Store 배포 불가. Podfile osx 10.15.
• 실제로 동작하는 타깃은 macOS 하나. Windows: Monaco 는 WebView2 로 뜨지만 브라우저 탭(webview_flutter)은 Windows 구현이 없어 WebViewController() 생성 시 예외(§4), 단축키가 Meta 키 전용(§3-16). Linux: flutter_monaco 가 Linux 미지원 → 편집기 자체가 없음. Web: flutter_pty(dart:ffi)를 무조건 import(output_panel.dart:5) → 웹 컴파일 자체가 불가, FileService 웹 구현도 스텁(§2).

2. 아키텍처

2.1 위젯 트리

main.dart:14  MaterialApp(theme: ColorScheme.fromSeed(deepPurple) ← 라이트 템플릿 테마, main.dart:32)
                     └ EditorScreen (editor_screen.dart:33)  StatefulWidget · 1,079행 · 메서드 33개 · 상태 필드 16개
                        └ Scaffold > Column (599-709)
                           ├ Expanded > Row
                           │  ├ _buildActivityBar() (712)      ActivityBarItem ×4 + 터미널 토글 (activity_bar.dart:3)
                           │  ├ [idx0] _buildSidebar() (752) → FileTree (file_tree.dart:6)
                           │  │ [idx1] FlutterSidebar (flutter_sidebar.dart:6)
                           │  │ [idx2] PubDevSidebar (pubdev_sidebar.dart:4)   폭 = _sidebarWidth+50 (623)
                           │  │ [idx3] GitSidebar (git_sidebar.dart:18)        폭 = _sidebarWidth+50 (632)
                           │  ├ HorizontalResizeHandle (640; resize_handles.dart:3)
                           │  └ Expanded > Column
                           │     ├ _buildTabBar() (841) → EditorTab / WebEditorTab (editor_tabs.dart:5,98) + Run/토글 버튼 (890-908)
                           │     ├ _buildBreadcrumbs() (915)
                           │     ├ Expanded: _buildWebView() | WelcomeScreen | _buildEditor()→MonacoEditor (660-668, 956)
                           │     ├ VerticalResizeHandle (673)
                           │     └ OutputPanel (682) → xterm TerminalView + flutter_pty (output_panel.dart:197,105)
                           └ _buildStatusBar() (1023)
                    

2.2 상태 관리 — 전부 setState + 전역 가변 포인터

• 상태 관리 라이브러리 없음. setState 85회(editor_screen 25, git_sidebar 21, pubdev 10 …). 모든 앱 상태(_rootNode, _openFiles, _activeFile, _currentCode, _webTabs, _webViewControllers, _fileWatchers, _recentlySavedFiles, _pendingCommand, 레이아웃 치수 등)가 _EditorScreenState 의 인스턴스 필드(editor_screen.dart:41-67,225)에 살고, 자식에게는 생성자 파라미터 + 콜백으로 prop-drilling 된다(예: FileTree 가 콜백 6개를 받음 file_tree.dart:7-12).
• 전역 함수 포인터: void Function(String)? _globalRunTerminalCommand(editor_screen.dart:26)를 initState 에서 _runTerminalCommand 로 세팅(74), dispose 에서 null(132). 공개 API runTerminalCommand()(29-31)는 이 포인터를 호출 — README 가 "Global Command API" 로 홍보(README.md:29,125-136). 사실상 top-level 서비스 로케이터.
• 정적 싱글턴: final FileService fileService = FileServiceImpl();(file_service.dart:7) — import 시점에 생성되는 top-level 인스턴스. GitService 는 GitSidebar 상태가 직접 new(git_sidebar.dart:33), PubClient 도 마찬가지(pubdev_sidebar.dart:19). DI·인터페이스 주입 지점 없음 → 테스트 대역 삽입 불가.
• 명령 전달이 prop-diff 부수효과: PubDevSidebar.onRunCommand → _runTerminalCommand(327-332)가 _pendingCommand 문자열과 _isOutputVisible 만 세팅 → OutputPanel.didUpdateWidget 이 initialCommand != oldWidget.initialCommand 를 감지(output_panel.dart:68-71) → post-frame 에 pty.write('$command\n')(81,86) → onCommandExecuted 로 _pendingCommand=null(692-696). 즉 "명령"이 문자열 동등성으로 식별되고 위젯 rebuild 에 편승한다.

2.3 플랫폼 추상화 — 조건부 import 한 곳, 나머지는 우회

• file_service.dart:2 import 'file_service_io.dart' if (dart.library.html) 'file_service_web.dart'; + 8-메서드 인터페이스(file_service_interface.dart:3-12). 조건이 구식 dart.library.html(wasm 대응은 dart.library.js_interop).
• 그러나 추상화가 우회된다: FlutterSidebar 는 dart:io 로 디스크를 직접 읽고(flutter_sidebar.dart:2,111-113,166,222,336), 파일 감시는 File.watch 직접 호출(editor_screen.dart:146-147), GitService·OutputPanel 은 Process/Pty. 21개 중 5개 파일이 dart:io 를 import.
• 웹 구현은 스텁: create/delete/rename 은 null/false 반환(file_service_web.dart:61-98), saveFile 은 메모리 맵에만 기록(76-80), pickDirectory 는 다중 파일 선택을 'Uploaded Files' 가상 루트로 평탄화(15-47). File System Access API 미사용.

2.4 계층화

• 없음. lib/ 루트에 화면·위젯(file_tree.dart, output_panel.dart, *_sidebar.dart)이 섞여 있고 widgets/editor, widgets/git 만 하위 폴더. models/ 2파일(31행), services/ 2서비스. import 스타일도 상대 7 : 패키지 2 로 혼재.
• 모델은 가변 + 미사용 필드: FileNodeDirectory.isExpanded(file_system_entity.dart:10)와 FileNodeFile.content(21)는 어디서도 읽지 않고, 펼침 상태는 FileTree._expandedPaths(file_tree.dart:30)와 FlutterSidebar._expandedFolders(flutter_sidebar.dart:23) 두 곳에 독립적으로 존재. children 기본값 const [](15)인데 targetDir.children.add(...)(editor_screen.dart:237,253)로 변이 — 현재는 모든 생성 경로가 growable 리스트를 넘겨 잠복 상태.

2.5 핵심 데이터 흐름 — 파일 열기 → 편집 → 저장 → 외부 변경

1. 트리 클릭 → FileTree.onFileSelected(file_tree.dart:161) → _openFile(editor_screen.dart:514): _openFiles 추가 + _watchFile 등록(515-521) → _activeFile 동기 교체(524-526) → fileService.readFile(529) → _currentCode 갱신(530-532) → setValue(534) + setLanguage(536-537).
2. 편집 내용은 Monaco(WebView) 버퍼에만 존재한다. Flutter 쪽은 변경 이벤트를 구독하지 않는다(onChanged류 사용 0건).
3. 2초 폴링(_startAutoSave 258-289): getValue()(266) → _currentCode 와 문자열 비교(268) → 다르면 _recentlySavedFiles 마킹(276) → fileService.saveFile(277) → 500ms 뒤 마킹 해제(279-281).
4. 외부 변경: File.watch modify(147-149) → 마킹돼 있으면 무시(151-153), 아니면 _reloadFileContent(154) → 활성 파일이면 setValue(176) + SnackBar(179-184).
5. 결론: "진실의 원천"이 세 곳(Monaco 버퍼 / _currentCode / 디스크)이고, 동기화 수단은 폴링·타이머·문자열 비교뿐이다. §6-b 의 손실 경로는 전부 여기서 파생된다.

2.6 객체 생성·배선 지점 (주입 가능한 곳 없음)

3. 기능 인벤토리

4. 의존성 표

전이 의존 중 주목: webview_windows 0.4.0, freezed_annotation, flutter_helper_utils(flutter_monaco), zmodem(xterm), ffi.

5. 강점 (차용 가치 있는 패턴)

1. 조건부 import 심(seam) + 좁은 인터페이스: file_service.dart:1-7 + file_service_interface.dart:3-12. 웹 구현이 스텁이어도 경계 자체는 올바른 자리에 있다.
2. 명령 결과 값 객체: GitServiceResult { exitCode, stdoutText, stderrText, ok, bestMessage }(git_service.dart:34-52). 인자 배열 명시, --porcelain=v1, --pretty=format:%H|%an|%ad|%s --date=iso-strict, %(HEAD)|%(refname:short) 로 파싱 가능한 출력 강제(81-140), subject 의 | 를 재결합(102).
3. git 안전 가드: pull/sync 전 upstream 확인(git_sidebar.dart:260-269), dirty tree 차단(271-279), pull --ff-only(git_service.dart:206), revert 확인 다이얼로그(138-155), await 뒤 mounted 체크(101,223,241…), try/finally 로 로딩 해제(109-111).
4. PTY 배선 레시피: Pty.start ↔ Terminal.onOutput/onResize 연결(output_panel.dart:105-126), 첫 프레임 이후 시작(43-46), 실패를 터미널 자체에 출력(127-129).
5. 자체 저장 억제 + 빈 내용 보호 의도: _recentlySavedFiles(editor_screen.dart:67,276-281), 빈 내용 저장 차단(270) — 구현은 타이밍 의존이지만 문제 인식은 정확.
6. 링크 → 새 탭 인터셉트: 첫 로드 후 모든 내비게이션을 탭으로 승격(88-97) — 문서 브라우저 UX 아이디어.
7. Quick Open 랭킹: .dart 우선·build/ 후순위(quick_open_dialog.dart:62-82).
8. 앵커드 팝업 메뉴: RenderBox→Overlay 좌표로 showMenu 위치 계산(git_sidebar.dart:721-732).
9. 작은 크롬 위젯: ActivityBarItem, SidebarIconButton, StatusBarItem, 리사이즈 핸들의 SystemMouseCursors.resizeColumn/Row(resize_handles.dart:14,49), _TopGitAction/_CommitAction enum + exhaustive switch(git_sidebar.dart:5-16,314-325).

6. 약점 / 기술 부채

(a) 구조

• God widget: _EditorScreenState 1,079행, 메서드 33개, 상태 필드 16개, setState 25회 — FS CRUD 다이얼로그·탭·자동저장·감시자·WebView 컨트롤러·git/pubdev 배선·_build* 7개가 한 클래스. GitSidebar 도 890행/setState 21회.
• 복붙: _getFileIcon 3벌(editor_screen.dart:1047, file_tree.dart:193, quick_open_dialog.dart:111, 아이콘 집합도 서로 다름), EditorTab↔WebEditorTab(editor_tabs.dart:5-96 vs 98-187), isStagedXY 2벌(git_sidebar.dart:55-59,65-69), bool _isHovered 보일러플레이트 7회, 펼침 상태 2벌(§2.4).
• 테마 없음: Color(0x…) 리터럴 118개(고유 26색). MaterialApp 은 라이트 deepPurple 템플릿(main.dart:32) → AlertDialog/showMenu/SnackBar/TextField(_showNameDialog 488-512, _deleteNode 380-399)가 다크 UI 안에서 Material 라이트로 렌더링.
• 전역 가변 함수 포인터(26), top-level 싱글턴(file_service.dart:7), build() 내 동기 I/O(flutter_sidebar.dart 8곳), 미사용 의존성 6종, 상대/패키지 import 혼재.

(b) 데이터 손실·경쟁 조건 (편집기로서 치명)

1. 탭 전환/닫기/종료 시 flush 없음: _openFile(514-548)이 저장 없이 _currentCode 를 덮고 setValue(534) → 최대 2초 분량 편집이 결정론적으로 소실. _closeFile(550-567)·dispose(129-139)도 동일.
2. 교차 파일 쓰기 경쟁: 폴링 루프는 getValue() 이후 _activeFile!.path 를 읽는다(266,275). _openFile 은 _activeFile 을 동기 교체(524-526)하고 _currentCode 는 await readFile 뒤(529-532)에 갱신 → 그 창에서 폴링이 떨어지면 A 파일 버퍼가 B 파일 경로에 저장된다.
3. 자동저장 루프 증식: _startAutoSave 가 onReady 마다 호출(971)되고 Future.doWhile 은 취소 불가(258-289). 편집기는 조건부 자식(660-668)이라 웹탭 전환/전체 닫기 N번 → 루프 N개가 2초마다 각각 문서 전체를 IPC 회수.
4. 감시자 억제가 타이밍 기반: 500ms 창(279-281) 밖에서 FS 이벤트가 오면 setValue(176) → 커서·undo 스택 초기화 + 그 사이 입력 덮어쓰기.
5. 활성 파일 재클릭(트리/탭 860-865) → 디스크 재읽기로 미저장 편집 폐기.
6. 빈 내용 보호(270-272) 때문에 파일을 의도적으로 비우는 편집은 영구히 저장되지 않음.
7. 삭제 후 폴더 선택창 재호출·결과 폐기(419); 이름변경 후 트리·감시자 미갱신(467-472); FileTree._expandedPaths 가 initState 에서만 채워져(file_tree.dart:34-40) 다른 폴더를 새로 열면 접힌 채 표시.
8. 커밋이 스테이징을 무시(git_sidebar.dart:339); 체크아웃 명령을 셸에 타이핑(880,883)하므로 flutter run 이 포그라운드인 동안 그 프로세스의 stdin 으로 들어감(output_panel.dart:86).
9. _closeFile 이 setState 콜백 안에서 async _openFile 호출(559); QuickOpenDialog 의 build 내 FocusNode() 생성·미해제(quick_open_dialog.dart:154); breadcrumb 이 '/' split + 루트 이름 매칭(916-923).

재현 시나리오(코드 경로 기준)

• S1 편집 소실: A 열기 → 한 글자 입력 → 2초 안에 B 클릭. _openFile(B) 가 flush 없이 setValue(534) → A 의 입력은 디스크·_currentCode 어디에도 남지 않는다. _closeFile(550-567)·앱 종료(129-139)도 동일 경로.
• S2 교차 저장: A 편집 → 폴링 직전에 B 클릭. _activeFile=B(524) 인 채 readFile(B)(529) 를 기다리는 동안 getValue()(266) 가 A 버퍼를 반환 → content != _currentCode(A 원본)(268) → saveFile(_activeFile=B, A 버퍼)(275-277). 창의 폭은 readFile 지연 시간이라 대용량 파일·느린 디스크에서 넓어진다.
• S3 루프 증식: 파일 열기 → pub.dev "View on Pub.dev"(웹탭, pubdev_sidebar.dart:339-342) → 파일 탭 복귀 → MonacoEditor 재마운트·onReady(969) → _startAutoSave 2회째. N회 반복 후 2초마다 getValue() N회, 이전 루프는 mounted 가 참이라 영원히 산다(260,262).
• S4 사이드바 상태 소실: 탐색기에서 폴더 여러 개 펼침 → git 뷰 전환 → 탐색기 복귀 → FileTree State 가 재생성돼 루트만 펼쳐진다(file_tree.dart:34-40). git 뷰 복귀마다 initState→_refresh()(git_sidebar.dart:75-78) 로 프로세스 3개(235-239), pub.dev 복귀마다 인기 목록 재요청(pubdev_sidebar.dart:29-32). 원인: 사이드바가 if (_selectedActivityIndex == n) 조건부 자식(editor_screen.dart:610-637)이라 전환 때마다 dispose 된다.

(c) 오류 처리 — 사실상 부재

• catch 22개 중 16개가 무음: 주석만 있는 빈 본문 6개(editor_screen.dart:162,188,283,538, file_service_io.dart:45,95) + 로그 없이 null/false 반환 10개(file_service_io.dart:68,84,109,124,147, file_service_web.dart:44, flutter_sidebar.dart:168,224,346, pubdev_sidebar.dart:97) + 스트림 onError 무시(editor_screen.dart:157-159). 코드베이스 전체에 print/debugPrint/log 호출 0건.
• 최악은 저장 실패(file_service_io.dart:95-97)와 자동저장 실패(editor_screen.dart:283-285)가 사용자에게 전혀 보이지 않는다는 점. readFile 은 try 없이 readAsString(file_service_io.dart:57-59) → 바이너리를 열면 예외(이건 541-546 에서 SnackBar 로 표면화되긴 함).

(d) 보안

• 셸 인젝션(실재): runTerminalCommand('git checkout ${b.name}')(git_sidebar.dart:880,883) → pty.write('$command\n')(output_panel.dart:86). git ref 이름은 ; $ ( ) & | 백틱을 허용하므로 클론한 저장소의 악성 브랜치명이 클릭 한 번에 실행된다. 안전한 GitService.checkoutBranch(git_service.dart:228-233)가 있는데도 미사용.
• Process.run(..., runInShell: true)(git_service.dart:59-64): POSIX 에서는 Dart 가 인자마다 작은따옴표 인용(SDK 3.47.3 process_patch.dart _getShellArguments 확인)하므로 커밋 메시지·경로 인젝션은 불가. Windows 는 cmd.exe /c 에 공백/탭/따옴표가 있을 때만 인용하므로 msg&calc 같은 인자는 메타문자 위험. 애초에 runInShell 이 불필요(PATH 탐색은 기본 동작).
• 파일/폴더 이름 검증 없음: p.join(parentPath, name)(file_service_io.dart:64,137)에 ../../x 가 통과 → 프로젝트 밖 쓰기.
• git add -A(339)가 .env 등 비밀을 통째로 스테이징. WebView 는 임의 패키지의 homepage/repository/issue_tracker URL 을 JavaScriptMode.unrestricted(82)로 IDE 프로세스 안에서 로드(macOS sandbox off). PTY 는 전체 환경변수 상속(110) — 터미널로서는 정상.

(e) 플랫폼

• README 5플랫폼 주장(README.md:39) vs 실제 §1. dart.library.html 조건(file_service.dart:2)은 wasm 비호환. 셸을 비로그인으로 띄우므로(output_panel.dart:96-98) Finder 에서 실행 시 .zprofile 의 PATH(Homebrew·fvm)가 없어 통합 터미널에서 flutter 를 못 찾을 수 있음.

(f) 품질·테스트·문서

• 테스트 0건(빈 템플릿 테스트로 flutter test 가 공허하게 통과, test/widget_test.dart:15-17), GitService 파서·FileService 단위 테스트 없음, CI 없음, i18n 없음, 접근성 없음(GestureDetector 11곳에 Semantics 없음, 4px 핸들), 영속화 없음(최근 폴더·레이아웃·설정). README 의 존재하지 않는 디렉토리, pub.dev 라벨 버그(§3-8).

(g) 편집기 기능 공백

• LSP/진단/완성 없음(Monaco 내장 언어 서비스는 TS/JSON/CSS/HTML 뿐, Dart 는 토크나이저만), 전역 검색/치환 없음(로드맵 README.md:202), 분할 뷰 없음(206), undo 이력은 Monaco 버퍼뿐이며 setValue 때마다 리셋, dirty 표시·인코딩/EOL 처리(상태바 하드코딩)·문제 패널·실행 구성(Run = flutter run 타이핑 894)·디버거·디바이스 선택·확장/테마(204-205)·멀티루트·대용량 트리 가드·바이너리 처리·.gitignore 반영 모두 없음.

7. '풀스택 코딩 에디터' 관점의 격차

8. 재사용 판정

차용 시 최소 수정 체크리스트 (패턴 차용 모듈)

• git_service.dart: runInShell: true 제거(59-64) · Process.run 에 타임아웃/취소 · getLog 구분자 | 를 %x00 등으로 교체(작성자명에 | 가 있으면 열이 밀려 날짜 파싱 실패, 96-102) · 결과 객체에 실행 명령·소요시간 필드 · 파서 단위 테스트(porcelain XY, %(HEAD)).
• resize_handles.dart: 히트영역 4px → 8px+ · 더블클릭 리셋 · onDragEnd 로 치수 영속화 콜백 · 키보드 조절.
• output_panel.dart 레시피: Pty 를 위젯 State 에서 떼어 TerminalSession 서비스로(다중 세션·수명 분리) · 명령은 idle 세션에만 전달(포그라운드 프로세스 감지) · 로그인 셸 PATH 보강($SHELL -l 또는 path_helper) · 종료/강제종료 UI.
• file_service 심: 조건 dart.library.js_interop · 목록화는 Directory.list() 스트림 + 깊이/개수 상한 + .gitignore/build/ 제외 · 디렉토리 감시 추가 · 모든 실패를 Result<T, FsError> 로 반환 · 이름 검증(경로 구분자·.. 거부).
• quick_open_dialog.dart: FocusNode 를 State 필드로 · fuzzy 스코어러 · 선택 항목 ensureVisible · 최근 파일 가중치.
• git_sidebar.dart: 체크아웃은 GitService.checkoutBranch 로(880,883 폐기) · _commitFlow 의 stageAll(339) 제거 · 새로고침은 FS/.git 감시 기반.

총평: "Flutter 로 IDE 셸을 만들 수 있다" 를 4주 만에 보여준 데모로서 가치가 있고, git 서비스 파서·PTY 배선·리사이즈 핸들 정도는 바로 참고할 만하다. 그러나 편집 버퍼의 소유권이 불명확(Monaco 버퍼 vs _currentCode vs 디스크)해서 데이터 손실이 구조적으로 발생하고, 오류가 전부 삼켜지며, 플랫폼 지원은 macOS 하나뿐이다. 풀스택 에디터의 기반으로는 아키텍처를 새로 세우고 패턴만 선별 차용하는 것이 맞다.

부록 A. 파일별 메트릭 (스크립트 실측)

LOC 는 wc -l 기준(개행 수). git_service.dart·git_sidebar.dart 는 파일 끝 개행이 없어 물리 행은 1 더 많다.

부록 B. 검증 방법과 한계

• 정적 정독만 수행했고 빌드·실행은 하지 않았다(대상 디렉토리 무수정 원칙). 플랫폼 지원 판단은 pubspec.lock 의 해석 결과 + 각 플러그인 pubspec 의 platforms 선언 + pub.dev README(flutter_monaco 는 최신 3.4.3 README 기준, 1.1.1 과 차이 가능)에 근거한다.
• 저장소가 shallow clone 이라 커밋 이력·저자 수·활동 기간은 조회 불가 — 팀 리드가 제공한 GitHub 메타데이터(생성 2025-12-11, 마지막 push 2026-01-05; API 실측 커밋 22건 · 기여자 2명 — 주 저자 19건)를 인용했다.
• runInShell 인용 처리는 로컬 Dart SDK 3.47.3 의 process_patch.dart(_getShellArguments) 를 직접 읽어 확인했다. 셸 인젝션(§6-d)은 코드 경로 분석이며 실제 실행으로 재현하지는 않았다.
• 경쟁 조건 S2 는 타이밍 의존이라 재현 확률이 낮을 수 있으나, 코드상 방어 장치가 전혀 없다는 점은 확정적이다.