IRONSTICK← Pagina iniziale

IRONSTICK — Il ponte per l'IA desktop

Un unico ponte locale, quattro IA desktop alla pari — Claude Desktop / Claude Code, ChatGPT Desktop, Qwen Desktop e Kimi Desktop — più la chat IA integrata di IRONSTICK. Che cos'è il ponte, come viene concesso in licenza, qual è il suo rapporto con la chat interna all'app, come si installa, come viene visualizzato ogni accesso, che cosa ci si può fare — e il catalogo completo dei 175 strumenti. Edizione per Windows.

1. Che cos'è il ponte

Il ponte collega la Sua IA desktop — Claude Desktop (o Claude Code), ChatGPT Desktop, Qwen Desktop o Kimi Desktop — con l'applicazione IRONSTICK in esecuzione sullo stesso computer. L'IA può allora leggere il materiale dei Suoi casi tramite strumenti costruiti su misura — cronache, testi integrali dei documenti, e-mail, scadenze, anagrafiche — e lavorarci in piena profondità: analizzare, verificare, redigere. Il collegamento è strettamente locale (127.0.0.1); nessun server IRONSTICK è coinvolto. I dati che l'IA legge vengono trattati nell'ambito del Suo abbonamento presso quel fornitore e alle sue condizioni — l'esposizione completa si trova nella dichiarazione GDPR sui flussi di dati.

• Presuppone la rispettiva applicazione desktop con il proprio account (Anthropic, OpenAI, Qwen o Kimi).
• Funziona solo finché IRONSTICK è in esecuzione — chiudendo l'app si chiude anche la fonte dei dati.
• Questo canale trasmette deliberatamente dati reali, non pseudonimizzati — è proprio questo che rende possibile la stesura di modelli pronti per il deposito.
• I documenti contrassegnati come segreti sono invisibili al ponte.
• La memoria IA condivisa tra le chat è costruita per procedimenti lunghi: le voci legate a un caso attivo non scadono mai, e ogni utilizzo ne rinnova la durata — solo il materiale morto invecchia ed esce dopo un anno.
• L'accesso in scrittura è volutamente ristretto: le proposte finiscono nel Monitor di Coerenza dei Dati per la Sua verifica; le bozze vengono passate al word processor; nulla viene scritto direttamente nei Suoi record.

1b. Perché il ponte?

Perché lavorare tramite un abbonamento costa di norma molte volte meno che tramite l'API. Un'IA desktop funziona con l'abbonamento forfettario che ha comunque presso il fornitore; ogni dialogo, ogni lettura di testo integrale, ogni round di stesura è coperto da esso. Lo stesso lavoro svolto con la chat interna di IRONSTICK gira sulla Sua chiave API e viene fatturato a token — nei dialoghi lunghi su fascicoli voluminosi il conto sale in fretta.

Dove il ponte brilla è il prezzo: è un potente riduttore dei costi dei dialoghi con l'IA e lo strumento d'elezione ogni volta che documenti o grandi quantità di dati vengono curati tramite l'IA — leggere interi fascicoli, tenere aggiornati cronache, protocolli e memoria, elaborare centinaia di allegati — un lavoro che, token per token, sarebbe proibitivamente costoso.

1c. Licenze — quattro ponti o il bundle

Ogni accesso di un'IA desktop è un modulo aggiuntivo con licenza propria:

• La disponibilità è contenuta nella Sua chiave di licenza firmata: solo i ponti concessi in licenza vengono effettivamente creati — uno senza licenza non ha front-end né superficie di strumenti e non compare nella configurazione.
• Può acquistare la licenza di un singolo ponte (solo per l'IA desktop che usa) oppure il bundle di tutti e quattro — ampliabile in seguito.
• I ponti con licenza possono funzionare in parallelo; un caso può essere elaborato contemporaneamente da più IA desktop.

1d. La chat IA integrata di IRONSTICK — lo stesso modello, più Gemini, senza licenza aggiuntiva

IRONSTICK ha anche una propria chat IA integrata, che funziona sullo stesso identico livello di lavoro del ponte — gli stessi strumenti, gli stessi gate, lo stesso ancoraggio e la stessa stesura di modelli pronti per il deposito. Ciò che può fare il ponte, lo può fare anche la chat interna all'app. Oltre ai quattro fornitori del ponte offre in più Gemini di Google come fornitore.

• Nessuna licenza aggiuntiva. La chat interna all'app è integrata in IRONSTICK; non richiede alcun ulteriore modulo ponte.
• Funziona tramite l'API dei fornitori (la Sua chiave API personale), fatturata a token. Poiché le tariffe API sono un po' più alte di un abbonamento forfettario, nell'uso quotidiano la chat interna all'app può risultare più cara rispetto all'uso del ponte insieme all'app desktop del fornitore — dove il modello ad abbonamento è di gran lunga più conveniente.
• In cambio, la via API tramite IRONSTICK è più sorvegliata e controllabile: pseudonimizzata dal router, finestra di consenso, registro di audit e limiti di dimensione — agli stessi gate del ponte.

2. Installazione (per ciascuna delle quattro)

La procedura è la stessa per ogni IA desktop; cambiano solo la fonte di download e il pulsante di configurazione.

1. Installare l'applicazione desktop, accedere con il proprio account e avviarla una volta (vedi la riga del fornitore qui sotto).
2. In IRONSTICK aprire Configurazione → Configurazione IA → IA con server MCP locale (STDIO).
3. Attivare «Consenti l'accesso al connettore da parte dell'IA desktop locale» (l'interruttore principale dell'intero canale).
4. Facoltativamente attivare «Consenti la navigazione da parte dell'IA desktop», se l'IA deve poter anche comandare l'app — aprire schermate, casi e documenti, esportare file. La lettura funziona anche senza.
5. Fare clic sul pulsante «Configura … Desktop» corrispondente. IRONSTICK installa la propria istanza del ponte e la registra da sé nell'IA desktop — niente da incollare, niente da digitare.
6. Avviare una nuova conversazione (oppure fare clic, nella stessa sezione, su «Riavvia l'IA desktop»). IRONSTICK compare allora tra i connettori dell'IA, e gli strumenti descritti più avanti sono disponibili in ogni conversazione.

La schermata di configurazione riporta i link di download e i link ai termini d'uso e all'informativa sulla privacy di ciascun fornitore.

3. Come gli accessi vengono mostrati nella barra dei menu

• Prima il consenso. Quando un'IA desktop accede ai dati per la prima volta nel corso di un'esecuzione del programma, IRONSTICK mostra una finestra di conferma bloccante. Rifiutare blocca quel canale per 10 minuti; acconsentire lo apre per il resto dell'esecuzione del programma.
• Un logo proprio di ciascuna IA compare nella barra superiore accanto all'indicatore CPU/RAM a ogni singola chiamata di strumento e resta acceso per 3 secondi dopo l'ultima chiamata — serie rapide di chiamate lo mantengono acceso senza interruzioni. Se il simbolo è spento, in quel momento non viene letto nulla. Ogni IA ha il proprio segno: la stella arancione di Claude, il nodo verde di OpenAI, il simbolo di chat viola di Qwen, la «K» color petrolio di Kimi.



• Il menu a tendina sul simbolo dell'IA mostra che cosa quell'IA ha letto nella sessione: la riga «Istruzioni di lavoro + divieto di allucinazione» (spunta verde finché è valida, croce rossa dopo la scadenza), poi per ogni caso i contrassegni Profilo, Giurisdizione e Digest più una barra «Documenti letti r di n».
• Il simbolo del cervello compare non appena la memoria IA condivisa contiene voci, e pulsa per 3 secondi ogni volta che un canale IA la legge o la scrive. Un clic apre la finestra di gestione; l'IA stessa non può mai cancellare la memoria.
• La navigazione da parte dell'IA (aprire schermate/casi/documenti) avviene solo se il relativo interruttore è attivo — altrimenti gli strumenti di navigazione vengono rifiutati.
• Accesso parallelo: se più IA con licenza lavorano contemporaneamente, la barra superiore mostra un logo pulsante per ogni IA attiva, uno accanto all'altro; ogni accesso viene sempre attribuito all'IA che lo ha effettuato.

4. Che cosa ci si fa — esempi

Parli con l'IA desktop (o con la chat interna all'app) in linguaggio naturale; sceglie da sé gli strumenti adatti. Richieste tipiche:

5. Nota sui dati

6. Riferimento tecnico

Seguono la panoramica dei gate, il catalogo completo dei 175 strumenti, le sezioni sui guardiani della diligenza e sul ciclo di verifica, nonché la descrizione tecnica. I nomi degli strumenti sono identificatori inglesi — esattamente come li vede l'IA.

4. I sedici gate deterministici anti-allucinazione e di sicurezza

IRONSTICK non cerca di educare l'IA collegata con dei prompt — impone la correttezza a livello strutturale. Sedici gate deterministici (pura logica, nessuna IA in alcun punto) si trovano tra il modello e i Suoi record. In tutto il catalogo degli strumenti che segue, gli strumenti protetti da un gate recano un contrassegno GATE.

Contesto e navigazione

Trovare il record giusto

Leggere un caso

Documenti e ricerca di passaggi

Giudici e decisioni giudiziarie

Cinque strumenti deterministici (nessuna IA in alcun punto) per una sola domanda: come decide un singolo giudice o pubblico ministero — che cosa accoglie delle memorie, che cosa trascura, quanto è prevedibile? Gli strumenti individuano e misurano; leggere le decisioni e giudicarle resta compito dell'IA, sui testi integrali. Contano come decisioni solo i documenti in entrata provenienti da un tribunale o da una procura.

Riparazione OCR tramite nuova scansione — micro-sourcing human-in-the-loop

Quando un testo integrale memorizzato risulta troncato o rovinato da una vecchia esecuzione OCR, l'IA non si limita a conviverci — ripara la banca dati, con Lei come autorità finale. Richiede una nuova scansione; Lei sceglie le pagine in IRONSTICK (lo stesso selettore di pagine dell'acquisizione documenti); la nuova scansione viene normalizzata in modo deterministico (filigrane rimosse, schemi OCR corretti, spaziature uniformate) e collocata nello spazio di scratch ACCANTO al testo attuale della banca dati. L'IA poi confronta le due versioni passaggio per passaggio, conserva quella corretta, ripara solo i danni meccanici dell'OCR — mai riformulando; numeri, nomi e importi restano intatti — e restituisce la versione riparata. IRONSTICK Gliela mostra per intero, e solo il SUO clic la salva come nuovo testo integrale.

Il passo oltre: l'avvocato come strumento di precisione. L'IA non usa IRONSTICK soltanto come fonte di dati — dove l'elaborazione automatica incontra limiti fisici, si rivolge deliberatamente a Lei come strumento visivo di precisione:

• Piena capacità anche con file giganteschi. Dove un PDF supera qualsiasi contesto dell'IA (il ponte impone limiti rigidi: 10 MB, 90 pagine), il processo non finisce con un inutile “file troppo grande” — l'IA indica invece il punto esatto: “pagina 12, in alto”.
• Micro-sforzo mirato invece di archeologia del fascicolo. Non deve mai setacciare un file di 200 pagine. Fa clic sulla graffetta nella voce che IRONSTICK ha già aperto per Lei, salta alla pagina indicata e trascrive esattamente le tre parole o cifre illeggibili.
• Ritorno diretto nel testo integrale. La Sua trascrizione viene ripresa alla lettera nella versione riparata, passa per la stessa finestra di accettazione, e l'analisi prosegue senza interruzioni.

