#!/usr/bin/env python3
"""CLI commands for nucleus-mcp."""

import os
import json
import sys
import time
import shutil
from datetime import datetime
from pathlib import Path
import argparse

# ============================================================================
# TEMPLATE: DEFAULT (Full structure)
# ============================================================================
DEFAULT_STATE = {
    "version": "1.0.0",
    "current_sprint": {
        "name": "Sprint 1",
        "focus": "Getting Started with Nucleus",
        "started_at": None
    },
    "top_3_leverage_actions": [
        "Set up your first agent",
        "Configure triggers",
        "Connect to Claude Desktop"
    ]
}

DEFAULT_TRIGGERS = {
    "version": "1.0.0",
    "triggers": [
        {
            "event_type": "task_completed",
            "target_agent": "synthesizer",
            "emitter_filter": None
        },
        {
            "event_type": "research_done",
            "target_agent": "architect",
            "emitter_filter": ["researcher"]
        }
    ]
}

SAMPLE_AGENT = '''# {agent_name} Agent

## Role
Define what this agent does.

## Responsibilities
- Task 1
- Task 2

## Triggers
Activated when: [define trigger conditions]

## Output Format
Describe expected output format.
'''

# ============================================================================
# ONBOARDING: Instructional Seed Tasks
# ============================================================================

def get_default_tasks():
    """Generate instructional seed tasks with current timestamps."""
    now = datetime.utcnow().isoformat() + "Z"
    return [
        {
            "id": "onboard-1",
            "description": "Welcome! Ask your AI: 'What is my current focus?'",
            "status": "READY",
            "priority": 1,
            "blocked_by": [],
            "required_skills": [],
            "claimed_by": None,
            "source": "nucleus-init",
            "escalation_reason": None,
            "created_at": now,
            "updated_at": now
        },
        {
            "id": "onboard-2",
            "description": "Try: 'Show me all tasks' to see your task queue",
            "status": "PENDING",
            "priority": 2,
            "blocked_by": ["onboard-1"],
            "required_skills": [],
            "claimed_by": None,
            "source": "nucleus-init",
            "escalation_reason": None,
            "created_at": now,
            "updated_at": now
        },
        {
            "id": "onboard-3",
            "description": "Create your first real task: 'Add a task: [your task here]'",
            "status": "PENDING",
            "priority": 3,
            "blocked_by": ["onboard-2"],
            "required_skills": [],
            "claimed_by": None,
            "source": "nucleus-init",
            "escalation_reason": None,
            "created_at": now,
            "updated_at": now
        }
    ]

BRAIN_README = '''# 🧠 Your Nucleus Control Plane

This folder contains your AI assistant's persistent memory.
Generated by Nucleus v0.5.0

## Structure

| Folder | Purpose |
|--------|---------|
| `ledger/` | Event logs, task history |
| `sessions/` | Saved session states |
| `artifacts/` | Generated documents |
| `slots/` | Agent slot registry |
| `memory/` | Engram storage (Memory) |

## Quick Commands

- `brain_session_start()` — Start your session
- `brain_save_session()` — Save current context
- `brain_resume_session()` — Resume previous session
- `brain_list_tasks()` — See pending tasks

## Need Help?

- Docs: [https://github.com/eidetic-works/nucleus-mcp](https://github.com/eidetic-works/nucleus-mcp)
- Issues: [https://github.com/eidetic-works/nucleus-mcp/issues](https://github.com/eidetic-works/nucleus-mcp/issues)
'''

# ============================================================================
# TEMPLATE: SOLO (Minimal structure for solo founders)
# ============================================================================
SOLO_STATE = {
    "version": "1.0.0",
    "mode": "solo",
    "current_focus": "Getting started with Nucleus",
    "tasks": []
}

SOLO_THREAD_REGISTRY = '''# Thread Registry

> **Protocol:** Agents check this file on activation to know their role.
> **Stable Anchor:** Thread ID (UUID) never changes, even when IDE renames the thread.

---

## Active Threads

| Thread ID | Role | Focus |
|:----------|:-----|:------|
| *(Add your threads here)* | | |

---

## How to Use

1. **Find your thread ID** in your IDE's artifact path (e.g., `.gemini/antigravity/brain/<thread-id>/`)
2. **Add a row** to the table above with your role
3. **Agent self-identifies** on next activation by reading this registry

---

## Example

| Thread ID | Role | Focus |
|:----------|:-----|:------|
| `7c654df4-b83e-...` | Lead Systems Architect | Infrastructure, MCP |
| `853a0b7e-9052-...` | Synthesizer | Product work, orchestration |
'''

