Skip to content

StreamVault is a TV-first free IPTV player for Android TV built with Kotlin, Jetpack Compose, Room, Hilt, and Media3.

docs(system): record phase 5 extraction baseline

David Nashashe9e89e65d870
diff --git a/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md b/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md
index bb5c5a98..f5db8512 100644
--- a/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md
+++ b/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md
@@ -221,3 +221,18 @@ callbacks and `LiveEpgScaffoldContent` adapter; the feature owns Guide state,
preview lifecycle calls, controls, dialogs, hero/grid composition, and default
EPG strings. EPG behavior tests, non-default locale parity, golden/runtime
checks, and legacy cleanup remain open.
+
+## System extraction inventory (Task 0, 2026-09-04)
+
+Approved project dependencies: `:core:navigation`, `:core:ui`, `:domain`.
+Direct `:data` imports: none.
+App adapters: `SystemWelcomePort` maps `SyncProgressBus` and app `BuildConfig`;
+`SystemPluginManagementPort` delegates to `StreamVaultPluginManager` and
+`ProviderSourceRegistry`.
+Phase 7 follow-up: keep these ports narrow; do not move plugin IPC, provider
+ownership, playback routing, or Android startup infrastructure into the feature.
+
+The pre-extraction source, import, resource, test, and consumer evidence is in
+`validation/phase5_system/`. The System module remains unimplemented until the
+characterization, boundary, and performance gates in the approved plan are
+verified.
diff --git a/validation/phase5_system/consumer-inventory.txt b/validation/phase5_system/consumer-inventory.txt
new file mode 100644
index 00000000..9f974368
--- /dev/null
+++ b/validation/phase5_system/consumer-inventory.txt
@@ -0,0 +1,17 @@
+AppNavHost.kt -> registerWelcomeGraph(actions, startupReady, onStartupNavigationRequested)
+AppNavHost.kt -> registerSystemGraph(actions, onTopLevelDestinationRequested)
+WelcomeGraph.kt -> WelcomeScreen
+SystemGraph.kt -> DownloadsScreen, PluginsScreen
+DownloadsScreen.kt -> DownloadsViewModel, AppScreenScaffold, app R
+DownloadsViewModel.kt -> domain DownloadManager, Android document picker and ACTION_VIEW
+PluginsScreen.kt -> PluginsViewModel, app plugin models, AppScreenScaffold
+PluginsViewModel.kt -> StreamVaultPluginManager, ProviderSourceRegistry, app plugin models
+PluginModels.kt -> StreamVaultPluginContract, PluginPlaybackRouting, StreamVaultPluginManager
+PluginMessengerClient.kt -> StreamVaultPluginContract
+StreamVaultPluginManager.kt -> StreamVaultPluginContract, InstalledStreamVaultPlugin,
+ plugin discovery/IPC/provider/playback infrastructure
+PluginPlaybackRoutingTest.kt -> StreamVaultPluginContract, InstalledStreamVaultPlugin
+StreamVaultPluginOwnerTest.kt -> StreamVaultPluginOwner
+
+Generated baseline-profile and lint references also exist under app/build output
+and app/lint-baseline.xml; they are regenerated/maintained after source moves.
diff --git a/validation/phase5_system/performance-before.md b/validation/phase5_system/performance-before.md
new file mode 100644
index 00000000..6b1d25b2
--- /dev/null
+++ b/validation/phase5_system/performance-before.md
@@ -0,0 +1,54 @@
+# Phase 5 System extraction — pre-extraction performance baseline
+
+Captured: 2026-09-04 on `feature/improveCompose`, rollback SHA
+`cddef1526924634819c7fb27d15c8a49b3945a1d`.
+
+## Environment and protocol
+
+- Gradle 8.12; Oracle JVM 21.0.5; Windows 11 amd64.
+- All runs used `--no-daemon --console=plain --warning-mode=none` and
+ `--profile`; the Gradle wrapper starts a single-use daemon for each run.
+- The first source run refreshed configuration state; subsequent runs reused
+ configuration cache. Each run followed a reversible one-blank-line edit in
+ the named source and the file was restored before the next run.
+- `WelcomeScreen.kt` and `StreamVaultPluginOwnerTest.kt` have the same Git blob
+ hashes as `HEAD` after restoration (`fc8ea1e6...` and `62933d46...`).
+- The focused pre-baseline build completed successfully in 3m 30s before these
+ samples; its detailed task result is in `task0-inventory.md`.
+
+## `:app:compileDebugKotlin` source-edit samples
+
+| Sample | Duration | Build result | Task result | Cache state |
+|---|---:|---|---|---|
+| source-1 | 72.7s | success | 141 actionable; 3 executed; 138 up-to-date | configuration cache unavailable/rebuilt |
+| source-2 | 19.8s | success | 141 actionable; 1 executed; 140 up-to-date | reused |
+| source-3 | 20.6s | success | 141 actionable; 1 executed; 140 up-to-date | reused |
+| source-4 | 20.7s | success | 141 actionable; 1 executed; 140 up-to-date | reused |
+| source-5 | 21.1s | success | 141 actionable; 1 executed; 140 up-to-date | reused |
+
+Raw durations: 72.7065s, 19.7733s, 20.6311s, 20.7051s, 21.0920s.
+Min 19.8s; median 20.6s; max 72.7s. The first run is a cache/configuration
+outlier and must not be compared with a post-extraction warm median without
+matching cache state.
+
+## `:app:compileDebugUnitTestKotlin` test-edit samples
+
+| Sample | Duration | Build result | Task result | Cache state |
+|---|---:|---|---|---|
+| test-1 | 62.4s | success | 153 actionable; 4 executed; 1 from cache; 148 up-to-date | configuration cache unavailable/rebuilt |
+| test-2 | 18.2s | success | 153 actionable; 1 executed; 152 up-to-date | reused |
+| test-3 | 16.7s | success | 153 actionable; 1 executed; 152 up-to-date | reused |
+| test-4 | 17.6s | success | 153 actionable; 1 executed; 152 up-to-date | reused |
+| test-5 | 20.1s | success | 153 actionable; 1 executed; 152 up-to-date | reused |
+
+Raw durations: 62.4346s, 18.1523s, 16.6664s, 17.5945s, 20.1057s.
+Min 16.7s; median 18.2s; max 62.4s. The first run is a cache/configuration
+outlier; the warm median is the paired comparison baseline.
+
+## Baseline interpretation
+
+These are pre-extraction measurements only. They establish paired warm medians
+for the later System-only edit and feature test-compile measurements; they do
+not yet demonstrate the Phase 5 gates of 25% source improvement, 20% unit-test
+compile improvement, sibling Kotlin compile absence, clean/warm no-regression,
+or startup no-regression.
diff --git a/validation/phase5_system/project-imports.txt b/validation/phase5_system/project-imports.txt
new file mode 100644
index 00000000..61fa5797
--- /dev/null
+++ b/validation/phase5_system/project-imports.txt
@@ -0,0 +1,56 @@
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:52:import com.streamvault.app.R
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:53:import com.streamvault.core.ui.image.rememberCrossfadeImageModel
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:54:import com.streamvault.app.ui.components.shell.AppNavigationChrome
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:55:import com.streamvault.app.ui.components.shell.AppScreenScaffold
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:56:import com.streamvault.core.ui.design.AppColors
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:57:import com.streamvault.domain.model.DownloadItem
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt:58:import com.streamvault.domain.model.DownloadStatus
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsUiState.kt:3:import com.streamvault.domain.model.DownloadItem
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsUiState.kt:4:import com.streamvault.domain.model.DownloadStorageConfig
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsViewModel.kt:10:import com.streamvault.app.R
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsViewModel.kt:11:import com.streamvault.domain.model.DownloadItem
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsViewModel.kt:12:import com.streamvault.domain.repository.DownloadManager
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:54:import com.streamvault.app.navigation.Routes
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:55:import com.streamvault.app.plugins.InstalledStreamVaultPlugin
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:56:import com.streamvault.app.plugins.PluginConfigurationAction
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:57:import com.streamvault.app.plugins.PluginConfigurationField
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:58:import com.streamvault.app.plugins.PluginConfigurationSection
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:59:import com.streamvault.app.plugins.owner
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:60:import com.streamvault.app.plugins.toBundleSafeKey
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:61:import com.streamvault.core.ui.components.dialogs.PremiumDialog
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:62:import com.streamvault.core.ui.components.dialogs.PremiumDialogFooterButton
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:63:import com.streamvault.app.ui.components.shell.AppNavigationChrome
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:64:import com.streamvault.app.ui.components.shell.AppScreenScaffold
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:65:import com.streamvault.core.ui.components.shell.StatusPill
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:66:import com.streamvault.core.ui.design.AppColors
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:67:import com.streamvault.core.ui.design.FocusSpec
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:68:import com.streamvault.core.ui.interaction.TvButton
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:69:import com.streamvault.core.ui.theme.FocusBorder
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:70:import com.streamvault.core.ui.theme.OnSurface
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt:71:import com.streamvault.core.ui.theme.Primary
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:6:import com.streamvault.app.plugins.InstalledStreamVaultPlugin
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:7:import com.streamvault.app.plugins.PluginConfigurationAction
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:8:import com.streamvault.app.plugins.PluginConfigurationField
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:9:import com.streamvault.app.plugins.PluginConfigurationSchema
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:10:import com.streamvault.app.plugins.StreamVaultPluginManager
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:11:import com.streamvault.app.plugins.StreamVaultPluginOwner
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt:12:import com.streamvault.app.plugins.owner
+app/src/main/java/com/streamvault/domain/model/Result.kt:13:import com.streamvault.domain.model.Result
+app/src/main/java/com/streamvault/domain/provider/ProviderSource.kt:5:import com.streamvault.domain.provider.ProviderSource
+app/src/main/java/com/streamvault/domain/provider/ProviderSourceRegistry.kt:5:import com.streamvault.domain.provider.ProviderSourceRegistry
+app/src/main/java/com/streamvault/app/ui/screens/welcome/WelcomeScreen.kt:37:import com.streamvault.app.BuildConfig
+app/src/main/java/com/streamvault/app/ui/screens/welcome/WelcomeScreen.kt:38:import com.streamvault.app.R
+app/src/main/java/com/streamvault/core/ui/components/shell/StatusPill.kt:39:import com.streamvault.core.ui.components.shell.StatusPill
+app/src/main/java/com/streamvault/core/ui/design/AppColors.kt:40:import com.streamvault.core.ui.design.AppColors
+app/src/main/java/com/streamvault/core/ui/interaction/TvButton.kt:41:import com.streamvault.core.ui.interaction.TvButton
+app/src/main/java/com/streamvault/data/sync/SyncProgressBus.kt:42:import com.streamvault.data.sync.SyncProgressBus
+app/src/main/java/com/streamvault/data/sync/SyncProgressAggregate.kt:43:import com.streamvault.data.sync.SyncProgressAggregate
+app/src/main/java/com/streamvault/domain/repository/ProviderRepository.kt:44:import com.streamvault.domain.repository.ProviderRepository
+app/src/main/java/com/streamvault/domain/sync/Section.kt:45:import com.streamvault.domain.sync.Section
+app/src/main/java/com/streamvault/domain/usecase/M3uProviderSetupCommand.kt:46:import com.streamvault.domain.usecase.M3uProviderSetupCommand
+app/src/main/java/com/streamvault/domain/usecase/ValidateAndAddProvider.kt:47:import com.streamvault.domain.usecase.ValidateAndAddProvider
+app/src/main/java/com/streamvault/domain/usecase/XtreamProviderSetupCommand.kt:48:import com.streamvault.domain.usecase.XtreamProviderSetupCommand
+
+The import scan was run against the eight pre-extraction production files. The
+feature-owned target must retain only core navigation/UI and domain imports;
+app, data, and plugin-runtime imports are boundary work items.
diff --git a/validation/phase5_system/resource-inventory.txt b/validation/phase5_system/resource-inventory.txt
new file mode 100644
index 00000000..b8661657
--- /dev/null
+++ b/validation/phase5_system/resource-inventory.txt
@@ -0,0 +1,33 @@
+R.string.app_name
+R.string.download_delete
+R.string.download_folder_change
+R.string.download_folder_default
+R.string.download_resume
+R.string.downloads_delete_confirm_delete
+R.string.downloads_delete_confirm_msg
+R.string.downloads_delete_confirm_title
+R.string.downloads_deleted
+R.string.downloads_empty_hint
+R.string.downloads_empty_title
+R.string.downloads_item_title
+R.string.downloads_loading
+R.string.downloads_no_thumb
+R.string.downloads_resumed
+R.string.downloads_status_cancelled
+R.string.downloads_status_completed
+R.string.downloads_status_downloading
+R.string.downloads_status_failed
+R.string.downloads_status_paused
+R.string.downloads_status_pending
+R.string.nav_downloads
+R.string.settings_cancel
+R.string.sync_items_indexed_format
+R.string.sync_section_live
+R.string.sync_section_series
+R.string.sync_section_vod
+R.string.welcome_loading_subtitle
+R.string.welcome_loading_title
+R.string.welcome_setup_later
+R.string.welcome_setup_provider
+R.string.welcome_subtitle
+R.string.welcome_tagline
diff --git a/validation/phase5_system/source-inventory.txt b/validation/phase5_system/source-inventory.txt
new file mode 100644
index 00000000..1f0d98c8
--- /dev/null
+++ b/validation/phase5_system/source-inventory.txt
@@ -0,0 +1,8 @@
+app/src/main/java/com/streamvault/app/ui/screens/welcome/WelcomeScreen.kt
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsUiState.kt
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsViewModel.kt
+app/src/main/java/com/streamvault/app/ui/screens/downloads/DownloadsScreen.kt
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsViewModel.kt
+app/src/main/java/com/streamvault/app/ui/screens/plugins/PluginsScreen.kt
+app/src/main/java/com/streamvault/app/navigation/graph/WelcomeGraph.kt
+app/src/main/java/com/streamvault/app/navigation/graph/SystemGraph.kt
diff --git a/validation/phase5_system/task0-inventory.md b/validation/phase5_system/task0-inventory.md
new file mode 100644
index 00000000..40780d33
--- /dev/null
+++ b/validation/phase5_system/task0-inventory.md
@@ -0,0 +1,61 @@
+# Phase 5 System extraction — Task 0 inventory
+
+Captured: 2026-09-04
+
+## Rollback point and working tree
+
+- Branch: `feature/improveCompose`
+- Rollback SHA: `cddef1526924634819c7fb27d15c8a49b3945a1d`
+- Pre-existing dirty paths, preserved: `docs/COMPOSE_REDUCTION_AND_UI_ARCHITECTURE_PLAN.md`,
+ `docs/COMPOSE_REDUCTION_PHASE5_ROADMAP.md`, and the untracked approved plan
+ `docs/superpowers/plans/2026-09-04-system-feature-extraction.md`.
+- No production or test code was modified for Task 0.
+
+## Source baseline
+
+| File | Physical lines |
+|---|---:|
+| `WelcomeScreen.kt` | 310 |
+| `DownloadsUiState.kt` | 13 |
+| `DownloadsViewModel.kt` | 146 |
+| `DownloadsScreen.kt` | 439 |
+| `PluginsViewModel.kt` | 342 |
+| `PluginsScreen.kt` | 811 |
+| `WelcomeGraph.kt` | 29 |
+| `SystemGraph.kt` | 30 |
+| **Total** | **2,120** |
+
+The planning estimate of 2,248 lines was stale; these fresh counts are the
+authoritative pre-extraction baseline.
+
+## Boundary findings
+
+- Welcome directly imports app `BuildConfig`/`R`, `SyncProgressBus`, and provider
+ setup/repository types.
+- Downloads directly imports app `R` and `AppScreenScaffold`; its domain
+ dependency is the existing `DownloadManager`.
+- Plugins directly imports app shell/routes, plugin presentation models, and
+ `StreamVaultPluginManager`; runtime discovery, IPC, provider ownership, and
+ playback routing remain app-owned.
+- The System module has no approved direct `:data` dependency. Sync progress
+ and development seeding cross `SystemWelcomePort`; plugin operations cross
+ `SystemPluginManagementPort`.
+- Exactly 33 app string references are used by the eight production files.
+
+## Focused pre-extraction build
+
+Command:
+
+```text
+./gradlew.bat :app:testDebugUnitTest --tests com.streamvault.app.plugins.StreamVaultPluginOwnerTest --tests com.streamvault.app.plugins.PluginPlaybackRoutingTest :app:compileDebugKotlin --no-daemon --console=plain --warning-mode=none
+```
+
+Result: `BUILD SUCCESSFUL in 3m 30s`; 170 actionable tasks, 10 executed,
+1 from cache, 159 up-to-date. Gradle 8.12, JVM 21.0.5 (Oracle), Windows 11
+amd64. Configuration cache was absent at graph calculation and stored after
+the build. Existing compiler warnings were emitted (duplicate `-module-name`,
+deprecated memory-trim overrides/constants, and the Kotlin annotation target
+warning); none were introduced by this slice.
+
+The five source-edit and five unit-test-compile samples are recorded separately
+in `performance-before.md` once the reversible-edit runs complete.
diff --git a/validation/phase5_system/test-inventory.txt b/validation/phase5_system/test-inventory.txt
new file mode 100644
index 00000000..5c52c0df
--- /dev/null
+++ b/validation/phase5_system/test-inventory.txt
@@ -0,0 +1,5 @@
+app/src/test/java/com/streamvault/app/plugins/PluginPlaybackRoutingTest.kt
+app/src/test/java/com/streamvault/app/plugins/StreamVaultPluginOwnerTest.kt
+
+No Welcome, Downloads, or Plugins presentation tests existed before this slice;
+characterization coverage is a required first implementation task.