brainiac-fizzy 0.0.2 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d61ec1e2e7dda1f0d37c5d584064da809d8314a97e9ad937c1ccc15ac8b7622
-  data.tar.gz: 794c745cb261a297a27c2b26bc7e0d831acf4eb86b56f74244f8f0f35c8b88fd
+  metadata.gz: 52b33b796dafe9d47fe9db8f881537d2d66bda2f54f51f1bafb9dd4a4b188a4c
+  data.tar.gz: '0260149a3b2daa8439049b9369980f1edf73f65226cb07785f7f0c954e74dc66'
 SHA512:
-  metadata.gz: 5a00fdc220e52bfdc4e27fc44472af3c7036f5f60bcaaa49e33239e217a48474d50fbfea3bf36b214d592260d3c06022dd8d7b5c1f1f531b694c1add5267ab4a
-  data.tar.gz: 181d3be9008ff6bea89223d6caed6d76503d3c1aac8517fa26c785f3f99ae9467f0acb2e7b103d1f646b3482f5ec1c0a1013bdb2498a6247010fcdd36cfcb41a
+  metadata.gz: 2fc7f43f8c505d94fc7f4364cb24d33d9aee11d23e6a73033df82e5fd6ad4b4aa496348df42fcac455ba71d75d7d66b3cea76b458f3cb5b0f544682427e5f4a5
+  data.tar.gz: 6bb9c239037adde4e1f371eb7087501ee9233ac32177ca2997aad0a4926b4e9db217d0b06dd49e2384fab3cb4a27de01b7491af32afcf121a536e68e7ab5a773

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

@@ -63,15 +63,22 @@ module Brainiac
           end
 
           def board_key_for_project(project_config)
+            # Priority 1: explicit fizzy_board in project config (board key name from fizzy.json)
+            board_key = project_config["fizzy_board"]
+            return board_key if board_key && @boards.key?(board_key)
+
+            # Priority 2: .fizzy.yaml in the repo directory
             fizzy_yaml = File.join(project_config["repo_path"], ".fizzy.yaml")
-            return nil unless File.exist?(fizzy_yaml)
+            if File.exist?(fizzy_yaml)
+              require "yaml"
+              data = YAML.safe_load_file(fizzy_yaml)
+              board_id = data["board"]
+              return board_key_for_id(board_id)
+            end
 
-            require "yaml"
-            data = YAML.safe_load_file(fizzy_yaml)
-            board_id = data["board"]
-            board_key_for_id(board_id)
+            nil
           rescue StandardError => e
-            LOG.warn "[Fizzy] Could not read .fizzy.yaml: #{e.message}" if defined?(LOG)
+            LOG.warn "[Fizzy] Could not resolve board for project: #{e.message}" if defined?(LOG)
             nil
           end
 

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

@@ -67,28 +67,34 @@ 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))
+    env = fizzy_env_for(agent_name)
+
+    # Best-effort cleanup of existing reactions from this agent
+    begin
+      result = run_cmd("fizzy", "reaction", "list", "--card", card_number.to_s,
+                       chdir: repo_path, env: env)
+      reactions = JSON.parse(result)["data"] || []
+
+      identity_output = run_cmd("fizzy", "identity", "show", chdir: repo_path, env: env)
+      current_user_id = JSON.parse(identity_output).dig("data", "accounts", 0, "user", "id")
+
+      if current_user_id
+        reactions.each do |reaction|
+          if reaction.dig("reacter", "id") == current_user_id
+            run_cmd("fizzy", "reaction", "delete", reaction["id"], "--card", card_number.to_s,
+                    chdir: repo_path, env: env)
+          end
+        end
       end
+    rescue StandardError => e
+      LOG.warn "Could not clean up existing reactions on card ##{card_number}: #{e.message}"
     end
 
-    # Add fresh reaction
+    # Always attempt to add the reaction even if cleanup failed
     run_cmd("fizzy", "reaction", "create", "--card", card_number.to_s,
-            "--content", "👍", chdir: repo_path, env: fizzy_env_for(agent_name))
+            "--content", "👀", chdir: repo_path, env: env)
   rescue StandardError => e
-    LOG.warn "Could not add reaction to card: #{e.message}"
+    LOG.warn "Could not add reaction to card ##{card_number}: #{e.message}"
   end
 end
 

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

@@ -488,10 +488,10 @@ def dispatch_followup_comment(ctx, card_key:, card_number:, work_dir:)
   effort = detect_effort(ctx.project_config, tags: card_tags, text: ctx.plain_text)
 
   is_worktree = work_dir != ctx.project_config["repo_path"]
-  resolved = resolve_project_cli_config(ctx.project_config,
-                                        cli_provider_override: ctx.cli_provider_override,
-                                        agent_name: ctx.agent_name)
-  should_resume = is_worktree && resolved["resume_flag"]
+  should_resume = is_worktree && resume_viable?(
+    project_config: ctx.project_config, cli_provider: ctx.cli_provider_override,
+    agent_name: ctx.agent_name, chdir: work_dir
+  )
 
   prompt = if should_resume
              LOG.info "[Resume] Using lean prompt for follow-up on card #{card_number || ctx.card_internal_id}"
@@ -508,7 +508,7 @@ def dispatch_followup_comment(ctx, card_key:, card_number:, work_dir:)
                             log_name: "followup-#{card_number || ctx.card_internal_id}",
                             model: ctx.model, effort: effort, agent_name: ctx.agent_name,
                             card_number: card_number, comment_id: ctx.comment_id,
-                            source: :fizzy, cli_provider: ctx.cli_provider_override, resume: is_worktree,
+                            source: :fizzy, cli_provider: ctx.cli_provider_override, resume: should_resume,
                             source_context: {
                               card_number: card_number, card_internal_id: ctx.card_internal_id,
                               deploy_intent: ctx.deploy_intent

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/prompts.rb

@@ -71,7 +71,10 @@ module Brainiac
           """
 
           Focus your response on the comment above. If you've already addressed this in a previous session, reply confirming it's done.
-          Otherwise, make the requested changes, commit, push, and update the PR.
+          Otherwise, make the requested changes, commit, and push.
+
+          **Response destination: Post your response as a comment on Fizzy card #{{CARD_NUMBER}}.**
+          Do NOT post comments on the GitHub PR — this conversation is happening on the card.
         PROMPT
 
         FOLLOWUP_NO_WORKTREE = <<~PROMPT

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

@@ -3,7 +3,7 @@
 module Brainiac
   module Plugins
     module Fizzy
-      VERSION = "0.0.2"
+      VERSION = "0.0.5"
     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"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainiac-fizzy
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.5
 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