newcode 0.1.1__py3-none-any.whl

code_puppy/plugins/hook_manager/register_callbacks.py

@@ -0,0 +1,205 @@
+"""
+Hook Manager plugin – registers callbacks for interactive hook management.
+
+Provides:
+  /hooks           – Launch interactive TUI menu (shows global + project hooks)
+  /hooks list      – Quick text listing of all configured hooks
+  /hooks enable    – Enable all hooks (both global and project)
+  /hooks disable   – Disable all hooks (both global and project)
+  /hooks status    – Show summary counts per event type
+"""
+import logging
+from typing import Any, List, Optional, Tuple
+
+from code_puppy.callbacks import register_callback
+
+logger = logging.getLogger(__name__)
+
+_COMMAND_NAME = "hooks"
+_ALIASES = ("hook",)
+
+
+# ---------------------------------------------------------------------------
+# /help entry
+# ---------------------------------------------------------------------------
+
+def _hooks_command_help() -> List[Tuple[str, str]]:
+    """Advertise /hooks in the /help menu."""
+    return [
+        ("hooks", "Manage Claude Code hooks (global + project) – browse, enable/disable, inspect"),
+        ("hook", "Alias for /hooks"),
+    ]
+
+
+# ---------------------------------------------------------------------------
+# /hooks command handler
+# ---------------------------------------------------------------------------
+
+def _handle_hooks_command(command: str, name: str) -> Optional[Any]:
+    """Handle /hooks (and /hook) slash commands.
+
+    Sub-commands
+    ------------
+    /hooks           Launch interactive TUI menu (shows both global and project hooks)
+    /hooks list      Print all hooks as text
+    /hooks enable    Enable every hook (both global and project)
+    /hooks disable   Disable every hook (both global and project)
+    /hooks status    Show counts per event type
+    """
+    if name not in (_COMMAND_NAME, *_ALIASES):
+        return None  # Not our command – pass through
+    from code_puppy.messaging import emit_error, emit_info, emit_success, emit_warning
+    from .config import flatten_all_hooks, _load_global_hooks_config, _load_project_hooks_config, save_global_hooks_config, save_hooks_config
+    import copy
+
+    tokens = command.split()
+    subcommand = tokens[1].lower() if len(tokens) > 1 else ""
+
+    # ------------------------------------------------------------------ list
+    if subcommand == "list":
+        entries = flatten_all_hooks()
+        if not entries:
+            emit_info("No hooks configured.")
+            emit_info("Add hooks to .claude/settings.json (project):")
+            emit_info('  { "hooks": { "PreToolUse": [ ... ] } }')
+            emit_info("Or to ~/.code_puppy/hooks.json (global)")
+            return True
+        emit_info(f"\U0001f3a3 Hooks ({len(entries)} total)\n")
+        
+        # Group by source for clarity
+        project_hooks = [e for e in entries if e.source == "project"]
+        global_hooks = [e for e in entries if e.source == "global"]
+        
+        if project_hooks:
+            emit_info("📁 PROJECT HOOKS (.claude/settings.json):")
+            for entry in project_hooks:
+                status = "\U0001f7e2 enabled " if entry.enabled else "\U0001f534 disabled"
+                emit_info(
+                    f"  {status}  [{entry.event_type}]  matcher={entry.display_matcher}"
+                )
+                emit_info(f"      {entry.display_command}")
+                emit_info("")
+        
+        if global_hooks:
+            emit_info("🌍 GLOBAL HOOKS (~/.code_puppy/hooks.json):")
+            for entry in global_hooks:
+                status = "\U0001f7e2 enabled " if entry.enabled else "\U0001f534 disabled"
+                emit_info(
+                    f"  {status}  [{entry.event_type}]  matcher={entry.display_matcher}"
+                )
+                emit_info(f"      {entry.display_command}")
+                emit_info("")
+        
+        return True
+    # --------------------------------------------------------------- enable
+    if subcommand == "enable":
+        count = 0
+        
+        # Enable all project hooks
+        project_config = _load_project_hooks_config()
+        project_cfg = copy.deepcopy(project_config)
+        for groups in project_cfg.values():
+            if not isinstance(groups, list):
+                continue
+            for group in groups:
+                for hook in group.get("hooks", []):
+                    hook["enabled"] = True
+                    count += 1
+        if project_config:
+            save_hooks_config(project_cfg)
+        
+        # Enable all global hooks
+        global_config = _load_global_hooks_config()
+        global_cfg = copy.deepcopy(global_config)
+        for groups in global_cfg.values():
+            if not isinstance(groups, list):
+                continue
+            for group in groups:
+                for hook in group.get("hooks", []):
+                    hook["enabled"] = True
+                    count += 1
+        if global_config:
+            save_global_hooks_config(global_cfg)
+        
+        emit_success(f"\u2705 Enabled {count} hook(s).")
+        return True
+    # -------------------------------------------------------------- disable
+    if subcommand == "disable":
+        count = 0
+        
+        # Disable all project hooks
+        project_config = _load_project_hooks_config()
+        project_cfg = copy.deepcopy(project_config)
+        for groups in project_cfg.values():
+            if not isinstance(groups, list):
+                continue
+            for group in groups:
+                for hook in group.get("hooks", []):
+                    hook["enabled"] = False
+                    count += 1
+        if project_config:
+            save_hooks_config(project_cfg)
+        
+        # Disable all global hooks
+        global_config = _load_global_hooks_config()
+        global_cfg = copy.deepcopy(global_config)
+        for groups in global_cfg.values():
+            if not isinstance(groups, list):
+                continue
+            for group in groups:
+                for hook in group.get("hooks", []):
+                    hook["enabled"] = False
+                    count += 1
+        if global_config:
+            save_global_hooks_config(global_cfg)
+        
+        emit_warning(f"\U0001f534 Disabled {count} hook(s).")
+        return True
+    # --------------------------------------------------------------- status
+    if subcommand == "status":
+        entries = flatten_all_hooks()
+        if not entries:
+            emit_info("No hooks configured.")
+            return True
+        from collections import Counter
+        by_event: Counter = Counter()
+        enabled_by_event: Counter = Counter()
+        by_source: Counter = Counter()
+        
+        for entry in entries:
+            by_event[entry.event_type] += 1
+            by_source[entry.source] += 1
+            if entry.enabled:
+                enabled_by_event[entry.event_type] += 1
+        
+        emit_info(
+            f"\U0001f4ca Hook status  "
+            f"({sum(enabled_by_event.values())}/{len(entries)} enabled)\n"
+        )
+        for event_type, total in sorted(by_event.items()):
+            enabled = enabled_by_event[event_type]
+            bar = "\u2588" * enabled + "\u2591" * (total - enabled)
+            emit_info(f"  {event_type:<20} {bar} {enabled}/{total}")
+        
+        emit_info(f"\nSources: {by_source['project']} project, {by_source['global']} global")
+        emit_info("")
+        return True
+    # ----------------------------------------------- unknown sub-command
+    if subcommand and subcommand not in ("", "tui"):
+        emit_error(f"Unknown sub-command: {subcommand}")
+        emit_info("Usage: /hooks [list|enable|disable|status]")
+        return True
+    # --------------------------------------------------- default: TUI menu
+    from .hooks_menu import show_hooks_menu
+    show_hooks_menu()
+    return True
+
+
+# ---------------------------------------------------------------------------
+# Register callbacks
+# ---------------------------------------------------------------------------
+
+register_callback("custom_command_help", _hooks_command_help)
+register_callback("custom_command", _handle_hooks_command)
+
+logger.info("Hook Manager plugin loaded")

