> methodology.md
Miten mittaamme
Tämä sivu on kirjaimellisesti paikka, jossa kerrotaan, miten Maguyva perustelee laatu- ja kustannusväitteensä todellisella datalla. Sivu sisältää vain faktoja: mitä mittaamme, miten pisteytämme sen ja mitä emme väitä auditoineemme.
Viimeksi päivitetty: 2026-10. Ajantasaiset lukumäärät generoidaan lähdedatasta; tämä sivu selittää mittausmallin. Linkitetty näyttöaineisto erottaa toteutetut testitapausten säännöt todentamattomista historiallisista hakutavoitteista.
- Fixture-portit
- Language-audit-ulottuvuudet
- Kustannusläpinäkyvyys
Tämä on tekoälyavusteinen käännös, joka tarjotaan käyttömukavuuden vuoksi. Virallinen englanninkielinen versio on ainoa sitova versio — kaikkia rekisteröitymisen yhteydessä syntyviä sopimuksia säätelee englanninkielinen teksti. Lue virallinen englanninkielinen versio
tl;dr — Laaturaportointi käyttää testitapausten luokituksia ja moniulotteisia kieliauditoinnin näkymiä. GREEN tunnetuissa testitapauksissa ei tarkoita riippumattomasti todennettua poiminnan oikeellisuutta eikä takaa, että jokainen käytössä oleva kieli täyttää nämä raja-arvot. Kustannusväitteet perustuvat työtilan hinnoittelulaskelmiin ja julkisiin käyttökustannuksiin, eivät kolmannen osapuolen kilpailijavertailuun.
1. Miksi tämä sivu on olemassa
Skeptisten ostajien ei pitäisi joutua reverse-engineeraamaan markkinointitekstiä. Maguyva indeksoi repositoryjä ja näyttää tarkkuus-, kielikattavuus- ja kustannusväitteitä koko sivustolla. Nämä väitteet tarvitsevat menetelmäsivun, joka on rehellinen mittausalueesta: mikä on fixture-tuettua, mikä on arviointiin perustuvaa ja mikä on framingia riippumattoman sertifioinnin sijaan.
2. Mitä mittaamme
Koodiälyn laatua mitataan ensisijaisesti kielimoottorissa — symbolien, suhteiden ja graafien poiminnassa lähdekoodista — ei subjektiivisilla ”agentin tyytyväisyys” -pisteillä.
- Kielikohtaiset fixture-sarjat: odotetut edget ja symbolit, jotka handlerin täytyy extraktoida oikein
- Testitapausten tarkkuusluokitus: GREEN edellyttää precision-arvoa ≥ 0.95, recall-arvoa ≥ 0.99, F1-arvoa ≥ 0.97 ja vähintään 20 odotettua kaarta sekä testitapausten kuratoinnin lisätarkistuksia. Tämä on tunnettuja testitapauksia koskeva sääntö, ei tilastollisen luottamuksen arvio eikä väite siitä, että jokaisen käytössä olevan kielen tila on GREEN.
- Language-audit-ulottuvuudet: tarkkuus, rakenteellinen eheys, kattavuus, laatu ja suorituskyky validointitaulussa
- Corpus- ja pistotarkastussilmukat: näytteistetyt edget oikeista repositoryistä, luokiteltuina rubriikin mukaan (oikein, false positive, tyyppi-/laajuus-/metadatavirhe) — kuvattu language-grind-blogijulkaisuissamme
- Tuotteen ominaisuusliput: mitä palvelin ilmoittaa tukevansa (AST, locals, graafipoiminta), erillään katalogin koosta
Tärkeää: Fixturet validoidaan itse kirjoittamiamme fixtureita vasten. VIHREÄ tarkoittaa, että tunnetut tapaukset menevät läpi. Se ei automaattisesti tarkoita, että jokainen todellisen maailman idiomi extraktoituu puhtaasti. Tämä ero on tarkoituksellinen ja julkinen.
3. Vihreä vs. riippumattomasti todennettu
Language-audit-taulu käyttää useita akseleita, joten yhtä vihreää valoa ei voi tulkita “todistetusti täydelliseksi.” Taulun pääluvut jaetaan yleensä näin:
- overall_green — regressiopuhdas self-snapshot-fixtureita ja niihin liittyviä corpus gateja vasten (tarpeellinen, mutta ei riittävä)
- independently_verified — sisältää vahvan arviointisignaalin, kuten pistotarkastussiemenen (mukana kielet, joissa on yhä arvioinnissa havaittuja virheitä)
- verified_clean / nolla arvioinnissa havaittua virhettä näytteistetyissä edgeissä — tiukempi osajoukko arvioiduista kielistä
- curation / oracle trust — kohdellaanko fixtureita itseään luotettuina oracleina
- structural flags — graafiextraktio ja AST-kyvykkyys eivät ole sama asia kuin katalogijäsenyys
Markkinoinnin kielimäärä (esimerkiksi “285+ kieltä”) on katalogin koko: konfiguroidut kielet ja palvelinmerkinnät. Katalogin koko ei ole AST-laadun SLA. Suosimme monitasoista raportointia yhden ylpeilyluvun sijaan. Nykyisen tuotepinnan osalta katso Yhteensopivuus ja Kielioppaat; kerronnallisia yksityiskohtia varten katso blogin kirjoitus kielten rekursiivisesta itseparannuksesta.
4. Haun ja retrievalin laatu
Semanttisen haun laatu on monimodaalinen: teksti, AST, graafi ja embeddingit yhdistetään. Dokumentoimme tietoisia insinöörikompromisseja sen sijaan, että väittäisimme retrievalia voittamattomaksi:
- Embeddingit käyttävät kaupallista malliperhettä (voyage-4-large kesäkuun 2026 blogitilannekuvan mukaan), valittu julkisten retrieval-ranking-listojen perusteella päätöshetkellä
- Vektorit on binäärikvantisoitu tallennusta ja kustannuksia varten; tämä vaihtaa tietoisesti hieman retrieval-tarkkuutta halvempaan ja nopeampaan Hamming-hakuun ilman erillistä vektoritietokantaa
- Aikeen mukainen reititys ja yhdistämisen painot ovat suunniteltuja heuristiikkoja. Joulukuun 2025 ehdotuksessa tuloksettomien hakujen lähtöosuudeksi arvioitiin noin 15 % ja tavoitteeksi asetettiin alle 5 %; emme ole toimittaneet kyselyjoukkoa tai mittausraporttia, joka osoittaisi tämän laskun. Näyttöaineisto korjaa aiemman väitteen saavutetusta parannuksesta.
- Blogijulkaisut sisältävät osiot “mikä on yhä epätäydellistä” — epätäydelliset signaalit ovat osa tallennetta, eivät piiloteltuja alaviitteitä
5. Kustannusväitteet
Maguyva-palvelun kustannuskieli kertoo hinnoittelurakenteesta ja toiminnan läpinäkyvyydestä, ei kolmannen osapuolen sertifioimasta virallisesta TCO-tutkimuksesta.
- Workspace-hinnoittelu: laskutus perustuu repositoryihin, indeksoituihin riveihin ja rebuild-tiheyteen — ei ihmis- tai agenttipaikkoihin. Usein kysytyt kysymykset ja tilaustasojen kuvaukset selittävät ulottuvuudet.
- Hintaesimerkki vertaa 25 maksullista käyttäjäpaikkaa havainnollistavalla $19–$59 paikkahinnalla Crew-tilaukseen, joka maksaa $49/kuukausi. Säästöt riippuvat tiimin koosta ja vaihtoehtoisesta tuotteesta; kyse ei ole vastaavien ominaisuuksien vertailusta eikä riippumattomasta kilpailuvertailusta.
- Toimintakustannusten rehellisyys: /team-sivu julkaisee todellisen kuukausittaisen ohjelmistokustannusten erittelyn (tilaukset, MCP-/hakutyökalut, käyttöpohjaiset kustannukset). Se on customer-zero-läpinäkyvyyttä, ei auditoitu tilinpäätös.
- Embedding- ja infrakustannukset ovat hyväksyttyjä tuotekustannuksia (premium-embeddingit, tallennustila, graafien rebuildit). Maksamme ne tarkoituksella ja kerromme siitä voyage-4-large-julkaisussa ja hinnoittelukertomuksessa.
6. Mitä emme väitä
Tämä sivu on myös lista ei-väitteistä. Jos jokin ei ole mittaustaululla, älä pidä markkinointisävyä todisteena.
- Ei yleistä absoluuttisen tarkkuuden takuuta jokaiselle kielelle. Testitapausten kynnysarvot koskevat kunkin kielen tunnettuja tapauksia; todellisessa koodissa on odotettavissa jäljelle jääviä virheitä, joita vähennetään jatkuvasti.
- Ei väitettä, että overall_green vastaisi tuotantotasoisen täydellistä extraktiota jokaiselle repository-idiomille
- Ei kolmannen osapuolen compliance-sertifiointipakettia, jota väitettäisiin menetelmäartefaktiksi tällä sivulla (katso Tietoturva tietojenkäsittelyn faktoja varten, ei compliance-merkkejä)
- Ei riippumatonta usean toimittajan bake-offia jaetuilla korpuksilla julkaistuna pysyvänä tuloskorttina
- Hakutulokset ja analyysit pysyvät best-effort-tasoisina käyttöehtojen mukaisesti — Maguyva ei korvaa koodikatselmointia, testausta tai tietoturva-auditointeja
7. Miten voit todentaa itse
Ostajan odotettu liike on yhä tämä: indeksoi repo, jonka jo ymmärrät, esitä yksi oikea kysymys ja tarkasta viittaukset.
- Aloita ilmaiseksi: pienet edustavat repot voittavat koko yrityksen indeksin ensimmäisenä päivänä
- Käytä MCP-työkaluja (intelligent_search, find_symbol, dependency_search) ja avaa viitatut polut
- Lue sisäänluku- ja hakuarkkitehtuurista sivulta Näin se toimii
- Lue ominaisuustasoista sivuilta Yhteensopivuus ja Kielioppaat, älä katso vain katalogin kokoa
- Lue tietojenkäsittelystä sivuilta Tietoturva ja Tietosuoja; tämä sivu ei korvaa niitä