Maguyva støtter TypeScript med AST-parsing og symbolutvinning, slik at AI-agenter kan spore grensesnitt, implementasjoner, delte pakker og JSX-tung applikasjonskode på tvers av monorepositorier.
TypeScript er språket der mange team forventer at AI-støttet refaktorering endelig skal føles trygt. Typesystemet hjelper, men det fjerner ikke det egentlige problemet: delte pakker, DTO-er, genererte klienter, React-komponenter, tester og applikasjonskode som alle trekker på de samme navnene på tvers av et stort repositorium.
For TypeScript er standarden høyere enn «den forstår syntaks». Agenten må følge kontrakten fra definisjon til implementasjon til påvirkningsradius før den redigerer en delt type, hook eller klient.
Maguyva trekker ut klasser, metoder, grensesnitt og typealiaser på tvers av .ts, .mts, .cts og de vanlige TypeScript-filvariantene rundt tester og stories. Medlemsprefikser normaliseres, men klassekvalifiserte identifikatorer bevares, noe som hjelper når et repositorium har både et rent hjelpefunksjonsnavn og en klasseomsluttet metode med samme siste segment.
JSX behandles som et ekte strukturelt signal snarere enn løs markering, og symbolforventninger hopper eksplisitt over mange test-, story- og konfigurasjonsstier. Det betyr noe i monorepositorier fordi agenten ellers bruker for mye tid på å gjenoppdage stillas i stedet for den faktiske implementasjonsflaten.
Tre startmønstre er som regel nok:
find_symbol når du allerede kjenner navnet på grensesnittet, typealiaset, hooken eller tjenesten.dependency_search før du endrer delte typer eller klienter som kan spre seg på tvers av pakker.structural_search når du trenger en kodeform, ikke et nøkkelordtreff, for eksempel gjentakende komponent- eller metodemønstre.For konseptuelle spørsmål som «følg innsendingsstien for kassen», er get_task_context ofte et bedre første hopp enn et rått søk.
Denne siden er sterkest for web- og plattformmonorepositorier der TypeScript er koordineringslaget for flere pakker. Hvis repositoriet ditt fortsatt inkluderer mye eldre JS, les JavaScript-guiden. Hvis spørsmålet ditt egentlig er «kan agenten holde applikasjonskode og infrastrukturkontekst sammen?» kombiner dette med Terraform.
Best egnet
Agent-arbeidsflyter
Motordetaljer
Nyttige MCP-inngangspunkter
find_symbol
Start her når du kjenner det delte grensesnittet, typealiaset, hooken eller tjenesten du vil undersøke.
dependency_search
Bruk det før du endrer en delt DTO eller klient, for å få en realistisk påvirkningsradius på tvers av pakker.
structural_search
Bruk AST-nivå-søk når du trenger et mønster, ikke et strengtreff, for eksempel gjentatte komponent- eller metodeformer.
Relaterte guider
Nyttig når et repositorium blander CommonJS, ESM, oppgaveskript, tester og eldre applikasjonskode.
Filendelser
.cjs, .js, .mjs, .spec.js, +2 til
Nyttig når infrastrukturkode er en del av repositoriekonteksten, og ikke noe agenten bør vifte forbi.
Filendelser
.tf, .tfvars