Maguyva hỗ trợ TypeScript với phân tích cú pháp AST và trích xuất symbol, giúp AI agent theo dõi interface, cách triển khai, package dùng chung, và mã ứng dụng nặng JSX trong các monorepo.
TypeScript là ngôn ngữ mà nhiều đội kỳ vọng việc refactor có AI hỗ trợ cuối cùng sẽ cảm thấy an toàn. Hệ thống kiểu giúp ích, nhưng nó không loại bỏ vấn đề thực sự: package dùng chung, DTO, client được sinh tự động, component React, test, và mã ứng dụng đều kéo về cùng những cái tên trong một repo lớn.
Với TypeScript, tiêu chuẩn cao hơn là chỉ “hiểu cú pháp”. Agent cần theo dõi hợp đồng từ định nghĩa đến triển khai rồi đến phạm vi ảnh hưởng trước khi nó chỉnh sửa một type, hook, hoặc client dùng chung.
Maguyva trích xuất class, method, interface, và type alias qua .ts, .mts, .cts, và các biến thể file TypeScript phổ biến quanh test và story. Các tiền tố member được chuẩn hóa, nhưng các định danh gán theo class được giữ nguyên, điều này hữu ích khi một repo có cả tên helper trần và một method thuộc phạm vi class có cùng đoạn cuối.
JSX được xem như một tín hiệu cấu trúc thực sự chứ không phải markup lạc lõng, và các kỳ vọng symbol chủ động bỏ qua rất nhiều đường dẫn test, story, và config. Điều đó quan trọng trong monorepo vì nếu không, agent sẽ tốn quá nhiều thời gian khám phá lại phần khung dựng sẵn thay vì bề mặt triển khai thực sự.
Ba mẫu khởi đầu thường là đủ:
find_symbol khi bạn đã biết tên interface, type alias, hook, hoặc service.dependency_search trước khi thay đổi type hoặc client dùng chung có thể lan rộng qua nhiều package.structural_search khi bạn cần một hình dạng mã, không phải một khớp từ khóa, ví dụ các mẫu component hoặc method lặp lại.Với các câu hỏi mang tính khái niệm như “theo dõi đường gửi đơn thanh toán,” get_task_context thường là bước đầu tốt hơn một tìm kiếm thô.
Trang này phù hợp nhất với các monorepo web và nền tảng, nơi TypeScript là tầng điều phối cho nhiều package. Nếu repo của bạn vẫn còn nhiều JS cũ, hãy đọc hướng dẫn JavaScript. Nếu câu hỏi của bạn thực sự là “agent có thể giữ cả ngữ cảnh mã ứng dụng và hạ tầng cùng lúc không?” hãy kết hợp trang này với Terraform.
Phù hợp nhất
Workflow agent
Chi tiết engine
Điểm khởi đầu MCP hữu ích
find_symbol
Bắt đầu ở đây khi bạn biết interface, type alias, hook, hay service dùng chung mà bạn muốn xem xét.
dependency_search
Dùng nó trước khi thay đổi một DTO hay client dùng chung để có được phạm vi ảnh hưởng thực tế trên các package.
structural_search
Dùng tìm kiếm cấp AST khi bạn cần một mẫu hình, không phải khớp chuỗi, ví dụ như các hình dạng component hay method lặp lại.
Hướng dẫn liên quan
Hữu ích khi một repo pha trộn CommonJS, ESM, script tác vụ, test, và mã ứng dụng cũ hơn.
Phần mở rộng
.cjs, .js, .mjs, .spec.js, +2 nữa
Hữu ích khi mã hạ tầng là một phần của ngữ cảnh repo, chứ không phải thứ mà agent nên lướt qua qua loa.
Phần mở rộng
.tf, .tfvars