brainiac-fizzy 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 900a770925d9d311e242d2262ba1d55488f1f1d99b706940412c90354fbecbe7
-  data.tar.gz: 10745520e457d223051f8b02451b6648b2fbd63b541a595da7430ef5a22a2580
+  metadata.gz: d848363b737703f7d3da85256a02550c97f4f45afad53daae7d0d29c035ce167
+  data.tar.gz: df5257f73e63964e4cbb7d33974e1057484dc497639c393069738c25111363b0
 SHA512:
-  metadata.gz: b5da5cb4db94444d25292a4521b73229c2e0115eaa14a4f29e1ddc0de47d87cb7bf54294d16ae59615ba0691be76ebf25040895c78a460fa7492b1f12729ff23
-  data.tar.gz: 9d16fc1d6792ddfbd2a0ba983a9bf66b4dc46cf3d2ead4bc3c77a4b6222679d5835cb30161722224cae7578a2ddd2531075090bc1829072f7c343b7bdb30abab
+  metadata.gz: 5e5bcd9d72ed693d4e2e4b0ce096df51238a29782a912650e1a39df9ecba62f439c5b79b6ba6b7814cd4e18ffe310d0cbe4f147f383baca3afd25ea303679362
+  data.tar.gz: 4bfcef1e519b2fb9738e25d2081cbbc24ba420fc9fac889d6ddbc4e4681665d914d250f150afc85263fa3761534f4617ea21311a3983907ec1bf376a6883004b

data/lib/brainiac/plugins/fizzy/cli.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Brainiac
+  module Plugins
+    module Fizzy
+      # CLI subcommands for brainiac-fizzy plugin.
+      #
+      # Invoked when a user runs `brainiac fizzy <command>`.
+      module Cli
+        BRAINIAC_DIR = ENV.fetch("BRAINIAC_DIR", File.join(Dir.home, ".brainiac"))
+        FIZZY_CONFIG_FILE = File.join(BRAINIAC_DIR, "fizzy.json")
+
+        class << self
+          def run(args)
+            command = args.shift
+
+            case command
+            when "config"
+              cmd_config
+            when "status"
+              cmd_status
+            when "setup"
+              cmd_setup
+            else
+              print_help
+            end
+          end
+
+          private
+
+          def cmd_config
+            if File.exist?(FIZZY_CONFIG_FILE)
+              puts File.read(FIZZY_CONFIG_FILE)
+            else
+              puts "No Fizzy config found at #{FIZZY_CONFIG_FILE}"
+              puts "Run 'brainiac fizzy setup' to get started."
+            end
+          end
+
+          def cmd_status
+            server_url = detect_server_url
+            begin
+              uri = URI("#{server_url}/api/fizzy")
+              response = Net::HTTP.get_response(uri)
+              data = JSON.parse(response.body)
+              puts "Fizzy: #{data["enabled"] ? "enabled" : "disabled"}"
+              puts "Boards: #{(data["boards"] || []).join(", ")}" if data["boards"]
+              puts "Authorized users: #{data["authorized_users"]}" if data["authorized_users"]
+            rescue StandardError => e
+              puts "Could not reach server at #{server_url}: #{e.message}"
+              puts "Is the server running? Check with: brainiac status"
+            end
+          end
+
+          def cmd_setup
+            puts "Fizzy Setup"
+            puts "==========="
+            puts ""
+
+            if File.exist?(FIZZY_CONFIG_FILE)
+              config = JSON.parse(File.read(FIZZY_CONFIG_FILE))
+              boards = config["boards"] || {}
+              users = config["authorized_users"] || []
+
+              if boards.any?
+                puts "✓ #{boards.size} board(s) configured: #{boards.keys.join(", ")}"
+              else
+                puts "⚠ No boards configured."
+                puts "  Edit #{FIZZY_CONFIG_FILE} to add board config."
+              end
+              puts ""
+
+              if users.any?
+                puts "✓ #{users.size} authorized user(s)"
+              else
+                puts "⚠ No authorized users configured."
+              end
+            else
+              puts "⚠ No fizzy.json found."
+              puts "  Create #{FIZZY_CONFIG_FILE} with your board config."
+              puts ""
+              puts "  Minimum config:"
+              puts "  {"
+              puts '    "authorized_users": [{ "id": "user-id", "name": "You", "human": true }],'
+              puts '    "boards": {'
+              puts '      "development": {'
+              puts '        "board_id": "your-board-id",'
+              puts '        "webhook_secret": "your-secret",'
+              puts '        "columns": { "right_now": "col-id", "needs_review": "col-id" }'
+              puts "      }"
+              puts "    }"
+              puts "  }"
+            end
+            puts ""
+            puts "Webhook URL: https://<your-ngrok>.ngrok-free.app/fizzy/<board-key>"
+          end
+
+          def print_help
+            puts <<~HELP
+              Usage: brainiac fizzy <command>
+
+              Commands:
+                config                              Show Fizzy config
+                status                              Check Fizzy status via server API
+                setup                               Show setup guide
+
+              Fizzy handles card assignment, comments, @mentions, cross-agent reviews,
+              duplicate detection, and planning mode via webhooks.
+
+              Webhook URL: https://<your-ngrok>/fizzy/<board-key>
+              Config file: #{FIZZY_CONFIG_FILE}
+            HELP
+          end
+
+          def detect_server_url
+            config_file = File.join(BRAINIAC_DIR, "brainiac.json")
+            if File.exist?(config_file)
+              config = JSON.parse(File.read(config_file))
+              config["server_url"] || "http://localhost:4567"
+            else
+              "http://localhost:4567"
+            end
+          rescue JSON::ParserError
+            "http://localhost:4567"
+          end
+        end
+      end
+
+      # Plugin CLI entry point — called by brainiac core's plugin delegation.
+      def self.cli(args)
+        Cli.run(args)
+      end
+
+      # Subcommand names for bash completion.
+      def self.completions
+        %w[config status setup]
+      end
+    end
+  end
+end

