agent-skill-manager 1.1.0 → 1.3.0

package/docs/ARCHITECTURE.md

@@ -1,60 +0,0 @@
-# Architecture
-
-## Overview
-
-agent-skill-manager is a terminal UI application that scans, displays, and manages skills installed for various AI coding agents. It follows a simple layered architecture: CLI entry → app bootstrap → core modules → TUI views.
-
-## Components
-
-### CLI Entry (`bin/agent-skill-manager.ts`)
-
-Handles `--help` and `--version` flags, then delegates to the main app entry point.
-
-### App Bootstrap (`src/index.ts`)
-
-Initializes the OpenTUI renderer, wires up keyboard handlers, and manages view state transitions (dashboard, detail, confirm, config, help).
-
-### Core Modules
-
-| Module               | Responsibility                                                    |
-| -------------------- | ----------------------------------------------------------------- |
-| `src/config.ts`      | Load/save config from `~/.config/agent-skill-manager/config.json` |
-| `src/scanner.ts`     | Walk provider directories, parse SKILL.md, filter & sort          |
-| `src/uninstaller.ts` | Build removal plans and execute safe deletions                    |
-
-### Views (`src/views/`)
-
-Each view is a factory function that creates OpenTUI components:
-
-- **dashboard.ts** — Main layout with scope tabs, search input, stats bar
-- **skill-list.ts** — Scrollable, selectable list of discovered skills
-- **skill-detail.ts** — Overlay showing full skill metadata
-- **confirm.ts** — Uninstall confirmation dialog with target list
-- **config.ts** — Provider toggle UI
-- **help.ts** — Keyboard shortcut overlay
-
-### Utilities (`src/utils/`)
-
-- **types.ts** — Shared TypeScript interfaces (`SkillInfo`, `AppConfig`, `Scope`, etc.)
-- **colors.ts** — Neon green color palette for the TUI
-- **frontmatter.ts** — YAML-like frontmatter parser for SKILL.md files
-
-## Data Flow
-
-```
-Config (disk) → Scanner (walk dirs) → SkillInfo[] → Views (render)
-                                                   ↕
-                                          Keyboard Events → State Machine → View Transitions
-                                                   ↓
-                                          Uninstaller → Filesystem Mutations → Rescan
-```
-
-## State Management
-
-Application state is held in module-level variables in `src/index.ts`:
-
-- `allSkills` / `filteredSkills` — current skill data
-- `currentScope` / `currentSort` / `searchQuery` — filter state
-- `viewState` — which overlay is active (`dashboard`, `detail`, `confirm`, `config`, `help`)
-
-State transitions are driven by keyboard events and propagated to views via update functions.

package/docs/CHANGELOG.md

@@ -1,46 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
-
-## [1.1.0] - 2026-03-11
-
-### Added
-
-- One-command install script (`curl | bash`) with automatic Bun installation
-- Non-interactive CLI mode with `asm` shorthand command
-- .npmignore to exclude unnecessary files from npm package
-- TUI screenshot in README
-
-### Fixed
-
-- Bun global bin PATH handling and asm/agent-skill-manager alias creation in installer
-- External font import in SVGs for GitHub rendering
-
-### Changed
-
-- Rebranded project to agent-skill-manager across all files
-- Renamed bin entry point to `agent-skill-manager.ts` to match package name
-- Renamed package to agent-skill-manager with version info in help output
-
-### Removed
-
-- Obsolete CLI_PLAN.md
-
-## [1.0.0] - 2025-03-11
-
-### Added
-
-- Interactive TUI dashboard with OpenTUI
-- Multi-agent support: Claude Code, Codex, OpenClaw, and generic Agents
-- Configurable providers via `~/.config/agent-skill-manager/config.json`
-- Global and project scope filtering
-- Real-time search and sort (by name, version, location)
-- Detailed skill view with SKILL.md frontmatter metadata
-- Safe uninstall with confirmation dialog
-- In-TUI config editor with provider toggle
-- CLI entry point with `--help` and `--version` flags
-- Pre-commit hooks (Prettier, TypeScript type-checking)
-- GitHub Actions CI pipeline
-- Unit tests for config, scanner, uninstaller, and frontmatter modules

package/docs/DEPLOYMENT.md

@@ -1,52 +0,0 @@
-# Deployment
-
-## Publishing to npm (via Bun)
-
-agent-skill-manager is distributed as a global CLI package.
-
-### 1. Bump the version
-
-Update the version in both files:
-
-- `package.json` → `"version"`
-- `bin/agent-skill-manager.ts` → `VERSION` constant
-
-### 2. Build and publish
-
-```bash
-npm publish
-```
-
-Or if using Bun's npm compatibility:
-
-```bash
-bunx npm publish
-```
-
-### 3. Install globally
-
-Users install with:
-
-```bash
-bun install -g agent-skill-manager
-```
-
-## Running from Source
-
-For development or CI environments:
-
-```bash
-git clone https://github.com/luongnv89/agent-skill-manager.git
-cd agent-skill-manager
-bun install
-bun run start
-```
-
-## CI Pipeline
-
-GitHub Actions runs on every push and PR to `main`:
-
-- Type-checking (`bun run typecheck`)
-- Tests (`bun test`)
-
-See `.github/workflows/ci.yml` for the full pipeline.

