Module: Brainiac::Plugins::Fizzy

Defined in:
lib/brainiac/plugins/fizzy.rb,
lib/brainiac/plugins/fizzy/cli.rb,
lib/brainiac/plugins/fizzy/hooks.rb,
lib/brainiac/plugins/fizzy/config.rb,
lib/brainiac/plugins/fizzy/helpers.rb,
lib/brainiac/plugins/fizzy/prompts.rb,
lib/brainiac/plugins/fizzy/version.rb,
lib/brainiac/plugins/fizzy/metadata.rb,
lib/brainiac/plugins/fizzy/planning.rb,
lib/brainiac/plugins/fizzy/handlers/summarize.rb

Defined Under Namespace

Modules: Cli, Config, Helpers, Hooks, Planning, Prompts, Summarize

Constant Summary collapse

VERSION = 
"0.0.19"

Class Method Summary collapse

Class Method Details

.cli(args) ⇒ Object

Plugin CLI entry point — called by brainiac core's plugin delegation.



656
657
658
 
# File 'lib/brainiac/plugins/fizzy/cli.rb', line 656

def self.cli(args)
  Cli.run(args)
end

.completions ⇒ Object

Subcommand names for bash completion.



661
662
663
 
# File 'lib/brainiac/plugins/fizzy/cli.rb', line 661

def self.completions
  %w[config status setup]
end

.configured? ⇒ Boolean

Returns true if Fizzy has at least one board configured.

Returns:

  • (Boolean) 


12
13
14
15
16
17
18
19
20
 
# File 'lib/brainiac/plugins/fizzy/metadata.rb', line 12

def self.configured?
  config_file = File.join(ENV.fetch("BRAINIAC_DIR", File.join(Dir.home, ".brainiac")), "fizzy.json")
  return false unless File.exist?(config_file)

  config = JSON.parse(File.read(config_file))
  !(config["boards"] || {}).empty?
rescue StandardError
  false
end

.handle_publish_or_triage(action, payload, board_key: nil) ⇒ Object 



178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
 
# File 'lib/brainiac/plugins/fizzy.rb', line 178

def handle_publish_or_triage(action, payload, board_key: nil)
  eventable = payload["eventable"] || {}
  card_number = eventable["number"]&.to_s

  if action == "card_triaged" && card_number
    return [200, { status: "ignored", reason: "self_move" }.to_json] if self_move_recent?(card_number)
    return [200, { status: "ignored", reason: "card_merged" }.to_json] if work_item_merged?(card_number)

    card_key = "card-#{card_number}"
    return [200, { status: "ignored", reason: "recently_completed" }.to_json] if recently_completed?(card_key)
  end

  if action == "card_published"
    assignees = eventable["assignees"] || []
    return handle_card_assigned(payload, board_key: board_key) if assignees.any? { |a| local_agent_names.include?(a["name"]) }
  end

  handle_card_published(payload, board_key: board_key)
end

.help_text ⇒ Object

Help text shown in brainiac help when the plugin is installed.



23
24
25
 
# File 'lib/brainiac/plugins/fizzy/metadata.rb', line 23

def self.help_text
  "    brainiac fizzy <command>      Manage Fizzy boards"
end

.on_agent_created(agent_key, entry) ⇒ Object

Called by brainiac CLI after agent create — prompts for Fizzy user ID.



666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
 
# File 'lib/brainiac/plugins/fizzy/cli.rb', line 666

def self.on_agent_created(agent_key, entry)
  return unless $stdin.tty?

  config_file = File.join(ENV.fetch("BRAINIAC_DIR", File.join(Dir.home, ".brainiac")), "fizzy.json")
  return unless File.exist?(config_file)

  display_name = entry["display_name"] || agent_key.capitalize
  puts ""
  puts "  [Fizzy] Configure Fizzy for #{display_name}?"
  print "  Fizzy user ID (or blank to skip): "
  user_id = $stdin.gets&.chomp
  return if user_id.nil? || user_id.empty?

  config = JSON.parse(File.read(config_file))
  config["authorized_users"] ||= []

  existing = config["authorized_users"].find { |u| u["id"] == user_id || u["name"]&.downcase == display_name.downcase }
  if existing
    puts "  ✓ #{display_name} already in authorized_users (id: #{existing["id"]})"
    return
  end

  config["authorized_users"] << { "id" => user_id, "name" => display_name, "human" => false }
  File.write(config_file, JSON.pretty_generate(config))
  puts "  ✓ Added #{display_name} (#{user_id}) to fizzy.json authorized_users"
rescue JSON::ParserError => e
  puts "  ⚠ Could not update fizzy.json: #{e.message}"
end

.on_agent_removed(agent_key, display_name) ⇒ Object

Called by brainiac CLI after agent remove — removes from Fizzy authorized_users.



696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
 
# File 'lib/brainiac/plugins/fizzy/cli.rb', line 696

def self.on_agent_removed(agent_key, display_name)
  config_file = File.join(ENV.fetch("BRAINIAC_DIR", File.join(Dir.home, ".brainiac")), "fizzy.json")
  return unless File.exist?(config_file)

  config = JSON.parse(File.read(config_file))
  users = config["authorized_users"]
  return unless users

  original_size = users.size
  users.reject! { |u| u["name"]&.downcase == display_name.downcase || u["name"]&.downcase == agent_key }
  return if users.size == original_size

  File.write(config_file, JSON.pretty_generate(config))
  puts "  [Fizzy] Removed #{display_name} from fizzy.json authorized_users"
rescue JSON::ParserError
  nil
end

.register(app) ⇒ Object

Called by Brainiac plugin system during server startup.

Parameters:

  • app (Sinatra::Application) —

    The running Brainiac server



28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/brainiac/plugins/fizzy.rb', line 28

def register(app)
  # Load Fizzy config
  Brainiac::Plugins::Fizzy::Config.load!

  # Register channel prompt
  Brainiac.register_channel_prompt(:fizzy,
                                   Brainiac::Plugins::Fizzy::Prompts::CHANNEL,
                                   pre_post_check: Brainiac::Plugins::Fizzy::Prompts::PRE_POST_CHECK)

  # Register lifecycle hooks
  Brainiac::Plugins::Fizzy::Hooks.register_all!

  # Set up webhook route
  setup_routes(app)

  LOG.info "[Fizzy] Plugin registered (webhook: /fizzy)"
end