# rama-l7/rta-constraint-intelligence architecture

> Architecture diagram of the GitHub repository rama-l7/rta-constraint-intelligence, 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/rama-l7/rta-constraint-intelligence
- Repository: https://github.com/rama-l7/rta-constraint-intelligence

## Overview

Ṛta is a deterministic SDC constraint-quality tool that analyzes timing intent before external STA; it is not an STA signoff engine. The main workflow accepts SDC through CLI, HTTP/API, or the legacy Streamlit UI, runs rule and contextual analyses, and presents findings and reports. Separate capabilities include SDC generation, conversion and linting, semantic/readiness diffs, coverage, clock and interaction analysis, and multi-corner management. Edges rely on README statements, SOURCE INDEX references, or shown excerpts; some feature wiring is documented rather than sampled directly.

Main entry points: [`rta/engine/rules/checker.py`](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/rules/checker.py) (SDC checker), [`rta/cli/cli.py`](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/cli/cli.py) (CLI), [`rta/api/api_server.py`](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/api/api_server.py) (HTTP API), [`rta/engine/preprocess/sdc_preprocess.py`](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/preprocess/sdc_preprocess.py) (SDC preprocessing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_surfaces["Product surfaces"]
  node_cli["CLI<br/>[cli.py]"]
  node_api["HTTP API<br/>[api_server.py]"]
  node_mcp["MCP adapter<br/>[mcp_server.py]"]
  node_streamlit["Streamlit UI<br/>[app.py]"]
end

subgraph group_analysis["Constraint analysis"]
  node_checker["SDC checker<br/>[checker.py]"]
  node_rules["Rules registry<br/>[rules_registry.py]"]
  node_preprocess["SDC preprocessing<br/>[sdc_preprocess.py]"]
  node_context["Design context<br/>[design_context.py]"]
  node_coverage["Constraint coverage<br/>[coverage.py]"]
  node_designcov["Design coverage<br/>[design_coverage.py]"]
  node_clock["Clock relations<br/>[clock_relations.py]"]
  node_interactions["Constraint interactions"]
  node_readiness["Readiness analysis"]
end

subgraph group_engineering["SDC engineering tools"]
  node_generator["SDC generator<br/>[generator.py]"]
  node_converter["SDC converter<br/>[converter.py]"]
  node_linter["SDC linter<br/>[linter.py]"]
  node_corners["Corner manager<br/>[corner_manager.py]"]
end

subgraph group_results["Comparison and output"]
  node_diff["Constraint diff<br/>[constraint_diff.py]"]
  node_readinessdiff["Readiness diff<br/>[readiness_diff.py]"]
  node_policy["CI policy gate<br/>[policy_engine.py]"]
  node_reporter["Report renderer<br/>[reporter.py]"]
end

node_engineer(("Engineer / CI"))
node_sta["External STA"]

node_engineer -->|"runs commands"| node_cli
node_engineer -->|"sends requests"| node_api
node_engineer -->|"uses UI"| node_streamlit
node_engineer -->|"uses tools"| node_mcp
node_cli -->|"invokes checks"| node_checker
node_api -->|"analyzes SDC"| node_checker
node_streamlit -->|"checks constraints"| node_checker
node_mcp -->|"adapts backend"| node_api
node_checker -->|"uses rules"| node_rules
node_checker -->|"preprocesses input"| node_preprocess
node_checker -->|"resolves design"| node_context
node_checker -->|"analyzes clocks"| node_clock
node_checker -->|"measures design coverage"| node_designcov
node_checker -->|"checks interactions"| node_interactions
node_checker -.->|"assesses readiness"| node_readiness
node_preprocess -->|"feeds coverage"| node_coverage
node_preprocess -->|"feeds analysis"| node_designcov
node_preprocess -->|"supports resolution"| node_context
node_cli -->|"generates SDC"| node_generator
node_cli -->|"converts SDC"| node_converter
node_cli -->|"lints SDC"| node_linter
node_cli -->|"manages corners"| node_corners
node_api -->|"generates SDC"| node_generator
node_api -->|"converts SDC"| node_converter
node_api -->|"lints SDC"| node_linter
node_api -->|"analyzes corners"| node_corners
node_cli -->|"compares constraints"| node_diff
node_api -->|"compares constraints"| node_diff
node_cli -->|"compares readiness"| node_readinessdiff
node_api -->|"compares readiness"| node_readinessdiff
node_cli -->|"evaluates gate"| node_policy
node_readinessdiff -->|"supplies comparison"| node_policy
node_api -->|"renders report"| node_reporter
node_cli -->|"renders report"| node_reporter
node_streamlit -->|"compares constraints"| node_diff
node_sta -.->|"runs afterward"| node_checker

click node_cli "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/cli/cli.py"
click node_api "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/api/api_server.py"
click node_mcp "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/api/mcp_server.py"
click node_streamlit "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/legacy/streamlit/app.py"
click node_checker "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/rules/checker.py"
click node_rules "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/rules/rules_registry.py"
click node_preprocess "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/preprocess/sdc_preprocess.py"
click node_context "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/context/design_context.py"
click node_coverage "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/coverage.py"
click node_designcov "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/design_coverage.py"
click node_clock "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/clock_relations.py"
click node_interactions "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/constraint_interactions.py"
click node_readiness "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/constraint_readiness.py"
click node_generator "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/generate/generator.py"
click node_converter "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/convert/converter.py"
click node_linter "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/lint/linter.py"
click node_corners "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/corners/corner_manager.py"
click node_diff "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/diff/constraint_diff.py"
click node_readinessdiff "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/diff/readiness_diff.py"
click node_policy "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/policy/policy_engine.py"
click node_reporter "https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/report/reporter.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_api,node_mcp,node_streamlit toneBlue
class node_checker,node_rules,node_preprocess,node_context,node_coverage,node_designcov,node_clock,node_interactions,node_readiness toneAmber
class node_generator,node_converter,node_linter,node_corners toneMint
class node_diff,node_readinessdiff,node_policy,node_reporter toneRose
class node_engineer,node_sta toneIndigo
```

## Components

### Product surfaces

- [CLI](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/cli/cli.py): `rta/cli/cli.py`
- [HTTP API](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/api/api_server.py): `rta/api/api_server.py`
- [MCP adapter](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/api/mcp_server.py): `rta/api/mcp_server.py`
- [Streamlit UI](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/legacy/streamlit/app.py): `legacy/streamlit/app.py`

### Constraint analysis

- [SDC checker](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/rules/checker.py): `rta/engine/rules/checker.py`
- [Rules registry](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/rules/rules_registry.py): `rta/engine/rules/rules_registry.py`
- [SDC preprocessing](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/preprocess/sdc_preprocess.py): `rta/engine/preprocess/sdc_preprocess.py`
- [Design context](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/context/design_context.py): `rta/engine/context/design_context.py`
- [Constraint coverage](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/coverage.py): `rta/engine/analysis/coverage.py`
- [Design coverage](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/design_coverage.py): `rta/engine/analysis/design_coverage.py`
- [Clock relations](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/clock_relations.py): `rta/engine/analysis/clock_relations.py`
- [Constraint interactions](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/constraint_interactions.py): `rta/engine/analysis/constraint_interactions.py`
- [Readiness analysis](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/analysis/constraint_readiness.py): `rta/engine/analysis/constraint_readiness.py`

### SDC engineering tools

- [SDC generator](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/generate/generator.py): `rta/tools/generate/generator.py`
- [SDC converter](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/convert/converter.py): `rta/tools/convert/converter.py`
- [SDC linter](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/lint/linter.py): `rta/tools/lint/linter.py`
- [Corner manager](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/corners/corner_manager.py): `rta/tools/corners/corner_manager.py`

### Comparison and output

- [Constraint diff](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/diff/constraint_diff.py): `rta/engine/diff/constraint_diff.py`
- [Readiness diff](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/diff/readiness_diff.py): `rta/engine/diff/readiness_diff.py`
- [CI policy gate](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/engine/policy/policy_engine.py): `rta/engine/policy/policy_engine.py`
- [Report renderer](https://github.com/rama-l7/rta-constraint-intelligence/blob/main/rta/tools/report/reporter.py): `rta/tools/report/reporter.py`

### Other components

- **Engineer / CI**
- **External STA**

## Connections

- Engineer / CI → CLI: runs commands
- Engineer / CI → HTTP API: sends requests (evidence: `rta/api/api_server.py`)
- Engineer / CI → Streamlit UI: uses UI
- Engineer / CI → MCP adapter: uses tools
- CLI → SDC checker: invokes checks (evidence: `rta/cli/cli.py`)
- HTTP API → SDC checker: analyzes SDC (evidence: `rta/api/api_server.py`)
- Streamlit UI → SDC checker: checks constraints (evidence: `legacy/streamlit/app.py`)
- MCP adapter → HTTP API: adapts backend (evidence: `rta/api/mcp_server.py`)
- SDC checker → Rules registry: uses rules (evidence: `rta/engine/rules/checker.py`)
- SDC checker → SDC preprocessing: preprocesses input (evidence: `rta/engine/rules/checker.py`)
- SDC checker → Design context: resolves design (evidence: `rta/engine/rules/checker.py`)
- SDC checker → Clock relations: analyzes clocks (evidence: `rta/engine/rules/checker.py`)
- SDC checker → Design coverage: measures design coverage (evidence: `rta/engine/rules/checker.py`)
- SDC checker → Constraint interactions: checks interactions (evidence: `rta/engine/rules/checker.py`)
- SDC checker → Readiness analysis: assesses readiness
- SDC preprocessing → Constraint coverage: feeds coverage (evidence: `rta/engine/analysis/coverage.py`)
- SDC preprocessing → Design coverage: feeds analysis (evidence: `rta/engine/analysis/design_coverage.py`)
- SDC preprocessing → Design context: supports resolution (evidence: `rta/engine/context/design_context.py`)
- CLI → SDC generator: generates SDC (evidence: `rta/cli/cli.py`)
- CLI → SDC converter: converts SDC (evidence: `rta/cli/cli.py`)
- CLI → SDC linter: lints SDC (evidence: `rta/cli/cli.py`)
- CLI → Corner manager: manages corners (evidence: `rta/cli/cli.py`)
- HTTP API → SDC generator: generates SDC (evidence: `rta/api/api_server.py`)
- HTTP API → SDC converter: converts SDC (evidence: `rta/api/api_server.py`)
- HTTP API → SDC linter: lints SDC (evidence: `rta/api/api_server.py`)
- HTTP API → Corner manager: analyzes corners (evidence: `rta/api/api_server.py`)
- CLI → Constraint diff: compares constraints (evidence: `rta/cli/cli.py`)
- HTTP API → Constraint diff: compares constraints (evidence: `rta/api/api_server.py`)
- CLI → Readiness diff: compares readiness (evidence: `rta/cli/cli.py`)
- HTTP API → Readiness diff: compares readiness (evidence: `rta/api/api_server.py`)
- CLI → CI policy gate: evaluates gate (evidence: `rta/cli/cli.py`)
- Readiness diff → CI policy gate: supplies comparison (evidence: `rta/engine/policy/policy_engine.py`)
- HTTP API → Report renderer: renders report (evidence: `rta/api/api_server.py`)
- CLI → Report renderer: renders report (evidence: `rta/cli/cli.py`)
- Streamlit UI → Constraint diff: compares constraints (evidence: `legacy/streamlit/app.py`)
- External STA → SDC checker: runs afterward