code_puppy/plugins/oauth_puppy_html.py

@@ -0,0 +1,224 @@
+"""Shared HTML templates for OAuth callback pages."""
+
+from __future__ import annotations
+
+from typing import Optional, Tuple
+
+CLAUDE_LOGO_URL = "https://voideditor.com/claude-icon.png"
+CHATGPT_LOGO_URL = (
+    "https://freelogopng.com/images/all_img/1681038325chatgpt-logo-transparent.png"
+)
+GEMINI_LOGO_URL = "https://upload.wikimedia.org/wikipedia/commons/thumb/8/8a/Google_Gemini_logo.svg/512px-Google_Gemini_logo.svg.png"
+
+
+def oauth_success_html(service_name: str, extra_message: Optional[str] = None) -> str:
+    """Return an animated success HTML page for OAuth completion."""
+    clean_service = service_name.strip() or "OAuth"
+    detail = f"<p class='detail'>{extra_message}</p>" if extra_message else ""
+    projectile, rival_url, rival_alt, target_modifier = _service_targets(clean_service)
+    target_classes = "target" if not target_modifier else f"target {target_modifier}"
+    return (
+        "<!DOCTYPE html>"
+        "<html lang='en'><head><meta charset='utf-8'>"
+        "<title>OAuth Success</title>"
+        "<style>"
+        "html,body{margin:0;padding:0;height:100%;overflow:hidden;font-family:'Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;background:linear-gradient(135deg,#0f172a 0%,#111827 45%,#1f2937 100%);color:#e5e7eb;}"
+        "body{display:flex;align-items:center;justify-content:center;}"
+        ".kennel{position:relative;width:90%;max-width:880px;padding:60px;background:rgba(15,23,42,0.72);border-radius:32px;backdrop-filter:blur(14px);box-shadow:0 30px 90px rgba(8,11,18,0.7);text-align:center;border:1px solid rgba(148,163,184,0.25);}"
+        "h1{font-size:3.4em;margin:0;color:#f1f5f9;text-shadow:0 14px 40px rgba(8,11,18,0.55);letter-spacing:1px;}"
+        "p{font-size:1.25em;margin:16px 0;color:#cbd5f5;}"
+        ".detail{font-size:1.1em;opacity:0.9;}"
+        ".mega{display:inline-block;font-size:1.35em;margin-top:14px;color:#f97316;}"
+        ".confetti{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:200%;height:200%;pointer-events:none;mix-blend-mode:screen;}"
+        ".confetti span{position:absolute;font-size:3.4em;animation:floaty 6s ease-in-out infinite;color:#fbbf24;}"
+        "@keyframes floaty{0%,100%{transform:translate3d(0,0,0) rotate(0deg);}35%{transform:translate3d(0,-70px,0) rotate(10deg);}65%{transform:translate3d(0,-90px,0) rotate(-12deg);}90%{transform:translate3d(0,-60px,0) rotate(6deg);}}"
+        ".confetti span:nth-child(odd){animation-duration:7.2s;}"
+        ".confetti span:nth-child(3n){animation-duration:8.6s;}"
+        ".confetti span:nth-child(4n){animation-duration:5.9s;}"
+        ".confetti span:nth-child(5n){animation-duration:9.4s;}"
+        ".artillery{position:absolute;bottom:12%;left:0;width:100%;max-width:1100px;height:240px;pointer-events:none;overflow:visible;}"
+        ".artillery .cannon{position:absolute;bottom:0;font-size:3.4em;color:#f97316;filter:drop-shadow(0 12px 32px rgba(249,115,22,0.45));}"
+        ".artillery .cannon.left{left:4%;}"
+        ".artillery .cannon.right{left:12%;transform:rotate(-4deg);}"
+        ".artillery .shell{position:absolute;left:10%;font-size:2.6em;animation:strafe 2.6s ease-out infinite;color:#facc15;text-shadow:0 0 14px rgba(250,204,21,0.45);}"
+        "@keyframes strafe{0%{left:10%;opacity:1;}60%{left:72%;opacity:1;}100%{left:82%;opacity:0;}}"
+        ".target{position:absolute;top:175px;right:-10%;width:220px;filter:drop-shadow(0 24px 46px rgba(8,11,18,0.72));animation:targetShake 1.9s ease-in-out infinite;}"
+        ".target img{width:200px;height:auto;border-radius:18px;background:#0f172a;padding:16px;border:1px solid rgba(148,163,184,0.35);}"
+        ".target.invert img{filter:brightness(1.2) saturate(1.15);background:rgba(15,23,42,0.9);}"
+        "@keyframes targetShake{0%,100%{transform:rotate(0deg) scale(1);}30%{transform:rotate(-4deg) scale(1.05);}60%{transform:rotate(3deg) scale(0.97);}85%{transform:rotate(-2deg) scale(1.04);}}"
+        ".target::after{content:'';position:absolute;top:50%;left:50%;width:220px;height:220px;border-radius:50%;background:radial-gradient(circle,rgba(248,113,113,0.35)0%,rgba(248,113,113,0)70%);transform:translate(-50%,-50%) scale(0);animation:impact 2.6s ease-out infinite;opacity:0;mix-blend-mode:screen;}"
+        "@keyframes impact{0%,60%{transform:translate(-50%,-50%) scale(0);opacity:0;}70%{transform:translate(-50%,-50%) scale(1.2);opacity:1;}100%{transform:translate(-50%,-50%) scale(1.5);opacity:0;}}"
+        "</style>"
+        "</head><body>"
+        "<div class='kennel'>"
+        "<div class='confetti'>"
+        + "".join(
+            f"<span style='left:{left}%;top:{top}%;animation-delay:{delay}s;'>{emoji}</span>"
+            for left, top, delay, emoji in _SUCCESS_EMOJIS
+        )
+        + "</div>"
+        f"<h1>&#x2705; {clean_service} OAuth Complete</h1>"
+        "<p class='mega'>Authentication token received successfully.</p>"
+        f"{detail}"
+        "<p>This window will close automatically.</p>"
+        f"<div class='{target_classes}'><img src='{rival_url}' alt='{rival_alt}'></div>"
+        "<div class='artillery'>" + _build_artillery(projectile) + "</div>"
+        "</div>"
+        "<script>setTimeout(()=>window.close(),3500);</script>"
+        "</body></html>"
+    )
+
+
+def oauth_failure_html(service_name: str, reason: str) -> str:
+    """Return an error HTML page for OAuth failure."""
+    clean_service = service_name.strip() or "OAuth"
+    clean_reason = reason.strip() or "An unexpected error occurred"
+    projectile, rival_url, rival_alt, target_modifier = _service_targets(clean_service)
+    target_classes = "target" if not target_modifier else f"target {target_modifier}"
+    return (
+        "<!DOCTYPE html>"
+        "<html lang='en'><head><meta charset='utf-8'>"
+        "<title>OAuth Error</title>"
+        "<style>"
+        "html,body{margin:0;padding:0;height:100%;overflow:hidden;font-family:'Inter',-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;background:linear-gradient(160deg,#101827 0%,#0b1120 100%);color:#e2e8f0;}"
+        "body{display:flex;align-items:center;justify-content:center;}"
+        ".kennel{position:relative;width:90%;max-width:780px;padding:55px;background:rgba(10,13,23,0.78);border-radius:30px;box-shadow:0 26px 80px rgba(2,6,23,0.78);text-align:center;border:1px solid rgba(71,85,105,0.35);}"
+        "h1{font-size:3em;margin:0 0 14px;text-shadow:0 16px 36px rgba(15,23,42,0.7);color:#f87171;}"
+        "p{font-size:1.2em;margin:14px 0;line-height:1.6;color:#cbd5f5;}"
+        ".howl{font-size:1.35em;margin:18px 0;color:#fda4af;}"
+        ".tearstorm{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);width:190%;height:190%;pointer-events:none;mix-blend-mode:screen;}"
+        ".tearstorm span{position:absolute;font-size:3.2em;animation:weep 4.8s ease-in-out infinite;color:#60a5fa;}"
+        "@keyframes weep{0%{transform:translate3d(0,-10px,0) rotate(-6deg);opacity:0.85;}35%{transform:translate3d(-20px,18px,0) rotate(8deg);opacity:1;}65%{transform:translate3d(25px,28px,0) rotate(-12deg);opacity:0.8;}100%{transform:translate3d(0,60px,0) rotate(0deg);opacity:0;}}"
+        ".tearstorm span:nth-child(odd){animation-duration:5.8s;}"
+        ".tearstorm span:nth-child(3n){animation-duration:6.4s;}"
+        ".tearstorm span:nth-child(4n){animation-duration:7.3s;}"
+        ".buttons{margin-top:26px;}"
+        ".buttons a{display:inline-block;margin:6px 12px;padding:12px 28px;border-radius:999px;background:rgba(59,130,246,0.16);color:#bfdbfe;text-decoration:none;font-weight:600;border:1px solid rgba(96,165,250,0.4);transition:all 0.3s;}"
+        ".buttons a:hover{background:rgba(96,165,250,0.28);transform:translateY(-2px);}"
+        ".battlefield{position:absolute;bottom:-25px;left:0;width:100%;max-width:960px;height:220px;pointer-events:none;}"
+        ".battlefield .shell{position:absolute;left:10%;font-size:2.4em;color:#38bdf8;text-shadow:0 0 12px rgba(56,189,248,0.45);animation:strafeSad 3s ease-out infinite;}"
+        "@keyframes strafeSad{0%{left:10%;opacity:1;}65%{left:70%;opacity:1;}100%{left:80%;opacity:0;}}"
+        ".battlefield .target{position:absolute;top:16px;right:6%;width:220px;filter:drop-shadow(0 20px 44px rgba(2,6,23,0.78));animation:sway 2s ease-in-out infinite;}"
+        ".battlefield .target img{width:200px;height:auto;border-radius:18px;background:#0b1120;padding:16px;border:1px solid rgba(96,165,250,0.4);}"
+        ".battlefield .target.invert img{filter:brightness(1.2) saturate(1.15);background:rgba(15,23,42,0.9);}"
+        "@keyframes sway{0%,100%{transform:rotate(0deg);}40%{transform:rotate(-6deg);}70%{transform:rotate(5deg);}}"
+        "</style>"
+        "</head><body>"
+        "<div class='kennel'>"
+        "<div class='tearstorm'>"
+        + "".join(
+            f"<span style='left:{left}%;top:{top}%;animation-delay:{delay}s;'>{emoji}</span>"
+            for left, top, delay, emoji in _FAILURE_EMOJIS
+        )
+        + "</div>"
+        f"<h1>&#x274C; {clean_service} OAuth Failed</h1>"
+        "<p class='howl'>Authentication could not be completed.</p>"
+        f"<p>{clean_reason}</p>"
+        "<p>Please try again from the application.</p>"
+        "<div class='buttons'>"
+        "<a href='https://github.com/janfeddersen-wq/new_code' target='_blank'>Documentation</a>"
+        "</div>"
+        "<div class='battlefield'>"
+        + _build_artillery(projectile, shells_only=True)
+        + f"<div class='{target_classes}'><img src='{rival_url}' alt='{rival_alt}'></div>"
+        + "</div>"
+        "</div>"
+        "</body></html>"
+    )
+
+
+_SUCCESS_EMOJIS = (
+    (5, 12, 0.0, "&#x2728;"),
+    (18, 28, 0.2, "&#x2705;"),
+    (32, 6, 1.1, "&#x1F389;"),
+    (46, 18, 0.5, "&#x2728;"),
+    (62, 9, 0.8, "&#x1F4AB;"),
+    (76, 22, 1.3, "&#x2705;"),
+    (88, 14, 0.4, "&#x2728;"),
+    (12, 48, 0.6, "&#x1F389;"),
+    (28, 58, 1.7, "&#x1F4AB;"),
+    (44, 42, 0.9, "&#x2728;"),
+    (58, 52, 1.5, "&#x2705;"),
+    (72, 46, 0.3, "&#x1F389;"),
+    (86, 54, 1.1, "&#x1F4AB;"),
+    (8, 72, 0.7, "&#x2728;"),
+    (24, 80, 1.2, "&#x1F389;"),
+    (40, 74, 0.2, "&#x2705;"),
+    (56, 66, 1.6, "&#x2728;"),
+    (70, 78, 1.0, "&#x1F4AB;"),
+    (84, 70, 1.4, "&#x2705;"),
+    (16, 90, 0.5, "&#x2728;"),
+    (32, 92, 1.9, "&#x1F4AB;"),
+    (48, 88, 1.1, "&#x1F389;"),
+    (64, 94, 1.8, "&#x2728;"),
+    (78, 88, 0.6, "&#x2705;"),
+    (90, 82, 1.3, "&#x1F4AB;"),
+)
+
+
+_FAILURE_EMOJIS = (
+    (8, 6, 0.0, "&#x26A0;"),
+    (22, 18, 0.3, "&#x274C;"),
+    (36, 10, 0.6, "&#x26A0;"),
+    (50, 20, 0.9, "&#x274C;"),
+    (64, 8, 1.2, "&#x26A0;"),
+    (78, 16, 1.5, "&#x274C;"),
+    (12, 38, 0.4, "&#x26A0;"),
+    (28, 44, 0.7, "&#x274C;"),
+    (42, 34, 1.0, "&#x26A0;"),
+    (58, 46, 1.3, "&#x274C;"),
+    (72, 36, 1.6, "&#x26A0;"),
+    (86, 40, 1.9, "&#x274C;"),
+    (16, 64, 0.5, "&#x26A0;"),
+    (32, 70, 0.8, "&#x274C;"),
+    (48, 60, 1.1, "&#x26A0;"),
+    (62, 74, 1.4, "&#x274C;"),
+    (78, 68, 1.7, "&#x26A0;"),
+    (90, 72, 2.0, "&#x274C;"),
+    (20, 88, 0.6, "&#x26A0;"),
+    (36, 92, 0.9, "&#x274C;"),
+    (52, 86, 1.2, "&#x26A0;"),
+    (68, 94, 1.5, "&#x274C;"),
+    (82, 90, 1.8, "&#x26A0;"),
+)
+
+
+_STRAFE_SHELLS: Tuple[Tuple[float, float], ...] = (
+    (22.0, 0.0),
+    (28.0, 0.35),
+    (34.0, 0.7),
+    (26.0, 0.2),
+    (32.0, 0.55),
+    (24.0, 0.9),
+    (30.0, 1.25),
+)
+
+
+def _build_artillery(projectile: str, *, shells_only: bool = False) -> str:
+    """Return HTML spans for animated shells (and cannons when desired)."""
+    shell_markup = []
+    for index, (top, delay) in enumerate(_STRAFE_SHELLS):
+        duration = 2.3 + (index % 3) * 0.25
+        shell_markup.append(
+            f"<span class='shell' style='top:{top}%;animation-delay:-{delay}s;animation-duration:{duration}s;'>{projectile}</span>"
+        )
+    shells = "".join(shell_markup)
+    if shells_only:
+        return shells
+
+    cannons = (
+        "<span class='cannon left'>&#x1F680;</span><span class='cannon right'>&#x26A1;</span>"
+    )
+    return cannons + shells
+
+
+def _service_targets(service_name: str) -> Tuple[str, str, str, str]:
+    """Map service names to projectile emoji and rival logo metadata."""
+    normalized = service_name.lower()
+    if "anthropic" in normalized or "claude" in normalized:
+        return "&#x26A1;", CLAUDE_LOGO_URL, "Claude logo", ""
+    if "chat" in normalized or "gpt" in normalized:
+        return "&#x1F680;", CHATGPT_LOGO_URL, "ChatGPT logo", "invert"
+    if "gemini" in normalized or "google" in normalized:
+        return "&#x2728;", GEMINI_LOGO_URL, "Gemini logo", ""
+    return "&#x1F4AB;", CHATGPT_LOGO_URL, "mystery logo", "invert"

