How scanaislop/aislop works
aislop is a deterministic, multi-language code-quality scanner and repair CLI. Its main workflow selects project files, runs enabled analysis engines, scores findings, and reports them; the documented fix command applies mechanical changes. Other product surfaces include coding-agent repair, editor hooks, MCP tools, configuration, and editor integration. The sampled source confirms engine orchestration, scoring, configuration, and fix-step behavior; links for unsampled command and integration internals are limited to relationships supported by the README and module layout.
Main entry points: scan.ts Scan Command · cli.ts CLI Dispatcher · scan-engine-runner.ts Engine Runner · orchestrator.ts Engine Orchestrator
Components 21
CLI and Config
- CLI Dispatcher
src/cli.ts - Config Loader
src/config/index.ts
Scan and Analysis
- Scan Command
src/commands/scan.ts - Project Discovery
src/utils/discover.ts - Language Coverage
src/utils/discovery-coverage.ts - Source Selection
src/utils/source-file-selection.ts - Engine Runner
src/commands/scan-engine-runner.ts - Engine Orchestrator
src/engines/orchestrator.ts - Analysis Engines
src/engines
Automated Repair
- Fix Command
src/commands/fix.ts - Fix Pipeline
src/commands/fix-pipeline.ts - Formatting Steps
src/commands/fix-formatting-pipeline.ts
Agent Integrations
- Agent Repair
src/commands/agent.ts - Agent Sessions
src/agents/session.ts - Editor Hooks
src/hooks - MCP Server
src/mcp.ts - VS Code Extension
editors/vscode/src/extension.ts
Results and State
- Score Calculator
src/scoring/index.ts - Scan Report Formats
src/output - Telemetry
src/telemetry/client.ts
Other components
- Developer
Connections 20
- Developer → CLI Dispatcher: runs command
- CLI Dispatcher → Config Loader: loads settings
- CLI Dispatcher → Scan Command: dispatches scan
- CLI Dispatcher → Fix Command: dispatches fix
- Scan Command → Project Discovery: discovers project
- Scan Command → Language Coverage: checks coverage
- Scan Command → Source Selection: selects files
- Scan Command → Engine Runner: runs analysis
- Engine Runner → Engine Orchestrator: runs engines
- Engine Orchestrator → Analysis Engines: dispatches checks
- Scan Command → Score Calculator: scores findings
- Scan Command → Scan Report Formats: renders results
- Fix Command → Fix Pipeline: runs fix steps
- Fix Pipeline → Formatting Steps: runs formatting
- CLI Dispatcher → Agent Repair: dispatches agent
- Agent Repair → Agent Sessions: manages sessions
- CLI Dispatcher → Editor Hooks: dispatches hooks
- CLI Dispatcher → MCP Server: starts server
- Developer → VS Code Extension: uses editor
- Scan Command → Telemetry: reports events