> registro dell'evoluzione
Su cosa gira Maguyva
Costruito per velocità, debuggabilità e miglioramento continuo: infrastruttura collaudata al centro, componenti su misura dove l'intelligenza del codice lo richiede.
> lsmod | grep production
Cosa gira in produzione
Questi sono i livelli fondamentali rimasti dopo molte iterazioni. Ognuno si è guadagnato il suo posto rendendo il debug più semplice o riducendo l'attrito nell'esecuzione degli agenti.
PostgreSQL + Lance
Storage e indici partizionati per tenant. Il tuo codice resta isolato, senza mescolanza di indici tra utenti.
Voyage AI: voyage-4-large
Embedding del codice ad alto recall per ricerca, recupero e fondatezza delle risposte degli agenti.
Binary Quantized HNSW
Embedding compressi in firme a 2048 bit e indicizzati con HNSW. Riduzione dello storage di 32x, ricerca a bassa latenza, zero infrastruttura aggiuntiva.
Motore linguistico del codice
Uno stack Tree-sitter pesantemente modificato, con grammatiche personalizzate, euristiche degli handler e copertura di estrazione per 279 linguaggi
Protocollo MCP
Server MCP remoto per Claude Code, Claude Desktop, Cursor, VS Code, Windsurf e other MCP-compatible clients. Strumenti 11 su un TypeScript Cloudflare Worker con trasporto HTTP nativo in streaming.
Lance columnar + R2
Embedding con cache columnare, sincronizzati sul cloud
Cronologia dell'architettura
Lo stack dopo i vicoli ciechi
Maguyva non è arrivato a questa forma tutto in una volta. Ogni livello è sopravvissuto perché ha reso il sistema più facile da comprendere, più economico da gestire o più facile da debuggare sotto pressione.
Gli esperimenti di orchestrazione sono iniziati prima. Questa cronologia inizia a settembre 2025, quando il prodotto Maguyva vero e proprio ha preso forma.
Inizia lo sviluppo mirato di Maguyva → Voyage voyage-code-3
La direzione del prodotto si consolida e inizia il ciclo di iterazione rapida
Livello di recupero vettoriale binario
Ricerca quantizzata con indici compatti, senza uno stack vettoriale separato
Il motore linguistico del codice va online
Query personalizzate, fallback del parser ed euristiche basate su handler per 279 linguaggi
Ricerca a fusione multimodale
Recupero classificato attraverso indici semantici, testuali, AST e a grafo in un'unica query
Sincronizzazione Lance columnar + R2
Cache columnare lato server, avvii a freddo più rapidi
Framework di validazione per 279 linguaggi
Test di estrazione automatizzati su ogni linguaggio supportato
Lancio pubblico su maguyva.ai
7 mesi dallo sviluppo mirato alla disponibilità pubblica
Servizio MCP su Cloudflare Worker con TypeScript
Trasporto HTTP streamable nativo, latenza inferiore, sostituito senza interrompere il traffico in produzione
Embedding di produzione → voyage-4-large
Ricerca semantica con recall più elevato dopo la migrazione da voyage-code-3
> ps aux | grep maguyva
Usiamo quello che rilasciamo
Maguyva è costruito da agenti che girano su Maguyva.
Il nostro sistema di orchestrazione coordina agenti IA specializzati che usano gli stessi strumenti MCP, gli stessi indici di ricerca e la stessa infrastruttura di produzione che ottieni tu. Non esiste una versione interna. La pagina del team elenca “1x Maguyva ($149) — paghiamo noi stessi.” Non è una battuta. È la fattura.
// il cliente zero rilascia in produzione ogni giorno
> cat /etc/principles.d/*.conf
Le regole sopravvissute alla produzione
Questi sono i vincoli rimasti utili in produzione. Riguardano meno l'ideologia e più il mantenere il sistema comprensibile mentre gli agenti apportano modifiche a grande velocità.
Niente fallback silenziosi
Fallisci in fretta, correggi in fretta. Ogni errore emerge immediatamente. Nessun degrado controllato che nasconde bug in produzione.
// panico > corruzione silenziosa
RPC innanzitutto
Logica lato database per le prestazioni. Le funzioni PostgreSQL vengono eseguite vicino ai dati, eliminando i round trip.
// funzioni PostgreSQL, 0 ORM
CQRS
Percorsi separati per scrittura e lettura. La pipeline di indicizzazione scrive, gli strumenti MCP leggono. Strategie di ottimizzazione diverse.
// scritture: in batch | letture: in cache
UUID deterministici
Coerenza della cache senza interrogazioni al database. Stesso input = stesso ID. Operazioni idempotenti per progettazione.
// uuid5(namespace, content_hash)
La migliore architettura è quella che puoi debuggare alle 3 del mattino.
(L'abbiamo testato.)
// ultimo aggiornamento: 2026-07
> ssh infra@maguyva -- status
Dove vive il tuo codice
Nessun mistero. Ecco esattamente cosa succede al tuo codice quando colleghi un repository.
Server bare-metal, US East
Macchine bare-metal ad Ashburn, ottimizzate per il throughput di indicizzazione invece di istanze generiche e rumorose.
CDN globale Cloudflare
Risposte API e MCP messe in cache all'edge. Asset statici serviti dalla rete globale di Cloudflare.
Partizionato per tenant, per workspace
Ogni workspace ottiene indici di repository con ambito per tenant, lungo tutta la pipeline e il database. Usiamo il codice dei clienti per fornire intelligenza del codice, non per addestrare modelli o vendere dati.
Costituita a Singapore
UT International PTE. LTD. Giurisdizione reale, entità reale.
Rimuovi un repository, rimuovi l'indice
Scollega un repository e Maguyva rimuove dal servizio il codice sorgente indicizzato attivo, gli embedding e i dati del grafo. I backup residui scadono secondo il piano di conservazione.
Ti serve UE o AU?
Regioni di deployment aggiuntive sono una conversazione da fare per i clienti con requisiti di residenza dei dati.