@indexnetwork/protocol 18.0.0-rc.481.1 → 20.0.0-rc.483.1

package/CHANGELOG.md

@@ -20,6 +20,60 @@ went 6.7.1 → 8.0.2 with no 7.x in between because the whole 7.x line shipped a
 prereleases between the two promotions. To track every change, read `rc`; to
 pin a supported release, use `latest`.
 
+## 20.0.0 - 2026-08-17
+
+### Changed
+
+- **BREAKING**: The communities capability ships as one class, `Networks`,
+  mirroring `Intents`. `NetworkGraphFactory`, `NetworkMembershipGraphFactory`
+  and `IntentNetworkGraphFactory` are no longer exported from the package root;
+  construct `new Networks({ database, indexer })` and call `createGraph()`,
+  `createMembershipGraph()` or `createAssignmentGraph()`. `createNetworkTools`
+  is now `Networks.createTools`. Graph behaviour is unchanged.
+
+  ```typescript
+  // before
+  const indexGraph = new NetworkGraphFactory(database).createGraph();
+  const membershipGraph = new NetworkMembershipGraphFactory(database).createGraph();
+  const assignmentGraph = new IntentNetworkGraphFactory(database, intents).createGraph();
+
+  // after
+  const networks = new Networks({ database, indexer: intents });
+  const indexGraph = networks.createGraph();
+  const membershipGraph = networks.createMembershipGraph();
+  const assignmentGraph = networks.createAssignmentGraph();
+  ```
+
+- `networks/` is flat: the `application/`, `domain/` and `ports/` directories are
+  gone, and `network.module.ts` is the capability's only public surface.
+  `NetworkToolDeps` now comes from that module rather than
+  `networks/ports/communities.tools.port.ts`, and the narrowed indexer port is
+  exported as `IntentNetworkIndexer`.
+
+## 19.0.0 - 2026-08-17
+
+### Removed
+
+- **BREAKING**: Retire ghost users. `softDeleteGhost`, `mergeGhostUser` and
+  `findDuplicateUser` are gone from the database port, along with `isGhost` on
+  every entity, contact payload, member row and opportunity card.
+- **BREAKING**: Remove `shouldEnrichGhostDisplayNameFromParallel` and
+  `isEnrichedNameMeaningful` (and the `enrichment.enricher` module). Both were
+  ghost-only: the first returned `false` for every real account.
+- **BREAKING**: `buildMinimalOpportunityCard` loses its trailing
+  `isCounterpartGhost` parameter and the `isGhost` field on its result. The
+  primary action label was never derived from it — it reads `viewerRole` alone —
+  so labels are unchanged.
+
+### Changed
+
+- The enrichment graph no longer soft-deletes or merges on the ghost paths. A
+  non-human enrichment result still aborts with `"Non-human entity detected"`;
+  it previously also called `softDeleteGhost`, which the host implemented as a
+  no-op for any non-ghost, so behaviour for real accounts is identical.
+- Low-confidence and failed enrichment now always fall through to basic info.
+  That was already the real-account path; only the ghost early-return is gone.
+
 ## 18.0.0 - 2026-08-17
 
 ### Changed

package/IMPLEMENTATION.md

@@ -148,9 +148,6 @@ import {
   PremiseGraphFactory,
   NegotiationGraphFactory,
   HydeGraphFactory,
-  NetworkGraphFactory,
-  NetworkMembershipGraphFactory,
-  IntentNetworkGraphFactory,
   RadarGraphFactory,
   MaintenanceGraphFactory,
 } from "@indexnetwork/protocol";