code_puppy/plugins/scheduler/__init__.py

@@ -0,0 +1 @@
+"""Scheduler plugin - manages scheduled tasks via /scheduler command."""

code_puppy/plugins/scheduler/register_callbacks.py

@@ -0,0 +1,88 @@
+"""Scheduler plugin callbacks.
+
+Registers the /scheduler command (and aliases /sched, /cron) via the
+custom_command and custom_command_help callback hooks, keeping all
+scheduler UI out of the core application.
+"""
+
+from typing import Any, List, Optional, Tuple
+
+from code_puppy.callbacks import register_callback
+from code_puppy.messaging import emit_error, emit_info
+
+_COMMAND_NAME = "scheduler"
+_ALIASES = ("sched", "cron")
+_DESCRIPTION = "Manage scheduled tasks – create, run, and monitor automated prompts"
+
+
+def _scheduler_help() -> List[Tuple[str, str]]:
+    """Return help entries for the scheduler commands."""
+    return [
+        (
+            "scheduler",
+            "Manage scheduled tasks – launch TUI or use sub-commands",
+        ),
+        ("sched", "Alias for /scheduler"),
+        ("cron", "Alias for /scheduler"),
+    ]
+
+
+def _handle_scheduler_command(command: str, name: str) -> Optional[Any]:
+    """Handle /scheduler, /sched, and /cron slash commands.
+
+    Sub-commands:
+        /scheduler         – Launch interactive TUI menu
+        /scheduler start   – Start the scheduler daemon
+        /scheduler stop    – Stop the scheduler daemon
+        /scheduler status  – Show daemon status
+        /scheduler list    – List all tasks
+        /scheduler run <id>– Run a task immediately
+    """
+    if name not in (_COMMAND_NAME, *_ALIASES):
+        return None
+
+    from code_puppy.plugins.scheduler.scheduler_menu import show_scheduler_menu
+    from code_puppy.scheduler.cli import (
+        handle_scheduler_list,
+        handle_scheduler_run,
+        handle_scheduler_start,
+        handle_scheduler_status,
+        handle_scheduler_stop,
+    )
+
+    tokens = command.split()
+
+    # Handle sub-commands
+    if len(tokens) > 1:
+        subcommand = tokens[1].lower()
+
+        if subcommand == "start":
+            handle_scheduler_start()
+            return True
+        elif subcommand == "stop":
+            handle_scheduler_stop()
+            return True
+        elif subcommand == "status":
+            handle_scheduler_status()
+            return True
+        elif subcommand == "list":
+            handle_scheduler_list()
+            return True
+        elif subcommand == "run":
+            if len(tokens) < 3:
+                emit_error("Usage: /scheduler run <task_id>")
+                return True
+            handle_scheduler_run(tokens[2])
+            return True
+        else:
+            emit_error(f"Unknown subcommand: {subcommand}")
+            emit_info("Usage: /scheduler [start|stop|status|list|run <id>]")
+            return True
+
+    # No subcommand – launch TUI menu
+    show_scheduler_menu()
+    return True
+
+
+register_callback("custom_command_help", _scheduler_help)
+register_callback("custom_command", _handle_scheduler_command)