Matteo Benedetto
1832562a7f
Il gateway remoto non è sempre raggiungibile (VPN/nodi giù): finora le ricerche
fallivano e la conoscenza non era consultabile. Ora l'estensione mantiene un
indice locale testuale e vi degrada automaticamente.
Core (extensions/local-db.ts):
- schema SQLite con FTS5 (unicode61 remove_diacritics 2), trigger di sync,
tabella meta per cursori/stato; usa node:sqlite (Node >= 22.5, nessuna
dipendenza esterna), con soppressione del warning "experimental"
- import idempotente dalle sessioni pi (tutte le directory di progetto):
qmem_store/qmem_correct (ID + testo integrale), qmem_get (payload completo),
qmem_search (record osservati, anche creati da altri agenti)
- merge senza regressioni: le osservazioni povere (es. search senza
project_id) non azzerano i campi già noti; superseded_by monotono
- ricerca FTS5 con filtri (kind/project/scope/level/topic), esclusione di
superseduti e privati, ranking bm25, snippet, ripiego AND -> OR dichiarato
- enrich dal gateway (GET /v1/memories/{id}, pacing < rate limit, timeout 8s
per richiesta, stop al primo guasto) e pull da /v1/memories:export (endpoint
lato gateway previsto: se assente lo segnala senza errore)
- localGet per il recupero puntuale offline
Estensione:
- qmem_search: su 0/429/5xx degrada all'indice locale, risultati etichettati
"INDICE LOCALE, ricerca testuale non neurale" + details.fallback=local_sqlite
- qmem_get: fallback locale per UUID
- qmem_store: avviso esplicito che il record NON è salvato (nessuna coda)
- rendering arricchito con project_id e flag privato (anche per il gateway)
- comando /qmem:local status|import|find|enrich|pull
- regole e skill aggiornate: quando si usa l'indice locale non applicare le
soglie 0.45/0.60 (sono semantiche)
CLI standalone (stesso core): scripts/qmem-sqlite.mjs status|import|find|
enrich|pull (+ --json). Test: scripts/test-local.mjs (14 controlli, HOME
temporanea, sessioni sintetiche, gateway black-hole e stub HTTP).
Verifiche: 14/14 test superati; import reale 185 sessioni -> 1046 record unici
(1032 con testo, 986 attivi, 60 superseduti, 672 con project_id, 20 gruppi di
duplicati) in 2,8 MB; enrich con gateway giù si ferma in ~16s con messaggio
chiaro invece di restare appeso.
29 lines
970 B
TypeScript
29 lines
970 B
TypeScript
/**
|
|
* pi-qmem — entrypoint estensione.
|
|
*
|
|
* La logica è divisa per responsabilità: shared/client, sei tool, comando
|
|
* di configurazione e regole operative.
|
|
*/
|
|
import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
|
|
import { registerQmemConfig } from "./config-command";
|
|
import { registerQmemCorrect } from "./tools/correct";
|
|
import { registerQmemGet } from "./tools/get";
|
|
import { registerQmemMeta } from "./tools/meta";
|
|
import { registerQmemSearch } from "./tools/search";
|
|
import { registerQmemStore } from "./tools/store";
|
|
import { registerQmemTree } from "./tools/tree";
|
|
import { registerQmemRules } from "./rules";
|
|
import { registerQmemLocal } from "./local-command";
|
|
|
|
export default function qmemExtension(pi: ExtensionAPI) {
|
|
registerQmemStore(pi);
|
|
registerQmemSearch(pi);
|
|
registerQmemCorrect(pi);
|
|
registerQmemMeta(pi);
|
|
registerQmemGet(pi);
|
|
registerQmemTree(pi);
|
|
registerQmemConfig(pi);
|
|
registerQmemLocal(pi);
|
|
registerQmemRules(pi);
|
|
}
|