SOLO_CONTEXT = '''# Project Context

> This file provides context to all AI agents working on your project.

## Company/Project
- **Name:** [Your Project Name]
- **Description:** [What you're building]

## Technical Stack
- **Backend:** 
- **Frontend:** 
- **Database:** 

## Current Priorities
1. 
2. 
3. 
'''


def init_brain_default(brain_path: Path) -> bool:
    """Initialize with default (full) template."""
    dirs = [
        brain_path / "ledger",
        brain_path / "sessions",
        brain_path / "slots",
        brain_path / "artifacts" / "research",
        brain_path / "artifacts" / "strategy",
        brain_path / "agents",
        brain_path / "memory",
    ]
    
    for d in dirs:
        d.mkdir(parents=True, exist_ok=True)
        print(f"  📁 Created {d}")
    
    (brain_path / "ledger" / "state.json").write_text(
        json.dumps(DEFAULT_STATE, indent=2)
    )
    print("  📄 Created ledger/state.json")
    
    (brain_path / "ledger" / "triggers.json").write_text(
        json.dumps(DEFAULT_TRIGGERS, indent=2)
    )
    print("  📄 Created ledger/triggers.json")
    
    (brain_path / "ledger" / "events.jsonl").write_text("")
    print("  📄 Created ledger/events.jsonl")
    
    # Seed instructional tasks
    (brain_path / "ledger" / "tasks.json").write_text(
        json.dumps(get_default_tasks(), indent=2)
    )
    print("  ✅ Created ledger/tasks.json (3 onboarding tasks)")
    
    # In-brain README
    (brain_path / "README.md").write_text(BRAIN_README)
    print("  📖 Created README.md")
    
    (brain_path / "agents" / "synthesizer.md").write_text(
        SAMPLE_AGENT.format(agent_name="Synthesizer")
    )
    print("  🤖 Created agents/synthesizer.md")
    
    (brain_path / "memory" / "context.md").write_text(
        "# Project Context\n\nDescribe your project here.\n"
    )
    print("  📝 Created memory/context.md")
    
    return True


def init_brain_solo(brain_path: Path) -> bool:
    """Initialize with solo (minimal) template."""
    dirs = [
        brain_path / "ledger",
        brain_path / "sessions",
        brain_path / "slots",
        brain_path / "meta",
        brain_path / "memory",
    ]
    
    for d in dirs:
        d.mkdir(parents=True, exist_ok=True)
        print(f"  📁 Created {d}")
    
    (brain_path / "ledger" / "state.json").write_text(
        json.dumps(SOLO_STATE, indent=2)
    )
    print("  📄 Created ledger/state.json (solo mode)")
    
    (brain_path / "meta" / "thread_registry.md").write_text(SOLO_THREAD_REGISTRY)
    print("  📋 Created meta/thread_registry.md")
    
    (brain_path / "memory" / "context.md").write_text(SOLO_CONTEXT)
    print("  📝 Created memory/context.md")
    
    # Seed instructional tasks
    (brain_path / "ledger" / "tasks.json").write_text(
        json.dumps(get_default_tasks(), indent=2)
    )
    print("  ✅ Created ledger/tasks.json (3 onboarding tasks)")
    
    # In-brain README
    (brain_path / "README.md").write_text(BRAIN_README)
    print("  📖 Created README.md")
    
    return True



