From abc614fc985b2488465895f433794d7eaa5bf2d9 Mon Sep 17 00:00:00 2001
From: Keysat <licensing@keysat.xyz>
Date: Sat, 20 Jun 2026 06:15:16 -0500
Subject: [PATCH] =?UTF-8?q?Mobile=20Phase=208g:=20add-investor=20sheet=20?=
 =?UTF-8?q?=E2=80=94=20optional=20stage=20picker=20+=20Priority=20toggle?=
 =?UTF-8?q?=20+=20reminder?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The mobile "New investor" sheet now captures three optional fields beyond name/contact/note,
matching the dc (GridApp.dc.html:737):

- Initial pipeline stage — a .stage-pick chip picker, defaulting to "Not in pipeline" so a
  plain directory add never auto-creates an opportunity row (Grant's call).
- A framed "Flag as Priority" toggle.
- An optional reminder (title + a progressive due-date field).

submitCreate orchestrates one-row calls in order: create (log-communication
create_investor_if_missing, now carrying priority) -> if a stage was picked, link to the
pipeline at that stage (reusing applyStage's idempotent link-then-PATCH) -> if a reminder
title was given, POST /api/reminders keyed on the new row's source_row_id. The link and
reminder steps are non-fatal: a failure toasts but never loses the created investor, and a
create that returns no row id warns instead of a clean success.

Backend: handle_log_fundraising_communication honors an optional priority flag only on its
create-if-missing branch (an existing-row log never touches priority).

Guarded by test_grid_add_investor.py (priority-on-create, defaults-False, the create-branch-
only invariant, and the create->link / create->reminder handshakes on a freshly-synced row).
40/40 backend green; the create sheet was interaction-verified in a throwaway jsdom harness.
---
 AGENTS.md                         |   9 +-
 backend/server.py                 |   5 +-
 backend/test_grid_add_investor.py | 180 ++++++++++++++++++++++++++++++
 frontend/index.html               |  96 +++++++++++++++-
 4 files changed, 279 insertions(+), 11 deletions(-)
 create mode 100644 backend/test_grid_add_investor.py

diff --git a/AGENTS.md b/AGENTS.md
index 1a49a25..ecadb57 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -75,7 +75,7 @@ Subsystem rules live in `docs/guides/` and lazy-load in Claude Code via `.claude
 - **Env:** secrets in `.env` (gitignored); names in `.env.example`. Verified names: `ANTHROPIC_API_KEY`, `SPARK_CONTROL_URL`, `SPARK_CONTROL_VERIFY_TLS`, `QDRANT_URL`, `X_API_KEY`, `CRM_DB_PATH`, `CRM_DEV_DB_PATH`. Also used: `CRM_SECRET_KEY` (beta/prod), `CRM_HOST`/`CRM_PORT`, `CRM_DATA_DIR`; digest mailer: `CRM_DIGEST_SENDER` (DWD impersonation sender) + `SMTP_HOST`/`SMTP_PORT`/`SMTP_SECURITY`/`SMTP_FROM`/`SMTP_USERNAME`/`SMTP_PASSWORD` (SMTP fallback); daily digest (Phase B): `CRM_DIGEST_ENABLED` + `CRM_DIGEST_SEND_HOUR` **only seed the first-boot default** — the live control is the DB policy (`app_settings.digest_policy`, set in Settings → Admin).
 - **Config placement:** operational/feature toggles live in the **admin panel**, DB-backed via `app_settings` (read-merge through a `load_*_policy(conn)` helper shared by the API + any scheduler; precedence DB-row → env-seed → default), so they're discoverable and take effect live. Reserve StartOS actions / env for **secrets and deploy-time config** (SMTP creds, API keys, DWD sender). Precedent: `digest_policy` (`GET/PATCH /api/admin/digest/policy`), `fundraising_backup_policy`.
 - **Agent/bot API access — three roles now (`admin`/`member`/`bot`).** `require_admin` is the only hard gate; everything else is "authenticated" (member, admin, *and* bot all pass). The **`bot` role** (added v0.1.0:89) is authenticated-but-never-admin: `require_bot_or_admin` gates agent-facing endpoints (e.g. `/api/intake/email-proposals*`) so a bot credential reaches *only* what it needs, never user-management/settings/security. Provision it via Settings → Admin edit-user dropdown (kept out of the teammate-invite form). **Two axes to keep separate as more agent capability lands:** the role controls *reach* (which endpoints); the per-feature human draft→approve gate controls *autonomy* (acting unattended). Money/merge/delete mutations stay behind the approval gate regardless of role. Don't build a finer capability/scope system until real NL-mutation endpoints exist to scope against.
-- **Design:** before building or changing any user-facing UI, read `design/DESIGN.md` and `design/tokens.tokens.json` and conform to them. The **mobile-first redesign landed** (Claude Design round-trip distilled into the contract 2026-06-19): the authority for mobile/responsive work is **`DESIGN.md` §8** + the tokens `mobile` and `color.light` groups; `design/BRIEF.md` is the input brief and `design/_imports/2026-06-19/` the provenance + per-surface interaction reference (the comps are Claude Design runtime prototypes — re-author each surface in the app's React idiom + real API, not drop-in; **the design source of truth is each `*.dc.html` at its DEFAULT `data-props` (compact/dark/plex/earmark — see `GridApp.dc.html` `data-props`), NOT the `screenshots/` PNGs, which are option-history (rejected/stale combos: INVESTOR/PROSPECT disposition badges, 6-stage MEETING/FUNDED funnel, star flag). Don't anchor on the screenshots** (cost a re-scope 2026-06-19; general learning in `standards/guides/design.md` Phase C)). A **light theme is built (P6)**: it lives in `:root[data-theme="light"]` (set by a pre-paint boot script from `localStorage.venture_crm_theme`; dark is the default), with an app-wide toggle in the desktop sidebar footer + the mobile top bar. **Colors are theme vars now — any new UI color MUST use a `:root` var (grow the set if needed), never a literal, or it won't flip in light** (chips/badges flip via `.stage-chip--{stage}`/`.due-chip--{overdue,today,week,later}` + the `--chip-*`/`--note-*`/`--badge-priority-*`/`--rem-*`/`--due-{overdue,today,week,later}-*`/`--money`/`--recency-*`/`--due-soon` slots; authoritative dark+light pairs are in the Claude Design export `design/_imports/2026-06-19_zip-file/` `store.js` + `*App.dc.html`). Mobile light is complete; desktop has known unthemed shades (Phase 7). (Note: inline `style={{}}` objects can't respond to media queries; responsive layout belongs in the CSS `<style>` block. The **mobile foundation primitives are built** — CSS: `.bottom-tab-bar`, the `.bottom-sheet` primitive, `.mobile-only`/`.desktop-only`, `:root` mobile vars; React (Phase 2): **`<BottomSheet>`** (scrim/Escape/drag-to-dismiss) + **`useIsMobile()`** (768px) + the **`MobileDetailRow`**/`.fs-detail` full-screen-detail + `.contact-card`/`.az-header` list patterns — **build new mobile surfaces on these** (P3 Grid reuses them directly; swap surfaces via a rules-of-hooks-safe `useIsMobile()` wrapper that mounts a `Mobile*`/`Desktop*` pair, never a per-component hook toggle). The inline-style→CSS migration is **scoped, per-surface** (~114 styles across 4 surfaces+shell, not ~1,300), folded into each surface's build; see `ROADMAP.md`.) **Phase 8 card/detail primitives (reuse these, don't reinvent):** `EarmarkCorner` (existing-LP corner triangle; `inline` variant for the org card), the `priority-pill`/`lp-pill` text pills, `StageChip` (+ `sm`), `NoteTimeline`, `LogCommunicationSheet`, **`SortPill`/`SortSheet`** (mono pill + label+hint option sheet, 8d — drive with a per-surface `{id,pill,label,hint}` table, e.g. `GRID_SORTS`/`PIPELINE_SORTS`/`SORT_OPTIONS`), **`MobileQuickLog`** (shell top-bar quick-log pencil), **`DueChip`** (8e — urgency-bucketed reminder due pill, `.due-chip--{bucket}` colors); `<BottomSheet>` takes a **`stacked`** prop to layer a sheet opened over another sheet (e.g. the Log sheet over a detail, or the 8e investor-picker over the add sheet). **Mobile reminder writes link a real investor via `source_row_id` → server-resolved `investor_id`** (the 8e add-flow picker; create POSTs `source_row_id`, never a free-text name — the old label never linked); **`PATCH /api/reminders` can't reassign the investor** (edit shows it read-only). The mobile **Contacts + Pipeline detail surfaces are drag-dismiss bottom sheets** (8b) that log via **`POST /api/communications`**; the **Grid detail stays full-screen** (its dc default) and reads its **notes timeline** via **`GET /api/communications?source_row_id=<grid row id>`** (investor-level: maps grid row → `fundraising_investors.source_row_id` → `fundraising_contacts.contact_id` → comms, soft-delete-respecting). **The Contacts read path injects derived read-only `committed` + `pipeline_stage` + `priority`** (`contact_grid_signals()` — existing-LP ring + stage pill + Priority sort) on **both** `GET /api/contacts` and `/api/contacts/{id}`; this needs no strip-point (the directory is read-only, never written back as a row) — unlike the grid's injected columns. **The opportunities list (`GET /api/opportunities`) likewise injects derived read-only `existing_investor`** (same `contact_grid_signals` committed>0 → the **8f** Pipeline-card earmark, agreeing with the detail "Existing LP" pill) **+ `last_contact_date`** (`MAX(communication_date)` on the deal's contact, `deleted_at`-filtered → card recency + Staleness sort); no strip-point (opp writes use a field allowlist, never a blob PUT). **Phase 8f Pipeline-card primitives (reuse, don't reinvent):** the card reuses `EarmarkCorner`/`priority-pill`/`StageChip`/recency; new patterns are the **horizontal-scroll segmented stage control** (`.pipeline-seg-tab--{stage}` whose `.active` tint comes from `--seg-{bg,text,border}` aliased to that stage's `--chip-*` vars) + label-with-count-badge, the **labeled `‹ Prev`·`Next ›` card move footer**, and **tappable page-dots** (active = 22px accent bar).
+- **Design:** before building or changing any user-facing UI, read `design/DESIGN.md` and `design/tokens.tokens.json` and conform to them. The **mobile-first redesign landed** (Claude Design round-trip distilled into the contract 2026-06-19): the authority for mobile/responsive work is **`DESIGN.md` §8** + the tokens `mobile` and `color.light` groups; `design/BRIEF.md` is the input brief and `design/_imports/2026-06-19/` the provenance + per-surface interaction reference (the comps are Claude Design runtime prototypes — re-author each surface in the app's React idiom + real API, not drop-in; **the design source of truth is each `*.dc.html` at its DEFAULT `data-props` (compact/dark/plex/earmark — see `GridApp.dc.html` `data-props`), NOT the `screenshots/` PNGs, which are option-history (rejected/stale combos: INVESTOR/PROSPECT disposition badges, 6-stage MEETING/FUNDED funnel, star flag). Don't anchor on the screenshots** (cost a re-scope 2026-06-19; general learning in `standards/guides/design.md` Phase C)). A **light theme is built (P6)**: it lives in `:root[data-theme="light"]` (set by a pre-paint boot script from `localStorage.venture_crm_theme`; dark is the default), with an app-wide toggle in the desktop sidebar footer + the mobile top bar. **Colors are theme vars now — any new UI color MUST use a `:root` var (grow the set if needed), never a literal, or it won't flip in light** (chips/badges flip via `.stage-chip--{stage}`/`.due-chip--{overdue,today,week,later}` + the `--chip-*`/`--note-*`/`--badge-priority-*`/`--rem-*`/`--due-{overdue,today,week,later}-*`/`--money`/`--recency-*`/`--due-soon` slots; authoritative dark+light pairs are in the Claude Design export `design/_imports/2026-06-19_zip-file/` `store.js` + `*App.dc.html`). Mobile light is complete; desktop has known unthemed shades (Phase 7). (Note: inline `style={{}}` objects can't respond to media queries; responsive layout belongs in the CSS `<style>` block. The **mobile foundation primitives are built** — CSS: `.bottom-tab-bar`, the `.bottom-sheet` primitive, `.mobile-only`/`.desktop-only`, `:root` mobile vars; React (Phase 2): **`<BottomSheet>`** (scrim/Escape/drag-to-dismiss) + **`useIsMobile()`** (768px) + the **`MobileDetailRow`**/`.fs-detail` full-screen-detail + `.contact-card`/`.az-header` list patterns — **build new mobile surfaces on these** (P3 Grid reuses them directly; swap surfaces via a rules-of-hooks-safe `useIsMobile()` wrapper that mounts a `Mobile*`/`Desktop*` pair, never a per-component hook toggle). The inline-style→CSS migration is **scoped, per-surface** (~114 styles across 4 surfaces+shell, not ~1,300), folded into each surface's build; see `ROADMAP.md`.) **Phase 8 card/detail primitives (reuse these, don't reinvent):** `EarmarkCorner` (existing-LP corner triangle; `inline` variant for the org card), the `priority-pill`/`lp-pill` text pills, `StageChip` (+ `sm`), `NoteTimeline`, `LogCommunicationSheet`, **`SortPill`/`SortSheet`** (mono pill + label+hint option sheet, 8d — drive with a per-surface `{id,pill,label,hint}` table, e.g. `GRID_SORTS`/`PIPELINE_SORTS`/`SORT_OPTIONS`), **`MobileQuickLog`** (shell top-bar quick-log pencil), **`DueChip`** (8e — urgency-bucketed reminder due pill, `.due-chip--{bucket}` colors); `<BottomSheet>` takes a **`stacked`** prop to layer a sheet opened over another sheet (e.g. the Log sheet over a detail, or the 8e investor-picker over the add sheet). **Mobile reminder writes link a real investor via `source_row_id` → server-resolved `investor_id`** (the 8e add-flow picker; create POSTs `source_row_id`, never a free-text name — the old label never linked); **`PATCH /api/reminders` can't reassign the investor** (edit shows it read-only). The mobile **Contacts + Pipeline detail surfaces are drag-dismiss bottom sheets** (8b) that log via **`POST /api/communications`**; the **Grid detail stays full-screen** (its dc default) and reads its **notes timeline** via **`GET /api/communications?source_row_id=<grid row id>`** (investor-level: maps grid row → `fundraising_investors.source_row_id` → `fundraising_contacts.contact_id` → comms, soft-delete-respecting). **The Contacts read path injects derived read-only `committed` + `pipeline_stage` + `priority`** (`contact_grid_signals()` — existing-LP ring + stage pill + Priority sort) on **both** `GET /api/contacts` and `/api/contacts/{id}`; this needs no strip-point (the directory is read-only, never written back as a row) — unlike the grid's injected columns. **The opportunities list (`GET /api/opportunities`) likewise injects derived read-only `existing_investor`** (same `contact_grid_signals` committed>0 → the **8f** Pipeline-card earmark, agreeing with the detail "Existing LP" pill) **+ `last_contact_date`** (`MAX(communication_date)` on the deal's contact, `deleted_at`-filtered → card recency + Staleness sort); no strip-point (opp writes use a field allowlist, never a blob PUT). **Phase 8f Pipeline-card primitives (reuse, don't reinvent):** the card reuses `EarmarkCorner`/`priority-pill`/`StageChip`/recency; new patterns are the **horizontal-scroll segmented stage control** (`.pipeline-seg-tab--{stage}` whose `.active` tint comes from `--seg-{bg,text,border}` aliased to that stage's `--chip-*` vars) + label-with-count-badge, the **labeled `‹ Prev`·`Next ›` card move footer**, and **tappable page-dots** (active = 22px accent bar). **Phase 8g add-investor primitives:** the mobile "New investor" sheet gained an optional **`.stage-pick`** chip picker (a "Not in pipeline" button + the 4 `StageChip`s; default off — Grant) and a framed **`.sheet-toggle-opt`** Priority toggle, plus an optional reminder (title + progressive due-date). Submit (`submitCreate`) orchestrates one-row calls in order — create (`log-communication`, which now honors an optional `priority` **only on its create-if-missing branch**) → optional pipeline link at the picked stage → optional `POST /api/reminders` keyed on the new row's `source_row_id`; the link/reminder steps are non-fatal.
 - **Commit style:** imperative subject, concise body explaining the *why*; put the package version in the subject (`… (v0.1.0:NN)`) for shippable changes. **No AI co-author / attribution trailers** — commits are authored by the user.
 
 ## Always
@@ -107,12 +107,13 @@ Subsystem rules live in `docs/guides/` and lazy-load in Claude Code via `.claude
 
 ## Current state
 
-_**Box live at v0.1.0:94**; `main` ahead by mobile Phases 0–7 + P3b + drag-reorder + **8a–8f** — **all deploy-pending** (no s9pk built). **The fundraising grid + email capture is the canonical system of record.** Active thread: **mobile-first redesign → Phase 8**, building to `design/phase8-conformance.md` (the 8a–8i spec, anchored on each `*.dc.html` DEFAULT `data-props` — NOT the `screenshots/` PNGs). **Plan (Grant, 2026-06-19): finish features first → then Grant device-tests + deploys** (nothing verified on a real phone). History: git log + `start9/0.4/startos/versions/`._
+_**Box live at v0.1.0:94**; `main` ahead by mobile Phases 0–7 + P3b + drag-reorder + **8a–8g** — **all deploy-pending** (no s9pk built). **The fundraising grid + email capture is the canonical system of record.** Active thread: **mobile-first redesign → Phase 8**, building to `design/phase8-conformance.md` (the 8a–8i spec, anchored on each `*.dc.html` DEFAULT `data-props` — NOT the `screenshots/` PNGs). **Plan (Grant, 2026-06-19): finish features first → then Grant device-tests + deploys** (nothing verified on a real phone). History: git log + `start9/0.4/startos/versions/`._
 
 - **Mobile redesign — 4 core surfaces built (Grid · Contacts · Pipeline · Reminders), each a rules-of-hooks-safe `useIsMobile()` → `Mobile*`/`Desktop*` pair (desktop untouched).** Foundation: bottom-tab bar + `:root` mobile vars; 4-stage enum; derived grid signals injected-on-GET/stripped-on-write at both points; mobile writes use **one-row endpoints only** (log-communication, pipeline link/stage, reminders, `update-row`) — never whole-grid PUT.
 - **Phase 8 done so far (8a–8f):** cards re-authored (existing-LP **earmark**/avatar **ring**, PRIORITY/Existing-LP pills, 4-stage chip, recency; disposition badges dropped); **Contacts + Pipeline detail → drag-dismiss bottom sheets** (email-copy pill, Log/Email, Org card, stat tiles, inline move-stage, notes timeline); **Grid-detail notes timeline** + shared `LogCommunicationSheet`; **top-bar quick-log pencil** (`MobileQuickLog`, all tabs); **sort controls** on Grid/Pipeline/Contacts (shared `SortPill`/`SortSheet`; Contacts type-tabs dropped + Priority sort); **8e Reminders re-bucketed** — Active/Done/All tabs dropped → title + urgency **summary line** + gradient add; **4 buckets** Overdue/Today/This-week/Later each with a colored **dot**; urgency-colored **`DueChip`** pill (`--due-*` theme vars) replaces plain due text; collapsible **Completed** section (done+cancelled, strikethrough, tap-check reopens); card now note + org + due-chip (assignee dropped from card, still in edit sheet); **swipe-right → snooze preset sheet** (+1/+3/+7/+14d, dc-style) replacing the old fixed +7d; **add-flow investor picker** — a stacked searchable sheet over the canonical grid investors that writes **`source_row_id` → a real server-resolved `investor_id` link** (replaces the old free-text label that never actually linked; "team task" = no investor). Per-phase detail in git log + the Design convention's primitives list.
 - **8f Pipeline card → dc anatomy:** segmented control is now **horizontal-scroll pills** (label + count badge; the active pill tints to its own stage color via `--seg-*`); cards re-authored to **earmark corner + name + Priority pill / `$amount · dot · recency` / labeled `‹ Prev`·`Next ›` move footer** (was name + contact·org sub + bare ‹/›); stage-column header is **StageChip + investor count + committed sum**; **page dots tappable** (active = 22px accent bar). Backend: the **opportunities list injects derived read-only `existing_investor`** (via `contact_grid_signals` committed>0 — agrees with the detail's "Existing LP" pill) **+ `last_contact_date`** (`MAX(communication_date)` on the deal's contact, soft-delete-filtered — drives the card recency + the Staleness sort). No strip-point needed (opp writes use a field allowlist, never a blob PUT). Card amount stays `expected_amount` (the deal forecast); earmark is the orthogonal existing-LP flag.
+- **8g add-investor stage + priority (+ reminder):** the mobile "New investor" sheet now also captures an **optional initial pipeline stage** (a `.stage-pick` chip picker — **defaults to "Not in pipeline"**, Grant's call: no surprise opportunity rows), a **"Flag as Priority"** toggle, and an **optional reminder** (title + progressive due-date). On submit `submitCreate` orchestrates one-row calls in sequence: create (`log-communication` `create_investor_if_missing`, now carrying `priority`) → **if a stage was picked**, link at that stage (reusing `applyStage`'s idempotent link-then-PATCH) → **if a reminder title was given**, `POST /api/reminders` with the new row's `source_row_id`. The link/reminder steps are non-fatal (a failure toasts but never loses the created investor). Backend: `handle_log_fundraising_communication` honors an optional `priority` **only on the create branch** (existing-row logs never touch priority). Guarded by `test_grid_add_investor.py` (priority-on-create + defaults-False + the create→link and create→reminder handshakes on a freshly-synced row).
 - **Live (deployed):** W2 NL query (v94); W1 reminders (v93); grid Pipeline (v88); Matrix intake + Gmail capture (DWD) + daily digest; Thesis/Architect (dual-approval); outreach — all draft-only.
-- **Tests:** **39/39 backend green** (`python3 backend/run_tests.py`; +`test_grid_comm_timeline.py` for the 8c timeline filter, +priority assertions in `test_contacts_grid_signals.py`; +8f opportunities-list `last_contact_date`/`existing_investor` soft-delete assertions in `test_soft_delete_reads.py`), `py_compile` clean; 8c+8d+8e+8f surfaces interaction-verified via throwaway 375px jsdom harnesses (deleted after — 8f mounted `MobilePipeline` against the **vendored** React/Babel + mocked `api`, asserting the full card/segment/header/dots anatomy). 8f added a read-path injection (covered by the new soft-delete assertions) so the count stays 39/39.
-- **Next — Phase 8, in order, build to `design/phase8-conformance.md`:** **8g** add-investor stage+priority → **8h** loose ends (incl. Grid detail G4/G5/G6 stage-card/reminder-card/timeline; "Open-in-Grid" deep-link-to-investor) → **8i** shell SVG icons + `·Ten31·` wordmark. **Skip Pipeline accordion** (Grant). **Then (after feature-complete):** deploy P0–P8 + P3b in one s9pk (**authorize + version-bump first**) and device-test light/dark on a phone.
+- **Tests:** **40/40 backend green** (`python3 backend/run_tests.py`; +`test_grid_comm_timeline.py` for the 8c timeline filter, +priority assertions in `test_contacts_grid_signals.py`; +8f opportunities-list `last_contact_date`/`existing_investor` soft-delete assertions in `test_soft_delete_reads.py`; +`test_grid_add_investor.py` for the 8g create flow), `py_compile` clean; 8c–8g surfaces interaction-verified via throwaway 375px jsdom harnesses (deleted after — 8f mounted `MobilePipeline` and 8g `MobileFundraisingGrid` against the **vendored** React/Babel + mocked `api`; 8g drove the create sheet end-to-end and asserted the create→link→reminder POST payloads). **jsdom note:** legacy `ReactDOM.render` doesn't fire `onChange` for synthetic input events — drive controlled inputs with `react-dom/test-utils` `Simulate.change`, not the prototype value-setter trick.
+- **Next — Phase 8, in order, build to `design/phase8-conformance.md`:** **8h** loose ends (incl. Grid detail G4/G5/G6 stage-card/reminder-card/timeline; "Open-in-Grid" deep-link-to-investor) → **8i** shell SVG icons + `·Ten31·` wordmark. **Skip Pipeline accordion** (Grant). **Then (after feature-complete):** deploy P0–P8 + P3b in one s9pk (**authorize + version-bump first**) and device-test light/dark on a phone.
 - **Open / risks:** all mobile work + light theme **built but never deployed or device-tested** (smoke/jsdom only); `MobileDetailRow` now unused-but-retained (legacy-usage sweep); Pipeline detail "Committed" tile shows grid-committed not deal-expected (deal forecast in a footnote); W2 happy-path only; **Claude/Architect path unverified live on the box**; v2.0 reserve-asset spine **not canonical**; doc drift — `crm-overview.md`/`EVALUATION.md` still call `lp_profiles` live.
diff --git a/backend/server.py b/backend/server.py
index c77ba2f..9fa3ae3 100644
--- a/backend/server.py
+++ b/backend/server.py
@@ -3341,6 +3341,9 @@ class CRMHandler(BaseHTTPRequestHandler):
         contact_in = body.get('contact')
         append_note = bool(body.get('append_note', True))
         create_investor_if_missing = bool(body.get('create_investor_if_missing', False))
+        # Optional initial Priority flag for the mobile add-investor sheet (8g). Honored ONLY on the
+        # create branch below — an existing-row log-communication never touches its priority.
+        create_priority = bool(body.get('priority', False))
         # Provenance: where this logged communication originated (grid UI vs the Matrix
         # intake bot). Default preserves prior behavior; callers may override.
         comm_source = (str(body.get('source') or 'fundraising_grid').strip() or 'fundraising_grid')[:64]
@@ -3391,7 +3394,7 @@ class CRMHandler(BaseHTTPRequestHandler):
                 "notes_last_modified": "",
                 "last_communication_date": "",
                 "lead": "",
-                "priority": False,
+                "priority": create_priority,
                 "follow_up": False,
                 "graveyard": False
             }
diff --git a/backend/test_grid_add_investor.py b/backend/test_grid_add_investor.py
new file mode 100644
index 0000000..83183f0
--- /dev/null
+++ b/backend/test_grid_add_investor.py
@@ -0,0 +1,180 @@
+#!/usr/bin/env python3
+"""Tests for the mobile add-investor flow (Phase 8g).
+
+Boots the REAL server against a temp DB and exercises the create path the mobile
+"New investor" sheet drives:
+  - POST /api/fundraising/log-communication with create_investor_if_missing honors an
+    optional initial `priority` flag on the NEW row (and defaults it to False when omitted);
+  - the brand-new row's source_row_id resolves immediately for the follow-on
+    POST /api/fundraising/pipeline/link (the relational sync runs inside the create), so the
+    create -> link-at-stage handshake the UI does works end to end;
+  - a follow-on POST /api/reminders with the new row's source_row_id resolves to the synced
+    investor (the create -> reminder handshake).
+Synthetic data only.
+
+Run: cd backend && python3 test_grid_add_investor.py
+"""
+import http.client
+import json
+import os
+import sqlite3
+import sys
+import tempfile
+import threading
+from http.server import ThreadingHTTPServer
+
+_DATA = tempfile.mkdtemp()
+os.environ["CRM_DATA_DIR"] = _DATA
+os.environ["CRM_DB_PATH"] = os.path.join(_DATA, "crm.db")
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+import server  # noqa: E402
+
+FAILS = []
+
+
+def check(cond, msg):
+    print(("  PASS " if cond else "  FAIL ") + msg)
+    if not cond:
+        FAILS.append(msg)
+
+
+class _Quiet(server.CRMHandler):
+    def log_message(self, *a):
+        pass
+
+
+def _req(port, method, path, token=None, body=None):
+    conn = http.client.HTTPConnection("127.0.0.1", port, timeout=10)
+    headers = {}
+    if token:
+        headers["Authorization"] = "Bearer " + token
+    payload = None
+    if body is not None:
+        payload = json.dumps(body)
+        headers["Content-Type"] = "application/json"
+    conn.request(method, path, body=payload, headers=headers)
+    resp = conn.getresponse()
+    raw = resp.read().decode("utf-8", "replace")
+    conn.close()
+    data = None
+    if raw:
+        try:
+            data = json.loads(raw)
+        except ValueError:
+            pass
+    return resp.status, data
+
+
+def _db():
+    return sqlite3.connect(os.environ["CRM_DB_PATH"])
+
+
+def seed():
+    c = _db()
+    c.execute("INSERT INTO users (id,username,email,password_hash,full_name,role,is_active) "
+              "VALUES ('u1','grant','grant@ten31.example','x','Grant','admin',1)")
+    c.commit()
+    c.close()
+
+
+def _create(port, token, name, contact_name, **extra):
+    body = {
+        "investor_name": name, "create_investor_if_missing": True,
+        "contact": {"name": contact_name, "email": contact_name.split(" ")[0].lower() + "@firm.com"},
+        "type": "note", "body": extra.pop("note", ""), "append_note": bool(extra.pop("note_append", False)),
+    }
+    body.update(extra)
+    return _req(port, "POST", "/api/fundraising/log-communication", token, body)
+
+
+def _grid_rows(port, token):
+    st, d = _req(port, "GET", "/api/fundraising/state", token)
+    return {r["id"]: r for r in (d or {}).get("data", {}).get("grid", {}).get("rows", [])}
+
+
+def main():
+    server.init_db()
+    seed()
+    token = server.create_token("u1", "grant", "admin")
+
+    httpd = ThreadingHTTPServer(("127.0.0.1", 0), _Quiet)
+    port = httpd.server_address[1]
+    threading.Thread(target=httpd.serve_forever, daemon=True).start()
+    try:
+        # ── create with priority:true seeds the row's Priority flag ──
+        print("\n[create: optional initial priority flag honored]")
+        st, d = _create(port, token, "Acme Capital", "Jane Doe", priority=True, note="Intro call", note_append=True)
+        row = (d or {}).get("data", {}).get("row") or {}
+        acme_id = row.get("id")
+        check(st == 201, f"create -> 201 (got {st})")
+        check(row.get("priority") is True, f"returned row carries priority=true (got {row.get('priority')!r})")
+        rows = _grid_rows(port, token)
+        check(rows.get(acme_id, {}).get("priority") is True,
+              f"GET /state shows the new row priority=true (got {rows.get(acme_id, {}).get('priority')!r})")
+        check(len(rows.get(acme_id, {}).get("contacts", [])) == 1,
+              f"new row has its first contact (got {rows.get(acme_id, {}).get('contacts')})")
+
+        # ── create without priority defaults to False (no accidental flag) ──
+        print("\n[create: priority defaults False when omitted]")
+        st, d = _create(port, token, "Beta Partners", "Pat Roe")  # no note, no priority
+        beta = (d or {}).get("data", {}).get("row") or {}
+        beta_id = beta.get("id")
+        check(st == 201, f"no-note create -> 201 (got {st})")
+        check(beta.get("priority") is False, f"omitted priority -> False (got {beta.get('priority')!r})")
+
+        # ── priority is honored ONLY on the create branch: logging against an EXISTING row
+        #    with priority:true must not flip its flag (Beta was created without priority) ──
+        print("\n[invariant: priority on an existing-row log does NOT change its flag]")
+        st, _ = _req(port, "POST", "/api/fundraising/log-communication", token, {
+            "row_id": beta_id, "type": "note", "body": "follow-up", "append_note": True, "priority": True,
+        })
+        check(st in (200, 201), f"log against existing Beta -> ok (got {st})")
+        rows = _grid_rows(port, token)
+        check(rows.get(beta_id, {}).get("priority") is False,
+              f"existing-row priority untouched by the log's priority flag (got {rows.get(beta_id, {}).get('priority')!r})")
+
+        # ── create -> link handshake: the brand-new row links at the chosen stage ──
+        print("\n[create -> link: freshly-created row resolves for pipeline link at stage]")
+        st, d = _req(port, "POST", "/api/fundraising/pipeline/link", token, {
+            "source_row_id": acme_id, "contact_index": 0, "name": "Acme Capital — Pipeline",
+            "stage": "engaged", "expected_amount": 0, "probability": 55, "fund_name": "",
+        })
+        opp = (d or {}).get("data") or {}
+        check(st == 201 and opp.get("stage") == "engaged",
+              f"link new row @engaged -> 201 (got {st}, stage={opp.get('stage')})")
+        rows = _grid_rows(port, token)
+        check(rows.get(acme_id, {}).get("pipeline") is True
+              and rows.get(acme_id, {}).get("pipeline_stage") == "engaged",
+              f"new row now in pipeline @engaged (got {rows.get(acme_id, {}).get('pipeline')}, "
+              f"{rows.get(acme_id, {}).get('pipeline_stage')})")
+
+        # ── create -> reminder handshake: source_row_id resolves to the synced investor ──
+        print("\n[create -> reminder: source_row_id resolves to the new investor]")
+        st, d = _req(port, "POST", "/api/reminders", token, {
+            "source_row_id": acme_id, "investor_name": "Acme Capital",
+            "title": "Send Fund III deck", "due_date": "2026-07-01", "details": "",
+        })
+        rem = (d or {}).get("data") or {}
+        check(st == 201, f"reminder create -> 201 (got {st})")
+        check(bool(rem.get("investor_id")) and rem.get("investor_name") == "Acme Capital",
+              f"reminder linked to the new investor (got id={rem.get('investor_id')!r}, "
+              f"name={rem.get('investor_name')!r})")
+
+        # ── unknown source_row_id is refused (guard) ──
+        print("\n[guard: reminder on an unknown source_row_id -> 404]")
+        st, _ = _req(port, "POST", "/api/reminders", token, {
+            "source_row_id": "nope", "title": "x",
+        })
+        check(st == 404, f"unknown source_row_id -> 404 (got {st})")
+    finally:
+        httpd.shutdown()
+
+    print("\n" + ("ALL PASS" if not FAILS else f"{len(FAILS)} FAILURE(S):"))
+    for f in FAILS:
+        print("  - " + f)
+    sys.exit(1 if FAILS else 0)
+
+
+if __name__ == "__main__":
+    main()
diff --git a/frontend/index.html b/frontend/index.html
index 50dc990..8cf9d46 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -2567,6 +2567,26 @@
         .dedup-box-title { font-size: 12px; color: var(--due-soon, #e0b341); margin-bottom: 4px; }
         .dedup-match { font-size: 13px; color: var(--text-secondary); padding: 3px 0; }
 
+        /* 8g add-investor: optional initial-stage chip picker + framed Priority toggle (dc GridApp:737).
+           Stage tint comes from <StageChip>; the framed button just carries the selection ring. */
+        .stage-pick { display: flex; flex-wrap: wrap; gap: 8px; }
+        .stage-pick-btn {
+            flex: 0 0 auto; min-height: var(--mobile-touch-target); padding: 6px 12px;
+            display: inline-flex; align-items: center; justify-content: center;
+            background: var(--bg-input); border: 1px solid var(--border); border-radius: var(--mobile-control-radius);
+            color: var(--text-secondary); font-size: 13px; font-family: inherit; cursor: pointer;
+        }
+        /* StageChip carries its own fill, so lean on a clear accent ring (not just bg) for the selected state. */
+        .stage-pick-btn.active { border-color: var(--accent); background: var(--accent-soft); box-shadow: 0 0 0 1px var(--accent); }
+        .sheet-toggle-opt {
+            width: 100%; min-height: var(--mobile-touch-target); gap: 12px; padding: 0 14px;
+            display: flex; align-items: center; justify-content: space-between;
+            background: var(--bg-input); border: 1px solid var(--border); border-radius: var(--mobile-control-radius);
+            color: var(--text-primary); font-size: 14px; font-family: inherit; cursor: pointer;
+        }
+        .sheet-toggle-opt.on { border-color: var(--accent); background: var(--accent-soft); color: var(--accent-light); }
+        .sheet-toggle-opt .check { flex: none; width: 16px; text-align: center; color: var(--accent); font-size: 15px; }
+
         /* P3b — mobile contact-pill editor (the 'edit' sheet: investor name + add/edit/remove pills). */
         .fs-detail-edit { margin-left: auto; background: transparent; border: none; color: var(--accent); font-size: 15px; font-family: inherit; cursor: pointer; padding: 6px 0 6px 8px; }
         .pill-edit { background: var(--bg-input); border: 1px solid var(--border); border-radius: var(--mobile-control-radius); padding: 10px 12px; margin-bottom: 10px; }
@@ -10059,7 +10079,7 @@
             const [sheet, setSheet] = useState(null); // 'view' | 'create' | 'note' | 'stage' | 'reminder' | 'sort'
             const [sortKey, setSortKey] = useState('name'); // GRID_SORTS
             const [busy, setBusy] = useState(false);
-            const [createForm, setCreateForm] = useState({ name: '', contactName: '', contactEmail: '', note: '' });
+            const [createForm, setCreateForm] = useState({ name: '', contactName: '', contactEmail: '', note: '', priority: false, stage: '', reminderTitle: '', reminderDue: '' });
             const [reminderForm, setReminderForm] = useState({ title: '', due_date: '', details: '' });
             // G6 — investor-level communications timeline for the open detail. Fetched on open
             // (source_row_id → canonical contacts → communications); commsReload re-runs it after a log.
@@ -10235,15 +10255,50 @@
                 try {
                     // The one-row create path: log-communication finds-or-creates the investor + first
                     // contact (no whole-grid PUT). append_note only if a first note was given (else the
-                    // create just seeds name + contact).
+                    // create just seeds name + contact). priority is honored on the create branch (8g).
                     const hasNote = !!String(createForm.note || '').trim();
-                    await api('/api/fundraising/log-communication', { method: 'POST', body: JSON.stringify({
+                    const resp = await api('/api/fundraising/log-communication', { method: 'POST', body: JSON.stringify({
                         investor_name: name, create_investor_if_missing: true,
                         contact: { name: cName, email: createForm.contactEmail.trim() },
                         type: 'note', body: createForm.note || '', append_note: hasNote,
+                        priority: !!createForm.priority,
                     }) }, token);
-                    onShowToast('Investor added', 'success');
-                    setCreateForm({ name: '', contactName: '', contactEmail: '', note: '' });
+                    const newRowId = resp && resp.data && resp.data.row && resp.data.row.id;
+
+                    // Optional: drop the brand-new investor into the pipeline at the chosen stage (8g).
+                    // Reuses the link-then-enforce flow applyStage uses (link is idempotent + may keep an
+                    // existing stage, so a follow-up PATCH pins the picked stage). The relational sync ran
+                    // inside the create above, so source_row_id already resolves for the link. Non-fatal:
+                    // a link failure must not lose the just-created investor.
+                    if (newRowId && createForm.stage) {
+                        try {
+                            const linkResp = await api('/api/fundraising/pipeline/link', { method: 'POST', body: JSON.stringify({
+                                source_row_id: newRowId, contact_index: 0, name: `${name} — Pipeline`,
+                                stage: createForm.stage, expected_amount: 0, probability: createForm.priority ? 55 : 35, fund_name: '',
+                            }) }, token);
+                            const opp = linkResp && linkResp.data;
+                            if (opp && opp.id && opp.stage !== createForm.stage) {
+                                await api(`/api/opportunities/${opp.id}/stage`, { method: 'PATCH', body: JSON.stringify({ stage: createForm.stage }) }, token);
+                            }
+                        } catch (_) { onShowToast('Investor added — but adding it to the pipeline failed', 'error'); }
+                    }
+
+                    // Optional: set a follow-up reminder linked to the new investor row (8g, Grant).
+                    if (newRowId && createForm.reminderTitle.trim()) {
+                        try {
+                            await api('/api/reminders', { method: 'POST', body: JSON.stringify({
+                                source_row_id: newRowId, investor_name: name,
+                                title: createForm.reminderTitle.trim(), due_date: createForm.reminderDue || '', details: '',
+                            }) }, token);
+                        } catch (_) { onShowToast('Investor added — but setting the reminder failed', 'error'); }
+                    }
+
+                    // The create itself succeeded; if its response carried no row id we couldn't run the
+                    // optional stage/reminder steps — say so rather than a clean success the user would trust.
+                    const incomplete = !newRowId && (!!createForm.stage || !!createForm.reminderTitle.trim());
+                    onShowToast(incomplete ? 'Investor added — reopen it to set the stage / reminder' : 'Investor added',
+                        incomplete ? 'error' : 'success');
+                    setCreateForm({ name: '', contactName: '', contactEmail: '', note: '', priority: false, stage: '', reminderTitle: '', reminderDue: '' });
                     closeSheet();
                     await reload(true);
                 } catch (err) { onShowToast(getErrorMessage(err, 'Failed to add investor'), 'error'); }
@@ -10326,7 +10381,7 @@
                                 <span className="vp-name">{activeViewName}</span>
                                 <span className="vp-caret">▾</span>
                             </button>
-                            <button className="grid-new-btn" onClick={() => { setCreateForm({ name: '', contactName: '', contactEmail: '', note: '' }); setSheet('create'); }}>+ New</button>
+                            <button className="grid-new-btn" onClick={() => { setCreateForm({ name: '', contactName: '', contactEmail: '', note: '', priority: false, stage: '', reminderTitle: '', reminderDue: '' }); setSheet('create'); }}>+ New</button>
                         </div>
                         <input className="mobile-search" type="text" placeholder="Search investors…" value={search} onChange={(e) => setSearch(e.target.value)} />
                         <div className="mobile-sortbar">
@@ -10380,6 +10435,35 @@
                             <label className="sheet-field-label">First note (optional)</label>
                             <textarea className="sheet-textarea" value={createForm.note} onChange={(e) => setCreateForm((f) => ({ ...f, note: e.target.value }))} placeholder="How you met, context…" />
                         </div>
+                        <div className="sheet-field">
+                            <label className="sheet-field-label">Initial pipeline stage (optional)</label>
+                            <div className="stage-pick">
+                                <button type="button" className={`stage-pick-btn ${createForm.stage === '' ? 'active' : ''}`} onClick={() => setCreateForm((f) => ({ ...f, stage: '' }))}>Not in pipeline</button>
+                                {PIPELINE_STAGES.map((st) => (
+                                    <button type="button" key={st} className={`stage-pick-btn ${createForm.stage === st ? 'active' : ''}`} onClick={() => setCreateForm((f) => ({ ...f, stage: st }))}>
+                                        <StageChip stage={st} />
+                                    </button>
+                                ))}
+                            </div>
+                        </div>
+                        <div className="sheet-field">
+                            <label className="sheet-field-label">Disposition</label>
+                            <button type="button" className={`sheet-toggle-opt ${createForm.priority ? 'on' : ''}`} aria-pressed={createForm.priority ? 'true' : 'false'}
+                                onClick={() => setCreateForm((f) => ({ ...f, priority: !f.priority }))}>
+                                <span>Flag as Priority</span>
+                                <span className="check">{createForm.priority ? '✓' : ''}</span>
+                            </button>
+                        </div>
+                        <div className="sheet-field">
+                            <label className="sheet-field-label">Reminder (optional)</label>
+                            <input className="sheet-input" value={createForm.reminderTitle} onChange={(e) => setCreateForm((f) => ({ ...f, reminderTitle: e.target.value }))} placeholder="e.g. Send Fund III deck" />
+                        </div>
+                        {createForm.reminderTitle.trim() && (
+                            <div className="sheet-field">
+                                <label className="sheet-field-label">Reminder due date</label>
+                                <input className="sheet-input" type="date" value={createForm.reminderDue} onChange={(e) => setCreateForm((f) => ({ ...f, reminderDue: e.target.value }))} />
+                            </div>
+                        )}
                         <button className="sheet-submit" onClick={submitCreate} disabled={busy}>{busy ? 'Adding…' : 'Add investor'}</button>
                     </BottomSheet>