@@ -159,8 +156,9 @@ import {
 Each factory takes its typed dependencies in the constructor and exposes a
 `.createGraph()` method that returns a compiled LangGraph ready for `.invoke()`.
 
-The intent lifecycle graph is the exception: it is reached through the `Intents`
-module rather than a factory of its own (see [Intents](#intents) below).
+The intent and community graphs are the exceptions: they are reached through the
+`Intents` and `Networks` module classes rather than factories of their own (see
+[Intents](#intents) and [Networks](#networks) below).
 
 | Factory | Workflow |
 |---|---|
@@ -170,9 +168,6 @@ module rather than a factory of its own (see [Intents](#intents) below).
 | `PremiseGraphFactory` | Decompose and index a user's premises |
 | `NegotiationGraphFactory` | Multi-turn bilateral negotiation flows |
 | `HydeGraphFactory` | Generate hypothetical documents and embed them (cache-aware) |
-| `NetworkGraphFactory` | Manage network/network CRUD |
-| `NetworkMembershipGraphFactory` | Manage network/network member join/leave |
-| `IntentNetworkGraphFactory` | Evaluate and assign/unassign intents to indexes |
 | `RadarGraphFactory` | Build the radar view: flat presenter-card list, optionally intent-scoped |
 | `MaintenanceGraphFactory` | Periodic maintenance (feed health, opportunity expiration) |
 
@@ -213,12 +208,34 @@ first use, so an unused method costs nothing.
 | `Intents.normalizeDescription(description)` | Normalize a description to its persisted form |
 | `Intents.FALLBACK_INTAKE_QUESTION` | The static round-1 question used when generation is unavailable |
 
-`IntentNetworkGraphFactory` takes an `Intents` instance as its evaluator:
+## Networks
+
+Communities ship the same way: one class covering the community lifecycle graph,
+the membership graph, signal↔community assignment, and the agent-facing
+community tools.
 
 ```typescript
-const intentNetworkGraph = new IntentNetworkGraphFactory(database, intents).createGraph();
+import { Networks } from "@indexnetwork/protocol";
+
+const networks = new Networks({
+  database,          // community, roster, and assignment persistence
+  indexer: intents,  // an `Intents` instance — scores a signal against a community
+});
 ```
 
+Both dependencies are optional; each method names what it requires, so a host
+that only registers tools can construct `new Networks()` with nothing.
+
+| Method | Purpose |
+|---|---|
+| `createGraph()` | Compile the community lifecycle graph — create, read, update, delete. Requires `database` |
+| `createMembershipGraph()` | Compile the roster graph — add, list, remove members. Requires `database` |
+| `createAssignmentGraph()` | Compile signal↔community assignment, direct or model-evaluated. Requires `database` and `indexer` |
+| `Networks.createTools(defineTool, deps)` | Register the agent-facing community tools |
+
+Assignment takes an `Intents` instance as its evaluator — the `indexer`
+dependency is narrowed to the single `indexIntent` method it calls.
+
 ## MCP server
 
 The package exports a factory that registers every chat tool over the Model Context Protocol and attaches a canonical `instructions` block (`MCP_INSTRUCTIONS`) that every connecting runtime follows. The factory takes three arguments:

package/dist/contacts/application/contact.tools.js

@@ -43,7 +43,6 @@ export function createContactTools(defineTool, deps) {
                         name: c.user.name,
                         email: c.user.email,
                         avatar: c.user.avatar,
-                        isGhost: c.user.isGhost,
                     })),
                 });
             }
@@ -81,7 +80,7 @@ export function createContactTools(defineTool, deps) {
             "Use when the user refers to a contact by partial name or email and you need their userId for another tool " +
             "(e.g. read_user_contexts).\n\n" +
             "**When to use:** Before list_contacts when the network is large — returns only matching contacts, bounded by limit.\n\n" +
-            "**Returns:** Array of matching contacts: userId, name, email, avatar, isGhost.",
+            "**Returns:** Array of matching contacts: userId, name, email, avatar.",
         querySchema: z.object({
             query: z.string().trim().min(1).describe('Free-text query matched against contact name and email (case-insensitive, substring).'),
             limit: z.number().int().positive().max(100).optional().describe('Maximum rows to return. Defaults to 25.'),
@@ -96,7 +95,6 @@ export function createContactTools(defineTool, deps) {
                         name: r.name,
                         email: r.email,
                         avatar: r.avatar,
-                        isGhost: r.isGhost,
                     })),
                 });
             }

package/dist/contacts/domain/contact.types.d.ts

