# brandonsepulveda/toolboxbs architecture

> Architecture diagram of the GitHub repository brandonsepulveda/toolboxbs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brandonsepulveda/toolboxbs
- Repository: https://github.com/brandonsepulveda/toolboxbs

## Overview

ToolboxBS is a native Windows PowerShell/WPF maintenance suite. The principal workflow is to choose a cataloged tool (or invoke it by ID in console mode), execute its PowerShell code, and retain session output and logs. The README documents additional dashboard, routine, search, profile, risk-confirmation, and export capabilities. No source excerpts were provided, so relationships below are limited to those stated in the README; implementation details within the listed scripts are not inferred.

Main entry points: [`src/ToolboxBS.ps1`](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1) (Tool catalog), [`docs/catalogo.json`](https://github.com/brandonsepulveda/toolboxbs/blob/main/docs/catalogo.json) (Catalog JSON)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["ToolboxBS application<br/>[ToolboxBS.ps1]"]
  node_wpf["WPF interface<br/>[ToolboxBS.ps1]"]
  node_console["Console mode<br/>[ToolboxBS.ps1]"]
  node_dashboard["Health dashboard<br/>[ToolboxBS.ps1]"]
  node_routines["One-click routines<br/>[ToolboxBS.ps1]"]
  node_search["Global search<br/>[ToolboxBS.ps1]"]
  node_profiles["Selection profiles<br/>[ToolboxBS.ps1]"]
end

subgraph group_tools["Tool execution"]
  node_catalog["Tool catalog<br/>[ToolboxBS.ps1]"]
  node_toolcode["Tool PowerShell code<br/>[ToolboxBS.ps1]"]
  node_runner["Tool execution<br/>[ToolboxBS.ps1]"]
end

subgraph group_operations["Operations"]
  node_risk["Risk confirmation<br/>[ToolboxBS.ps1]"]
  node_revert["Change reversal<br/>[ToolboxBS.ps1]"]
end

subgraph group_outputs["Generated outputs"]
  node_logging["Session logging<br/>[ToolboxBS.ps1]"]
  node_reports["Reports and backups<br/>[ToolboxBS.ps1]"]
  node_catalog_export["Catalog export<br/>[ToolboxBS.ps1]"]
  node_catalog_file["Catalog JSON<br/>[catalogo.json]"]
end

node_user(("Windows user"))
node_winget["winget"]

node_user -->|"launches"| node_entry
node_entry -->|"uses"| node_catalog
node_catalog -->|"generates interface"| node_wpf
node_catalog -->|"contains"| node_toolcode
node_user -->|"invokes commands"| node_console
node_console -->|"runs tool IDs"| node_runner
node_wpf -->|"executes selection"| node_runner
node_runner -->|"confirms risky actions"| node_risk
node_runner -->|"offers undo actions"| node_revert
node_runner -->|"records output"| node_logging
node_runner -->|"writes reports and backups"| node_reports
node_catalog -->|"drives capabilities"| node_dashboard
node_catalog -->|"drives capabilities"| node_routines
node_catalog -->|"indexes tools"| node_search
node_profiles -->|"saves selections"| node_catalog
node_entry -->|"exports catalog"| node_catalog_export
node_catalog_export -->|"writes JSON"| node_catalog_file
node_runner -.->|"installs applications"| node_winget

click node_entry "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_catalog "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_toolcode "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_runner "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_wpf "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_console "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_dashboard "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_routines "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_search "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_profiles "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_risk "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_revert "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_logging "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_reports "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_catalog_export "https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1"
click node_catalog_file "https://github.com/brandonsepulveda/toolboxbs/blob/main/docs/catalogo.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_entry,node_wpf,node_console,node_dashboard,node_routines,node_search,node_profiles,node_user toneBlue
class node_catalog,node_toolcode,node_runner toneAmber
class node_risk,node_revert toneMint
class node_logging,node_reports,node_catalog_export,node_catalog_file toneRose
class node_winget toneIndigo
```

## Components

### Application

- [ToolboxBS application](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [WPF interface](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Console mode](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Health dashboard](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [One-click routines](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Global search](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Selection profiles](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`

### Tool execution

- [Tool catalog](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Tool PowerShell code](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Tool execution](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`

### Operations

- [Risk confirmation](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Change reversal](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`

### Generated outputs

- [Session logging](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Reports and backups](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Catalog export](https://github.com/brandonsepulveda/toolboxbs/blob/main/src/ToolboxBS.ps1): `src/ToolboxBS.ps1`
- [Catalog JSON](https://github.com/brandonsepulveda/toolboxbs/blob/main/docs/catalogo.json): `docs/catalogo.json`

### Other components

- **Windows user**
- **winget**

## Connections

- Windows user → ToolboxBS application: launches (evidence: `README.md`)
- ToolboxBS application → Tool catalog: uses (evidence: `README.md`)
- Tool catalog → WPF interface: generates interface (evidence: `README.md`)
- Tool catalog → Tool PowerShell code: contains (evidence: `README.md`)
- Windows user → Console mode: invokes commands (evidence: `README.md`)
- Console mode → Tool execution: runs tool IDs (evidence: `README.md`)
- WPF interface → Tool execution: executes selection (evidence: `README.md`)
- Tool execution → Risk confirmation: confirms risky actions (evidence: `README.md`)
- Tool execution → Change reversal: offers undo actions (evidence: `README.md`)
- Tool execution → Session logging: records output (evidence: `README.md`)
- Tool execution → Reports and backups: writes reports and backups (evidence: `README.md`)
- Tool catalog → Health dashboard: drives capabilities (evidence: `README.md`)
- Tool catalog → One-click routines: drives capabilities (evidence: `README.md`)
- Tool catalog → Global search: indexes tools (evidence: `README.md`)
- Selection profiles → Tool catalog: saves selections (evidence: `README.md`)
- ToolboxBS application → Catalog export: exports catalog (evidence: `README.md`)
- Catalog export → Catalog JSON: writes JSON (evidence: `README.md`)
- Tool execution → winget: installs applications (evidence: `README.md`)
