bugsink-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bc4e718e40bae09f46946050bfd5a52133b1a7f1b4653bd5d74ac4b39eeeef44
+  data.tar.gz: 04bc34a4dabc823fd3fd262b1b28e7174407e0cb922d5d6bd8e34ca526f0dedb
+SHA512:
+  metadata.gz: a4af07cd5b996e3ded9cd7333a1f1f097f6c6720a3b41b4cea21e03b6631c53c08642122e1e78d5cfdd1706d4b462b8ec03e8b7a366942ff5456774b07178f2b
+  data.tar.gz: 5c1303e396df707697e9fa08331720031cc39630367b4fbb0672769da9017cb0f9add4b0a38dbb9466d5e09c1b818a5640f008fa04266095e045a4263d600db6

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+# 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).
+
+## [0.1.0] - 2026-02-04
+
+### Added
+- Initial release of bugsink-cli gem
+- Complete BugSink API wrapper with support for:
+  - Teams (list, get, create, update)
+  - Projects (list, get, create, update)
+  - Issues (list, get) - read-only
+  - Events (list, get, stacktrace) - read-only
+  - Releases (list, get, create)
+- Configuration management via environment variables and .bugsink dotfile
+- Multiple output formats: table, JSON, quiet
+- Comprehensive CLI with help system
+- HTTParty-based HTTP client with error handling

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tomáš Landovský
+
+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.

data/README.md

