feat(outbox): store offline con coda locale e sincronizzazione al ritorno della rete
Prima qmem_store falliva se il gateway non era raggiungibile: la conoscenza andava persa. Ora il record entra in una coda locale persistente e viene inviato automaticamente quando la connessione torna. Core (extensions/local-db.ts): - tabella `pending` (local_id, payload JSON, attempts, last_error, status, remote_id) + colonna `records.pending` (migrazione automatica dei DB esistenti) - queueStore(): accoda e crea subito il placeholder locale ricercabile (⏳) - flushQueue(): POST /v1/memories con Idempotency-Key = local_id (retry senza duplicati), FIFO, pacing sotto il rate limit, timeout 12s per richiesta - esiti: synced (il record locale adotta l'ID remoto, niente duplicati) · duplicate (409: registra l'ID del match e NON sovrascrive il testo locale autorevole) · failed (4xx di validazione, non ritentato) · 0/429/5xx: resta in coda e il flush si ferma - supersede offline: supersedes_id che punta a un local_id viene rimappato al remote_id al flush (se il genitore non è sincronizzato → failed esplicito) - submitOrQueue(): online → gateway + indicizzazione locale; offline → coda - maybeBackgroundFlush() (single-flight) e flushQueueIfPending() per session_start - stato/report: queued/synced/duplicate/failed, più vecchio, ultimo errore, last_flush, record pendenti in indice Estensione: - qmem_store: gateway giù → accoda e risponde con id locale, dimensione coda e spiegazione (details.queued/local_id/queue_size) - fallback offline di session_start: flush in background (non blocca l'avvio) - /qmem:local queue|flush; status con la coda; marker "⏳ in coda" nei risultati locali di qmem_search/qmem_get - regole e skill: un record in coda NON è ancora nella memoria condivisa CLI: store [--queue-only], queue, flush (+ status con la coda). Test: scripts/test-local.mjs ora copre anche outbox → 24 controlli (flush con 2 sync + 1 duplicato 409 + 1 fallito 422, Idempotency-Key, rimappatura del supersede, ricerca del record con l'ID remoto dopo il sync). Verifiche: 24/24 test superati; demo reale su DB temporaneo: store accodato, queue con local_id, flush con gateway giù → "fermato: HTTP 0" e voce che resta in coda con l'errore registrato.
This commit is contained in:
+15
-2
@@ -42,7 +42,20 @@ In quel caso:
|
||||
- comandi: `/qmem:local status | import | find <query> | enrich | pull`
|
||||
(`import` dalle sessioni, `enrich`/`pull` dal gateway quando torna online).
|
||||
|
||||
`qmem_store` non ha coda locale: con il gateway giù il record **non** viene
|
||||
salvato. Annota il contenuto e riscrivilo quando il gateway è raggiungibile.
|
||||
`qmem_store` accoda in locale: con il gateway giù il record entra nell'**outbox**
|
||||
locale (SQLite), è subito ricercabile (marcato ⏳) e viene inviato al gateway al
|
||||
ritorno della connessione (flush automatico su `session_start`, oppure
|
||||
`/qmem:local flush`). Finché non è sincronizzato **non** è nella memoria
|
||||
condivisa: i risultati locali marcati ⏳ non sono visibili agli altri agenti.
|
||||
|
||||
Stato e gestione della coda:
|
||||
|
||||
- `/qmem:local queue` — voci in attesa, tentativi, ultimo errore
|
||||
- `/qmem:local flush` — invio immediato (idempotente: `Idempotency-Key` = id locale)
|
||||
- esiti: `synced` (sul gateway, il record locale adotta l'ID remoto), `duplicate`
|
||||
(409: era già presente, viene registrato l'ID del match), `failed` (4xx di
|
||||
validazione: non ritentato in automatico)
|
||||
- supersede offline: una correzione che punta a un record ancora locale viene
|
||||
rimappata all'ID remoto al momento del flush
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user