moxytool/changelog.md

# Changelog

## 2025-10-29 - 1.5.1 - fix(scriptindex)
Improve script search: use ObjectSorter with weighted results prioritizing slug and name

- Replaced smartfuzzy.FuzzyMatcher with smartfuzzy.ObjectSorter for multi-field fuzzy searching
- Search now runs across slug, name, and description fields
- Added weighting so slug matches are prioritized, name matches receive a medium boost
- Search returns ordered script objects based on adjusted score

## 2025-10-29 - 1.5.0 - feat(scripts)
Add fuzzy search and type filtering for community scripts; improve scripts CLI output and cache handling

- Integrate @push.rocks/smartfuzzy and use FuzzyMatcher to provide ranked, fuzzy search results for scripts
- Add optional type filtering to scripts search (e.g. type:vm, type:ct, type:pve) and parse a --filter option in the CLI
- Improve scripts CLI output: colored type badges, truncated descriptions, clearer usage/help text and filtered result messaging
- Optimize ScriptIndex.loadCache to avoid reloading when cache is already present
- Update deno.json to include the smartfuzzy dependency and export/import smartfuzzy in plugins

## 2025-10-28 - 1.4.2 - fix(scriptindex)
Handle missing script metadata fields in ScriptIndex.search to prevent crashes

- Add null/undefined checks for name, slug, and description in ScriptIndex.search to avoid runtime exceptions when script metadata is incomplete
- Improves robustness of scripts search against partially populated or malformed cached metadata

## 2025-10-28 - 1.4.1 - fix(cli)
Fallback to 'unknown' when script.slug is missing in scripts list

- Fixes a potential runtime error when listing scripts if a script entry lacks a slug
- Uses a safe fallback ('unknown') before calling padEnd to ensure stable output
- Modified file: ts/moxytool.cli.ts

## 2025-10-28 - 1.4.0 - feat(cli)
Improve CLI output and logging with colored header, grouped script listings, and ANSI-styled logger

- Set smartcli instance version from deno.json to surface the package version in the CLI
- Revamp standard command output with a colored ASCII header, clearer commands list, and improved usage line
- Group script index output by type including Proxmox VE host (pve), Containers (ct), Virtual Machines (vm), and Other
- Enhance scripts listing formatting (slug padding and bullet points) for readability
- Replace timestamped logger messages with ANSI-colored output and icons for error/warn/success/info

## 2025-10-28 - 1.3.6 - fix(deps)
Bump smartcli dependency and add local settings file

- Bumped @push.rocks/smartcli from ^4.0.18 to ^4.0.19 in deno.json
- Added .claude/settings.local.json (development/local settings file)

## 2025-10-28 - 1.3.5 - fix(smartcli)
Bump @push.rocks/smartcli to ^4.0.18 and add local settings file for tooling permissions

- Updated dependency @push.rocks/smartcli from ^4.0.16 to ^4.0.18 in deno.json
- Added a local settings file (.claude/settings.local.json) to configure runtime/tooling permissions (web fetch domains, bash/deno/npm command allowances, and local read access)
- No code API changes; this is a dependency/infra update — incrementing patch version

## 2025-10-28 - 1.3.4 - fix(smartcli)
Update @push.rocks/smartcli to ^4.0.16 and add local Claude settings

- Bump dependency in deno.json: @push.rocks/smartcli from ^4.0.15 to ^4.0.16
- Add .claude/settings.local.json containing local permissions/configuration (development/local-only file)

## 2025-10-28 - 1.3.3 - fix(deno.json)
Bump @push.rocks/smartcli to ^4.0.15 and add local Claude settings

- Updated deno.json: @push.rocks/smartcli ^4.0.14 → ^4.0.15
- Added .claude/settings.local.json with local permissions for development/CI
- No runtime source changes; dependency update only — recommend a patch release

