ios: native iOS client (radio, podcasts, library, SSH/SFTP provider)

.github/workflows/ios.yml

@@ -0,0 +1,66 @@
+name: ios
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ios-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  # Pinned so the project file and the manifest agree. Bump deliberately.
+  XCODEGEN_VERSION: 2.45.4
+  XCODE_APP: /Applications/Xcode_26.6.app
+
+jobs:
+  simulator:
+    # macos-26 ships Xcode 26.6 (17F113), the same toolchain the local
+    # project is developed against. See ios/README.md for the matrix.
+    runs-on: macos-26
+    defaults:
+      run:
+        working-directory: ios
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Select Xcode
+        run: sudo xcode-select -s "$XCODE_APP"
+
+      - name: Install XcodeGen
+        run: |
+          curl -sL -o "$RUNNER_TEMP/xcodegen.zip" \
+            "https://github.com/yonaskolb/XcodeGen/releases/download/$XCODEGEN_VERSION/xcodegen.zip"
+          unzip -q "$RUNNER_TEMP/xcodegen.zip" -d "$RUNNER_TEMP"
+          echo "$RUNNER_TEMP/xcodegen/bin" >> "$GITHUB_PATH"
+
+      - name: Generate project
+        run: xcodegen generate
+
+      # Package logic is plain Swift; `swift test` runs it on the runner
+      # without a simulator boot.
+      - name: Test CliampCore
+        run: swift test --package-path CliampCore
+
+      # Device signing is not configured in CI: the simulator build and the
+      # hosted unit tests run unsigned.
+      - name: Build app (unsigned)
+        run: |
+          xcodebuild build \
+            -project Cliamp.xcodeproj \
+            -scheme Cliamp \
+            -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest' \
+            CODE_SIGNING_ALLOWED=NO
+
+      - name: Test app (unsigned)
+        run: |
+          xcodebuild test \
+            -project Cliamp.xcodeproj \
+            -scheme Cliamp \
+            -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest' \
+            CODE_SIGNING_ALLOWED=NO

.gitignore

@@ -19,5 +19,13 @@ keystore.properties
 # test artifact: local Room database dump
 kls_database.db
 
+# Xcode: the project is generated from ios/project.yml by XcodeGen
+*.xcodeproj/
+*.xcworkspace/
+xcuserdata/
+DerivedData/
+.swiftpm/
+.build/
+
 # local planning scratchpad, not for upstream (for now)
 plan.md

AGENTS.md

@@ -1,12 +1,13 @@
 # OpenCode
 
-This repo is the **Android app**. The player UI lives in **cliamp**, a separate Go project.
+This repo holds the **Android app** and the **iOS app**. The player UI lives in **cliamp**, a separate Go project.
 
 ## Source map
 
 | Tree                                                | Role                                       |
 | --------------------------------------------------- | ------------------------------------------ |
