shakaflow-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5941531ee5176e9d53e3df254edb01918e8c6d3d5b28e8790b452c9728ed3e21
+  data.tar.gz: 7b3e5e54753ed9996fb3d9d924b7e51691e05d1962b77ecc30b2ac5ae577b737
+SHA512:
+  metadata.gz: 4aa231099e5fed28dc52f1cb7494164aad62242f2a7b12455fdf521238389187b79e8878c9f1a1d2b1a51e10f5c33378c750257ee8337a12341342a0f0ddfbd3
+  data.tar.gz: 119e02b309760de3f9f813658d6e35e49cacdd7b47dad6205f3073e41f1a85bc565a13070c33fcc56c0927e69ef9874bfcaa9bc008d816d38034756d1cfb7dad

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 ShakaCode
+
+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,124 @@
+# ShakaFlow CLI
+
+Command-line interface for interacting with the ShakaFlow development API.
+
+## Installation
+
+```bash
+gem install shakaflow-cli
+```
+
+## Configuration
+
+Before using the CLI, configure your API credentials:
+
+```bash
+# Interactive configuration
+sf config
+
+# Or with flags
+sf config --url https://shakaflow.com --token YOUR_API_TOKEN
+
+# Configure a different environment
+sf config --env staging --url https://staging.shakaflow.com --token YOUR_STAGING_TOKEN
+```
+
+Configuration is stored in `~/.sf.yml`.
+
+### Environment Variables
+
+You can also use environment variables:
+
+- `SF_API_URL` - API URL (overrides config file)
+- `SF_API_TOKEN` - API token (overrides config file)
+- `SF_ENV` - Environment to use (default: production)
+
+## Commands
+
+### List LLM Providers
+
+```bash
+sf providers
+```
+
+### List Channel Members
+
+```bash
+sf members --workspace "My Workspace" --channel engineering
+```
+
+### Get Member Activity Context
+
+Get raw activity data for a member (no LLM processing):
+
+```bash
+sf member-activity-context \
+  --workspace "My Workspace" \
+  --channel engineering \
+  --member justin \
+  --days 7
+```
+
+### Generate Member Activity Summary
+
+Generate an AI-powered activity summary:
+
+```bash
+sf member-activity-summary \
+  --workspace "My Workspace" \
+  --channel engineering \
+  --member justin \
+  --days 7
+```
+
+With custom LLM provider:
+
+```bash
+sf member-activity-summary \
+  --workspace "My Workspace" \
+  --channel engineering \
+  --member justin \
+  --days 7 \
+  --provider anthropic
+```
+
+With custom prompt:
+
+```bash
+sf member-activity-summary \
+  --workspace "My Workspace" \
+  --channel engineering \
+  --member justin \
+  --days 7 \
+  --prompt "Summarize in 3 bullet points"
+```
+
+### Test Raw LLM Prompt
+
+```bash
+sf prompt --message "Hello, world!"
+sf prompt --message "Explain Ruby blocks" --provider openai --model gpt-4o
+```
+
+## Global Options
+
+- `--env ENV` - Environment to use (production, staging). Default: production
+- `--format FORMAT` - Output format (json, table). Default: table
+- `--json` - Shortcut for `--format json`
+
+## Output Formats
+
+By default, the CLI outputs human-readable tables. Use `--json` or `--format json` for machine-readable output:
+
+```bash
+sf providers --json
+sf members --workspace "My Workspace" --channel engineering --format json
+```
+
+## Getting Your API Token
+
+API tokens are created through Slack using the `/sc api-token` command, or by your ShakaFlow administrator.
+
+## License
+
+MIT License - see [LICENSE.txt](LICENSE.txt)

data/exe/sf

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "shakaflow_cli"
+
+ShakaflowCli::CLI.new(ARGV).run

data/lib/shakaflow_cli/version.rb

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

data/lib/shakaflow_cli.rb

