9router-manager 0.0.1

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "9router-manager",
+  "version": "0.0.1",
+  "description": "9Router AI Gateway Local - Combo Model Scanner (Node.js)",
+  "license": "MIT",
+  "author": "ARIS",
+  "type": "module",
+  "bin": {
+    "9router-manager": "bin/9router-manager.js"
+  },
+  "main": "./src/cli.js",
+  "files": [
+    "bin",
+    "src",
+    "bat",
+    "sh",
+    "metadata.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "start": "node src/cli.js",
+    "test": "node --test tests/*.test.js",
+    "env:test": "node --test tests/env.test.js",
+    "cli:test": "node --test tests/cli.test.js",
+    "paths:test": "node --test tests/paths.test.js",
+    "metadata:test": "node --test tests/metadata.test.js",
+    "combo:test": "node --test tests/combo.test.js",
+    "scan:test": "node --test tests/scan.test.js",
+    "results:test": "node --test tests/results.test.js",
+    "audit-shape:test": "node --test tests/audit-shape.test.js",
+    "password:test": "node --test tests/password.test.js",
+    "lint": "node --check src/*.js bin/*.js tests/*.test.js",
+    "scan": "node src/cli.js scan",
+    "results": "node src/cli.js results",
+    "list": "node src/cli.js list",
+    "version": "node src/cli.js version",
+    "help": "node src/cli.js help",
+    "prepublishOnly": "npm run lint && npm test"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.0.0",
+    "cli-progress": "^3.12.0",
+    "commander": "^12.0.0",
+    "dotenv": "^16.4.5"
+  },
+  "keywords": [
+    "9router",
+    "ai-gateway",
+    "model-scanner",
+    "cli",
+    "nodejs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arssnndr/9router-manager.git"
+  },
+  "homepage": "https://github.com/arssnndr/9router-manager",
+  "bugs": {
+    "url": "https://github.com/arssnndr/9router-manager/issues"
+  }
+}

package/sh/check-results.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# 9Router - Check Last Scan Results - Cross-platform launcher
+# Usage: ./check-results.sh
+# Or: 9router-manager results (after installation)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# Try CLI first if installed
+if command -v 9router-manager &> /dev/null; then
+    9router-manager results
+    exit $?
+fi
+
+# Fallback: direct Python execution
+# Load .env if exists
+ENV_FILE="$SCRIPT_DIR/.env"
+if [[ -f "$ENV_FILE" ]]; then
+    set -a
+    source "$ENV_FILE"
+    set +a
+fi
+
+# Default audit path for Linux/macOS
+AUDIT_PATH="${NINEROUTER_AUDIT_PATH:-$HOME/.local/share/hermes/scripts/9router_daily_combo_model_scan_last.json}"
+
+# Expand ~ if present
+AUDIT_PATH="${AUDIT_PATH/#\~/$HOME}"
+
+if [[ ! -f "$AUDIT_PATH" ]]; then
+    echo "ERROR: Audit log not found:"
+    echo "  $AUDIT_PATH"
+    echo ""
+    echo "Run scan first:"
+    echo "  9router-manager scan"
+    echo "  or: ./run-scan.sh"
+    echo ""
+    exit 1
+fi
+
+# Detect Python
+PYTHON_CMD=""
+if command -v python3 &> /dev/null; then
+    PYTHON_CMD="python3"
+elif command -v python &> /dev/null; then
+    PYTHON_CMD="python"
+else
+    echo "ERROR: Python not found!"
+    exit 1
+fi
+
+"$PYTHON_CMD" "$SCRIPT_DIR/check_results.py"

