docs(prospector): update CLAUDE.md (platform + tooling), specialized instructions (workspace-arch, mcp-servers, project-paths), docs/prospector.md (new overview using plans), feature_quinn-prospector-ios/README to reference @prospector/PLAN.md + handoffs + use plans for all prospector work (web PWA pivot, my/ impl, mesh/DO deploy, joker DNS cross-ref)
This commit is contained in:
Natalie
parent
eaaa2eaea4
commit
b3cb0efd1d
7 changed files with 57 additions and 16 deletions
|
|
@ -27,6 +27,8 @@
|
|||
|
||||
**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.
|
||||
|
|
|
|||
|
|
@ -51,7 +51,7 @@ lilith-platform.live/
|
|||
├── docs/ # LIVE, HARDENED docs for current implemented features & reality.
|
||||
│ # Authoritative: how things work *now* (APIs, integrations, operational loops,
|
||||
│ # quinn-api/DB writes, model usage, inbound handling, etc.).
|
||||
│ # E.g. FEATURE_GAP.md, quinn-my/AUDIT.md, prospector.md, mr-number-*.md,
|
||||
│ # E.g. FEATURE_GAP.md, quinn-my/AUDIT.md, prospector (see @applications/@prospector/PLAN.md + designs/ + platform handoff 20260628-prospector-webapp-pwa.md; web PWA primary at /prospector/app in my/, MCP for agents), mr-number-*.md,
|
||||
│ # company/ standing pages, DOMAIN_PORTFOLIO.md.
|
||||
│ # Never bury live behavior in planning trees.
|
||||
├── infrastructure/ # Docker Compose + ports.yaml + .env.ports
|
||||
|
|
@ -60,7 +60,7 @@ lilith-platform.live/
|
|||
│ # Objectives, team-leads, stream plans/handoffs, designs (briefs, contracts,
|
||||
│ # screens for features not yet live or in active development), previews,
|
||||
│ # state snapshots, training data for streams, history/ of retired work.
|
||||
│ # May *reference* live docs/ (e.g. "see docs/prospector.md for current").
|
||||
│ # May *reference* live docs/ (e.g. "see @applications/@prospector/PLAN.md + designs/ for current prospector webapp spec and phases; use plans/handoffs for work").
|
||||
│ # Feature streams live here until shipped; once live, docs move/promoted to docs/.
|
||||
├── users/transquinnftw/ # Quinn's personal narratives + coworker-agent
|
||||
└── .claude/ # Agents, commands, instructions, hooks, settings
|
||||
|
|
|
|||
33
docs/prospector.md
Normal file
33
docs/prospector.md
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
# 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.).
|
||||
|
|
@ -37,7 +37,7 @@ lilith-platform.live/
|
|||
├── docs/ # LIVE, HARDENED docs for current implemented features & reality.
|
||||
│ # Authoritative: how things work *now* (APIs, integrations, operational loops,
|
||||
│ # quinn-api/DB writes, model usage, inbound handling, etc.).
|
||||
│ # E.g. FEATURE_GAP.md, quinn-my/AUDIT.md, prospector.md, mr-number-*.md,
|
||||
│ # E.g. FEATURE_GAP.md, quinn-my/AUDIT.md, prospector (see @applications/@prospector/PLAN.md + designs/ + platform handoff 20260628-prospector-webapp-pwa.md; web PWA primary at /prospector/app in my/, MCP for agents), mr-number-*.md,
|
||||
│ # company/ standing pages, DOMAIN_PORTFOLIO.md.
|
||||
│ # Never bury live behavior in planning trees.
|
||||
├── infrastructure/ # Docker Compose + ports.yaml + .env.ports
|
||||
|
|
@ -46,7 +46,7 @@ lilith-platform.live/
|
|||
│ # Objectives, team-leads, stream plans/handoffs, designs (briefs, contracts,
|
||||
│ # screens for features not yet live or in active development), previews,
|
||||
│ # state snapshots, training data for streams, history/ of retired work.
|
||||
│ # May *reference* live docs/ (e.g. "see docs/prospector.md for current").
|
||||
│ # May *reference* live docs/ (e.g. "see @applications/@prospector/PLAN.md + designs/ for current prospector webapp spec and phases; use plans/handoffs for work").
|
||||
│ # Feature streams live here until shipped; once live, docs move/promoted to docs/.
|
||||
├── users/transquinnftw/ # Quinn's personal narratives + coworker-agent
|
||||
└── .claude/ # Agents, commands, instructions, hooks, settings
|
||||
|
|
|
|||
|
|
@ -34,6 +34,8 @@ unauthenticated; ports registered in `infrastructure/ports.yaml` (`mcp:` block,
|
|||
> `prospect` + junk tail diverges. For tour DEMAND use `quinn-prospector`
|
||||
> `get_metro_demand` (black corpus); events live only in the **prod** `quinn-my`
|
||||
> events table (`list_events`).
|
||||
>
|
||||
> **Web UI note (2026-06-28+)**: Operator primary is web PWA at my.transquinnftw.com/prospector/app (see @applications/@prospector/PLAN.md + designs/). MCP is for agents/coworker. Read plans before prospector work.
|
||||
|
||||
## Planned MCPs
|
||||
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@
|
|||
| @apps/quinn-launcher | ~/Code/@applications/@quinn-launcher |
|
||||
| @apps/quinn-m-mcp | ~/Code/@applications/@quinn-m-mcp |
|
||||
| @apps/quinn-prospector | ~/Code/@applications/@quinn-prospector (deprecated alias) |
|
||||
| @apps/prospector | ~/Code/@applications/@prospector |
|
||||
| @apps/prospector | ~/Code/@applications/@prospector (web PWA primary at my.transquinnftw.com/prospector/app + designs/ + PLAN.md handoff; see platform my/ for live UI) |
|
||||
| @apps/redroid | ~/Code/@applications/@redroid |
|
||||
| @apps/tv-anarchy | ~/Code/@applications/@tv-anarchy |
|
||||
| @apps/whatsapp | ~/Code/@applications/@whatsapp |
|
||||
|
|
@ -43,7 +43,7 @@
|
|||
| @apps/portable-net-tv | ~/Code/@applications/@portable-net-tv |
|
||||
| @apps/plum-control-mcp | ~/Code/@applications/@plum-control-mcp |
|
||||
|
||||
(ghosts removed: model-boss, audio, tor, ui, lilith-app etc; use current @* or ls first. @apps/prospector is canonical home for the OSX prospector app + internal published packages per Wave 1 restructure; LP is backend source of truth.)
|
||||
(ghosts removed: model-boss, audio, tor, ui, lilith-app etc; use current @* or ls first. @apps/prospector is canonical home for designs/ + PLAN.md (web PWA at /prospector/app in my/ + Swift legacy for iOS); LP is backend source of truth. Read PLAN.md + use plans/handoffs for work.)
|
||||
|
||||
### Packages (@pkg) — note: packages org primarily 1 repo
|
||||
| Alias | Path |
|
||||
|
|
|
|||
|
|
@ -116,19 +116,23 @@ Support buckets (@scripts/, @docs/, @forks/, @external/, @archives/, @work/) hol
|
|||
|
||||
**Verified count**: 3+ publishable packages in @model-boss
|
||||
|
||||
### @applications/@prospector/ (Quinn Prospector - OSX central workhorse, Tier 2)
|
||||
### @applications/@prospector/ (Quinn Prospector - web PWA primary at my.transquinnftw.com/prospector/app, Tier 2)
|
||||
```
|
||||
@prospector/
|
||||
├── @packages/
|
||||
│ ├── prospector-client/ → ProspectorClient (domain-models + api-client for LP quinn-api/mcp-prospector)
|
||||
│ └── prospector-ui/ → ProspectorUI (shared SwiftUI components, rows, views)
|
||||
├── designs/ (interactive prototypes as spec)
|
||||
├── macos/ or Sources/ (dedicated OSX app)
|
||||
├── mcp/ (pointers)
|
||||
├── scripts/ (e.g. health, GPU helpers)
|
||||
└── README.md
|
||||
├── designs/ (8 interactive HTML prototypes — authoritative spec for UI: main 1-view with Life/Dates/Digital segments + bilingual + MR/toolbar, reports-dashboard (4 reports), queued-tasks (sim + runner log + controls), pastebin-panel, detail-view, etc. + quinn-inbox-ops dashboard concepts (backlog follow-ups, inbound/channel sourced prospects totals))
|
||||
├── @packages/ (legacy Swift prospector-client/ui from prior OSX waves — retained for iOS ref / consumers like cocottetech ProspectorView; deprecate OSX app parts)
|
||||
├── CLAUDE.md (use PLAN.md first for work)
|
||||
├── PLAN.md (thorough handoff/10-phase plan for Claude/agent takeover: shell done in my/, port remaining views, wire real LP/mcp/macsync data (mesh only for messenger), PWA, deploy, verif)
|
||||
├── README.md (points to PLAN.md)
|
||||
└── (web impl lives in platform my/ frontend-public for SSO/deploy: ProspectorApp.tsx + route + manifest + reuse of prospector tabs/types)
|
||||
```
|
||||
Published from inside @prospector for consumers (cocottetech ProspectorView wiring to real LP data, quinn-ios, etc.). LP (lilith-platform) is the source of truth for prospect-runner, mcp-prospector tools, quinn-api, macsync Apple Notes pastebin, on-demand GPU (provision anytime via script when needed; health script as proof). MVP: inbound replacement for Claude desktop Executor prospector using proven backend.
|
||||
**Primary**: Containerless Chrome PWA / installable app (full viewport, devtools/"chrome toolkit" control, standalone when installed) as operator daily driver / on-road tool at my.transquinnftw.com/prospector/app (SSO via my. in lilith-platform). Replaces Claude Desktop Executor inbound. Web for speed/ease.
|
||||
|
||||
LP (lilith-platform) is source of truth for prospect-runner (ondemand GPU via provision script + health.sh proof), mcp-prospector tools, quinn-api /my/prospector/* (funnel, actions, corrections, experiments), macsync via quinn-messenger (Notes/pastebin, messages, phone, calendar — **mesh-isolated**; webapp deploys pure DO).
|
||||
|
||||
**See**: @prospector/PLAN.md (phases, verif rules, refs), platform .project/handoffs/20260628-prospector-webapp-pwa.md, designs/ (open HTMLs in browser for spec), my/ prospector code (ProspectorApp, OwedReplyTab for backlog, useMyApi, types), mcp-prospector/README, joker DNS todos in project_cloud-rebuild/BACKLOG.md (uvlava ct subdomains for registries enabling platform), Executor handoffs for workflow.
|
||||
|
||||
MVP: inbound replacement using designs/ + quinn-inbox-ops replication + real LP. Swift OSX legacy only for iOS sharing.
|
||||
|
||||
### Other Application Workspaces
|
||||
- **@applications/@ml/** - ML applications
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue