# j0rdan-m/ioc-tracking-tool architecture

> Architecture diagram of the GitHub repository j0rdan-m/ioc-tracking-tool, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/j0rdan-m/ioc-tracking-tool
- Repository: https://github.com/j0rdan-m/ioc-tracking-tool

## Overview

IOC Investigation Toolkit is a browser-based analyst application for browsing a curated security-tool catalog and investigating indicators. The main flow is to search or paste an indicator, then inspect catalog matches or run keyless provider checks; analysts can also extract indicators from text, analyze batches or email headers, and retain findings in local investigations. Separate branches cover pivoting and graph-based workspaces, history, exports, provider evidence and signal scoring. The graph follows documented wiring and indexed imports; unsampled features and relationships are represented only where the README supports them.

Main entry points: [`src/App.svelte`](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/App.svelte) (Application shell), [`src/lib/services/fast-analyze.js`](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/fast-analyze.js) (Provider checks), [`src/lib/components/FastAnalyzeModal.svelte`](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/FastAnalyzeModal.svelte) (Fast analyze UI), [`src/lib/components/IocExtractorModal.svelte`](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/IocExtractorModal.svelte) (IOC extraction UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Analyst interface"]
  node_app["Application shell<br/>[App.svelte]"]
  node_catalog["Tool catalog<br/>[ToolGrid.svelte]"]
  node_search["Search and filters<br/>[SearchBar.svelte]"]
  node_fastui["Fast analyze UI"]
  node_extractui["IOC extraction UI"]
  node_emailui["Email header UI"]
end

subgraph group_analysis["IOC analysis"]
  node_analysisservice["Provider checks<br/>[fast-analyze.js]"]
  node_batch["Batch scheduler<br/>[batch-analyze.js]"]
  node_iocextract["IOC extraction<br/>[extract-iocs.js]"]
  node_refang["IOC normalization<br/>[refang.js]"]
  node_headeranalysis["Header analysis"]
  node_signal["Signal score<br/>[signal-score.js]"]
  node_rawresponse["Provider evidence"]
end

subgraph group_workspace["Investigation workspace"]
  node_workspaceui["Workspace interface"]
  node_pivot["Pivot discovery<br/>[pivot-service.js]"]
  node_workspacemodel["Investigation model"]
end

subgraph group_records["Local records and exports"]
  node_workspacepersist[("Workspace repository")]
  node_history[("Analysis history")]
  node_exports["Export model<br/>[export-model.js]"]
end

subgraph group_platform["App services"]
  node_di["Dependency wiring<br/>[bootstrap.js]"]
  node_container["DI context bridge<br/>[provide.js]"]
end

node_analyst(("Analyst"))
node_publicapis{{"Public lookup APIs"}}

node_analyst -->|"uses"| node_app
node_app -->|"renders"| node_catalog
node_app -->|"renders"| node_search
node_app -->|"opens"| node_fastui
node_app -->|"opens"| node_extractui
node_app -->|"opens"| node_emailui
node_analyst -->|"searches"| node_search
node_search -->|"filters"| node_catalog
node_analyst -->|"submits indicator"| node_fastui
node_fastui -->|"requests checks"| node_analysisservice
node_analysisservice -->|"queries"| node_publicapis
node_analysisservice -->|"captures response"| node_rawresponse
node_analyst -->|"pastes text"| node_extractui
node_extractui -->|"extracts indicators"| node_iocextract
node_iocextract -->|"normalizes"| node_refang
node_extractui -->|"runs selected"| node_batch
node_batch -->|"runs checks"| node_analysisservice
node_analyst -->|"pastes headers"| node_emailui
node_emailui -->|"analyzes headers"| node_headeranalysis
node_app -->|"opens"| node_workspaceui
node_workspaceui -->|"stores investigations"| node_workspacepersist
node_workspacepersist -->|"sanitizes records"| node_workspacemodel
node_workspaceui -.->|"requests pivots"| node_pivot
node_pivot -->|"queries providers"| node_analysisservice
node_fastui -.->|"records analysis"| node_history
node_history -->|"provides export data"| node_exports
node_exports -->|"sanitizes evidence"| node_rawresponse
node_exports -->|"calculates score"| node_signal
node_di -->|"provides dependencies"| node_container

click node_app "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/App.svelte"
click node_catalog "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/ToolGrid.svelte"
click node_search "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/SearchBar.svelte"
click node_fastui "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/FastAnalyzeModal.svelte"
click node_extractui "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/IocExtractorModal.svelte"
click node_emailui "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/EmailHeadersModal.svelte"
click node_analysisservice "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/fast-analyze.js"
click node_batch "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/batch-analyze.js"
click node_iocextract "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/extract-iocs.js"
click node_refang "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/refang.js"
click node_headeranalysis "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/email-header-analyzer.js"
click node_workspaceui "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/InvestigationWorkspace.svelte"
click node_pivot "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/workspace/pivot-service.js"
click node_workspacemodel "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/workspace/investigation-model.js"
click node_workspacepersist "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/workspace/investigation-repository.js"
click node_history "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/investigation-history.js"
click node_exports "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/export/export-model.js"
click node_signal "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/signal-score.js"
click node_di "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/bootstrap.js"
click node_container "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/di/provide.js"
click node_rawresponse "https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/provider-response.js"

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_app,node_catalog,node_search,node_fastui,node_extractui,node_emailui toneBlue
class node_analysisservice,node_batch,node_iocextract,node_refang,node_headeranalysis,node_signal,node_rawresponse toneAmber
class node_workspaceui,node_pivot,node_workspacemodel,node_publicapis toneMint
class node_workspacepersist,node_history,node_exports toneRose
class node_di,node_container,node_analyst toneIndigo
```

## Components

### Analyst interface

- [Application shell](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/App.svelte): `src/App.svelte`
- [Tool catalog](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/ToolGrid.svelte): `src/lib/components/ToolGrid.svelte`
- [Search and filters](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/SearchBar.svelte): `src/lib/components/SearchBar.svelte`
- [Fast analyze UI](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/FastAnalyzeModal.svelte): `src/lib/components/FastAnalyzeModal.svelte`
- [IOC extraction UI](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/IocExtractorModal.svelte): `src/lib/components/IocExtractorModal.svelte`
- [Email header UI](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/EmailHeadersModal.svelte): `src/lib/components/EmailHeadersModal.svelte`

### IOC analysis

- [Provider checks](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/fast-analyze.js): `src/lib/services/fast-analyze.js`
- [Batch scheduler](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/batch-analyze.js): `src/lib/utils/batch-analyze.js`
- [IOC extraction](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/extract-iocs.js): `src/lib/utils/extract-iocs.js`
- [IOC normalization](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/refang.js): `src/lib/utils/refang.js`
- [Header analysis](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/email-header-analyzer.js): `src/lib/utils/email-header-analyzer.js`
- [Signal score](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/signal-score.js): `src/lib/utils/signal-score.js`
- [Provider evidence](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/utils/provider-response.js): `src/lib/utils/provider-response.js`

### Investigation workspace

- [Workspace interface](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/components/InvestigationWorkspace.svelte): `src/lib/components/InvestigationWorkspace.svelte`
- [Pivot discovery](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/workspace/pivot-service.js): `src/lib/services/workspace/pivot-service.js`
- [Investigation model](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/workspace/investigation-model.js): `src/lib/services/workspace/investigation-model.js`

### Local records and exports

- [Workspace repository](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/workspace/investigation-repository.js): `src/lib/services/workspace/investigation-repository.js`
- [Analysis history](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/investigation-history.js): `src/lib/services/investigation-history.js`
- [Export model](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/services/export/export-model.js): `src/lib/services/export/export-model.js`

### App services

- [Dependency wiring](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/bootstrap.js): `src/lib/bootstrap.js`
- [DI context bridge](https://github.com/j0rdan-m/ioc-tracking-tool/blob/main/src/lib/di/provide.js): `src/lib/di/provide.js`

### Other components

- **Analyst**
- **Public lookup APIs**

## Connections

- Analyst → Application shell: uses (evidence: `README.md`)
- Application shell → Tool catalog: renders (evidence: `src/App.svelte`)
- Application shell → Search and filters: renders (evidence: `src/App.svelte`)
- Application shell → Fast analyze UI: opens (evidence: `src/App.svelte`)
- Application shell → IOC extraction UI: opens (evidence: `src/App.svelte`)
- Application shell → Email header UI: opens (evidence: `src/App.svelte`)
- Analyst → Search and filters: searches (evidence: `README.md`)
- Search and filters → Tool catalog: filters (evidence: `README.md`)
- Analyst → Fast analyze UI: submits indicator (evidence: `README.md`)
- Fast analyze UI → Provider checks: requests checks (evidence: `README.md`)
- Provider checks → Public lookup APIs: queries (evidence: `README.md`)
- Provider checks → Provider evidence: captures response (evidence: `src/lib/services/fast-analyze.js`)
- Analyst → IOC extraction UI: pastes text (evidence: `README.md`)
- IOC extraction UI → IOC extraction: extracts indicators (evidence: `src/lib/components/IocExtractorModal.svelte`)
- IOC extraction → IOC normalization: normalizes (evidence: `README.md`)
- IOC extraction UI → Batch scheduler: runs selected (evidence: `src/lib/components/IocExtractorModal.svelte`)
- Batch scheduler → Provider checks: runs checks (evidence: `README.md`)
- Analyst → Email header UI: pastes headers (evidence: `README.md`)
- Email header UI → Header analysis: analyzes headers (evidence: `README.md`)
- Application shell → Workspace interface: opens (evidence: `src/App.svelte`)
- Workspace interface → Workspace repository: stores investigations
- Workspace repository → Investigation model: sanitizes records (evidence: `src/lib/services/workspace/investigation-repository.js`)
- Workspace interface → Pivot discovery: requests pivots
- Pivot discovery → Provider checks: queries providers (evidence: `src/lib/services/workspace/pivot-service.js`)
- Fast analyze UI → Analysis history: records analysis
- Analysis history → Export model: provides export data (evidence: `src/lib/services/export/export-model.js`)
- Export model → Provider evidence: sanitizes evidence (evidence: `src/lib/services/export/export-model.js`)
- Export model → Signal score: calculates score (evidence: `src/lib/services/export/export-model.js`)
- Dependency wiring → DI context bridge: provides dependencies (evidence: `src/lib/bootstrap.js`)