I sistemi tradizionali conoscono esattamente due stati: “successo” (qualunque cosa l'OCR abbia prodotto, giusta o sbagliata) e “errore — elaborare il documento manualmente”. Qui l'avvocato diventa un micro-esecutore per esattamente lo 0,1 % di una scansione che l'IA non riesce a risolvere con certezza — una simbiosi tra la velocità dell'IA e la vista umana.

E-mail, calendario e scadenze

Persone, istituzioni e registri di lavoro

Regole di lavoro, formati e memoria

Proposte (con gate di revisione — mai scrittura diretta)

Spazio di scratch — i contenuti voluminosi non passano mai per l'IA

Un'area di lavoro locale. Qualsiasi chiamata di strumento può contenere to_scratch: il risultato completo viene allora scritto in un file di scratch e l'IA riceve solo il percorso e la dimensione — nessuna anteprima; e ogni risultato oltre il limite del connettore (10.000 caratteri; 20.000 per Claude Desktop e ChatGPT Desktop) vi finisce automaticamente, allo stesso modo — apritori dei set di strumenti compresi. I contenuti voluminosi non transitano per l'output dell'IA in NESSUNA delle due direzioni (più veloce, più economico, nessun errore di trascrizione). I percorsi di scratch sono direttamente utilizzabili come source_path per deliver_file e update_ki_instruction. L'archivio sopravvive ai riavvii: le note proprie dell'IA, il suo registro di stato e la contabilità della copertura di lettura persistono; i dump degli strumenti dei giorni precedenti vengono eliminati a ogni avvio, i file non toccati dopo 180 giorni.

L'archivio di scratch è un vault. Da settembre 2026 ogni file al suo interno è cifrato a riposo con AES-256, con la stessa derivazione della chiave della banca dati dei casi e dell'archivio documenti — nulla di ciò che l'IA scrive giace in chiaro sul disco. Lettura e scrittura passano solo attraverso il gate di IRONSTICK; un file in chiaro collocato nell'archivio per qualsiasi altra via (uno strumento del file system, una copia manuale) viene rifiutato, rimosso e segnalato all'IA come violazione delle regole. I file lasciano l'archivio solo attraverso la finestra di esportazione di IRONSTICK, mai verso una cartella di download. Insieme alla banca dati, all'archivio documenti e alla configurazione cifrati, ciò chiude l'ultima lacuna: nessun dato dei casi giace non cifrato sul disco dell'utente — nemmeno i file di lavoro dell'IA.

Nessuno strumento accorcia il proprio risultato. evidence_readfull, read_full_case, read_email_body, open_url (leggi e sentenze intere), read_tagesprotokolle, read_person e read_chronik consegnano sempre il loro contenuto COMPLETO. Un'unica regola centrale decide dove arriva: sotto il limite del connettore nella risposta, sopra di esso per intero nel file di scratch. L'IA non deve mai indovinare in anticipo quanto sarà grande un risultato.

Guardiano della freschezza: IRONSTICK sorveglia ogni file di scratch. Nel momento in cui i dati sottostanti cambiano — un nuovo documento o una nuova voce di cronaca nel caso esportato, una scrittura nel calendario o nel protocollo — o un file semplicemente invecchia, il suo contenuto viene sostituito da un avviso di invalidazione che indica all'IA esattamente come recuperarlo di nuovo. L'IA non può mai lavorare su dump silenziosamente obsoleti.

Web, registri e validazione

Revisione tra pari — passare un lavoro a UN'ALTRA IA desktop (Claude ⇄ ChatGPT ⇄ Qwen ⇄ Kimi)

Passaggio e consegna

7. Guardiani della diligenza — il ponte sorveglia l'etica di lavoro dell'IA

Quattro guardiani deterministici della diligenza sorvegliano con quanta cura l'IA collegata lavori effettivamente. Sono pura contabilità e logica di stringhe — nessuna IA coinvolta in alcun punto — perciò non possono allucinare, non costano praticamente nulla e non possono essere dissuasi da nulla:

• Guardiano della copertura di lettura. Quando l'IA richiede un dump dell'intero caso, i file di preparazione di un caso o un testo integrale oltre il limite del connettore, il ponte registra riga per riga quali intervalli ha davvero letto — e conserva questa contabilità anche dopo i riavvii. Finché restano lacune, ogni risposta degli strumenti — ricerche, grep, tutto — reca gli esatti intervalli di righe non letti con una percentuale. Un “ho letto tutto” dichiarato è semplicemente impossibile; solo una lettura completa ottiene l'unica conferma “COMPLETE — tutte le righe lette”, una fine matematicamente dimostrabile dell'obbligo di lettura — e registra la lettura nel registro di preparazione.
• Nessuna anteprima. Qualsiasi risultato oltre il limite del connettore (10.000 caratteri; 20.000 per Claude Desktop e ChatGPT Desktop) viene scritto per intero nell'archivio di scratch; l'IA riceve solo una nota che indica il file, la sua dimensione e i due comandi di proseguimento. Nulla viene mostrato due volte, e l'IA legge i contenuti voluminosi là dove risiedono. Ciò vale per ogni strumento — apritori dei set di strumenti compresi; rispondono direttamente solo il lettore delle istruzioni e gli strumenti di scratch stessi. E nessuno strumento accorcia il proprio risultato: sotto il limite arriva completo nella risposta, sopra di esso completo nell'archivio di scratch.
• Guardiano della riconsegna. Se l'IA continua a correggere un file di lavoro dopo che Le è già stato consegnato, a ogni ulteriore modifica si risponde con il promemoria che in questo momento Lei ha in mano la versione superata e che il file corretto deve essere consegnato di nuovo — basta con i silenziosi “l'ho corretto nella cartella delle bozze”.
• Guardiano delle bozze non consegnate. Quando l'IA scrive il suo protocollo giornaliero — il segnale “sto concludendo” — il ponte elenca per nome ogni bozza versionata scritta nella sessione che non è mai stata consegnata. Il lavoro finito non può restare silenziosamente bloccato nell'archivio di lavoro dell'IA.
• Guardiano del formato e-mail. Ogni accesso ai contenuti delle e-mail reca automaticamente il rimando vincolante allo strumento del formato mail (riquadro da copiare per l'oggetto, riquadro da copiare per il corpo, contenuti obbligatori, regole linguistiche) — all'IA viene ricordata l'unica via di consegna corretta prima che possa improvvisarne una.
• Guardiano del riquadro da copiare. Ogni volta che l'IA scrive o modifica un file di lavoro testuale, la risposta reca il promemoria che i documenti raggiungono l'utente solo attraverso lo strumento di consegna — incollare una lettera finita nella chat come testo o in un riquadro da copiare aggira formattazione, verifica e tracciamento della consegna ed è una violazione visibile delle regole. L'unico artefatto legittimo in riquadro da copiare resta l'e-mail, esattamente secondo lo strumento del formato mail.
• Ancora del caso. Ogni risposta degli strumenti che riguarda un caso reca il numero registrato, il cliente e l'oggetto del caso (gate 10) — il contesto inventato dalla memoria di un altro caso si smentisce da sé nella stessa finestra.
• Guida del livello di modello. Le istruzioni indicano all'IA quale classe di modello richiede un compito: prima degli strumenti per gli atti (formato di output, verifica, consegna) Le chiede in una frase di passare il client desktop al modello di punta, e dopo la consegna Le comunica che un modello più economico è di nuovo sufficiente. Quando i contatori delle proposte indicano la cura della rete delle parti (due proposte anagrafiche e una proposta di relazione o di collegamento al caso), il ponte aggiunge — una volta per sessione — l'indicazione che questo lavoro interamente protetto da gate non richiede un modello di punta. Decide Lei; l'IA continua a lavorare.

Dalla stessa versione, anche l'esecuzione degli strumenti avviene in un thread di lavoro isolato all'interno dell'applicazione — nemmeno accessi dell'IA di diversi secondi a grandi fascicoli rallentano più l'interfaccia utente di IRONSTICK.

8. Il compilatore degli atti — consegna solo dietro prova

Atti e lettere vengono scritti in dialogo con l'IA desktop sul fascicolo dal vivo — lo stesso livello di lavoro e gli stessi gate della chat propria di IRONSTICK. Ciò che lascia il sistema è un modello pronto per il deposito, mai un atto giudiziario finito: Lei lo rivede, lo corregge e lo firma. Due gate si trovano davanti a ogni passaggio: la verifica deterministica descritta di seguito, e — se Lei lo attiva nella configurazione per il modello API attivo — il Red/Blue Team: un secondo modello legge la bozza come avvocato avversario; i rilievi sostanziali la rimandano indietro per la rielaborazione, al massimo due round, ogni punto analizzato nel merito e mai adottato ciecamente. Se l'IA ritiene i rilievi infondati, ripresenta il file invariato con una risposta scritta a ciascun rilievo — il revisore non viene eseguito una seconda volta su un file invariato, e il rapporto del revisore Le arriva insieme a quelle risposte. Il passaggio stesso avviene attraverso la finestra di esportazione di IRONSTICK, da cui la bozza passa al word processor con un clic.

Un atto formale non può lasciare il sistema sulla fiducia. verify_pleading, uno scanner deterministico (nessuna IA coinvolta in alcun punto), controlla la bozza finita rispetto ai Suoi record dal vivo e alla biblioteca giuridica verificata lungo otto classi di affermazioni:

• Riferimenti alle prove — timbri IS e numeri #, nell'elenco degli allegati E nel corpo del testo: esistenza, appartenenza, integrità del timbro, e provenienza delle citazioni legata al documento: ogni elemento citato o allegato deve risultare letto per QUESTO documento — recuperato per intero, oppure con il suo file di scratch letto al 100 %; una lettura vale 2 ore, ogni consegna dello stesso documento la proroga, verificare un altro documento azzera le letture degli allegati. Citare da estratti di ricerca o a memoria non supera la verifica. Una riga di allegato può dichiarare un intervallo di pagine (“pag. 12–15”); l'obbligo di lettura resta l'intero documento.
• Citazioni normative — l'articolo citato deve esistere nel testo della biblioteca verificata (tollerante al punto delle migliaia, esatto ai confini di parola) E recare la provenienza di lettura: l'IA deve aver effettivamente estratto quell'articolo dalla biblioteca in questa esecuzione dell'applicazione — articoli di stampa, sintesi web e memoria del modello non fondano mai una norma e non superano la verifica. Anche i sotto-riferimenti citati (comma/punto) vengono verificati nella loro esistenza. Una fonte mancante dalla biblioteca non passa inosservata: l'IA deve richiederla, e la richiesta finisce nella Sua finestra di consenso — le fonti spuntate vengono recuperate, verificate e memorizzate; quelle non spuntate vengono rifiutate e ogni loro citazione successiva reca una nota visibile “rifiutata dall'utente”.
• Citazioni testuali — ogni passaggio citato deve essere trovato per intero nei testi integrali del caso o nella biblioteca giuridica (tollerante agli errori OCR). Una citazione non trovata in alcuna fonte è CONTRADICTED e blocca la consegna. Togliere le virgolette o riformulare leggermente il passaggio non serve: la citazione bloccata viene ricordata per quel documento e resta bloccata. Una citazione eliminata del tutto è consentita — e la consegna Le indica espressamente quali citazioni sono state rimosse perché nessuna fonte le contiene.
• Numeri di dosar rispetto ai Suoi casi e record.
• Importi a tolleranza ZERO — la cifra deve corrispondere esattamente alla forma registrata; “14.500” dove il registro riporta “14.500,00” blocca la consegna fino alla correzione.
• Anagrafiche delle parti — ogni nome usato deve corrispondere alla grafia registrata lettera per lettera, segni diacritici compresi.
• CNP e IBAN — validazione della somma di controllo (una cifra di controllo non valida è sempre un'allucinazione) più corrispondenza con registro/record.
• Parti nominate — ogni persona o società nominata nel documento deve essere stata letta (profilo) E verificata nelle sue connessioni (who_is_connected_with); il rifiuto indica le due chiamate e raccomanda in aggiunta il test delle cricche (read_cliques).

Ogni rilievo è VERIFIED, UNVERIFIED o CONTRADICTED. La consegna di un documento formale viene rifiutata senza una nuova attestazione OK per l'esatto stato del file — ogni modifica annulla l'attestazione. Dopo cinque esecuzioni di verifica fallite il ciclo si interrompe in modo definitivo, ordina all'IA di fermarsi e riferire, e avvisa Lei direttamente nell'applicazione. E le consegne passano esclusivamente per l'archivio di lavoro proprio dell'applicazione, così che attestazione, versionamento e tracciamento delle riconsegne restino legati a ogni file — la consegna in linea e i percorsi esterni vengono rifiutati.

Appendice — Descrizione tecnica completa del ponte

Stato: 175 strumenti membro · 20 set di strumenti · revisione del protocollo MCP 2024-11-05. Il presente documento descrive il ponte in modo esaustivo — architettura, ogni livello funzionale, ogni gate, ogni limite e ogni reindirizzamento — esclusivamente in prosa.

1. Scopo e posizionamento

Il ponte collega applicazioni commerciali di IA desktop (Claude Desktop, ChatGPT Desktop, Qwen Desktop, Kimi Desktop) a un'applicazione di gestione dei casi legali IRONSTICK in esecuzione sullo stesso computer. L'IA desktop riceve una superficie di strumenti controllata e autodescrittiva tramite il Model Context Protocol (MCP); ogni chiamata viene eseguita all'interno dell'applicazione IRONSTICK sulla banca dati dal vivo, e ogni risultato viene post-elaborato dal ponte prima di raggiungere il modello. Gli obiettivi di progettazione sono: carico di contesto permanente minimo sul modello, imposizione strutturale di regole di lavoro che un semplice testo di istruzioni non può garantire, protezione del lavoro non salvato dell'utente, protezione dei dati da richieste sovradimensionate o mal indirizzate, e completa assenza di materiale di configurazione leggibile nel prodotto installato.

2. Topologia dei processi

Il ponte è composto da due processi che cooperano.

L'applicazione IRONSTICK ospita un server HTTP legato esclusivamente all'interfaccia di loopback. La sua porta e un token di accesso esadecimale di 48 caratteri sono definiti nell'archivio di configurazione dell'applicazione; ogni richiesta deve presentare il token. Questo server possiede il registro degli strumenti, esegue tutte le chiamate di strumento, applica tutti i gate e i post-processori, ed è l'unica fonte di verità su ciò che un modello collegato può vedere e fare.

Davanti a ciascuna IA desktop si trova un piccolo eseguibile nativo compilato ahead-of-time da Dart. Parla JSON-RPC su stdio verso l'IA desktop (trasporto MCP standard) e inoltra il lavoro al server HTTP dell'applicazione. Ogni IA desktop ha la propria directory di installazione, che contiene una copia di questo eseguibile e un file di configurazione privato con: la porta di loopback, il token di accesso, una stringa di identità del chiamante (per esempio claudedesktop, chatgptdesktop, qwendesktop), il percorso del file di istruzioni servito all'avvio della sessione e il percorso dello script di consegna. L'identità del chiamante viaggia con ogni chiamata di strumento come argomento interno e determina tutti i comportamenti specifici per IA descritti più avanti. Il front-end invia inoltre all'applicazione un segnale di presenza (heartbeat) circa ogni tre secondi mentre un'IA desktop è collegata; l'applicazione lo mostra come indicatore di presenza «ponte collegato» con una durata di validità di quindici secondi, così che l'utente veda sempre se un'IA esterna è attualmente collegata.

Durante l'handshake MCP di inizializzazione il front-end restituisce la propria identità di server e, incorporato nel risultato dell'inizializzazione, il testo completo delle istruzioni di avvio della sessione. I front-end dalla versione 2.6.6 in poi cercano un file compagno del percorso di istruzioni configurato, il cui nome reca un suffisso core, e lo preferiscono; questo fornisce un'istruzione di base condensata di circa quindicimila e cinquecento caratteri invece del playbook completo di circa cinquantaseimila, riducendo il carico permanente delle istruzioni a circa un quarto. Il playbook completo resta sempre disponibile al modello tramite uno strumento dedicato (vedi sezione 5).

3. Sicurezza, licenze e consenso

Tutto il traffico avviene esclusivamente in loopback ed è autenticato tramite token. Gli strumenti di accesso al web applicano un filtraggio delle richieste lato server: sono ammesse solo destinazioni http e https pubbliche; localhost, intervalli di loopback, reti private e indirizzi link-local vengono respinti, così che un modello non possa mai essere indotto, tramite il ponte, a scansionare il computer o la LAN.

Il ponte e le integrazioni desktop per i singoli fornitori sono moduli aggiuntivi con licenza separata. La loro disponibilità è codificata come bit in una chiave di licenza firmata; il front-end e la superficie di strumenti di un modulo senza licenza semplicemente non vengono creati.

Per il collegamento con Claude Desktop un gate di consenso protegge il primo accesso ai dati per ogni esecuzione dell'applicazione: la prima chiamata di strumento dopo l'avvio del programma fa comparire una finestra di avviso sopra la schermata corrente. Se l'utente approva, l'accesso è libero per il resto dell'esecuzione; se l'utente rifiuta, l'accesso è bloccato per dieci minuti e ogni chiamata bloccata restituisce all'IA desktop un messaggio esplicativo che le chiede di riprovare più tardi; trascorsi i dieci minuti, l'accesso successivo fa comparire di nuovo l'avviso. Lo stato è mantenuto solo in memoria e mai reso persistente.

Indipendentemente dal consenso, un blocco di accesso alle istruzioni protegge ogni collegamento desktop: nessuno strumento — apritori dei set di strumenti, lo strumento di esecuzione dei membri, tutto — viene eseguito finché il chiamante non ha letto le istruzioni e restituito alla lettera il divieto di allucinazione (regola 5) tramite lo strumento di conferma; restano aperti solo il lettore delle istruzioni, lo strumento di conferma e lo strumento della lingua di sistema. La conferma è legata alla singola IA desktop e decade sessanta minuti dopo essere stata data, dopo due ore senza chiamate, a mezzanotte e a ogni nuovo handshake di connessione — dopo una decadenza il chiamante deve rileggere e restituire una regola scelta a caso invece di quella che conosce a memoria. Nel collegamento con Claude ogni chat è un chiamante a sé (distinto tramite gli eventi strutturati degli strumenti nel registro di sessione locale di Claude, mai tramite il testo della conversazione), una chat il cui contesto è stato compattato viene bloccata subito, senza penalità, finché non ha riletto, e a una chat che accede alla cartella dei dati con i propri strumenti di file invece che tramite il connettore ciò viene registrato come violazione delle regole; un rifiuto indica le due chiamate che aprono il blocco, e il menu a tendina sul simbolo dell'IA nell'applicazione mostra lo stato come spunta verde o croce rossa.

Ogni funzione di lettura e di scrittura dei dati viene convalidata rispetto all'identità del titolare derivata dalla licenza. I record di prova contrassegnati come segreti sono esclusi senza eccezione da ogni funzione di lettura, ricerca, dump e timbratura; i record contrassegnati come cancellati sono ugualmente invisibili.

4. Sistema delle istruzioni

La guida del modello arriva in tre livelli, con specificità strettamente crescente e permanenza strettamente decrescente.

L'istruzione di base viene consegnata una sola volta, all'interno del risultato dell'inizializzazione. Contiene il mandato (lavoro giuridico basato sui fatti al livello di un senior associate), le regole universali (la lingua del dialogo è la lingua di sistema di IRONSTICK; la giurisdizione dei documenti generati deriva dal caso, mai dal dialogo; disciplina delle date; nessuna citazione da estratti di ricerca — ogni pagina su cui l'IA fa affidamento deve essere aperta e letta tramite open_url, qualunque ricerca l'abbia trovata; disciplina delle citazioni e dei riferimenti; il limite di tre tentativi per ogni chiamata di strumento che fallisce; disciplina della consegna) e la descrizione del meccanismo dei set di strumenti stesso, compresa la spiegazione del campo del set di strumenti di appartenenza descritto nella sezione 6.

Le regole di lavoro per area non sono permanenti: vengono consegnate al modello alla lettera e aggiornate ogni volta che apre il set di strumenti corrispondente, come parte del contenuto di apertura.

Il playbook completo — base più tutte le regole dei set di strumenti più le appendici (tra cui il formato del file del protocollo giornaliero) — può essere riletto in qualsiasi momento tramite lo strumento di lettura delle istruzioni; il front-end legge il file dal vivo, così che le modifiche alle istruzioni raggiungano una sessione in corso senza riconnessione.

Tre di queste regole sono inoltre imposte a livello strutturale anziché testuale, tramite i gate descritti nelle sezioni 3 e 7: il blocco di accesso, la disciplina delle date e la disciplina delle fonti normative. La lettura delle istruzioni stessa è l'ultima regola del blocco universale: il modo per sbloccare il connettore è indicato solo dopo tutte le regole precedenti, così che un modello che vi arriva le abbia lette.

5. La superficie degli strumenti e il livello dei set di strumenti

Un elenco piatto di 175 strumenti peggiora in modo misurabile la scelta degli strumenti nei modelli desktop attuali. Il ponte espone quindi una superficie ridotta di ventotto voci: sei strumenti di base (data e ora correnti; contesto GUI attuale; lingua di sistema; giurisdizione del caso; rilettura delle istruzioni; conferma delle istruzioni), lo strumento di consegna inserito dal front-end, venti apritori di set di strumenti, lo strumento di esecuzione dei membri e lo strumento dell'inventario completo. Tutto il resto esiste solo come membro all'interno dei set di strumenti.

Aprire un set di strumenti è una normale chiamata di strumento senza argomenti. La risposta fornisce, in un colpo solo: primo, dove il set di strumenti ne ha uno, un blocco di contesto pregenerato in modo deterministico e calcolato al momento dell'apertura (otto set di strumenti hanno tali generatori — il protocollo di avvio della sessione stesso; l'inventario attuale dei file di scratch; le dieci voci di memoria più recenti come anteprima; le prime trenta leggi della biblioteca giuridica; l'elenco dei casi caldi; i documenti registrati e le e-mail in arrivo di oggi; il protocollo giornaliero di oggi; l'istantanea attuale di scadenze e appuntamenti); secondo, le regole di lavoro dell'area alla lettera; terzo, le definizioni complete degli strumenti membro con i loro schemi di parametri completi; quarto, una riga di ripiego che rimanda all'inventario completo. Un errore all'interno di un generatore di pregenerazione non impedisce mai l'apertura.

I membri vengono eseguiti tramite lo strumento di esecuzione dei membri, che riceve il nome esatto del membro e un oggetto di argomenti. Prima dell'esecuzione viene effettuata una leggera validazione dello schema: i campi obbligatori devono essere presenti e non vuoti, e i parametri interi, numerici e booleani devono poter essere interpretati come tali; una violazione restituisce lo schema atteso invece di eseguire. Un nome di membro sconosciuto restituisce come suggerimento il nome esistente più vicino per distanza di modifica. Il livello delle istruzioni limita i tentativi di correzione a tre per ogni chiamata che fallisce, dopodiché il modello deve fermarsi e riferire l'errore esatto.

I set di strumenti non sono modali; tutti gli apritori restano richiamabili in ogni momento, uno strumento può deliberatamente essere membro di più set di strumenti, e i contenuti di apertura non vengono mai deviati nell'archivio di scratch (degli schemi in un file sarebbero inutili). I gate funzionali rimuovono interi gruppi: quando la navigazione GUI non è abilitata dall'utente, l'apritore del set di strumenti di navigazione e tutti i suoi membri sono assenti da ogni elenco e da ogni risposta. Lo strumento dell'inventario completo elenca ogni membro con uno scopo di una riga e il suo set di strumenti di appartenenza ed esiste solo come via d'uscita; le descrizioni dei set di strumenti sono l'instradatore principale. In totale i venti set di strumenti contengono 280 voci di membri sui 175 strumenti distinti.

Il costo di contesto misurato di questa disposizione: la configurazione iniziale (istruzione di base più elenco ridotto degli strumenti) è di circa diecimila token; una singola apertura di un set di strumenti aggiunge tra circa novecento e settemilacinquecento token a seconda del set di strumenti, prima del suo contenuto variabile di pregenerazione.

6. Formato di definizione degli strumenti e relativa catena di produzione

Ogni definizione di strumento è composta da quattro parti. La descrizione contiene lo scopo dello strumento, i suoi mandati comportamentali e i suoi rimandi — e nient'altro. Lo schema di input contiene ogni parametro con la propria descrizione, compresi valori predefiniti, formati, note di mutua esclusività e mandati per singolo parametro; le istruzioni d'uso dei parametri risiedono esclusivamente qui. Il campo di output descrive, prima di qualsiasi chiamata, esattamente che cosa restituisce la chiamata, compresi ordinamenti, marcatori e forme di errore, così che il modello possa giudicarne l'idoneità senza chiamate di prova. Il campo del set di strumenti di appartenenza indica il set di strumenti a cui lo strumento appartiene principalmente, con un valore riservato che contrassegna gli strumenti di base sempre presenti nell'elenco di primo livello; un membro incontrato all'interno di un set di strumenti estraneo indica così dove si trovano altri strumenti della sua famiglia, e ogni apertura di un set di strumenti reca una riga esplicativa che afferma che il modello non è mai vincolato al set di strumenti aperto.

Tutto il testo destinato al modello è in inglese senza eccezioni. La catena di produzione va da un unico documento sorgente canonico, tramite generatori, all'overlay compilato nel programma e al progetto dei cluster che documenta la topologia dei set di strumenti; il generatore si interrompe in modo definitivo quando una qualsiasi descrizione o testo di output — a qualsiasi profondità dello schema — corrisponde a un rilevatore di lingua tedesca, e un guardiano della deriva interrompe la sincronizzazione quando la dichiarazione di appartenenza di uno strumento punta a un set di strumenti che non elenca effettivamente lo strumento come membro. I limiti numerici dichiarati negli schemi degli strumenti sono imposti da una funzione ausiliaria di limitazione condivisa nelle funzioni esecutive, così che un massimo dichiarato sia un massimo reale.

7. Meccanismi universali di runtime

I seguenti meccanismi valgono per l'intera superficie degli strumenti e sono implementati centralmente, non per singolo strumento.

Reindirizzamento su richiesta nello scratch: ogni strumento accetta un parametro aggiuntivo che indica un file di scratch; se impostato, il risultato completo viene scritto in quel file e il modello riceve solo il percorso e la dimensione — nessuna anteprima. I contenuti voluminosi non transitano così mai nel flusso di token del modello in nessuna delle due direzioni, e il percorso è direttamente utilizzabile ovunque sia accettato un percorso sorgente.

Protezione dal superamento: qualsiasi risultato che superi il limite del connettore — diecimila caratteri, un'unica costante centrale, raddoppiata a ventimila per Claude Desktop e ChatGPT Desktop — viene scritto automaticamente in un file di scratch generato. Il modello riceve solo una nota che indica la dimensione totale e il numero di righe, il nome del file, l'esplicita garanzia che nulla è andato perso, i due comandi di proseguimento (lettura per intervalli; ricerca per schema nel file) e l'espresso divieto di ripetere la chiamata — nessuna anteprima, così che i contenuti voluminosi vengano letti là dove risiedono e il modello si abitui a lavorare dall'archivio di scratch. L'unica eccezione è il lettore delle istruzioni, il cui pacchetto arriva sempre completo; gli apritori dei set di strumenti vengono deviati come ogni altro risultato. Nessuno strumento accorcia il proprio risultato — il limite del connettore è l'unico punto in cui si decide sulla dimensione. I risultati oltre i dieci megabyte non vengono deviati, ma ricevono in risposta un'istruzione di restringimento che indica i filtri applicabili, poiché anche l'archivio di scratch limita lì la dimensione dei file. Sono esenti dalla deviazione gli strumenti di lettura dello scratch stessi (limitati internamente; deviarli creerebbe una ricorsione) e le chiamate che hanno già richiesto il reindirizzamento nello scratch.

Gate della data: ogni strumento che scrive in IRONSTICK viene rifiutato ai chiamanti esterni a meno che quel chiamante non abbia recuperato la data e l'ora correnti negli ultimi trenta minuti. Il rifiuto indica il rimedio — recuperare l'ora, poi ripetere la chiamata identica. La finestra è legata al singolo fornitore, volutamente breve, così che una nuova conversazione non possa ereditare un vecchio recupero e che i passaggi della mezzanotte vengano intercettati. I chiamanti interni all'app non sono interessati. Questo esiste perché altrimenti i modelli esterni timbrano i record con l'«oggi» della loro epoca di addestramento.

Gate delle norme: l'accesso al web per leggi e norme è rifiutato strutturalmente finché non è stata consultata la biblioteca giuridica interna; il rifiuto rimanda alla procedura della biblioteca. Qualsiasi fonte normativa che venga comunque recuperata dal web deve essere segnalata alla biblioteca tramite lo strumento di registrazione — il livello delle istruzioni classifica l'omissione come violazione di un dovere, e i risultati che riguardano fonti giuridiche recano un marcatore ai fini della verificabilità.

Blocco rigido della navigazione: otto schermate sono dichiarate protette — i quattro moduli di acquisizione (acquisizione documenti, acquisizione documenti legata al caso, acquisizione della cronaca del caso, acquisizione cliente), il modulo di creazione del caso, il modulo di assegnazione istituzione/persona e l'editor di testo. Mentre la finestra principale dell'utente mostra una qualsiasi di esse, ogni funzione di navigazione GUI e di esportazione viene rifiutata a livello di handler — il wrapper intercetta allo stesso modo le chiamate dirette e l'esecuzione dei membri — con un messaggio che indica la schermata protetta, vieta la navigazione e istruisce il modello a rispondere con i dati di cui dispone e a proporre l'apertura solo dopo che l'utente ha terminato e salvato. Un modello non può quindi mai distruggere il lavoro non salvato dell'utente cambiando schermata. Lo strumento di apertura delle pagine web è esplicitamente esente da questo wrapper, poiché condivide il prefisso del nome ma non naviga nell'applicazione.

Offerta di navigazione: i risultati della quarantina circa di strumenti il cui output descrive un oggetto apribile nella GUI — un caso, una persona, un'istituzione, un cliente, una prova specifica, un'e-mail, voci di calendario o scadenze — ricevono una riga aggiunta che suggerisce al modello di offrire all'utente di aprire l'oggetto direttamente in IRONSTICK, indicando l'esatta chiamata di navigazione. Dove gli argomenti della chiamata contengono l'identificativo dell'oggetto la proposta è concreta; per i risultati di ricerca e di elenco fa riferimento all'identificativo di un risultato. La riga richiede esplicitamente il consenso dell'utente prima di navigare, a meno che la richiesta dell'utente non fosse già un comando di visualizzazione/apertura. L'offerta viene aggiunta solo dopo la gestione del superamento, e solo quando il risultato non è un errore, la navigazione è abilitata e il blocco rigido della navigazione non è attivo — il blocco prevale sempre sulla proposta.

Propagazione del chiamante: l'identità del chiamante accompagna ogni esecuzione e determina lo stato per singola IA — il briefing di lavoro una volta al giorno è tracciato per ogni IA desktop, gli elenchi dei compiti di revisione tra pari escludono i compiti propri del chiamante, e il registro delle chiamate attribuisce ogni riga.

Registro delle chiamate: un registro diagnostico attivabile registra una riga per ogni chiamata di strumento di tutte le IA collegate — marca temporale, chiamante, il nome effettivo dello strumento (per l'esecuzione dei membri il membro interno, non il wrapper), gli argomenti limitati a trecento caratteri, la dimensione del risultato misurata prima di qualsiasi deviazione per superamento, la durata dell'esecuzione e un indicatore di errore. L'interruttore si trova nell'archivio di configurazione dell'applicazione e viene riletto con una cache di dieci secondi, così che la registrazione possa essere attivata o disattivata senza riavvio. Esiste per l'analisi dei percorsi e l'ottimizzazione dei set di strumenti ed è pensato per essere disattivato in seguito.

Riduzione di segni diacritici e scritture: ogni ricerca per parola chiave, ricerca per schema e confronto in tutto il ponte ignora maiuscole/minuscole e segni diacritici per tutte le undici lingue di sistema, compresa la i turca con e senza punto (sostituita prima della conversione in minuscolo, poiché altrimenti cambia la lunghezza), le lettere varianti cirilliche e le legature latine; la riduzione è stabile nelle posizioni laddove vengono riportate posizioni.

Convenzioni sui risultati: gli errori vengono restituiti come testo che inizia con un prefisso di errore e contrassegnati come errori nel risultato MCP; il modello è istruito a correggere e riprovare al massimo tre volte, poi a fermarsi e riferire. I marcatori strutturati e autodescrittivi incorporati nei risultati (per operazioni di memoria, gate e simili) sono stabili e documentati nei rispettivi campi di output.

Guardiano della copertura di lettura: quando un modello richiede un dump dell'intero caso o la consegna nello scratch del lettore dell'intero caso, il ponte registra con esattezza di riga quali intervalli del file di dump sono stati effettivamente letti. Finché restano intervalli non letti, ogni risposta riuscita di uno strumento — ricerche, corrispondenze di schemi, tutto — reca gli esatti intervalli di righe non letti insieme a una percentuale di lettura; una lettura completa dichiarata è quindi impossibile. Una volta che il file è stato letto per intero, i richiami cessano e la successiva lettura per intervalli conferma una sola volta che tutte le righe sono state lette, dando al modello una fine dimostrabile del suo obbligo di lettura. Sono tracciati i dump dell'intero caso, i file di intestazione e di digest dello strumento di preparazione del caso e ogni testo integrale di documento deviato nell'archivio di scratch; le letture parziali di altri risultati reindirizzati restano legittime e silenziose. Lo stato della copertura è reso persistente accanto all'archivio e sopravvive ai riavvii dell'applicazione, e un file letto fino in fondo viene registrato nel registro di preparazione — la lettura resta valida anche dopo che la pulizia all'avvio ha rimosso il file.

Guardiano della riconsegna: dopo una consegna di file riuscita la cui sorgente si trova nell'archivio di scratch, un file marcatore accanto all'archivio registra il nome e l'ora della consegna (anche le consegne passate come contenuto in linea vengono registrate con il loro nome di consegna). Ogni successiva modifica, scrittura o normalizzazione di un file lì registrato riceve in risposta il promemoria che l'utente ha in mano la versione consegnata superata e che il file corretto deve essere consegnato di nuovo con un nuovo numero di versione. La risposta alla consegna recupera inoltre dall'applicazione lo stato attuale della copertura di lettura tramite un endpoint interno che non è uno strumento, e rimprovera una consegna effettuata nonostante intervalli non letti.

Guardiano delle bozze non consegnate: l'aggiunta al protocollo giornaliero — il segnale di chiusura del modello — elenca per nome ogni file di lavoro versionato scritto dal modello nella sessione che non è mai stato consegnato, con l'istruzione di consegnare ora l'artefatto finito; un lavoro che esiste solo nell'archivio di scratch non raggiunge mai l'utente.

Guardiano del formato e-mail: ogni risposta degli strumenti di lettura e di scaricamento delle e-mail reca il rimando fisso secondo cui l'istruzione vincolante per la formattazione e la consegna delle e-mail — riquadro da copiare per l'oggetto, riquadro da copiare per il corpo, sezione dei destinatari, contenuti obbligatori, regole linguistiche — proviene dallo strumento di specifica del formato mail, da recuperare prima di costruire qualsiasi e-mail e da seguire alla lettera.

Esecuzione in un isolate di lavoro: il nucleo computazionale degli strumenti di dati e di analisi viene eseguito in un isolate di lavoro dedicato all'interno dell'applicazione, con il proprio registro e le proprie connessioni alla banca dati; l'isolate dell'interfaccia dell'applicazione si limita a instradare, applicare i gate e post-elaborare. Nemmeno accessi di diversi secondi a grandi fascicoli rallentano quindi mai l'interfaccia utente dell'applicazione; se il worker termina, l'esecuzione ripiega senza soluzione di continuità sull'isolate dell'interfaccia e il worker viene ricreato alla prima occasione. Gli strumenti che per loro natura richiedono l'isolate dell'interfaccia — navigazione, finestre di conferma, il browser integrato, il recupero della posta e gli strumenti di scrittura protetti dal gate di revisione — sono esclusi per progettazione dall'instradamento verso il worker.

8. Gate di interazione

Tre strumenti rispondono deliberatamente alla loro prima chiamata con una domanda invece che con un risultato; in tutti la risposta letterale "unknown" è sempre valida e mai sanzionata.

Il gate di consegna: lo strumento di consegna dei file, chiamato senza la dichiarazione di formalità, non consegna nulla e chiede se la consegna rientra in uno dei quattro tipi di artefatto formale — atto giuridico, e-mail al tribunale, voce di cronaca, protocollo giornaliero — o in nessuno di essi. Rispondere «no» consegna immediatamente — ma la dichiarazione viene verificata nel contenuto: un rilevatore deterministico esamina il file, e un contenuto con la forma di una lettera o di un atto (formule di saluto e di chiusura in sei lingue, un blocco del destinatario, marcatori giuridici, un blocco identificativo) respinge la dichiarazione di informalità e registra il tentativo; un simile contenuto non ha alcuna via informale. Rispondere con un tipo formale restituisce, sempre senza consegnare, l'istruzione di formattazione vincolante esattamente per quel tipo, incorporata nella risposta del gate; solo la chiamata ripetuta che reca l'indicatore di conferma che il file è stato verificato rispetto a questa istruzione consegna effettivamente. Un guardiano della serie di versioni rifiuta inoltre la prima consegna con una nuova radice del nome file mentre nella cartella di consegna esiste già una serie versionata con lo stesso numero di caso — rinominare un documento per azzerarne il contatore di versione è strutturalmente impossibile; un documento realmente diverso richiede una dichiarazione consapevole e registrata. Questo gate è implementato all'interno dell'eseguibile del front-end stesso, che recupera dal vivo l'istruzione di formattazione attuale dall'applicazione. Documenti e lettere non raggiungono mai l'utente come testo di chat o riquadri da copiare — ogni accesso in scrittura a un file di lavoro testuale reca questo promemoria, e l'unico artefatto legittimo in riquadro da copiare resta l'e-mail secondo il suo strumento di formato.

Il gate di ricerca: la ricerca centrale delle prove, alla sua prima chiamata, non cerca nulla e chiede tre cose — che tipo di elemento si cerca (documento in entrata, documento in uscita, prova con documento allegato, dichiarazione/trascrizione, nota di cronaca, o sconosciuto), l'ambito quando è presente un identificativo del cliente (solo questo caso, tutti i casi del cliente, o sconosciuto — con l'elenco dei casi del cliente incluso nella domanda) e la forma di risposta desiderata. Le forme di risposta sono: un elenco pulito di identificativi (l'impostazione predefinita raccomandata; i risultati vengono poi aperti singolarmente tramite il lettore delle prove), risultati compatti con il contesto della corrispondenza, oppure il risultato completo scritto in un unico file di scratch.

Il gate dell'intero caso: il lettore dell'intero caso, alla sua prima chiamata, non carica nulla e riferisce quanto è effettivamente grande il caso — il numero di prove e il volume complessivo approssimativo dei contenuti tra titoli, descrizioni, testi integrali dei documenti e trascrizioni — poi chiede al modello di decidere tra strumenti di ricerca mirati e una chiamata ripetuta con l'argomento di consegna nello scratch, che scrive il contenuto completo del caso, normalizzato rispetto all'OCR, nell'archivio di scratch e restituisce solo il riferimento al file.

Il gate di verifica: per gli atti formali lo strumento di consegna richiede inoltre una nuova attestazione del verificatore deterministico degli atti. Tale verificatore analizza il file di scratch finito lungo otto classi di affermazioni — riferimenti alle prove nell'elenco degli allegati e nel corpo del testo (timbri e numeri, compresa la provenienza delle citazioni legata al documento: ogni elemento citato o allegato deve risultare letto per questo documento — recuperato per intero o con il suo file di scratch letto fino in fondo; una lettura vale due ore, ogni consegna dello stesso documento proroga di due ore i suoi elementi citati, e verificare o consegnare un documento con una radice diversa azzera le letture degli allegati; una riga di allegato può dichiarare un intervallo di pagine, l'obbligo di lettura resta l'intero documento), citazioni normative rispetto alla biblioteca verificata (un articolo assente dal testo normativo verificato è un rilievo contraddetto; la citazione richiede inoltre la provenienza di lettura — ogni lettura dalla biblioteca viene registrata per ogni esecuzione dell'applicazione con i numeri degli articoli effettivamente restituiti, e un articolo citato senza tale registrazione di lettura è un rilievo contraddetto, così che articoli di stampa, sintesi web e memoria del modello non possano mai fondare una norma; i sotto-riferimenti citati come comma e punto vengono verificati nella loro esistenza nella regione di testo dell'articolo; una fonte assente dalla biblioteca blocca finché non viene integrata o rifiutata), citazioni testuali — ciascuna deve essere trovata per intero nei testi integrali del caso o nella biblioteca giuridica; una citazione non trovata in alcuna fonte è contraddetta e blocca la consegna, una citazione da cui sono state solo tolte le virgolette o la cui formulazione è stata leggermente modificata resta bloccata, e le citazioni eliminate del tutto vengono segnalate all'utente al momento della consegna —, numeri di dosar, importi secondo una regola di tolleranza zero (la forma esatta registrata), anagrafiche delle parti lettera per lettera compresi i segni diacritici, identificativi personali/bancari tramite i validatori di somma di controllo, e parti nominate — ogni persona o società del registro delle entità nominata nel documento deve essere stata letta (profilo) e verificata nelle connessioni per questo documento, con il rifiuto che indica entrambe le chiamate e raccomanda il test delle cricche. I rilievi sono classificati come verificati, non verificati o contraddetti; qualsiasi rilievo contraddetto o norma mancante non risolta produce un verdetto bloccante. L'attestazione si lega all'esatto stato del file — qualsiasi modifica la annulla — e dopo cinque esecuzioni di verifica fallite il ciclo si interrompe in modo definitivo, istruisce il modello a fermarsi e riferire, e avvisa l'utente direttamente nell'applicazione.

Il gate di consenso per le fonti normative: una fonte normativa segnalata dal modello non viene più integrata in silenzio. Le richieste si raccolgono in un'unica finestra di consenso nell'applicazione — fonte, giurisdizione, IA richiedente — dove le voci spuntate vengono recuperate, verificate e memorizzate (con un avvio immediato del worker) e quelle non spuntate vengono rifiutate; una fonte rifiutata trasforma le sue citazioni successive in note visibili di mancata verifica per decisione dell'utente, invece che in blocchi silenziosi. Da quel momento il monitor dei dati riporta le leggi solo per il ciclo di revisione periodica.

La regola di consegna solo dall'archivio: lo strumento di consegna accetta esclusivamente un percorso sorgente all'interno dell'archivio di lavoro dell'applicazione; i contenuti in linea e i percorsi esterni all'archivio vengono rifiutati per ogni tipo di file. Ciò mantiene l'attestazione di verifica, il tracciamento delle riconsegne, il versionamento e la copertura di lettura legati senza eccezione a ogni artefatto consegnato.

9. Avvio della sessione e inquadramento

L'apertura del set di strumenti di avvio della sessione esegue l'intero protocollo di avvio in un colpo solo e lo scrive in un file di scratch fisso e denominato; la risposta diretta restituisce solo l'ancora della data, la lingua di sistema e il contesto GUI attuale, e il modello legge il resto — voci di memoria in scadenza, il briefing giornaliero, scadenze, appuntamenti, compiti aperti tra pari e l'indice degli ultimi dieci protocolli giornalieri — con un'unica lettura dello scratch. I membri di questo set di strumenti rieseguono singoli pezzi su richiesta.

Lo strumento di data e ora risponde con una riga (data, ora, fuso orario, giorno della settimana, sincronizzata via NTP dove possibile, altrimenti orologio di sistema) e reca il mandato permanente secondo cui ogni turno di dialogo inizia con la data corrente e le date non vengono mai indovinate. Lo strumento del contesto GUI riferisce quale schermata della finestra principale dell'applicazione è aperta, con breadcrumb e il cliente e il caso aperti. Lo strumento della lingua di sistema restituisce l'identificativo della lingua che governa il dialogo e gli elenchi trasversali ai casi; lo strumento della giurisdizione restituisce, per ogni caso, la giurisdizione che governa i documenti generati e la terminologia, è obbligatorio prima di qualsiasi lavoro sui documenti e istruisce a chiedere all'utente quando non è impostata. Lo strumento del briefing mattutino restituisce il briefing strutturato di oggi con identificativi e marcatori, così che il modello possa agire su ogni voce; lo strumento del briefing di lavoro tiene traccia, per ogni IA desktop, se quell'IA è già stata aggiornata oggi, restituendo i protocolli giornalieri recenti solo al primo contatto della giornata.

10. L'archivio di scratch

L'archivio di scratch è la cartella di lavoro del modello per tutto ciò che è voluminoso. Offre: scrittura con possibilità di aggiunta in coda per un assemblaggio a blocchi; lettura per intervalli con numeri di riga che corrispondono direttamente agli editor basati sulle righe; sostituzione esatta del testo con requisito di univocità, un nuovo tentativo tollerante a spazi e virgolette tipografiche che richiede comunque l'univocità, e un ripiego prescritto su individuazione e copia in caso di qualsiasi altra mancata corrispondenza; inserimento per numero di riga o dopo un marcatore; cancellazione di intervalli di righe; sostituzione atomica di intervalli di righe come operazione sicura di ristrutturazione; ricerca per schema insensibile a maiuscole/minuscole e segni diacritici in uno o in tutti i file, con un limite di cinquanta risultati e righe di contesto facoltative; una struttura markdown che associa i titoli agli intervalli di righe senza leggere il file; un elenco della directory; la copia; un confronto per righe tra due file che nasconde le righe comuni; una normalizzazione orientata alla consegna che appiattisce il markdown strutturale secondo le convenzioni degli atti, protegge i riferimenti, completa i riferimenti brevi alle prove a sette cifre e normalizza i fine riga; l'uniformazione degli spazi; la pulizia di fine riga e caratteri invisibili; proiezioni uniformate distruttive (uno scheletro di confronto in minuscolo, oppure solo la riduzione dei segni diacritici) sempre in un file di destinazione separato; contatori di parole, lettere e righe; e la cancellazione.

Un registro di stato leggero memorizza note chiave-valore per la sessione in corso — soprattutto quale file è l'attuale bozza principale — con semantica di lettura, impostazione e cancellazione, e sopravvive ai riavvii dell'applicazione.

Ciclo di vita: l'archivio è di lunga durata e sopravvive ai riavvii; le note proprie del modello, il registro di stato, i metadati dei file e la contabilità della copertura di lettura persistono, mentre i dump degli strumenti dei giorni precedenti vengono eliminati a ogni avvio e i file non toccati da centottanta giorni vengono eliminati. Ogni accesso tramite qualsiasi strumento di scratch — compresa una semplice lettura — azzera il conto alla rovescia per la cancellazione di quel file; la sola comparsa nell'elenco della directory no. Il livello delle istruzioni obbliga il modello a cancellare i propri file di lavoro al termine di un compito e a trasferire invece le intuizioni durature nel sistema di memoria.

11. Il sistema di memoria

La memoria IA persistente è un taccuino condiviso tra le chat, comune a tutte le IA collegate e all'assistente interno all'app. Una voce contiene al massimo mille caratteri — le descrizioni del set di strumenti e degli strumenti esigono una compressione all'essenziale assoluto e la suddivisione del materiale più ampio — ed è collegata almeno a un cliente o a un caso (con un collegamento al caso il cliente viene derivato e corretto automaticamente) e facoltativamente a una prova, un'e-mail, un'entità o un'istituzione, tutti convalidati. Le voci devono essere scritte nella lingua di sistema di IRONSTICK indipendentemente dalla lingua del dialogo, e al modello è vietato usare i propri file di memoria privati per le conoscenze sui casi, poiché questi non raggiungono né l'IA pari né l'utente. Una data di scadenza facoltativa rende una voce simile a una scadenza: le voci in scadenza e scadute compaiono per prime nel protocollo di avvio della sessione e nelle viste delle scadenze dell'applicazione.

La ricerca è filtrabile per ciascuno degli identificativi collegati e per data di scadenza (tutto, esattamente oggi, o una finestra di dieci giorni attorno a una data indicata), restituisce i risultati dai più recenti con un valore predefinito di venti e un massimo di cinquanta, e contrassegna le voci del taccuino scritte dall'utente come rigorosamente in sola lettura per l'IA. L'aggiornamento sostituisce il testo e/o sposta, imposta o cancella la data di scadenza; tutto ciò che non viene fornito resta invariato. Un aggiornamento il cui testo supera il limite viene respinto con una dichiarazione di capacità che indica la lunghezza inviata, il limite, l'occupazione attuale della voce e lo spazio libero residuo; anche ogni aggiornamento di testo riuscito riferisce occupazione e spazio residuo; in entrambi i casi, quando restano liberi meno di trecento caratteri, la risposta aggiunge la raccomandazione permanente di rielaborare l'intera voce oppure di creare una voce aggiuntiva lasciando un rimando in quella vecchia. La cancellazione è irreversibile e rifiuta le voci del taccuino dell'utente e le voci di compito. La manutenzione è pensata per procedimenti di lunga durata: le voci collegate a un caso sono esenti dall'eliminazione annuale finché quel caso è attivo — decadono solo quando il caso viene reso inattivo o archiviato (il che elimina subito le sue voci) o quando il cliente viene cancellato; l'eliminazione annuale si applica solo alle voci senza caso. Inoltre, ogni voce restituita da una ricerca in memoria e ogni aggiornamento di una voce ne rinnovano la durata, e l'eliminazione misura l'età rispetto al momento più recente tra creazione e ultimo accesso — una voce effettivamente usata non scade mai; solo il materiale morto invecchia ed esce. Le voci del taccuino dell'utente non scadono mai automaticamente.

Anagrafiche, persone, relazioni e documenti non appartengono alla memoria: le descrizioni li instradano verso gli strumenti di proposta e l'acquisizione documenti.

12. Scadenze, appuntamenti e calendario

Gli strumenti delle scadenze forniscono le scadenze attive o in forma compatta (titolo, data di scadenza, giorni rimanenti, caso, con le voci contrassegnate come segrete escluse) o con descrizioni per voce e contrassegni espliciti di scaduto e urgente (urgente significa dieci giorni o meno), e in una forma di esposizione ordinata per urgenza con filtri di periodo (tutte raggruppate per criticità, solo critiche, in scadenza a breve, oggi, questa settimana, la prossima settimana o una data specifica). Lo strumento degli appuntamenti espone un giorno o un periodo ordinato con le udienze per prime — udienze importate dal portale, poi udienze del calendario, poi le restanti voci di calendario. Il lettore del calendario elenca le voci a livello globale o per caso, con intervallo di date facoltativo.

Lo strumento di acquisizione nel calendario non scrive mai: apre il modulo del calendario dell'applicazione precompilato con titolo, data, orari, descrizione e collegamento facoltativo al caso, e l'utente completa e salva. La sua descrizione impone un controllo obbligatorio dei duplicati prima di ogni chiamata: leggere prima il calendario dello stesso giorno, confrontare solo per data ignorando gli orari e, in presenza di una voce simile, mostrarla all'utente e chiedere se si tratta dello stesso evento, chiamando lo strumento solo dopo che l'utente ha confermato una nuova voce.

13. Il diario giornaliero

Il sistema del diario scrive e legge il protocollo giornaliero trasversale ai casi. L'aggiunta riguarda un giorno (predefinito oggi, con la data recuperata tramite lo strumento dell'ora), aggiunge sempre in coda a un giorno esistente con un separatore e non sovrascrive mai, collega i casi interessati tramite un elenco di casi e si aspetta il contenuto come markdown pulito nello stile di protocollo definito nell'appendice delle istruzioni. Uno strumento per le note aggiunge una singola riga di evento al protocollo di oggi con un riferimento facoltativo al caso. Lo strumento del formato restituisce il formato vincolante del file di protocollo. La lettura funziona per data, per intervallo o dai più recenti, con opzione di testo integrale e limitazione al caso; la ricerca è una ricerca per parola chiave insensibile ai segni diacritici su titoli e testi integrali, con data, titolo ed estratto di contesto per ogni risultato. Entrambe le forme di elenco hanno come valore predefinito dieci voci e un massimo di trenta. L'apertura del set di strumenti fornisce già per intero il protocollo di oggi, con una nota su quanti altri protocolli esistono nelle ultime due settimane.

14. Accesso ai casi

L'individuazione del caso avviene per numero di caso, per nome della parte coinvolta (tollerante ai segni diacritici, comprendendo controparte, attore, titolo e cliente — obbligatoria ogni volta che l'utente nomina una parte senza numero, poiché molti casi non hanno alcun numero) e tramite l'elenco dei casi del cliente. I procedimenti correlati derivano dalla gerarchia dei casi come voci padre, figlio e dello stesso gruppo.

Lo strumento di panoramica rapida restituisce, in una chiamata, ogni campo della scheda caso, ogni campo della scheda cliente, un fascicolo del portale collegato facoltativo e gli ultimi quindici identificativi di prova con le date di registrazione — pensato come orientamento prima di qualsiasi accesso ai testi integrali. Il lettore della cronaca restituisce la cronaca di un caso dalle voci più recenti, in forma compatta e senza testi integrali, con filtri di data e un limite fino a cinquanta voci, ed è la risposta rapida designata per «che cosa è successo per ultimo» — non conta nulla ai fini della preparazione del caso.

La preparazione del caso è uno strumento e un gate. Lo strumento di preparazione fornisce, in una chiamata, l'intestazione (profilo e giurisdizione) e il digest di ogni documento — identificativo, data, tipo, titolo, la sintesi redatta all'acquisizione, rimandi e dimensione del testo integrale — che è la cronaca; un secondo elenco delle stesse righe è stato eliminato in quanto puro spreco di token. La risposta inizia sempre con una nota che indica dove si trovano intestazione e digest (in linea quando l'intera risposta resta sotto il limite del connettore, altrimenti come due file di scratch da leggere fino in fondo) e i cinque documenti più recenti da leggere integralmente. Il gate di preparazione rifiuta poi, ai chiamanti esterni, due livelli di output sul caso: una nota o una voce su un caso (diario, nota giornaliera, voce di cronaca, nota del caso) finché profilo, giurisdizione, digest e le cinque voci di cronaca più recenti (note senza PDF né trascrizione; immagini ammesse) non sono stati letti integralmente — così che una serie in corso di voci di cronaca tenga conto delle ultime, senza costringere a leggere documenti pesanti per una semplice nota; un giudizio sul caso (verifica dell'atto, passaggio, esportazione) inoltre finché ogni documento citato o allegato non è stato letto integralmente. Le letture sono registrate per ogni IA desktop in un registro persistente, valide per tre giorni o fino al successivo documento in entrata del caso; i documenti in uscita e i record di prova non invalidano mai una lettura. Lo stesso registro alimenta il menu a tendina sul simbolo dell'IA. Un terzo livello, inferiore, protegge i contenuti del caso stessi: ogni strumento sui contenuti del caso — cronaca, cronologia, ricerche per parola chiave, per passaggio e per periodo, testi integrali, contraddizioni, dichiarazioni, obblighi, scadenze, calendario, corrispondenza, utilizzo, prove depositate, catene di lettere, elenchi degli allegati, timbri, media, istituzioni, etichette, valutazione e note di istruzione — viene rifiutato per un caso di cui il chiamante non ha letto il digest, con il rifiuto che indica lo strumento di preparazione; il terzo tentativo rifiutato sullo stesso caso viene registrato come violazione delle regole. I contatori di preparazione si azzerano a ogni lettura delle istruzioni e a ogni avvio della sessione.

La lettura completa del caso è protetta da gate come descritto nella sezione 8. Il dump nello scratch è la via completa più rapida: assembla l'intero testo del caso all'interno dell'applicazione, senza tagli, normalizza le anomalie OCR (spazi ripetuti, fine riga misti, spazi unificatori, trattini morbidi, caratteri a larghezza zero), lo scrive direttamente nell'archivio di scratch e restituisce solo il riferimento con le statistiche; i casi molto grandi vengono suddivisi in file parziali numerati. I filtri di ambito limitano il dump alla direzione in entrata, in uscita o a entrambe, e un elenco di identificativi di prova esegue il dump esattamente di quei record — il modo designato per leggere per intero un singolo documento molto grande, con il caso derivato dalla prova.

Il lettore delle prove è la base obbligatoria di ogni affermazione sostanziale: carica un record con il testo integrale estratto del documento (completo e non troncato; oltre il limite del connettore arriva per intero nell'archivio di scratch) e, se presente, il testo integrale della chat o della trascrizione (comprese chat di messaggistica e trascrizioni telefoniche, di udienza, di interrogatorio e giudiziarie), più la sintesi qualificata, la descrizione e i metadati, che sono dichiarati non sostitutivi del testo integrale. Se non compare nessuna delle due sezioni di testo integrale, non esiste alcun testo estratto e il modello non deve fare affermazioni sostanziali sul record. Un elenco separato da virgole di fino a dodici identificativi legge più record in una chiamata. Uno strumento di inventario dei media riferisce esistenza, tipo, data e dimensione degli allegati immagine, audio e video di un record o di un caso, dichiarando esplicitamente che il contenuto multimediale non è leggibile come testo e che lo strumento esiste affinché un record con soli media non venga erroneamente classificato come vuoto.

Le etichette vengono presentate come post-it liberi dell'utente sui record di prova — il testo è l'informazione, il colore non ha un significato fisso, e un record etichettato è dichiarato un forte indicatore di rilevanza. Tre modalità forniscono una panoramica globale con conteggi e record richiamati, tutte le etichette di un caso, oppure una ricerca testuale nei testi delle etichette, con un filtro di ambito che separa le etichette personali da quelle legate al caso. I gruppi per materia elencano l'intero panorama dei casi di un cliente come gruppi con casi annidati, compresa la parentela ad albero. La valutazione del caso memorizzata è recuperabile per ogni caso.

15. Ricerca all'interno del fascicolo

La ricerca centrale delle prove assegna un punteggio su tutti i campi delle prove, sui testi integrali estratti dei documenti e sui contenuti delle trascrizioni, con le query di più parole combinate in modo congiuntivo, indipendenza dai segni diacritici e un incremento per le frasi; i risultati sono ordinati per rilevanza senza esporre i punteggi, ogni risultato indica quale campo lo ha attivato, il valore predefinito è quindici e il massimo trenta risultati, e la forma di risposta segue la scelta del gate della sezione 8. La ricerca per passaggi suddivide documenti e trascrizioni in finestre di paragrafo e di frase e restituisce i passaggi più corrispondenti con il loro riferimento — individuando dove si trova qualcosa in un testo, non soltanto in quale record — con una corrispondenza tollerante agli errori OCR che supera gli errori di acquisizione, un bonus per le frasi e la limitazione esattamente a un caso o a tutti i casi di esattamente un cliente (lo strumento designato per le domande del tipo «X ha mai, in qualche punto»; mai trasversalmente tra clienti), con un valore predefinito di otto e un massimo di venti passaggi. Uno strumento per intervallo di date elenca le prove tra due date. Il cercatore dedicato della corrispondenza di una parte è obbligatorio quando l'utente chiede documenti da o verso una parte specifica: confronta la parte, in modo tollerante ai segni diacritici, con i record di coinvolgimento, filtra per direzione (a me, da me, o entrambe), esclude chat e trascrizioni, nasconde per impostazione predefinita le schermate autoprodotte indicandone il numero, e ordina dai più recenti — espressamente distinto dalla ricerca per parola chiave, che restituirebbe anche i record che si limitano a menzionare la parte.

16. Strumenti di analisi deterministici

Questi strumenti calcolano a partire dai record senza alcun coinvolgimento dell'IA. La cronologia restituisce tutti gli elementi di un caso ordinati per data dell'evento in ordine decrescente, con riferimento, marca temporale, tipo di record e titolo, con un valore predefinito di trecento e un massimo di cinquecento elementi. Il raccoglitore di contraddizioni volutamente non giudica: raccoglie fino a centoventi elementi candidati (predefinito sessanta), facoltativamente filtrati su un'entità, con riferimento, data, partecipanti e breve contenuto, e lascia al modello il giudizio e le successive letture dei testi integrali. Lo strumento chi-ha-detto-cosa trova ogni elemento in cui compare una persona — come partecipante, nel titolo o nel testo, o all'interno della formulazione di una trascrizione — indipendentemente dai segni diacritici, indicando la fonte di ogni risultato, con un valore predefinito di quaranta e un massimo di cento. Lo strumento della rete dei partecipanti conta quali persone ed entità compaiono insieme negli stessi elementi, a livello globale o per caso, facoltativamente concentrandosi su un'entità. Lo strumento degli obblighi elenca gli elementi aperti contrassegnati con scadenza per data di scadenza, con conteggio dei giorni, descrizioni, riferimenti e contrassegno di scaduto/urgente.

Cinque ulteriori strumenti deterministici servono alla caratterizzazione di singoli giudici e pubblici ministeri; contano come decisioni solo i documenti in entrata provenienti da un tribunale o da una procura. L'elencatore delle decisioni restituisce ogni decisione in cui una persona ha seduto come giudice o ha agito come pubblico ministero, su tutti i casi, contando solo un nome nell'intestazione (composizione del collegio) o nel blocco delle firme — un nome nel corpo del testo non conta, e i cancellieri non vengono mai elencati. Il lettore della struttura scompone una decisione in tribunale, sezione, numero di caso, tipo, numero e data, udienza, collegio, la frase che nomina parti e oggetto, il dispositivo alla lettera, le parole chiave dell'esito, rimedio, pronuncia, citazioni normative con il loro stato nella biblioteca e l'ampiezza della motivazione, ciascuno con la sua posizione in caratteri, segnalando ciò che manca come non trovato. Il raccoglitore delle memorie scrive ogni memoria depositata nel caso fino alla data della decisione in due file di scratch — i documenti in uscita del cliente e quelli in entrata della controparte — limitandosi ai documenti indirizzati a un tribunale o a una procura, ciascuno solo con il suo documento principale (e-mail di accompagnamento e allegati tagliati), ed elencando come non assegnato ciò che non può essere classificato; i suoi file comportano l'obbligo di lettura. Il confronto con la decisione misura quale quota della motivazione propria del tribunale corrisponde, come testo, alle memorie del cliente, a quelle della controparte, a entrambe, al testo normativo della biblioteca, o a nulla (la formulazione propria del tribunale), misura separatamente l'esposizione delle posizioni delle parti ed elenca i passaggi corrispondenti con il loro tasso di corrispondenza dal settanta per cento in su, dal più alto, nella formulazione originale con le posizioni in caratteri. Il confronto tra documenti mette a confronto due documenti qualsiasi tra clienti e casi diversi, classifica i passaggi corrispondenti come testo normativo, fonte citata comune o condivisi solo da questi due, e apre la sua risposta con l'avviso che fornisce solo una prima impressione e che entrambi i documenti devono essere letti per intero prima di affermare qualsiasi cosa su un collegamento.

La famiglia di strumenti per il tracciamento dei depositi opera in modo deterministico sugli atti memorizzati: lo strumento di utilizzo risponde, per una prova, quali allegati contiene fisicamente e in quali atti è stata essa stessa depositata (con data e numero di ruolo, su tutti i casi), oppure, per un caso, fornisce il rapporto delle lacune sugli elementi mai depositati; l'elencatore delle prove depositate restituisce per ogni atto memorizzato gli identificativi allegati più l'insieme totale deduplicato ed è obbligatorio prima di comporre l'elenco degli allegati di un nuovo atto, con l'avvertenza documentata che sono coperti solo gli allegati collegati strutturalmente. La catena dei numeri di registro trova, a partire da un numero di lettera o da tutti i numeri presenti in un documento, ogni documento che condivide quel numero in ordine cronologico — il percorso documentato di un procedimento amministrativo. L'elencatore degli allegati risolve gli allegati fisicamente contenuti in un documento, compreso il timbro di deposito deterministico per ciascun allegato; lo strumento dei timbri risolve qualsiasi identificativo di prova nel suo timbro di deposito deterministico (più file memorizzati producono più timbri; un record senza file memorizzato produce un marcatore esplicito di assenza). Entrambi gli strumenti che forniscono timbri vietano di inventare timbri — devono sempre essere recuperati.

17. Riparazione OCR

Un percorso di escalation in quattro passi ripara i testi integrali memorizzati rovinati ed è esplicitamente escluso dall'uso come comodo sostituto della lettura. La richiesta di nuova scansione chiede all'applicazione di rieseguire l'OCR sul PDF originale memorizzato; l'utente seleziona le pagine in IRONSTICK, e il modello è istruito a informare l'utente in una frase e ad attendere. Lo strumento di stato va chiamato una sola volta quando l'utente dice che le pagine sono state scelte — i cicli di interrogazione ripetuta sono vietati — e, quando è pronto, restituisce l'ordine di lavoro insieme a due file di scratch contenenti la nuova scansione e il testo attuale della banca dati. La regola di confronto e riparazione consente solo correzioni meccaniche dell'OCR, mai riformulazioni, con numeri, nomi e importi mantenuti esatti. Dove un punto è illeggibile in ENTRAMBE le fonti, il modello può chiedere all'utente un controllo visivo prima dell'invio — al massimo tre punti per documento, con il record aperto nel punto esatto e il punto indicato con precisione («pagina 7, secondo paragrafo — l'importo?»); con la navigazione disattivata, record e pagina vengono invece indicati nella chat. Lo strumento di invio consegna all'applicazione il file di scratch riparato, che l'applicazione mostra all'utente in una finestra modale; solo il salvataggio da parte dell'utente sostituisce il testo nella banca dati, e nulla viene memorizzato automaticamente. L'ultima escalation, la richiesta di passaggio del PDF, apre il record e fa sì che il modello chieda all'utente di trascinare personalmente il PDF originale nella chat — il ponte volutamente non fornisce alcun aiuto sul percorso, rifiuta in modo rigido quando non è stata preceduta da una nuova scansione, e rifiuta i PDF oltre i dieci megabyte o oltre le novanta pagine; il modello legge poi il PDF visivamente, costruisce la versione riparata nell'archivio di scratch e la invia attraverso lo stesso gate di revisione. In caso di rifiuto per dimensione o numero di pagine il flusso non finisce: il ripiego della trascrizione apre comunque il record, e il modello chiede all'utente di aprire il PDF tramite la graffetta e di trascrivere alla lettera i punti decisivi («pagina X, in alto, dovrebbe esserci scritto … — lo digiti esattamente, per favore») — al massimo tre punti, ripresi alla lettera nella versione riparata; qualsiasi lacuna residua viene dichiarata apertamente. L'avvocato agisce così come strumento visivo di precisione esattamente per la frazione di una scansione che la macchina non riesce a risolvere, invece di elaborare il documento manualmente.

18. Persone, istituzioni, clienti e proposte di dati

Gli strumenti di individuazione trovano clienti, persone e istituzioni tramite un frammento di nome, in modo tollerante ai segni diacritici; un cercatore per parola chiave cerca in nomi, note e campi di analisi quando si conosce solo un frammento. Una verifica deterministica di elenchi confronta un documento che contiene un elenco di nomi con tutte le persone e società registrate, indirizzato tramite identificativo della prova o tramite caso — in quel caso viene analizzata la voce più recente del caso, indicata nella risposta. Nei collegamenti con Claude e ChatGPT la verifica delle parti accetta in anticipo le parti successive e le cerca in background mentre quella corrente viene elaborata; i risultati sono conservati per trenta minuti e l'ordine del gate resta invariato. Gli strumenti di rete elencano tutti coloro che sono collegati a una parte tramite relazioni esplicite e casi condivisi, le cricche dell'intera rete delle parti tramite rilevamento deterministico delle comunità (esattamente la vista Universo della schermata delle persone, con un contrassegno di sospetto per gruppi insolitamente densi e una separazione facoltativa di persone e istituzioni in livelli), e le parti più collegate; ogni risposta relativa a una parte inizia con il blocco dei casi a cui la parte è collegata. Il lettore del profilo restituisce ogni campo anagrafico e di analisi completo e non troncato. I lettori dei profili restituiscono il profilo dell'entità con analisi e relazioni, tutte le relazioni di una persona in entrambe le direzioni tra persone e istituzioni, il profilo dell'istituzione e le istituzioni formalmente collegate a un caso. Il lettore del tempo di lavoro riferisce il tempo di lavoro misurato passivamente (ogni visualizzazione di pagina dura fino alla successiva, con un limite di trenta minuti, e l'ultima conta come un minuto) come panoramica dei totali e dei casi, clienti e giorni principali, oppure come ripartizione giornaliera di un caso, su un intervallo di date o su una finestra degli ultimi giorni con valore predefinito di sette.

Scrivere direttamente nelle anagrafiche è impossibile. Due strumenti di proposta collocano i risultati nel monitor di coerenza dei dati dell'applicazione come elementi da revisionare: la proposta anagrafica (solo dopo che l'utente ha confermato nella chat che il risultato deve essere registrato) riguarda un'entità o un'istituzione esistente — individuata prima per nome — oppure descrive un nuovo record per nome e campi, con un elenco di campi ammessi in cui i numeri di identificazione societari e personali condividono un unico campo, solo campi comprovati ammessi, e riferimenti facoltativi alle prove; la proposta di relazione descrive una relazione tra due persone individuate o tra una persona e un'istituzione, con esattamente una controparte, una categoria obbligatoria, una motivazione facoltativa e riferimenti facoltativi a caso, cliente e prove. Una proposta può anche rinominare un record (campo Name), impostarne il tipo (campo PersonKind: fisica o giuridica), cambiare la categoria di una relazione esistente, proporre una cancellazione (di un record, di un'etichetta o di una scadenza evasa) con una motivazione nella lingua di sistema, che è obbligatoria, oppure proporre due record come duplicati; un nuovo record viene accettato solo dopo che il tipo è stato deciso nel dialogo, e una proposta che tocca la descrizione o i dati di contatto di una persona viene rifiutata a meno che il chiamante non abbia letto quel profilo negli ultimi trenta minuti. In entrambi i flussi il record cambia solo quando l'utente accetta la proposta nel monitor. A una proposta di nuovo record si risponde prima con l'elenco dei record simili già esistenti — corrispondenza approssimativa, nulla viene salvato — e il chiamante deve o registrare su uno di essi o confermare esplicitamente, tramite parametro, che la parte è realmente nuova; una corrispondenza rigorosa viene reindirizzata al record esistente. Ogni nuova parte salvata restituisce un obbligo di seguito che impone al chiamante di ricercare e registrare le connessioni della parte, ricerca web compresa. Un terzo strumento di proposta assegna una parte a un caso: esattamente un'entità o un'istituzione, una motivazione obbligatoria e riferimenti facoltativi alle prove diventano un elemento di revisione per il collegamento al caso nello stesso monitor; l'accettazione scrive il collegamento del partecipante su cui si basano le viste delle cricche e delle connessioni, mentre un collegamento esistente, un duplicato in sospeso o un rifiuto precedente vengono segnalati invece di essere riproposti. L'applicazione conta inoltre le proposte per chiamante: dopo due proposte anagrafiche memorizzate e una proposta di relazione o di collegamento al caso considera la sessione come cura della rete delle parti, aggiunge una volta l'indicazione che questo lavoro interamente protetto da gate non richiede un modello di punta e — nella chat interna all'app — mantiene l'esecuzione sul livello di modello intermedio. Processi in background indipendenti alimentano lo stesso monitor: un estrattore di dati deduplicato alla fonte e una scansione periodica di normalizzazione che propone unioni e riclassificazioni secondo il modello a tre categorie (persona fisica; persona giuridica come qualsiasi ente che non sia un singolo essere umano, con un'iscrizione nel registro delle imprese che prevale sulla proprietà statale; istituzione come organi statali senza iscrizione nel registro) — senza mai unire automaticamente.

19. La biblioteca giuridica

La biblioteca contiene i testi integrali delle leggi come file markdown con un numero di registrazione interno per ogni legge. Lo strumento di elenco sfoglia l'inventario (identificativo, giurisdizione, titolo, tipo, nome del file, data dell'ultima verifica; predefinito cinquanta, massimo cinquecento) ed è in sola lettura. Lo strumento di ricerca è obbligatorio prima di qualsiasi ricerca su internet di una norma: trova corrispondenze o per denominazione, su titolo e descrizione, o per passaggio citato con tolleranza approssimativa (bastano circa il sessanta per cento delle parole e le desinenze sono tollerate), richiede la giurisdizione ricavata dal caso, colloca le corrispondenze nel titolo molto al di sopra di quelle nel contenuto (una corrispondenza nel titolo vale nove decimi, ogni risultato nel contenuto un decimo, al massimo tre estratti per file) e restituisce per ogni risultato il numero di registrazione, il nome del file, brevi estratti con le loro esatte posizioni in caratteri e una chiamata già pronta per un brano alla lettera il cui intervallo è già ampliato — di almeno cinquecento caratteri oltre l'estratto — così che il modello recuperi da sé la formulazione autorevole invece di fidarsi dell'estratto. Lo strumento dei brani restituisce il contenuto alla lettera di una legge tra due posizioni in caratteri, indirizzato tramite numero di registrazione, limitato al file, preceduto da una nota secondo cui l'intervallo può essere regolato e l'intera legge è caricabile, con i risultati sovradimensionati deviati automaticamente nell'archivio di scratch; la corrispondenza delle cifre nelle ricerche normative usa regole di confine che tollerano la notazione con il punto delle migliaia dei portali ufficiali. Le leggi intere sono caricabili per nome del file o per numero di registrazione, con i file grandi deviati automaticamente. Lo strumento di registrazione è il canale di segnalazione obbligatorio per qualsiasi legge trovata sul web aperto: vengono inviati solo il link, la giurisdizione e, facoltativamente, titolo e frase; un processo in background recupera, converte, memorizza e annuncia la fonte nel monitor dei dati, e il modello stesso non converte mai nulla. Un ciclo di revisione della biblioteca tiene traccia della data dell'ultima verifica di ogni fonte. Una legge caricata dall'utente come file senza fonte online reca in ogni risposta un avviso di attualità, perché non se ne può verificare la vigenza. Il rifiuto di una legge nel monitor dei dati richiede una conferma che ne indica la conseguenza: la legge esce dalla biblioteca, e rifiutare un aggiornamento rimuove l'intera legge, anche sul server di studio.