def init_brain(path: str = ".brain", template: str = "default"):
    """Initialize a new .brain directory structure."""
    brain_path = Path(path)
    
    if brain_path.exists():
        # Count files to detect active brain
        file_count = len(list(brain_path.rglob("*")))
        
        if file_count > 10:
            # This looks like an active brain - extra protection
            print(f"⚠️  {path}/ contains {file_count} files!")
            print("   This looks like an ACTIVE brain with real content.")
            print("   Overwriting is NOT recommended.")
            print()
            response = input("Type 'BACKUP-AND-OVERWRITE' to confirm (or anything else to abort): ")
            if response != 'BACKUP-AND-OVERWRITE':
                print("✅ Aborted. Your brain is safe.")
                return False
        else:
            print(f"⚠️  Directory {path} already exists.")
            response = input("Overwrite? (y/N): ")
            if response.lower() != 'y':
                print("Aborted.")
                return False
        
        # ALWAYS backup before overwrite
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
        backup_path = Path(f"{path}.backup.{timestamp}")
        print(f"📦 Creating backup at {backup_path}...")
        shutil.copytree(brain_path, backup_path)
        print(f"   ✅ Backup complete ({file_count} items saved)")
        
        # Now safe to remove old brain
        shutil.rmtree(brain_path)
    
    print(f"🧠 Initializing Nucleus Control Plane at {path}/ (template: {template})...")
    
    # Route to template-specific init
    if template == "solo":
        init_brain_solo(brain_path)
    else:
        init_brain_default(brain_path)
    
    print("\n✅ Nucleus Control Plane initialized!")
    
    # Generate config and auto-configure
    abs_path = str(brain_path.absolute())
    nucleus_config = {
        "command": "python3",
        "args": ["-m", "mcp_server_nucleus"],
        "env": {"NUCLEAR_BRAIN_PATH": abs_path}
    }
    
    # Attempt auto-configuration for Claude Desktop
    claude_config_path = Path.home() / "Library" / "Application Support" / "Claude" / "claude_desktop_config.json"
    auto_configured = False
    
    if claude_config_path.exists():
        try:
            print("\n🔍 Found Claude Desktop config...")
            backup_path = claude_config_path.with_suffix(".json.bak")
            if not backup_path.exists():
                shutil.copy2(claude_config_path, backup_path)
                print(f"  📦 Created backup at {backup_path}")
            
            with open(claude_config_path, 'r') as f:
                config_data = json.load(f)
            
            if "mcpServers" not in config_data:
                config_data["mcpServers"] = {}
            
            if "nucleus" not in config_data["mcpServers"]:
                config_data["mcpServers"]["nucleus"] = nucleus_config
                
                with open(claude_config_path, 'w') as f:
                    json.dump(config_data, f, indent=2)
                
                print("  ✅ Auto-configured 'nucleus' in Claude Desktop settings!")
                auto_configured = True
            else:
                print("  ℹ️  'nucleus' already configured in Claude Desktop.")
                auto_configured = True
                
        except Exception as e:
            print(f"  ⚠️  Could not auto-configure: {e}")

    if not auto_configured:
        config_snippet = f'''"nucleus": {{
    "command": "python3",
    "args": ["-m", "mcp_server_nucleus"],
    "env": {{
      "NUCLEAR_BRAIN_PATH": "{abs_path}"
    }}
  }}'''
        
        print("\n" + "="*60)
        print("📋 COPY THIS into your AI client's config:")
        print("="*60)
        print()
        print(config_snippet)
        print()
        print("="*60)
        print("\n📍 Config file locations:")
        print("   Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json")
        print("   Cursor:         ~/.cursor/mcp.json") 
        print("   Windsurf:       ~/.codeium/windsurf/mcp_config.json")
    
    print("\n" + "="*60)
    print("🚀 NEXT STEPS")
    print("="*60)
    print("\n1. Restart your AI Client (Claude Desktop, Cursor, etc.)")
    print("2. Try these prompts:")
    print("   • \"What is my current focus?\"")
    print("   • \"Show me all tasks\"")
    print("   • \"Add a task: Build landing page\"")
    print("\n📚 Docs: https://github.com/eidetic-works/nucleus-mcp")
    
    return True


