refactor!: name the community a network everywhere, not an index

The domain rename to networks left the noun "index" in the agent-facing MCP
tools, the host interfaces, and a long tail of identifiers and copy, so agents,
hosts and readers had to speak both vocabularies. This renames them in place,
with no aliases or compatibility shims.

BREAKING CHANGE: the intent<->network MCP tools are renamed
(create_intent_index -> add_intent_to_network, read_intent_indexes ->
list_intent_networks, delete_intent_index -> remove_intent_from_network), the
protocol ports a host implements drop "Index" from every member, opportunity
payloads carry `network` instead of `index`, and `index intent link`/`unlink`
become `index intent add-to-network`/`remove-from-network`.

Author: serefyarar

README.md

@@ -70,8 +70,8 @@ index intent show <id>                      # Show full signal details
 index intent create "Looking for a CTO"     # Create from natural language
 index intent update <id> "revised text"     # Update a signal (runs full pipeline)
 index intent archive <id>                   # Archive a signal
-index intent link <id> <network-id>         # Link a signal to a network
-index intent unlink <id> <network-id>       # Unlink a signal from a network
+index intent add-to-network <id> <network-id>      # Add a signal to a network
+index intent remove-from-network <id> <network-id> # Remove a signal from a network
 ```
 
 ### `index negotiation`

cli-output-reference.html

@@ -538,7 +538,7 @@ <h1>I N D E X  CLI</h1>
   <span class="bold">Updated</span>       <span class="c-gray">3/29/2026, 9:30:00 AM</span>
   <span class="bold">Archived</span>      <span class="c-gray">3/30/2026, 12:00:00 PM</span>
 
-  <span class="bold">Index Assignments</span>
+  <span class="bold">Networks</span>
   <span class="c-cyan">*</span> AI Research Collaborations<span class="c-gray"> (0.92)</span>
   <span class="c-cyan">*</span> Crypto & Identity<span class="c-gray"> (0.78)</span>
   <span class="c-gray">──────────────────────────────────────────────────</span></div>
@@ -562,13 +562,13 @@ <h1>I N D E X  CLI</h1>
     </div>
 
     <div class="terminal">
-      <div class="terminal-bar"><div class="dots"><span class="dot dot-r"></span><span class="dot dot-y"></span><span class="dot dot-g"></span></div><span class="cmd">$ index intent link &lt;id&gt; &lt;network-id&gt;</span></div>
-      <div class="terminal-body"><span class="c-green bold">+</span> Signal linked to network.</div>
+      <div class="terminal-bar"><div class="dots"><span class="dot dot-r"></span><span class="dot dot-y"></span><span class="dot dot-g"></span></div><span class="cmd">$ index intent add-to-network &lt;id&gt; &lt;network-id&gt;</span></div>
+      <div class="terminal-body"><span class="c-green bold">+</span> Signal added to network.</div>
     </div>
 
     <div class="terminal">
-      <div class="terminal-bar"><div class="dots"><span class="dot dot-r"></span><span class="dot dot-y"></span><span class="dot dot-g"></span></div><span class="cmd">$ index intent unlink &lt;id&gt; &lt;network-id&gt;</span></div>
-      <div class="terminal-body"><span class="c-green bold">+</span> Signal unlinked from network.</div>
+      <div class="terminal-bar"><div class="dots"><span class="dot dot-r"></span><span class="dot dot-y"></span><span class="dot dot-g"></span></div><span class="cmd">$ index intent remove-from-network &lt;id&gt; &lt;network-id&gt;</span></div>
+      <div class="terminal-body"><span class="c-green bold">+</span> Signal removed from network.</div>
     </div>
 
     <div class="terminal full-width">
@@ -1098,8 +1098,8 @@ <h1>I N D E X  CLI</h1>
 <span class="c-green bold">+</span> Signal created.
 <span class="c-green bold">+</span> Signal updated.
 <span class="c-green bold">+</span> Signal f47ac10b archived.
-<span class="c-green bold">+</span> Signal linked to network.
-<span class="c-green bold">+</span> Signal unlinked from network.
+<span class="c-green bold">+</span> Signal added to network.
+<span class="c-green bold">+</span> Signal removed from network.
 <span class="c-green bold">+</span> Opportunity accepted.
 <span class="c-green bold">+</span> Opportunity rejected.
 <span class="c-green bold">+</span> Message sent (e5f6a7b8-c9d0-1234-ef01-56789abcdef0)
@@ -1194,9 +1194,9 @@ <h1>I N D E X  CLI</h1>
 <span class="c-orange">&gt; Creating a new signal...</span>            <span class="dim">create_intent</span>
 <span class="c-orange">&gt; Updating signal...</span>                  <span class="dim">update_intent</span>
 <span class="c-orange">&gt; Removing signal...</span>                  <span class="dim">delete_intent</span>
-<span class="c-orange">&gt; Saving signal to index...</span>           <span class="dim">create_intent_index</span>
-<span class="c-orange">&gt; Fetching signals in index...</span>        <span class="dim">read_intent_indexes</span>
-<span class="c-orange">&gt; Removing signal from index...</span>       <span class="dim">delete_intent_index</span>
+<span class="c-orange">&gt; Adding signal to network...</span>        <span class="dim">add_intent_to_network</span>
+<span class="c-orange">&gt; Fetching signals in network...</span>      <span class="dim">list_intent_networks</span>
+<span class="c-orange">&gt; Removing signal from network...</span>     <span class="dim">remove_intent_from_network</span>
 <span class="c-orange">&gt; Checking your indexes...</span>            <span class="dim">read_indexes</span>
 <span class="c-orange">&gt; Creating a new index...</span>             <span class="dim">create_index</span>
 <span class="c-orange">&gt; Updating index...</span>                   <span class="dim">update_index</span>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Command-line interface for Index Network",
   "license": "MIT",
   "type": "module",

src/args.parser.ts

@@ -15,7 +15,7 @@ export interface ParsedCommand {
   /** The unrecognized command string (when command === "unknown"). */
   unknown?: string;
   /** Subcommand for multi-level commands (profile, intent, opportunity, network, conversation). */
-  subcommand?: "show" | "sync" | "list" | "create" | "archive" | "accept" | "reject" | "join" | "leave" | "invite" | "with" | "send" | "stream" | "help" | "update" | "delete" | "link" | "unlink" | "links" | "search" | "add" | "remove" | "import" | "complete";
+  subcommand?: "show" | "sync" | "list" | "create" | "archive" | "accept" | "reject" | "join" | "leave" | "invite" | "with" | "send" | "stream" | "help" | "update" | "delete" | "add-to-network" | "remove-from-network" | "search" | "add" | "remove" | "import" | "complete";
   /** Target user ID for `profile show <user-id>`. */
   userId?: string;
   /** Intent ID for show/archive subcommands. */
@@ -273,7 +273,7 @@ export function parseArgs(args: string[]): ParsedCommand {
   return result;
 }
 
-const INTENT_SUBCOMMANDS = new Set(["list", "show", "create", "archive", "update", "link", "unlink"]);
+const INTENT_SUBCOMMANDS = new Set(["list", "show", "create", "archive", "update", "add-to-network", "remove-from-network"]);
 
 /**
  * Parse intent-specific positional arguments into subcommand, ID, or content.
@@ -306,8 +306,8 @@ function parseIntentArgs(positionals: string[], result: ParsedCommand): void {
         result.intentContent = rest.slice(1).join(" ");
       }
       break;
-    case "link":
-    case "unlink":
+    case "add-to-network":
+    case "remove-from-network":
       result.intentId = rest[0];
       result.targetId = rest[1]; // networkId
       break;

src/intent.command.ts

@@ -16,8 +16,8 @@ Usage:
   index intent create <content>                 Create a signal from text
   index intent update <id> <content>            Update a signal's description
   index intent archive <id>                     Archive a signal (accepts short ID)
-  index intent link <id> <network-id>           Link a signal to a network
-  index intent unlink <id> <network-id>         Unlink a signal from a network
+  index intent add-to-network <id> <network-id>      Add a signal to a network
+  index intent remove-from-network <id> <network-id> Remove a signal from a network
 `;
 
 /**
@@ -129,37 +129,37 @@ export async function handleIntent(
       return;
     }
 
-    case "link": {
+    case "add-to-network": {
       if (!options.intentId || !options.targetId) {
-        output.error("Usage: index intent link <intent-id> <network-id>", 1);
+        output.error("Usage: index intent add-to-network <intent-id> <network-id>", 1);
         return;
       }
       // Resolve short ID to full UUID — the tool rejects non-UUID intent IDs.
       const intent = await client.getIntent(options.intentId);
-      const result = await client.callTool("create_intent_index", {
+      const result = await client.callTool("add_intent_to_network", {
         intentId: intent.id,
         networkId: options.targetId,
       });
       if (options.json) { console.log(JSON.stringify(result)); return; }
-      if (!result.success) { output.error(result.error ?? "Failed to link signal", 1); return; }
-      output.success("Signal linked to network.");
+      if (!result.success) { output.error(result.error ?? "Failed to add signal to network", 1); return; }
+      output.success("Signal added to network.");
       return;
     }
 
-    case "unlink": {
+    case "remove-from-network": {
       if (!options.intentId || !options.targetId) {
-        output.error("Usage: index intent unlink <intent-id> <network-id>", 1);
+        output.error("Usage: index intent remove-from-network <intent-id> <network-id>", 1);
         return;
       }
       // Resolve short ID to full UUID — the tool rejects non-UUID intent IDs.
       const intent = await client.getIntent(options.intentId);
-      const result = await client.callTool("delete_intent_index", {
+      const result = await client.callTool("remove_intent_from_network", {
         intentId: intent.id,
         networkId: options.targetId,
       });
       if (options.json) { console.log(JSON.stringify(result)); return; }
-      if (!result.success) { output.error(result.error ?? "Failed to unlink signal", 1); return; }
-      output.success("Signal unlinked from network.");
+      if (!result.success) { output.error(result.error ?? "Failed to remove signal from network", 1); return; }
+      output.success("Signal removed from network.");
       return;
     }
   }

src/main.ts

@@ -160,7 +160,7 @@ function renderHelp(): void {
     helpRowDim(cmdLW, "example", 'index intent create "looking for a CTO"'),
     "",
     helpRowCmd(cmdLW, "intent", "list · show · create · update · archive"),
-    helpRowCont(cmdLW, "link · unlink · links"),
+    helpRowCont(cmdLW, "add-to-network · remove-from-network"),
     helpRowCmd(cmdLW, "negotiation", "list · show"),
     "",
     helpRowCmd(cmdLW, "profile", "show · sync"),

src/output/base.ts

@@ -108,9 +108,9 @@ const TOOL_DESCRIPTIONS: Record<string, string> = {
   create_intent: "Creating a new signal...",
   update_intent: "Updating signal...",
   delete_intent: "Removing signal...",
-  create_intent_index: "Saving signal to index...",
-  read_intent_indexes: "Fetching signals in index...",
-  delete_intent_index: "Removing signal from index...",
+  add_intent_to_network: "Adding signal to network...",
+  list_intent_networks: "Fetching signals in network...",
+  remove_intent_from_network: "Removing signal from network...",
   read_networks: "Checking your communities...",
   create_network: "Creating a new community...",
   update_network: "Updating community...",

src/output/formatters.ts

@@ -179,10 +179,10 @@ export function intentCard(intent: Intent): void {
     console.log(`  ${BOLD}Archived${RESET}      ${GRAY}${new Date(intent.archivedAt).toLocaleString()}${RESET}`);
   }
 
-  if (intent.indexes && intent.indexes.length > 0) {
+  if (intent.networks && intent.networks.length > 0) {
     console.log();
-    console.log(`  ${BOLD}Index Assignments${RESET}`);
-    for (const idx of intent.indexes) {
+    console.log(`  ${BOLD}Networks${RESET}`);
+    for (const idx of intent.networks) {
       const score = idx.relevancyScore !== undefined ? ` (${idx.relevancyScore.toFixed(2)})` : "";
       console.log(`  ${CYAN}*${RESET} ${idx.title}${GRAY}${score}${RESET}`);
     }
@@ -278,7 +278,7 @@ export function opportunityCard(opp: OpportunityDetail): void {
   const st = opp.status ?? "unknown";
   cardLine(`${BOLD}Status:${RESET}  ${statusColor(st)}${st}${RESET}`);
   if (opp.category) cardLine(`${BOLD}Category:${RESET}  ${opp.category}`);
-  if (opp.index?.title) cardLine(`${BOLD}Network:${RESET}  ${opp.index.title}`);
+  if (opp.network?.title) cardLine(`${BOLD}Network:${RESET}  ${opp.network.title}`);
   if (opp.confidence != null) cardLine(`${BOLD}Confidence:${RESET}  ${confidenceBar(opp.confidence)}`);
   if (opp.myRole) cardLine(`${BOLD}Your role:${RESET}  ${roleLabel(opp.myRole)}`);
 

src/types.ts

@@ -52,7 +52,7 @@ export interface Intent {
   createdAt: string;
   updatedAt: string;
   archivedAt: string | null;
-  indexes?: Array<{ id: string; title: string; relevancyScore?: number }>;
+  networks?: Array<{ id: string; title: string; relevancyScore?: number }>;
 }
 
 /** Options for listing intents. */
@@ -146,7 +146,7 @@ export interface OpportunityDetail {
   otherParties?: OpportunityParty[];
   category?: string;
   confidence?: number;
-  index?: { id: string; title: string };
+  network?: { id: string; title: string };
   primaryActionLabel?: string;
   createdAt?: string;
   /** Present when the requested opportunity was superseded by this enriched opportunity. */
@@ -155,7 +155,7 @@ export interface OpportunityDetail {
 
 // ── Network types ───────────────────────────────────────────────────
 
-/** A network (index) as returned by the API. */
+/** A network as returned by the API. */
 export interface Network {
   id: string;
   key?: string | null;