package/sh/run-scan.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+# 9Router Model Scanner - Cross-platform launcher
+# Usage: ./run-scan.sh
+# Or: 9router-manager scan (after installation)
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# Try CLI first if installed
+if command -v 9router-manager &> /dev/null; then
+    9router-manager scan
+    exit $?
+fi
+
+# Fallback: direct Python execution
+# Load .env if exists
+ENV_FILE="$SCRIPT_DIR/.env"
+if [[ -f "$ENV_FILE" ]]; then
+    echo "Loading config from .env..."
+    set -a
+    source "$ENV_FILE"
+    set +a
+fi
+
+# Check password
+if [[ -z "$NINEROUTER_PASSWORD" ]]; then
+    echo "ERROR: NINEROUTER_PASSWORD is not set!"
+    echo ""
+    echo "Setup instructions:"
+    echo "  1. cp .env.template .env"
+    echo "  2. Edit .env, set NINEROUTER_PASSWORD"
+    echo ""
+    exit 1
+fi
+
+# Detect Python
+PYTHON_CMD=""
+if command -v python3 &> /dev/null; then
+    PYTHON_CMD="python3"
+elif command -v python &> /dev/null; then
+    PYTHON_CMD="python"
+else
+    echo "ERROR: Python not found!"
+    echo "Please install Python or set PYTHON_EXE in .env"
+    exit 1
+fi
+
+echo ""
+echo "Running combo scan..."
+echo ""
+
+"$PYTHON_CMD" "$SCRIPT_DIR/scan.py"
+
+echo ""
+echo "Scan completed."

package/sh/setup-scheduler-macos.sh

@@ -0,0 +1,109 @@
+#!/bin/bash
+# 9Router - Setup Auto-Scan on macOS (launchd)
+# Usage: ./setup-scheduler-macos.sh
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+echo "============================================"
+echo " 9Router - Auto-Scan Setup (macOS/launchd)"
+echo "============================================"
+echo ""
+
+# Check if running on macOS
+if [[ "$(uname)" != "Darwin" ]]; then
+    echo "WARNING: This script is designed for macOS."
+    echo "For Linux, use setup-scheduler.sh instead."
+    echo ""
+fi
+
+# Load .env
+ENV_FILE="$SCRIPT_DIR/.env"
+if [[ -f "$ENV_FILE" ]]; then
+    echo "Loading config from .env..."
+    set -a
+    source "$ENV_FILE"
+    set +a
+fi
+
+# Check password
+if [[ -z "$NINEROUTER_PASSWORD" ]]; then
+    echo "ERROR: NINEROUTER_PASSWORD is not set!"
+    echo "Please edit .env and set NINEROUTER_PASSWORD"
+    exit 1
+fi
+
+# Detect Python
+PYTHON_CMD=""
+if command -v python3 &> /dev/null; then
+    PYTHON_CMD="python3"
+elif command -v python &> /dev/null; then
+    PYTHON_CMD="python"
+else
+    echo "ERROR: Python not found!"
+    exit 1
+fi
+
+PYTHON_PATH=$(which "$PYTHON_CMD")
+echo "Python: $PYTHON_PATH"
+
+SCRIPT_ABS=$(realpath "$SCRIPT_DIR/scan.py")
+PLIST_LABEL="com.9router.daily-scan"
+LAUNCHD_DIR="$HOME/Library/LaunchAgents"
+PLIST_FILE="$LAUNCHD_DIR/$PLIST_LABEL.plist"
+
+echo ""
+echo "=== launchd Setup ==="
+echo "This will create a launchd agent to run scan at login."
+echo ""
+
+# Create LaunchAgents directory
+mkdir -p "$LAUNCHD_DIR"
+
+# Create the launchd plist
+cat > "$PLIST_FILE" << PLISTEOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>$PLIST_LABEL</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>$SCRIPT_DIR/run-scan.sh</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StartInterval</key>
+    <integer>86400</integer>
+    <key>StandardOutPath</key>
+    <string>$HOME/Library/Logs/9router-scan.log</string>
+    <key>StandardErrorPath</key>
+    <string>$HOME/Library/Logs/9router-scan.error.log</string>
+</dict>
+</plist>
+PLISTEOF
+
+echo "Created: $PLIST_FILE"
+echo ""
+
+# Load the service
+echo "Loading launchd service..."
+launchctl load "$PLIST_FILE" 2>/dev/null || echo "Note: launchctl may require elevated permissions"
+
+echo "SUCCESS - launchd agent created!"
+echo ""
+echo "To check status:"
+echo "  launchctl list | grep 9router"
+echo ""
+echo "To view logs:"
+echo "  tail -f ~/Library/Logs/9router-scan.log"
+echo ""
+echo "To unload (stop):"
+echo "  launchctl unload $PLIST_FILE"
+echo ""
+echo "To remove completely:"
+echo "  launchctl unload $PLIST_FILE && rm $PLIST_FILE"

package/sh/setup-scheduler.sh