def main():
    """CLI entry point."""
    parser = argparse.ArgumentParser(
        prog='nucleus',
        description='Nucleus Control Plane CLI - Manage your AI coordination system'
    )
    
    subparsers = parser.add_subparsers(dest='cli_command', help='Available commands')
    
    # ============================================================
    # INIT COMMAND
    # ============================================================
    init_parser = subparsers.add_parser('init', help='Initialize a new .brain directory')
    init_parser.add_argument(
        'path',
        nargs='?',
        default='.brain',
        help='Path to create .brain directory (default: .brain)'
    )
    init_parser.add_argument(
        '-t', '--template',
        choices=['default', 'solo'],
        default='default',
        help='Template to use: default (full) or solo (minimal)'
    )
    
    # ============================================================
    # INSTALL COMMAND
    # ============================================================
    install_parser = subparsers.add_parser('install', help='Install an agent from a .nuke artifact')
    install_parser.add_argument('path', help='Path to the .nuke artifact file')

    
    # ============================================================
    # DEPTH COMMANDS (ADHD Accommodation)
    # ============================================================
    depth_parser = subparsers.add_parser('depth', help='Track conversation depth (ADHD guardrail)')
    depth_subparsers = depth_parser.add_subparsers(dest='depth_action', help='Depth actions')
    
    # nucleus depth show
    depth_subparsers.add_parser('show', help='Show current depth indicator')
    
    # nucleus depth up [--to=N]
    depth_up = depth_subparsers.add_parser('up', help='Come back up one level')
    depth_up.add_argument('--to', type=int, help='Go up to specific level (optional)')
    
    # nucleus depth reset
    depth_subparsers.add_parser('reset', help='Reset to root level')
    
    # nucleus depth max N
    depth_max = depth_subparsers.add_parser('max', help='Set max safe depth')
    depth_max.add_argument('level', type=int, help='Max safe depth (1-10)')
    
    # nucleus depth push TOPIC
    depth_push = depth_subparsers.add_parser('push', help='Go deeper into a topic')
    depth_push.add_argument('topic', help='Topic you are diving into')
    
    # nucleus depth map
    depth_subparsers.add_parser('map', help='Show visual exploration map')
    
    # ============================================================
    # FEATURES COMMANDS (Feature Map)
    # ============================================================
    features_parser = subparsers.add_parser('features', help='Manage product feature map')
    features_subparsers = features_parser.add_subparsers(dest='features_action', help='Feature actions')
    
    # nucleus features list [--product=X] [--status=X]
    features_list = features_subparsers.add_parser('list', help='List all features')
    features_list.add_argument('--product', help='Filter by product (gentlequest/nucleus)')
    features_list.add_argument('--status', help='Filter by status')
    
    # nucleus features test <id>
    features_test = features_subparsers.add_parser('test', help='Show test instructions for a feature')
    features_test.add_argument('id', help='Feature ID to get test instructions for')
    
    # nucleus features search <query>
    features_search = features_subparsers.add_parser('search', help='Search features')
    features_search.add_argument('query', help='Search query')
    
    # nucleus features proof <id>
    features_proof = features_subparsers.add_parser('proof', help='Show proof document for a feature')
    features_proof.add_argument('id', help='Feature ID to show proof for')
    
    # nucleus sessions - Session management commands
    sessions_parser = subparsers.add_parser('sessions', help='Session management commands')
    sessions_subparsers = sessions_parser.add_subparsers(dest='sessions_action')
    
    # nucleus sessions list
    sessions_subparsers.add_parser('list', help='List all saved sessions')
    
    # nucleus sessions save <context>
    sessions_save = sessions_subparsers.add_parser('save', help='Save current session')
    sessions_save.add_argument('context', help='Context name (e.g., "Nucleus v0.5.0")')
    sessions_save.add_argument('--task', help='Current active task')
    
    # nucleus sessions resume [id]
    sessions_resume = sessions_subparsers.add_parser('resume', help='Resume a saved session')
    sessions_resume.add_argument('id', nargs='?', help='Session ID to resume (defaults to most recent)')
    
    # --- STATUS SUBCOMMAND (SATELLITE VIEW) ---
    status_parser = subparsers.add_parser('status', help='Show unified satellite view of the brain')
    status_parser.add_argument('--minimal', action='store_true', help='Show minimal view (depth only)')
    status_parser.add_argument('--sprint', action='store_true', help='Show sprint view (includes tasks)')
    status_parser.add_argument('--full', action='store_true', help='Show full view (includes session)')
    
    # --- CONSOLIDATE SUBCOMMAND ---
    consolidate_parser = subparsers.add_parser('consolidate', help='Brain consolidation and cleanup operations')
    consolidate_subparsers = consolidate_parser.add_subparsers(dest='consolidate_action', help='Consolidation commands')
    
    # nucleus consolidate archive
    consolidate_subparsers.add_parser('archive', help='Archive .resolved.* backup files to clean up brain folder')
    
    # nucleus consolidate propose
    consolidate_subparsers.add_parser('propose', help='Detect redundant artifacts and generate merge proposals')
    
    # nucleus consolidate status
    consolidate_subparsers.add_parser('status', help='Show consolidation status and archive info')
    
    # ============================================================
    # SEARCH COMMAND
    # ============================================================
    search_parser = subparsers.add_parser('search', help='Search for agents in the registry')
    search_parser.add_argument('query', help='Search query (name, tag, or description)')

    # ============================================================
    # MOUNT COMMAND
    # ============================================================
    mount_parser = subparsers.add_parser('mount', help='Manage external MCP mounts')
    mount_subparsers = mount_parser.add_subparsers(dest='mount_action', help='Mount actions')

    # nucleus mount add <id> [options]
    mount_add = mount_subparsers.add_parser('add', help='Add a new mount')
    mount_add.add_argument('id', help='Unique mount ID')
    mount_add.add_argument('--transport', choices=['stdio', 'sse'], default='stdio', help='Transport type')
    mount_add.add_argument('--command', help='Command to execute (stdio)')
    mount_add.add_argument('--args', nargs='*', help='Arguments for command (stdio)')
    mount_add.add_argument('--env', nargs='*', help='Environment variables (KEY=VALUE)')
    mount_add.add_argument('--url', help='URL for SSE transport')

    # nucleus mount list
    mount_subparsers.add_parser('list', help='List all mounts')

    # nucleus mount remove <id>
    mount_remove = mount_subparsers.add_parser('remove', help='Remove a mount')
    mount_remove.add_argument('id', help='Mount ID to remove')

    args = parser.parse_args()
    
    if args.cli_command == 'init':
        init_brain(args.path, args.template)
    elif args.cli_command == 'install':
        handle_install_command(args)
    elif args.cli_command == 'mount':
        handle_mount_command(args)
    elif args.cli_command == 'status':
        handle_status_command(args)
    elif args.cli_command == 'depth':
        handle_depth_command(args)
    elif args.cli_command == 'features':
        handle_features_command(args)
    elif args.cli_command == 'sessions':
        handle_sessions_command(args)
    elif args.cli_command == 'consolidate':
        handle_consolidate_command(args)
    elif args.cli_command == 'search':
        handle_search_command(args)
    elif args.cli_command == 'schema':
        handle_schema_command(args)
    elif args.cli_command is None:
        # No command given, show help
        parser.print_help()
    else:
        print(f"Unknown command: {args.cli_command}")
        parser.print_help()


