Maguyva tukee TypeScript-kieltä AST-jäsennyksellä ja symbolien poiminnalla, jotta tekoälyagentit voivat jäljittää rajapintoja, toteutuksia, jaettuja paketteja ja JSX-painotteista sovelluskoodia monorepoissa.
TypeScript on kieli, jossa monet tiimit odottavat tekoälyavusteisen refaktoroinnin vihdoin tuntuvan turvalliselta. Tyyppijärjestelmä auttaa, mutta se ei poista todellista ongelmaa: jaetut paketit, DTO:t, generoidut asiakkaat, React-komponentit, testit ja sovelluskoodi kaikki vetävät samoja nimiä suuressa repositoriossa.
TypeScriptille standardi on korkeampi kuin “se ymmärtää syntaksin”. Agentin täytyy seurata sopimusta määrittelystä toteutukseen ja vaikutusalueeseen ennen jaetun tyypin, hookin tai asiakkaan muokkaamista.
Maguyva poimii luokat, metodit, rajapinnat ja tyyppialiakset .ts:sta, .mts:sta, .cts:sta ja yleisistä TypeScript-tiedostomuunnelmista testien ja storyjen ympärillä. Jäsenetuliitteet normalisoidaan, mutta luokkapätevöidyt tunnisteet säilytetään, mikä auttaa, kun repositoriossa on sekä paljas apuohjelman nimi että luokkakohtainen metodi, jolla on sama viimeinen segmentti.
JSX käsitellään todellisena rakenteellisena signaalina eikä irrallisena merkkauksena, ja symboliodotukset ohittavat eksplisiittisesti paljon testi-, story- ja konfiguraatiopolkuja. Se merkitsee monorepoissa, koska muuten agentti käyttää liikaa aikaa telineiden uudelleenlöytämiseen todellisen toteutuspinnan sijaan.
Kolme aloitusmallia riittää yleensä:
find_symbol, kun tiedät jo rajapinnan, tyyppialiaksen, hookin tai palvelun nimen.dependency_search ennen jaettujen tyyppien tai asiakkaiden muuttamista, jotka saattavat levitä usean paketin yli.structural_search, kun tarvitset koodimuotoa, et avainsanavastaavuutta, esimerkiksi toistuvia komponentti- tai metodimalleja.Käsitteellisille kysymyksille, kuten “seuraa kassalle lähettämisen polkua”, get_task_context on usein parempi ensiaskel kuin raaka haku.
Tämä sivu on vahvimmillaan web- ja alustamonorepoissa, joissa TypeScript on useiden pakettien koordinaatiokerros. Jos repositoriossasi on vielä paljon vanhempaa JS:ää, lue JavaScript-opas. Jos kysymyksesi on oikeasti “pystyykö agentti pitämään sovelluskoodin ja infrakontekstin yhdessä?”, yhdistä tämä Terraformiin.
Parhaiten sopii
Agenttien työnkulut
Moottorin yksityiskohdat
Hyödylliset MCP-liittymäkohdat
find_symbol
Aloita tästä, kun tiedät jaetun rajapinnan, tyyppialiaksen, hookin tai palvelun, jota haluat tarkastella.
dependency_search
Käytä sitä ennen jaetun DTO:n tai clientin muuttamista saadaksesi realistisen vaikutusalueen pakettien yli.
structural_search
Käytä AST-tason hakua, kun tarvitset kuviota etkä merkkijonovastaavuutta, esimerkiksi toistuvia komponentti- tai metodimuotoja.
Aiheeseen liittyvät oppaat
Hyödyllinen, kun repositorio sekoittaa CommonJS:ää, ESM:ää, tehtäväskriptejä, testejä ja vanhempaa sovelluskoodia.
Päätteet
.cjs, .js, .mjs, .spec.js, +2 lisää
Hyödyllinen, kun infrastruktuurikoodi on osa repositorion kontekstia eikä jotain, minkä agentti voi vain sivuuttaa kädenheilautuksella.
Päätteet
.tf, .tfvars