docs: add power-user import mode design

Author: yhs0602

docs/superpowers/plans/2026-03-19-power-user-import-mode.md

@@ -0,0 +1,76 @@
+# Power-User Import Mode Implementation Plan
+
+> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Keep SAF as the default import path while exposing advanced non-SAF import entry points only when power-user mode is enabled.
+
+**Architecture:** Add a small import entry-point catalog interface, a settings wrapper for the power-user toggle, and gate the advanced chooser behind that toggle. Keep standard imports on direct SAF and leave advanced browsing in `NewFileChooserActivity`.
+
+**Tech Stack:** Android Views preferences, Jetpack Compose, Activity Result API, existing shared preferences, JUnit5.
+
+---
+
+## Chunk 1: Import entry-point boundary
+
+### Task 1: Add failing unit test for entry-point visibility
+
+**Files:**
+- Test: `app/src/test/java/com/kyhsgeekcode/disassembler/importing/ImportEntryPointCatalogTest.kt`
+
+- [ ] Step 1: Write failing test for standard mode
+- [ ] Step 2: Run `./gradlew testDebugUnitTest --tests com.kyhsgeekcode.disassembler.importing.ImportEntryPointCatalogTest`
+- [ ] Step 3: Add `ImportEntryPoint` and `ImportEntryPointCatalog`
+- [ ] Step 4: Re-run the test until green
+
+### Task 2: Use catalog in project overview
+
+**Files:**
+- Create: `app/src/main/java/com/kyhsgeekcode/disassembler/importing/ImportEntryPointCatalog.kt`
+- Modify: `app/src/main/java/com/kyhsgeekcode/disassembler/ui/MainTab.kt`
+
+- [ ] Step 1: Render buttons from visible entry points
+- [ ] Step 2: Keep `Select file` on direct SAF
+- [ ] Step 3: Add `Advanced import` launch path
+- [ ] Step 4: Run `./gradlew testDebugUnitTest assembleDebug`
+
+## Chunk 2: Power-user settings boundary
+
+### Task 3: Add settings wrapper
+
+**Files:**
+- Create: `app/src/main/java/com/kyhsgeekcode/disassembler/preference/PowerUserModeSettings.kt`
+- Modify: `app/src/main/java/com/kyhsgeekcode/disassembler/preference/SettingsFragment.kt`
+- Modify: `app/src/main/res/xml/pref_settings.xml`
+- Modify: `app/src/main/res/xml-v30/pref_settings.xml`
+- Modify: `app/src/main/res/values/strings.xml`
+
+- [ ] Step 1: Add toggle preference XML
+- [ ] Step 2: Add wrapper object for preference reads
+- [ ] Step 3: Make `ProjectOverview` refresh setting on resume
+- [ ] Step 4: Run `./gradlew testDebugUnitTest assembleDebug`
+
+## Chunk 3: Advanced chooser gating
+
+### Task 4: Gate advanced root items
+
+**Files:**
+- Modify: `app/src/main/java/com/kyhsgeekcode/filechooser/NewFileChooserActivity.kt`
+- Modify: `app/src/main/java/com/kyhsgeekcode/filechooser/NewFileChooserAdapter.kt`
+- Modify: `app/src/main/java/com/kyhsgeekcode/filechooser/model/FileItem.kt`
+
+- [ ] Step 1: Add chooser extra for power-user mode
+- [ ] Step 2: Restrict advanced root items to power-user mode
+- [ ] Step 3: Keep direct SAF import outside chooser
+- [ ] Step 4: Run `./gradlew testDebugUnitTest assembleDebug`
+
+## Chunk 4: Final verification
+
+### Task 5: Verify and commit
+
+**Files:**
+- Modify as needed based on verification failures
+
+- [ ] Step 1: Run `JAVA_HOME=$(/usr/libexec/java_home -v 17) ANDROID_HOME=$HOME/Library/Android/sdk ./gradlew testDebugUnitTest assembleDebug`
+- [ ] Step 2: Update maintenance docs if behavior changed
+- [ ] Step 3: Commit feature in a focused commit
+

docs/superpowers/specs/2026-03-19-power-user-import-mode-design.md

@@ -0,0 +1,73 @@
+# Power-User Import Mode Design
+
+## Summary
+
+기본 파일 가져오기 흐름은 SAF를 기준으로 유지한다. 파워유저 기능은 별도 설정으로 명시적으로 활성화했을 때만 노출하고, 기본 사용자 경험과 구현 경로에서 분리한다.
+
+## Goals
+
+- 기본 사용자 경로는 Play 정책과 최신 Android 저장소 모델에 맞는 SAF 중심 흐름으로 유지한다.
+- 루트 파일 탐색, 직접 경로 탐색, 앱 목록 기반 선택 등 파워유저 기능은 기본 경로와 분리한다.
+- UI와 구현을 분리하기 위해 import entry point를 인터페이스로 추상화한다.
+
+## Non-goals
+
+- 이번 단계에서 루트 전용 구현을 새로 작성하지는 않는다.
+- 모든 legacy power-user 기능을 복구하지는 않는다.
+- 루트 권한 확보/검증 로직을 추가하지는 않는다.
+
+## UX
+
+### Standard mode
+
+- 메인 화면에는 `Select file`만 보인다.
+- 이 버튼은 바로 SAF `OpenDocument`를 호출한다.
+
+### Power-user mode
+
+- Settings에 `Enable power-user import options` 토글을 추가한다.
+- 토글을 켜면 메인 화면에 `Advanced import` 버튼이 추가로 보인다.
+- `Advanced import`는 기존 `NewFileChooserActivity`를 열고, 여기서만 non-SAF/advanced 소스를 노출한다.
+
+## Architecture
+
+### Import entry point boundary
+
+- `ImportEntryPoint`:
+  - `SafImport`
+  - `AdvancedImport`
+- `ImportEntryPointCatalog`:
+  - power-user 설정값에 따라 화면에 노출할 entry point 목록을 결정한다.
+- UI는 이 catalog만 보고 버튼을 렌더링한다.
+
+### Settings boundary
+
+- `PowerUserModeSettings`는 shared preference 접근을 캡슐화한다.
+- UI는 직접 preference key 문자열을 알지 않는다.
+
+### Advanced chooser boundary
+
+- `NewFileChooserActivity`는 `EXTRA_POWER_USER_MODE`를 입력으로 받는다.
+- power-user 모드일 때만 root/app/process/hash/zoo 등 advanced root items를 노출한다.
+
+## Data flow
+
+1. Settings에서 power-user toggle 변경
+2. `PowerUserModeSettings`에 저장
+3. `ProjectOverview`가 resume 시 설정값 재조회
+4. `ImportEntryPointCatalog`가 visible entry points 계산
+5. `Select file`은 SAF로 직접 import
+6. `Advanced import`는 advanced chooser로 이동
+
+## Testing
+
+- `ImportEntryPointCatalogTest`
+  - standard mode는 `SafImport`만 노출
+  - power-user mode는 `SafImport`, `AdvancedImport`를 노출
+- `PowerUserModeSettingsTest`는 이번 단계에서는 보류
+- 기존 `testDebugUnitTest` 전체 회귀 확인
+
+## Rollout
+
+- 이번 PR에서는 토글 + 버튼 분리 + chooser gating만 도입한다.
+- 후속 PR에서 root-only mode, direct-path mode, advanced source별 세부 제어를 추가한다.