def handle_depth_command(args):
    """Handle depth subcommands."""
    # Import the core functions from __init__
    try:
        from . import _depth_show, _depth_pop, _depth_reset, _depth_set_max, _depth_push, _generate_depth_map
    except ImportError:
        # Direct import for testing
        try:
            from mcp_server_nucleus import _depth_show, _depth_pop, _depth_reset, _depth_set_max, _depth_push, _generate_depth_map
        except ImportError:
            print("Error: Could not import depth functions. Make sure NUCLEAR_BRAIN_PATH is set.")
            return
    
    if args.depth_action == 'show' or args.depth_action is None:
        result = _depth_show()
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        print()
        print("╔═══════════════════════════════════════════════════════════╗")
        print(f"║ {result['indicator']:^59} ║")
        print("╟───────────────────────────────────────────────────────────╢")
        print(f"║ Status: {result['status']:<51} ║")
        print("╟───────────────────────────────────────────────────────────╢")
        if result['breadcrumbs']:
            print(f"║ Path: {result['breadcrumbs'][:53]:<53} ║")
        else:
            print("║ Path: (root level)                                       ║")
        print("╟───────────────────────────────────────────────────────────╢")
        print("║ Tree:                                                     ║")
        for line in result['tree'].split('\n')[:5]:  # Max 5 lines
            print(f"║   {line:<56} ║")
        print("╚═══════════════════════════════════════════════════════════╝")
        print()
        print("Commands: nucleus depth up | nucleus depth reset | nucleus depth push <topic>")
        
    elif args.depth_action == 'up':
        to_level = getattr(args, 'to', None)
        if to_level is not None:
            # Pop multiple times to reach target level
            result = _depth_show()
            current = result.get('current_depth', 0)
            pops_needed = current - to_level
            if pops_needed <= 0:
                print(f"Already at or below level {to_level}")
                return
            for _ in range(pops_needed):
                result = _depth_pop()
        else:
            result = _depth_pop()
        
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        print(result.get('message', '✅ Popped up one level'))
        print(f"  {result['indicator']}")
        if result.get('breadcrumbs'):
            print(f"  Path: {result['breadcrumbs']}")
        
    elif args.depth_action == 'reset':
        result = _depth_reset()
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        print(result['message'])
        print(f"  New session: {result['session_id']}")
        
    elif args.depth_action == 'max':
        result = _depth_set_max(args.level)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        print(f"✅ {result['message']}")
        print(f"  {result['indicator']}")
        
    elif args.depth_action == 'push':
        result = _depth_push(args.topic)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        print(f"📍 Diving into: {args.topic}")
        print(f"  {result['indicator']}")
        if result.get('warning'):
            print(f"  {result['warning']}")
        print(f"  Path: {result['breadcrumbs']}")
        
    elif args.depth_action == 'map':
        result = _generate_depth_map()
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        print(f"🗺️  {result['message']}")
        print(f"  Path: {result.get('path', '(root)')}")
        print()
        print("─" * 50)
        print(result['mermaid'])
        print("─" * 50)
        print()
        print("💡 Copy the mermaid code block to visualize in any markdown viewer!")
        
    else:
        # Show depth help
        print("Usage: nucleus depth <action>")
        print()
        print("Actions:")
        print("  show    Show current depth indicator")
        print("  up      Come back up one level")
        print("  reset   Reset to root level")
        print("  max N   Set max safe depth")
        print("  push X  Go deeper into topic X")
        print("  map     Show visual exploration map")


