goose 딥다이브
— WHOOP 5.0 데이터를 '내 폰 안에서만' 해석하는 로컬 우선 헬스 앱

1프로젝트 한줄 요약

goose는 WHOOP 5.0 피트니스 밴드의 데이터를 제조사 클라우드를 거치지 않고, 아이폰 안에서 직접 받아 해석하는 오픈소스 iOS 앱입니다. 밴드와는 블루투스(BLE)로 통신하고, 받아온 원시 데이터(패킷)는 Rust로 짠 계산 코어에 넘겨 수면 단계·회복 점수·스트레인(부하)·스트레스·심폐 부하·에너지 같은 건강 지표로 바꿉니다.

구조를 한 문장으로 줄이면 이렇습니다. SwiftUI 앱(화면) ↔ Rust 코어(두뇌)가 단 하나의 함수로 대화하고, 그 사이를 JSON 문자열이 오갑니다. 화면은 "수면 점수 계산해줘"라는 요청을 JSON으로 만들어 Rust에 던지고, Rust가 계산해서 JSON으로 답을 돌려주는 식이죠. 이렇게 UI는 Swift, 무거운 계산·검증은 Rust로 역할을 깔끔하게 나눈 것이 이 프로젝트의 정체성입니다.

중요한 단서: goose는 아직 알파(alpha) 단계의 개념 증명(PoC)입니다. README가 솔직하게 밝히듯, "Xcode가 뭔지, Rust 코어를 어떻게 빌드하는지 모른다면 이 빌드는 당신을 위한 것이 아니다"라고 적혀 있습니다. 일반 사용자용 앱이 아니라, 개발자가 '이 정도 규모의 프로젝트가 실현 가능한지' 평가하라고 공개한 코드라는 뜻입니다. 그래서 우리는 이걸 '완성품'이 아니라 '잘 설계된 아키텍처 표본'으로 공부합니다.

2왜 주목받는가

2025~2026년 개발자 커뮤니티의 큰 흐름 두 가지가 goose 안에서 만납니다. 하나는 "내 데이터는 내 기기에"라는 local-first·프라이버시 운동, 다른 하나는 "성능이 중요한 부분만 Rust로 빼고 UI는 네이티브로"라는 Rust↔네이티브 조합입니다. 웨어러블이라는 친숙한 주제에 이 둘을 정직하게 적용한 점이 화제가 됐습니다. TrendShift는 별 개수가 아니라 언급(mention) 모멘텀으로 순위를 매기기 때문에, 갓 공개된 알파 프로젝트도 #19에 오를 수 있습니다.

이 프로젝트가 긁어주는 실제 가려움

특히 인상적인 '데이터 정직성' 원칙

이 프로젝트가 단순한 취미 코드와 다른 결정적 지점은 가짜 데이터를 절대 보여주지 않겠다는 규율입니다. recovery-todo.md에는 이렇게 적혀 있습니다 — "회복 지표는 fixture(샘플)·예시 값을 쓰지 말 것. 신뢰할 수 있는 로컬 데이터가 생기기 전까지는 0이나 빈 상태(empty state)를 보여줄 것." 화면을 그럴듯하게 채우려고 임시 더미값을 넣는 흔한 유혹을 코드 규칙으로 금지한 셈입니다. 헬스 데이터처럼 신뢰가 생명인 분야에서 배울 만한 태도입니다.

경쟁 구도에서의 위치

3기술 스택 전체 지도

goose는 두 개의 언어로 된 한 몸입니다. 사람이 보는 화면은 전부 Swift/SwiftUI, 데이터를 해석하는 두뇌는 전부 Rust. 그리고 둘을 잇는 가느다란 다리(FFI)가 있습니다. 언어 비율이 Rust 73% / Swift 26%인 이유는, 화면보다 '데이터를 어떻게 정확히 해석하느냐'에 코드의 무게가 실려 있기 때문입니다.

① 프론트엔드 — SwiftUI 앱 (GooseSwift/)

사용자가 만지는 모든 것. 탭 4개(Home·Health·Coach·More)로 구성된 네이티브 iOS 앱입니다.

② 코어 — Rust 계산 엔진 (Rust/core/)

이 프로젝트의 진짜 본체. 패킷 파싱부터 수면 단계 판정, 회복 점수, 검증·내보내기까지 모든 '판단'이 여기 모여 있습니다. Cargo.toml을 뜯어보면 규모가 드러납니다.

릴리스 빌드 설정도 임베디드/모바일을 의식했습니다 — opt-level=3(최대 최적화), lto="thin"(링크 타임 최적화), codegen-units=1(최적화 우선), panic="abort"(패닉 시 즉시 종료해 바이너리 축소), strip="debuginfo"(디버그 심볼 제거). 앱에 들어갈 정적 라이브러리를 작고 빠르게 만들기 위한 전형적인 조합입니다.

