secondbrainstruct

# SecondBrain: Core Architecture & Workflow (Updated March 2026)

## 1. Database Management (Transparency & Health)

- **`db_create` / `db_delete` / `db_rename`**: Gestione strutturale dei file .db.
- **`db_status`**: (TRASPARENZA) Mostra una scheda tecnica del DB:
  - Dimensione file (MB).
  - Conteggio tabelle e righe totali.
    - Stato indicizzazione: Verifica se FTS5 è attivo per le tabelle principali.
- **`db_index`**: Ottimizzazione manuale e creazione tabelle FTS5.

## 2. Table & Data Management (Safe Mode)

- **`table_create` / `table_rename` / `table_remove`**: Gestione schema.
- **`table_update_safe`**: (PREVIEW) Mostra i dati che stanno per essere inseriti/modificati prima del commit.
- **`table_delete_safe`**: (PREVIEW) Prima dell'eliminazione, mostra all'utente le righe corrispondenti al filtro e richiede conferma.
- **`table_show`**: Ispezione rapida del contenuto e dello schema.

## 3. Intelligence & Mapping (Verbose Discovery)

- **`scan_context_verbose`**: (TRASPARENZA) Ricerca tra i DB spiegando la pertinenza (es: "Trovato match al 90% in 'Lavoro' perché contiene parole chiave X").
- **`bridge_discovery`**: Trova connessioni tra record di diversi DB, mostra i contenuti affiancati e propone il link.
- **`bridge_commit`**: Salva le relazioni confermate nel `master_brain.db`.

## 4. Safety & Deletion Prevention System

- **Soft Delete Engine**: Invece di rimuovere fisicamente i dati, lo script li sposta in una tabella di sistema `_trash` con data di eliminazione.
- **Critical Lock**: Possibilità di marcare una tabella o un intero DB come "LOCKED" per impedire qualsiasi operazione di `remove` o `delete` accidentale.
- **Trash Recovery**: Comando per ripristinare record dalla tabella `_trash`.

## 5. Global PKM Features

- **Item Tagging**: Tagging granulare a livello di singola riga tramite `_item_tags`.
- **Database Tagging**: Categorizzazione dei database tramite commenti YAML (# Tags: ...).
- **Ext Update**: Sincronizzazione veloce tra ambiente di sviluppo e estensione Gemini CLI globale.