Initial commit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: mycollablab

.github/workflows/ci.yml

@@ -0,0 +1,20 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.23"
+
+      - run: go build ./...
+
+      - run: go vet ./...

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.23"
+
+      - uses: goreleaser/goreleaser-action@v6
+        with:
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,26 @@
+# Binary
+cupi
+
+# Integration test binaries/artifacts
+*.test
+
+# Go build artifacts
+*.test
+*.out
+
+# Scraper output
+api_reference.json
+api_reference.md
+tools/*.pdf
+
+# macOS
+.DS_Store
+
+# Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Claude Code
+.claude/

.goreleaser.yaml

@@ -0,0 +1,50 @@
+version: 2
+
+project_name: cupi
+
+before:
+  hooks:
+    - go mod tidy
+
+builds:
+  - binary: cupi
+    env:
+      - CGO_ENABLED=0
+    ldflags:
+      - -s -w -X github.com/Cloverhound/cupi-cli/cmd.Version={{.Version}}
+    goos:
+      - darwin
+      - linux
+      - windows
+    goarch:
+      - amd64
+      - arm64
+
+archives:
+  - formats:
+      - tar.gz
+    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    format_overrides:
+      - goos: windows
+        formats:
+          - zip
+
+checksum:
+  name_template: "checksums.txt"
+
+release:
+  github:
+    owner: Cloverhound
+    name: cupi-cli
+  draft: false
+  prerelease: auto
+
+changelog:
+  sort: asc
+  filters:
+    exclude:
+      - "^docs:"
+      - "^test:"
+      - "^chore:"
+      - Merge pull request
+      - Merge branch

CLAUDE.md

@@ -0,0 +1,48 @@
+# cupi — Cisco Unity Connection CLI
+
+## Overview
+
+Go CLI tool (`cupi`) for Cisco Unity Connection (CUC). Wraps:
+- **CUPI** — REST/JSON provisioning (`/vmrest/`) — users, distlists, handlers, COS, templates, schedules
+- **PAWS** — Platform admin SOAP (`/platform-services/services/`) — cluster status, DRS backup
+- **AST** — System health XML (`/ast/Astisapi.dll`) — disk, heartbeat, alerts, perfmon
+- **DIME** — Log collection (`/logcollectionservice/services/DimeGetFileService`) — log file downloads
+
+## Key Paths
+
+- Config: `~/.cupi/config.json` (servers map, not `clusters`)
+- Keyring service: `cupi`
+- Module: `github.com/Cloverhound/cupi`
+- Binary: `cupi`
+- Env vars: `CUPI_DEBUG`, `CUPI_DRY_RUN`
+
+## Credential Types
+
+- `cupi` — CUPI REST (default, analogous to `axl` in cucm-cli)
+- `application` — Application-level APIs
+- `platform` — OS admin for PAWS
+
+## Development
+
+```bash
+go build -o cupi .        # Build (Version reports "dev")
+./cupi --help             # Verify
+./cupi version            # Print version
+./cupi upgrade --check    # Check for newer release on GitHub
+bash install-local.sh     # Install binary (embeds git tag as version) + skill
+go run ./tools/scraper/   # Run API doc scraper
+go test ./tests/ -run TestCLI  # Run CLI validation tests (no live server needed)
+
+# Build with explicit version:
+go build -ldflags "-X github.com/Cloverhound/cupi-cli/cmd.Version=v1.2.3" -o cupi .
+```
+
+## Architecture
+
+- `internal/appconfig/` — `ServerConfig` (not `ClusterConfig`), `defaultServer`, `servers`
+- `internal/auth/` — `CredTypeCUPI="cupi"`, keyring service `"cupi"`
+- `internal/client/rest.go` — JSON REST: `Request/Get/Post/Put/Delete`
+- `internal/client/ast.go` — VOS-common AST only (disk, tftp, heartbeat, alerts, perfmon)
+- `internal/client/paws.go` — PAWS SOAP (identical to cucm-cli, CUPI_DEBUG)
+- `internal/client/dime.go` — DIME log download (identical to cucm-cli, CUPI_DEBUG)
+- `tools/scraper/` — Phase 1 HTML scraper for CUPI API docs

LICENSE

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