# CocotteCockpitiOS (ios-fe) — Prospector Tab

The Prospector feature (1-view messenger with channels Life/Dates/Shows, Mr Number, classification, stage, operations sub-cats) is integrated as a **primary tab** (tag 3, icon "person.2", label "Prospector") in the main `TabView`.

See `Sources/App.swift`:

```swift
TabView(selection: $selection) {
    ...
    ProspectorTab()
        .tabItem { Label("Prospector", systemImage: "person.2") }.tag(3)
    ...
}
```

`ProspectorTab` is a thin wrapper (`NavigationStack { ProspectorView() ... }`).

The actual UI + logic is in the shared kit: `../cockpit-kit/Sources/CocotteCockpitKit/ProspectorView.swift` (and `ProspectorRow`, `ProspectorItem`, `ProspectorChannel`, etc.).

## Build / Launch notes (current DX)

- Use the local `project.yml`, `ios-tools.config.json`, and scripts in this directory.
- The feature tracker scripts (in the lilith .project/feature_quinn-prospector-ios/scripts/) are historical reference only; the active DX lives here.
- To land directly on the tab during development: pass `--tab 3` (the `RootView` reads it for initial selection) or use the run scripts that perform the tab reorder + launch.
- Example (from recent successful run): build from the updated sources here, install to the target simulator/device ("iPhone 16 Pro for Prospector"), launch with the tab selected. The UI appears with the exact channels, list, badges, summary, and "Classify All" as specified.

After the tab reorder, Prospector sits directly in the main bar (visible, not buried under More).

## Current state

- UI shell + demo data matching the spec/prototype (see the kit README for details and the live wiring TODOs).
- Real data will come from the platform (via `CockpitModel` / `LiveCockpitAPI` passed down, engagement-events, classifier, etc.).
- The kit view is preferredColorScheme(.dark) and uses the environment tokens from the shell.

For the full initiative history, spec, prototypes (the original swift-ui sample and quinn-my-ui TSX), objectives, and handoffs, see the feature tracker in the lilith tree:

`.project/feature_quinn-prospector-ios/` (updated to point here as the correct/current implementation location; quinn-ios refs are historical/legacy).

All active code lives in @cocottetech paths.

## Related

- Kit implementation + more notes: `../cockpit-kit/README.md`
- Platform backend (classifier, mcp-prospector, engagement, macsync integration for threads/pastebin/outbox, DO GPU models): tracked in the main platform docs and the mcp-prospector README.
- The companion native macOS / desktop experience can follow the same visual spec (see workspace designs and the quinn-my-ui prototype for parity).

**Packages note (Wave 1 restructure)**: Shared ProspectorClient/ProspectorUI now come from new canonical `@applications/@prospector/@packages/` (published for consumers including future real LP data wiring in ProspectorView here). Old locations @packages/@swift/@prospector and @applications/@quinn-prospector deprecated after migration (per plan.md). Use new for wiring to LP's proven backend (runner, mcp, quinn-api, Notes pastebin via macsync). GPU provision anytime via script; health script proof. MVP inbound replacement focus for OSX app.

---

*Live shell integration doc. The tracker holds the port story and planning; the source here + the kit is the truth for the running feature.*