@@ -0,0 +1,320 @@
+# BugSink CLI
+
+A command-line interface for the BugSink error tracking service. Provides full API access for teams, projects, issues, events, and releases.
+
+## Installation
+
+Install the gem:
+
+```bash
+gem install bugsink-cli
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem 'bugsink-cli', '~> 0.1.0'
+```
+
+## Configuration
+
+### Environment Variables
+
+**Required:**
+- `BUGSINK_API_KEY` - Your BugSink API authentication token
+
+**Optional:**
+- `BUGSINK_HOST` - API host (default: `https://bugs.kopernici.cz`)
+
+### Project Configuration
+
+The CLI supports a `.bugsink` dotfile in your project root to store the default project ID:
+
+```bash
+# Set default project
+bugsink config set-project 8
+
+# This creates .bugsink file with:
+PROJECT_ID=8
+```
+
+## Quick Start
+
+```bash
+# Set your API key
+export BUGSINK_API_KEY="your-token-here"
+
+# Test connection
+bugsink config test
+
+# Set default project
+bugsink config set-project 8
+
+# List latest issues
+bugsink issues list --project=8 --sort=last_seen --order=desc
+
+# Get formatted stacktrace
+bugsink events stacktrace <event-uuid>
+```
+
+## Usage
+
+### General Syntax
+
+```bash
+bugsink <resource> <action> [arguments] [options]
+```
+
+### Global Options
+
+- `--json` - Output as JSON (machine-readable)
+- `--quiet` - Minimal output (IDs only)
+
+### Resources
+
+#### Config
+
+```bash
+bugsink config show              # Show current configuration
+bugsink config set-project <id>  # Set default project ID
+bugsink config test              # Test API connectivity
+```
+
+#### Teams
+
+```bash
+# List all teams
+bugsink teams list [--json|--quiet]
+
+# Get team details
+bugsink teams get <uuid> [--json]
+
+# Create team
+bugsink teams create '{"name":"Team Name","visibility":"hidden"}'
+
+# Update team
+bugsink teams update <uuid> '{"name":"New Name"}'
+```
+
+#### Projects
+
+```bash
+# List all projects (optionally filter by team)
+bugsink projects list [--team=<uuid>] [--json|--quiet]
+
+# Get project details
+bugsink projects get <id> [--json]
+
+# Create project
+bugsink projects create '{
+  "team":"<team-uuid>",
+  "name":"Project Name",
+  "visibility":"team_members",
+  "alert_on_new_issue":true
+}'
+
+# Update project
+bugsink projects update <id> '{"name":"New Name","alert_on_new_issue":false}'
+```
+
+#### Issues (Read-Only)
+
+```bash
+# List issues for a project
+bugsink issues list --project=<id> \
+  [--sort=last_seen|digest_order] \
+  [--order=asc|desc] \
+  [--json|--quiet]
+
+# Get issue details
+bugsink issues get <uuid> [--json]
+```
+
+**Note:** Issues are **read-only** via the API. You cannot update status, resolve, or add comments through the CLI.
+
+#### Events (Read-Only)
+
+```bash
+# List events for an issue
+bugsink events list --issue=<uuid> [--order=asc|desc] [--json|--quiet]
+
+# Get event details
+bugsink events get <uuid> [--json]
+
+# Get formatted stacktrace (Markdown)
+bugsink events stacktrace <uuid>
+```
+
+**Note:** Events are **read-only** and created automatically via Sentry SDK. No manual creation/updates available.
+
+#### Releases
+
+```bash
+# List releases for a project
+bugsink releases list --project=<id> [--json|--quiet]
+
+# Get release details
+bugsink releases get <uuid> [--json]
+
+# Create release
+bugsink releases create '{
+  "project":8,
+  "version":"v1.2.3",
+  "timestamp":"2026-02-03T12:00:00Z"
+}'
+```
+
+**Note:** Releases can be created but not updated or deleted.
+
+### Help System
+
+```bash
+# General help
+bugsink help
+
+# Resource-specific help
+bugsink help teams
+bugsink help projects
+bugsink help issues
+bugsink help events
+bugsink help releases
+```
+
+## Examples
+
+### Daily Development Workflow
+
+```bash
+# Set up once
+export BUGSINK_API_KEY="..."
+cd /path/to/project
+bugsink config set-project 8
+
+# Check latest errors
+bugsink issues list --project=8 --sort=last_seen --order=desc --json | jq '.[:5]'
+
+# Get detailed stacktrace for an issue
+ISSUE_UUID=$(bugsink issues list --project=8 --quiet | head -1)
+EVENT_UUID=$(bugsink events list --issue=$ISSUE_UUID --quiet | head -1)
+bugsink events stacktrace $EVENT_UUID
+```
+
+### Creating a Release
+
+```bash
+# After deployment
+VERSION="v$(date +%Y%m%d-%H%M%S)"
+bugsink releases create "{\"project\":8,\"version\":\"$VERSION\"}"
+```
+
+### Filtering and Searching
+
+```bash
+# Get all projects for a specific team
+TEAM_UUID="ee4f4572-0957-4346-b433-3c605acbfa2a"
+bugsink projects list --team=$TEAM_UUID --json | jq '.[].name'
+
+# Get IDs of all teams
+bugsink teams list --quiet
+```
+
+## Output Formats
+
+### Table (Default)
+
+Human-readable table format with tab-separated columns:
+
+```
+id	name	visibility
+ee4f4572...	Team Name	team_members
+```
+
+### JSON
+
+Machine-readable JSON format (use `--json`):
+
+```json
+[
+  {
+    "id": "ee4f4572-0957-4346-b433-3c605acbfa2a",
+    "name": "Team Name",
+    "visibility": "team_members"
+  }
+]
+```
+
+### Quiet
+
+Minimal output with just IDs (use `--quiet`):
+
+```
+ee4f4572-0957-4346-b433-3c605acbfa2a
+```
+
+## API Capabilities & Limitations
+
+### Supported Write Operations
+
+- **Teams:** Create, Update
+- **Projects:** Create, Update
+- **Releases:** Create
+
+### Read-Only Resources
+
+- **Issues:** Cannot update status, resolve, or add comments
+- **Events:** Created automatically via Sentry SDK ingestion only
+
+### Not Supported
+
+- **DELETE operations:** No resource can be deleted via API
+- **Bulk operations:** Must process items one at a time
+- **Filtering on list endpoints:** Limited filter support
+
+## Library Usage
+
+You can also use bugsink-cli as a Ruby library:
+
+```ruby
+require 'bugsink'
+
+# Initialize client
+config = Bugsink::Config.new
+client = Bugsink::Client.new(config)
+
+# List teams
+response = client.teams_list
+teams = response.data
+
+# Get project
+project = client.project_get(8)
+
+# Create release
+release = client.release_create(
+  project_id: 8,
+  version: 'v1.0.0'
+)
+```
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies. Then, run `bundle exec rspec` to run the tests.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+### Running Tests
+
+```bash
+# Run all tests
+BUGSINK_API_KEY="your-key" bundle exec rspec
+
+# Run specific test
+BUGSINK_API_KEY="your-key" bundle exec rspec spec/bugsink/config_spec.rb
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/koperniki/bugsink-cli.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/exe/bugsink

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bugsink'
+
+cli = Bugsink::CLI.new(ARGV)
+cli.run

data/lib/bugsink/cli.rb

@@ -0,0 +1,573 @@
+# frozen_string_literal: true
+
+require 'optparse'
+require 'json'
+require_relative 'client'
+require_relative 'config'
+
+module Bugsink
+  # CLI command parser and router for BugSink API
+  class CLI
+    attr_reader :client, :config, :options
+
+    def initialize(args = ARGV)
+      @args = args
+      @options = {
+        format: 'table',
+        project_id: nil
+      }
+      @config = Config.new
+      @client = Client.new(@config)
+    rescue Config::ConfigError => e
+      error("Configuration error: #{e.message}")
+      exit 1
+    end
+
+    def run
+      return show_help if @args.empty?
+
+      resource = @args[0]
+      action = @args[1]
+
+      case resource
+      when 'help', '--help', '-h'
+        show_help(action)
+      when '--version', '-v'
+        show_version
+      when 'config'
+        handle_config(action)
+      when 'teams'
+        handle_teams(action, @args[2..])
+      when 'projects'
+        handle_projects(action, @args[2..])
+      when 'issues'
+        handle_issues(action, @args[2..])
+      when 'events'
+        handle_events(action, @args[2..])
+      when 'releases'
+        handle_releases(action, @args[2..])
+      else
+        error("Unknown resource: #{resource}")
+        show_help
+        exit 1
+      end
+    rescue Client::ClientError => e
+      error("API error: #{e.message}")
+      exit 1
+    rescue ArgumentError => e
+      error("Argument error: #{e.message}")
+      exit 1
+    rescue StandardError => e
+      error("Unexpected error: #{e.class} - #{e.message}")
+      error(e.backtrace.join("\n")) if ENV['DEBUG']
+      exit 1
+    end
+
+    private
+
+    def handle_config(action)
+      case action
+      when 'show'
+        puts @config.to_s
+      when 'set-project'
+        project_id = @args[2]
+        error('Project ID required') && exit(1) unless project_id
+        @config.set_project_id(project_id.to_i)
+        success("Project ID set to #{project_id}")
+      when 'test'
+        @client.test_connection
+        success('API connection successful!')
+      else
+        error("Unknown config action: #{action}")
+        exit 1
+      end
+    end
+
+    def handle_teams(action, args)
+      case action
+      when 'list'
+        parse_format_options!(args)
+        response = @client.teams_list
+        output_list(response.data, format: @options[:format])
+      when 'get'
+        uuid = args[0]
+        error('Team UUID required') && exit(1) unless uuid
+        parse_format_options!(args[1..])
+        team = @client.team_get(uuid)
+        output_single(team, format: @options[:format])
+      when 'create'
+        data = parse_json_arg(args[0])
+        error('Name required in JSON') && exit(1) unless data['name']
+        team = @client.team_create(
+          name: data['name'],
+          visibility: data['visibility']
+        )
+        output_single(team, format: 'json')
+      when 'update'
+        uuid = args[0]
+        error('Team UUID required') && exit(1) unless uuid
+        data = parse_json_arg(args[1])
+        error('Update data required') && exit(1) if data.empty?
+        team = @client.team_update(
+          uuid,
+          name: data['name'],
+          visibility: data['visibility']
+        )
+        output_single(team, format: 'json')
+      else
+        error("Unknown teams action: #{action}")
+        exit 1
+      end
+    end
+
+    def handle_projects(action, args)
+      case action
+      when 'list'
+        parse_project_options!(args)
+        response = @client.projects_list(team_uuid: @options[:team])
+        output_list(response.data, format: @options[:format])
+      when 'get'
+        id = args[0]
+        error('Project ID required') && exit(1) unless id
+        parse_format_options!(args[1..])
+        project = @client.project_get(id.to_i)
+        output_single(project, format: @options[:format])
+      when 'create'
+        data = parse_json_arg(args[0])
+        error('Team and name required in JSON') && exit(1) unless data['team'] && data['name']
+        project = @client.project_create(
+          team_uuid: data['team'],
+          name: data['name'],
+          visibility: data['visibility'],
+          alert_on_new_issue: data['alert_on_new_issue'],
+          alert_on_regression: data['alert_on_regression'],
+          alert_on_unmute: data['alert_on_unmute']
+        )
+        output_single(project, format: 'json')
+      when 'update'
+        id = args[0]
+        error('Project ID required') && exit(1) unless id
+        data = parse_json_arg(args[1])
+        error('Update data required') && exit(1) if data.empty?
+        project = @client.project_update(
+          id.to_i,
+          name: data['name'],
+          visibility: data['visibility'],
+          alert_on_new_issue: data['alert_on_new_issue'],
+          alert_on_regression: data['alert_on_regression'],
+          alert_on_unmute: data['alert_on_unmute']
+        )
+        output_single(project, format: 'json')
+      else
+        error("Unknown projects action: #{action}")
+        exit 1
+      end
+    end
+
+    def handle_issues(action, args)
+      case action
+      when 'list'
+        parse_issue_options!(args)
+        project_id = @options[:project_id] || @config.project_id
+        error('Project ID required (use --project or set via config)') && exit(1) unless project_id
+        response = @client.issues_list(
+          project_id: project_id,
+          sort: @options[:sort] || 'last_seen',
+          order: @options[:order] || 'desc'
+        )
+        output_list(response.data, format: @options[:format])
+      when 'get'
+        uuid = args[0]
+        error('Issue UUID required') && exit(1) unless uuid
+        parse_format_options!(args[1..])
+        issue = @client.issue_get(uuid)
+        output_single(issue, format: @options[:format])
+      else
+        error("Unknown issues action: #{action}")
+        info('Note: Issues are read-only. Write operations not available in API.')
+        exit 1
+      end
+    end
+
+    def handle_events(action, args)
+      case action
+      when 'list'
+        parse_event_options!(args)
+        error('Issue UUID required (use --issue)') && exit(1) unless @options[:issue]
+        response = @client.events_list(
+          issue_uuid: @options[:issue],
+          order: @options[:order] || 'desc'
+        )
+        output_list(response.data, format: @options[:format])
+      when 'get'
+        uuid = args[0]
+        error('Event UUID required') && exit(1) unless uuid
+        parse_format_options!(args[1..])
+        event = @client.event_get(uuid)
+        output_single(event, format: @options[:format])
+      when 'stacktrace'
+        uuid = args[0]
+        error('Event UUID required') && exit(1) unless uuid
+        stacktrace = @client.event_stacktrace(uuid)
+        puts stacktrace
+      else
+        error("Unknown events action: #{action}")
+        exit 1
+      end
+    end
+
+    def handle_releases(action, args)
+      case action
+      when 'list'
+        parse_release_options!(args)
+        project_id = @options[:project_id] || @config.project_id
+        error('Project ID required (use --project or set via config)') && exit(1) unless project_id
+        response = @client.releases_list(project_id: project_id)
+        output_list(response.data, format: @options[:format])
+      when 'get'
+        uuid = args[0]
+        error('Release UUID required') && exit(1) unless uuid
+        parse_format_options!(args[1..])
+        release = @client.release_get(uuid)
+        output_single(release, format: @options[:format])
+      when 'create'
+        data = parse_json_arg(args[0])
+        error('Project and version required in JSON') && exit(1) unless data['project'] && data['version']
+        release = @client.release_create(
+          project_id: data['project'],
+          version: data['version'],
+          timestamp: data['timestamp']
+        )
+        output_single(release, format: 'json')
+      else
+        error("Unknown releases action: #{action}")
+        exit 1
+      end
+    end
+
+    def parse_format_options!(args)
+      OptionParser.new do |opts|
+        opts.on('--json', 'Output as JSON') { @options[:format] = 'json' }
+        opts.on('--quiet', 'Minimal output') { @options[:format] = 'quiet' }
+      end.parse!(args)
+    end
+
+    def parse_project_options!(args)
+      OptionParser.new do |opts|
+        opts.on('--team=UUID', 'Filter by team UUID') { |v| @options[:team] = v }
+        opts.on('--json', 'Output as JSON') { @options[:format] = 'json' }
+        opts.on('--quiet', 'Minimal output') { @options[:format] = 'quiet' }
+      end.parse!(args)
+    end
+
+    def parse_issue_options!(args)
+      OptionParser.new do |opts|
+        opts.on('--project=ID', 'Project ID') { |v| @options[:project_id] = v.to_i }
+        opts.on('--sort=FIELD', 'Sort field') { |v| @options[:sort] = v }
+        opts.on('--order=ORDER', 'Sort order (asc|desc)') { |v| @options[:order] = v }
+        opts.on('--json', 'Output as JSON') { @options[:format] = 'json' }
+        opts.on('--quiet', 'Minimal output') { @options[:format] = 'quiet' }
+      end.parse!(args)
+    end
+
+    def parse_event_options!(args)
+      OptionParser.new do |opts|
+        opts.on('--issue=UUID', 'Issue UUID (required)') { |v| @options[:issue] = v }
+        opts.on('--order=ORDER', 'Sort order (asc|desc)') { |v| @options[:order] = v }
+        opts.on('--json', 'Output as JSON') { @options[:format] = 'json' }
+        opts.on('--quiet', 'Minimal output') { @options[:format] = 'quiet' }
+      end.parse!(args)
+    end
+
+    def parse_release_options!(args)
+      OptionParser.new do |opts|
+        opts.on('--project=ID', 'Project ID') { |v| @options[:project_id] = v.to_i }
+        opts.on('--json', 'Output as JSON') { @options[:format] = 'json' }
+        opts.on('--quiet', 'Minimal output') { @options[:format] = 'quiet' }
+      end.parse!(args)
+    end
+
+    def parse_json_arg(json_str)
+      return {} unless json_str
+
+      JSON.parse(json_str)
+    rescue JSON::ParserError => e
+      error("Invalid JSON: #{e.message}")
+      exit 1
+    end
+
+    def output_list(data, format:)
+      case format
+      when 'json'
+        puts JSON.pretty_generate(data)
+      when 'quiet'
+        data.each { |item| puts item['id'] || item['uuid'] }
+      else
+        output_table(data)
+      end
+    end
+
+    def output_single(data, format:)
+      case format
+      when 'json'
+        puts JSON.pretty_generate(data)
+      when 'quiet'
+        puts data['id'] || data['uuid']
+      else
+        puts JSON.pretty_generate(data)
+      end
+    end
+
+    def output_table(data)
+      return puts 'No data' if data.empty?
+
+      # Extract common fields
+      keys = data.first.keys
+      headers = keys.join("\t")
+      puts headers
+      puts '-' * 80
+
+      data.each do |item|
+        values = keys.map { |k| format_value(item[k]) }
+        puts values.join("\t")
+      end
+    end
+
+    def format_value(value)
+      case value
+      when Hash, Array
+        JSON.generate(value)
+      when nil
+        ''
+      else
+        value.to_s
+      end
+    end
+
+    def show_version
+      puts "BugSink CLI v#{Bugsink::VERSION}"
+    end
+
+    def show_help(resource = nil)
+      if resource
+        show_resource_help(resource)
+      else
+        show_general_help
+      end
+    end
+
+    def show_general_help
+      puts <<~HELP
+        BugSink CLI - API wrapper for BugSink error tracking
+
+        Usage: bugsink <resource> <action> [options]
+
+        Resources:
+          config      - Configuration management
+          teams       - Team operations
+          projects    - Project operations
+          issues      - Issue operations (read-only)
+          events      - Event operations (read-only)
+          releases    - Release operations
+
+        Global Options:
+          --json      Output as JSON
+          --quiet     Minimal output (IDs only)
+
+        Common Commands:
+          bugsink config show                          Show current configuration
+          bugsink config set-project <id>              Set default project ID
+          bugsink config test                          Test API connectivity
+
+          bugsink teams list                           List all teams
+          bugsink teams get <uuid>                     Get team details
+          bugsink teams create '{"name":"TeamName"}'   Create team
+
+          bugsink projects list [--team=<uuid>]        List projects
+          bugsink projects get <id>                    Get project details
+
+          bugsink issues list --project=<id>           List issues for project
+          bugsink issues get <uuid>                    Get issue details
+
+          bugsink events list --issue=<uuid>           List events for issue
+          bugsink events stacktrace <uuid>             Get formatted stacktrace
+
+          bugsink releases list --project=<id>         List releases
+          bugsink releases create '{"project":8,"version":"v1.0"}'
+
+        Environment Variables:
+          BUGSINK_API_KEY      API authentication token (required)
+          BUGSINK_HOST         API host (default: https://bugs.kopernici.cz)
+
+        Configuration File:
+          .bugsink                Project ID for current directory
+
+        For resource-specific help:
+          bugsink help <resource>
+
+        Examples:
+          # Set up configuration
+          export BUGSINK_API_KEY="your-token-here"
+          bugsink config set-project 8
+          bugsink config test
+
+          # List latest issues
+          bugsink issues list --project=8 --sort=last_seen --order=desc --json
+
+          # Get stacktrace for an event
+          bugsink events stacktrace <event-uuid>
+
+        Note: Issues and Events are READ-ONLY via the API. Write operations are not supported.
+      HELP
+    end
+
+    def show_resource_help(resource)
+      case resource
+      when 'config'
+        puts <<~HELP
+          bugsink config - Configuration management
+
+          Actions:
+            show              Show current configuration
+            set-project <id>  Set default project ID in .bugsink file
+            test              Test API connectivity
+
+          Examples:
+            bugsink config show
+            bugsink config set-project 8
+            bugsink config test
+        HELP
+      when 'teams'
+        puts <<~HELP
+          bugsink teams - Team operations
+
+          Actions:
+            list                    List all teams
+            get <uuid>              Get team details
+            create <json>           Create new team
+            update <uuid> <json>    Update team
+
+          JSON Format (create):
+            {"name":"Team Name","visibility":"hidden"}
+            Visibility options: joinable, discoverable, hidden
+
+          JSON Format (update):
+            {"name":"New Name"}  // All fields optional
+
+          Examples:
+            bugsink teams list --json
+            bugsink teams get ee4f4572-0957-4346-b433-3c605acbfa2a
+            bugsink teams create '{"name":"My Team","visibility":"hidden"}'
+            bugsink teams update <uuid> '{"name":"Updated Name"}'
+        HELP
+      when 'projects'
+        puts <<~HELP
+          bugsink projects - Project operations
+
+          Actions:
+            list [--team=<uuid>]    List projects (optionally filtered by team)
+            get <id>                Get project details
+            create <json>           Create new project
+            update <id> <json>      Update project
+
+          JSON Format (create):
+            {
+              "team":"team-uuid",
+              "name":"Project Name",
+              "visibility":"team_members",
+              "alert_on_new_issue":true,
+              "alert_on_regression":true,
+              "alert_on_unmute":false
+            }
+            Visibility options: joinable, discoverable, team_members
+
+          JSON Format (update):
+            {"name":"New Name","alert_on_new_issue":false}  // All fields optional
+
+          Examples:
+            bugsink projects list --team=<uuid> --json
+            bugsink projects get 8
+            bugsink projects create '{"team":"<uuid>","name":"Test Project"}'
+            bugsink projects update 8 '{"alert_on_new_issue":false}'
+        HELP
+      when 'issues'
+        puts <<~HELP
+          bugsink issues - Issue operations (READ-ONLY)
+
+          Actions:
+            list --project=<id> [--sort=<field>] [--order=<asc|desc>]
+            get <uuid>
+
+          Options:
+            --project=<id>    Project ID (required for list)
+            --sort=<field>    Sort by: last_seen, digest_order (default: last_seen)
+            --order=<order>   Sort order: asc, desc (default: desc)
+
+          Examples:
+            bugsink issues list --project=8 --sort=last_seen --order=desc
+            bugsink issues get <uuid> --json
+
+          Note: Issues are READ-ONLY. No write operations available in API.
+        HELP
+      when 'events'
+        puts <<~HELP
+          bugsink events - Event operations (READ-ONLY)
+
+          Actions:
+            list --issue=<uuid> [--order=<asc|desc>]
+            get <uuid>
+            stacktrace <uuid>
+
+          Options:
+            --issue=<uuid>    Issue UUID (required for list)
+            --order=<order>   Sort order: asc, desc (default: desc)
+
+          Examples:
+            bugsink events list --issue=<uuid>
+            bugsink events get <uuid> --json
+            bugsink events stacktrace <uuid>
+
+          Note: Events are READ-ONLY. Created via Sentry SDK only.
+        HELP
+      when 'releases'
+        puts <<~HELP
+          bugsink releases - Release operations
+
+          Actions:
+            list --project=<id>     List releases for project
+            get <uuid>              Get release details
+            create <json>           Create new release
+
+          JSON Format (create):
+            {
+              "project":8,
+              "version":"v1.2.3",
+              "timestamp":"2026-02-03T12:00:00Z"  // Optional
+            }
+
+          Examples:
+            bugsink releases list --project=8
+            bugsink releases get <uuid>
+            bugsink releases create '{"project":8,"version":"v1.2.3"}'
+
+          Note: Releases can be created but not updated or deleted.
+        HELP
+      else
+        error("Unknown resource: #{resource}")
+        show_general_help
+      end
+    end
+
+    def success(message)
+      puts "✓ #{message}"
+    end
+
+    def info(message)
+      puts "ℹ #{message}"
+    end
+
+    def error(message)
+      warn "✗ #{message}"
+    end
+  end
+end

data/lib/bugsink/client.rb

@@ -0,0 +1,260 @@
+# frozen_string_literal: true
+
+require 'httparty'
+require 'json'
+require_relative 'config'
+
+module Bugsink
+  # HTTP client for BugSink API
+  class Client
+    include HTTParty
+
+    class ClientError < StandardError
+      attr_reader :code, :response
+
+      def initialize(message, code: nil, response: nil)
+        super(message)
+        @code = code
+        @response = response
+      end
+    end
+
+    class Response
+      attr_reader :data, :next_cursor
+
+      def initialize(response_body)
+        @data = response_body.is_a?(Hash) ? [response_body] : (response_body || [])
+        @next_cursor = extract_next_cursor(@data)
+      end
+
+      def initialize_from_list(response_body)
+        @data = response_body['results'] || []
+        @next_cursor = response_body['next']
+      end
+
+      def success?
+        true
+      end
+
+      def add_data(new_data)
+        @data.concat(new_data)
+      end
+
+      def has_more?
+        !@next_cursor.nil?
+      end
+
+      private
+
+      def extract_next_cursor(data)
+        return nil unless data.is_a?(Hash)
+        data['next']
+      end
+    end
+
+    attr_reader :config
+
+    def initialize(config = nil)
+      @config = config || Config.new
+      @config.validate!
+
+      self.class.base_uri @config.host
+      self.class.headers @config.authorization_header
+      self.class.headers 'Content-Type' => 'application/json'
+      self.class.headers 'Accept' => 'application/json'
+    end
+
+    # Teams
+    def teams_list
+      response = self.class.get('/api/canonical/0/teams/')
+      check_response(response)
+      parse_list_response(response)
+    end
+
+    def team_get(uuid)
+      response = self.class.get("/api/canonical/0/teams/#{uuid}/")
+      check_response(response)
+      response.parsed_response
+    end
+
+    def team_create(name:, visibility: nil)
+      body = { name: name }
+      body[:visibility] = visibility if visibility
+
+      response = self.class.post('/api/canonical/0/teams/', body: body.to_json)
+      check_response(response)
+      response.parsed_response
+    end
+
+    def team_update(uuid, name: nil, visibility: nil)
+      body = {}
+      body[:name] = name if name
+      body[:visibility] = visibility if visibility
+
+      raise ArgumentError, 'At least one field must be provided for update' if body.empty?
+
+      response = self.class.patch("/api/canonical/0/teams/#{uuid}/", body: body.to_json)
+      check_response(response)
+      response.parsed_response
+    end
+
+    # Projects
+    def projects_list(team_uuid: nil)
+      query = {}
+      query[:team] = team_uuid if team_uuid
+
+      response = self.class.get('/api/canonical/0/projects/', query: query)
+      check_response(response)
+      parse_list_response(response)
+    end
+
+    def project_get(id)
+      response = self.class.get("/api/canonical/0/projects/#{id}/")
+      check_response(response)
+      response.parsed_response
+    end
+
+    def project_create(team_uuid:, name:, visibility: nil, alert_on_new_issue: nil, alert_on_regression: nil, alert_on_unmute: nil)
+      body = {
+        team: team_uuid,
+        name: name
+      }
+      body[:visibility] = visibility if visibility
+      body[:alert_on_new_issue] = alert_on_new_issue unless alert_on_new_issue.nil?
+      body[:alert_on_regression] = alert_on_regression unless alert_on_regression.nil?
+      body[:alert_on_unmute] = alert_on_unmute unless alert_on_unmute.nil?
+
+      response = self.class.post('/api/canonical/0/projects/', body: body.to_json)
+      check_response(response)
+      response.parsed_response
+    end
+
+    def project_update(id, name: nil, visibility: nil, alert_on_new_issue: nil, alert_on_regression: nil, alert_on_unmute: nil)
+      body = {}
+      body[:name] = name if name
+      body[:visibility] = visibility if visibility
+      body[:alert_on_new_issue] = alert_on_new_issue unless alert_on_new_issue.nil?
+      body[:alert_on_regression] = alert_on_regression unless alert_on_regression.nil?
+      body[:alert_on_unmute] = alert_on_unmute unless alert_on_unmute.nil?
+
+      raise ArgumentError, 'At least one field must be provided for update' if body.empty?
+
+      response = self.class.patch("/api/canonical/0/projects/#{id}/", body: body.to_json)
+      check_response(response)
+      response.parsed_response
+    end
+
+    # Issues
+    def issues_list(project_id:, sort: 'last_seen', order: 'desc', limit: 250, cursor: nil)
+      query = {
+        project: project_id,
+        sort: sort,
+        order: order,
+        limit: limit
+      }
+      query[:cursor] = cursor if cursor
+
+      response = self.class.get('/api/canonical/0/issues/', query: query)
+      check_response(response)
+      parse_list_response(response)
+    end
+
+    def issue_get(uuid)
+      response = self.class.get("/api/canonical/0/issues/#{uuid}/")
+      check_response(response)
+      response.parsed_response
+    end
+
+    # Events
+    def events_list(issue_uuid:, order: 'desc', limit: 250, cursor: nil)
+      query = {
+        issue: issue_uuid,
+        order: order,
+        limit: limit
+      }
+      query[:cursor] = cursor if cursor
+
+      response = self.class.get('/api/canonical/0/events/', query: query)
+      check_response(response)
+      parse_list_response(response)
+    end
+
+    def event_get(uuid)
+      response = self.class.get("/api/canonical/0/events/#{uuid}/")
+      check_response(response)
+      response.parsed_response
+    end
+
+    def event_stacktrace(uuid)
+      response = self.class.get("/api/canonical/0/events/#{uuid}/stacktrace/")
+      check_response(response)
+      response.body
+    end
+
+    # Releases
+    def releases_list(project_id:)
+      query = { project: project_id }
+
+      response = self.class.get('/api/canonical/0/releases/', query: query)
+      check_response(response)
+      parse_list_response(response)
+    end
+
+    def release_get(uuid)
+      response = self.class.get("/api/canonical/0/releases/#{uuid}/")
+      check_response(response)
+      response.parsed_response
+    end
+
+    def release_create(project_id:, version:, timestamp: nil)
+      body = {
+        project: project_id,
+        version: version
+      }
+      body[:timestamp] = timestamp if timestamp
+
+      response = self.class.post('/api/canonical/0/releases/', body: body.to_json)
+      check_response(response)
+      response.parsed_response
+    end
+
+    # Test connectivity
+    def test_connection
+      response = self.class.get('/api/canonical/0/teams/')
+      check_response(response)
+      true
+    rescue ClientError => e
+      raise ClientError.new("Connection test failed: #{e.message}", code: e.code, response: e.response)
+    end
+
+    private
+
+    def check_response(response)
+      return response if response.code >= 200 && response.code < 300
+
+      error_message = "HTTP #{response.code}"
+      begin
+        error_body = response.parsed_response
+        error_message += ": #{error_body}" if error_body
+      rescue JSON::ParserError
+        error_message += ": #{response.body}"
+      end
+
+      raise ClientError.new(error_message, code: response.code, response: response.body)
+    end
+
+    def parse_list_response(response)
+      body = response.parsed_response
+
+      # Handle paginated list responses
+      if body.is_a?(Hash) && body.key?('results')
+        resp = Response.new(nil)
+        resp.initialize_from_list(body)
+        resp
+      else
+        # Handle simple array responses (like teams)
+        Response.new(body)
+      end
+    end
+  end
+end

data/lib/bugsink/config.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Bugsink
+  # Configuration management for BugSink API client
+  class Config
+    class ConfigError < StandardError; end
+
+    attr_reader :api_key, :host, :project_id
+
+    DOTFILE = '.bugsink'.freeze
+
+    def initialize
+      @api_key = ENV['BUGSINK_API_KEY']
+      @host = ENV.fetch('BUGSINK_HOST', 'https://bugs.kopernici.cz')
+      @project_id = read_project_id
+    end
+
+    def valid?
+      !api_key.nil? && !api_key.empty?
+    end
+
+    def validate!
+      raise ConfigError, 'BUGSINK_API_KEY environment variable is required' unless valid?
+    end
+
+    def authorization_header
+      { 'Authorization' => "Bearer #{api_key}" }
+    end
+
+    def set_project_id(id)
+      File.write(dotfile_path, "PROJECT_ID=#{id}\n")
+      @project_id = id
+    end
+
+    def project_id_present?
+      !project_id.nil?
+    end
+
+    def to_s
+      <<~CONFIG
+        BugSink Configuration:
+          Host: #{host}
+          API Key: #{api_key ? "#{api_key[0..8]}...#{api_key[-8..]}" : 'not set'}
+          Project ID: #{project_id || 'not set'}
+      CONFIG
+    end
+
+    private
+
+    def read_project_id
+      return nil unless File.exist?(dotfile_path)
+
+      content = File.read(dotfile_path).strip
+      match = content.match(/^PROJECT_ID=(\d+)$/)
+      match ? match[1].to_i : nil
+    end
+
+    def dotfile_path
+      File.join(Dir.pwd, DOTFILE)
+    end
+  end
+end

data/lib/bugsink/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Bugsink
+  VERSION = '0.1.0'
+end

data/lib/bugsink.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'bugsink/version'
+require_relative 'bugsink/config'
+require_relative 'bugsink/client'
+require_relative 'bugsink/cli'
+
+module Bugsink
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: bugsink-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tomas Kopernik
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: A command-line interface for the BugSink error tracking service, providing
+  full API access for teams, projects, issues, events, and releases.
+email:
+- tomas@kopernik.cz
+executables:
+- bugsink
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- exe/bugsink
+- lib/bugsink.rb
+- lib/bugsink/cli.rb
+- lib/bugsink/client.rb
+- lib/bugsink/config.rb
+- lib/bugsink/version.rb
+homepage: https://github.com/koperniki/bugsink-cli
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/koperniki/bugsink-cli
+  source_code_uri: https://github.com/koperniki/bugsink-cli
+  changelog_uri: https://github.com/koperniki/bugsink-cli/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: CLI tool for interacting with BugSink error tracking API
+test_files: []