## 2025-10-28 - 1.3.2 - fix(cli)
Correct scripts subcommand argument parsing and bump smartcli dependency

- Fix scripts command argument indices so the subcommand is read from argvArg._[1] and subsequent arguments from argvArg._[2]. This resolves incorrect handling of 'scripts search', 'scripts info' and 'scripts run' inputs.
- Upgrade @push.rocks/smartcli dependency from ^4.0.11 to ^4.0.14 in deno.json for compatibility/stability improvements.

## 2025-10-27 - 1.3.1 - fix(publish)
Switch publish registry to internal Verdaccio instance and add local CI settings

- Update package.json publishConfig.registry from https://registry.npmjs.org/ to https://verdaccio.lossless.digital/ to publish packages to the internal Verdaccio registry.
- Add .claude/settings.local.json to include local CI/dev settings (local configuration only).

## 2025-10-27 - 1.3.0 - feat(cli)
Add automatic update command and documentation updates

- Add 'update' CLI command that checks the latest Gitea release and runs the install script to perform a self-update
- Implements release fetch/compare logic and executes the repository install.sh via curl
- Update README to document the one-line installer and the new 'moxytool update' usage
- Update changelog to note the new update command and installation clarifications

## 2025-10-27 - 1.2.0 - feat(scripts)
Add community scripts subsystem: script index, runner, and CLI commands with background refresh; update docs and paths

- New `scripts` command with subcommands: list, search, info, run, refresh (implemented in ts/moxytool.cli.ts)
- Added ScriptIndex (ts/moxytool.classes.scriptindex.ts) to fetch and cache ~400 community scripts with a 24h TTL and background refresh
- Added ScriptRunner (ts/moxytool.classes.scriptrunner.ts) to execute community installation scripts interactively via bash/curl
- Background index refresh at startup and explicit refresh command; cache saved under /etc/moxytool/scripts
- README and changelog updated with scripts usage and features; Proxmox support range updated to 7.4-9.x
- Updated module exports in mod.ts and minor logging change in ts/index.ts
- Added script-related paths (scriptsCacheDir, scriptsIndexFile) to ts/moxytool.paths.ts

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).

## [1.1.0] - 2025-01-27

### Added
- `update` command for automatic self-updating from Gitea releases
- `scripts` command for Proxmox community scripts management
- Access to 400+ community-maintained installation scripts
- Automatic daily index updates with local caching
- Script search and filtering capabilities
- Interactive script execution with full stdin/stdout/stderr passthrough
- Support for both LXC containers and VM templates
- Script metadata display (requirements, ports, credentials)
- One-line installation script as primary installation method

### Features
- `moxytool update` - Update MOXYTOOL to the latest version automatically
- `moxytool scripts list` - List all available scripts
- `moxytool scripts search <query>` - Search scripts by keyword
- `moxytool scripts info <slug>` - View detailed script information
- `moxytool scripts run <slug>` - Execute installation scripts
- `moxytool scripts refresh` - Force update the script index

### Changed
- Updated Proxmox version support to 7.4-9.x (from 7.4-8.x)
- Updated vGPU installer to anomixer fork with Proxmox v9 support

## [1.0.0] - 2025-01-24

### Added
- Initial release of MOXYTOOL
- `vgpu-setup` command for automated Proxmox vGPU installation
- Support for NVIDIA vGPU on Proxmox hosts
- Interactive installer integration with wvthoog/proxmox-vgpu-installer
- Cross-platform binary support (Linux, macOS, Windows)
- Multi-architecture support (x64, arm64)

### Features
- Automated vGPU driver download and installation
- Support for custom driver URLs and local files
- Debug mode for troubleshooting
- Step-by-step installation process
- Verification of Proxmox installation before setup

[1.1.0]: https://code.foss.global/serve.zone/moxytool/releases/tag/v1.1.0
[1.0.0]: https://code.foss.global/serve.zone/moxytool/releases/tag/v1.0.0