@@ -0,0 +1,114 @@
+#!/bin/bash
+# 9Router - Setup Auto-Scan on Linux (Cron)
+# Usage: ./setup-scheduler.sh
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_ROOT"
+
+echo "============================================"
+echo " 9Router - Auto-Scan Setup (Linux/Cron)"
+echo "============================================"
+echo ""
+
+# Load .env
+ENV_FILE="$PROJECT_ROOT/.env"
+if [[ -f "$ENV_FILE" ]]; then
+    echo "Loading config from .env..."
+    set -a
+    source "$ENV_FILE"
+    set +a
+fi
+
+# Check password
+if [[ -z "$NINEROUTER_PASSWORD" ]]; then
+    echo "ERROR: NINEROUTER_PASSWORD is not set!"
+    echo "Please edit .env and set NINEROUTER_PASSWORD"
+    exit 1
+fi
+
+# Detect Python
+PYTHON_CMD=""
+if command -v python3 &> /dev/null; then
+    PYTHON_CMD="python3"
+elif command -v python &> /dev/null; then
+    PYTHON_CMD="python"
+else
+    echo "ERROR: Python not found!"
+    echo "Please install Python or set PYTHON_EXE in .env"
+    exit 1
+fi
+
+PYTHON_PATH=$(which "$PYTHON_CMD")
+echo "Python: $PYTHON_PATH"
+echo "Project root: $PROJECT_ROOT"
+echo ""
+
+# Use run-scan.sh as the cron entry point (handles .env loading internally)
+RUNNER_SCRIPT="$SCRIPT_DIR/run-scan.sh"
+if [[ ! -x "$RUNNER_SCRIPT" ]]; then
+    chmod +x "$RUNNER_SCRIPT"
+fi
+
+echo "=== Cron Setup ==="
+echo "This will create a cron job to run scan via run-scan.sh."
+echo ""
+echo "Schedule options:"
+echo "  1. At login/reboot (recommended)"
+echo "  2. Daily at specific time"
+echo "  3. Hourly"
+echo ""
+read -p "Choose option (1-3) [1]: " SCHEDULE_CHOICE
+SCHEDULE_CHOICE="${SCHEDULE_CHOICE:-1}"
+
+case "$SCHEDULE_CHOICE" in
+    1)
+        # @reboot + delay to let services come up
+        CRON_CMD="@reboot sleep 300 && $RUNNER_SCRIPT"
+        CRON_DESC="Run once at system startup (5 min delay)"
+        ;;
+    2)
+        read -p "Enter time (HH:MM) [09:00]: " TIME_INPUT
+        TIME_INPUT="${TIME_INPUT:-09:00}"
+        HOUR="${TIME_INPUT%%:*}"
+        MINUTE="${TIME_INPUT##*:}"
+        CRON_CMD="$MINUTE $HOUR * * * $RUNNER_SCRIPT"
+        CRON_DESC="Run daily at $TIME_INPUT"
+        ;;
+    3)
+        CRON_CMD="0 * * * * $RUNNER_SCRIPT"
+        CRON_DESC="Run every hour"
+        ;;
+    *)
+        echo "Invalid option. Using default (login/reboot)..."
+        CRON_CMD="@reboot sleep 300 && $RUNNER_SCRIPT"
+        CRON_DESC="Run once at system startup (5 min delay)"
+        ;;
+esac
+
+echo ""
+echo "Schedule: $CRON_DESC"
+echo "Command:  $CRON_CMD"
+echo ""
+
+# Add to crontab (idempotent: remove existing 9router entry first)
+EXISTING=$(crontab -l 2>/dev/null | grep -F "run-scan.sh" | grep -F "9router" || true)
+if [[ -n "$EXISTING" ]]; then
+    echo "Removing existing 9router cron entry..."
+    (crontab -l 2>/dev/null | grep -v -F "run-scan.sh" | grep -v -F "9router_daily_combo_model_scan") | crontab -
+fi
+
+(crontab -l 2>/dev/null; echo "$CRON_CMD") | crontab -
+
+echo "SUCCESS - Cron job created!"
+echo ""
+echo "To view cron jobs:"
+echo "  crontab -l"
+echo ""
+echo "To remove:"
+echo "  crontab -e  # then delete the run-scan.sh line"
+echo ""
+echo "To view logs:"
+echo "  tail -f ~/.local/share/9router/audit/*.log 2>/dev/null || echo 'No logs yet'"