9router-manager 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ARIS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,327 @@
+# 9Router Manager
+
+Manajemen 9Router AI gateway lokal — scan model, update combo, monitor provider.
+
+**Cross-platform**: Windows, Linux, macOS supported.
+
+**Tests: 88/88 pass · Node ≥18**
+
+## Fitur
+
+- ✅ Scan semua model dari provider aktif
+- ✅ Concurrent testing (configurable, default 1 worker — raise NINEROUTER_MAX_WORKERS env var untuk scan paralel)
+- ✅ Auto-retry pada HTTP 429 (rate limit)
+- ✅ Progress bar real-time
+- ✅ Audit log untuk tracking perubahan (verify_token disanitasi, ditulis async)
+- ✅ Setup auto-scan via scheduler interaktif (confirm + auto-exec, atau print-only mode)
+
+## Struktur
+
+```
+9router-manager/
+├── bin/
+│   └── 9router-manager.js  # Executable shim
+├── src/
+│   ├── cli.js              # CLI entry + commander setup
+│   ├── env.js              # .env loader + path/token helpers
+│   ├── scan.js             # API + concurrent scan logic
+│   ├── combo.js            # SQLite combo management
+│   ├── metadata.js         # Model pattern matching + sort keys
+│   └── results.js          # Read & print audit JSON
+├── tests/
+│   ├── audit-shape.test.js
+│   ├── cli.test.js
+│   ├── combo.test.js
+│   ├── env.test.js
+│   ├── metadata.test.js
+│   ├── paths.test.js
+│   ├── results.test.js
+│   └── scan.test.js
+├── bat/                    # Windows batch scripts
+│   ├── run-scan.bat
+│   ├── check-results.bat
+│   └── setup-scheduler.bat
+├── sh/                     # Unix shell scripts
+│   ├── run-scan.sh
+│   ├── check-results.sh
+│   ├── setup-scheduler.sh
+│   └── setup-scheduler-macos.sh
+├── metadata.json           # Model patterns + release dates
+├── package.json            # Node.js package config
+├── .env                    # Konfigurasi lokal (password, path)
+└── .env.template           # Template dokumentasi
+```
+
+## Setup
+
+### 1. Konfigurasi
+
+Gunakan perintah bawaan CLI untuk mengatur konfigurasi global (disimpan di `~/.9router/.env`):
+
+```bash
+9router-manager config
+```
+
+Aplikasi akan meminta Anda untuk memasukkan:
+- `NINEROUTER_PASSWORD` (password dashboard 9Router)
+- `NINEROUTER_BASE_URL` (biarkan default jika menggunakan `localhost:20128`)
+
+*(Jika Anda ingin konfigurasi per-folder, Anda masih bisa meng-copy `.env.template` ke `.env` di folder tersebut).*
+
+### 2. Setup Auto-Scan (Opsional)
+
+**Cara cepat (via CLI):**
+```bash
+9router-manager setup       # Tanyakan konfirmasi, lalu jalankan script
+9router-manager setup -y    # Skip konfirmasi (untuk script/CI)
+```
+
+**Cara manual (langsung ke script):**
+```bash
+# Windows (as Administrator)
+bat\setup-scheduler.bat
+
+# Linux (cron)
+./sh/setup-scheduler.sh
+
+# macOS (launchd)
+./sh/setup-scheduler-macos.sh
+```
+
+## Usage
+
+### CLI (Recommended)
+
+After installation, simply type:
+```bash
+9router-manager
+```
+
+Akan muncul menu interaktif:
+```
+╔═══════════════════════════════════════════════════╗
+║           9Router Manager v0.0.1                     ║
+╠═══════════════════════════════════════════════════╣
+║  AI Gateway Local - Model Scanner                 ║
+╚═══════════════════════════════════════════════════╝
+
+  [1] Run Model Scan
+  [2] List Combos
+  [3] Show Last Scan Results
+  [4] Test Single Model
+  [5] Setup Auto-Scan Scheduler
+  [6] Configure Settings
+  ────────────────────────────────────────────────────────────
+  [v] Version Info    [h] Show Help    [q] Quit
+
+  Pilihan (nomor/v/h/q):
+```
+
+Atau gunakan command line mode:
+```bash
+9router-manager scan                              # Run scan
+9router-manager list                              # List combos
+9router-manager list --details                    # List combos + models in each
+9router-manager results                           # Check results
+9router-manager test <model>                      # Test single model
+9router-manager setup                             # Setup scheduler (interaktif)
+9router-manager setup -y                          # Setup scheduler (skip prompt)
+9router-manager config                            # Configure global settings (interaktif)
+9router-manager version                           # Version info
+9router-manager help                              # Show help
+```
+
+### Installation
+
+Install globally via npm (recommended for development):
+
+```bash
+npm link
+```
+
+Setelah itu perintah `9router-manager` bisa dipanggil dari direktori manapun (entry-point dari `package.json`).
+
+### Shell Scripts (Fallback)
+
+Jika CLI belum diinstall, bisa pakai shell scripts:
+
+**Linux/macOS:**
+```bash
+./sh/run-scan.sh
+./sh/check-results.sh
+./sh/setup-scheduler.sh
+```
+
+**Windows:**
+```bash
+bat\run-scan.bat
+bat\check-results.bat
+bat\setup-scheduler.bat
+```
+
+### Direct Node
+
+```bash
+node src/cli.js scan
+node src/cli.js results
+node src/cli.js test minimax/MiniMax-M2.7
+```
+
+### Commit
+
+```bash
+git add .
+git commit -m "feat: add new feature"
+```
+
+Format: `type: short description`
+
+## Konfigurasi
+
+| Variable | Default | Deskripsi |
+|----------|---------|-----------|
+| `NINEROUTER_PASSWORD` | (required) | Password dashboard 9Router |
+| `NINEROUTER_BASE_URL` | `http://localhost:20128` | URL 9Router gateway |
+| `NINEROUTER_DB_PATH` | OS-specific | Path SQLite DB |
+| `NINEROUTER_AUDIT_PATH` | OS-specific | Audit log output |
+| `NINEROUTER_TIMEOUT` | `8` | Timeout per model (detik) |
+| `NINEROUTER_MAX_WORKERS` | `1` | Concurrent workers |
+| `NINEROUTER_RETRY_429_MAX` | `2` | Max retry pada rate limit |
+| `NINEROUTER_RETRY_429_DELAY` | `3.0` | Delay antar retry (detik) |
+| `NINEROUTER_SLEEP` | `0.05` | Delay antar test (detik) |
+| `NINEROUTER_PROMPT` | `1+1=?` | Prompt dikirim ke setiap model |
+| `NINEROUTER_ENV_FILE` | (unset) | Override default .env search path |
+
+## Managed Combo
+
+Target combo **tidak dikonfigurasi** — scanner mendeteksinya otomatis dari `/v1/models` × tabel `combos` SQLite.
+
+- 0 combo cocok: scanner berhenti dengan error.
+- Tepat 1 combo cocok: combo itu yang di-update.
+- Lebih dari 1 cocok: scanner berhenti dengan error (target ambigu).
+
+Managed combo berisi semua model dari semua provider yang berhasil response saat di-test.
+
+- Menambah model baru yang mulai response
+- Menghapus model yang tidak lagi response (timeout, 400, 402, 404, 429, error)
+- Skip provider yang statusnya `active=false` di SQLite 9Router
+
+## Commit Types
+
+| Type | Usage |
+|------|-------|
+| `feat` | Fitur baru |
+| `fix` | Bug fix |
+| `docs` | Dokumentasi |
+| `style` | Formatting, typo |
+| `refactor` | Refactoring |
+| `perf` | Performa |
+| `test` | Unit test |
+| `build` | Build system |
+| `ci` | CI/CD |
+| `chore` | Config, dependency |
+| `revert` | Revert commit |
+
+## Quick Start
+
+```bash
+# 1. Install dependencies
+npm install
+
+# 2. Setup configuration
+node src/cli.js config
+# (You will be prompted to enter your 9Router password)
+
+# 3. Run scan
+npm run scan
+# atau
+node src/cli.js scan
+
+# 4. Check results
+npm run results
+# atau
+node src/cli.js results
+
+# 5. Run tests
+npm test
+```
+
+## Sub-commands
+
+- `scan` — Run daily combo model scan
+- `list` — List combos in database (use `--details` to show models)
+- `results` / `check` / `status` — Show last scan results
+- `test <model>` — Test a single model
+- `setup` — Setup auto-scan scheduler (interactive; `-y` to skip prompt)
+- `config` — Configure global settings (interactive)
+- `version` — Show version info
+- `help` — Show help
+
+## Per-Phase Test Scripts
+
+```bash
+npm run env:test         # 8 tests
+npm run cli:test         # 6 tests
+npm run paths:test       # 14 tests
+npm run metadata:test    # 22 tests
+npm run combo:test       # 9 tests
+npm run scan:test        # 16 tests
+npm run results:test     # 8 tests
+npm run audit-shape:test # 10 tests
+npm test                 # 88 tests total
+```
+
+## Key Files
+
+| File | Platform | Description |
+|------|----------|-------------|
+| `bin/9router-manager.js` | All | Executable shim (`#!/usr/bin/env node`) |
+| `src/cli.js` | All | CLI entry + commander setup + interactive menu |
+| `src/scan.js` | All | API + concurrent scan logic |
+| `src/combo.js` | All | SQLite combo management (async) |
+| `src/env.js` | All | .env loader + path helpers |
+| `src/metadata.js` | All | Model pattern matching + sort keys |
+| `src/results.js` | All | Audit JSON reader/summarizer |
+| `package.json` | All | Node.js package config |
+| `sh/run-scan.sh` | Linux/macOS | Run scan (fallback) |
+| `sh/check-results.sh` | Linux/macOS | Check results (fallback) |
+| `bat/run-scan.bat` | Windows | Run scan (fallback) |
+
+## OS-Specific Paths
+
+Default paths untuk setiap OS (jika `NINEROUTER_DB_PATH` / `NINEROUTER_AUDIT_PATH` tidak diset):
+
+| OS | DB Path | Audit Path |
+|----|---------|------------|
+| Windows | `~/AppData/Roaming/9router/db/data.sqlite` | `%USERPROFILE%\AppData\Local\hermes\scripts\9router_daily_combo_model_scan_last.json` |
+| Linux | `~/.9router/db/data.sqlite` (fallback: `~/.config/9router/`, `~/.local/share/9router/`, `snap`) | `~/.local/share/9router/audit/9router_daily_combo_model_scan_last.json` |
+| macOS | `~/.9router/db/data.sqlite` (fallback: `~/.config/9router/`, `~/.local/share/9router/`) | `~/Library/Logs/9router-scan.log` |
+
+## Project Status
+
+- [x] All rewrite phases complete
+- [x] 88/88 tests pass (`npm test`)
+- [x] `npm run lint` passes
+- [x] No `AIO` references in the tree
+- [x] Combo-agnostic audit file paths
+- [x] Async audit write + sanitized verify_token
+- [x] Multi-platform CI (Linux, macOS, Windows × Node 18/20/22)
+- [x] `node bin/9router-manager.js` works end-to-end
+- [x] Interactive menu with letter shortcuts (q/h/v)
+- [x] `setup` command with confirm + auto-exec + non-TTY fallback
+
+## Open Questions
+
+- **TypeScript?** Plain JS for now. Can be added later via `tsc --check` without a full rewrite.
+- **Cookie store?** In-memory `Map` (single-session scan). Browser-equivalent `tough-cookie` is overkill for a one-shot CLI run.
+- **Concurrency model?** Promise-based fan-out (capped by `NINEROUTER_MAX_WORKERS`). Watch SQLite write contention at the end of long runs.
+- **Schema for `metadata.json`?** Ported as-is. Normalize later if it pays off.
+
+## Commit
+
+```bash
+git add .
+git commit -m "feat: add new feature"
+```
+
+Format: `type: short description`