Uno strumento di riverifica controlla su richiesta una legge rispetto alla sua fonte e riferisce se è invariata, aggiornata o duplicata; un recupero più recente prende il posto della voce, e sul server di studio vince l'ultimo che ha verificato, indipendentemente da chi abbia registrato la legge per primo. Le leggi intere oltre il limite del connettore finiscono nell'archivio di scratch e non registrano nulla come letto; la provenienza deriva dallo strumento degli articoli.

20. Validatori e registri

Strumenti di verifica deterministici coprono: IBAN (formato, lunghezza specifica per paese, somma di controllo); numeri personali, previdenziali e fiscali nazionali secondo nove schemi in sei paesi tramite cifre di controllo, con una modalità mirata per schema e una modalità automatica che prova tutti gli schemi e riferisce quelli validi; identificativi IVA europei (prima un controllo offline del formato del paese, poi il servizio ufficiale dal vivo dell'Unione, che restituisce i dati aziendali resi disponibili dove lo Stato membro li fornisce); numeri EORI tramite il servizio di validazione dal vivo dell'Unione; identificativi delle persone giuridiche (prima la somma di controllo, poi il registro globale per stato e nome); e numeri del registro delle imprese tramite il portale europeo dei registri delle imprese, visualizzato in un vero motore di browser, con il modello istruito a leggere la pagina restituita e a confermare il risultato. Ogni validatore restituisce un risultato concreto e motivato — valido con i dettagli, non valido con l'aspetto che non supera il controllo, non trovato, oppure servizio non raggiungibile con lo stato — mai un semplice sì o no, così che un numero realmente errato sia sempre distinguibile da un disservizio. Il livello delle istruzioni rende obbligatoria l'esecuzione del validatore corrispondente prima che un tale numero entri in un documento prodotto o revisionato. Lo stesso set di strumenti contiene lo strumento della posizione approssimativa dell'utente (paese, città e indirizzo pubblico dall'ultima istantanea di accesso, esplicitamente non una fonte per la giurisdizione) e uno strumento meteo fornito al meglio delle possibilità.