package/docs/DEVELOPMENT.md

@@ -1,64 +0,0 @@
-# Development Guide
-
-## Prerequisites
-
-- [Bun](https://bun.sh) >= 1.0.0
-- [Git](https://git-scm.com/)
-
-## Setup
-
-```bash
-git clone https://github.com/luongnv89/agent-skill-manager.git
-cd agent-skill-manager
-bun install
-```
-
-## Running
-
-```bash
-bun run start        # Launch the TUI
-bun run dev          # Same as start (alias)
-```
-
-## Testing
-
-```bash
-bun test             # Run all tests
-bun run typecheck    # Type-check without emitting
-```
-
-Test files are co-located with source files using the `*.test.ts` convention:
-
-- `src/config.test.ts`
-- `src/scanner.test.ts`
-- `src/uninstaller.test.ts`
-- `src/utils/frontmatter.test.ts`
-
-## Pre-commit Hooks
-
-The project uses [pre-commit](https://pre-commit.com/) with:
-
-- **trailing-whitespace** — removes trailing whitespace
-- **end-of-file-fixer** — ensures files end with a newline
-- **check-yaml / check-json** — validates config files
-- **check-added-large-files** — prevents accidental large file commits
-- **prettier** — auto-formats TS, JS, JSON, CSS, and MD files
-- **typecheck** — runs `tsc --noEmit` on staged TypeScript files
-
-Install hooks locally:
-
-```bash
-pre-commit install
-```
-
-## Debugging
-
-Since this is a TUI application, standard `console.log` will interfere with the terminal UI. For debugging:
-
-1. Write to a log file: `Bun.write("/tmp/sm-debug.log", JSON.stringify(data))`
-2. Run tests to isolate logic from the TUI layer
-3. Use the `--help` flag to verify CLI plumbing without launching the TUI
-
-## Project Layout
-
-See [ARCHITECTURE.md](ARCHITECTURE.md) for the full component breakdown.

package/install.sh

@@ -1,226 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-# ============================================================================
-# agent-skill-manager Installer
-# The universal skill manager for AI coding agents.
-#
-# Usage:
-#   curl -sSL https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
-#   wget -qO- https://raw.githubusercontent.com/luongnv89/agent-skill-manager/main/install.sh | bash
-# ============================================================================
-
-TOOL_NAME="agent-skill-manager"
-REPO_OWNER="luongnv89"
-REPO_NAME="agent-skill-manager"
-BUN_MIN_VERSION="1.0.0"
-
-# --- Color Output ---
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-info()  { printf "${BLUE}[INFO]${NC}  %s\n" "$*"; }
-ok()    { printf "${GREEN}[ OK ]${NC}  %s\n" "$*"; }
-warn()  { printf "${YELLOW}[WARN]${NC}  %s\n" "$*"; }
-err()   { printf "${RED}[ERR ]${NC}  %s\n" "$*" >&2; }
-die()   { err "$@"; exit 1; }
-
-# --- OS / Arch Detection ---
-detect_os() {
-    local os
-    os="$(uname -s | tr '[:upper:]' '[:lower:]')"
-    case "$os" in
-        linux*)  echo "linux" ;;
-        darwin*) echo "macos" ;;
-        mingw*|msys*|cygwin*) echo "windows" ;;
-        *)       die "Unsupported operating system: $os" ;;
-    esac
-}
-
-detect_arch() {
-    local arch
-    arch="$(uname -m)"
-    case "$arch" in
-        x86_64|amd64)  echo "x86_64" ;;
-        aarch64|arm64) echo "arm64" ;;
-        armv7l)        echo "armv7" ;;
-        *)             die "Unsupported architecture: $arch" ;;
-    esac
-}
-
-# --- Version Comparison ---
-# Returns 0 if $1 >= $2 (semver)
-version_gte() {
-    local IFS=.
-    local i ver1=($1) ver2=($2)
-    for ((i=0; i<${#ver2[@]}; i++)); do
-        local v1="${ver1[i]:-0}"
-        local v2="${ver2[i]:-0}"
-        if ((v1 > v2)); then return 0; fi
-        if ((v1 < v2)); then return 1; fi
-    done
-    return 0
-}
-
-# --- Bun Detection & Installation ---
-check_bun() {
-    if command -v bun &>/dev/null; then
-        local bun_version
-        bun_version="$(bun --version 2>/dev/null || echo "0.0.0")"
-        if version_gte "$bun_version" "$BUN_MIN_VERSION"; then
-            ok "Bun $bun_version found (>= $BUN_MIN_VERSION required)"
-            return 0
-        else
-            warn "Bun $bun_version found but >= $BUN_MIN_VERSION is required"
-            return 1
-        fi
-    else
-        return 1
-    fi
-}
-
-install_bun() {
-    info "Installing Bun..."
-    if command -v curl &>/dev/null; then
-        curl -fsSL https://bun.sh/install | bash
-    elif command -v wget &>/dev/null; then
-        wget -qO- https://bun.sh/install | bash
-    else
-        die "Neither curl nor wget found. Please install one of them first."
-    fi
-
-    # Source bun into current shell
-    local bun_install="${BUN_INSTALL:-$HOME/.bun}"
-    if [ -f "$bun_install/bin/bun" ]; then
-        export BUN_INSTALL="$bun_install"
-        export PATH="$bun_install/bin:$PATH"
-    fi
-
-    if ! command -v bun &>/dev/null; then
-        die "Bun installation completed but 'bun' is not in PATH. Please restart your shell and re-run this script."
-    fi
-
-    ok "Bun $(bun --version) installed"
-}
-
-# --- Ensure Bun global bin is in PATH ---
-ensure_bun_in_path() {
-    local bun_bin="${BUN_INSTALL:-$HOME/.bun}/bin"
-    if [[ ":$PATH:" != *":$bun_bin:"* ]]; then
-        export PATH="$bun_bin:$PATH"
-        info "Added $bun_bin to PATH for this session"
-    fi
-}
-
-# --- Install agent-skill-manager ---
-install_asm() {
-    info "Installing $TOOL_NAME globally via Bun..."
-    bun install -g "$TOOL_NAME"
-    ok "$TOOL_NAME installed globally"
-}
-
-# --- Create command aliases ---
-create_aliases() {
-    local bun_bin="${BUN_INSTALL:-$HOME/.bun}/bin"
-    local bin_target=""
-
-    # Find the actual installed binary (could be skill-manager or agent-skill-manager)
-    for name in skill-manager agent-skill-manager; do
-        if [ -f "$bun_bin/$name" ] || [ -L "$bun_bin/$name" ]; then
-            bin_target="$bun_bin/$name"
-            break
-        fi
-    done
-
-    if [ -z "$bin_target" ]; then
-        warn "Could not find installed binary in $bun_bin"
-        return 1
-    fi
-
-    # Create symlinks for all expected command names
-    for alias_name in agent-skill-manager asm; do
-        local alias_path="$bun_bin/$alias_name"
-        if [ ! -f "$alias_path" ] && [ ! -L "$alias_path" ]; then
-            ln -s "$bin_target" "$alias_path"
-            ok "Created alias: $alias_name"
-        fi
-    done
-}
-
-# --- Verification ---
-verify_installation() {
-    info "Verifying installation..."
-    local found=false
-
-    for cmd in agent-skill-manager asm skill-manager; do
-        if command -v "$cmd" &>/dev/null; then
-            ok "$cmd is available"
-            found=true
-        fi
-    done
-
-    if [ "$found" = false ]; then
-        warn "No commands found in PATH"
-        warn "Add Bun's global bin to your PATH by adding this to your shell profile:"
-        warn "  export PATH=\"\$HOME/.bun/bin:\$PATH\""
-        return 1
-    fi
-
-    return 0
-}
-
-# --- Entry Point ---
-main() {
-    echo ""
-    info "============================================"
-    info " $TOOL_NAME Installer"
-    info "============================================"
-    echo ""
-
-    local os arch
-    os="$(detect_os)"
-    arch="$(detect_arch)"
-    info "OS: $os | Arch: $arch"
-    echo ""
-
-    # Step 1: Ensure Bun is installed
-    if ! check_bun; then
-        install_bun
-    fi
-    echo ""
-
-    # Step 2: Ensure Bun global bin is in PATH
-    ensure_bun_in_path
-
-    # Step 3: Install agent-skill-manager
-    install_asm
-    echo ""
-
-    # Step 4: Create aliases (agent-skill-manager, asm)
-    create_aliases
-    echo ""
-
-    # Step 5: Verify
-    if verify_installation; then
-        echo ""
-        info "============================================"
-        ok "Installation complete!"
-        info "============================================"
-        echo ""
-        info "Get started:"
-        info "  asm                    # Launch interactive TUI (shorthand)"
-        info "  agent-skill-manager    # Launch interactive TUI"
-        info "  asm --help             # Show help"
-        echo ""
-    else
-        echo ""
-        warn "Installation finished but verification had warnings."
-        warn "Try restarting your terminal, then run: agent-skill-manager"
-        echo ""
-    fi
-}
-
-main "$@"