lilith-platform.live/docs/prospector.md

3.1 KiB

Prospector (Web PWA + MCP + iOS)

Primary operator UI (2026-06-28+): Containerless Chrome PWA / installable app at https://my.transquinnftw.com/prospector/app (SSO via my. surface).

  • Focused daily driver for inbound prospecting (replaces Claude Desktop Executor).
  • SSO + unified deploy with quinn.my (DO cloud).
  • See full spec + implementation phases in @applications/@prospector/PLAN.md (read this first for any work).
  • Current shell: codebase/@features/my/frontend-public/src/pages/ProspectorApp.tsx + route + manifest (reuses existing prospector tabs, types, /my/prospector/* endpoints, useMyApi).
  • Design spec: designs/ in @applications/@prospector/ (8 interactive HTML prototypes — open in browser; main-view, reports-dashboard (4), queued-tasks, pastebin, detail, bilingual, MR flow, quinn-inbox-ops dashboard fusion for backlog/inbound/channel stats).
  • Also replicable via quinn-desktop publish for phone review (no iOS app needed).

For agents / coworker (MCP): quinn-prospector MCP (codebase/@features/api/src/mcp-prospector on black :3912). Tools: cockpit_stream/classify/draft/send/thread/mark_worked, classify_message, mr_number_*, get_prospect/list_prospects, corrections, pastebin (via macsync), tour/backfill, etc.

Mesh note: Core webapp + most flows on pure DO + LP (quinn-api, prospect-runner for GPU ondemand, etc.). Only quinn-messenger depends on WG mesh (for macsync Apple integrations prospector uses: Notes pastebin/templates, messages, phonecalls, calendar). See quinn-messenger MCP + handoffs/20260628_prospector-macsync-integration.md.

iOS / consumers: designs/ as shared spec. iOS in cocottetech cockpit-kit (feature_quinn-prospector-ios tracks). Swift packages in @prospector/@packages/ retained for ref (legacy OSX app parts deprecated).

Deployment: quinn.my surface (./run deploy:my). joker.com DNS (NS for uvlava.com ct. subdomains to enable forge/npm/pypi/swift.ct registries + platform; A for live.transquinnftw.com) is cross-project enabler — see /pm hot todos + .project/project_cloud-rebuild/BACKLOG.md + uvlava docs.

Handoffs / Plans (always use these):

  • @applications/@prospector/PLAN.md (detailed 10-phase takeover plan, verif, commands).
  • .project/handoffs/20260628-prospector-webapp-pwa.md (my/ addition summary).
  • .project/handoffs/20260628_prospector-macsync-integration.md, 20260628_prospector-autohandler-parity.md, etc.
  • project_cloud-rebuild/PLAN.md + BACKLOG.md (joker DNS + cloud context).
  • See also: mcp-prospector/README.md, prospector-autorunner-handoff.md, of-redirect-spec.md, Executor handoffs (local), prospector-health.sh, provision-raw-gpu-droplet.sh.

Backend source: LP quinn-api surfaces + mcp-prospector + prospect features (engine_drafts, qualification, runner, corrections teach). Proven via health.sh.

References: @applications/@prospector/ (canonical), platform my/ prospector code + types, quinn-inbox-ops (Executor html,data dashboard artifact for stats), designs/ prototypes.

Work in this area must read/use the plans/handoffs above. Update them + this doc as status changes.

See root CLAUDE.md for broader protocols (use plans, collective voice, scoped commits, etc.).