architecture/network/remove

Raised when node removal targets a node that is not in the network.

architecture/network/remove/network.remove.errors.ts

NetworkRemoveNodeNotFoundError

Raised when node removal targets a node that is not in the network.

NetworkRemoveStructuralAnchorError

Raised when node removal targets an input or output anchor node.

architecture/network/remove/network.remove.utils.types.ts

ERROR_CANNOT_REMOVE_ANCHOR_NODE

Error emitted when a caller attempts to remove an input or output anchor node from the network topology.

ERROR_NODE_NOT_IN_NETWORK

Error emitted when the target node passed to remove is not present in the network node list.

FIRST_REMOVED_NODE_INDEX

Array index used to retrieve the first element spliced from the node list during a single-node removal operation.

NetworkRemoveProps

Internal network properties accessed by the remove utilities to manage dirty-state flags after node removal.

NODE_NOT_FOUND_INDEX

Sentinel index value returned when a node search yields no match in the network node list.

NODE_TYPE_INPUT

Node type literal for input anchors that cannot be removed from the network topology.

NODE_TYPE_OUTPUT

Node type literal for output anchors that cannot be removed from the network topology.

NodeConnectionSnapshotContext

Snapshot of all node adjacency connection lists captured prior to removal.

NodeRemovalContext

Immutable context object used to carry one validated node-removal orchestration request.

ReconnectEndpointPairContext

Endpoint pair describing source and target nodes for reconnecting bridged paths.

architecture/network/remove/network.remove.utils.ts

Node removal utilities.

This module provides a focused implementation for removing a single hidden node from a network while attempting to preserve overall functional connectivity. The removal procedure mirrors the legacy Neataptic logic but augments it with clearer documentation and explicit invariants.

High‑level algorithm (removeNode):

