semanticembed 0.1.0__tar.gz

semanticembed-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.pyc
+*.pyo
+dist/
+build/
+*.egg-info/
+.eggs/
+.env
+.venv/
+*.egg
+.ipynb_checkpoints/

semanticembed-0.1.0/LICENSE

@@ -0,0 +1,18 @@
+SemanticEmbed SDK License
+
+Copyright (c) 2026 SemanticEmbed Inc. All rights reserved.
+
+This software is proprietary and confidential. Unauthorized copying,
+distribution, modification, or use of this software, via any medium,
+is strictly prohibited.
+
+The SemanticEmbed SDK is distributed as a compiled package for the
+sole purpose of interfacing with the SemanticEmbed cloud API. It does
+not contain the encoding algorithm or any proprietary computation logic.
+
+Free tier: graphs up to 50 nodes, no signup required.
+Paid tier: unlimited nodes, requires a valid license key.
+
+Patent pending. Application #63/994,075.
+
+For licensing inquiries: jeffmurr@seas.upenn.edu

semanticembed-0.1.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: semanticembed
+Version: 0.1.0
+Summary: 6D structural intelligence for directed graphs. Six numbers per node. Sub-millisecond.
+Project-URL: Homepage, https://github.com/jmurray10/semanticembed-sdk
+Project-URL: Documentation, https://github.com/jmurray10/semanticembed-sdk
+Project-URL: Repository, https://github.com/jmurray10/semanticembed-sdk
+Author-email: Jeff Murray <jeffmurr@seas.upenn.edu>
+License: Proprietary
+License-File: LICENSE
+Keywords: graph,microservices,observability,risk-detection,structural-analysis
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.24
+Description-Content-Type: text/markdown
+
+# SemanticEmbed SDK
+
+**Structural intelligence for directed graphs. Six numbers per node. Sub-millisecond.**
+
+SemanticEmbed computes a 6-dimensional structural encoding for every node in a directed graph. From a bare edge list -- no runtime telemetry, no historical data, no tuning -- it produces six independent measurements that fully describe each node's structural role.
+
+> **Validated against production incidents.** In a blind test against a live production environment (100+ services, 2,500+ incidents over 30 days), the majority of topology-relevant incidents occurred on nodes that 6D structural analysis had flagged as risky -- from the call graph alone, before any incident occurred.
+
+---
+
+## Why 6D?
+
+Observability tools tell you **what broke**. SemanticEmbed tells you **what will break** -- from topology alone.
+
+- **No agents, no instrumentation** -- just an edge list
+- **Sub-millisecond** -- encodes 100+ node graphs in <1ms
+- **Works on any directed graph** -- microservices, AI agent pipelines, data workflows, CI/CD
+- **Mathematically independent axes** -- six dimensions, zero redundancy, each captures structural information no other metric provides
+
+---
+
+## Try It Now
+
+**[Open the Interactive Demo in Google Colab](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/01_quickstart.ipynb)** -- runs in your browser, nothing to install locally.
+
+---
+
+## Install
+
+```bash
+pip install semanticembed
+```
+
+**Free tier:** Up to 50 nodes per graph. No signup required.
+
+---
+
+## Quick Start
+
+```python
+from semanticembed import encode, report
+
+# Any directed graph as an edge list
+edges = [
+    ("frontend", "api-gateway"),
+    ("api-gateway", "order-service"),
+    ("api-gateway", "user-service"),
+    ("order-service", "payment-service"),
+    ("order-service", "inventory-service"),
+    ("payment-service", "database"),
+]
+
+# Compute the 6D encoding (sub-millisecond)
+result = encode(edges)
+
+# Six structural measurements per node
+for node, vector in result.vectors.items():
+    print(f"{node}: {vector}")
+
+# Structural risk report
+print(report(result))
+```
+
+Output:
+
+```
+STRUCTURAL RISK REPORT
+======================
+
+AMPLIFICATION RISKS (high fanout, high criticality):
+  - api-gateway    | fanout=0.667 | criticality=0.556
+
+CONVERGENCE SINKS (low independence, many upstream callers):
+  - database       | independence=0.000
+
+STRUCTURAL SPOF (low independence, high upstream dependency):
+  - api-gateway    | independence=0.000 | every request flows through this node
+```
+
+---
+
+## What It Finds That Other Tools Miss
+
+| Your current tools | SemanticEmbed |
+|---|---|
+| This service has high latency | This service is on 89% of all paths (structural SPOF) |
+| This service had 5 errors | This service fans out to 12 downstream services (amplification risk) |
+| This service is healthy | This service has zero lateral redundancy (convergence sink) |
+
+Runtime monitoring tells you what is slow **now**. Structural analysis tells you what **will** cause cascading failures regardless of current load.
+
+---
+
+## The Six Dimensions
+
+Every node gets six independent structural measurements:
+
+| Dimension | What It Measures | Risk Signal |
+|-----------|-----------------|-------------|
+| **Depth** | Position in the execution pipeline (0.0 = entry, 1.0 = deepest) | Deep nodes accumulate upstream latency |
+| **Independence** | Lateral redundancy at the same pipeline stage | Low independence = structural chokepoint |
+| **Hierarchy** | Module or group membership | Cross-module dependencies = blast radius |
+| **Throughput** | Fraction of total traffic flowing through the node | High throughput + low independence = hidden bottleneck |
+| **Criticality** | Fraction of end-to-end paths depending on this node | High criticality = SPOF |
+| **Fanout** | Broadcaster (1.0) vs aggregator (0.0) | High fanout = amplification risk |
+
+These six properties are mathematically independent -- knowing any five tells you nothing about the sixth.
+
+See [docs/dimensions.md](docs/dimensions.md) for the full reference.
+
+---
+
+## Use Cases
+
+**Microservice architectures** -- Find SPOFs, amplification cascades, and convergence bottlenecks in any service mesh. Works with Kubernetes, Istio, OTel traces, or static architecture diagrams.
+
+**AI agent pipelines** -- Identify vendor concentration risk, gateway bottlenecks, and guardrail single points of failure in LLM orchestration graphs.
+
+**CI/CD and data pipelines** -- Detect structural fragility in build graphs, ETL workflows, and deployment pipelines before they cause cascading failures.
+
+**Architecture drift monitoring** -- Compare structural fingerprints across releases. Know exactly which services changed structural role and by how much.
+
+---
+
+## Notebooks
+
+Step-by-step Colab notebooks. Click to open, run in your browser.
+
+| Notebook | Use Case | What You Learn |
+|----------|----------|---------------|
+| [01 - Quickstart](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/01_quickstart.ipynb) | Getting started | Install, encode a graph, read the risk report |
+| [02 - Dimensions Deep Dive](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/02_dimensions.ipynb) | Understanding 6D | What each dimension means, with worked examples |
+| [03 - Drift Detection](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/03_drift_detection.ipynb) | Architecture drift | Compare graph versions, detect structural changes |
+| [04 - Bring Your Own Graph](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/04_bring_your_own.ipynb) | Any graph | Load from JSON, OTel traces, or Kubernetes |
+| [05 - AI Agent Pipelines](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/05_ai_agent_pipelines.ipynb) | AI/LLM agents | Vendor concentration, gateway bottlenecks, guardrail SPOFs |
+| [06 - CI/CD & Data Pipelines](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/06_cicd_pipelines.ipynb) | CI/CD & ETL | Build graph fragility, pipeline bottlenecks, drift gates |
+| [07 - OpenTelemetry](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/07_opentelemetry.ipynb) | OTel traces | Extract edges from traces, structural analysis, CI/CD gates |
+
+---
+
+## Example Graphs
+
+The `examples/` directory contains edge lists for well-known architectures:
+
+| File | Application | Nodes | Edges |
+|------|------------|-------|-------|
+| [google_online_boutique.json](examples/google_online_boutique.json) | Google Online Boutique (microservices) | 11 | 15 |
+| [weaveworks_sock_shop.json](examples/weaveworks_sock_shop.json) | Weaveworks Sock Shop (microservices) | 15 | 15 |
+| [ai_agent_pipeline.json](examples/ai_agent_pipeline.json) | Multi-agent LLM orchestration | 12 | 15 |
+| [cicd_pipeline.json](examples/cicd_pipeline.json) | CI/CD build pipeline | 13 | 17 |
+
+---
+
+## React Components
+
+Drop-in React components for rendering SDK results. See [examples/react/](examples/react/) for the full source.
+
+| Component | What it renders |
+|-----------|----------------|
+| `useSemanticEmbed.ts` | React hook — call `encode()` from your frontend |
+| `RiskTable.tsx` | Sortable risk table with severity badges |
+| `RadarChart.tsx` | 6D radar chart comparing node profiles |
+| `TopologySummary.tsx` | KPI cards + risk breakdown |
+
+```tsx
+import { useSemanticEmbed } from './useSemanticEmbed';
+import { RiskTable } from './RiskTable';
+
+function App() {
+  const { result, loading, encode } = useSemanticEmbed();
+  return (
+    <>
+      <button onClick={() => encode([["A","B"],["B","C"],["C","D"]])}>Analyze</button>
+      {result && <RiskTable risks={result.risks} />}
+    </>
+  );
+}
+```
+
+---
+
+## Input Format
+
+SemanticEmbed accepts any directed graph as an edge list.
+
+```python
+# Python tuples
+edges = [("A", "B"), ("B", "C")]
+result = encode(edges)
+
+# JSON file
+result = encode_file("my_graph.json")
+```
+
+JSON format:
+
+```json
+{
+  "edges": [
+    {"source": "A", "target": "B"},
+    {"source": "B", "target": "C"}
+  ]
+}
+```
+
+See [docs/input_format.md](docs/input_format.md) for the full spec.
+
+---
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [docs/getting_started.md](docs/getting_started.md) | Install, encode, read results, export -- one page |
+| [docs/api_reference.md](docs/api_reference.md) | Every function, class, parameter, and return type |
+| [docs/dimensions.md](docs/dimensions.md) | The six structural dimensions -- full reference |
+| [docs/input_format.md](docs/input_format.md) | Edge list input specification |
+| [docs/output_format.md](docs/output_format.md) | Encoding output and risk report format |
+
+---
+
+## License
+
+SemanticEmbed SDK is proprietary software distributed as a compiled package.
+Free tier available for graphs up to 50 nodes. See [LICENSE](LICENSE) for terms.
+
+**Patent pending.** Application #63/994,075.
+
+---
+
+## Contact
+
+Email jeffmurr@seas.upenn.edu

