How flint-fyi/flint works
Flint is an experimental hybrid linter: users invoke its CLI to lint a repository, optionally watch for changes, apply fixes, and view reports. The repository separates orchestration and linting mechanics in a shared core from language adapters and rule plugins, with CLI renderers presenting results. The README also calls out readable configuration, type-aware caching, and a unified rule core. Some subsystem links are dashed because the supplied excerpts do not show their runtime wiring; the graph does not assume those calls.
Main entry points: src Lint core · runCli.ts CLI entry · languages Language runtime · language.ts Other languages
Components 22
CLI workflow
- CLI entry
packages/cli/src/runCli.ts - Single run
packages/cli/src/runCliOnce.ts - Watch run
packages/cli/src/runCliWatch.ts - Output renderers
packages/cli/src/renderers - Report presenters
packages/cli/src/presenters
Linting engine
- Lint core
packages/core/src - Configuration
packages/core/src/configs - File hosts
packages/core/src/host - Lint cache
packages/core/src/cache - Fixes and changes
packages/core/src/changing - Reports and directives
packages/core/src/reporting
Language support
- Language runtime
packages/core/src/languages - TypeScript language
packages/typescript-language/src - Volar languages
packages/volar-language/src/language.ts - Other languages
packages/astro-language/src/language.ts
Rule plugins
- TypeScript rules
packages/ts/src/plugin.ts - Browser rules
packages/browser/src/plugin.ts - Astro rules
packages/astro/src/plugin.ts - JSON rules
packages/package-json/src/plugin.ts - Markdown rules
packages/md/src/plugin.ts - Additional plugins
packages
Other components
- Developer
Connections 22
- Developer → CLI entry: invokes
packages/cli/src/runCli.ts - CLI entry → Single run: runs once
packages/cli/src/runCli.ts - CLI entry → Watch run: starts watch
packages/cli/src/runCli.ts - CLI entry → Output renderers: creates renderer
packages/cli/src/runCli.ts - Single run → Lint core: runs lint
packages/cli/src/runCliOnce.ts - Watch run → Single run: reruns lint
packages/cli/src/runCliWatch.ts - Output renderers → Report presenters: selects presenter
packages/cli/src/renderers/createRendererFactory.ts - Lint core → Configuration: loads configuration
- Lint core → File hosts: uses file host
packages/core/src/types/host.ts - Lint core → Lint cache: caches results
- Lint core → Fixes and changes: applies fixes
- Lint core → Reports and directives: produces reports
- Lint core → Language runtime: runs language visitors
- Language runtime → TypeScript language: uses services
- Language runtime → Volar languages: supports Volar
- Language runtime → Other languages: supports languages
- TypeScript rules → Lint core: creates rules
packages/ts/src/plugin.ts - Browser rules → TypeScript language: analyzes syntax
- Astro rules → Other languages: uses Astro language
- JSON rules → Other languages: uses JSON language
- Markdown rules → Other languages: uses Markdown language
- Additional plugins → Lint core: extends core
packages/core/src/host/withRepositoryRoot.ts