Server · Rust · costruito su Stratum DB

Stratum Hub

Il server, uno per azienda, che dà memoria condivisa e coordinamento alle sessioni di Claude Code: memorie, task, messaggi, decisioni e sessioni attive, su tutti i dispositivi.

Scorri

Ogni dato vive in un ambito: l'azienda, un progetto, una persona. Ogni ambito è un database Stratum a sé, così permessi, backup, conservazione e cancellazione si applicano ambito per ambito.

Architettura

Una scrittura nell'hub

  1. 1

    Richiesta

    Un dispositivo parla all'hub in HTTPS, con il certificato dell'azienda e il suo token. L'hub del token conserva solo l'impronta SHA-256.

  2. 2

    Permessi

    Le regole di accesso sono scritte in Cedar, un linguaggio fatto per i permessi: owner, admin dell'azienda, lettori, scrittori e admin di progetto.

  3. 3

    Scrittore

    Ogni ambito ha un solo scrittore, su un thread del sistema operativo, con una coda di 1.024 comandi. Per ogni comando controlla idempotenza, versione e regole.

  4. 4

    Un commit per gruppo

    Raccoglie fino a 256 comandi o circa 1 MiB in un solo commit: documenti, eventi, registro di controllo e registro dei comandi, con un solo fsync.

  5. 5

    Eventi

    Chi è in ascolto riceve gli eventi in streaming (SSE). Una memoria nuova si trova subito con la ricerca testuale; il suo vettore arriva entro circa un secondo.

Funzioni

Cosa tiene l'hub

Memorie

Fatti, decisioni e problemi noti, fino a 256 KiB l'una, cercati per significato e per parole. Una memoria simile a una esistente viene segnalata; una vecchia si può sostituire con una nuova.

Brief

Il riepilogo che una sessione riceve prima del primo prompt: decisioni e problemi noti del progetto, preferenze della persona. Chi riprende una lane riceve il punto da cui ripartire.

Lane e task

Una lane è un filone di lavoro tenuto da una sola sessione attiva. I task hanno dipendenze: uno è pronto quando quelle sono completate.

Lease sui file

Una sessione riserva fino a 64 percorsi per richiesta; chi li modifica da un'altra riceve un avviso o un rifiuto. Il lease scade se la sessione non si fa sentire per 2 minuti.

Messaggi e domande

Note, domande, risposte e incarichi tra sessioni, fino a 64 KiB. Una domanda a una persona offre da 2 a 4 opzioni e la risposta può entrare nel registro delle decisioni.

Decisioni

Le parole esatte di chi decide, cifrate una per una con ChaCha20-Poly1305. Per cancellarne una si distrugge la sua chiave: l'operazione è irreversibile e riservata all'owner.

Prenotazioni

Risorse condivise, come il turno per il push o un telefono di prova: da 60 secondi a 7 giorni, 24 ore di default. Chi trova la risorsa occupata può aspettare in coda.

Avvio di sessioni

Una sessione o una persona avvia sessioni di aiuto su un dispositivo. Al massimo due livelli, e al massimo 8 aperte per persona, 3 per sessione, 6 per dispositivo.

Eval

I risultati delle valutazioni, salvati per suite, dataset, braccio e commit, con fino a 64 metriche ciascuno.

Ricerca delle memorie

Significato, parole, riordino

Vettori
bge-m3, 1024 dimensioni, calcolati in gruppi di 16 testi.
Pesi sparsi
Un peso per ogni parola importante, dallo stesso modello: riordinano i primi 100 candidati.
Reranker
Facoltativo: rilegge i primi 20 risultati con la domanda e li riordina. Tre modelli ammessi.
BM25
La ricerca per parole, finché i vettori di un ambito non sono pronti.

99,2 %

delle volte la memoria giusta è tra le prime 5, con il reranker (LongMemEval-S, 500 domande)

94,2 %

delle volte è la prima trovata

208 ms

la mediana di un recall con la qualità «balanced», su CPU

245 ms

con la qualità «best»

LongMemEval-S è un benchmark pubblico di memoria a lungo termine; qui è misurato solo il recupero, su un PC con Intel i9 e una RTX 3050 Ti, in una sola esecuzione. La qualità delle risposte finali con la memoria non è ancora misurata.

Sicurezza e conservazione

Chi entra, cosa resta

Ingresso

Ogni azienda ha la sua autorità di certificazione. Un dispositivo entra con un codice d'invito, valido 15 minuti, o con l'approvazione di un admin. Il suo token è di 256 bit.

Credenziali

Le credenziali dei piani stanno in un vault cifrato a busta con AES-256-GCM: una chiave per ogni voce, protetta da una chiave principale.

Conservazione di defaultgiorni
Sessioni30
Eventi30
Messaggi60
Recall60
Riassunti e archivio90
Task180
Registro di controllo365

Glossario

Le parole dell'hub

Ambito
Dove vive un dato: l'azienda, un progetto o una persona. Un database per ambito.
Lane
Un filone di lavoro con un nome, seguito da una sola sessione attiva alla volta, con lo stato da cui riparte chi subentra.
Lease
La riserva di file o cartelle da parte di una sessione, per evitare modifiche sovrapposte.
Brief
Ciò che una sessione deve sapere prima del primo prompt.
Digest
Il riassunto di ciò che ha fatto una sessione o un lavoro; non entra nel recall automatico.
Spawn
L'avvio di una sessione di Claude Code su un dispositivo, chiesto da una sessione o da una persona.
Sleep e wake
Una lane ferma si mette a dormire; un messaggio la risveglia avviando di nuovo la sua sessione.
Instradamento
La scelta di account, piano e modello su cui gira una sessione, tra quelli consentiti dalle regole dell'azienda.
SSE
Server-Sent Events: una connessione HTTP che resta aperta e porta gli eventi man mano.
Cedar
Un linguaggio per scrivere regole di accesso, valutate a ogni richiesta.

Da sapere

Cosa non fa ancora

Ricerca per parole in inglese

Il BM25 dell'hub usa solo lo stemming inglese; la ricerca per significato funziona in tutte le lingue del modello.

Copia locale spenta

L'hub serve il suo registro delle operazioni per una copia locale sui dispositivi, ma per gli utenti è spenta e il recall non la usa.

Coordinamento non gratis

Due sessioni in parallelo, con o senza hub, danno la stessa qualità di una e costano da 1,4 a 1,7 volte tanto; l'hub riduce le modifiche sovrapposte.