nexo-brain 2.3.0 → 2.3.1

package/scripts/migrate-v1.7-to-v1.8 2.py

@@ -1,214 +0,0 @@
-#!/usr/bin/env python3
-"""
-NEXO Migration Script: v1.7.x -> v1.8.0 (Hybrid Architecture)
-
-Migrates CLAUDE.md to the new hybrid architecture where:
-- CLAUDE.md = bootstrap (identity, profile, format, autonomy, project atlas)
-- MCP instructions field = tool-coupled behavioral rules
-- nexo_context_packet = on-demand area-specific context
-
-The MCP server now carries all tool-coupled rules in its `instructions` field,
-so CLAUDE.md no longer needs to duplicate them. This reduces CLAUDE.md from
-~130 lines to ~50 lines, saving ~3K context tokens per session.
-
-Safe to run multiple times (idempotent). Creates a backup before modifying.
-
-Usage:
-    python3 migrate-v1.7-to-v1.8.py [--dry-run] [--nexo-home /path/to/nexo]
-"""
-
-import argparse
-import os
-import re
-import shutil
-import sys
-from datetime import datetime
-
-
-# Sections that are now in the MCP instructions field and should be REMOVED from CLAUDE.md
-MCP_OWNED_SECTIONS = [
-    "Heartbeat",
-    "Guard",
-    "Delegation",
-    "Reminders & Followups",
-    "Reminders y Followups",
-    "Memory",
-    "Memoria",
-    "Trust Score",
-    "Adaptive Mode",
-    "Dissonance",
-    "Disonancia",
-    "Observe the User",
-    "Observar a Francisco",  # legacy personal CLAUDE.md files
-    "Observar al Usuario",
-    "Change Log",
-    "Session Diary",
-    "Cortex",
-    "Operational Codex",
-]
-
-# Sections that STAY in CLAUDE.md (bootstrap layer)
-BOOTSTRAP_SECTIONS = [
-    "Startup",
-    "User Profile",
-    "Francisco",  # legacy personal CLAUDE.md files
-    "Formato",
-    "Format",
-    "Autonomy",
-    "Autonomía",
-    "Project Atlas",
-    "Atlas de Proyectos",
-    "Hooks",
-    "Menu",
-    "Platforms",
-    "Plataformas",
-    "Repo",
-]
-
-
-def find_nexo_home(override=None):
-    if override:
-        return override
-    candidates = [
-        os.path.expanduser("~/nexo"),
-        os.path.expanduser("~/.nexo"),
-        os.path.expanduser("~/claude/nexo-mcp"),
-    ]
-    for c in candidates:
-        if os.path.isdir(c):
-            return c
-    return None
-
-
-def find_claude_md():
-    """Find the CLAUDE.md file that contains NEXO instructions."""
-    candidates = [
-        os.path.expanduser("~/.claude/CLAUDE.md"),
-        os.path.expanduser("~/CLAUDE.md"),
-    ]
-    for c in candidates:
-        if os.path.isfile(c):
-            return c
-    return None
-
-
-def parse_sections(content):
-    """Parse markdown into sections by ## headers."""
-    sections = []
-    current_header = None
-    current_lines = []
-
-    for line in content.split("\n"):
-        if line.startswith("## "):
-            if current_header is not None:
-                sections.append((current_header, "\n".join(current_lines)))
-            current_header = line[3:].strip()
-            current_lines = [line]
-        else:
-            current_lines.append(line)
-
-    if current_header is not None:
-        sections.append((current_header, "\n".join(current_lines)))
-    elif current_lines:
-        sections.append(("_preamble", "\n".join(current_lines)))
-
-    return sections
-
-
-def is_mcp_owned(header):
-    """Check if a section header matches an MCP-owned section."""
-    header_lower = header.lower()
-    for section in MCP_OWNED_SECTIONS:
-        if section.lower() in header_lower:
-            return True
-    return False
-
-
-def migrate_claude_md(path, dry_run=False):
-    """Slim down CLAUDE.md by removing MCP-owned sections."""
-    with open(path, "r") as f:
-        content = f.read()
-
-    original_lines = len(content.strip().split("\n"))
-    sections = parse_sections(content)
-
-    # Separate preamble, bootstrap, and MCP-owned sections
-    preamble = ""
-    kept = []
-    removed = []
-
-    for header, body in sections:
-        if header == "_preamble":
-            preamble = body
-        elif is_mcp_owned(header):
-            removed.append(header)
-        else:
-            kept.append((header, body))
-
-    if not removed:
-        print("  CLAUDE.md already migrated (no MCP-owned sections found).")
-        return False
-
-    # Add hybrid architecture note to preamble
-    if "MCP instructions" not in preamble and "instructions" not in preamble:
-        preamble = preamble.rstrip() + (
-            "\nTool-coupled behavioral rules (heartbeat, guard, trust, memory, diary) "
-            "now live in the MCP server instructions field and are injected automatically.\n"
-        )
-
-    # Reconstruct
-    new_content = preamble + "\n"
-    for header, body in kept:
-        new_content += "\n" + body + "\n"
-
-    new_lines = len(new_content.strip().split("\n"))
-
-    print(f"  Sections removed (now in MCP): {', '.join(removed)}")
-    print(f"  Lines: {original_lines} → {new_lines} (saved {original_lines - new_lines})")
-
-    if dry_run:
-        print("  [DRY RUN] No changes written.")
-        return True
-
-    # Backup
-    backup = path + f".backup-{datetime.now().strftime(\"%Y%m%d-%H%M%S\")}"
-    shutil.copy2(path, backup)
-    print(f"  Backup: {backup}")
-
-    with open(path, "w") as f:
-        f.write(new_content)
-    print("  CLAUDE.md updated.")
-    return True
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Migrate NEXO to v1.8 hybrid architecture")
-    parser.add_argument("--dry-run", action="store_true", help="Show what would change without modifying files")
-    parser.add_argument("--nexo-home", help="Override NEXO home directory")
-    args = parser.parse_args()
-
-    print("NEXO v1.7 → v1.8 Migration (Hybrid Architecture)")
-    print("=" * 50)
-    print()
-
-    # Step 1: Find and migrate CLAUDE.md
-    claude_md = find_claude_md()
-    if claude_md:
-        print(f"Found CLAUDE.md: {claude_md}")
-        migrate_claude_md(claude_md, dry_run=args.dry_run)
-    else:
-        print("No CLAUDE.md found (skipping).")
-
-    print()
-    print("Migration complete.")
-    print()
-    print("What changed:")
-    print("  - CLAUDE.md now contains only bootstrap (identity, format, autonomy)")
-    print("  - Tool-coupled rules are in the MCP server instructions field")
-    print("  - Context-specific rules load on-demand via nexo_context_packet")
-    print()
-    print("The MCP server must be restarted for instructions to take effect.")
-
-
-if __name__ == "__main__":
-    main()

