# kailashchandrasrisatyadev/grc-multiframework-compliance-mapping architecture

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

- Interactive diagram: https://gitdiagram.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping
- Repository: https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping

## Overview

This is a command-line research tool for ranking security-policy statements against ISO/IEC 27001 and NIST SP 800-53 control catalogues. The principal workflow loads configuration and CSV inputs, verifies and loads an offline sentence encoder, builds catalogue embeddings, ranks candidate controls, assigns review bands and audit-priority scores, and exports reviewable results with provenance. Multi-framework mapping reuses statement embeddings but keeps each framework’s index and queue separate; compatible-run comparison is another documented capability. Some CLI wiring and output details are unsampled, so those links are marked unverified.

Main entry points: [`src/grc_mapper/cli.py`](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/cli.py) (Command CLI), [`src/grc_mapper/pipeline.py`](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/pipeline.py) (Mapping pipeline), [`src/grc_mapper/model.py`](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/model.py) (SBERT encoder), [`src/grc_mapper/multiframework.py`](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/multiframework.py) (Multi-framework map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and inputs"]
  node_cli["Command CLI<br/>[cli.py]"]
  node_settings["Settings<br/>[config.py]"]
  node_csv_inputs["CSV inputs<br/>[data.py]"]
  node_text_rules["Text validation<br/>[text.py]"]
end

subgraph group_model["Model and indexing"]
  node_model_check["Model integrity<br/>[integrity.py]"]
  node_offline["Offline loading<br/>[offline.py]"]
  node_encoder["SBERT encoder<br/>[model.py]"]
  node_pipeline["Mapping pipeline<br/>[pipeline.py]"]
end

subgraph group_mapping["Mapping and review"]
  node_framework_specs["Framework specs<br/>[frameworks.py]"]
  node_multi_map["Multi-framework map<br/>[multiframework.py]"]
  node_similarity["Similarity ranking<br/>[mapping.py]"]
  node_scoring["Review scoring<br/>[scoring.py]"]
end

subgraph group_audit["Outputs and audit"]
  node_export["Result export<br/>[export.py]"]
  node_provenance["Run provenance<br/>[provenance.py]"]
  node_history["Run comparison<br/>[history.py]"]
end

node_auditor(("Auditor"))

node_auditor -->|"invokes"| node_cli
node_cli -->|"resolves settings"| node_settings
node_cli -.->|"loads catalogues"| node_csv_inputs
node_csv_inputs -.->|"validates text"| node_text_rules
node_cli -->|"runs mapping"| node_pipeline
node_pipeline -->|"loads encoder"| node_encoder
node_encoder -->|"verifies model"| node_model_check
node_encoder -->|"enforces offline"| node_offline
node_pipeline -->|"ranks candidates"| node_similarity
node_pipeline -->|"scores mappings"| node_scoring
node_cli -.->|"loads framework spec"| node_framework_specs
node_cli -.->|"runs multi-map"| node_multi_map
node_multi_map -->|"ranks per framework"| node_similarity
node_multi_map -->|"scores per framework"| node_scoring
node_cli -.->|"writes results"| node_export
node_cli -.->|"records run"| node_provenance
node_cli -.->|"compares runs"| node_history
node_export -.->|"presents candidates"| node_auditor
node_provenance -.->|"supports audit"| node_auditor

click node_cli "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/cli.py"
click node_settings "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/config.py"
click node_csv_inputs "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/data.py"
click node_text_rules "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/text.py"
click node_model_check "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/integrity.py"
click node_offline "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/offline.py"
click node_encoder "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/model.py"
click node_pipeline "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/pipeline.py"
click node_framework_specs "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/frameworks.py"
click node_multi_map "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/multiframework.py"
click node_similarity "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/mapping.py"
click node_scoring "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/scoring.py"
click node_export "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/export.py"
click node_provenance "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/provenance.py"
click node_history "https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/history.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_cli,node_settings,node_csv_inputs,node_text_rules toneBlue
class node_model_check,node_offline,node_encoder,node_pipeline toneAmber
class node_framework_specs,node_multi_map,node_similarity,node_scoring toneMint
class node_export,node_provenance,node_history toneRose
class node_auditor toneIndigo
```

## Components

### CLI and inputs

- [Command CLI](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/cli.py): `src/grc_mapper/cli.py`
- [Settings](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/config.py): `src/grc_mapper/config.py`
- [CSV inputs](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/data.py): `src/grc_mapper/data.py`
- [Text validation](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/text.py): `src/grc_mapper/text.py`

### Model and indexing

- [Model integrity](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/integrity.py): `src/grc_mapper/integrity.py`
- [Offline loading](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/offline.py): `src/grc_mapper/offline.py`
- [SBERT encoder](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/model.py): `src/grc_mapper/model.py`
- [Mapping pipeline](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/pipeline.py): `src/grc_mapper/pipeline.py`

### Mapping and review

- [Framework specs](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/frameworks.py): `src/grc_mapper/frameworks.py`
- [Multi-framework map](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/multiframework.py): `src/grc_mapper/multiframework.py`
- [Similarity ranking](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/mapping.py): `src/grc_mapper/mapping.py`
- [Review scoring](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/scoring.py): `src/grc_mapper/scoring.py`

### Outputs and audit

- [Result export](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/export.py): `src/grc_mapper/export.py`
- [Run provenance](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/provenance.py): `src/grc_mapper/provenance.py`
- [Run comparison](https://github.com/kailashchandrasrisatyadev/grc-multiframework-compliance-mapping/blob/main/src/grc_mapper/history.py): `src/grc_mapper/history.py`

### Other components

- **Auditor**

## Connections

- Auditor → Command CLI: invokes (evidence: `README.md`)
- Command CLI → Settings: resolves settings (evidence: `src/grc_mapper/cli.py`)
- Command CLI → CSV inputs: loads catalogues (evidence: `src/grc_mapper/cli.py`)
- CSV inputs → Text validation: validates text (evidence: `src/grc_mapper/data.py`)
- Command CLI → Mapping pipeline: runs mapping (evidence: `src/grc_mapper/cli.py`)
- Mapping pipeline → SBERT encoder: loads encoder (evidence: `src/grc_mapper/pipeline.py`)
- SBERT encoder → Model integrity: verifies model (evidence: `src/grc_mapper/model.py`)
- SBERT encoder → Offline loading: enforces offline (evidence: `src/grc_mapper/model.py`)
- Mapping pipeline → Similarity ranking: ranks candidates (evidence: `src/grc_mapper/pipeline.py`)
- Mapping pipeline → Review scoring: scores mappings (evidence: `src/grc_mapper/pipeline.py`)
- Command CLI → Framework specs: loads framework spec (evidence: `src/grc_mapper/cli.py`)
- Command CLI → Multi-framework map: runs multi-map (evidence: `src/grc_mapper/cli.py`)
- Multi-framework map → Similarity ranking: ranks per framework (evidence: `src/grc_mapper/multiframework.py`)
- Multi-framework map → Review scoring: scores per framework (evidence: `src/grc_mapper/multiframework.py`)
- Command CLI → Result export: writes results (evidence: `src/grc_mapper/cli.py`)
- Command CLI → Run provenance: records run (evidence: `src/grc_mapper/cli.py`)
- Command CLI → Run comparison: compares runs (evidence: `src/grc_mapper/cli.py`)
- Result export → Auditor: presents candidates
- Run provenance → Auditor: supports audit