data/lib/brainiac/plugins/fizzy/config.rb

@@ -89,7 +89,7 @@ module Brainiac
             tag_names = tags.map { |t| t.is_a?(Hash) ? t["name"] : t.to_s }.map(&:downcase)
 
             PROJECTS.each do |key, config|
-              project_tags = (config["fizzy_tags"] || []).map(&:downcase)
+              project_tags = (config["tags"] || config["fizzy_tags"] || []).map(&:downcase)
               return [key, config] if tag_names.intersect?(project_tags)
             end
 

data/lib/brainiac/plugins/fizzy/delegators.rb

@@ -41,6 +41,11 @@ def scrub_invalid_attachments!(dir)
   Brainiac::Plugins::Fizzy::Helpers.scrub_invalid_attachments!(dir)
 end
 
+def detect_planning_mode(text:, tags:, card_internal_id:, card_number:)
+  Brainiac::Plugins::Fizzy::Helpers.detect_planning_mode(text: text, tags: tags,
+                                                         card_internal_id: card_internal_id, card_number: card_number)
+end
+
 def verify_fizzy_signature!(request, payload_body, board_key: nil)
   Brainiac::Plugins::Fizzy::Helpers.verify_signature!(request, payload_body, board_key: board_key)
 end
@@ -83,6 +88,30 @@ def human_mentioned?(user_id)
   Brainiac::Plugins::Fizzy::Config.human_mentioned?(user_id)
 end
 
+# Extracts user IDs from Fizzy mention markup in plain text.
+# Fizzy represents mentions as @[Display Name](user-id) in plain text.
+def detect_mentioned_user_ids(text)
+  return [] unless text
+
+  text.scan(/@\[[^\]]*\]\(([^)]+)\)/).flatten
+end
+
+# Webhook dispatch — routes incoming actions to the appropriate handler.
+# Called from within the Sinatra route block, so it must be a top-level method.
+def dispatch_webhook_action(action, payload)
+  case action
+  when "card_assigned"
+    handle_card_assigned(payload)
+  when "comment_created"
+    handle_comment(payload)
+  when "card_published", "card_triaged"
+    Brainiac::Plugins::Fizzy.handle_publish_or_triage(action, payload)
+  else
+    LOG.info "[Fizzy] Ignoring unknown action: #{action}"
+    [200, { status: "ignored", action: action }.to_json]
+  end
+end
+
 # Top-level prompt constants — handler files reference these directly
 PROMPT_CARD_ASSIGNED = Brainiac::Plugins::Fizzy::Prompts::CARD_ASSIGNED
 PROMPT_FOLLOWUP_WORKTREE = Brainiac::Plugins::Fizzy::Prompts::FOLLOWUP_WORKTREE

data/lib/brainiac/plugins/fizzy/handlers/assignment.rb

@@ -67,6 +67,24 @@ end
 
 def react_to_assignment(card_number, repo_path, agent_name)
   Thread.new do