-| this repository                                     | Kotlin / Compose Android client            |
+| `android/`                                          | Kotlin / Compose Android client            |
+| `ios/`                                              | SwiftUI iOS client (port in progress)      |
 | [bjarneo/cliamp](https://github.com/bjarneo/cliamp) | TUI source of truth (Bubbletea, Lip Gloss) |
 
 Find cliamp without machine-specific paths:
@@ -38,10 +39,15 @@ Two local skills own product work. Everything else is generic language guidance.
 
 `go-skills-router`, `go-coding-standards`, `go-cli`, `go-architecture-review`, `go-concurrency-review`
 
+**Swift / SwiftUI** — no local Swift skill set exists. Use standard Swift 6 and SwiftUI conventions, and treat `docs/design.md` plus `docs/ios-parity.md` as the product source of truth. Do not invent or claim Swift skills that are not installed.
+
 Do not add git plugin entries to `opencode.jsonc`.
 
 ## Routing
 
+**iOS port**  
+Read `docs/ios-parity.md` first; it owns scope, IDs, and state. `ios/project.yml` is the project source: run `xcodegen generate` inside `ios/` before building, and never commit the generated project. Build with `xcodebuild` (see `ios/README.md` for pinned commands). When porting behavior, read the Android source as the reference; do not edit `android/` from an iOS task.
+
 **Android cleanup**  
 Load `android-kotlin-modernize` plus the Kotlin/Compose set. Do not edit cliamp.
 

THIRD-PARTY-NOTICES.md

@@ -7,6 +7,7 @@ not. They are redistributed under their own terms.
 
 | Component | Licence | Notes |
 | --- | --- | --- |
+| Poppins | SIL Open Font License 1.1 | Full text in `licenses/Poppins-OFL.txt`. Redistributing the font files requires shipping this notice. |
 | JetBrains Mono 2.304 | SIL Open Font License 1.1 | Full text in `licenses/JetBrainsMono-OFL.txt`. Redistributing the font files requires shipping this notice. |
 | AndroidX (core, lifecycle, activity, compose, datastore) | Apache License 2.0 | Copyright The Android Open Source Project |
 | AndroidX Media3 (ExoPlayer, session, HLS, okhttp datasource) | Apache License 2.0 | Copyright The Android Open Source Project |

docs/ios-parity-evidence/FND-01.md

@@ -0,0 +1,35 @@
+# FND-01 — foundation decisions and runnable project
+
+Task ID / owner: FND-01 / opencode (2026-09-16)
+
+Android baseline commit / build: `21782fd233b4ab089dc1e6ea56e758a2aa2a8477` (inspected only; no device audit yet)
+
+iOS commit / build / device / OS: `d894f39` scaffold + the CI/docs commit that follows it; iPhone 17 simulator, iOS 26.5; Xcode 26.6 (17F113), XcodeGen 2.45.4
+
+Fixture and reproduction steps:
+
+```sh
+cd ios
+xcodegen generate
+swift test --package-path CliampCore
+xcodebuild build -project Cliamp.xcodeproj -scheme Cliamp \
+  -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest' CODE_SIGNING_ALLOWED=NO
+xcodebuild test -project Cliamp.xcodeproj -scheme Cliamp \
+  -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest' CODE_SIGNING_ALLOWED=NO
+xcrun simctl install <device> "$(find ~/Library/Developer/Xcode/DerivedData/Cliamp-*/Build/Products/Debug-iphonesimulator -maxdepth 1 -name Cliamp.app)"
+xcrun simctl launch <device> stream.cliamp.mobile
+```
+
+Functional result and test link: package tests 2/2 passed (`swift test`), app tests 2/2 passed (`xcodebuild test`), unsigned simulator build succeeded, app launched to the placeholder shell. Gate F: P (local). Warnings are errors on both paths: app targets via `SWIFT_TREAT_WARNINGS_AS_ERRORS` / `GCC_TREAT_WARNINGS_AS_ERRORS`, CliampCore via `-warnings-as-errors` in its manifest (verified in the `swiftc` invocations for both `swift test` and the Xcode build). CI workflow `.github/workflows/ios.yml` pins `macos-26` + Xcode 26.6 + XcodeGen 2.45.4; its first GitHub run is pending a push from the owner.
+
+Visual result and paired capture link: not applicable — the placeholder shell has no product visuals; VIS work starts in phase 1. Gate V: NA.
+
+Experience result and video/device notes: not applicable — no product interactions exist yet. Gate X: NA.
+
+Persistence / offline / error checks: not applicable to the scaffold.
+
+Decisions recorded (ios/README.md): iOS 18.0 floor (DEC-03 surfaces), universal iPhone + iPad portrait/landscape, SwiftUI + Swift 6, XcodeGen generated project, app + local SPM packages, unsigned simulator CI, automatic device signing with no repo credentials. Device matrix: CI on iPhone 17 simulator; visual review on iPhone 17e / 17 Pro Max / iPad mini / iPad Pro 11; physical iPhone named by owner before `RAD-11`.
+
+Known difference or blocker / decision ID / next action: CI has not executed on GitHub yet; run it on the next push and move FND-01 to `D` if green. XcodeGen 2.45.4 is pinned in CI but not enforced locally against a different version; `minimumXcodeGenVersion` guards only the manifest schema. A codex `gpt-6-astra` review of the first two commits (2026-09-16) found four issues — package warnings-as-errors not enforced, a wrong Clang warnings-as-errors key, device-matrix references pointing nowhere, and stale tracker prose — all fixed in the follow-up commit. FND-02 (Android reference capture) and FND-03 (audio spike) are the next dependency-ready rows.
+
+Reviewer / date: pending

docs/ios-parity-evidence/first-view-slice.md

@@ -0,0 +1,34 @@
+# First view slice — design contract, shell, Stations, settings, player
+
+Task IDs / owner: VIS-01–06, RAD-01, RAD-06–07, SET-01 (all W) / opencode (2026-09-16)
+
+Android baseline commit / build: `21782fd233b4ab089dc1e6ea56e758a2aa2a8477` (source read for palette, type, icons, chrome, controls, Stations, Settings, Now Playing)
+
+iOS commit / build / device / OS: `ee947cb`, `4c88b38`, `3753476`; iPhone 17 simulator, iOS 26.5; Xcode 26.6
+
+Fixture and reproduction steps:
+
+```sh
+cd ios
+xcodegen generate
+swift test --package-path CliampDesign   # 15 tests
+swift test --package-path CliampCore     # 11 tests
+xcodebuild build -project Cliamp.xcodeproj -scheme Cliamp \
+  -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest' CODE_SIGNING_ALLOWED=NO
+xcodebuild test -project Cliamp.xcodeproj -scheme Cliamp \
+  -destination 'platform=iOS Simulator,name=iPhone 17,OS=latest' CODE_SIGNING_ALLOWED=NO  # 3 app tests
+```
+
+Preview hooks (DEBUG only) drive the screens for capture: `-cliamp-preview-player` plays the first seed station and opens the player, `-cliamp-preview-playing` does the same without opening it, `-cliamp-preview-url <url>` plays any URL, `-cliamp-preview-directory` / `-cliamp-preview-custom` open those filters (and the custom add form).
+
+Functional result and test link: design suite 15/15 (palette values, alpha-first hex, SVG path arcs/sweep/adjacent decimals, icon shape counts); core suite 11/11 (seed list, m3u parsing, model derived fields, time formatting); app suite 3/3 (package linkage, root construction, all six font faces registered). Stations fetched 15 live channels from `streams.m3u` on the simulator and fell back to the twelve-channel seed when parse/fetch fails (fallback path unit-tested via `parseGarbage`, live offline test still open). AVPlayer played the Lofi stream with ON AIR, buffering and error states observed.
+
+Visual result and paired capture link: simulator captures reviewed during development — Stations in oxide-light and oxide, Now Playing (dark), Settings (dark). Paired Android captures do not exist yet (FND-02); gates stay unchecked.
+
+Experience result and video/device notes: transport press travel renders in both themes; favourite star toggles in place; tab bar and rail switch at the landscape breakpoint. No device feel review, no video, no VoiceOver pass.
+
+Persistence / offline / error checks: favourites, theme choice and all settings are in-memory for this slice; the app returns to "nothing playing" on relaunch. Offline playlist fallback is implemented but not exercised on-device. A failed stream surfaces "STREAM ERROR" text; no backoff yet (RAD-10).
+
+Known difference or blocker / decision ID / next action: at the time of this slice the player had no ICY metadata, artwork, directory, search, queue or persistence; all but queue/search/persistence landed in later commits recorded in the activity log, and the codex review of the shell/model/radio code was resolved before any gate was set.
+
+Reviewer / date: pending