Maguyva understøtter TypeScript med AST-parsing og symboludtræk, så AI-agenter kan spore interfaces, implementeringer, delte pakker og JSX-tung applikationskode på tværs af monorepoer.
TypeScript er det sprog, hvor mange teams forventer, at AI-assisteret refaktorering endelig føles sikker. Typesystemet hjælper, men det fjerner ikke det reelle problem: delte pakker, DTO’er, genererede klienter, React-komponenter, tests og applikationskode, der alle trækker på de samme navne på tværs af et stort repository.
For TypeScript er standarden højere end “den forstår syntaks.” Agenten skal følge kontrakten fra definition til implementering til virkningsradius, før den redigerer en delt type, hook eller klient.
Maguyva udtrækker klasser, metoder, interfaces og type-aliaser på tværs af .ts, .mts, .cts og de almindelige TypeScript-filvarianter omkring tests og stories. Medlemspræfikser normaliseres, men klassekvalificerede identifikatorer bevares, hvilket hjælper, når et repository har både et rent hjælpefunktionsnavn og en klasse-scopet metode med det samme sidste segment.
JSX behandles som et reelt strukturelt signal frem for løsreven markup, og symbolforventninger springer eksplicit en stor mængde test-, story- og config-stier over. Det betyder noget i monorepoer, fordi agenten ellers bruger for meget tid på at genopdage stilladset i stedet for den faktiske implementeringsflade.
Tre udgangsmønstre er som regel nok:
find_symbol, når du allerede kender navnet på interfacet, type-aliaset, hooken eller servicen.dependency_search, før du ændrer delte typer eller klienter, der kan sprede sig på tværs af pakker.structural_search, når du har brug for en kodeform, ikke et nøgleordsmatch, for eksempel gentagne komponent- eller metodemønstre.Til konceptuelle spørgsmål som “følg checkout-indsendelsesstien” er get_task_context ofte et bedre første skridt end en rå søgning.
Denne side er stærkest til web- og platformsmonorepoer, hvor TypeScript er koordineringslaget for flere pakker. Hvis dit repository stadig indeholder meget ældre JS, så læs JavaScript-guiden. Hvis dit spørgsmål egentlig er “kan agenten holde applikationskode og infrastrukturkontekst sammen?”, så kombinér dette med Terraform.
Bedst egnet til
Agent-arbejdsgange
Motordetaljer
Nyttige MCP-indgange
find_symbol
Start her, når du kender det delte interface, type alias, hook eller den service, du vil undersøge.
dependency_search
Brug det, før du ændrer en delt DTO eller klient, for at få en realistisk påvirkningsradius på tværs af pakker.
structural_search
Brug AST-niveau-søgning, når du har brug for et mønster, ikke en strengmatch — for eksempel gentagne komponent- eller metodeformer.
Relaterede guides
Nyttigt når et repository blander CommonJS, ESM, task-scripts, tests og ældre applikationskode.
Filendelser
.cjs, .js, .mjs, .spec.js, +2 mere
Nyttigt når infrastrukturkode er en del af repository-konteksten og ikke noget, agenten bare skal vifte forbi.
Filendelser
.tf, .tfvars