def handle_features_command(args):
    """Handle features subcommands."""
    # Import feature functions from main module
    from . import _list_features, _get_feature, _search_features, _get_proof
    
    if args.features_action == 'list':
        result = _list_features(args.product, args.status, None)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        features = result.get("features", [])
        if not features:
            print("📋 No features found.")
            if args.product or args.status:
                print("   Try removing filters to see all features.")
            return
        
        # Group by product
        by_product = {}
        for f in features:
            prod = f.get("product", "unknown")
            by_product.setdefault(prod, []).append(f)
        
        print(f"\n📋 Features ({len(features)} total)")
        print("=" * 60)
        
        for product, prod_features in by_product.items():
            print(f"\n{product.upper()} ({len(prod_features)} features):")
            print("-" * 40)
            for f in prod_features:
                status_icon = {
                    "production": "✅",
                    "released": "✅",
                    "development": "🚧",
                    "staged": "🔄",
                    "broken": "❌",
                    "deprecated": "⚠️"
                }.get(f.get("status"), "❓")
                
                validated = f.get("validation_result")
                val_icon = "✅" if validated == "passed" else "❌" if validated == "failed" else "⏳"
                
                print(f"  {status_icon} {f.get('name'):<30} v{f.get('version'):<8} {val_icon}")
        
        print()
        
    elif args.features_action == 'test':
        result = _get_feature(args.id)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        f = result.get("feature", {})
        print(f"\n🧪 How to Test: {f.get('name')}")
        print("=" * 60)
        print(f"\n📝 Description: {f.get('description')}")
        print(f"📦 Product: {f.get('product')}")
        print(f"🏷️  Version: {f.get('version')}")
        print(f"📊 Status: {f.get('status')}")
        
        print("\n📋 Test Steps:")
        for i, step in enumerate(f.get("how_to_test", []), 1):
            print(f"   {i}. {step}")
        
        print("\n✅ Expected Result:")
        print(f"   {f.get('expected_result')}")
        
        if f.get("deployed_url"):
            print(f"\n🌐 URL: {f.get('deployed_url')}")
        
        validated = f.get("validation_result")
        last_val = f.get("last_validated")
        if validated:
            val_icon = "✅" if validated == "passed" else "❌"
            print(f"\n📅 Last Validated: {last_val} - {val_icon} {validated.upper()}")
        else:
            print("\n⏳ Not yet validated")
        
        print()
        
    elif args.features_action == 'search':
        result = _search_features(args.query)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        features = result.get("features", [])
        if not features:
            print(f"🔍 No features found matching '{args.query}'")
            return
        
        print(f"\n🔍 Search results for '{args.query}' ({len(features)} matches)")
        print("-" * 50)
        for f in features:
            print(f"  • {f.get('name')} ({f.get('product')}) - {f.get('description')[:50]}...")
        print()
        
    elif args.features_action == 'proof':
        result = _get_proof(args.id)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        if not result.get("exists"):
            print(f"📋 {result.get('message')}")
            print()
            print("💡 Generate a proof with:")
            print(f"   In Claude: brain_generate_proof(feature_id='{args.id}', thinking='...')")
            return
        
        print(result.get("content", ""))
        
    else:
        # Show features help
        print("Usage: nucleus features <action>")
        print()


def handle_mount_command(args):
    """Handle mount subcommands."""
    brain_path = Path(os.environ.get("NUCLEAR_BRAIN_PATH", ".brain")).resolve()
    if not brain_path.exists():
         # Try to find .brain in current dir or parents
         cwd = Path.cwd()
         if (cwd / ".brain").exists():
             brain_path = cwd / ".brain"
    
    mounts_file = brain_path / "mounts.json"
    
    if args.mount_action == 'add':
        if not mounts_file.exists():
            mounts = {}
        else:
            try:
                mounts = json.loads(mounts_file.read_text())
            except:
                mounts = {}
        
        config = {
            "transport": args.transport,
            "status": "configured" # CLI configure only
        }
        
        if args.transport == 'stdio':
            if not args.command:
                print("❌ Error: --command is required for stdio transport")
                return
            config["command"] = args.command
            config["args"] = args.args or []
            
            env_vars = {}
            if args.env:
                for e in args.env:
                    if '=' in e:
                        k, v = e.split('=', 1)
                        env_vars[k] = v
            if env_vars:
                config["env"] = env_vars
                
        elif args.transport == 'sse':
            if not args.url:
                print("❌ Error: --url is required for sse transport")
                return
            config["url"] = args.url
            
        mounts[args.id] = config
        mounts_file.write_text(json.dumps(mounts, indent=2))
        print(f"✅ Mount '{args.id}' added to configuration.")
        print("   Restart Nucleus to activate.")
        
    elif args.mount_action == 'remove':
        if not mounts_file.exists():
            print("❌ No mounts configured.")
            return
            
        try:
            mounts = json.loads(mounts_file.read_text())
        except:
             print("❌ Failed to parse mounts file.")
             return
             
        if args.id in mounts:
            del mounts[args.id]
            mounts_file.write_text(json.dumps(mounts, indent=2))
            print(f"✅ Mount '{args.id}' removed.")
            print("   Restart Nucleus to apply.")
        else:
            print(f"❌ Mount '{args.id}' not found.")
            
    elif args.mount_action == 'list':
        if not mounts_file.exists():
            print("No mounts configured.")
            return
            
        try:
            mounts = json.loads(mounts_file.read_text())
        except:
             print("❌ Failed to parse mounts file.")
             return
             
        print(f"\n🔌 Configured Mounts ({len(mounts)})")
        print("=" * 60)
        for mid, cfg in mounts.items():
            t = cfg.get("transport")
            details = f"{cfg.get('command')} {' '.join(cfg.get('args', []))}" if t == 'stdio' else cfg.get('url')
            print(f"  • {mid:<15} [{t}] {details}")
        print()
    
    else:
        print("Usage: nucleus mount <add|remove|list>")
        print("Actions:")
        print("  list              List all features")
        print("  list --product=X  Filter by product")
        print("  list --status=X   Filter by status")
        print("  test <id>         Show test instructions")
        print("  search <query>    Search features")
        print("  proof <id>        Show proof document")


