lilith-platform.live/.project/feature_quinn-prospector-ios

feature_quinn-prospector-ios

Initiative: Prospector 1-view (Life/Work/Shows messenger with classification per spec, Mr Number, stage) as part of the @cocottetech v4 platform client. The iOS lives in cocottetech's cockpit iOS (ios-fe + kit); this tracker holds the spec and prototypes (historical quinn-ios references are legacy).

One-view magic: Unified inbox/list that surfaces:

• Mr. Number scoring (colored badge/score from screening)
• Prospect classification (e.g. "qualified", "harvester", "budget", "off-brand" — using our fast rules + GPU LLM classifier)
• Prospecting stage (New / Engaged / Logistics / Booked / etc. from prospect state machine)
• Life vs Work divide (Personal messages tab/section vs Work/Prospects with scoring+classification+stage. Personal has no prospector overlays.)

Also: Corresponding UI enhancements in quinn-my (web/desktop) for the same surfaces.

Great DX commands (reproducible, reusable, from this dir or aliased):

• ./scripts/build.sh — builds the iOS + Watch targets (rsync to plum if needed, xcodegen, xcodebuild via ios-tools or direct).
• ./scripts/deploy-iphone-wireless.sh — wireless install to iPhone over local network (xcrun devicectl or ios-tools deploy --wireless).
• ./scripts/deploy-iwatch-wireless.sh — same for Apple Watch (pairs automatically).
• ./scripts/full-cycle.sh — build + deploy to both + verify.
• All use config, support --dry-run, --simulator fallback, logging, etc. for great DX like TVAnarchy.

Integration:

• Uses cocottetech platform models, api-client, and cockpit-kit (design tokens, components).
• Data from quinn.api (prospector surfaces, /my/prospects, mr-number screening, macsync/quinn-messenger threads via BFF).
• Classifier via the efficient fast-classifier (local) + full via mcp-prospector or direct API (GPU-backed LLM when deployed).
• Mr Number via the screening endpoints / mcp tools.
• Life/work: client tags or separate "personal" vs "prospect" inboxes (personal falls back to regular messenger data; work uses prospect classification + stage + score).
• quinn-my web UI: parallel "Prospector Messenger" view or tab with same 1-view list (React/TSX using the same backend).

Precedent: (historical) quinn-ios (old), TVAnarchy, quinn-my prospector, mcp-prospector, plans. Current iOS home is @cocottetech cockpit client.

Use plans: Read @applications/@prospector/PLAN.md (webapp primary, phases for /prospector/app PWA + designs/) + platform .project/handoffs/ + this feature's objectives/ before work. See docs/prospector.md.

Status: Tracker for the initiative (Life/Work/Shows 1-view with Mr Number, classification per spec [personal:friends],[work: operations(medical, hair, beauty),dates, shows], misc, spam, stage, etc.).

iOS impl in @cocottetech v4 cockpit client (ios-fe + cockpit-kit/ProspectorView.swift with tab). Legacy quinn-ios refs are historical; use cocotte DX.

Prototypes here document the required UI.

Note on backend: The classify/cockpit intelligence comes from the platform/ai-copilot (in @cocottetech) and mcp-prospector surfaces. Deployment state for those is tracked separately (see objectives and handoffs).

Quick Start (historical; see cocotte path)

For the cocotte cockpit iOS (current home):

• Use the DX in @cocottetech/@platform/codebase/@features/ai-copilot/ios-fe (its scripts/config).
• The Prospector is a tab inside the running CocotteCockpitiOS app (no separate bundle needed for the initial integration).
• To test the view: build/run the cockpit iOS, switch to the Prospector tab. The 1-view with the channels + classification per spec is there (mock data; wire to platform data later).

See scripts/ and docs/ for details.

Architecture (updated for cocotte v4 path)

• Native iOS: Integrated tab in CocotteCockpitiOS (see ios-fe/App.swift). ProspectorView in cockpit-kit implements the 1-view (Life | Dates | Shows channels, badges for MR/classification/stage per spec, derive logic).
• Data: From platform (engagement-events with prospectId, classification via backend or client derive, etc.).
• quinn-my / web: Prototypes in quinn-my-ui/ here inform platform equivalents.
• Backend: platform.api + ai-copilot (in @cocottetech).
• Deploy DX: cocotte ios-fe tooling.
• Legacy note: Old quinn-ios / separate bundle scripts here are historical.

See objectives/ (updated).

DX Commands (Great, Reproducible)

All scripts are here, support env overrides, --help, --dry, verbose logs. Run from this dir on plum or with ssh.

Example:

./scripts/build.sh --target=prospector-ios --watch
./scripts/deploy-iphone-wireless.sh --udid=auto
./scripts/deploy-iwatch-wireless.sh

See scripts/README.md for full.

When you run the deploy, the new "Quinn Prospector" (or "Life Messenger") app will appear on your iPhone home screen, and Watch app/complications. It will be the life/work divided messenger replacement with the 1-view prospect surfaces.

Integration Points (current, in cocotte v4)

• See the cocottetech cockpit-kit ProspectorView + platform models/api-client (engagement-events etc.).
• Classification: the derive + backend classifier (as implemented in the port).

Next

See objectives/ (updated for cocotte path and the port to cockpit-kit + tab).

The tracker captures the requirement and design; active code is in @cocottetech.