package/bat/check-results.bat

@@ -0,0 +1,60 @@
+@echo off
+setlocal EnableDelayedExpansion
+
+title 9Router Scan - Cek Hasil
+
+echo ============================================
+echo  Cek Hasil Scan
+echo ============================================
+echo.
+
+REM Load .env from project root if exists
+set "SCRIPT_DIR=%~dp0.."
+for %%i in ("%SCRIPT_DIR%") do set "SCRIPT_DIR=%%~fi"
+set "ENV_FILE=%SCRIPT_DIR%\.env"
+if exist "%ENV_FILE%" (
+    for /f "usebackq tokens=1,* delims==" %%a in ("%ENV_FILE%") do (
+        set "%%a=%%b"
+    )
+)
+
+REM Resolve audit path dari environment atau use default
+if defined NINEROUTER_AUDIT_PATH (
+    set "AUDIT_PATH=%NINEROUTER_AUDIT_PATH%"
+) else (
+    set "AUDIT_PATH=%USERPROFILE%\AppData\Local\hermes\scripts\9router_daily_combo_model_scan_last.json"
+)
+
+REM Expand ~ to userprofile if present
+set "FIRST_CHAR=!AUDIT_PATH:~0,1!"
+if "!FIRST_CHAR!"=="~" (
+    set "AUDIT_PATH=%USERPROFILE%!AUDIT_PATH:~1!"
+)
+
+REM Check file exists
+if not exist "%AUDIT_PATH%" (
+    echo ERROR: Audit log tidak ditemukan:
+    echo   %AUDIT_PATH%
+    echo.
+    echo Jalankan scan terlebih dahulu:
+    echo   python scan.py
+    echo   atau: .\bat\run-scan.bat
+    echo.
+    pause
+    exit /b 1
+)
+
+REM Run Python to display results
+where python >nul 2>nul
+if %errorlevel%==0 (
+    python check_results.py
+) else if defined PYTHON_EXE (
+    "%PYTHON_EXE%" check_results.py
+) else (
+    echo ERROR: Python tidak ditemukan!
+    pause
+    exit /b 1
+)
+
+echo.
+pause