package/scripts/migrate-v1.7-to-v1.8.py

@@ -1,214 +0,0 @@
-#!/usr/bin/env python3
-"""
-NEXO Migration Script: v1.7.x -> v1.8.0 (Hybrid Architecture)
-
-Migrates CLAUDE.md to the new hybrid architecture where:
-- CLAUDE.md = bootstrap (identity, profile, format, autonomy, project atlas)
-- MCP instructions field = tool-coupled behavioral rules
-- nexo_context_packet = on-demand area-specific context
-
-The MCP server now carries all tool-coupled rules in its `instructions` field,
-so CLAUDE.md no longer needs to duplicate them. This reduces CLAUDE.md from
-~130 lines to ~50 lines, saving ~3K context tokens per session.
-
-Safe to run multiple times (idempotent). Creates a backup before modifying.
-
-Usage:
-    python3 migrate-v1.7-to-v1.8.py [--dry-run] [--nexo-home /path/to/nexo]
-"""
-
-import argparse
-import os
-import re
-import shutil
-import sys
-from datetime import datetime
-
-
-# Sections that are now in the MCP instructions field and should be REMOVED from CLAUDE.md
-MCP_OWNED_SECTIONS = [
-    "Heartbeat",
-    "Guard",
-    "Delegation",
-    "Reminders & Followups",
-    "Reminders y Followups",
-    "Memory",
-    "Memoria",
-    "Trust Score",
-    "Adaptive Mode",
-    "Dissonance",
-    "Disonancia",
-    "Observe the User",
-    "Observar a {{user}}",  # legacy personal CLAUDE.md files
-    "Observar al Usuario",
-    "Change Log",
-    "Session Diary",
-    "Cortex",
-    "Operational Codex",
-]
-
-# Sections that STAY in CLAUDE.md (bootstrap layer)
-BOOTSTRAP_SECTIONS = [
-    "Startup",
-    "User Profile",
-    "{{user_name}}",  # legacy personal CLAUDE.md files
-    "Formato",
-    "Format",
-    "Autonomy",
-    "Autonomía",
-    "Project Atlas",
-    "Atlas de Proyectos",
-    "Hooks",
-    "Menu",
-    "Platforms",
-    "Plataformas",
-    "Repo",
-]
-
-
-def find_nexo_home(override=None):
-    if override:
-        return override
-    candidates = [
-        os.path.expanduser("~/nexo"),
-        os.path.expanduser("~/.nexo"),
-        os.path.expanduser("~/claude/nexo-mcp"),
-    ]
-    for c in candidates:
-        if os.path.isdir(c):
-            return c
-    return None
-
-
-def find_claude_md():
-    """Find the CLAUDE.md file that contains NEXO instructions."""
-    candidates = [
-        os.path.expanduser("~/.claude/CLAUDE.md"),
-        os.path.expanduser("~/CLAUDE.md"),
-    ]
-    for c in candidates:
-        if os.path.isfile(c):
-            return c
-    return None
-
-
-def parse_sections(content):
-    """Parse markdown into sections by ## headers."""
-    sections = []
-    current_header = None
-    current_lines = []
-
-    for line in content.split("\n"):
-        if line.startswith("## "):
-            if current_header is not None:
-                sections.append((current_header, "\n".join(current_lines)))
-            current_header = line[3:].strip()
-            current_lines = [line]
-        else:
-            current_lines.append(line)
-
-    if current_header is not None:
-        sections.append((current_header, "\n".join(current_lines)))
-    elif current_lines:
-        sections.append(("_preamble", "\n".join(current_lines)))
-
-    return sections
-
-
-def is_mcp_owned(header):
-    """Check if a section header matches an MCP-owned section."""
-    header_lower = header.lower()
-    for section in MCP_OWNED_SECTIONS:
-        if section.lower() in header_lower:
-            return True
-    return False
-
-
-def migrate_claude_md(path, dry_run=False):
-    """Slim down CLAUDE.md by removing MCP-owned sections."""
-    with open(path, "r") as f:
-        content = f.read()
-
-    original_lines = len(content.strip().split("\n"))
-    sections = parse_sections(content)
-
-    # Separate preamble, bootstrap, and MCP-owned sections
-    preamble = ""
-    kept = []
-    removed = []
-
-    for header, body in sections:
-        if header == "_preamble":
-            preamble = body
-        elif is_mcp_owned(header):
-            removed.append(header)
-        else:
-            kept.append((header, body))
-
-    if not removed:
-        print("  CLAUDE.md already migrated (no MCP-owned sections found).")
-        return False
-
-    # Add hybrid architecture note to preamble
-    if "MCP instructions" not in preamble and "instructions" not in preamble:
-        preamble = preamble.rstrip() + (
-            "\nTool-coupled behavioral rules (heartbeat, guard, trust, memory, diary) "
-            "now live in the MCP server instructions field and are injected automatically.\n"
-        )
-
-    # Reconstruct
-    new_content = preamble + "\n"
-    for header, body in kept:
-        new_content += "\n" + body + "\n"
-
-    new_lines = len(new_content.strip().split("\n"))
-
-    print(f"  Sections removed (now in MCP): {', '.join(removed)}")
-    print(f"  Lines: {original_lines} → {new_lines} (saved {original_lines - new_lines})")
-
-    if dry_run:
-        print("  [DRY RUN] No changes written.")
-        return True
-
-    # Backup
-    backup = path + f".backup-{datetime.now().strftime(\"%Y%m%d-%H%M%S\")}"
-    shutil.copy2(path, backup)
-    print(f"  Backup: {backup}")
-
-    with open(path, "w") as f:
-        f.write(new_content)
-    print("  CLAUDE.md updated.")
-    return True
-
-
-def main():
-    parser = argparse.ArgumentParser(description="Migrate NEXO to v1.8 hybrid architecture")
-    parser.add_argument("--dry-run", action="store_true", help="Show what would change without modifying files")
-    parser.add_argument("--nexo-home", help="Override NEXO home directory")
-    args = parser.parse_args()
-
-    print("NEXO v1.7 → v1.8 Migration (Hybrid Architecture)")
-    print("=" * 50)
-    print()
-
-    # Step 1: Find and migrate CLAUDE.md
-    claude_md = find_claude_md()
-    if claude_md:
-        print(f"Found CLAUDE.md: {claude_md}")
-        migrate_claude_md(claude_md, dry_run=args.dry_run)
-    else:
-        print("No CLAUDE.md found (skipping).")
-
-    print()
-    print("Migration complete.")
-    print()
-    print("What changed:")
-    print("  - CLAUDE.md now contains only bootstrap (identity, format, autonomy)")
-    print("  - Tool-coupled rules are in the MCP server instructions field")
-    print("  - Context-specific rules load on-demand via nexo_context_packet")
-    print()
-    print("The MCP server must be restarted for instructions to take effect.")
-
-
-if __name__ == "__main__":
-    main()

