refactor: remove the contact-import and ghost-user creation paths

Contacts are established solely by accepting an opportunity, which already
writes the mutual `contact` memberships in both users' personal networks
(OpportunityService → upsertContactMembership, on accept and start-chat).
Every other way of creating a contact — and the ghost users it minted — is
removed. Read/search/remove of existing contacts is unchanged.

This is the code half. Deleting the 14 ghost users still in production, and
dropping `users.is_ghost` plus the remaining `isGhost` plumbing, follow as
separate changes; nothing here can create a new ghost.

- protocol: the whole `integrations` capability (`src/integrations/`), its
  five public types and the `import_gmail_contacts` tool.
- protocol: `import_contacts` and `add_contact`; `ContactServiceAdapter`
  narrows to list/remove/search.
- protocol: `generateInviteMessage` — it required `recipient.isGhost`, so it
  can never fire once ghosts are gone. Its endpoint
  (`GET /opportunities/:id/invite-message`) and web caller go with it; the
  other three invite-message call sites use local templates and are untouched.
- protocol: `contactsEnabled`, `integration` and `integrationImporter` from
  `ToolDeps`; `createGhostUser` from the database interface.
- api: `POST /users/contacts`, `POST /integrations/:toolkit/import`,
  `ContactService.addContact/resolveUsers/importContacts`, both
  `createGhostUser*` adapters, the Gmail/Slack contact fetchers,
  `contacts-feature.ts`, `contacts.guard.ts`, `lib/dedup/`,
  `types/integrations.types.ts`.
- The `CONTACTS_ENABLED` and `CONTACT_DEDUP_STRATEGY` flags: with the write
  paths gone they gated nothing. Remove from `startup.env.ts` and
  `.env.example` (both still set in Railway — delete there after deploy).
- cli: `index contact add` and `index contact import --gmail`, plus the now
  unused `--name` and `--gmail` flags.
- web: the add-contact path in AccessTab (add-by-email now only offered for
  invitable networks), `usersService.addContact`, the Gmail/Slack import in
  IntegrationsTab, and the ghost branch in `useOpportunityActions`.

- `contactService.removeContact` and `DELETE /users/contacts/:contactId` stay.
  The hard delete doubles as the reverse opt-out that OpportunityService
  honours via `restore: false`; routing personal-network removal through
  `networkService.removeMember` would drop that and silently re-add people.
- Retired tool names are kept in the MCP forbidden-name lists as regression
  guards.

- protocol: build clean, `architecture:check` clean, `test:isolated`
  2202 pass / 0 fail, full suite at parity with the pre-change baseline
  (96 pre-existing failures, all database-gated; no new failures).
- api: typecheck and lint clean; CI's hermetic gates green (83 pinning +
  33 CLI guard specs). The database-backed suite is unchanged and still gated.
- cli: 351 pass / 0 fail, build and lint clean.
- web: build and lint clean.
- `check:lockfile-versions` clean.

Author: yanekyuk

npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli-darwin-arm64",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Platform-specific binary for @indexnetwork/cli (macOS arm64)",
   "license": "MIT",
   "os": [

npm/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli-darwin-x64",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Platform-specific binary for @indexnetwork/cli (macOS x64)",
   "license": "MIT",
   "os": [

npm/linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli-linux-arm64",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Platform-specific binary for @indexnetwork/cli (Linux arm64)",
   "license": "MIT",
   "os": [

npm/linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli-linux-x64",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Platform-specific binary for @indexnetwork/cli (Linux x64)",
   "license": "MIT",
   "os": [

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Command-line interface for Index Network",
   "license": "MIT",
   "type": "module",
@@ -20,10 +20,10 @@
     "publish:all": "bun scripts/publish.ts"
   },
   "optionalDependencies": {
-    "@indexnetwork/cli-linux-x64": "0.15.0",
-    "@indexnetwork/cli-linux-arm64": "0.15.0",
-    "@indexnetwork/cli-darwin-x64": "0.15.0",
-    "@indexnetwork/cli-darwin-arm64": "0.15.0"
+    "@indexnetwork/cli-linux-x64": "0.16.0",
+    "@indexnetwork/cli-linux-arm64": "0.16.0",
+    "@indexnetwork/cli-darwin-x64": "0.16.0",
+    "@indexnetwork/cli-darwin-arm64": "0.16.0"
   },
   "devDependencies": {
     "@types/bun": "1.3.14"

src/args.parser.ts

@@ -36,10 +36,6 @@ export interface ParsedCommand {
   prompt?: string;
   /** Output raw JSON instead of formatted text. */
   json?: boolean;
-  /** Name for --name flag (e.g. contact add). */
-  name?: string;
-  /** Gmail import flag for contact import. */
-  gmail?: boolean;
   /** Objective for --objective flag (e.g. scrape). */
   objective?: string;
   /** LinkedIn URL for profile create. */
@@ -158,12 +154,6 @@ export function parseArgs(args: string[]): ParsedCommand {
     } else if (arg === "--json") {
       result.json = true;
       i++;
-    } else if (arg === "--name") {
-      result.name = args[i + 1];
-      i += 2;
-    } else if (arg === "--gmail") {
-      result.gmail = true;
-      i++;
     } else if (arg === "--objective") {
       result.objective = args[i + 1];
       i += 2;

src/contact.command.ts

@@ -1,31 +1,29 @@
 /**
  * Contact command handlers for the Index CLI.
- * Implements: list, add, remove, import subcommands.
+ * Implements: list and remove subcommands.
  */
 import type { ApiClient } from "./api.client";
 import * as output from "./output";
 
 const CONTACT_HELP = `
 Usage:
-  index contact list                       List your contacts
-  index contact add <email> [--name <n>]   Add a contact by email
-  index contact remove <email>             Remove a contact
-  index contact import --gmail             Import contacts from Gmail
+  index contact list             List your contacts
+  index contact remove <email>   Remove a contact
 `;
 
 /**
  * Route a contact subcommand to the appropriate handler.
  *
  * @param client - Authenticated API client.
- * @param subcommand - The subcommand (list, add, remove, import).
+ * @param subcommand - The subcommand (list, remove).
  * @param positionals - Positional arguments after the subcommand.
- * @param options - Additional options (json, name, gmail).
+ * @param options - Additional options (json).
  */
 export async function handleContact(
   client: ApiClient,
   subcommand: string | undefined,
   positionals: string[],
-  options: { json?: boolean; name?: string; gmail?: boolean },
+  options: { json?: boolean },
 ): Promise<void> {
   if (!subcommand) {
     if (options.json) {
@@ -48,16 +46,6 @@ export async function handleContact(
       console.log();
       return;
     }
-    case "add": {
-      const email = positionals[0];
-      if (!email) { output.error("Missing email. Usage: index contact add <email>", 1); return; }
-      const result = await client.callTool("add_contact", { email, name: options.name });
-      if (options.json) { console.log(JSON.stringify(result)); return; }
-      if (!result.success) { output.error(result.error ?? "Failed to add contact", 1); return; }
-      const data = result.data as { message: string };
-      output.success(data.message);
-      return;
-    }
     case "remove": {
       const email = positionals[0];
       if (!email) { output.error("Missing email. Usage: index contact remove <email>", 1); return; }
@@ -73,18 +61,6 @@ export async function handleContact(
       output.success(`Removed ${email} from contacts.`);
       return;
     }
-    case "import": {
-      if (options.gmail) {
-        const result = await client.callTool("import_gmail_contacts", {});
-        if (options.json) { console.log(JSON.stringify(result)); return; }
-        if (!result.success) { output.error(result.error ?? "Failed to import Gmail contacts", 1); return; }
-        const data = result.data as { message: string };
-        output.success(data.message);
-      } else {
-        output.error("Specify import source: --gmail", 1);
-      }
-      return;
-    }
     default: {
       if (options.json) {
         console.log(JSON.stringify({ error: `Unknown subcommand: ${subcommand}` }));

src/main.ts

@@ -123,8 +123,6 @@ function renderHelp(): void {
     "--limit <n>",
     "--since <date>",
     "--json",
-    "--name <name>",
-    "--gmail",
     "--objective <text>",
     "--linkedin <url>",
     "--github <url>",
@@ -173,7 +171,7 @@ function renderHelp(): void {
     helpRowCmd(cmdLW, "conversation", "list · with · show · send · stream"),
     helpRowCmd(cmdLW, "network", "list · create · show · update · delete"),
     helpRowCont(cmdLW, "join · leave · invite"),
-    helpRowCmd(cmdLW, "contact", "list · add · remove · import"),
+    helpRowCmd(cmdLW, "contact", "list · remove"),
     "",
     helpRowCmd(cmdLW, "scrape", "extract content from a URL"),
     helpRowCmd(cmdLW, "sync", "download your context locally"),
@@ -188,8 +186,6 @@ function renderHelp(): void {
     helpRowDim(optLW, "--limit <n>", "limit number of results"),
     helpRowDim(optLW, "--since <date>", "filter by ISO date or duration"),
     helpRowDim(optLW, "--json", "output raw JSON"),
-    helpRowDim(optLW, "--name <name>", "name for contact add"),
-    helpRowDim(optLW, "--gmail", "import contacts from Gmail"),
     helpRowDim(optLW, "--objective <text>", "objective for scrape command"),
     helpRowDim(optLW, "--linkedin <url>", "LinkedIn URL for profile create"),
     helpRowDim(optLW, "--github <url>", "GitHub URL for profile create"),
@@ -391,8 +387,6 @@ async function main(): Promise<void> {
     case "contact":
       await handleContact(client, args.subcommand, args.positionals ?? [], {
         json: args.json,
-        name: args.name,
-        gmail: args.gmail,
       });
       return;
     case "scrape":

src/output/base.ts

@@ -123,10 +123,7 @@ const TOOL_DESCRIPTIONS: Record<string, string> = {
   update_opportunity: "Updating opportunity status...",
   scrape_url: "Reading content from URL...",
   read_docs: "Looking up documentation...",
-  import_gmail_contacts: "Importing Gmail contacts...",
-  import_contacts: "Importing contacts...",
   list_contacts: "Listing your contacts...",
-  add_contact: "Adding contact...",
   remove_contact: "Removing contact...",
 };
 

tests/args.parser.spec.ts

@@ -92,34 +92,12 @@ describe("parseArgs", () => {
       expect(result.subcommand).toBe("list");
     });
 
-    it("parses contact add with email", () => {
-      const result = parseArgs(["contact", "add", "foo@bar.com"]);
-      expect(result.command).toBe("contact");
-      expect(result.subcommand).toBe("add");
-      expect(result.positionals).toEqual(["foo@bar.com"]);
-    });
-
-    it("parses contact add with --name", () => {
-      const result = parseArgs(["contact", "add", "foo@bar.com", "--name", "John"]);
-      expect(result.command).toBe("contact");
-      expect(result.subcommand).toBe("add");
-      expect(result.positionals).toEqual(["foo@bar.com"]);
-      expect(result.name).toBe("John");
-    });
-
     it("parses contact remove", () => {
       const result = parseArgs(["contact", "remove", "foo@bar.com"]);
       expect(result.command).toBe("contact");
       expect(result.subcommand).toBe("remove");
       expect(result.positionals).toEqual(["foo@bar.com"]);
     });
-
-    it("parses contact import --gmail", () => {
-      const result = parseArgs(["contact", "import", "--gmail"]);
-      expect(result.command).toBe("contact");
-      expect(result.subcommand).toBe("import");
-      expect(result.gmail).toBe(true);
-    });
   });
 
   // ── Intent commands ────────────────────────────────────────────────