21. Accesso al web

Due strumenti raggiungono l'internet aperto, entrambi presentati come integrazione delle capacità web proprie dell'IA desktop, con l'istruzione esplicita di usarli direttamente quando l'IA non dispone di un proprio accesso al web, e il divieto di usarli per dati relativi ai casi. Lo strumento di ricerca interroga tramite un'interfaccia web dal comportamento umano con una scelta di motori e restituisce risultati con titolo e link, destinati a essere seguiti con l'apritore di pagine. L'apritore di pagine recupera esattamente un URL pubblico con una pipeline a stadi che la descrizione elenca per intero, così che il modello non si arrenda mai prematuramente: una richiesta HTTP dal comportamento umano con veri header di browser, gestione dei reindirizzamenti e compressione; rilevamento automatico delle verifiche anti-bot con escalation verso un vero motore di browser integrato; rilevamento delle pagine-guscio JavaScript con rendering finché non compare il contenuto; conversione dei PDF esatta per pagina, usando il livello di testo per ogni pagina e l'OCR solo per le pagine scansionate, così che i documenti misti funzionino; e conversione dei formati office e di testo in testo leggibile. L'output è markdown, completo: il contenuto principale viene estratto (navigazione, pubblicità e banner dei cookie rimossi), le pagine senza corpo di articolo mantengono il piè di pagina perché lì si trovano indirizzo e dati di contatto, e dove l'estrazione lascerebbe quasi nulla viene consegnata invece l'intera pagina. Una chiamata risponde entro quarantacinque secondi; un documento grande o scansionato continua a essere elaborato in background e viene consegnato subito alla chiamata successiva con lo stesso indirizzo. I portali normativi vengono rifiutati finché non è stata effettuata una ricerca nella biblioteca, secondo il gate delle norme.

