[#501] 프로젝트에 Tuist를 적용한다 (#512)

* chore: tuist 전환 기반 추가

* feat: tuist 모듈 매니페스트 구성

* refactor: tuist 생성 구조 전환

* fix: Tuist 권장 설정 및 번들 버전 경고 수정

* fix: Tuist 생성 안정화

* fix: 패키지 manifest 경고 제거

* chore: 위젯 문자열 카탈로그 갱신

* docs: Tuist 개발 도구 문서화

* ci: Tuist 생성 검증 추가

* refactor: 앱 타깃 스킴 정리

* ci: mise 액션 런타임 버전 업데이트

* refactor: 배포 타깃 설정 통합

* refactor: 위젯 접근자 생성 정리

Author: opficdev

.github/workflows/build.yml

@@ -5,8 +5,8 @@ on:
 
 env:
   WORKSPACE: DevLog.xcworkspace
-  SCHEME: DevLog
-  XCODE_VERSION: latest
+  SCHEME: DevLogApp
+  XCODE_VERSION: "26.3"
   MATCH_GIT_URL: ${{ secrets.MATCH_GIT_URL }}
   MATCH_GIT_BASIC_AUTHORIZATION: ${{ secrets.MATCH_GIT_BASIC_AUTHORIZATION }}
 
@@ -51,6 +51,12 @@ jobs:
           sudo xcode-select -s "$XCODE_APP/Contents/Developer"
           xcodebuild -version
 
+      - name: Set up Tuist
+        uses: jdx/mise-action@v4
+        with:
+          install: true
+          cache: true
+
       - name: Cache SwiftPM
         uses: actions/cache@v5
         with:
@@ -63,6 +69,25 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-spm-
 
+      - name: Generate Xcode project with Tuist
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          tuist generate --no-open
+
+          git diff --exit-code -- \
+            DevLog.xcworkspace \
+            Application/DevLogApp/DevLogApp.xcodeproj \
+            Application/DevLogCore/DevLogCore.xcodeproj \
+            Application/DevLogData/DevLogData.xcodeproj \
+            Application/DevLogDomain/DevLogDomain.xcodeproj \
+            Application/DevLogInfra/DevLogInfra.xcodeproj \
+            Application/DevLogPersistence/DevLogPersistence.xcodeproj \
+            Application/DevLogPresentation/DevLogPresentation.xcodeproj \
+            Widget/DevLogWidgetCore/DevLogWidgetCore.xcodeproj \
+            Widget/DevLogWidgetExtension/DevLogWidgetExtension.xcodeproj
+
       - name: Select iOS Simulator Runtime (installed)
         id: pick_ios
         shell: bash

.github/workflows/testflight.yml

@@ -18,7 +18,7 @@ on:
       - develop
 
 env:
-  SCHEME: DevLog
+  SCHEME: DevLogApp
   RUBY_VERSION: "3.2"
   XCODE_VERSION: latest
   APP_STORE_TEAM_ID: ${{ secrets.APP_STORE_TEAM_ID }}

.gitignore

@@ -13,6 +13,7 @@ xcuserdata/
 GoogleService-Info.plist
 UserInterfaceState.xcuserstate
 Breakpoints_v2.xcbkptlist
+**/Derived/
 **/build/
 **/xcuserdata/
 ContentView.swift
@@ -36,6 +37,14 @@ fastlane/logs/
 # Build Artifacts
 *.ipa
 *.dSYM.zip
+.package.resolved
+.home/
+.module-cache/
+.swift-module-cache/
+.tmp/
+.spm/
+Tuist/.build/
+DevLog.xcworkspace/.tuist-generated
 
 # drawio
-*.drawio.bkp
+*.drawio.bkp

.hermes/skills/devlog-architecture-harness/references/devlog-workflow-rules.md

@@ -13,7 +13,7 @@ This reference holds DevLog-specific working rules that should live with the pro
 - Prefer Xcode Local MCP for iOS project code changes.
 - If Xcode Local MCP is unavailable or fails because of session transport, state that explicitly before using a fallback.
 - This repository is workspace-based. Prefer workspace/scheme context over standalone project builds when dependencies cross module projects.
-- CI truth lives in `.github/workflows/build.yml`: `DevLog.xcworkspace`, scheme `DevLog`, simulator build, `-resolvePackageDependencies`, `-skipPackagePluginValidation`, and `-skipMacroValidation`.
+- CI truth lives in `.github/workflows/build.yml`: select Xcode 26.3, install Tuist with mise, run `tuist generate --no-open`, assert generated Xcode files are clean with `git diff --exit-code`, then build `DevLog.xcworkspace` scheme `DevLog` with `-resolvePackageDependencies`, `-skipPackagePluginValidation`, and `-skipMacroValidation`.
 - CI is build validation, not a full test run, unless the workflow changes.
 - Avoid unrelated `Package.resolved` churn. Keep lockfile changes only when dependency resolution is the task.
 

.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+tuist = "4.194.4"

Application/DevLogApp/DevLogApp.xcodeproj/project.pbxproj

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "2640"
-   version = "1.7">
+   LastUpgradeVersion = "2650"
+   version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
-      buildImplicitDependencies = "YES"
-      buildArchitectures = "Automatic">
+      buildImplicitDependencies = "YES">
       <BuildActionEntries>
          <BuildActionEntry
             buildForTesting = "YES"
@@ -15,9 +14,9 @@
             buildForAnalyzing = "YES">
             <BuildableReference
                BuildableIdentifier = "primary"
-               BlueprintIdentifier = "DFD48AFF2DC4D6E2005905C5"
+               BlueprintIdentifier = "B9946B184E6A28C345727743"
                BuildableName = "DevLog.app"
-               BlueprintName = "DevLog"
+               BlueprintName = "DevLogApp"
                ReferencedContainer = "container:DevLogApp.xcodeproj">
             </BuildableReference>
          </BuildActionEntry>
@@ -27,15 +26,14 @@
       buildConfiguration = "Debug"
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
-      shouldUseLaunchSchemeArgsEnv = "YES"
-      shouldAutocreateTestPlan = "YES">
+      shouldUseLaunchSchemeArgsEnv = "YES">
       <Testables>
          <TestableReference
             skipped = "NO"
-            parallelizable = "YES">
+            parallelizable = "NO">
             <BuildableReference
                BuildableIdentifier = "primary"
-               BlueprintIdentifier = "DF3416442E45F67C00F9312B"
+               BlueprintIdentifier = "0EDF4BB78A091D2F550FEB0C"
                BuildableName = "DevLogAppTests.xctest"
                BlueprintName = "DevLogAppTests"
                ReferencedContainer = "container:DevLogApp.xcodeproj">
@@ -57,9 +55,9 @@
          runnableDebuggingMode = "0">
          <BuildableReference
             BuildableIdentifier = "primary"
-            BlueprintIdentifier = "DFD48AFF2DC4D6E2005905C5"
+            BlueprintIdentifier = "B9946B184E6A28C345727743"
             BuildableName = "DevLog.app"
-            BlueprintName = "DevLog"
+            BlueprintName = "DevLogApp"
             ReferencedContainer = "container:DevLogApp.xcodeproj">
          </BuildableReference>
       </BuildableProductRunnable>
@@ -74,9 +72,9 @@
          runnableDebuggingMode = "0">
          <BuildableReference
             BuildableIdentifier = "primary"
-            BlueprintIdentifier = "DFD48AFF2DC4D6E2005905C5"
+            BlueprintIdentifier = "B9946B184E6A28C345727743"
             BuildableName = "DevLog.app"
-            BlueprintName = "DevLog"
+            BlueprintName = "DevLogApp"
             ReferencedContainer = "container:DevLogApp.xcodeproj">
          </BuildableReference>
       </BuildableProductRunnable>