JohT · JohT · Mar 22, 2026 · Mar 20, 2026 · Mar 22, 2026 · Mar 22, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -264,7 +264,7 @@ For all details see: https://github.com/JohT/code-graph-analysis-pipeline/releas
 
 ### 📖 Jupyter Notebook Reports
 
-* [External Dependencies](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/external-dependencies-java/ExternalDependenciesJava.md) contains detailed information about external library usage ([Notebook](./jupyter/ExternalDependenciesJava.ipynb)).
+* [External Dependencies](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/external-dependencies-java/ExternalDependenciesJava.md) contains detailed information about external library usage ([Notebook](./domains/external-dependencies/explore/ExternalDependenciesJava.ipynb)).
 * [Object Oriented Design Quality Metrics](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/object-oriented-design-metrics-java/ObjectOrientedDesignMetricsJava.md) is based on [OO Design Quality Metrics by Robert Martin](https://api.semanticscholar.org/CorpusID:18246616) ([Notebook](./jupyter/ObjectOrientedDesignMetricsJava.ipynb)).
 * [Overview](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/overview-java/OverviewJava.md) contains overall statistics and details about methods and their complexity. ([Notebook](./jupyter/OverviewJava.ipynb)).
 * [Internal Dependencies](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/internal-dependencies-java/InternalDependenciesJava.md) is based on [Analyze java package metrics in a graph database](https://joht.github.io/johtizen/data/2023/04/21/java-package-metrics-analysis.html) and also includes cyclic dependencies ([Notebook](./jupyter/InternalDependenciesJava.ipynb)).
@@ -281,7 +281,7 @@ Here are some reports that utilize Neo4j's [Graph Data Science Library](https://
 
 ### 📖 Other Reports
 
-* [External Dependencies (CSV)](./scripts/reports/ExternalDependenciesCsv.sh) ([Example](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/external-dependencies-csv/External_package_usage_overall.csv))
+* [External Dependencies (CSV)](./domains/external-dependencies/externalDependenciesCsv.sh) ([Example](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/external-dependencies-csv/External_package_usage_overall.csv))
 * [Object Oriented Design Metrics (CSV)](./scripts/reports/ObjectOrientedDesignMetricsCsv.sh) ([Example](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/object-oriented-design-metrics-csv/MainSequenceAbstractnessInstabilityDistanceJava.csv))
 * [Overview (CSV)](./scripts/reports/OverviewCsv.sh) ([Example](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/overview-csv/Cyclomatic_Method_Complexity.csv))
 * [Internal Dependencies - Cyclic (CSV)](./scripts/reports/InternalDependenciesCsv.sh) ([Example](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/internal-dependencies-csv/Cyclic_Dependencies_Breakdown_Backward_Only.csv))

diff --git a/README.md b/README.md
@@ -46,7 +46,7 @@ Curious? Explore the examples at [code-graph-analysis-examples](https://github.c
 
 Here is an overview of [Jupyter Notebooks](https://jupyter.org) reports from [code-graph-analysis-examples](https://github.com/JohT/code-graph-analysis-examples). For a complete list, see the [Jupyter Notebook Report Reference](#page_with_curl-jupyter-notebook-report-reference).
 
-- [External Dependencies](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/external-dependencies-java/ExternalDependenciesJava.md) contains detailed information about external library usage ([Notebook](./jupyter/ExternalDependenciesJava.ipynb)).
+- [External Dependencies](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/external-dependencies-java/ExternalDependenciesJava.md) contains detailed information about external library usage ([Notebook](./domains/external-dependencies/explore/ExternalDependenciesJava.ipynb)).
 - [Git History](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/git-history-general/GitHistoryGeneral.md) contains information about the git history of the analyzed code ([Notebook](./jupyter/GitHistoryGeneral.ipynb)).
 - [Internal Dependencies](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/internal-dependencies-java/InternalDependenciesJava.md) is based on [Analyze java package metrics in a graph database](https://joht.github.io/johtizen/data/2023/04/21/java-package-metrics-analysis.html) and also includes cyclic dependencies ([Notebook](./jupyter/InternalDependenciesJava.ipynb)).
 - [Method Metrics](https://github.com/JohT/code-graph-analysis-examples/blob/main/analysis-results/AxonFramework/latest/method-metrics-java/MethodMetricsJava.md)  shows how the effective number of lines of code and the cyclomatic complexity are distributed across the methods in the code ([Notebook](./jupyter/MethodMetricsJava.ipynb)).

diff --git a/...bel_external_types_and_annotations.cypher → ...bel_external_types_and_annotations.cypher b/...bel_external_types_and_annotations.cypher → ...bel_external_types_and_annotations.cypher
diff --git a/...xternal_type_and_annotation_labels.cypher → ...xternal_type_and_annotation_labels.cypher b/...xternal_type_and_annotation_labels.cypher → ...xternal_type_and_annotation_labels.cypher
diff --git a/domains/external-dependencies/README.md b/domains/external-dependencies/README.md
@@ -0,0 +1,79 @@
+# External Dependencies Domain
+
+This directory contains the implementation and resources for analysing external dependencies within the Code Graph Analysis Pipeline. It follows the vertical-slice domain pattern: all Cypher queries, Python chart scripts, and report templates needed for this analysis live here.
+
+## Entry Points
+
+The following scripts are discovered and invoked automatically by the central compilation scripts in [scripts/reports/compilations/](../../scripts/reports/compilations/). They are found by filename pattern.
+
+- [externalDependenciesCsv.sh](./externalDependenciesCsv.sh): Entry point for CSV reports based on Cypher queries. Discovered by `CsvReports.sh` (`*Csv.sh` pattern).
+- [externalDependenciesPython.sh](./externalDependenciesPython.sh): Entry point for Python-based chart generation. Discovered by `PythonReports.sh` (`*Python.sh` pattern).
+- [externalDependenciesMarkdown.sh](./externalDependenciesMarkdown.sh): Entry point for the Markdown summary report. Discovered by `MarkdownReports.sh` (`*Markdown.sh` pattern).
+
+## Folder Structure
+
+- [explore](./explore/): Original Jupyter notebooks for interactive, exploratory analysis. Marked with `code_graph_analysis_pipeline_data_validation: ValidateAlwaysFalse` so they are not automatically executed by the pipeline.
+- [queries](./queries/): All Cypher queries for identifying and quantifying external dependencies. These are self-contained copies from [cypher/External_Dependencies/](../../cypher/External_Dependencies/).
+- [summary](./summary/): Markdown template and assembly script for the summary report.
+
+## Prerequisites
+
+This domain requires the following to be in place before running. These are provided by the central pipeline ([scripts/prepareAnalysis.sh](../../scripts/prepareAnalysis.sh)) and are **not** set up by this domain.
+
+### Graph database
+
+- Neo4j must be running and accessible at `bolt://localhost:7687`.
+- `NEO4J_INITIAL_PASSWORD` environment variable must be set.
+- Artifacts must already have been scanned and loaded by jQAssistant, creating `DEPENDS_ON` relationships between `Type` nodes.
+
+### Node labels (Java)
+
+The following labels must exist on `Type` nodes before external dependency analysis can run. They are created by Cypher queries in [cypher/Types/](../../cypher/Types/):
+
+- `PrimitiveType` — primitive types like `int`, `boolean`
+- `Void` — void return type
+- `JavaType` — built-in Java standard library types (e.g. `java.lang.*`, `java.util.*`)
+- `ResolvedDuplicateType` — deduplicated types that appear in multiple jars
+
+Without these labels, `Label_external_types_and_annotations.cypher` cannot correctly distinguish external types from internal and built-in ones.
+
+### Relationship weight properties (Java)
+
+The following properties must exist on `DEPENDS_ON` relationships between `Package` nodes. They are set by Cypher queries in [cypher/DependsOn_Relationship_Weights/](../../cypher/DependsOn_Relationship_Weights/):
+
+- `weight` — sum of type-level dependency weights between two packages
+- `weightInterfaces` — subset of `weight` attributable to interface dependencies
+
+### TypeScript enrichment
+
+For TypeScript projects, the following must be completed by [cypher/Typescript_Enrichment/](../../cypher/Typescript_Enrichment/):
+
+- Module properties set on `Module` nodes: `namespace`, `moduleName`, `isNodeModule`, `isExternalImport`
+- `IS_IMPLEMENTED_IN` relationships linking `ExternalModule` nodes to their resolved internal `Module` nodes
+- `DEPENDS_ON` relationships propagated to resolved modules
+- NPM packages linked to their corresponding `ExternalModule` nodes via `PROVIDED_BY_NPM_DEPENDENCY`
+
+### General enrichment
+
+- `name` and `extension` properties on `File` nodes — set by [cypher/General_Enrichment/](../../cypher/General_Enrichment/).
+
+## What This Domain Produces
+
+### CSV reports (`reports/external-dependencies/`)
+
+One CSV file per Cypher query covering:
+
+- **Java packages**: overall usage, spread, per-artifact, per-type, distribution, aggregated, Maven POM declared dependencies
+- **TypeScript modules and namespaces**: overall usage, spread, per-internal-module, aggregated
+- **Package management**: `package.json` dependency occurrence and combinations
+
+### SVG charts (`reports/external-dependencies/`)
+
+Python-generated charts from [externalDependencyCharts.py](./externalDependencyCharts.py):
+
+- **Java**: pie charts for most-used and most-spread packages (by types and by packages, with drill-down into "others"), stacked bar charts for per-artifact breakdown, scatter plots for aggregated usage patterns
+- **TypeScript**: pie charts for modules and namespaces (usage and spread, with drill-down)
+
+### Markdown summary (`reports/external-dependencies/external_dependencies_report.md`)
+
+A structured report designed to be readable by both humans and AI agents. Includes key findings, tables, chart references, and architectural recommendations such as Hexagonal Architecture patterns and Anti-Corruption Layer candidates.
diff --git a/jupyter/ExternalDependenciesJava.ipynb → ...es/explore/ExternalDependenciesJava.ipynb b/jupyter/ExternalDependenciesJava.ipynb → ...es/explore/ExternalDependenciesJava.ipynb
@@ -1726,7 +1726,7 @@
    }
   ],
   "celltoolbar": "Tags",
-  "code_graph_analysis_pipeline_data_validation": "ValidateJavaExternalDependencies",
+  "code_graph_analysis_pipeline_data_validation": "ValidateAlwaysFalse",
   "kernelspec": {
    "display_name": "codegraph",
    "language": "python",

diff --git a/jupyter/ExternalDependenciesTypescript.ipynb → ...lore/ExternalDependenciesTypescript.ipynb b/jupyter/ExternalDependenciesTypescript.ipynb → ...lore/ExternalDependenciesTypescript.ipynb
@@ -1629,7 +1629,7 @@
    }
   ],
   "celltoolbar": "Tags",
-  "code_graph_analysis_pipeline_data_validation": "ValidateTypescriptModuleDependencies",
+  "code_graph_analysis_pipeline_data_validation": "ValidateAlwaysFalse",
   "kernelspec": {
    "display_name": "codegraph",
    "language": "python",