Maguyva supporta TypeScript con parsing AST ed estrazione dei simboli, così gli agenti AI possono tracciare interfacce, implementazioni, package condivisi, e codice applicativo ricco di JSX nei monorepo.
TypeScript è il linguaggio in cui molti team si aspettano che il refactoring assistito dall’AI finalmente sembri sicuro. Il sistema di tipi aiuta, ma non elimina il vero problema: package condivisi, DTO, client generati, componenti React, test, e codice applicativo che tirano tutti gli stessi nomi in un grande repository.
Per TypeScript, lo standard è più alto di “capisce la sintassi.” L’agente deve seguire il contratto dalla definizione all’implementazione fino al raggio d’impatto prima di modificare un tipo, un hook, o un client condiviso.
Maguyva estrae classi, metodi, interfacce, e alias di tipo attraverso .ts, .mts, .cts, e le comuni varianti di file TypeScript intorno a test e story. I prefissi member vengono normalizzati, ma gli identificatori qualificati dalla classe vengono preservati, il che aiuta quando un repository ha sia un nome helper semplice che un metodo con scope di classe con lo stesso segmento finale.
JSX viene trattato come un vero segnale strutturale piuttosto che markup vagante, e le aspettative sui simboli saltano esplicitamente molti percorsi di test, story, e configurazione. Conta nei monorepo perché altrimenti l’agente passa troppo tempo a riscoprire l’impalcatura invece della vera superficie di implementazione.
Tre pattern di partenza di solito bastano:
find_symbol quando conosci già il nome dell’interfaccia, dell’alias di tipo, dell’hook, o del service.dependency_search prima di modificare tipi o client condivisi che potrebbero propagarsi tra i package.structural_search quando ti serve una forma di codice, non un match di parole chiave, per esempio pattern di componenti o metodi ripetuti.Per domande concettuali come “segui il percorso di invio del checkout,” get_task_context è spesso un primo passo migliore di una ricerca grezza.
Questa pagina è più forte per monorepo web e platform dove TypeScript è il livello di coordinamento per più package. Se il tuo repository include ancora molto JS più vecchio, leggi la guida JavaScript. Se la tua domanda è davvero “l’agente riesce a tenere insieme codice applicativo e contesto infrastrutturale?” abbina questa pagina a Terraform.
Il più adatto per
Workflow degli agenti
Dettagli del motore
Punti di ingresso MCP utili
find_symbol
Inizia da qui quando conosci l'interfaccia condivisa, l'alias di tipo, l'hook o il servizio che vuoi ispezionare.
dependency_search
Usalo prima di modificare un DTO o un client condiviso per ottenere un raggio d'impatto realistico tra i pacchetti.
structural_search
Usa la ricerca a livello AST quando ti serve un pattern, non una corrispondenza di stringa, ad esempio forme ripetute di componenti o metodi.
Guide correlate
Utile quando un repository mescola CommonJS, ESM, script di task, test, e codice applicativo più datato.
Estensioni
.cjs, .js, .mjs, .spec.js, +2 altri
Utile quando il codice infrastrutturale fa parte del contesto del repository e non è qualcosa su cui l'agente dovrebbe sorvolare.
Estensioni
.tf, .tfvars