semanticembed-0.1.0/README.md

@@ -0,0 +1,233 @@
+# SemanticEmbed SDK
+
+**Structural intelligence for directed graphs. Six numbers per node. Sub-millisecond.**
+
+SemanticEmbed computes a 6-dimensional structural encoding for every node in a directed graph. From a bare edge list -- no runtime telemetry, no historical data, no tuning -- it produces six independent measurements that fully describe each node's structural role.
+
+> **Validated against production incidents.** In a blind test against a live production environment (100+ services, 2,500+ incidents over 30 days), the majority of topology-relevant incidents occurred on nodes that 6D structural analysis had flagged as risky -- from the call graph alone, before any incident occurred.
+
+---
+
+## Why 6D?
+
+Observability tools tell you **what broke**. SemanticEmbed tells you **what will break** -- from topology alone.
+
+- **No agents, no instrumentation** -- just an edge list
+- **Sub-millisecond** -- encodes 100+ node graphs in <1ms
+- **Works on any directed graph** -- microservices, AI agent pipelines, data workflows, CI/CD
+- **Mathematically independent axes** -- six dimensions, zero redundancy, each captures structural information no other metric provides
+
+---
+
+## Try It Now
+
+**[Open the Interactive Demo in Google Colab](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/01_quickstart.ipynb)** -- runs in your browser, nothing to install locally.
+
+---
+
+## Install
+
+```bash
+pip install semanticembed
+```
+
+**Free tier:** Up to 50 nodes per graph. No signup required.
+
+---
+
+## Quick Start
+
+```python
+from semanticembed import encode, report
+
+# Any directed graph as an edge list
+edges = [
+    ("frontend", "api-gateway"),
+    ("api-gateway", "order-service"),
+    ("api-gateway", "user-service"),
+    ("order-service", "payment-service"),
+    ("order-service", "inventory-service"),
+    ("payment-service", "database"),
+]
+
+# Compute the 6D encoding (sub-millisecond)
+result = encode(edges)
+
+# Six structural measurements per node
+for node, vector in result.vectors.items():
+    print(f"{node}: {vector}")
+
+# Structural risk report
+print(report(result))
+```
+
+Output:
+
+```
+STRUCTURAL RISK REPORT
+======================
+
+AMPLIFICATION RISKS (high fanout, high criticality):
+  - api-gateway    | fanout=0.667 | criticality=0.556
+
+CONVERGENCE SINKS (low independence, many upstream callers):
+  - database       | independence=0.000
+
+STRUCTURAL SPOF (low independence, high upstream dependency):
+  - api-gateway    | independence=0.000 | every request flows through this node
+```
+
+---
+
+## What It Finds That Other Tools Miss
+
+| Your current tools | SemanticEmbed |
+|---|---|
+| This service has high latency | This service is on 89% of all paths (structural SPOF) |
+| This service had 5 errors | This service fans out to 12 downstream services (amplification risk) |
+| This service is healthy | This service has zero lateral redundancy (convergence sink) |
+
+Runtime monitoring tells you what is slow **now**. Structural analysis tells you what **will** cause cascading failures regardless of current load.
+
+---
+
+## The Six Dimensions
+
+Every node gets six independent structural measurements:
+
+| Dimension | What It Measures | Risk Signal |
+|-----------|-----------------|-------------|
+| **Depth** | Position in the execution pipeline (0.0 = entry, 1.0 = deepest) | Deep nodes accumulate upstream latency |
+| **Independence** | Lateral redundancy at the same pipeline stage | Low independence = structural chokepoint |
+| **Hierarchy** | Module or group membership | Cross-module dependencies = blast radius |
+| **Throughput** | Fraction of total traffic flowing through the node | High throughput + low independence = hidden bottleneck |
+| **Criticality** | Fraction of end-to-end paths depending on this node | High criticality = SPOF |
+| **Fanout** | Broadcaster (1.0) vs aggregator (0.0) | High fanout = amplification risk |
+
+These six properties are mathematically independent -- knowing any five tells you nothing about the sixth.
+
+See [docs/dimensions.md](docs/dimensions.md) for the full reference.
+
+---
+
+## Use Cases
+
+**Microservice architectures** -- Find SPOFs, amplification cascades, and convergence bottlenecks in any service mesh. Works with Kubernetes, Istio, OTel traces, or static architecture diagrams.
+
+**AI agent pipelines** -- Identify vendor concentration risk, gateway bottlenecks, and guardrail single points of failure in LLM orchestration graphs.
+
+**CI/CD and data pipelines** -- Detect structural fragility in build graphs, ETL workflows, and deployment pipelines before they cause cascading failures.
+
+**Architecture drift monitoring** -- Compare structural fingerprints across releases. Know exactly which services changed structural role and by how much.
+
+---
+
+## Notebooks
+
+Step-by-step Colab notebooks. Click to open, run in your browser.
+
+| Notebook | Use Case | What You Learn |
+|----------|----------|---------------|
+| [01 - Quickstart](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/01_quickstart.ipynb) | Getting started | Install, encode a graph, read the risk report |
+| [02 - Dimensions Deep Dive](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/02_dimensions.ipynb) | Understanding 6D | What each dimension means, with worked examples |
+| [03 - Drift Detection](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/03_drift_detection.ipynb) | Architecture drift | Compare graph versions, detect structural changes |
+| [04 - Bring Your Own Graph](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/04_bring_your_own.ipynb) | Any graph | Load from JSON, OTel traces, or Kubernetes |
+| [05 - AI Agent Pipelines](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/05_ai_agent_pipelines.ipynb) | AI/LLM agents | Vendor concentration, gateway bottlenecks, guardrail SPOFs |
+| [06 - CI/CD & Data Pipelines](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/06_cicd_pipelines.ipynb) | CI/CD & ETL | Build graph fragility, pipeline bottlenecks, drift gates |
+| [07 - OpenTelemetry](https://colab.research.google.com/github/jmurray10/semanticembed-sdk/blob/main/notebooks/07_opentelemetry.ipynb) | OTel traces | Extract edges from traces, structural analysis, CI/CD gates |
+
+---
+
+## Example Graphs
+
+The `examples/` directory contains edge lists for well-known architectures:
+
+| File | Application | Nodes | Edges |
+|------|------------|-------|-------|
+| [google_online_boutique.json](examples/google_online_boutique.json) | Google Online Boutique (microservices) | 11 | 15 |
+| [weaveworks_sock_shop.json](examples/weaveworks_sock_shop.json) | Weaveworks Sock Shop (microservices) | 15 | 15 |
+| [ai_agent_pipeline.json](examples/ai_agent_pipeline.json) | Multi-agent LLM orchestration | 12 | 15 |
+| [cicd_pipeline.json](examples/cicd_pipeline.json) | CI/CD build pipeline | 13 | 17 |
+
+---
+
+## React Components
+
+Drop-in React components for rendering SDK results. See [examples/react/](examples/react/) for the full source.
+
+| Component | What it renders |
+|-----------|----------------|
+| `useSemanticEmbed.ts` | React hook — call `encode()` from your frontend |
+| `RiskTable.tsx` | Sortable risk table with severity badges |
+| `RadarChart.tsx` | 6D radar chart comparing node profiles |
+| `TopologySummary.tsx` | KPI cards + risk breakdown |
+
+```tsx
+import { useSemanticEmbed } from './useSemanticEmbed';
+import { RiskTable } from './RiskTable';
+
+function App() {
+  const { result, loading, encode } = useSemanticEmbed();
+  return (
+    <>
+      <button onClick={() => encode([["A","B"],["B","C"],["C","D"]])}>Analyze</button>
+      {result && <RiskTable risks={result.risks} />}
+    </>
+  );
+}
+```
+
+---
+
+## Input Format
+
+SemanticEmbed accepts any directed graph as an edge list.
+
+```python
+# Python tuples
+edges = [("A", "B"), ("B", "C")]
+result = encode(edges)
+
+# JSON file
+result = encode_file("my_graph.json")
+```
+
+JSON format:
+
+```json
+{
+  "edges": [
+    {"source": "A", "target": "B"},
+    {"source": "B", "target": "C"}
+  ]
+}
+```
+
+See [docs/input_format.md](docs/input_format.md) for the full spec.
+
+---
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [docs/getting_started.md](docs/getting_started.md) | Install, encode, read results, export -- one page |
+| [docs/api_reference.md](docs/api_reference.md) | Every function, class, parameter, and return type |
+| [docs/dimensions.md](docs/dimensions.md) | The six structural dimensions -- full reference |
+| [docs/input_format.md](docs/input_format.md) | Edge list input specification |
+| [docs/output_format.md](docs/output_format.md) | Encoding output and risk report format |
+
+---
+
+## License
+
+SemanticEmbed SDK is proprietary software distributed as a compiled package.
+Free tier available for graphs up to 50 nodes. See [LICENSE](LICENSE) for terms.
+
+**Patent pending.** Application #63/994,075.
+
+---
+
+## Contact
+
+Email jeffmurr@seas.upenn.edu

semanticembed-0.1.0/dimensions.md

@@ -0,0 +1,92 @@
+# The Six Dimensions
+
+SemanticEmbed computes six independent structural measurements for every node in a directed graph. Together, these six numbers form a coordinate vector in 6-dimensional Euclidean space that fully describes the node's structural role.
+
+---
+
+## Overview
+
+| # | Dimension | What It Measures | Range |
+|---|-----------|-----------------|-------|
+| 1 | **Depth** | Position in the execution pipeline | 0.0 -- 1.0 |
+| 2 | **Independence** | Lateral redundancy at the same stage | 0.0 -- 1.0 |
+| 3 | **Hierarchy** | Module or group membership | 0.0 -- 1.0 |
+| 4 | **Throughput** | Fraction of total traffic through this node | 0.0 -- 1.0 |
+| 5 | **Criticality** | Fraction of end-to-end paths depending on this node | 0.0 -- 1.0 |
+| 6 | **Fanout** | Broadcaster (1.0) vs aggregator (0.0) | 0.0 -- 1.0 |
+
+---
+
+## Depth
+
+Where a node sits in the execution pipeline. Entry points are 0.0, deepest sinks are 1.0.
+
+A failure at low depth cascades forward through more of the graph. A failure at high depth has limited downstream impact.
+
+---
+
+## Independence
+
+How many other nodes operate at the same pipeline stage. Measures lateral redundancy.
+
+A node with independence 0.0 is the only node at its depth level -- a structural chokepoint. A node with high independence has many parallel peers.
+
+**This dimension has no equivalent in standard graph centrality measures.** Maximum correlation with all 10 standard centrality metrics: |r| = 0.369. It captures a structural property that the entire field's standard toolkit cannot see.
+
+---
+
+## Hierarchy
+
+Which module, cluster, or logical group a node belongs to. Captures community structure.
+
+Nodes in the same module have similar hierarchy values. Cross-module dependencies show up as connections between nodes with different hierarchy values.
+
+---
+
+## Throughput
+
+What fraction of total traffic flows through this node, based on connectivity relative to the graph.
+
+Independent of depth: a deep node can have high or low throughput. High throughput combined with low independence indicates a hidden bottleneck.
+
+---
+
+## Criticality
+
+How many end-to-end paths through the graph depend on this node.
+
+A node with criticality 0.5 sits on half of all source-to-sink paths. If it fails, half of all end-to-end flows break. Independent of throughput: a low-traffic node can be highly critical if it bridges two large subgraphs.
+
+---
+
+## Fanout
+
+Whether a node amplifies (broadcasts to many downstream) or aggregates (collects from many upstream).
+
+High fanout = amplification risk. A failure here multiplies across all downstream dependents. Low fanout = convergence sink. Many upstream services depend on this single point.
+
+---
+
+## Independence of Dimensions
+
+The six dimensions are mathematically independent. Knowing any five tells you nothing about the sixth:
+
+- A deep node can have high or low throughput
+- A high-traffic node can sit on one path or many paths
+- A node at any depth, throughput, or criticality can be a broadcaster or aggregator
+- Independence has near-zero correlation with all standard centrality measures
+
+This independence is what makes the encoding efficient. No dimension is redundant. Every dimension carries structural information that no other dimension provides.
+
+Adding more dimensions (7, 8, ...) was tested and hurt performance -- the extra dimensions carried redundant information. Six is the natural dimensionality of the structural property space for directed computational graphs.
+
+---
+
+## Structural Risk Patterns
+
+| Pattern | Dimensions | Risk |
+|---------|-----------|------|
+| **Amplification risk** | High fanout + high criticality | Failure cascades to many services across many paths |
+| **Convergence sink** | Low independence + low fanout | Many services depend on one aggregation point |
+| **Structural SPOF** | Low independence + high criticality | Only node at its depth, on most paths |
+| **Hidden bottleneck** | High throughput + low independence | Carries most traffic with no redundancy |