22. Navigazione GUI ed esportazioni

Tutta la navigazione è facoltativa e soggetta a un interruttore dell'utente; senza di esso l'intero gruppo non esiste. Gli strumenti di navigazione aprono, nella finestra principale dell'applicazione: un caso (facoltativamente sulla scheda della cronaca o della valutazione), l'elenco dei casi di un cliente, una persona, un'istituzione (entrambe evidenziate con il dettaglio aperto), una voce di prova (pagina di cronaca corretta, evidenziata), la preparazione del dossier (con una variante completamente automatica riservata al desiderio esplicito dell'utente di un PDF completo), il protocollo giornaliero (facoltativamente il dettaglio di un giorno specifico), il monitor e-mail (facoltativamente il dettaglio di una mail specifica), la ricerca globale con una query avviata (riservata al desiderio esplicito; le risposte in chat usano invece la ricerca interna), l'area di backup con avvio immediato di un backup, e qualsiasi schermata indicata dall'elenco canonico delle schermate. Le finestre di esportazione coprono l'elenco dei clienti, l'elenco delle scadenze, la panoramica dei casi di un cliente, il dossier del caso in due tipi di documento e la mappa, più la creazione del pacchetto IA del cliente. Tutti gli strumenti di navigazione sono soggetti al blocco rigido e sono i destinatari delle offerte di navigazione della sezione 7.