1. Guard: ensure the node exists and is not an input or output (those are structural anchors).
2. Ungate: detach connections gated BY the node (we don't currently reassign gater roles).
3. Snapshot inbound / outbound connections (before mutation of adjacency lists).
4. Disconnect all inbound, outbound, and self connections.
5. Physically remove the node from the network's node array.
6. Simple path repair heuristic: for every former inbound source and outbound target, add a direct connection if (a) both endpoints still exist, (b) they are distinct, and (c) no direct connection already exists. This keeps forward information flow possibilities.
7. Mark topology / caches dirty so that subsequent activation / ordering passes rebuild state.

Notes / Limitations:

• We do NOT attempt to clone weights or distribute the removed node's function across new connections (more sophisticated strategies could average or compose weights).
• Gating effects involving the removed node as a gater are dropped; downstream behavior may change—callers relying heavily on gating may want a custom remap strategy.
• Self connections are simply removed; no attempt is made to emulate recursion via alternative structures.

networkRemoveUtils

Default export bundle for the node removal utilities chapter.

Bundles removeNode so the network facade can bind it as a method without importing it individually.

removeNode

removeNode(
  node: default,
): void

Remove a hidden node from the network while minimally repairing connectivity.

Parameters:

• this - Network instance (bound implicitly via method-style call).
• node - The node object to remove (must be of type 'hidden').

architecture/network/remove/network.remove.gates.utils.ts

clearConnectionGater

clearConnectionGater(
  candidateConnection: default,
): void

Clears gater reference so legacy checks treat connection as ungated.

Parameters:

• candidateConnection - Connection to clear.

Returns: Nothing.

detachGatesOwnedByNode

detachGatesOwnedByNode(
  removalContext: NodeRemovalContext,
): void

Removes gate records gated by target node and nulls their gater field.

Parameters:

• removalContext - Immutable removal context.

Returns: Nothing.

isGatedByRemovedNode

isGatedByRemovedNode(
  candidateConnection: default,
  removedNode: default,
): boolean

Checks whether a gate candidate is currently gated by removed node.

Parameters:

• candidateConnection - Gate candidate.
• removedNode - Removed node reference.

Returns: True when removed node is gater.

keepGateConnectionAfterNodeRemoval

keepGateConnectionAfterNodeRemoval(
  candidateConnection: default,
  removedNode: default,
): boolean

Filters one gate connection while clearing removed-node gater ownership.

Parameters:

• candidateConnection - Gate candidate.
• removedNode - Removed node reference.

Returns: True when gate should remain in list.

architecture/network/remove/network.remove.finalize.utils.ts

markNetworkRemovalDirtyFlags

markNetworkRemovalDirtyFlags(
  internalNetwork: NetworkRemoveProps,
): void

Marks all cached removal-sensitive network structures as dirty after node removal.

Parameters:

• internalNetwork - Internal mutable network props.

Returns: Nothing.

releaseRemovedNodeWhenPoolingEnabled

releaseRemovedNodeWhenPoolingEnabled(
  removedNode: default | undefined,
): void

Releases removed node to object pool when pooling is enabled.

Parameters:

• removedNode - Removed node instance.

Returns: Nothing.

removeNodeFromNetworkStorage

removeNodeFromNetworkStorage(
  removalContext: NodeRemovalContext,
): void

Removes node from network storage and conditionally releases it to pool.

Parameters:

• removalContext - Immutable removal context.

Returns: Nothing.

spliceNodeFromNetwork

spliceNodeFromNetwork(
  removalContext: NodeRemovalContext,
): default | undefined

Splices node out of network list using validated index.

Parameters:

• removalContext - Immutable removal context.

Returns: Removed node or undefined.

architecture/network/remove/network.remove.snapshot.utils.ts

cloneInboundConnections

cloneInboundConnections(
  targetNode: default,
): default[]

Clones inbound connections for safe traversal after mutation.

Parameters:

• targetNode - Node being removed.

Returns: Inbound connection snapshot.

cloneOutboundConnections

cloneOutboundConnections(
  targetNode: default,
): default[]

Clones outbound connections for safe traversal after mutation.

Parameters:

• targetNode - Node being removed.

Returns: Outbound connection snapshot.

countSelfConnections

countSelfConnections(
  targetNode: default,
): number

Counts self-loop connections currently attached to node.

Parameters:

• targetNode - Node being removed.

Returns: Self-loop count.

createNodeConnectionSnapshot

createNodeConnectionSnapshot(
  removalContext: NodeRemovalContext,
): NodeConnectionSnapshotContext

Creates immutable snapshots of all node adjacency lists before mutation.

Parameters:

• removalContext - Immutable removal context.

Returns: Snapshot context.

disconnectAllNodeConnections

disconnectAllNodeConnections(
  removalContext: NodeRemovalContext,
  snapshotContext: NodeConnectionSnapshotContext,
): void

Disconnects all inbound, outbound, and self-loop edges for removed node.

Parameters:

• removalContext - Immutable removal context.
• snapshotContext - Immutable adjacency snapshot.

Returns: Nothing.

disconnectConnectionGroup

disconnectConnectionGroup(
  network: default,
  connectionsToDisconnect: default[],
): void

Disconnects each connection in a single connection list.

Parameters:

• network - Target network.
• connectionsToDisconnect - Connection list.

Returns: Nothing.

disconnectSelfLoops

disconnectSelfLoops(
  network: default,
  targetNode: default,
  selfConnectionCount: number,
): void

Disconnects node self-loop connections using deterministic count traversal.

Parameters:

• network - Target network.
• targetNode - Node whose self-loop is removed.
• selfConnectionCount - Number of self-loops to remove.

Returns: Nothing.

architecture/network/remove/network.remove.reconnect.utils.ts

collectReconnectEndpointPairs

collectReconnectEndpointPairs(
  snapshotContext: NodeConnectionSnapshotContext,
): ReconnectEndpointPairContext[]

Collects all valid source/target reconnect endpoint pairs.

Parameters:

• snapshotContext - Immutable adjacency snapshot.

Returns: Valid reconnect endpoint pairs.

connectPairWhenMissing

connectPairWhenMissing(
  network: default,
  reconnectPair: ReconnectEndpointPairContext,
): void

Connects one endpoint pair only when direct edge does not already exist.

Parameters:

• network - Target network.
• reconnectPair - Source/target pair.

Returns: Nothing.

createReconnectEndpointPair

createReconnectEndpointPair(
  inboundConnection: default,
  outboundConnection: default,
): ReconnectEndpointPairContext | undefined

Creates one reconnect endpoint pair when endpoints are valid.

Parameters:

• inboundConnection - Inbound edge from snapshot.
• outboundConnection - Outbound edge from snapshot.

Returns: Reconnect pair or undefined.

doesDirectConnectionExist

doesDirectConnectionExist(
  network: default,
  reconnectPair: ReconnectEndpointPairContext,
): boolean

Checks whether a direct connection already exists for reconnect pair.

Parameters:

• network - Target network.
• reconnectPair - Source/target pair.

Returns: True when direct edge already exists.

isReconnectPairValid

isReconnectPairValid(
  inboundConnection: default,
  outboundConnection: default,
): boolean

Validates reconnect pair endpoints.

Parameters:

• inboundConnection - Inbound edge from snapshot.
• outboundConnection - Outbound edge from snapshot.

Returns: True when reconnect pair should be attempted.

reconnectBridgedPaths

reconnectBridgedPaths(
  removalContext: NodeRemovalContext,
  snapshotContext: NodeConnectionSnapshotContext,
): void

Reconnects paths from former inbound sources to former outbound targets.

Parameters:

• removalContext - Immutable removal context.
• snapshotContext - Immutable adjacency snapshot.

Returns: Nothing.

architecture/network/remove/network.remove.validation.utils.ts

createValidatedNodeRemovalContext

createValidatedNodeRemovalContext(
  network: default,
  targetNode: default,
): NodeRemovalContext

Create a validated immutable context object for one node-removal operation.

Parameters:

• network - Target network.
• targetNode - Node requested for removal.

Returns: Validated removal context.

ensureNodeIsNotStructuralAnchor

ensureNodeIsNotStructuralAnchor(
  targetNode: default,
): void

Ensures removal target is not an input/output anchor node.

Parameters:

• targetNode - Node under validation.

Returns: Nothing.

isStructuralAnchorNode

isStructuralAnchorNode(
  targetNode: default,
): boolean

Checks whether node is an input/output structural anchor.

Parameters:

• targetNode - Node under evaluation.

Returns: True when node is an anchor.

resolveNodeIndexOrThrow

resolveNodeIndexOrThrow(
  network: default,
  targetNode: default,
): number

Resolves node index and throws when missing.

Parameters:

• network - Target network.
• targetNode - Node being removed.

Returns: Node index inside network list.