package/bat/run-scan.bat

@@ -0,0 +1,65 @@
+@echo off
+setlocal EnableDelayedExpansion
+
+title 9Router Combo Model Scan
+
+echo ============================================
+echo  9Router Combo Model Scan
+echo ============================================
+echo.
+
+REM Resolve script directory (parent of bat folder)
+set "SCRIPT_DIR=%~dp0.."
+for %%i in ("%SCRIPT_DIR%") do set "SCRIPT_DIR=%%~fi"
+
+REM Load .env from project root
+set "ENV_FILE=%SCRIPT_DIR%\.env"
+if exist "%ENV_FILE%" (
+    echo Loading config from .env...
+    for /f "usebackq tokens=1,* delims==" %%a in ("%ENV_FILE%") do (
+        set "%%a=%%b"
+    )
+) else (
+    echo WARNING: .env file not found at %ENV_FILE%
+    echo.
+)
+
+REM Debug: show what was loaded
+REM echo DEBUG: NINEROUTER_PASSWORD=[%NINEROUTER_PASSWORD%]
+
+REM Check password
+if not defined NINEROUTER_PASSWORD (
+    echo ERROR: NINEROUTER_PASSWORD tidak diset!
+    echo Silakan isi password di file .env atau environment variable.
+    echo.
+    echo Cara setup:
+    echo   1. Copy .env.template ke .env
+    echo   2. Edit .env, isi NINEROUTER_PASSWORD
+    echo.
+    pause
+    exit /b 1
+)
+
+echo.
+echo Menjalankan combo scan...
+echo.
+
+REM Change to script directory
+cd /d "%SCRIPT_DIR%"
+
+REM Try python from PATH first
+where python >nul 2>nul
+if %errorlevel%==0 (
+    python scan.py
+) else if defined PYTHON_EXE (
+    "%PYTHON_EXE%" scan.py
+) else (
+    echo ERROR: Python tidak ditemukan!
+    echo Pastikan Python terinstall atau atur PYTHON_EXE di .env
+    pause
+    exit /b 1
+)
+
+echo.
+pause
+exit /b 0