+    # Delete existing reactions from this agent before re-reacting
+    result = run_cmd("fizzy", "reaction", "list", "--card", card_number.to_s,
+                     "--jq", "[.data[] | {id, reacter_id: .reacter.id}]",
+                     chdir: repo_path, env: fizzy_env_for(agent_name))
+    reactions = JSON.parse(result)
+
+    identity = run_cmd("fizzy", "identity", "show", "--jq", ".data.accounts[0].user.id",
+                       chdir: repo_path, env: fizzy_env_for(agent_name))
+    current_user_id = identity.strip.tr('"', "")
+
+    reactions.each do |reaction|
+      if reaction["reacter_id"] == current_user_id
+        run_cmd("fizzy", "reaction", "delete", reaction["id"], "--card", card_number.to_s,
+                chdir: repo_path, env: fizzy_env_for(agent_name))
+      end
+    end
+
+    # Add fresh reaction
     run_cmd("fizzy", "reaction", "create", "--card", card_number.to_s,
             "--content", "👍", chdir: repo_path, env: fizzy_env_for(agent_name))
   rescue StandardError => e

data/lib/brainiac/plugins/fizzy/helpers.rb

@@ -139,6 +139,16 @@ module Brainiac
             end
           end
 
+          # Determines whether a card should run in planning mode.
+          # Returns nil if planning is not active, or { card_id: <id> } if it is.
+          # Planning mode is triggered by a "plan" or "planning" tag on the card.
+          def detect_planning_mode(text:, tags:, card_internal_id:, card_number:)
+            tag_names = (tags || []).map { |t| t.is_a?(Hash) ? t["name"] : t.to_s }.map(&:downcase)
+            return nil unless tag_names.include?("plan") || tag_names.include?("planning")
+
+            { card_id: card_number || card_internal_id }
+          end
+
           private
 
           def detect_branch_from_comment(body, card_number)

data/lib/brainiac/plugins/fizzy/metadata.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# Lightweight metadata for brainiac-fizzy.
+# Loaded by `brainiac help` without pulling in the full plugin runtime.
+
+require_relative "version"
+
+module Brainiac
+  module Plugins
+    module Fizzy
+      # Returns true if Fizzy has at least one board configured.
+      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
+
+      # Help text shown in `brainiac help` when the plugin is installed.
+      def self.help_text
+        "    brainiac fizzy <command>      Manage Fizzy boards"
+      end
+    end
+  end
+end

data/lib/brainiac/plugins/fizzy/version.rb

@@ -3,7 +3,7 @@
 module Brainiac
   module Plugins
     module Fizzy
-      VERSION = "0.0.1"
+      VERSION = "0.0.3"
     end
   end
 end

data/lib/brainiac/plugins/fizzy.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "fizzy/version"
+require_relative "fizzy/metadata"
 require_relative "fizzy/config"
 require_relative "fizzy/helpers"
 require_relative "fizzy/prompts"
@@ -171,20 +172,6 @@ module Brainiac
           end
         end
 
-        def dispatch_webhook_action(action, payload)
-          case action
-          when "card_assigned"
-            handle_card_assigned(payload)
-          when "comment_created"
-            handle_comment(payload)
-          when "card_published", "card_triaged"
-            Brainiac::Plugins::Fizzy.handle_publish_or_triage(action, payload)
-          else
-            LOG.info "[Fizzy] Ignoring unknown action: #{action}"
-            [200, { status: "ignored", action: action }.to_json]
-          end
-        end
-
         public
 
         def handle_publish_or_triage(action, payload)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainiac-fizzy
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Andy Davis
@@ -89,6 +89,7 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/brainiac/plugins/fizzy.rb
+- lib/brainiac/plugins/fizzy/cli.rb
 - lib/brainiac/plugins/fizzy/config.rb
 - lib/brainiac/plugins/fizzy/delegators.rb
 - lib/brainiac/plugins/fizzy/handlers/assignment.rb
@@ -99,6 +100,7 @@ files:
 - lib/brainiac/plugins/fizzy/handlers/deployments.rb
 - lib/brainiac/plugins/fizzy/helpers.rb
 - lib/brainiac/plugins/fizzy/hooks.rb
+- lib/brainiac/plugins/fizzy/metadata.rb
 - lib/brainiac/plugins/fizzy/planning.rb
 - lib/brainiac/plugins/fizzy/prompts.rb
 - lib/brainiac/plugins/fizzy/version.rb