# lintsure/lintsure architecture

> Architecture diagram of the GitHub repository lintsure/lintsure, 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/lintsure/lintsure
- Repository: https://github.com/lintsure/lintsure

## Overview

Lintsure is a local, deterministic code-readiness checker for AI-assisted development. A developer or agent invokes the CLI or MCP server; the core reads project files and selected framework configuration, applies pattern-based rules, maps findings to framework controls, and enriches results with baseline/review state and code reachability. Results can be inspected in CLI/MCP responses or exported as SARIF and a human-reviewed assessment report. The README also documents agent setup and pull-request scanning; those capability branches are shown where supported. Several core modules are indexed but not excerpted, so their internal call links are omitted where not evidenced.

Main entry points: [`packages/core/src/index.ts`](https://github.com/lintsure/lintsure/blob/main/packages/core/src/index.ts) (Config and file discovery), [`packages/core/src/knowledge/index.ts`](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/index.ts) (Framework knowledge), [`packages/core/src/rules/index.ts`](https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/index.ts) (Rule registry), [`packages/cli/src/index.ts`](https://github.com/lintsure/lintsure/blob/main/packages/cli/src/index.ts) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI commands<br/>[index.ts]"]
  node_agent_setup["Agent setup<br/>[agents.ts]"]
  node_mcp["MCP tools<br/>[index.ts]"]
end

subgraph group_analysis["Scan and Rules"]
  node_config_walk["Config and file discovery<br/>[index.ts]"]
  node_rule_engine["Rule registry<br/>[index.ts]"]
  node_owasp_rules["OWASP checks<br/>[owasp.ts]"]
  node_stack_rules["Stack checks<br/>[stack.ts]"]
  node_cra_rules["CRA checks<br/>[cra.ts]"]
  node_standards_rules["Standards checks<br/>[standards.ts]"]
  node_pack_loader["Rule packs<br/>[packs.ts]"]
end

subgraph group_frameworks["Framework Mapping"]
  node_knowledge["Framework knowledge<br/>[index.ts]"]
  node_framework_types["Framework obligations<br/>[types.ts]"]
  node_owasp_knowledge["OWASP mapping<br/>[owasp-top10.ts]"]
  node_cra_knowledge["CRA mapping<br/>[cra.ts]"]
  node_gdpr_knowledge["GDPR mapping<br/>[gdpr.ts]"]
  node_eu_ai_knowledge["EU AI Act mapping<br/>[eu-ai-act.ts]"]
  node_more_knowledge["Other framework maps<br/>[more.ts]"]
end

subgraph group_findings["Finding Lifecycle"]
  node_review_state[("Baseline and acceptance<br/>[review.ts]")]
  node_guidance["Finding guidance<br/>[guidance.ts]"]
  node_record["Run record<br/>[record.ts]"]
  node_reach["Import reachability<br/>[reach.ts]"]
end

subgraph group_outputs["Reports and Integration"]
  node_assessment["Assessment report<br/>[assessment.ts]"]
  node_sarif["SARIF output<br/>[sarif.ts]"]
  node_external_action["GitHub Action"]
end

node_developer(("Developer or agent"))

node_developer -->|"runs commands"| node_cli
node_developer -->|"calls tools"| node_mcp
node_cli -->|"configures agents"| node_agent_setup
node_cli -.->|"scans project"| node_config_walk
node_mcp -.->|"requests scans"| node_config_walk
node_config_walk -.->|"selects checks"| node_rule_engine
node_rule_engine -->|"loads rules"| node_owasp_rules
node_rule_engine -->|"loads rules"| node_stack_rules
node_rule_engine -->|"loads rules"| node_cra_rules
node_rule_engine -->|"loads rules"| node_standards_rules
node_config_walk -.->|"loads configured packs"| node_pack_loader
node_knowledge -->|"registers framework"| node_owasp_knowledge
node_knowledge -->|"registers framework"| node_cra_knowledge
node_knowledge -->|"registers framework"| node_gdpr_knowledge
node_knowledge -->|"registers framework"| node_eu_ai_knowledge
node_knowledge -->|"registers frameworks"| node_more_knowledge
node_knowledge -->|"uses obligation types"| node_framework_types
node_cli -.->|"manages review data"| node_review_state
node_config_walk -->|"applies baseline"| node_review_state
node_config_walk -->|"builds run record"| node_record
node_config_walk -.->|"computes reachability"| node_reach
node_config_walk -.->|"can render report"| node_assessment
node_config_walk -.->|"can export findings"| node_sarif
node_developer -->|"runs PR checks"| node_external_action

click node_cli "https://github.com/lintsure/lintsure/blob/main/packages/cli/src/index.ts"
click node_agent_setup "https://github.com/lintsure/lintsure/blob/main/packages/cli/src/agents.ts"
click node_mcp "https://github.com/lintsure/lintsure/blob/main/packages/mcp/src/index.ts"
click node_config_walk "https://github.com/lintsure/lintsure/blob/main/packages/core/src/index.ts"
click node_rule_engine "https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/index.ts"
click node_owasp_rules "https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/owasp.ts"
click node_stack_rules "https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/stack.ts"
click node_cra_rules "https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/cra.ts"
click node_standards_rules "https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/standards.ts"
click node_knowledge "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/index.ts"
click node_framework_types "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/types.ts"
click node_owasp_knowledge "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/owasp-top10.ts"
click node_cra_knowledge "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/cra.ts"
click node_gdpr_knowledge "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/gdpr.ts"
click node_eu_ai_knowledge "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/eu-ai-act.ts"
click node_more_knowledge "https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/more.ts"
click node_review_state "https://github.com/lintsure/lintsure/blob/main/packages/core/src/review.ts"
click node_guidance "https://github.com/lintsure/lintsure/blob/main/packages/core/src/guidance.ts"
click node_record "https://github.com/lintsure/lintsure/blob/main/packages/core/src/record.ts"
click node_reach "https://github.com/lintsure/lintsure/blob/main/packages/core/src/reach.ts"
click node_assessment "https://github.com/lintsure/lintsure/blob/main/packages/core/src/assessment.ts"
click node_sarif "https://github.com/lintsure/lintsure/blob/main/packages/core/src/sarif.ts"
click node_pack_loader "https://github.com/lintsure/lintsure/blob/main/packages/core/src/packs.ts"

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_agent_setup,node_mcp toneBlue
class node_config_walk,node_rule_engine,node_owasp_rules,node_stack_rules,node_cra_rules,node_standards_rules,node_pack_loader toneAmber
class node_knowledge,node_framework_types,node_owasp_knowledge,node_cra_knowledge,node_gdpr_knowledge,node_eu_ai_knowledge,node_more_knowledge toneMint
class node_review_state,node_guidance,node_record,node_reach toneRose
class node_assessment,node_sarif,node_external_action,node_developer toneIndigo
```

## Components

### User Interfaces

- [CLI commands](https://github.com/lintsure/lintsure/blob/main/packages/cli/src/index.ts): `packages/cli/src/index.ts`
- [Agent setup](https://github.com/lintsure/lintsure/blob/main/packages/cli/src/agents.ts): `packages/cli/src/agents.ts`
- [MCP tools](https://github.com/lintsure/lintsure/blob/main/packages/mcp/src/index.ts): `packages/mcp/src/index.ts`

### Scan and Rules

- [Config and file discovery](https://github.com/lintsure/lintsure/blob/main/packages/core/src/index.ts): `packages/core/src/index.ts`
- [Rule registry](https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/index.ts): `packages/core/src/rules/index.ts`
- [OWASP checks](https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/owasp.ts): `packages/core/src/rules/owasp.ts`
- [Stack checks](https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/stack.ts): `packages/core/src/rules/stack.ts`
- [CRA checks](https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/cra.ts): `packages/core/src/rules/cra.ts`
- [Standards checks](https://github.com/lintsure/lintsure/blob/main/packages/core/src/rules/standards.ts): `packages/core/src/rules/standards.ts`
- [Rule packs](https://github.com/lintsure/lintsure/blob/main/packages/core/src/packs.ts): `packages/core/src/packs.ts`

### Framework Mapping

- [Framework knowledge](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/index.ts): `packages/core/src/knowledge/index.ts`
- [Framework obligations](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/types.ts): `packages/core/src/knowledge/types.ts`
- [OWASP mapping](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/owasp-top10.ts): `packages/core/src/knowledge/owasp-top10.ts`
- [CRA mapping](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/cra.ts): `packages/core/src/knowledge/cra.ts`
- [GDPR mapping](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/gdpr.ts): `packages/core/src/knowledge/gdpr.ts`
- [EU AI Act mapping](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/eu-ai-act.ts): `packages/core/src/knowledge/eu-ai-act.ts`
- [Other framework maps](https://github.com/lintsure/lintsure/blob/main/packages/core/src/knowledge/more.ts): `packages/core/src/knowledge/more.ts`

### Finding Lifecycle

- [Baseline and acceptance](https://github.com/lintsure/lintsure/blob/main/packages/core/src/review.ts): `packages/core/src/review.ts`
- [Finding guidance](https://github.com/lintsure/lintsure/blob/main/packages/core/src/guidance.ts): `packages/core/src/guidance.ts`
- [Run record](https://github.com/lintsure/lintsure/blob/main/packages/core/src/record.ts): `packages/core/src/record.ts`
- [Import reachability](https://github.com/lintsure/lintsure/blob/main/packages/core/src/reach.ts): `packages/core/src/reach.ts`

### Reports and Integration

- [Assessment report](https://github.com/lintsure/lintsure/blob/main/packages/core/src/assessment.ts): `packages/core/src/assessment.ts`
- [SARIF output](https://github.com/lintsure/lintsure/blob/main/packages/core/src/sarif.ts): `packages/core/src/sarif.ts`
- **GitHub Action**

### Other components

- **Developer or agent**

## Connections

- Developer or agent → CLI commands: runs commands (evidence: `README.md`)
- Developer or agent → MCP tools: calls tools (evidence: `README.md`)
- CLI commands → Agent setup: configures agents (evidence: `packages/cli/src/index.ts`)
- CLI commands → Config and file discovery: scans project
- MCP tools → Config and file discovery: requests scans
- Config and file discovery → Rule registry: selects checks (evidence: `packages/core/src/index.ts`)
- Rule registry → OWASP checks: loads rules (evidence: `packages/core/src/rules/index.ts`)
- Rule registry → Stack checks: loads rules (evidence: `packages/core/src/rules/index.ts`)
- Rule registry → CRA checks: loads rules (evidence: `packages/core/src/rules/index.ts`)
- Rule registry → Standards checks: loads rules (evidence: `packages/core/src/rules/index.ts`)
- Config and file discovery → Rule packs: loads configured packs (evidence: `packages/core/src/index.ts`)
- Framework knowledge → OWASP mapping: registers framework (evidence: `packages/core/src/knowledge/index.ts`)
- Framework knowledge → CRA mapping: registers framework (evidence: `packages/core/src/knowledge/index.ts`)
- Framework knowledge → GDPR mapping: registers framework (evidence: `packages/core/src/knowledge/index.ts`)
- Framework knowledge → EU AI Act mapping: registers framework (evidence: `packages/core/src/knowledge/index.ts`)
- Framework knowledge → Other framework maps: registers frameworks (evidence: `packages/core/src/knowledge/index.ts`)
- Framework knowledge → Framework obligations: uses obligation types (evidence: `packages/core/src/knowledge/index.ts`)
- CLI commands → Baseline and acceptance: manages review data
- Config and file discovery → Baseline and acceptance: applies baseline (evidence: `packages/core/src/index.ts`)
- Config and file discovery → Run record: builds run record (evidence: `packages/core/src/index.ts`)
- Config and file discovery → Import reachability: computes reachability (evidence: `packages/core/src/index.ts`)
- Config and file discovery → Assessment report: can render report (evidence: `packages/core/src/index.ts`)
- Config and file discovery → SARIF output: can export findings (evidence: `packages/core/src/index.ts`)
- Developer or agent → GitHub Action: runs PR checks (evidence: `README.md`)
