# gideon-taylor/pivet architecture

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

- Interactive diagram: https://gitdiagram.com/gideon-taylor/pivet
- Repository: https://github.com/gideon-taylor/pivet

## Overview

Pivet is a PeopleSoft definition version-control utility. Its principal workflow loads configured jobs, connects to an environment, runs profile-selected extractors to write definitions into a working directory, then commits and optionally pushes the resulting Git changes. Configuration editing and raw-data formatting are additional capabilities. The README documents the overall job sequence; the sampled source and SOURCE INDEX show key runtime calls and plugin discovery, but not every processor’s internal database queries or the complete remote-push implementation.

Main entry points: [`Pivet/Data/JobRunner.cs`](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/JobRunner.cs) (Job runner), [`Pivet/Program.cs`](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Program.cs) (CLI and GUI entry), [`Pivet/Data/Processors/RawDataProcessor.cs`](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/RawDataProcessor.cs) (Raw data extraction), [`Pivet/GUI`](https://github.com/gideon-taylor/pivet/tree/master/Pivet/GUI) (Config editors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Job runtime"]
  node_entry["CLI and GUI entry<br/>[Program.cs]"]
  node_runner["Job runner<br/>[JobRunner.cs]"]
  node_connection["Connection provider"]
  node_changed["Changed-file records<br/>[ChangedItem.cs]"]
end

subgraph group_extract["Definition extraction"]
  node_processorapi["Processor contract<br/>[IDataProcessor.cs]"]
  node_html["HTML extraction<br/>[HTMLProcessor.cs]"]
  node_messages["Message catalog extraction"]
  node_peoplecode["PeopleCode extraction"]
  node_sql["SQL extraction<br/>[SQLProcessor.cs]"]
  node_styles["Stylesheet extraction"]
  node_translate["Translate extraction"]
  node_registry["Content references"]
  node_raw["Raw data extraction"]
  node_formatters["Raw data formatters"]
  node_formatterservice["Formatter discovery"]
  node_rawdb["Raw data database service"]
end

subgraph group_config["Configuration tools"]
  node_configmodel["Job configuration<br/>[Config.cs]"]
  node_builder["Config builder<br/>[ConfigBuilder.cs]"]
  node_validator["Config validation<br/>[ConfigValidator.cs]"]
  node_editors["Config editors"]
end

subgraph group_git["Version control"]
  node_version["Git repository manager"]
end

node_operator(("Operator"))
node_oracle[("PeopleSoft database")]

node_operator -->|"runs"| node_entry
node_entry -->|"loads config"| node_configmodel
node_entry -->|"starts builder"| node_builder
node_builder -->|"creates config"| node_configmodel
node_entry -->|"runs jobs"| node_runner
node_entry -->|"opens editors"| node_editors
node_editors -->|"validates config"| node_validator
node_editors -->|"edits config"| node_configmodel
node_runner -->|"creates provider"| node_connection
node_connection -->|"connects"| node_oracle
node_runner -->|"invokes processors"| node_processorapi
node_runner -.->|"selects by profile"| node_html
node_runner -.->|"selects by profile"| node_messages
node_runner -.->|"selects by profile"| node_peoplecode
node_runner -.->|"selects by profile"| node_sql
node_runner -.->|"selects by profile"| node_styles
node_runner -.->|"selects by profile"| node_translate
node_runner -.->|"selects by profile"| node_registry
node_runner -->|"runs raw processor"| node_raw
node_raw -->|"formats output"| node_formatters
node_formatterservice -->|"discovers formatters"| node_formatters
node_raw -.->|"uses data service"| node_rawdb
node_runner -->|"updates repository"| node_version
node_runner -->|"collects changes"| node_changed
node_version -.->|"pushes remote"| node_oracle

click node_entry "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Program.cs"
click node_configmodel "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Config.cs"
click node_builder "https://github.com/gideon-taylor/pivet/blob/master/Pivet/ConfigBuilder.cs"
click node_validator "https://github.com/gideon-taylor/pivet/blob/master/Pivet/GUI/ConfigValidator.cs"
click node_editors "https://github.com/gideon-taylor/pivet/tree/master/Pivet/GUI"
click node_runner "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/JobRunner.cs"
click node_connection "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Connection/IConnectionProvider.cs"
click node_processorapi "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/IDataProcessor.cs"
click node_html "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/HTMLProcessor.cs"
click node_messages "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/MessageCatalogProcessor.cs"
click node_peoplecode "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/PeopleCodeProcessor.cs"
click node_sql "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/SQLProcessor.cs"
click node_styles "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/StylesheetProcessor.cs"
click node_translate "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/TranslateValueProcessor.cs"
click node_registry "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/RegistryProcessor.cs"
click node_raw "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/RawDataProcessor.cs"
click node_formatters "https://github.com/gideon-taylor/pivet/tree/master/Pivet/Data/Formatters"
click node_formatterservice "https://github.com/gideon-taylor/pivet/blob/master/Pivet/GUI/RawDataFormatterService.cs"
click node_changed "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/ChangedItem.cs"
click node_version "https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/VersionController.cs"
click node_rawdb "https://github.com/gideon-taylor/pivet/blob/master/Pivet/RawDataDatabaseService.cs"

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_runner,node_connection,node_changed toneBlue
class node_processorapi,node_html,node_messages,node_peoplecode,node_sql,node_styles,node_translate,node_registry,node_raw,node_formatters,node_formatterservice,node_rawdb,node_oracle toneAmber
class node_configmodel,node_builder,node_validator,node_editors toneMint
class node_version toneRose
class node_operator toneIndigo
```

## Components

### Job runtime

- [CLI and GUI entry](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Program.cs): `Pivet/Program.cs`
- [Job runner](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/JobRunner.cs): `Pivet/Data/JobRunner.cs`
- [Connection provider](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Connection/IConnectionProvider.cs): `Pivet/Data/Connection/IConnectionProvider.cs`
- [Changed-file records](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/ChangedItem.cs): `Pivet/Data/ChangedItem.cs`

### Definition extraction

- [Processor contract](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/IDataProcessor.cs): `Pivet/Data/Processors/IDataProcessor.cs`
- [HTML extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/HTMLProcessor.cs): `Pivet/Data/Processors/HTMLProcessor.cs`
- [Message catalog extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/MessageCatalogProcessor.cs): `Pivet/Data/Processors/MessageCatalogProcessor.cs`
- [PeopleCode extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/PeopleCodeProcessor.cs): `Pivet/Data/Processors/PeopleCodeProcessor.cs`
- [SQL extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/SQLProcessor.cs): `Pivet/Data/Processors/SQLProcessor.cs`
- [Stylesheet extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/StylesheetProcessor.cs): `Pivet/Data/Processors/StylesheetProcessor.cs`
- [Translate extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/TranslateValueProcessor.cs): `Pivet/Data/Processors/TranslateValueProcessor.cs`
- [Content references](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/RegistryProcessor.cs): `Pivet/Data/Processors/RegistryProcessor.cs`
- [Raw data extraction](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/Processors/RawDataProcessor.cs): `Pivet/Data/Processors/RawDataProcessor.cs`
- [Raw data formatters](https://github.com/gideon-taylor/pivet/tree/master/Pivet/Data/Formatters): `Pivet/Data/Formatters`
- [Formatter discovery](https://github.com/gideon-taylor/pivet/blob/master/Pivet/GUI/RawDataFormatterService.cs): `Pivet/GUI/RawDataFormatterService.cs`
- [Raw data database service](https://github.com/gideon-taylor/pivet/blob/master/Pivet/RawDataDatabaseService.cs): `Pivet/RawDataDatabaseService.cs`

### Configuration tools

- [Job configuration](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Config.cs): `Pivet/Config.cs`
- [Config builder](https://github.com/gideon-taylor/pivet/blob/master/Pivet/ConfigBuilder.cs): `Pivet/ConfigBuilder.cs`
- [Config validation](https://github.com/gideon-taylor/pivet/blob/master/Pivet/GUI/ConfigValidator.cs): `Pivet/GUI/ConfigValidator.cs`
- [Config editors](https://github.com/gideon-taylor/pivet/tree/master/Pivet/GUI): `Pivet/GUI`

### Version control

- [Git repository manager](https://github.com/gideon-taylor/pivet/blob/master/Pivet/Data/VersionController.cs): `Pivet/Data/VersionController.cs`

### Other components

- **Operator**
- **PeopleSoft database**

## Connections

- Operator → CLI and GUI entry: runs (evidence: `README.md`)
- CLI and GUI entry → Job configuration: loads config (evidence: `Pivet/Program.cs`)
- CLI and GUI entry → Config builder: starts builder (evidence: `Pivet/Program.cs`)
- Config builder → Job configuration: creates config (evidence: `Pivet/ConfigBuilder.cs`)
- CLI and GUI entry → Job runner: runs jobs (evidence: `Pivet/Program.cs`)
- CLI and GUI entry → Config editors: opens editors (evidence: `Pivet/Program.cs`)
- Config editors → Config validation: validates config (evidence: `Pivet/GUI/EnvironmentEditorWindow.cs`)
- Config editors → Job configuration: edits config (evidence: `Pivet/GUI/EnvironmentEditorWindow.cs`)
- Job runner → Connection provider: creates provider (evidence: `Pivet/Data/JobRunner.cs`)
- Connection provider → PeopleSoft database: connects
- Job runner → Processor contract: invokes processors (evidence: `Pivet/Data/JobRunner.cs`)
- Job runner → HTML extraction: selects by profile (evidence: `README.md`)
- Job runner → Message catalog extraction: selects by profile (evidence: `README.md`)
- Job runner → PeopleCode extraction: selects by profile (evidence: `README.md`)
- Job runner → SQL extraction: selects by profile (evidence: `README.md`)
- Job runner → Stylesheet extraction: selects by profile (evidence: `README.md`)
- Job runner → Translate extraction: selects by profile (evidence: `README.md`)
- Job runner → Content references: selects by profile (evidence: `README.md`)
- Job runner → Raw data extraction: runs raw processor (evidence: `Pivet/Data/JobRunner.cs`)
- Raw data extraction → Raw data formatters: formats output (evidence: `Pivet/Data/Processors/RawDataProcessor.cs`)
- Formatter discovery → Raw data formatters: discovers formatters (evidence: `Pivet/GUI/RawDataFormatterService.cs`)
- Raw data extraction → Raw data database service: uses data service (evidence: `Pivet/RawDataDatabaseService.cs`)
- Job runner → Git repository manager: updates repository (evidence: `README.md`)
- Job runner → Changed-file records: collects changes (evidence: `Pivet/Data/JobRunner.cs`)
- Git repository manager → PeopleSoft database: pushes remote (evidence: `README.md`)
