How lintsure/lintsure works
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: src/index.ts Config and file discovery · knowledge/index.ts Framework knowledge · rules/index.ts Rule registry · src/index.ts CLI commands
Components 25
User Interfaces
- CLI commands
packages/cli/src/index.ts - Agent setup
packages/cli/src/agents.ts - MCP tools
packages/mcp/src/index.ts
Scan and Rules
- Config and file discovery
packages/core/src/index.ts - Rule registry
packages/core/src/rules/index.ts - OWASP checks
packages/core/src/rules/owasp.ts - Stack checks
packages/core/src/rules/stack.ts - CRA checks
packages/core/src/rules/cra.ts - Standards checks
packages/core/src/rules/standards.ts - Rule packs
packages/core/src/packs.ts
Framework Mapping
- Framework knowledge
packages/core/src/knowledge/index.ts - Framework obligations
packages/core/src/knowledge/types.ts - OWASP mapping
packages/core/src/knowledge/owasp-top10.ts - CRA mapping
packages/core/src/knowledge/cra.ts - GDPR mapping
packages/core/src/knowledge/gdpr.ts - EU AI Act mapping
packages/core/src/knowledge/eu-ai-act.ts - Other framework maps
packages/core/src/knowledge/more.ts
Finding Lifecycle
- Baseline and acceptance
packages/core/src/review.ts - Finding guidance
packages/core/src/guidance.ts - Run record
packages/core/src/record.ts - Import reachability
packages/core/src/reach.ts
Reports and Integration
- Assessment report
packages/core/src/assessment.ts - SARIF output
packages/core/src/sarif.ts - GitHub Action
Other components
- Developer or agent
Connections 24
- Developer or agent → CLI commands: runs commands
README.md - Developer or agent → MCP tools: calls tools
README.md - CLI commands → Agent setup: configures agents
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
packages/core/src/index.ts - Rule registry → OWASP checks: loads rules
packages/core/src/rules/index.ts - Rule registry → Stack checks: loads rules
packages/core/src/rules/index.ts - Rule registry → CRA checks: loads rules
packages/core/src/rules/index.ts - Rule registry → Standards checks: loads rules
packages/core/src/rules/index.ts - Config and file discovery → Rule packs: loads configured packs
packages/core/src/index.ts - Framework knowledge → OWASP mapping: registers framework
packages/core/src/knowledge/index.ts - Framework knowledge → CRA mapping: registers framework
packages/core/src/knowledge/index.ts - Framework knowledge → GDPR mapping: registers framework
packages/core/src/knowledge/index.ts - Framework knowledge → EU AI Act mapping: registers framework
packages/core/src/knowledge/index.ts - Framework knowledge → Other framework maps: registers frameworks
packages/core/src/knowledge/index.ts - Framework knowledge → Framework obligations: uses obligation types
packages/core/src/knowledge/index.ts - CLI commands → Baseline and acceptance: manages review data
- Config and file discovery → Baseline and acceptance: applies baseline
packages/core/src/index.ts - Config and file discovery → Run record: builds run record
packages/core/src/index.ts - Config and file discovery → Import reachability: computes reachability
packages/core/src/index.ts - Config and file discovery → Assessment report: can render report
packages/core/src/index.ts - Config and file discovery → SARIF output: can export findings
packages/core/src/index.ts - Developer or agent → GitHub Action: runs PR checks
README.md