@@ -0,0 +1,478 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "yaml"
+require "optparse"
+require "uri"
+require "date"
+require "fileutils"
+
+require_relative "shakaflow_cli/version"
+
+module ShakaflowCli
+  # ShakaFlow CLI - Development API client
+  # Usage: sf <command> [options]
+  class CLI
+    CONFIG_FILE = ".sf.yml"
+    HOME_CONFIG = File.join(Dir.home, CONFIG_FILE)
+
+    def initialize(args)
+      @args = args
+      @command = args.shift
+      @options = {}
+    end
+
+    def run
+      case @command
+      when "config"
+        handle_config
+      when "providers"
+        handle_providers
+      when "prompt"
+        handle_prompt
+      when "member-activity-summary"
+        handle_member_activity_summary
+      when "member-activity-context"
+        handle_member_activity_context
+      when "members"
+        handle_members
+      when "version", "-v", "--version"
+        puts "shakaflow-cli #{VERSION}"
+      when "help", nil, "-h", "--help"
+        print_help
+      else
+        puts "Unknown command: #{@command}"
+        print_help
+        exit 1
+      end
+    end
+
+    private
+
+    def print_help
+      puts <<~HELP
+        ShakaFlow CLI - Development API client (v#{VERSION})
+
+        Usage: sf <command> [options]
+
+        Commands:
+          config                      Configure API URL and token
+          providers                   List available LLM providers
+          prompt                      Test a raw LLM prompt
+          member-activity-summary     Generate activity summary for a member
+          member-activity-context     Get raw activity context data (no LLM)
+          members                     List members of a channel
+          version                     Show version
+
+        Global Options:
+          --env ENV                   Environment to use (production, staging). Default: production
+          --format FORMAT             Output format (json, table). Default: table
+          --help                      Show help for a command
+
+        Examples:
+          sf config --url https://shakaflow.com --token abc123
+          sf providers
+          sf members --workspace "My Workspace" --channel engineering
+          sf member-activity-context --workspace "My Workspace" --channel engineering --member justin --days 7
+          sf member-activity-summary --workspace "My Workspace" --channel engineering --member justin --days 7
+          sf member-activity-summary --workspace "My Workspace" --channel engineering --member justin --provider anthropic
+          sf member-activity-summary --workspace "My Workspace" --channel engineering --member justin --prompt-file prompt.txt
+          sf prompt --message "Hello, world!"
+      HELP
+    end
+
+    def handle_config
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: sf config [options]"
+        opts.on("--url URL", "API URL") { |v| @options[:url] = v }
+        opts.on("--token TOKEN", "API token") { |v| @options[:token] = v }
+        opts.on("--env ENV", "Environment (production, staging)") { |v| @options[:env] = v }
+      end
+      parser.parse!(@args)
+
+      env = @options[:env] || "production"
+
+      config = load_config
+      config[env] ||= {}
+
+      if @options[:url]
+        config[env]["url"] = @options[:url]
+      else
+        print "API URL [#{config.dig(env, 'url')}]: "
+        input = $stdin.gets.chomp
+        config[env]["url"] = input unless input.empty?
+      end
+
+      if @options[:token]
+        config[env]["token"] = @options[:token]
+      else
+        print "API Token [#{config.dig(env, 'token') ? '****' : '(not set)'}]: "
+        input = $stdin.gets.chomp
+        config[env]["token"] = input unless input.empty?
+      end
+
+      save_config(config)
+      puts "Configuration saved to #{HOME_CONFIG}"
+    end
+
+    def handle_providers
+      parse_global_options
+      response = api_get("/api/v1/llm/providers")
+      output_response(response, :providers)
+    end
+
+    def handle_prompt
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: sf prompt [options]"
+        opts.on("--message MESSAGE", "Prompt message") { |v| @options[:message] = v }
+        opts.on("--provider PROVIDER", "LLM provider") { |v| @options[:provider] = v }
+        opts.on("--model MODEL", "LLM model") { |v| @options[:model] = v }
+        opts.on("--temperature TEMP", Float, "Temperature") { |v| @options[:temperature] = v }
+        opts.on("--max-tokens TOKENS", Integer, "Max tokens") { |v| @options[:max_tokens] = v }
+      end
+      parser.parse!(@args)
+      parse_global_options
+
+      message = @options[:message]
+      if message.nil? || message.empty?
+        puts "Error: --message is required"
+        exit 1
+      end
+
+      body = {
+        messages: [{ role: "user", content: message }],
+        provider: @options[:provider],
+        model: @options[:model],
+        temperature: @options[:temperature],
+        max_tokens: @options[:max_tokens]
+      }.compact
+
+      response = api_post("/api/v1/llm/test_prompt", body)
+      output_response(response, :prompt)
+    end
+
+    def handle_member_activity_summary
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: sf member-activity-summary [options]"
+        opts.on("--workspace WORKSPACE", "Slack workspace name") { |v| @options[:workspace] = v }
+        opts.on("--channel CHANNEL", "Slack channel name") { |v| @options[:channel] = v }
+        opts.on("--member MEMBER", "Member handle") { |v| @options[:member] = v }
+        opts.on("--days DAYS", Integer, "Number of days") { |v| @options[:days] = v }
+        opts.on("--start-date DATE", "Start date (YYYY-MM-DD)") { |v| @options[:start_date] = v }
+        opts.on("--end-date DATE", "End date (YYYY-MM-DD)") { |v| @options[:end_date] = v }
+        opts.on("--period-type TYPE", "Period type (daily, weekly, monthly)") { |v| @options[:period_type] = v }
+        opts.on("--provider PROVIDER", "LLM provider") { |v| @options[:provider] = v }
+        opts.on("--model MODEL", "LLM model") { |v| @options[:model] = v }
+        opts.on("--prompt PROMPT", "Custom prompt (use - for stdin)") { |v| @options[:prompt] = v }
+        opts.on("--prompt-file FILE", "Read prompt from file") { |v| @options[:prompt_file] = v }
+        opts.on("--include-context", "Include activity context in response") { @options[:include_context] = true }
+      end
+      parser.parse!(@args)
+      parse_global_options
+
+      validate_required(:workspace, :channel, :member)
+
+      custom_prompt = read_prompt
+
+      body = {
+        workspace: @options[:workspace],
+        channel: @options[:channel],
+        member: @options[:member],
+        days: @options[:days],
+        start_date: @options[:start_date],
+        end_date: @options[:end_date],
+        period_type: @options[:period_type],
+        provider: @options[:provider],
+        model: @options[:model],
+        custom_prompt:,
+        include_context: @options[:include_context] ? "true" : nil
+      }.compact
+
+      response = api_post("/api/v1/activity_reports/member_activity_summary", body)
+      output_response(response, :summary)
+    end
+
+    def handle_member_activity_context
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: sf member-activity-context [options]"
+        opts.on("--workspace WORKSPACE", "Slack workspace name") { |v| @options[:workspace] = v }
+        opts.on("--channel CHANNEL", "Slack channel name") { |v| @options[:channel] = v }
+        opts.on("--member MEMBER", "Member handle") { |v| @options[:member] = v }
+        opts.on("--days DAYS", Integer, "Number of days") { |v| @options[:days] = v }
+        opts.on("--start-date DATE", "Start date (YYYY-MM-DD)") { |v| @options[:start_date] = v }
+        opts.on("--end-date DATE", "End date (YYYY-MM-DD)") { |v| @options[:end_date] = v }
+        opts.on("--period-type TYPE", "Period type (daily, weekly, monthly)") { |v| @options[:period_type] = v }
+      end
+      parser.parse!(@args)
+      parse_global_options
+
+      validate_required(:workspace, :channel, :member)
+
+      query = {
+        workspace: @options[:workspace],
+        channel: @options[:channel],
+        member: @options[:member],
+        days: @options[:days],
+        start_date: @options[:start_date],
+        end_date: @options[:end_date],
+        period_type: @options[:period_type]
+      }.compact
+
+      response = api_get("/api/v1/activity_reports/member_activity_context", query)
+      output_response(response, :context)
+    end
+
+    def handle_members
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: sf members [options]"
+        opts.on("--workspace WORKSPACE", "Slack workspace name") { |v| @options[:workspace] = v }
+        opts.on("--channel CHANNEL", "Slack channel name") { |v| @options[:channel] = v }
+      end
+      parser.parse!(@args)
+      parse_global_options
+
+      validate_required(:workspace, :channel)
+
+      response = api_get("/api/v1/activity_reports/members", {
+                           workspace: @options[:workspace],
+                           channel: @options[:channel]
+                         })
+      output_response(response, :members)
+    end
+
+    def parse_global_options
+      @options[:env] ||= ENV["SF_ENV"] || "production"
+      @options[:format] ||= "table"
+
+      # Check remaining args for global options
+      remaining = []
+      while (arg = @args.shift)
+        case arg
+        when "--env"
+          @options[:env] = @args.shift
+        when "--format"
+          @options[:format] = @args.shift
+        when "--json"
+          @options[:format] = "json"
+        else
+          remaining << arg
+        end
+      end
+      @args = remaining
+    end
+
+    def validate_required(*keys)
+      missing = keys.select { |k| @options[k].nil? || @options[k].to_s.empty? }
+      return if missing.empty?
+
+      puts "Error: Missing required options: #{missing.map { |k| "--#{k.to_s.tr('_', '-')}" }.join(', ')}"
+      exit 1
+    end
+
+    def read_prompt
+      if @options[:prompt_file]
+        File.read(@options[:prompt_file])
+      elsif @options[:prompt] == "-"
+        $stdin.read
+      elsif @options[:prompt]
+        @options[:prompt]
+      end
+    end
+
+    def load_config
+      if File.exist?(HOME_CONFIG)
+        YAML.load_file(HOME_CONFIG) || {}
+      elsif File.exist?(CONFIG_FILE)
+        YAML.load_file(CONFIG_FILE) || {}
+      else
+        {}
+      end
+    end
+
+    def save_config(config)
+      File.write(HOME_CONFIG, YAML.dump(config))
+      File.chmod(0o600, HOME_CONFIG)
+    end
+
+    def api_url
+      env = @options[:env] || "production"
+      url = ENV["SF_API_URL"] || load_config.dig(env, "url")
+      unless url
+        puts "Error: API URL not configured. Run 'sf config' first."
+        exit 1
+      end
+      url
+    end
+
+    def api_token
+      env = @options[:env] || "production"
+      token = ENV["SF_API_TOKEN"] || load_config.dig(env, "token")
+      unless token
+        puts "Error: API token not configured. Run 'sf config' first."
+        exit 1
+      end
+      token
+    end
+
+    def api_get(path, query = {})
+      uri = URI.join(api_url, path)
+      uri.query = URI.encode_www_form(query) unless query.empty?
+
+      request = Net::HTTP::Get.new(uri)
+      request["Authorization"] = "Bearer #{api_token}"
+      request["Content-Type"] = "application/json"
+
+      execute_request(uri, request)
+    end
+
+    def api_post(path, body)
+      uri = URI.join(api_url, path)
+
+      request = Net::HTTP::Post.new(uri)
+      request["Authorization"] = "Bearer #{api_token}"
+      request["Content-Type"] = "application/json"
+      request.body = body.to_json
+
+      execute_request(uri, request)
+    end
+
+    def execute_request(uri, request)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = 10
+      http.read_timeout = 120
+
+      response = http.request(request)
+
+      case response
+      when Net::HTTPSuccess
+        JSON.parse(response.body)
+      else
+        { error: "HTTP #{response.code}: #{response.message}", body: response.body }
+      end
+    rescue StandardError => e
+      { error: e.message }
+    end
+
+    def output_response(response, type)
+      if @options[:format] == "json"
+        puts JSON.pretty_generate(response)
+      else
+        output_table(response, type)
+      end
+    end
+
+    def output_table(response, type)
+      if response[:error] || response["error"]
+        puts "Error: #{response[:error] || response['error']}"
+        puts response[:body] || response["body"] if response[:body] || response["body"]
+        exit 1
+      end
+
+      case type
+      when :providers
+        output_providers_table(response)
+      when :prompt
+        output_prompt_result(response)
+      when :summary
+        output_summary_result(response)
+      when :context
+        output_context_result(response)
+      when :members
+        output_members_table(response)
+      else
+        puts JSON.pretty_generate(response)
+      end
+    end
+
+    def output_providers_table(response)
+      puts "LLM Providers:"
+      puts "-" * 60
+      response["providers"]&.each do |provider|
+        default = provider["is_default"] ? " (default)" : ""
+        available = provider["available"] ? "+" : "-"
+        puts "  #{available} #{provider['name']}#{default}"
+        puts "    Model: #{provider['default_model']}"
+      end
+    end
+
+    def output_prompt_result(response)
+      puts "Response:"
+      puts response["response"]
+      puts
+      puts "Model: #{response['model']} (#{response['provider']})"
+    end
+
+    def output_summary_result(response)
+      puts "Summary:"
+      puts response["summary"]
+      puts
+      puts "Model: #{response['model']} (#{response['provider']})"
+      puts
+      puts "Prompt used:"
+      puts "-" * 60
+      puts response["prompt_used"]
+
+      if response["member_content"]
+        puts
+        puts "Activity Context:"
+        puts "-" * 60
+        puts JSON.pretty_generate(response["member_content"])
+      end
+    end
+
+    def output_context_result(response)
+      puts "Activity Context for #{response['member_name']}:"
+      puts "Period: #{response['start_date']} to #{response['end_date']} (#{response['period_type']})"
+      puts
+
+      tasks = response["tasks"] || []
+      if tasks.any?
+        puts "Tasks (#{tasks.count}):"
+        tasks.each do |task|
+          puts "  [#{task['state']}] #{task['name']}"
+          puts "    URL: #{task['url']}"
+        end
+        puts
+      end
+
+      prs = response["prs_without_task"] || []
+      if prs.any?
+        puts "PRs without task (#{prs.count}):"
+        prs.each do |pr|
+          puts "  #{pr['title']}"
+          puts "    URL: #{pr['url']}"
+        end
+        puts
+      end
+
+      reviews = response["reviews_done"] || []
+      if reviews.any?
+        puts "Reviews done (#{reviews.count}):"
+        reviews.each do |review|
+          puts "  #{review['pr_title']} (#{review['state']})"
+        end
+        puts
+      end
+
+      stalled = response["stalled_prs"] || []
+      return unless stalled.any?
+
+      puts "Stalled PRs (#{stalled.count}):"
+      stalled.each do |pr|
+        puts "  #{pr['title']} (#{pr['days_unresponsive']} days)"
+      end
+    end
+
+    def output_members_table(response)
+      puts "Channel Members:"
+      puts "-" * 60
+      response["members"]&.each do |member|
+        github = member["github_login"] ? " (@#{member['github_login']})" : ""
+        puts "  #{member['handle']} - #{member['name']}#{github}"
+        puts "    Email: #{member['email']}"
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: shakaflow-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ShakaCode
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-01-20 00:00:00.000000000 Z
+dependencies: []
+description: Command-line interface for interacting with ShakaFlow development API
+email:
+- support@shakacode.com
+executables:
+- sf
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- exe/sf
+- lib/shakaflow_cli.rb
+- lib/shakaflow_cli/version.rb
+homepage: https://github.com/shakacode/shakaflow
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/shakacode/shakaflow
+  source_code_uri: https://github.com/shakacode/shakaflow
+  changelog_uri: https://github.com/shakacode/shakaflow/blob/main/cli/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: CLI client for ShakaFlow API
+test_files: []