package/scripts/nexo-preflight.sh

@@ -1,236 +0,0 @@
-#!/bin/bash
-# ============================================================================
-# NEXO Preflight — CI / manual verification script
-# Checks: Python syntax, shell syntax, manifest<->file consistency,
-#         manifest<->watchdog consistency
-# Exit code: 0 if all PASS, 1 if any FAIL
-# Usage: bash scripts/nexo-preflight.sh
-# ============================================================================
-set -uo pipefail
-
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-SRC="$REPO_ROOT/src"
-MANIFEST="$SRC/crons/manifest.json"
-WATCHDOG="$SRC/scripts/nexo-watchdog.sh"
-
-PASS=0
-FAIL=0
-WARN=0
-
-pass() { echo "  PASS  $1"; ((PASS++)); }
-fail() { echo "  FAIL  $1"; ((FAIL++)); }
-warn() { echo "  WARN  $1"; ((WARN++)); }
-
-echo "============================================================"
-echo "NEXO Preflight — $(date '+%Y-%m-%d %H:%M:%S')"
-echo "============================================================"
-
-# ── 1. py_compile for all Python scripts in src/scripts/ ──────────────────
-echo ""
-# Non-core scripts to exclude from compilation checks
-NON_CORE="check-context.py"
-
-echo "--- Check 1: Python syntax (src/scripts/*.py) ---"
-for pyfile in "$SRC"/scripts/*.py; do
-    # Skip " 2" duplicate files (backup copies)
-    [[ "$pyfile" == *" 2"* ]] && continue
-    [ -f "$pyfile" ] || continue
-    name=$(basename "$pyfile")
-    # Skip non-core scripts
-    for skip in $NON_CORE; do
-        [[ "$name" == "$skip" ]] && continue 2
-    done
-    if python3 -m py_compile "$pyfile" 2>/dev/null; then
-        pass "$name"
-    else
-        fail "$name — py_compile error"
-    fi
-done
-
-# ── 2. py_compile for auto_close_sessions.py ──────────────────────────────
-echo ""
-echo "--- Check 2: Python syntax (auto_close_sessions.py) ---"
-ACS="$SRC/auto_close_sessions.py"
-if [ -f "$ACS" ]; then
-    if python3 -m py_compile "$ACS" 2>/dev/null; then
-        pass "auto_close_sessions.py"
-    else
-        fail "auto_close_sessions.py — py_compile error"
-    fi
-else
-    fail "auto_close_sessions.py — file not found"
-fi
-
-# ── 3. bash -n for all shell scripts in src/scripts/ ─────────────────────
-echo ""
-echo "--- Check 3: Shell syntax (src/scripts/*.sh) ---"
-for shfile in "$SRC"/scripts/*.sh; do
-    # Skip " 2" duplicate files (backup copies)
-    [[ "$shfile" == *" 2"* ]] && continue
-    [ -f "$shfile" ] || continue
-    name=$(basename "$shfile")
-    if bash -n "$shfile" 2>/dev/null; then
-        pass "$name"
-    else
-        fail "$name — bash -n syntax error"
-    fi
-done
-
-# ── 4. Manifest<->file consistency ────────────────────────────────────────
-echo ""
-echo "--- Check 4: Manifest crons have existing script files ---"
-if [ ! -f "$MANIFEST" ]; then
-    fail "manifest.json not found at $MANIFEST"
-else
-    # Extract script paths from manifest crons
-    cron_scripts=$(python3 -c "
-import json, sys
-try:
-    m = json.load(open('$MANIFEST'))
-    for c in m.get('crons', []):
-        print(c.get('id', '?') + '|' + c.get('script', ''))
-except Exception as e:
-    print(f'ERROR|{e}', file=sys.stderr)
-    sys.exit(1)
-" 2>/dev/null)
-
-    if [ $? -ne 0 ]; then
-        fail "manifest.json — cannot parse JSON"
-    else
-        while IFS='|' read -r cron_id script_path; do
-            [ -z "$script_path" ] && continue
-            full_path="$SRC/$script_path"
-            if [ -f "$full_path" ]; then
-                pass "cron '$cron_id' -> $script_path exists"
-            else
-                fail "cron '$cron_id' -> $script_path NOT FOUND"
-            fi
-        done <<< "$cron_scripts"
-    fi
-fi
-
-# ── 5. Manifest<->watchdog MONITORS consistency ──────────────────────────
-echo ""
-echo "--- Check 5: Manifest crons present in watchdog MONITORS ---"
-if [ ! -f "$WATCHDOG" ]; then
-    fail "nexo-watchdog.sh not found at $WATCHDOG"
-else
-    # The watchdog dynamically builds MONITORS from manifest.json via
-    # _build_monitors_from_manifest(). Verify that function exists and
-    # references the manifest, plus check that any hardcoded PERSONAL_MONITORS
-    # use valid com.nexo.* plist IDs.
-
-    if grep -q "_build_monitors_from_manifest" "$WATCHDOG"; then
-        pass "watchdog dynamically loads MONITORS from manifest.json"
-    else
-        fail "watchdog does NOT reference _build_monitors_from_manifest"
-    fi
-
-    if grep -q 'MANIFEST_FILE' "$WATCHDOG"; then
-        pass "watchdog references MANIFEST_FILE"
-    else
-        fail "watchdog does NOT reference MANIFEST_FILE for dynamic loading"
-    fi
-
-    # Check that any hardcoded personal monitors have valid format
-    personal_count=$(grep -c '|com\.nexo\.' "$WATCHDOG" 2>/dev/null || echo 0)
-    if [ "$personal_count" -gt 0 ]; then
-        pass "watchdog has $personal_count personal monitor entries"
-    else
-        pass "watchdog has no hardcoded personal monitors (all from manifest)"
-    fi
-fi
-
-# ── 6. Manifest<->README consistency ─────────────────────────────────────
-echo ""
-echo "--- Check 6: Manifest crons mentioned in README ---"
-README="$REPO_ROOT/README.md"
-if [ -f "$README" ] && [ -f "$MANIFEST" ]; then
-    manifest_ids=$(python3 -c "
-import json
-m = json.load(open('$MANIFEST'))
-for c in m.get('crons', []):
-    print(c['id'])
-" 2>/dev/null)
-
-    for cid in $manifest_ids; do
-        if grep -qE "\*\*${cid}\*\*|${cid}" "$README" 2>/dev/null; then
-            pass "cron '$cid' documented in README"
-        else
-            fail "cron '$cid' NOT in README"
-        fi
-    done
-else
-    warn "README.md or manifest.json not found, skipping"
-fi
-
-# ── 7. Smoke tests ──────────────────────────────────────────────────────
-echo ""
-echo "--- Check 7: Smoke tests ---"
-
-# 7a: catchup weekday conversion (manifest 0=Sunday -> python 6)
-WEEKDAY_TEST=$(python3 -c "
-# Simulate the conversion from catchup.py
-manifest_weekday = 0  # Sunday in cron/launchd
-py_weekday = (manifest_weekday - 1) % 7  # Should be 6 (Sunday in Python)
-assert py_weekday == 6, f'Expected 6 (Sunday), got {py_weekday}'
-# Also test Monday
-assert (1 - 1) % 7 == 0, 'Monday should be 0'
-# Saturday
-assert (6 - 1) % 7 == 5, 'Saturday should be 5'
-print('OK')
-" 2>&1)
-if [ "$WEEKDAY_TEST" = "OK" ]; then
-    pass "catchup weekday conversion (manifest 0=Sun -> python 6)"
-else
-    fail "catchup weekday conversion: $WEEKDAY_TEST"
-fi
-
-# 7b: change_log schema uses what_changed (not description)
-SCHEMA_TEST=$(python3 -c "
-import sys
-sys.path.insert(0, '$SRC')
-# Verify change_log columns match what learning-housekeep uses
-with open('$SRC/db/_core.py') as f:
-    core = f.read()
-if 'what_changed' in core:
-    print('OK')
-else:
-    print('FAIL: what_changed not found in _core.py')
-" 2>&1)
-if [ "$SCHEMA_TEST" = "OK" ]; then
-    pass "change_log schema uses what_changed (matches reconciler)"
-else
-    fail "change_log schema: $SCHEMA_TEST"
-fi
-
-# 7c: reconciler queries use correct columns for change_log
-RECONCILER_TEST=$(python3 -c "
-with open('$SRC/scripts/nexo-learning-housekeep.py') as f:
-    code = f.read()
-# Find the change_log section of _reconcile_decision_outcome
-cl_section = code[code.index('# Check change_log'):code.index('return None', code.index('# Check change_log'))]
-if 'what_changed LIKE' in cl_section:
-    print('OK')
-else:
-    print('FAIL: change_log section does not use what_changed')
-" 2>&1)
-if [ "$RECONCILER_TEST" = "OK" ]; then
-    pass "reconciler uses correct change_log columns"
-else
-    fail "reconciler columns: $RECONCILER_TEST"
-fi
-
-# ── Summary ───────────────────────────────────────────────────────────────
-echo ""
-echo "============================================================"
-echo "Results: $PASS PASS, $FAIL FAIL, $WARN WARN"
-echo "============================================================"
-
-if [ "$FAIL" -gt 0 ]; then
-    echo "PREFLIGHT FAILED"
-    exit 1
-else
-    echo "PREFLIGHT OK"
-    exit 0
-fi