cocottetech/@platform/codebase/@features/ai-copilot/cockpit-kit/README.md

CocotteCockpitKit — Prospector

The Prospector 1-view (Life / Dates / Digital channels with Mr Number scoring, classification badges, stage, and operations sub-categories) is implemented as ProspectorView.swift + supporting types in this kit.

It is exposed as a primary tab (tag 3, "Prospector") in the iOS client shell (ios-fe/App.swift → ProspectorTab → ProspectorView).

Status (as of latest build)

• UI shell complete and matching the spec from the feature tracker prototypes (channels segmented, row with avatar + last message + badges for MR score / classification / stage, summary bar for classified count + high score, "Classify All" toolbar action, detail navigation stub).
• Demo / mock data using the exact taxonomy:
  • Life: personal:friends
  • Dates: work:dates (in-person bookings)
  • Digital: work:digital (OF/content audience, cams, digital work)
  • Operations sub-cats under work (medical, hair, beauty) + misc / spam
• Dark theme, NavigationStack + List + Picker(.segmented) + NavigationLink to detail (stub ProspectorDetail).
• Wired into the TabView in CocotteCockpitiOSApp (after Fleet, before Activity/Insights). Can be selected directly with --tab 3 (or the simulator run script that does the reorder + launch).

Current wiring: internal @State mock data in onAppear.
Next (real data): feed from CockpitModel / LiveCockpitAPI (engagement-events with prospect classification/state, Mr Number via specialist or dedicated endpoint, stage from prospect state machine). The "Classify All" button will call the platform classifier (fast rules + GPU LLM via mcp-prospector or direct when PROSPECT_LLM_BACKEND=modelboss).

See the feature tracker for the full initiative history and spec:

• .project/feature_quinn-prospector-ios/README.md
• .project/feature_quinn-prospector-ios/objectives/README.md (especially 0003 UI port + classification, 0008 wireless/sim state)
• Prototypes (for reference): swift-ui/ProspectorMessengerView.swift and the quinn-my-ui TSX version (headers now point here as the live home).

Build / Run (iOS client)

The Prospector tab is part of the normal CocotteCockpitiOS build. Use the DX in the ios-fe directory:

cd @platform/codebase/@features/ai-copilot/ios-fe

# Typical dev cycle (see the feature tracker's scripts/README.md for the full historical context and the reorder that made Prospector a primary tab)
./scripts/run-ios-sim.sh          # or the equivalent that builds + installs to simulator with --tab 3
# or
xcodebuild ... -scheme CocotteCockpitiOS ...  # then launch with args for tab selection

The ios-fe has its own ios-tools.config.json, project.yml, and scripts (the old quinn-ios ones in the tracker are retained only as historical reference).

After build/install/launch with the Prospector tab selected, the UI appears with the channels, list, badges, and summary exactly as prototyped.

Architecture notes (live implementation)

• UI: Pure SwiftUI in this kit (ProspectorView, ProspectorChannel, ProspectorItem, ProspectorRow, ProspectorDetail stub). Reuses kit design tokens / components where possible (the view is self-contained for the initial integration).
• Shell: ios-fe/Sources/App.swift owns the TabView (Drops 0, Assets 1, Fleet 2, Prospector 3, Activity 4, Insights 5). ProspectorTab is a thin wrapper that gives it a NavigationStack + title.
• Data / backend: Will use the shared CocottePlatformModels + CocottePlatformAPIClient (or the higher-level CockpitModel / LiveCockpitAPI in the feature). Classification comes from the platform ai-copilot surfaces + mcp-prospector (or direct for the 1-view). Mr Number screening and prospect state (stage) from the central prospector engine.
• quinn-my / web parity: The same 1-view + channels + badges + summary is prototyped in the tracker's quinn-my-ui/ProspectorMessenger.tsx to drive the web implementation.
• macOS / desktop: A parallel native macOS experience (separate target or app) can reuse the same visual spec / components (see the tracker prototypes and the companion OSX designs in the workspace). The backend (engagement + classifier + macsync for threads/pastebin/outbox) is shared.

Related (live vs planning)

• Live code: this ProspectorView.swift, the tab registration in ios-fe/App.swift, the platform backend (prospector features in api + mcp-prospector).
• Tracker / planning (history of the port from quinn-ios prototype, objectives, handoffs, the original sample that this view was ported from): .project/feature_quinn-prospector-ios/ (both in the lilith worktree and main tree copies). These are now updated to point here as the correct/current implementation location. quinn-ios references are explicitly historical/legacy.
• Designs / contracts (the v4 prospecting sub-features like cross-provider graph, auto-qualify, warm intros, marketplace): still in the planning surface (.project/designs/prospecting/ and ai-copilot specialist contracts).
• Executor / inbound handling instructions: See the platform mcp-prospector/README.md and the operator's Executor workspace (Documents/Claude/Projects/Executor/prospecting/) for the state machine, pastebin via macsync, macsync outbox wiring, DO GPU model usage, corrections loop, etc.

Wiring notes (for future real data)

• Pass CockpitModel (or a prospect-specific slice) down to ProspectorView.
• Map platform engagement-events (or /my/prospects + classifier results) to ProspectorItem.
• Classification badge from the fast + full (GPU) path.
• Mr Number score from the screening specialist / mr-number endpoints.
• Stage from the prospect state machine (prospect-qualification / runner).
• "Classify All" → call the classifier for the current filtered set (with macsync context for pastebin/templates if drafting).
• Detail view → full thread context + actions (mark worked, correction for training, draft/send via macsync outbox).

Packages / shared client note (Wave 1 restructure): The ProspectorClient/ProspectorUI (and future wiring to real LP data) are now published from the new canonical home @applications/@prospector/@packages/ (ProspectorClient, ProspectorUI). Update consumers here to use those (path for MVP, registry post-publish). Old @packages/@swift/@prospector/ and @applications/@quinn-prospector/ are deprecated (see their READMEs + plan.md). LP remains source of truth (prospect-runner, mcp-prospector, quinn-api, macsync pastebin). GPU on-demand via provision script + health script verification. MVP: OSX @prospector app as central to replace Executor inbound.

The tab is intentionally lightweight in the shell so the heavy lifting (model, API client, tokens) stays in the shared kit and platform layers.

---

This document lives with the live implementation. The feature tracker in lilith-platform describes the initiative and the port from the original prototypes. All active iOS work for the Prospector 1-view is in @cocottetech paths.