@@ -13,7 +13,6 @@ export interface ContactEntry {
         name: string;
         email: string;
         avatar: string | null;
-        isGhost: boolean;
     };
 }
 /** Flat contact row returned by searchContacts. */
@@ -22,5 +21,4 @@ export interface ContactSearchResult {
     name: string;
     email: string;
     avatar: string | null;
-    isGhost: boolean;
 }

package/dist/contexts/application/index.d.ts

@@ -59,7 +59,6 @@ export { PremiseAnalyzer, type PremiseAnalyzerOutput, } from "../../premises/pre
 export { PremiseIndexer, type PremiseIndexerOutput, } from "../../premises/premise.indexer.js";
 export { EnrichmentGraphFactory, type CompiledPremiseGraph, } from "../../enrichment/enrichment.graph.js";
 export { EnrichmentGenerator, type GeneratedProfile } from "../../enrichment/enrichment.generator.js";
-export { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful, } from "../../enrichment/enrichment.enricher.js";
 export { createEnrichmentTools } from "../../enrichment/enrichment.tools.js";
 export { createPremiseTools } from "../../premises/premise.tools.js";
 export { UserContextGenerator } from "../../contexts/context.generator.js";

package/dist/contexts/application/index.js

@@ -62,7 +62,6 @@ export { PremiseIndexer, } from "../../premises/premise.indexer.js";
 // ── Enrichment graph + service classes ───────────────────────────────────────
 export { EnrichmentGraphFactory, } from "../../enrichment/enrichment.graph.js";
 export { EnrichmentGenerator } from "../../enrichment/enrichment.generator.js";
-export { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful, } from "../../enrichment/enrichment.enricher.js";
 // ── Tool factories (foreground adapters) ──────────────────────────────────────
 // These are foreground adapter entry points consumed by the tool composition root (shared/agent)
 // composition.  They accept compiled graphs and host deps through the tool-dep

package/dist/enrichment/enrichment.graph.js

@@ -1,6 +1,5 @@
 import { StateGraph, START, END } from "@langchain/langgraph";
 import { EnrichmentGraphState } from "./enrichment.state.js";
-import { shouldEnrichGhostDisplayNameFromParallel, isEnrichedNameMeaningful } from "./enrichment.enricher.js";
 import { socialsToEnrichmentRequest } from "../shared/utils/social-label.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { timed } from "../shared/observability/performance.js";
