# leiterconsulting/splunk-version-value-explorer architecture

> Architecture diagram of the GitHub repository leiterconsulting/splunk-version-value-explorer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leiterconsulting/splunk-version-value-explorer
- Repository: https://github.com/leiterconsulting/splunk-version-value-explorer

## Overview

Version Compass is a browser-based Splunk release, upgrade, and migration planning guide. Users select a product, deployment context, current release, and destination to get a tailored comparison with compatibility checks, readiness guidance, citations, and shareable or printable results. The documented product also includes product-specific views, cloud-environment filters, and browser-scoped WebMCP tools. The graph preserves those branches and the read-only content-delivery service; UI internals were not sampled, so their documented relationships cite the README.

Main entry points: [`dist/app.js`](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/app.js) (Journey explorer), [`dist/comparison.js`](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/comparison.js) (Route comparison), [`dist/content-client.js`](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/content-client.js) (Content client), [`worker/index.mjs`](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/worker/index.mjs) (Read-only content API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journey["Journey explorer"]
  node_explorer["Journey explorer<br/>[app.js]"]
  node_comparison["Route comparison<br/>[comparison.js]"]
  node_contentclient["Content client<br/>[content-client.js]"]
  node_updates["Content updates<br/>[content-updates.js]"]
end

subgraph group_guidance["Product guidance"]
  node_platform["Platform journeys<br/>[platform.json]"]
  node_products["Product tracks<br/>[products.json]"]
  node_guidance_data["Readiness guidance<br/>[guidance.json]"]
  node_environment["Cloud environments<br/>[environment.js]"]
  node_editions["ES editions<br/>[editions.js]"]
  node_forwarders["Forwarder guidance<br/>[forwarders.js]"]
  node_soar["SOAR guidance<br/>[soar.js]"]
  node_decision["Decision support"]
end

subgraph group_results["Reports and agents"]
  node_report["Report tools<br/>[report-tools.js]"]
  node_print["Print report<br/>[release-print.js]"]
  node_webmcp["WebMCP tools<br/>[webmcp.js]"]
end

subgraph group_content["Content delivery"]
  node_worker["Read-only content API<br/>[index.mjs]"]
  node_store[("Revision store<br/>[content-store.mjs]")]
  node_schema[("Content schema<br/>[schema.ts]")]
  node_bundled["Published content bundle<br/>[catalog.json]"]
end

node_customer(("Customer"))

node_customer -->|"selects journey"| node_explorer
node_explorer -->|"builds comparison"| node_comparison
node_comparison -->|"uses release paths"| node_platform
node_comparison -->|"checks compatibility"| node_products
node_comparison -->|"adds readiness work"| node_guidance_data
node_explorer -->|"filters hosting context"| node_environment
node_explorer -->|"shows editions"| node_editions
node_explorer -->|"shows forwarder guidance"| node_forwarders
node_explorer -->|"shows SOAR guidance"| node_soar
node_comparison -->|"surfaces risks"| node_decision
node_explorer -->|"loads content"| node_contentclient
node_contentclient -->|"checks updates"| node_updates
node_comparison -->|"creates shareable report"| node_report
node_report -->|"formats for print"| node_print
node_webmcp -->|"retrieves comparisons"| node_comparison
node_webmcp -->|"lists supported releases"| node_platform
node_contentclient -.->|"requests content"| node_worker
node_worker -->|"reads revisions"| node_store
node_worker -->|"uses seed content"| node_bundled
node_store -.->|"queries tables"| node_schema

click node_explorer "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/app.js"
click node_comparison "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/comparison.js"
click node_contentclient "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/content-client.js"
click node_updates "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/content-updates.js"
click node_platform "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/datasets/platform.json"
click node_products "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/datasets/products.json"
click node_guidance_data "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/datasets/guidance.json"
click node_environment "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/environment.js"
click node_editions "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/editions.js"
click node_forwarders "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/forwarders.js"
click node_soar "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/soar.js"
click node_decision "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/decision-support.js"
click node_report "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/report-tools.js"
click node_print "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/release-print.js"
click node_webmcp "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/webmcp.js"
click node_worker "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/worker/index.mjs"
click node_store "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/worker/content-store.mjs"
click node_schema "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/db/schema.ts"
click node_bundled "https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/catalog.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_explorer,node_comparison,node_contentclient,node_updates toneBlue
class node_platform,node_products,node_guidance_data,node_environment,node_editions,node_forwarders,node_soar,node_decision toneAmber
class node_report,node_print,node_webmcp toneMint
class node_worker,node_store,node_schema,node_bundled toneRose
class node_customer toneIndigo
```

## Components

### Journey explorer

- [Journey explorer](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/app.js): `dist/app.js`
- [Route comparison](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/comparison.js): `dist/comparison.js`
- [Content client](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/content-client.js): `dist/content-client.js`
- [Content updates](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/content-updates.js): `dist/content-updates.js`

### Product guidance

- [Platform journeys](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/datasets/platform.json): `content/datasets/platform.json`
- [Product tracks](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/datasets/products.json): `content/datasets/products.json`
- [Readiness guidance](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/datasets/guidance.json): `content/datasets/guidance.json`
- [Cloud environments](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/environment.js): `dist/environment.js`
- [ES editions](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/editions.js): `dist/editions.js`
- [Forwarder guidance](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/forwarders.js): `dist/forwarders.js`
- [SOAR guidance](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/soar.js): `dist/soar.js`
- [Decision support](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/decision-support.js): `dist/decision-support.js`

### Reports and agents

- [Report tools](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/report-tools.js): `dist/report-tools.js`
- [Print report](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/release-print.js): `dist/release-print.js`
- [WebMCP tools](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/dist/webmcp.js): `dist/webmcp.js`

### Content delivery

- [Read-only content API](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/worker/index.mjs): `worker/index.mjs`
- [Revision store](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/worker/content-store.mjs): `worker/content-store.mjs`
- [Content schema](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/db/schema.ts): `db/schema.ts`
- [Published content bundle](https://github.com/leiterconsulting/splunk-version-value-explorer/blob/main/content/catalog.json): `content/catalog.json`

### Other components

- **Customer**

## Connections

- Customer → Journey explorer: selects journey (evidence: `README.md`)
- Journey explorer → Route comparison: builds comparison (evidence: `README.md`)
- Route comparison → Platform journeys: uses release paths (evidence: `README.md`)
- Route comparison → Product tracks: checks compatibility (evidence: `README.md`)
- Route comparison → Readiness guidance: adds readiness work (evidence: `README.md`)
- Journey explorer → Cloud environments: filters hosting context (evidence: `README.md`)
- Journey explorer → ES editions: shows editions (evidence: `README.md`)
- Journey explorer → Forwarder guidance: shows forwarder guidance (evidence: `README.md`)
- Journey explorer → SOAR guidance: shows SOAR guidance (evidence: `README.md`)
- Route comparison → Decision support: surfaces risks (evidence: `README.md`)
- Journey explorer → Content client: loads content (evidence: `README.md`)
- Content client → Content updates: checks updates (evidence: `README.md`)
- Route comparison → Report tools: creates shareable report (evidence: `README.md`)
- Report tools → Print report: formats for print (evidence: `README.md`)
- WebMCP tools → Route comparison: retrieves comparisons (evidence: `README.md`)
- WebMCP tools → Platform journeys: lists supported releases (evidence: `README.md`)
- Content client → Read-only content API: requests content
- Read-only content API → Revision store: reads revisions (evidence: `worker/index.mjs`)
- Read-only content API → Published content bundle: uses seed content (evidence: `worker/index.mjs`)
- Revision store → Content schema: queries tables
