# xuehai888/st_sap_agent architecture

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

- Interactive diagram: https://gitdiagram.com/xuehai888/st_sap_agent
- Repository: https://github.com/xuehai888/st_sap_agent

## Overview

This repository is a clinical-trial statistical-programming agent spanning SAP document generation, SDTM/ADaM/TFL SAS program generation, SAS execution and QC, BE analysis, and statistical review. The main user-to-result path is a study request through SAP metadata/rule/template processing to a generated document; other README-documented capabilities form parallel branches. The graph preserves the central runtime modules and the substantial QC, BE, and document-processing subsystems. Some subsystem links reflect README descriptions because their source was not sampled; uncertain implementation-level connections are omitted.

Main entry points: [`skills/sas-validation/scripts/run_full_validation.py`](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/run_full_validation.py) (QC orchestrator), [`skills/be_analysis_skill/core.py`](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/core.py) (BE analysis), [`pipeline/all_docx_pipelines.py`](https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/all_docx_pipelines.py) (SAP pipeline), [`pipeline/docx_pipeline.py`](https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/docx_pipeline.py) (Document pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["SAP planning"]
  node_sap_pipeline["SAP pipeline"]
  node_docx_pipeline["Document pipeline<br/>[docx_pipeline.py]"]
  node_pipeline_core["Metadata and rules<br/>[pipeline_core.py]"]
  node_sap_engine["SAP generator<br/>[engine.py]"]
end

subgraph group_programming["Program generation"]
  node_sdtm_generator["SDTM generator<br/>[generator.py]"]
  node_adam_generator["ADaM generator<br/>[generator.py]"]
  node_tfl_generator["TFL generator<br/>[generator.py]"]
end

subgraph group_execution["SAS and QC"]
  node_sas_executor["SAS executor<br/>[run_sas.py]"]
  node_qc_runner["QC orchestrator"]
  node_qc_scanner["Project scanner<br/>[scan_project.py]"]
  node_qc_generator["Validation generator<br/>[generate_sas.py]"]
  node_qc_batch["Validation execution<br/>[run_sas_batch.py]"]
  node_qc_compare["Output comparison<br/>[cross_compare.py]"]
  node_qc_report["QC report<br/>[build_report.py]"]
end

subgraph group_analysis["BE and review"]
  node_be_core["BE analysis<br/>[core.py]"]
  node_be_plots["BE plots<br/>[be_plots.py]"]
  node_be_report["BE report<br/>[be_report.py]"]
  node_wnl_export["WinNonlin export<br/>[data_exporter.py]"]
  node_wnl_guide["WinNonlin guide<br/>[guide_generator.py]"]
  node_wnl_compare["Engine comparison<br/>[result_comparer.py]"]
  node_stat_review["Statistical review<br/>[engine.py]"]
end

subgraph group_documents["Document infrastructure"]
  node_template_ingest["Template ingestion<br/>[ingest.py]"]
  node_template_generator["Document generator<br/>[docx_generator.py]"]
  node_docx_formatter["DOCX formatter<br/>[docx_formatter.py]"]
  node_docx_validator["DOCX validation<br/>[docx.py]"]
end

node_requester(("Study requester"))

node_requester -->|"requests SAP"| node_sap_pipeline
node_sap_pipeline -->|"specializes"| node_docx_pipeline
node_docx_pipeline -->|"uses core"| node_pipeline_core
node_requester -.->|"requests SAP"| node_sap_engine
node_requester -->|"requests mapping"| node_sdtm_generator
node_requester -->|"requests derivation"| node_adam_generator
node_requester -->|"requests TFL"| node_tfl_generator
node_requester -->|"runs programs"| node_sas_executor
node_requester -->|"requests QC"| node_qc_runner
node_qc_runner -->|"scans project"| node_qc_scanner
node_qc_runner -->|"generates checks"| node_qc_generator
node_qc_runner -->|"runs programs"| node_qc_batch
node_qc_runner -->|"compares outputs"| node_qc_compare
node_qc_runner -->|"builds report"| node_qc_report
node_requester -->|"requests analysis"| node_be_core
node_be_core -.->|"produces plots"| node_be_plots
node_be_core -.->|"produces report"| node_be_report
node_be_core -->|"exports data"| node_wnl_export
node_requester -.->|"requests guide"| node_wnl_guide
node_requester -.->|"requests comparison"| node_wnl_compare
node_requester -->|"requests review"| node_stat_review
node_requester -.->|"provides templates"| node_template_ingest
node_template_generator -->|"formats document"| node_docx_formatter
node_requester -.->|"requests document"| node_template_generator
node_requester -.->|"validates document"| node_docx_validator

click node_sap_pipeline "https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/all_docx_pipelines.py"
click node_docx_pipeline "https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/docx_pipeline.py"
click node_pipeline_core "https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/pipeline_core.py"
click node_sap_engine "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sap-generator/engine.py"
click node_sdtm_generator "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sdtm-program-generator/generator.py"
click node_adam_generator "https://github.com/xuehai888/st_sap_agent/blob/main/skills/adam-program-generator/generator.py"
click node_tfl_generator "https://github.com/xuehai888/st_sap_agent/blob/main/skills/tfl-program-generator/generator.py"
click node_sas_executor "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-executor/run_sas.py"
click node_qc_runner "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/run_full_validation.py"
click node_qc_scanner "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/scan_project.py"
click node_qc_generator "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/generate_sas.py"
click node_qc_batch "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/run_sas_batch.py"
click node_qc_compare "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/cross_compare.py"
click node_qc_report "https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/build_report.py"
click node_be_core "https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/core.py"
click node_be_plots "https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/be_plots.py"
click node_be_report "https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/be_report.py"
click node_wnl_export "https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/winnonlin_bridge/data_exporter.py"
click node_wnl_guide "https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/winnonlin_bridge/guide_generator.py"
click node_wnl_compare "https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/winnonlin_bridge/result_comparer.py"
click node_stat_review "https://github.com/xuehai888/st_sap_agent/blob/main/skills/statistical-review/engine.py"
click node_template_ingest "https://github.com/xuehai888/st_sap_agent/blob/main/skills/template_engine/ingest.py"
click node_template_generator "https://github.com/xuehai888/st_sap_agent/blob/main/skills/template_engine/docx_generator.py"
click node_docx_formatter "https://github.com/xuehai888/st_sap_agent/blob/main/skills/template_engine/docx_formatter.py"
click node_docx_validator "https://github.com/xuehai888/st_sap_agent/blob/main/skills/docx/scripts/office/validators/docx.py"

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_sap_pipeline,node_docx_pipeline,node_pipeline_core,node_sap_engine toneBlue
class node_sdtm_generator,node_adam_generator,node_tfl_generator toneAmber
class node_sas_executor,node_qc_runner,node_qc_scanner,node_qc_generator,node_qc_batch,node_qc_compare,node_qc_report,node_requester toneMint
class node_be_core,node_be_plots,node_be_report,node_wnl_export,node_wnl_guide,node_wnl_compare,node_stat_review toneRose
class node_template_ingest,node_template_generator,node_docx_formatter,node_docx_validator toneIndigo
```

## Components

### SAP planning

- [SAP pipeline](https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/all_docx_pipelines.py): `pipeline/all_docx_pipelines.py`
- [Document pipeline](https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/docx_pipeline.py): `pipeline/docx_pipeline.py`
- [Metadata and rules](https://github.com/xuehai888/st_sap_agent/blob/main/pipeline/pipeline_core.py): `pipeline/pipeline_core.py`
- [SAP generator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sap-generator/engine.py): `skills/sap-generator/engine.py`

### Program generation

- [SDTM generator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sdtm-program-generator/generator.py): `skills/sdtm-program-generator/generator.py`
- [ADaM generator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/adam-program-generator/generator.py): `skills/adam-program-generator/generator.py`
- [TFL generator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/tfl-program-generator/generator.py): `skills/tfl-program-generator/generator.py`

### SAS and QC

- [SAS executor](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-executor/run_sas.py): `skills/sas-executor/run_sas.py`
- [QC orchestrator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/run_full_validation.py): `skills/sas-validation/scripts/run_full_validation.py`
- [Project scanner](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/scan_project.py): `skills/sas-validation/scripts/scan_project.py`
- [Validation generator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/generate_sas.py): `skills/sas-validation/scripts/generate_sas.py`
- [Validation execution](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/run_sas_batch.py): `skills/sas-validation/scripts/run_sas_batch.py`
- [Output comparison](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/cross_compare.py): `skills/sas-validation/scripts/cross_compare.py`
- [QC report](https://github.com/xuehai888/st_sap_agent/blob/main/skills/sas-validation/scripts/build_report.py): `skills/sas-validation/scripts/build_report.py`

### BE and review

- [BE analysis](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/core.py): `skills/be_analysis_skill/core.py`
- [BE plots](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/be_plots.py): `skills/be_analysis_skill/be_plots.py`
- [BE report](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/be_report.py): `skills/be_analysis_skill/be_report.py`
- [WinNonlin export](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/winnonlin_bridge/data_exporter.py): `skills/be_analysis_skill/winnonlin_bridge/data_exporter.py`
- [WinNonlin guide](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/winnonlin_bridge/guide_generator.py): `skills/be_analysis_skill/winnonlin_bridge/guide_generator.py`
- [Engine comparison](https://github.com/xuehai888/st_sap_agent/blob/main/skills/be_analysis_skill/winnonlin_bridge/result_comparer.py): `skills/be_analysis_skill/winnonlin_bridge/result_comparer.py`
- [Statistical review](https://github.com/xuehai888/st_sap_agent/blob/main/skills/statistical-review/engine.py): `skills/statistical-review/engine.py`

### Document infrastructure

- [Template ingestion](https://github.com/xuehai888/st_sap_agent/blob/main/skills/template_engine/ingest.py): `skills/template_engine/ingest.py`
- [Document generator](https://github.com/xuehai888/st_sap_agent/blob/main/skills/template_engine/docx_generator.py): `skills/template_engine/docx_generator.py`
- [DOCX formatter](https://github.com/xuehai888/st_sap_agent/blob/main/skills/template_engine/docx_formatter.py): `skills/template_engine/docx_formatter.py`
- [DOCX validation](https://github.com/xuehai888/st_sap_agent/blob/main/skills/docx/scripts/office/validators/docx.py): `skills/docx/scripts/office/validators/docx.py`

### Other components

- **Study requester**

## Connections

- Study requester → SAP pipeline: requests SAP (evidence: `README.md`)
- SAP pipeline → Document pipeline: specializes (evidence: `pipeline/all_docx_pipelines.py`)
- Document pipeline → Metadata and rules: uses core (evidence: `pipeline/docx_pipeline.py`)
- Study requester → SAP generator: requests SAP (evidence: `README.md`)
- Study requester → SDTM generator: requests mapping (evidence: `README.md`)
- Study requester → ADaM generator: requests derivation (evidence: `README.md`)
- Study requester → TFL generator: requests TFL (evidence: `README.md`)
- Study requester → SAS executor: runs programs (evidence: `README.md`)
- Study requester → QC orchestrator: requests QC (evidence: `README.md`)
- QC orchestrator → Project scanner: scans project (evidence: `skills/sas-validation/scripts/run_full_validation.py`)
- QC orchestrator → Validation generator: generates checks (evidence: `skills/sas-validation/scripts/run_full_validation.py`)
- QC orchestrator → Validation execution: runs programs (evidence: `skills/sas-validation/scripts/run_full_validation.py`)
- QC orchestrator → Output comparison: compares outputs (evidence: `skills/sas-validation/scripts/run_full_validation.py`)
- QC orchestrator → QC report: builds report (evidence: `skills/sas-validation/scripts/run_full_validation.py`)
- Study requester → BE analysis: requests analysis (evidence: `README.md`)
- BE analysis → BE plots: produces plots (evidence: `README.md`)
- BE analysis → BE report: produces report (evidence: `README.md`)
- BE analysis → WinNonlin export: exports data (evidence: `skills/be_analysis_skill/winnonlin_bridge/data_exporter.py`)
- Study requester → WinNonlin guide: requests guide (evidence: `README.md`)
- Study requester → Engine comparison: requests comparison (evidence: `README.md`)
- Study requester → Statistical review: requests review (evidence: `README.md`)
- Study requester → Template ingestion: provides templates (evidence: `README.md`)
- Document generator → DOCX formatter: formats document (evidence: `skills/template_engine/docx_generator.py`)
- Study requester → Document generator: requests document (evidence: `README.md`)
- Study requester → DOCX validation: validates document (evidence: `README.md`)
