Kiến trúc

Signalint là một MCP server chạy qua stdio cục bộ. Adapters là các module duy nhất thực thi các engine chẩn đoán; mọi tầng phía trên chúng đều hoạt động trên các đối tượng issue đã được chuẩn hóa. Luồng triển khai là tĩnh và cục bộ: không cần bất kỳ dịch vụ đám mây nào.

Luồng dữ liệu của check_files

1. Server xác thực đối tượng tool thông qua các Zod schema nghiêm ngặt.
2. Các đường dẫn được yêu cầu được giải quyết theo gốc dự án và kiểm tra lại sau khi chuẩn hóa symlink.
3. Các mẫu glob ignore và việc loại trừ node_modules vô Ä‘iều kiện sẽ loại bỏ các đường dẫn ngoài phạm vi.
4. Signalint đọc các snapshot và tính toán hash cấu hình engine.
5. Các kết quả cache theo file được tái sử dụng; Oxlint và Biome (tùy chọn) chỉ nhận các trường hợp cache miss.
6. tsc chỉ được bỏ qua khi các snapshot liên quan đến TypeScript được cung cấp vẫn trùng khớp với kết quả toàn bộ chương trình mới nhất.
7. Các engine được bật hoạt động độc lập, do đó một thất bại không làm mất chẩn đoán của engine khác.
8. Các lỗi được chuẩn hóa, lọc, gom cụm, sắp xếp với ưu tiên 1 đứng đầu và mặc định giới hạn ở 10 cụm.
9. Trạng thái vòng lặp và số liệu được ghi lại trước khi trả về phản hồi JSON.

Chiến lược thực thi engine

Oxlint và Biome

Các engine này hoạt Ä‘á»™ng theo từng file. Má»™t cuá»™c gọi check_files sẽ hash từng file, dùng lại các mục trong SQLite khi key trùng khá»›p hoàn toàn và chỉ gá»­i các file cache miss tá»›i adapter.

TypeScript

tsc kiểm tra toàn bá»™ chÆ°Æ¡ng trình (whole-program). Các hash file được cung cấp quyết định xem việc chạy tsc có cần thiết hay không, nhÆ°ng các file không bao giờ được truyền dÆ°á»›i dạng root của compiler. Cấu hình root thông thường sá»­ dụng --project vá»›i trạng thái tăng dần (incremental state). Cấu hình root kiểu solution chứa references sẽ sá»­ dụng --build, nhờ đó các dá»± án composite được tham chiếu sẽ được duyệt qua.

Giới hạn lưu trữ

Cache SQLite cập nhật mốc thời gian khi đọc và loại bỏ các hàng ít được sá»­ dụng nhất (LRU) khi vượt quá 10.000 mục. Khi khởi Ä‘á»™ng phiên, chỉ phần Ä‘uôi gần nhất có giá»›i hạn được nạp lại; các lượt ghi xoay vòng file JSONL sang bản sao lÆ°u .1 khi chạm giá»›i hạn kích thÆ°á»›c. Lệnh stats tính toán trên cả hai file được giữ lại.

Ranh giới tin cậy

Các tham số MCP được xử lý như dữ liệu không đáng tin vì một mô hình AI có thể bị prompt-inject bởi nội dung dự án. các đường dẫn tuyệt đối, thoát ra ngoài, bắt đầu bằng dấu gạch ngang và chứa ký tự NUL bị từ chối, mảng tham số bị giới hạn và các adapter thực thi các file nhị phân đã giải quyết mà không qua shell.

Đọc tổng quan chi tiết về bản triển khai hiện tại trong ARCHITECTURE.md và mô hình đe dọa trong SECURITY.md.