def handle_sessions_command(args):
    """Handle sessions subcommands."""
    # Import session functions from main module
    from . import _list_sessions, _save_session, _resume_session
    
    if args.sessions_action == 'list':
        result = _list_sessions()
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        
        sessions = result.get("sessions", [])
        if not sessions:
            print("📋 No saved sessions found.")
            return

        print(f"\n📋 Saved Sessions ({len(sessions)})")
        print("=" * 60)
        for s in sessions:
            print(f"• {s['timestamp']} - {s.get('context', 'Unknown Context')}")
            print(f"  ID: {s['id']}")
            print(f"  Task: {s.get('active_task', 'None')}")
            print("-" * 40)
        print()
            
    elif args.sessions_action == 'save':
        result = _save_session(
            args.context,
            active_task=args.task,
            pending_decisions=[],
            breadcrumbs=[],
            next_steps=[]
        )
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        print(f"✅ Session saved: {result['session_id']}")
        
    elif args.sessions_action == 'resume':
        result = _resume_session(args.id)
        if "error" in result:
            print(f"❌ Error: {result['error']}")
            return
        print("✅ Session resumed")
        print(f"Context: {result.get('context')}")
        print(f"Task: {result.get('active_task')}")


def handle_install_command(args):
    """Handle install command."""
    # Import Installer lazily
    from .runtime.installer import Installer
    
    try:
        nuke_path = Path(args.path)
        if not nuke_path.exists():
            print(f"❌ Error: File not found: {nuke_path}")
            return

        # Initialize installer with environment brain path or default
        brain_path = Path(os.environ.get("NUCLEAR_BRAIN_PATH", ".brain"))
        
        installer = Installer(brain_path)
        print(f"📦 Installing agent from {nuke_path}...")
        
        manifest = installer.install_from_file(nuke_path)
        
        print("\n✅ Installation Complete!")
        print(f"  Agent: {manifest.agent.name} ({manifest.agent.id})")
        print(f"  Version: {manifest.agent.version}")
        
        caps = [c.scope.value for c in manifest.capabilities]
        if caps:
            print(f"  Capabilities: {', '.join(caps)}")
        else:
            print("  Capabilities: None declared")
        
    except Exception as e:
        print(f"\n❌ Installation Failed: {e}")
        # import traceback
        # traceback.print_exc()




def handle_search_command(args):
    """Handle agent search."""
    from pathlib import Path
    # Local imports to avoid circular deps during init
    try:
        from .runtime.team import TeamManager
        from .runtime.registry import RegistryClient
    except ImportError:
        # Fallback if running from source without install
        sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
        from mcp_server_nucleus.runtime.team import TeamManager
        from mcp_server_nucleus.runtime.registry import RegistryClient

    brain_path = Path(os.environ.get("NUCLEAR_BRAIN_PATH", ".brain"))
    
    # 1. Resolve Registry URL
    team_mgr = TeamManager(brain_path)
    registry_url = team_mgr.get_registry_url()
    
    print(f"🔍 Searching registry: {registry_url or 'Default Public'}...")
    
    # 2. Init Client
    if registry_url:
        client = RegistryClient(registry_url=registry_url)
    else:
        client = RegistryClient()
        
    # 3. Search
    try:
        # In a real CLI verify_client logic, we'd want to handle errors if registry is unreachable
        # For Phase 57, we assume success or catch
        client.fetch_index()
        results = client.search(args.query)
        
        if not results:
            print("No agents found.")
            return

        print(f"\nFound {len(results)} agents:")
        print("=" * 60)
        for agent in results:
            print(f"  • {agent.name} ({agent.id})")
            print(f"    v{agent.latest_version} | {agent.description}")
            print(f"    Tags: {', '.join(agent.tags)}")
            print(f"    Repo: {agent.repo_url}")
            print()
            
    except Exception as e:
        print(f"❌ Error during search: {e}")