③ 둘을 잇는 다리 — FFI (C ABI)

Swift와 Rust는 서로의 함수를 직접 부를 수 없습니다. 그래서 둘 다 이해하는 C 언어 규약(C ABI)을 중간 다리로 씁니다. 놀랍도록 단순합니다 — 헤더 파일(goose_core_bridge.h)에 함수가 딱 3개뿐입니다.

// goose_core_bridge.h — Swift와 Rust를 잇는 전체 인터페이스
char *goose_core_version_json(void);              // 버전 정보(JSON)
char *goose_bridge_handle_json(const char *req);  // 요청(JSON) → 응답(JSON)
void  goose_bridge_free_string(char *value);      // Rust가 만든 문자열 메모리 해제

핵심은 가운데 함수 하나입니다. "JSON 문자열을 넣으면 JSON 문자열이 나온다" — 모든 기능(수면 계산, 패킷 가져오기, 검증 등)이 이 단일 창구를 통합니다. 함수를 기능마다 수십 개 만드는 대신, 메서드 이름을 JSON 안에 담아 보내는 방식이죠. (자세한 동작은 4장에서)

④ 빌드 인프라 — Cargo + Xcode 결합

빌드 산출물(.a 아카이브)은 저장소에 커밋하지 않고 빌드할 때마다 로컬에서 생성합니다. 소스 트리를 깨끗하게 유지하려는 의도입니다.

4아키텍처 심화 분석

전체 데이터 흐름 한 장

핵심 패턴 ① — "함수 하나로 모든 것": JSON-RPC over FFI

언어가 다른 두 세계를 잇는 가장 흔한 실수는 기능마다 FFI 함수를 만드는 것입니다. 그러면 함수가 수십 개로 불어나고, 타입 변환 코드도 그만큼 늘어납니다. goose는 정반대로 갑니다 — 창구를 하나로 통일하고, "무엇을 할지"는 JSON 안에 적어 보냅니다. 마치 웹 API가 하나의 엔드포인트에 메서드 이름을 담아 호출하는 RPC와 같은 발상입니다.

// Swift가 Rust에 보내는 요청 봉투 (GooseRustBridge.swift)
{
  "schema": "goose.bridge.request.v1",
  "request_id": "goose-swift-1717459200.5-7",  // 타임스탬프+카운터로 추적
  "method": "sleep.compute",                     // 무엇을 할지
  "args": { ... }                                // 입력값
}

// Rust가 돌려주는 응답 봉투
{
  "ok": true,                 // 성공/실패 플래그
  "result": { ... },          // 결과(성공 시)
  "error": { "message": ... },// 에러(실패 시)
  "timing": { "method": "sleep.compute", "method_elapsed_us": 1234 }
}

Swift 쪽 래퍼는 이 봉투를 만들고, 문자열로 바꿔 goose_bridge_handle_json()에 넘긴 뒤, 돌아온 문자열을 다시 객체로 파싱합니다. 이때 반드시 지켜야 하는 규칙이 하나 있습니다.

// 소유권을 안전하게 넘겨받는 Swift 패턴
var responsePointer: UnsafeMutablePointer<CChar>?
request.withCString { pointer in
  responsePointer = goose_bridge_handle_json(pointer)
}
guard let responsePointer else { throw .nullResponse }
defer { goose_bridge_free_string(responsePointer) }  // ★ 끝나면 무조건 해제
let responseText = String(cString: responsePointer)

핵심 패턴 ② — 경계 비용을 '재는' 습관

흥미롭게도 goose의 브리지는 단순히 호출만 하지 않고, 매 호출의 시간 비용을 마이크로초 단위로 측정합니다. 요청을 JSON으로 만드는 데(encode), C 경계를 넘나드는 데(ffi round-trip), 응답을 파싱하는 데(decode) 각각 얼마가 걸렸는지를 기록하죠. 그리고 Rust가 알려주는 "순수 계산 시간(method_elapsed_us)"과 비교합니다.

핵심 패턴 ③ — 패킷을 '신뢰 가능한 지표'로 정제하는 파이프라인

Rust 코어의 lib.rs가 노출하는 40여 개 모듈을 보면, 원시 패킷이 화면에 뜨는 점수가 되기까지의 단계가 보입니다. 데이터를 함부로 믿지 않고 여러 검증 관문을 통과시킵니다.

특히 눈에 띄는 모듈들: metric_readiness(어떤 지표가 '계산 가능한 입력'을 갖췄는지 먼저 판정), privacy_lint(내보낼 데이터에 민감정보가 섞이지 않았는지 자동 점검), openwhoop_reference(WHOOP 프로토콜에 대한 오픈소스 참고 구현과의 대조), property_tests(무작위 입력으로 알고리즘 성질을 검증하는 속성 기반 테스트). 데이터 정직성이라는 원칙이 모듈 구조에까지 새겨져 있습니다.