package/bat/setup-scheduler.bat

@@ -0,0 +1,75 @@
+@echo off
+setlocal
+
+title 9Router Combo Model Scan - Setup Scheduler
+
+echo ============================================
+echo  Setup: Windows Task Scheduler
+echo ============================================
+echo.
+
+REM Check admin privileges
+net session >nul 2>&1
+if %errorlevel% neq 0 (
+    echo WARNING:Perlu Administrator privilege!
+    echo Silakan klik kanan dan pilih ^"Run as administrator^"
+    echo.
+    pause
+    exit /b 1
+)
+
+REM Resolve script paths
+set "SCRIPT_DIR=%~dp0"
+set "SCRIPT_DIR=%SCRIPT_DIR:~0,-1%"
+
+REM Determine Python executable
+set "PYTHON_EXE="
+where python >nul 2>nul
+if %errorlevel%==0 (
+    set "PYTHON_EXE=python"
+) else (
+    set "PYTHON_EXE=C:\Users\Aris\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe"
+)
+
+REM Load password from .env if exists
+if exist "%SCRIPT_DIR%\.env" (
+    for /f "usebackq tokens=1,* delims==" %%a in ("%SCRIPT_DIR%\.env") do (
+        set "%%a=%%b"
+    )
+)
+
+REM Build command - include env vars inline
+set "CMD=""
+
+REM Set minimum required env vars for the scheduled task
+set "CMD=%CMD% set NINEROUTER_PASSWORD=%NINEROUTER_PASSWORD% && "
+set "CMD=%CMD% "%PYTHON_EXE%" "%SCRIPT_DIR%\scan.py""
+set "CMD=%CMD%""
+
+echo Membuat scheduled task...
+echo.
+echo Command: %PYTHON_EXE% scan.py
+echo Schedule: ONLOGON, delay 5 minutes
+echo.
+
+schtasks /Create /TN "9Router Combo Model Scan" /SC ONLOGON /DELAY 0005:00 /TR "cmd /c %CMD%" /F
+
+if %errorlevel%==0 (
+    echo.
+    echo SUCCESS - Taskscheduler dibuat.
+    echo.
+    echo Scan akan jalan otomatis 5 menit setelah login Windows.
+    echo.
+    echo Untuk melihat task:
+    echo   schtasks /query /TN "9Router Combo Model Scan"
+    echo.
+    echo Untuk hapus task:
+    echo   schtasks /Delete /TN "9Router Combo Model Scan" /F
+) else (
+    echo.
+    echo GAGAL - Gagal membuat task.
+    echo Pastikan tidak ada task dengan nama yang sama.
+)
+
+echo.
+pause

package/bin/9router-manager.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { main } from '../src/cli.js';
+
+main().catch((err) => {
+  console.error('FATAL:', err.message);
+  process.exit(1);
+});