diff --git a/.project/feature_quinn-prospector-ios/README.md b/.project/feature_quinn-prospector-ios/README.md index 58c93cdc..391521cd 100644 --- a/.project/feature_quinn-prospector-ios/README.md +++ b/.project/feature_quinn-prospector-ios/README.md @@ -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. diff --git a/CLAUDE.md b/CLAUDE.md index 11ef2627..8092d81a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 diff --git a/docs/prospector.md b/docs/prospector.md new file mode 100644 index 00000000..83184b6b --- /dev/null +++ b/docs/prospector.md @@ -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.). \ No newline at end of file diff --git a/tooling/claude/CLAUDE.md b/tooling/claude/CLAUDE.md index 0f2af520..7249d608 100644 --- a/tooling/claude/CLAUDE.md +++ b/tooling/claude/CLAUDE.md @@ -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 diff --git a/tooling/claude/dot-claude/instructions/mcp-servers.md b/tooling/claude/dot-claude/instructions/mcp-servers.md index 9333675a..93cc05d1 100644 --- a/tooling/claude/dot-claude/instructions/mcp-servers.md +++ b/tooling/claude/dot-claude/instructions/mcp-servers.md @@ -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 diff --git a/tooling/claude/dot-claude/instructions/project-paths.md b/tooling/claude/dot-claude/instructions/project-paths.md index 45848b42..9b045cca 100644 --- a/tooling/claude/dot-claude/instructions/project-paths.md +++ b/tooling/claude/dot-claude/instructions/project-paths.md @@ -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 | diff --git a/tooling/claude/dot-claude/instructions/workspace-architecture.md b/tooling/claude/dot-claude/instructions/workspace-architecture.md index b2e9e8a0..1f88e75a 100644 --- a/tooling/claude/dot-claude/instructions/workspace-architecture.md +++ b/tooling/claude/dot-claude/instructions/workspace-architecture.md @@ -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