23. Scrittura, formati e consegna

Il set di strumenti di scrittura vincola la produzione di documenti a specifiche recuperate. Lo strumento del formato di output restituisce l'istruzione di generazione vincolante per il tipo di artefatto richiesto — per gli atti differenziata tra atto giuridico e lettera semplice, ciascuno in forma con difensore e senza difensore, con la giurisdizione, la lingua e la data del caso risolte direttamente nell'istruzione e segnaposto che il modello compila con i dati del connettore; lo strumento del formato di invio della posta restituisce la specifica vincolante per gli invii al tribunale con consegna sequenziale dei pacchetti. Entrambi vanno seguiti alla lettera. Il passaggio all'editor inserisce un atto in markdown direttamente nel word processor di IRONSTICK con il testo caricato ma nulla memorizzato — l'utente rivede e salva — ed è disponibile sul collegamento con Claude. Lo strumento di acquisizione della cronaca apre il modulo della cronaca precompilato nel caso corretto, senza salvare nulla da sé.

La consegna dei file all'utente avviene esclusivamente tramite lo strumento di consegna, che il front-end esegue da sé: il file finisce nella cartella di consegna dedicata all'interno della directory dei download dell'utente, la cartella si apre con il file evidenziato, e viene stampato un link. La cartella è destinata solo alla consegna — nulla al suo interno viene mai letto, modificato o cancellato dal modello. Il contenuto arriva o in linea oppure, in modo preferito e obbligatorio per file grandi o già scritti, tramite percorso sorgente, che il front-end legge direttamente dal disco così che nulla venga ridigitato attraverso il modello, formati binari compresi. Il modello assegna da sé le versioni ai nomi dei file, un nuovo numero per ogni consegna, e una consegna con lo stesso nome sovrascrive; il risultato riporta le versioni esistenti della radice del nome e la più alta, avvertendo quando il numero consegnato non è il più alto. La consegna avviene una volta per compito, alla fine, mai per stati intermedi, e passa prima per il gate di formalità della sezione 8.