def handle_consolidate_command(args):
    """Handle consolidate subcommands."""
    # Import the core functions from __init__
    try:
        from . import _archive_resolved_files, _get_archive_path
    except ImportError:
        try:
            from mcp_server_nucleus import _archive_resolved_files, _get_archive_path
        except ImportError:
            print("Error: Could not import consolidation functions. Make sure NUCLEAR_BRAIN_PATH is set.")
            return
    
    if args.consolidate_action == 'archive':
        print("🧹 Archiving resolved backup files...")
        print()
        
        result = _archive_resolved_files()
        
        if not result.get("success"):
            print(f"❌ Error: {result.get('error', 'Unknown error')}")
            return
        
        files_moved = result.get("files_moved", 0)
        archive_path = result.get("archive_path", "")
        
        if files_moved == 0:
            print("✅ No backup files to archive. Brain folder is already clean!")
            return
        
        print(f"✅ Archived {files_moved} files!")
        print(f"   Location: {archive_path}")
        print()
        print("📁 Moved files (sample):")
        for f in result.get("moved_files", [])[:5]:
            print(f"   • {f}")
        if files_moved > 5:
            print(f"   ... and {files_moved - 5} more")
        print()
        print("💡 To recover files, move them back from the archive folder.")
        
    elif args.consolidate_action == 'propose':
        try:
            from . import _generate_merge_proposals
        except ImportError:
            try:
                from mcp_server_nucleus import _generate_merge_proposals
            except ImportError:
                print("Error: Could not import proposal functions.")
                return
        
        print("🔍 Scanning brain for redundant artifacts...")
        print()
        
        result = _generate_merge_proposals()
        
        if not result.get("success"):
            print(f"❌ Error: {result.get('error', 'Unknown error')}")
            return
        
        total = result.get("total_proposals", 0)
        summary = result.get("summary", {})
        
        if total == 0:
            print("✅ Brain is clean! No consolidation proposals found.")
            return
        
        # Print summary table
        print(f"📋 Found {total} consolidation proposals:")
        print()
        print(f"   Versioned Duplicates: {summary.get('versioned_duplicates', 0)}")
        print(f"   Related Series:       {summary.get('related_series', 0)}")
        print(f"   Stale Files (30d):    {summary.get('stale_files', 0)}")
        print(f"   Archive Candidates:   {summary.get('archive_candidates', 0)}")
        print()
        
        # Print full proposal document
        print("─" * 60)
        print(result.get("proposal_text", ""))
        
    elif args.consolidate_action == 'status':
        try:
            archive_path = _get_archive_path()
            resolved_archive = archive_path / "resolved"
            
            if not resolved_archive.exists():
                print("📊 Consolidation Status")
                print()
                print("   Archive: Not yet created")
                print("   Run: nucleus consolidate archive")
                return
            
            # Count files in archive
            archived_count = len(list(resolved_archive.glob("*")))
            
            print("📊 Consolidation Status")
            print()
            print(f"   Archive path: {resolved_archive}")
            print(f"   Archived files: {archived_count}")
            print()
            print("💡 Run 'nucleus consolidate archive' to archive new backup files.")
            
        except Exception as e:
            print(f"❌ Error: {e}")
        
    else:
        # Show consolidate help
        print("Usage: nucleus consolidate <action>")
        print()
        print("Actions:")
        print("  archive    Archive .resolved.* backup files (safe, reversible)")
        print("  status     Show consolidation status and archive info")


def handle_status_command(args):
    """Handle nucleus status command (Satellite View)."""
    from mcp_server_nucleus import (
        _get_satellite_view,
        _format_satellite_cli
    )
    
    # Determine detail level from flags
    if args.minimal:
        detail_level = "minimal"
    elif args.sprint:
        detail_level = "sprint"
    elif args.full:
        detail_level = "full"
    else:
        detail_level = "standard"
    
    try:
        view = _get_satellite_view(detail_level)
        output = _format_satellite_cli(view)
        print(output)
    except Exception as e:
        print(f"❌ Error getting satellite view: {e}")
        print()
        print("Make sure NUCLEAR_BRAIN_PATH is set correctly.")






def handle_schema_command(args):
    """Handle schema export command."""
    import asyncio
    from .runtime.schema_gen import generate_tool_schema, export_schema_to_file
    
    # We need an initialized MCP instance
    try:
        from . import mcp
    except ImportError:
        print("Error: Could not import mcp instance. Ensure you are in the package root.")
        return

    async def run_gen():
        tool_names = await mcp.get_tools()
        print(f"🔍 Generating schema for {len(tool_names)} tools...")
        schema = await generate_tool_schema(mcp)
        export_schema_to_file(schema, args.output)
        print(f"✅ Schema exported to: {args.output}")

    asyncio.run(run_gen())


if __name__ == "__main__":
    main()
