nexo-brain 5.3.26 → 5.3.27

package/src/plugins/backup 2.py

@@ -1,127 +0,0 @@
-"""Backup plugin — hourly SQLite backups with 7-day retention."""
-import os
-import shutil
-import time
-import glob
-from db import get_db
-
-NEXO_HOME = os.environ.get("NEXO_HOME", os.path.expanduser("~/.nexo"))
-DB_PATH = os.path.join(NEXO_HOME, "data", "nexo.db")
-BACKUP_DIR = os.path.join(NEXO_HOME, "backups")
-
-RETENTION_DAYS = 7
-
-
-def handle_backup_now() -> str:
-    """Create an immediate backup of the NEXO database."""
-    os.makedirs(BACKUP_DIR, exist_ok=True)
-    timestamp = time.strftime("%Y-%m-%d-%H%M")
-    dest = os.path.join(BACKUP_DIR, f"nexo-{timestamp}.db")
-
-    # Use SQLite backup API for consistency
-    import sqlite3
-    src_conn = sqlite3.connect(DB_PATH)
-    try:
-        dst_conn = sqlite3.connect(dest)
-        try:
-            src_conn.backup(dst_conn)
-        finally:
-            dst_conn.close()
-    finally:
-        src_conn.close()
-
-    size_kb = os.path.getsize(dest) / 1024
-    _cleanup_old()
-    return f"Backup created: {os.path.basename(dest)} ({size_kb:.0f} KB)"
-
-
-def handle_backup_list() -> str:
-    """List available backups with dates and sizes."""
-    if not os.path.isdir(BACKUP_DIR):
-        return "No backups."
-    files = sorted(glob.glob(os.path.join(BACKUP_DIR, "nexo-*.db")), reverse=True)
-    if not files:
-        return "No backups."
-    lines = [f"BACKUPS ({len(files)}):"]
-    total_size = 0
-    for f in files:
-        size = os.path.getsize(f) / 1024
-        total_size += size
-        name = os.path.basename(f)
-        lines.append(f"  {name} ({size:.0f} KB)")
-    lines.append(f"\n  Total: {total_size/1024:.1f} MB")
-    return "\n".join(lines)
-
-
-def handle_backup_restore(filename: str) -> str:
-    """Restore database from a backup file. DESTRUCTIVE — replaces current DB.
-
-    Args:
-        filename: Backup filename (e.g., 'nexo-2026-03-11-1200.db')
-    """
-    src = os.path.join(BACKUP_DIR, filename)
-    if not os.path.isfile(src):
-        return f"Backup not found: {filename}"
-
-    # Create safety backup first
-    safety = os.path.join(BACKUP_DIR, f"nexo-pre-restore-{time.strftime('%Y%m%d%H%M%S')}.db")
-    import sqlite3
-    src_conn = sqlite3.connect(DB_PATH)
-    try:
-        dst_conn = sqlite3.connect(safety)
-        try:
-            src_conn.backup(dst_conn)
-        finally:
-            dst_conn.close()
-    finally:
-        src_conn.close()
-
-    # Restore
-    restore_conn = sqlite3.connect(src)
-    try:
-        target_conn = sqlite3.connect(DB_PATH)
-        try:
-            restore_conn.backup(target_conn)
-        finally:
-            target_conn.close()
-    finally:
-        restore_conn.close()
-
-    # Invalidate shared connection so db.py reconnects to restored data
-    import db
-    if db._shared_conn is not None:
-        try:
-            db._shared_conn.close()
-        except Exception:
-            pass
-        db._shared_conn = None
-
-    return f"DB restaurada desde {filename}. Safety backup: {os.path.basename(safety)}"
-
-
-def _cleanup_old():
-    """Remove backups older than RETENTION_DAYS.
-
-    Covers both the hourly `nexo-YYYY-MM-DD-HHMM.db` snapshots and the
-    `nexo-pre-restore-*.db` safety snapshots created by handle_backup_restore.
-    Failures are swallowed — housekeeping must never interrupt the caller.
-    """
-    if not os.path.isdir(BACKUP_DIR):
-        return
-    cutoff = time.time() - (RETENTION_DAYS * 86400)
-    # glob `nexo-*.db` matches both the hourly pattern and pre-restore
-    # snapshots, so a single loop prunes both with a single pass.
-    for f in glob.glob(os.path.join(BACKUP_DIR, "nexo-*.db")):
-        try:
-            if os.path.getmtime(f) < cutoff:
-                os.remove(f)
-        except OSError:
-            # Permission / concurrent removal — skip silently.
-            pass
-
-
-TOOLS = [
-    (handle_backup_now, "nexo_backup_now", "Create an immediate backup of the NEXO database"),
-    (handle_backup_list, "nexo_backup_list", "List available backups with dates and sizes"),
-    (handle_backup_restore, "nexo_backup_restore", "Restore database from a backup (DESTRUCTIVE)"),
-]

package/src/plugins/claims_tools 2.py