24. Revisione tra pari tra IA

Lo strumento di passaggio consegna un lavoro prodotto all'altra IA desktop: il contenuto va in un grande archivio a breve termine, un record di compito vi fa riferimento, l'istruzione (limitata a mille caratteri) indica che cosa deve fare la pari, e il modello chiede poi all'utente di attivare la pari nell'altra applicazione. Lo strumento della casella in arrivo elenca i compiti aperti indirizzati al chiamante — i propri non compaiono mai — con identificativo, incarico e contenuto completo, facoltativamente filtrati per cliente o caso. Lo strumento di risposta chiude un compito (cancellandone il contenuto a breve termine) e contemporaneamente rimanda la valutazione come nuovo compito al mittente originale; lo strumento di completamento chiude senza restituire nulla. Lettura e scrittura dello scratch sono membri di questo set di strumenti per gestire i contenuti scambiati.

25. File di istruzioni IA

Per ogni caso l'utente può memorizzare file di istruzioni che il modello deve consultare. L'elencatore mostra le istruzioni di un caso con identificativo, nome del file, dimensione, data di caricamento ed estratto, senza testi integrali; l'inventario globale elenca ogni istruzione su tutti i clienti e casi; il lettore singolo restituisce un'istruzione senza tagli tramite il suo identificativo numerico, con l'opzione di instradare il contenuto grezzo nell'archivio di scratch, esatto al byte, per il passaggio diretto; il lettore cumulativo restituisce tutte le istruzioni di un caso in una chiamata con la stessa opzione di scratch. Entrambi gli output di elenco vengono deviati automaticamente quando sono sovradimensionati. Lo strumento di aggiornamento propone una versione modificata attraverso esattamente una di tre vie — un frammento da aggiungere in coda (la via preferita per le aggiunte, con l'applicazione che assembla da sé il risultato e il divieto per il modello di riprodurre il contenuto esistente), un percorso sorgente verso una nuova versione completa sul disco, oppure il nuovo contenuto completo in linea — e l'applicazione mostra la modifica all'utente come confronto; solo un'approvazione esplicita la adotta, l'esito (approvato, rifiutato o in sospeso) viene restituito, e uno stato in sospeso vieta di inviare di nuovo. L'esportazione del pacchetto costruisce il bundle completo di istruzioni e skill di un cliente e apre la finestra di esportazione.

26. Integrazioni complementari al di fuori della superficie degli strumenti

Un complemento lato client integra il ponte senza far parte della superficie MCP: un plugin di skill installabile per ogni IA desktop (cinque skill che rispecchiano il modello di lavoro basato su set di strumenti e run-tool, generate e versionate dal configuratore dell'applicazione). La configurazione del front-end del ponte per ogni IA viene scritta dai corrispondenti pulsanti del configuratore, che scrivono sempre l'identità del chiamante e il percorso delle istruzioni per proteggere dalla condivisione della configurazione tra IA diverse.

27. Semantica di errori e rifiuti — riepilogo

Ogni rifiuto nel sistema è istruttivo anziché laconico: le violazioni dello schema restituiscono lo schema atteso; i nomi sconosciuti restituiscono la corrispondenza più vicina; il gate della data indica il rimedio esatto; il gate delle norme indica la procedura della biblioteca; il blocco della navigazione indica la schermata protetta e l'alternativa differita; il blocco del consenso indica la finestra per riprovare; le risposte sovradimensionate indicano il file e i due comandi di proseguimento oppure i filtri di restringimento; i fallimenti dei validatori indicano l'aspetto che non supera il controllo e distinguono i disservizi; i rifiuti per capacità nella memoria indicano occupazione e spazio residuo e, vicino al limite, le opzioni di ristrutturazione; i gate di consegna e di ricerca indicano le loro opzioni di risposta, compresa la via d'uscita universale unknown; il blocco di accesso indica le due chiamate che lo aprono; il gate di preparazione indica le parti non lette con identificativi e percentuali; il verificatore degli atti indica, per ogni lettura scaduta o azzerata, l'esatta chiamata che la ripristina. Il contratto verso il modello prevede che, dopo al massimo tre tentativi corretti su una qualsiasi chiamata che fallisce, il modello si fermi e riferisca all'utente l'errore esatto.