5디렉토리 구조 해부

구조에서 읽히는 설계 의도가 분명합니다. 화면(GooseSwift)과 두뇌(Rust/core)가 폴더 단위로 완전히 분리되어 있고, 둘 사이는 GooseRustBridge.swift ↔ goose_core_bridge.h라는 좁고 명확한 한 지점으로만 연결됩니다. 또한 docs/goose-swift-mvp/에 각 탭의 "계약(contract)"과 수용 기준(acceptance check)을 문서로 남겨, 화면이 어떤 데이터를 어떤 상태로 보여줘야 하는지 미리 못 박아둔 점도 학습할 만합니다.

6학습 포인트 (기술별)

① Rust ↔ Swift FFI — '단일 JSON 창구' 패턴

가장 값진 교보재입니다. 서로 다른 언어를 붙일 때, 함수를 잘게 쪼개는 대신 JSON-in/JSON-out 함수 하나 + 메모리 해제 함수 하나로 끝내는 설계를 실제 코드로 볼 수 있습니다. C ABI, extern "C", UnsafeMutablePointer, withCString, defer 기반 메모리 해제까지 한 흐름으로 익힙니다.

실습 아이디어: 빈 Rust 라이브러리에 handle_json(req)->resp 함수 하나만 만들고, 파이썬/Node의 ctypes·ffi로 호출해 "ping→pong" JSON을 왕복시켜 보기.

② CoreBluetooth — 실제 기기와 BLE로 대화하기

GooseBLEClient.swift는 스캔 → 연결 → 서비스 탐색 → 패킷 수신 → 동기화라는 BLE의 전형적 수명주기를 담고 있습니다. central/peripheral, GATT 서비스·특성(characteristic), 알림(notify) 구독 같은 개념을 현실 기기 맥락에서 배울 수 있습니다.

③ local-first 아키텍처 — 서버 없이 SQLite로

백엔드가 없습니다. rusqlite로 폰 안에 SQLite DB를 두고 모든 상태를 로컬에 보관합니다. "동기화 서버가 진실의 원천"이 아니라 "내 기기가 진실의 원천"인 설계를 공부하기 좋습니다.

④ 데이터 무결성·정직성 규율

CRC32 체크섬, sanitize/correlation 단계, metric_readiness(입력이 충분할 때만 계산), property test, 그리고 "신뢰 데이터 없으면 빈 상태"라는 규칙. 사용자를 속이지 않는 데이터 UI를 어떻게 코드 차원에서 강제하는지 배웁니다.

⑤ iOS Live Activity (ActivityKit)

GooseWorkoutLiveActivityExtension은 운동 중 잠금화면·다이내믹 아일랜드에 실시간 정보를 띄우는 위젯입니다. 앱 본체와 익스텐션이 데이터를 공유하는 구조를 엿볼 수 있습니다.

⑥ 크로스-언어 빌드 파이프라인

build_ios_rust.sh 한 편이 작은 교과서입니다. 플랫폼별 Rust 타깃 선택(실기기 arm64 vs 시뮬레이터), xcrun으로 SDK 경로·clang·ar 찾기, 타깃별 환경변수(CC_*, CFLAGS_*, *_LINKER) 설정, 그리고 마커 파일 + find -newer로 불필요한 재빌드 건너뛰기까지. Xcode 빌드 단계에 외부 툴체인을 끼워 넣는 실전 기법입니다.

7하드웨어 / 시스템 요구사항

# iOS용 Rust 타깃 설치
rustup target add aarch64-apple-ios aarch64-apple-ios-sim x86_64-apple-ios

# 시뮬레이터 빌드 (커맨드라인)
xcodebuild -project GooseSwift.xcodeproj -scheme GooseSwift \
  -configuration Debug \
  -destination 'platform=iOS Simulator,name=iPhone 17' build

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

여유가 된다면 5주차로 HealthKit(수면 import·운동 write)과 ActivityKit(Live Activity)을 붙여, goose의 주변부 기능까지 직접 만들어 보면 전체 그림이 완성됩니다.

10핵심 키워드 사전

11참고 링크

• b-nnett/goose — GitHub 저장소(README·소스)
• TrendShift — goose 트렌드 페이지(#19)
• The Rustonomicon — FFI 가이드(소유권·안전성)
• Apple — CoreBluetooth 공식 문서
• Apple — ActivityKit(Live Activity) 문서
• Apple — HealthKit 문서
• rusqlite — Rust용 SQLite 바인딩
• Serde — Rust 직렬화 프레임워크