@@ -1,119 +0,0 @@
-"""Claims/wiki plugin — public surface over NEXO claim graph."""
-
-import claim_graph
-
-
-def handle_claim_add(
-    text: str,
-    domain: str = "",
-    evidence: str = "",
-    confidence: float = 1.0,
-    source_type: str = "",
-    source_id: str = "",
-    freshness_days: int = 30,
-) -> str:
-    result = claim_graph.add_claim(
-        text=text,
-        domain=domain,
-        evidence=evidence,
-        confidence=confidence,
-        source_type=source_type,
-        source_id=source_id,
-        freshness_days=freshness_days,
-    )
-    if result.get("error"):
-        return f"ERROR: {result['error']}"
-    return f"Claim #{result['id']} {result['action']} (confidence={result['confidence']})"
-
-
-def handle_claim_search(query: str = "", domain: str = "", status: str = "", limit: int = 20) -> str:
-    items = claim_graph.search_claims(query=query, domain=domain, status=status, limit=limit)
-    if not items:
-        return "No claims found."
-    lines = [f"CLAIMS — {len(items)} result(s):", ""]
-    for item in items:
-        lines.append(
-            f"  #{item['id']} [{item.get('verification_status','unverified')}] "
-            f"freshness={item.get('freshness_state','?')}({item.get('freshness_score',0)})"
-        )
-        lines.append(f"    {item['text'][:220]}")
-        if item.get("evidence"):
-            lines.append(f"    evidence: {str(item['evidence'])[:180]}")
-        if item.get("domain"):
-            lines.append(f"    domain: {item['domain']}")
-    return "\n".join(lines)
-
-
-def handle_claim_get(claim_id: int) -> str:
-    item = claim_graph.get_claim(claim_id)
-    if not item:
-        return f"Claim #{claim_id} not found."
-    lines = [
-        f"CLAIM #{item['id']}",
-        f"  status: {item.get('verification_status', 'unverified')}",
-        f"  confidence: {item.get('confidence', 0)}",
-        f"  freshness: {item.get('freshness_state', '?')} ({item.get('freshness_score', 0)})",
-        f"  age_days: {item.get('age_days', 0)}",
-        f"  domain: {item.get('domain', '') or 'n/a'}",
-        f"  source: {item.get('source_type', '')}:{item.get('source_id', '')}",
-        f"  text: {item.get('text', '')}",
-    ]
-    if item.get("evidence"):
-        lines.append(f"  evidence: {item['evidence']}")
-    if item.get("links_out"):
-        lines.append(f"  links_out: {len(item['links_out'])}")
-    if item.get("links_in"):
-        lines.append(f"  links_in: {len(item['links_in'])}")
-    return "\n".join(lines)
-
-
-def handle_claim_link(source_claim_id: int, target_claim_id: int, relation: str, confidence: float = 1.0) -> str:
-    result = claim_graph.link_claims(source_claim_id, target_claim_id, relation, confidence=confidence)
-    if result.get("error"):
-        return f"ERROR: {result['error']}"
-    return f"Linked claim #{source_claim_id} -> #{target_claim_id} [{relation}]"
-
-
-def handle_claim_verify(claim_id: int, status: str = "confirmed") -> str:
-    result = claim_graph.verify_claim(claim_id, status=status)
-    if result.get("error"):
-        return f"ERROR: {result['error']}"
-    return (
-        f"Claim #{result['id']} now {result['verification_status']} "
-        f"(freshness={result.get('freshness_state', '?')} {result.get('freshness_score', 0)})"
-    )
-
-
-def handle_claim_lint(max_age_days: int = 30, limit: int = 20) -> str:
-    items = claim_graph.lint_claims(max_age_days=max_age_days, limit=limit)
-    if not items:
-        return "Claim lint: no attention items."
-    lines = [f"CLAIM LINT — {len(items)} attention item(s):", ""]
-    for item in items:
-        lines.append(f"  #{item['id']} [{', '.join(item.get('lint_reasons', []))}]")
-        lines.append(f"    {item['text'][:220]}")
-    return "\n".join(lines)
-
-
-def handle_claim_stats() -> str:
-    stats = claim_graph.stats()
-    return (
-        "CLAIM GRAPH STATS\n"
-        f"  total: {stats['total_claims']}\n"
-        f"  links: {stats['total_links']}\n"
-        f"  contradictions: {stats['contradictions']}\n"
-        f"  lint_attention: {stats['lint_attention']}\n"
-        f"  by_status: {stats['by_status']}\n"
-        f"  by_domain: {stats['by_domain']}"
-    )
-
-
-TOOLS = [
-    (handle_claim_add, "nexo_claim_add", "Add a structured claim with provenance, evidence, and freshness."),
-    (handle_claim_search, "nexo_claim_search", "Search claims by meaning or filters."),
-    (handle_claim_get, "nexo_claim_get", "Get a single claim with its links and freshness metadata."),
-    (handle_claim_link, "nexo_claim_link", "Link two claims with supports/contradicts/refines/supersedes."),
-    (handle_claim_verify, "nexo_claim_verify", "Verify or reclassify a claim state."),
-    (handle_claim_lint, "nexo_claim_lint", "Audit stale, weak, contradictory, or evidence-poor claims."),
-    (handle_claim_stats, "nexo_claim_stats", "Claim graph statistics and attention counts."),
-]