@@ -376,8 +375,7 @@ export async function autoGenerateNode(state, deps) {
             try {
                 const enrichment = await deps.enricher.enrichUserProfile(request);
                 if (enrichment && !enrichment.isHuman) {
-                    logger.info("Enrichment detected non-human entity, soft-deleting ghost", { userId: state.userId });
-                    await deps.database.softDeleteGhost(state.userId);
+                    logger.info("Enrichment detected non-human entity, aborting", { userId: state.userId });
                     return { error: "Non-human entity detected" };
                 }
                 const hasMeaningfulEnrichment = !!enrichment &&
@@ -387,11 +385,6 @@ export async function autoGenerateNode(state, deps) {
                         enrichment.attributes.skills.length > 0 ||
                         enrichment.attributes.interests.length > 0);
                 if (hasMeaningfulEnrichment) {
-                    if (user.isGhost && !isEnrichedNameMeaningful(user.email || '', enrichment.identity.name || '')) {
-                        logger.info("Enrichment has content but no real name for ghost, soft-deleting", { userId: state.userId });
-                        await deps.database.softDeleteGhost(state.userId);
-                        return { error: "No real name found for ghost user" };
-                    }
                     logger.verbose("Chat API enrichment succeeded", {
                         userId: state.userId,
                         skillsCount: enrichment.attributes.skills.length,
@@ -399,11 +392,6 @@ export async function autoGenerateNode(state, deps) {
                     });
                     // Update user record with enriched data
                     const updatePayload = {};
-                    const enrichedName = enrichment.identity.name?.trim();
-                    if (enrichedName &&
-                        shouldEnrichGhostDisplayNameFromParallel({ isGhost: !!user.isGhost, name: user.name ?? '', email: user.email ?? '' }, enrichedName)) {
-                        updatePayload.name = enrichedName;
-                    }
                     if (enrichment.identity.bio?.trim())
                         updatePayload.intro = enrichment.identity.bio.trim();
                     if (enrichment.identity.location?.trim())
@@ -435,19 +423,6 @@ export async function autoGenerateNode(state, deps) {
                     if (Object.keys(updatePayload).length > 0) {
                         await deps.database.updateUser(state.userId, updatePayload);
                     }
-                    // Post-enrichment dedup: check if this ghost matches an existing user
-                    if (user.isGhost) {
-                        const currentSocials = await deps.database.getUserSocials(state.userId);
-                        const duplicate = await deps.database.findDuplicateUser(state.userId, currentSocials);
-                        if (duplicate) {
-                            logger.info("Post-enrichment dedup: merging ghost into existing user", {
-                                ghostId: state.userId,
-                                targetId: duplicate.id,
-                            });
-                            await deps.database.mergeGhostUser(state.userId, duplicate.id);
-                            return { error: `Merged as duplicate of user ${duplicate.id}` };
-                        }
-                    }
                     // Build a text blob from the enrichment result so it flows
                     // through premise decomposition (when available) rather than
                     // bypassing premises via prePopulatedProfile.
@@ -468,19 +443,9 @@ export async function autoGenerateNode(state, deps) {
                         operationsPerformed: { scraped: true },
                     };
                 }
-                if (user.isGhost) {
-                    logger.info("Low-confidence enrichment for ghost, soft-deleting", { userId: state.userId });
-                    await deps.database.softDeleteGhost(state.userId);
-                    return { error: "Enrichment not confident for ghost user" };
-                }
                 logger.warn("Chat API returned low-signal enrichment, falling back to basic info", { userId: state.userId });
             }
             catch (enrichErr) {
-                if (user.isGhost) {
-                    logger.info("Enrichment failed for ghost, soft-deleting", { userId: state.userId });
-                    await deps.database.softDeleteGhost(state.userId);
-                    return { error: "Enrichment failed for ghost user" };
-                }
                 logger.warn("Chat API enrichment failed, falling back to basic info", {
                     userId: state.userId,
                     error: enrichErr instanceof Error ? enrichErr.message : String(enrichErr),

package/dist/index.d.ts

@@ -39,9 +39,8 @@ export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, } fro
 export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, } from "./agents/index.js";
 export { RadarGraphFactory } from "./opportunities/index.js";
 export { HydeGraphFactory } from "./discovery/index.js";
-export { NetworkGraphFactory } from "./networks/index.js";
-export { NetworkMembershipGraphFactory } from "./networks/index.js";
-export { IntentNetworkGraphFactory } from "./networks/index.js";
+export { Networks } from "./networks/network.module.js";
+export type { IntentNetworkIndexer, NetworksDeps, NetworkToolDeps, } from "./networks/network.module.js";
 export { Intents } from "./intents/intent.module.js";
 export type { FollowUpPlan, FollowUpPlanInput, IntakeAnswer, IntakePack, IntakePackInput, IntakePackQuestion, IntakePackQuestionOption, IntakeRound, IntentIndexerOutput, IntentsDeps, IntentToolDeps, SynthesisInput, SynthesisResult, } from "./intents/intent.module.js";
 export { MaintenanceGraphFactory } from "./maintenance/maintenance.graph.js";

package/dist/index.js

@@ -35,9 +35,10 @@ export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, } fro
 export { ONBOARDING_PERSONA_ID, ONBOARDING_PERSONA, } from "./agents/index.js";
 export { RadarGraphFactory } from "./opportunities/index.js";
 export { HydeGraphFactory } from "./discovery/index.js";
-export { NetworkGraphFactory } from "./networks/index.js";
-export { NetworkMembershipGraphFactory } from "./networks/index.js";
-export { IntentNetworkGraphFactory } from "./networks/index.js";
+// ─── Networks ─────────────────────────────────────────────────────────────────
+// The whole capability behind one class: the community lifecycle graph, the
+// membership graph, signal assignment, and the agent-facing tools.
+export { Networks } from "./networks/network.module.js";
 // ─── Intents ──────────────────────────────────────────────────────────────────
 // The whole capability behind one class: lifecycle graph, verification,
 // network indexing, guided intake, and the agent-facing tools.

package/dist/networks/{application/indexer.graph.d.ts → indexer.graph.d.ts}

@@ -1,7 +1,14 @@
-import type { IntentNetworkGraphDatabase } from "../ports/index.js";
-import type { DebugMetaAgent } from "../../agents/index.js";
-import type { IntentNetworkIndexer } from "../ports/index.js";
+import type { IntentNetworkGraphDatabase } from "../shared/interfaces/database.interface.js";
+import type { DebugMetaAgent } from "../agents/index.js";
+import type { Intents } from "../intents/intent.module.js";
 import { IntentNetworkGraphState, type AssignmentResult } from "./indexer.state.js";
+/**
+ * The one intents method assignment calls: score a signal against a network.
+ *
+ * Naming the single method rather than accepting the whole capability keeps the
+ * injected surface auditable, and lets a test pass a one-method stub.
+ */
+export type IntentNetworkIndexer = Pick<Intents, "indexIntent">;
 /**
  * Factory class to build and compile the Intent–Network (indexer) Graph.
  *
@@ -12,7 +19,7 @@ import { IntentNetworkGraphState, type AssignmentResult } from "./indexer.state.
  *
  * ## Signal assignment policy
  *
- * The indexer is injected at construction time via the communities ports layer,
+ * The indexer is injected at construction time as {@link IntentNetworkIndexer},
  * which narrows the intents module to the one method used here — this factory
  * never reaches intents internals directly.
  *
@@ -40,9 +47,6 @@ import { IntentNetworkGraphState, type AssignmentResult } from "./indexer.state.
  *   read: readNode → END
  *   delete: unassignNode → END
  * }
- *
- * IND-546: canonical home — previously network/indexer/indexer.graph.ts.
- * Signals dependency consumed via capabilities/signals.facade.ts (through ports).
  */
 /** The graph's channel state, as every node sees it. */
 export type IntentNetworkState = typeof IntentNetworkGraphState.State;

package/dist/networks/{application/indexer.graph.js → indexer.graph.js}

@@ -1,9 +1,9 @@
 import { StateGraph, START, END } from "@langchain/langgraph";
-import { buildNetworkAssignmentDecision } from "../../shared/assignment/network-assignment.policy.js";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { timed } from "../../shared/observability/performance.js";
-import { requestContext } from "../../shared/observability/request-context.js";
-import { renderNetworkContext } from "../../shared/network/metadata.renderer.js";
+import { buildNetworkAssignmentDecision } from "../shared/assignment/network-assignment.policy.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { timed } from "../shared/observability/performance.js";
+import { requestContext } from "../shared/observability/request-context.js";
+import { renderNetworkContext } from "../shared/network/metadata.renderer.js";
 import { IntentNetworkGraphState } from "./indexer.state.js";
 const logger = protocolLogger("IntentNetworkGraphFactory");
 export class IntentNetworkGraphFactory {
@@ -141,7 +141,7 @@ export async function assignNode(state, deps) {
             const sourceName = intentForIndexing.sourceType
                 ? `${intentForIndexing.sourceType}:${intentForIndexing.sourceId ?? ""}`
                 : undefined;
-            // Score the signal against the network (intents module, injected via ports)
+            // Score the signal against the network (intents module, injected as IntentNetworkIndexer)
             const _traceEmitter = requestContext.getStore()?.traceEmitter;
             const _indexerStart = Date.now();
             _traceEmitter?.({ type: "agent_start", name: "intent-networker" });

package/dist/networks/{application/indexer.state.d.ts → indexer.state.d.ts}

@@ -1,9 +1,7 @@
-import type { DebugMetaAgent } from "../../agents/index.js";
+import type { DebugMetaAgent } from "../agents/index.js";
 /**
  * Intent payload and metadata loaded for network evaluation.
  * Loaded from the database before LLM-based assignment scoring.
- *
- * IND-546: canonical home — previously network/indexer/indexer.state.ts.
  */
 export interface IntentForIndexing {
     id: string;
@@ -15,8 +13,6 @@ export interface IntentForIndexing {
 /**
  * Index and member prompts for a single network (user must be member with autoAssign).
  * Used by the evaluated assignment path in IntentNetworkGraphFactory.
- *
- * IND-546: canonical home — previously network/indexer/indexer.state.ts.
  */
 export interface IndexMemberContext {
     networkId: string;
@@ -26,8 +22,6 @@ export interface IndexMemberContext {
 /**
  * Result of executing an assignment decision.
  * Returned from the assign node as a structured output alongside mutationResult.
- *
- * IND-546: canonical home — previously network/indexer/indexer.state.ts.
  */
 export interface AssignmentResult {
     networkId: string;
@@ -44,13 +38,13 @@ export interface AssignmentResult {
  * Two assignment paths, selected via `skipEvaluation`:
  * - `true` (direct / manual_override): writes the link immediately with a fixed
  *   score of 1 and mode `manual_override`.  No LLM call.
- * - `false` (automatic / evaluated): loads intent + network context, calls
- *   IntentIndexer from the signals public facade, then applies
- *   `buildNetworkAssignmentDecision` to produce the threshold / metadata.
- *   A no-prompt fast path skips the LLM when both prompts are absent.
+ * - `false` (automatic / evaluated): loads intent + network context, calls the
+ *   injected indexer, then applies `buildNetworkAssignmentDecision` to produce
+ *   the threshold / metadata. A no-prompt fast path skips the LLM when both
+ *   prompts are absent.
  *
- * The IntentIndexer is injected as a constructor argument — communities never
- * imports signals internals directly.
+ * The indexer is injected as a constructor argument — communities never imports
+ * signals internals directly.
  *
  * Flow:
  * START → router → {
@@ -58,10 +52,6 @@ export interface AssignmentResult {
  *   read: readNode → END
  *   delete: unassignNode → END
  * }
- *
- * IND-546: canonical home — previously network/indexer/indexer.state.ts.
- * LangGraph state carries IntentIndexerOutput and DebugMetaAgent which are
- * cross-capability types; this file therefore belongs in the application layer.
  */
 export declare const IntentNetworkGraphState: import("@langchain/langgraph").AnnotationRoot<{
     /** User performing the action. Always required. */

package/dist/networks/{application/indexer.state.js → indexer.state.js}

@@ -8,13 +8,13 @@ import { Annotation } from "@langchain/langgraph";
  * Two assignment paths, selected via `skipEvaluation`:
  * - `true` (direct / manual_override): writes the link immediately with a fixed
  *   score of 1 and mode `manual_override`.  No LLM call.
- * - `false` (automatic / evaluated): loads intent + network context, calls
- *   IntentIndexer from the signals public facade, then applies
- *   `buildNetworkAssignmentDecision` to produce the threshold / metadata.
- *   A no-prompt fast path skips the LLM when both prompts are absent.
+ * - `false` (automatic / evaluated): loads intent + network context, calls the
+ *   injected indexer, then applies `buildNetworkAssignmentDecision` to produce
+ *   the threshold / metadata. A no-prompt fast path skips the LLM when both
+ *   prompts are absent.
  *
- * The IntentIndexer is injected as a constructor argument — communities never
- * imports signals internals directly.
+ * The indexer is injected as a constructor argument — communities never imports
+ * signals internals directly.
  *
  * Flow:
  * START → router → {
@@ -22,10 +22,6 @@ import { Annotation } from "@langchain/langgraph";
  *   read: readNode → END
  *   delete: unassignNode → END
  * }
- *
- * IND-546: canonical home — previously network/indexer/indexer.state.ts.
- * LangGraph state carries IntentIndexerOutput and DebugMetaAgent which are
- * cross-capability types; this file therefore belongs in the application layer.
  */
 export const IntentNetworkGraphState = Annotation.Root({
     // --- Core Inputs (from ChatGraph via ToolContext) ---

package/dist/networks/{application/membership.graph.d.ts → membership.graph.d.ts}

@@ -1,5 +1,5 @@
-import type { NetworkMembershipGraphDatabase } from "../ports/index.js";
-import { NetworkMembershipGraphState } from "../domain/index.js";
+import type { NetworkMembershipGraphDatabase } from "../shared/interfaces/database.interface.js";
+import { NetworkMembershipGraphState } from "./membership.state.js";
 /**
  * Factory class to build and compile the Network Membership Graph.
  *
@@ -26,8 +26,6 @@ import { NetworkMembershipGraphState } from "../domain/index.js";
  *
  * Flow:
  * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
- *
- * IND-546: canonical home — previously network/membership/membership.graph.ts.
  */
 /** The graph's channel state, as every node sees it. */
 export type NetworkMembershipState = typeof NetworkMembershipGraphState.State;

package/dist/networks/{application/membership.graph.js → membership.graph.js}

@@ -1,7 +1,7 @@
 import { StateGraph, START, END } from "@langchain/langgraph";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { timed } from "../../shared/observability/performance.js";
-import { NetworkMembershipGraphState } from "../domain/index.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { timed } from "../shared/observability/performance.js";
+import { NetworkMembershipGraphState } from "./membership.state.js";
 const logger = protocolLogger("NetworkMembershipGraphFactory");
 export class NetworkMembershipGraphFactory {
     constructor(database) {

package/dist/networks/{domain/membership.state.d.ts → membership.state.d.ts}

@@ -13,8 +13,6 @@
  *
  * Flow:
  * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
- *
- * IND-546: canonical home — previously network/membership/membership.state.ts.
  */
 export declare const NetworkMembershipGraphState: import("@langchain/langgraph").AnnotationRoot<{
     /** User performing the action (the actor). Always required. */

package/dist/networks/{domain/membership.state.js → membership.state.js}

@@ -14,8 +14,6 @@ import { Annotation } from "@langchain/langgraph";
  *
  * Flow:
  * START → routerNode → {addMemberNode | listMembersNode | removeMemberNode} → END
- *
- * IND-546: canonical home — previously network/membership/membership.state.ts.
  */
 export const NetworkMembershipGraphState = Annotation.Root({
     // --- Core Inputs (from ChatGraph via ToolContext) ---

package/dist/networks/{application/network.graph.d.ts → network.graph.d.ts}

@@ -1,5 +1,5 @@
-import type { NetworkGraphDatabase } from "../ports/index.js";
-import { NetworkGraphState } from "../domain/index.js";
+import type { NetworkGraphDatabase } from "../shared/interfaces/database.interface.js";
+import { NetworkGraphState } from "./network.state.js";
 /**
  * Factory class to build and compile the Network (community) lifecycle graph.
  *
@@ -25,8 +25,6 @@ import { NetworkGraphState } from "../domain/index.js";
  *
  * Flow:
  * START → routerNode → {createNode | readNode | updateNode | deleteNode} → END
- *
- * IND-546: canonical home — previously network/network.graph.ts.
  */
 /** The graph's channel state, as every node sees it. */
 export type NetworkState = typeof NetworkGraphState.State;

package/dist/networks/{application/network.graph.js → network.graph.js}

@@ -1,7 +1,7 @@
 import { StateGraph, START, END } from "@langchain/langgraph";
-import { protocolLogger } from "../../shared/observability/protocol.logger.js";
-import { timed } from "../../shared/observability/performance.js";
-import { NetworkGraphState } from "../domain/index.js";
+import { protocolLogger } from "../shared/observability/protocol.logger.js";
+import { timed } from "../shared/observability/performance.js";
+import { NetworkGraphState } from "./network.state.js";
 const logger = protocolLogger("NetworkGraphFactory");
 export class NetworkGraphFactory {
     constructor(database) {