ui-cli 1.2.1__tar.gz

ui_cli-1.2.1/.gitignore

@@ -0,0 +1,97 @@
+# Claude Code
+.claude/
+.claude*
+
+# Environment variables (contains secrets)
+.env
+.env.local
+.env.*.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# Conda
+.conda/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+.settings/
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.hypothesis/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+*.temp
+
+# MkDocs
+site/
+uv.lock
+
+# Dolt database files (added by bd init)
+.dolt/
+*.db
+.beads/backup/
+
+# Local caches from other CLI tooling
+aiohomematic_storage/

ui_cli-1.2.1/CHANGELOG.md

@@ -0,0 +1,170 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.2.1] - 2026-04-16
+
+### Changed
+
+- Consolidated package versioning onto the root `VERSION` file for builds and local runs
+- Aligned the external release flow with `fmcli` and `nanobanana` via a single tag-driven PyPI publish workflow
+- Added `git-cliff` configuration for changelog generation without changing the SemVer workflow
+
+## [1.2.0] - 2026-04-15
+
+### Added
+
+#### UniFi API Key Authentication (Local Controller)
+- **X-API-KEY header authentication** for UDM/UniFi OS controllers — no session cookies needed
+- `controller_api_key` field in settings — configure via `UI_CLI_CONTROLLER_API_KEY` env var
+- **Automatic UDM prefix detection** — `/proxy/network` prefix applied automatically when API key is used
+- **Legacy controller fallback** — if a 404/405 is received and credentials are available, retries with cookie-based login automatically
+- `is_local_configured()` and `check_local_controller()` updated to accept API key as valid auth method
+- Status command supports API key authentication
+
+### Fixed
+
+- Hard 401 error on invalid/rejected API key — no silent fallback when key is wrong
+- Removed v2 endpoint 404-to-503 remapping regression
+
+## [0.3.0] - 2024-12-03
+
+### Added
+
+#### Claude Desktop Integration (MCP Server)
+- **16 AI-optimized tools** for natural language network management
+- `./ui mcp install` - One-command Claude Desktop setup
+- `./ui mcp check` - Verify installation
+- `./ui mcp show` - View current configuration
+- `./ui mcp remove` - Remove from Claude Desktop
+
+**Available Tools:**
+| Category | Tools |
+|----------|-------|
+| Status & Health | `network_status`, `network_health`, `internet_speed`, `run_speedtest`, `isp_performance` |
+| Counts & Lists | `client_count`, `device_list`, `network_list` |
+| Lookups | `find_client`, `find_device`, `client_status` |
+| Actions | `block_client`, `unblock_client`, `kick_client`, `restart_device`, `create_voucher` |
+
+#### Quick Timeout & Spinners
+- `--quick` / `-q` option for 5-second timeout on connectivity checks
+- `--timeout` / `-t` option for custom timeout values
+- Spinners on all local commands for better UX
+- Default timeout reduced from 30s to 15s
+
+#### CI/CD Support
+- `UNIFI_NO_SPINNER` env var to disable spinners
+- Auto-disable spinners when `CI=true` or `NO_COLOR` is set
+
+### Architecture
+- Subprocess-based tools layer for MCP (CLI remains single source of truth)
+- JSON output for all action commands
+
+---
+
+## [0.2.0] - 2024-12-01
+
+### Added
+
+#### Local Controller API (Milestone 2)
+- **Health & Monitoring**
+  - `./ui lo health` - Site health summary (WAN, LAN, WLAN, VPN status)
+  - `./ui lo events list` - View recent events with filtering
+
+- **Client Management**
+  - `./ui lo clients list` - List connected clients with filters (wired/wireless/network)
+  - `./ui lo clients all` - List all clients including offline
+  - `./ui lo clients get` - Get client details by name or MAC
+  - `./ui lo clients status` - Comprehensive client status (signal, experience, data usage)
+  - `./ui lo clients block/unblock` - Block or unblock clients
+  - `./ui lo clients kick` - Disconnect (reconnect) clients
+  - `./ui lo clients count` - Count clients by type/network/vendor/AP
+  - `./ui lo clients duplicates` - Find duplicate client names
+
+- **Device Management**
+  - `./ui lo devices list` - List network devices
+  - `./ui lo devices get` - Get device details by ID/MAC/name
+  - `./ui lo devices restart` - Restart a device
+  - `./ui lo devices upgrade` - Upgrade device firmware
+  - `./ui lo devices locate` - Toggle locate LED
+  - `./ui lo devices adopt` - Adopt a new device
+
+- **Network Configuration**
+  - `./ui lo networks list` - List all networks/VLANs
+  - `./ui lo config show` - Export running configuration (table/JSON/YAML)
+
+- **Security & Firewall**
+  - `./ui lo firewall list` - List firewall rules with ruleset filter
+  - `./ui lo firewall groups` - List firewall groups (address/port)
+  - `./ui lo portfwd list` - List port forwarding rules
+
+- **Guest Management**
+  - `./ui lo vouchers list` - List guest vouchers
+  - `./ui lo vouchers create` - Create vouchers with duration/quota/limits
+  - `./ui lo vouchers delete` - Delete vouchers
+
+- **DPI & Statistics**
+  - `./ui lo dpi stats` - Site-level DPI statistics
+  - `./ui lo dpi client` - Per-client DPI breakdown
+  - `./ui lo stats daily` - Daily traffic statistics
+  - `./ui lo stats hourly` - Hourly traffic statistics
+
+- **Other**
+  - `./ui speedtest` - Run speedtest via controller
+  - `./ui status` - Enhanced status with local controller info
+
+### Added (Testing)
+- Comprehensive pytest test suite (87 tests)
+  - 71 unit tests
+  - 16 integration tests
+- Test fixtures for mock API responses
+- pytest-asyncio for async test support
+
+### Changed
+- Updated documentation (README, USERGUIDE, ROADMAP)
+- Added CONTRIBUTING.md and LICENSE
+
+---
+
+## [0.1.0] - 2024-11-29
+
+### Added
+
+#### Site Manager API (Milestone 1)
+- **Authentication**
+  - API key authentication via `UNIFI_API_KEY`
+  - Connection status check (`./ui status`)
+
+- **Hosts**
+  - `./ui hosts list` - List all controllers
+  - `./ui hosts get` - Get controller details
+
+- **Sites**
+  - `./ui sites list` - List all sites
+
+- **Devices**
+  - `./ui devices list` - List all devices with host filter
+  - `./ui devices count` - Count devices by model/status/host/product-line
+
+- **ISP Metrics**
+  - `./ui isp metrics` - ISP performance metrics with interval options
+
+- **SD-WAN**
+  - `./ui sdwan list` - List SD-WAN configurations
+  - `./ui sdwan get` - Get configuration details
+  - `./ui sdwan status` - Get deployment status
+
+- **Output Formats**
+  - Table (default), JSON, CSV output for all commands
+  - Verbose mode for additional details
+
+### Infrastructure
+- Typer CLI framework
+- Rich terminal formatting
+- httpx async HTTP client
+- pydantic-settings configuration

ui_cli-1.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Vedanta Barooah
+
+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.