brainiac-fizzy 0.0.7 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 217c9ec16a0eb73260514086be2a7b686e8471cfd0c81c11e95d240a0a5eafa9
-  data.tar.gz: 713ae82ad6dd28c9abc7c8e7cb588e32722d1dced7d6de39f9b30b0cea72003f
+  metadata.gz: d3d24ce3986d1b5353dca763a8ba29060ecd2dce47065cc2ffdd201d4075ca66
+  data.tar.gz: 6f39b2c02369556d1b7914c7a37eebcb98eccf016944ed2ea34bba6dac94ebc4
 SHA512:
-  metadata.gz: a0fb9fc74bb8b6ee408ffcb5f65c6123cf5b4b3e50a761bde58bc7a6aafb4b64496c3cb00f98580fe248afd261b3822aae4d064d44452909f3f2ac011d378f29
-  data.tar.gz: 93307161001d597b62991ffbd6850bf76883227d93a1844740ade3b55168aafbed71a1e9d5a4918e5673c1ab456dcbe903c41a5209bab53b588726f018c3cdee
+  metadata.gz: b417b22c6c7150d3cf823225141d00ae41d94d3f2a6e6c3eb736f4db2ea122ce33b46a0c5d237e4315cf29f415b82b31fa58085a1a48e83177288314bdc8df11
+  data.tar.gz: 61d02c8a206ecd4c0e3c9680b3f8856914c30b45a16d9a7507b6118c980c0765fa24e96e4018bbb3793dd357e84de99ee39551b3724c7dba421927b8b679b89e

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

@@ -25,6 +25,10 @@ def prefetch_card_context(card_number, repo_path:, agent_name: nil)
   Brainiac::Plugins::Fizzy::Helpers.prefetch_card_context(card_number, repo_path: repo_path, agent_name: agent_name)
 end
 
+def fetch_intent_context(card_number, repo_path:, agent_name: nil)
+  Brainiac::Plugins::Fizzy::Helpers.fetch_intent_context(card_number, repo_path: repo_path, agent_name: agent_name)
+end
+
 def move_card_to_column(card_number, column_name, project_config:, agent_name: nil)
   Brainiac::Plugins::Fizzy::Helpers.move_card_to_column(card_number, column_name, project_config: project_config, agent_name: agent_name)
 end
@@ -46,6 +50,18 @@ def detect_planning_mode(text:, tags:, card_internal_id:, card_number:)
                                                          card_internal_id: card_internal_id, card_number: card_number)
 end
 
+def lookup_fizzy_card_info(card_internal_id)
+  Brainiac::Plugins::Fizzy::Helpers.lookup_fizzy_card_info(card_internal_id)
+end
+
+def update_fizzy_work_item(card_internal_id, updates)
+  Brainiac::Plugins::Fizzy::Helpers.update_fizzy_work_item(card_internal_id, updates)
+end
+
+def resolve_card_number(internal_id, repo_path:)
+  Brainiac::Plugins::Fizzy::Helpers.resolve_card_number(internal_id, repo_path: repo_path)
+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

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

@@ -103,12 +103,10 @@ def setup_assigned_worktree(repo_path, branch, card_internal_id, card_number, pr
   worktree_path = File.join(File.dirname(repo_path), "#{File.basename(repo_path)}--#{branch}")
   worktree_path = create_or_reuse_worktree(repo_path: repo_path, branch: branch, worktree_path: worktree_path)
 
-  map = load_work_item_map
-  map[card_internal_id] = {
-    "number" => card_number, "branch" => branch, "worktree" => worktree_path,
-    "project" => project_key, "agent" => agent_name
-  }
-  save_work_item_map(map)
+  register_work_item(
+    branch: branch, worktree: worktree_path, project: project_key, agent: agent_name,
+    source: :fizzy, source_data: { "card_internal_id" => card_internal_id, "card_number" => card_number }
+  )
   worktree_path
 end
 

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

@@ -41,11 +41,9 @@ def handle_comment(payload)
   agent_result = validate_agent_comment(creator_is_agent, is_api_sourced, creator_name, mentioned_agent, card_internal_id)
   return agent_result if agent_result
 
-  card_info = load_work_item_map[card_internal_id]
+  card_info = lookup_fizzy_card_info(card_internal_id)
   comment_id = eventable["id"]
 
-  return [200, { status: "ignored", reason: "not relevant" }.to_json] unless mentioned_agent || card_info
-
   project_config, project_key = resolve_fizzy_project(card_info, card_internal_id, eventable)
   return [200, { status: "ignored", reason: "no matching project" }.to_json] unless project_config
 
@@ -158,7 +156,7 @@ end
 def validate_agent_comment(creator_is_agent, is_api_sourced, creator_name, mentioned_agent, card_internal_id)
   return nil unless creator_is_agent || is_api_sourced
 
-  card_info = load_work_item_map[card_internal_id]
+  card_info = lookup_fizzy_card_info(card_internal_id)
   card_assigned_agent = card_info&.dig("agent")
 
   agent_is_assigned = card_assigned_agent && card_assigned_agent.downcase == (creator_name || "").downcase
@@ -207,7 +205,8 @@ end
 
 def handle_cancel_command(eventable, card_internal_id)
   killed = 0
-  card_number_for_cancel = load_work_item_map.dig(card_internal_id, "number")
+  cancel_card_info = lookup_fizzy_card_info(card_internal_id)
+  card_number_for_cancel = cancel_card_info&.dig("number")
   prefixes = ["card-#{card_internal_id}"]
   prefixes << "card-#{card_number_for_cancel}" if card_number_for_cancel
 
@@ -229,9 +228,8 @@ def handle_cancel_command(eventable, card_internal_id)
   end
 
   comment_id_for_cancel = eventable["id"]
-  card_info_for_cancel = load_work_item_map[card_internal_id]
-  if card_info_for_cancel && card_number_for_cancel && comment_id_for_cancel
-    repo = (card_info_for_cancel["project"] && PROJECTS.dig(card_info_for_cancel["project"], "repo_path")) ||
+  if cancel_card_info && card_number_for_cancel && comment_id_for_cancel
+    repo = (cancel_card_info["project"] && PROJECTS.dig(cancel_card_info["project"], "repo_path")) ||
            DEFAULT_PROJECT["repo_path"]
     Thread.new do
       run_cmd("fizzy", "reaction", "create", "--card", card_number_for_cancel.to_s,
@@ -257,9 +255,7 @@ def resolve_fizzy_project(card_info, card_internal_id, eventable)
       if project_result
         project_key, project_config = project_result
         card_info["project"] = project_key
-        map = load_work_item_map
-        map[card_internal_id] = card_info
-        save_work_item_map(map)
+        update_fizzy_work_item(card_internal_id, "project" => project_key)
         LOG.info "Backfilled project '#{project_key}' for card #{card_internal_id} in card map"
       else
         LOG.warn "No project found for card #{card_internal_id}"
@@ -305,21 +301,23 @@ def resolve_assigned_agent(card_info, card_internal_id, eventable, project_confi
   card_assignees = eventable.dig("card", "assignees") || []
   webhook_agent = card_assignees.map { |a| a["name"] }.find { |name| local_agent_names.include?(name) }
 
-  webhook_agent = resolve_agent_via_api(card_info, card_internal_id, project_config) if webhook_agent.nil? && project_config
+  webhook_agent = resolve_agent_via_api(card_info, card_internal_id, eventable, project_config) if webhook_agent.nil? && project_config
 
   return nil unless webhook_agent
 
-  map = load_work_item_map
-  map[card_internal_id] ||= {}
-  map[card_internal_id]["agent"] = webhook_agent
-  save_work_item_map(map)
+  card_number = eventable.dig("card", "number")
+  update_fizzy_work_item(card_internal_id, { "agent" => webhook_agent }.tap { |h| h["number"] = card_number if card_number })
   LOG.info "Backfilled agent '#{webhook_agent}' into card map for #{card_internal_id}"
   webhook_agent
 end
 
-def resolve_agent_via_api(card_info, card_internal_id, project_config)
-  api_card_number = card_info&.dig("number") || card_internal_id
-  return nil unless api_card_number
+def resolve_agent_via_api(card_info, card_internal_id, eventable, project_config)
+  api_card_number = card_info&.dig("number") || eventable.dig("card", "number")
+  api_card_number ||= resolve_card_number(card_internal_id, repo_path: project_config["repo_path"])
+  unless api_card_number
+    LOG.warn "Cannot resolve agent via API — no card number available (internal_id: #{card_internal_id})"
+    return nil
+  end
 
   output = run_cmd("fizzy", "card", "show", api_card_number.to_s,
                    chdir: project_config["repo_path"], env: default_fizzy_env)
@@ -364,6 +362,7 @@ def dispatch_cross_agent_review(ctx, card_key:, card_number:, card_assigned_agen
   review_worktree_path, review_branch = setup_cross_agent_worktree(ctx, card_number)
   prompt = build_cross_agent_prompt(ctx, card_number, card_assigned_agent, review_worktree_path, review_branch)
 
+  intent_ctx = fetch_intent_context(card_number, repo_path: ctx.project_config["repo_path"], agent_name: ctx.agent_name)
   pid, log_file = run_agent(prompt,
                             project_config: ctx.project_config, chdir: review_worktree_path,
                             log_name: "review-#{ctx.agent_name.downcase}-#{card_number || ctx.card_internal_id}",
@@ -371,7 +370,8 @@ def dispatch_cross_agent_review(ctx, card_key:, card_number:, card_assigned_agen
                             card_number: card_number, comment_id: ctx.comment_id,
                             source: :fizzy, source_context: { card_number: card_number },
                             cli_provider: ctx.cli_provider_override,
-                            message: ctx.plain_text, channel: "Fizzy comment")
+                            message: ctx.plain_text, channel: "Fizzy comment",
+                            context: intent_ctx)
   return [200, { status: "intent_skip", agent: ctx.agent_name, card: card_number }.to_json] unless pid
 
   register_session(card_key, pid, log_file: log_file, supersede_key: card_key, agent_name: ctx.agent_name)
@@ -433,7 +433,7 @@ def handle_new_mention(ctx)
   card_title = card_data["title"] || "exploration"
 
   if card_number.nil?
-    map_entry = load_work_item_map[ctx.card_internal_id]
+    map_entry = lookup_fizzy_card_info(ctx.card_internal_id)
     card_number = if map_entry && map_entry["number"]
                     map_entry["number"]
                   else
@@ -459,12 +459,10 @@ def setup_new_mention_worktree(ctx, card_number, card_title)
   repo_path = ctx.project_config["repo_path"]
   worktree_path, branch = resolve_or_create_worktree(ctx, card_number, card_title, repo_path)
 
-  map = load_work_item_map
-  map[ctx.card_internal_id] = {
-    "number" => card_number, "branch" => branch, "worktree" => worktree_path,
-    "project" => ctx.project_key, "agent" => ctx.agent_name
-  }
-  save_work_item_map(map)
+  register_work_item(
+    branch: branch, worktree: worktree_path, project: ctx.project_key, agent: ctx.agent_name,
+    source: :fizzy, source_data: { "card_internal_id" => ctx.card_internal_id, "card_number" => card_number }
+  )
 
   [worktree_path, branch]
 end
@@ -472,6 +470,7 @@ end
 def dispatch_new_mention(ctx, card_key:, card_number:, card_title:, branch:, worktree_path:)
   prompt = build_mention_prompt(ctx, card_number, card_title, branch, worktree_path)
 
+  intent_ctx = fetch_intent_context(card_number, repo_path: ctx.project_config["repo_path"], agent_name: ctx.agent_name)
   pid, log_file = run_agent(prompt,
                             project_config: ctx.project_config, chdir: worktree_path,
                             log_name: "mention-#{card_number || ctx.card_internal_id}",
@@ -479,7 +478,8 @@ def dispatch_new_mention(ctx, card_key:, card_number:, card_title:, branch:, wor
                             card_number: card_number, comment_id: ctx.comment_id,
                             source: :fizzy, cli_provider: ctx.cli_provider_override,
                             source_context: { card_number: card_number },
-                            message: ctx.plain_text, channel: "Fizzy comment")
+                            message: ctx.plain_text, channel: "Fizzy comment",
+                            context: intent_ctx)
   return [200, { status: "intent_skip", agent: ctx.agent_name, card: card_number }.to_json] unless pid
 
   register_session(card_key, pid, log_file: log_file, supersede_key: card_key, agent_name: ctx.agent_name)
@@ -509,6 +509,7 @@ def dispatch_followup_comment(ctx, card_key:, card_number:, work_dir:)
              build_followup_prompt(ctx, card_number, card_tags, work_dir)
            end
 
+  intent_ctx = fetch_intent_context(card_number, repo_path: ctx.project_config["repo_path"], agent_name: ctx.agent_name)
   pid, log_file = run_agent(prompt,
                             project_config: ctx.project_config, chdir: work_dir,
                             log_name: "followup-#{card_number || ctx.card_internal_id}",
@@ -519,7 +520,8 @@ def dispatch_followup_comment(ctx, card_key:, card_number:, work_dir:)
                               card_number: card_number, card_internal_id: ctx.card_internal_id,
                               deploy_intent: ctx.deploy_intent
                             },
-                            message: ctx.plain_text, channel: "Fizzy comment")
+                            message: ctx.plain_text, channel: "Fizzy comment",
+                            context: intent_ctx)
   return [200, { status: "intent_skip", agent: ctx.agent_name, card: card_number }.to_json] unless pid
 
   register_session(card_key, pid, log_file: log_file, supersede_key: card_key, agent_name: ctx.agent_name)
@@ -561,12 +563,7 @@ end
 
 def resolve_and_save_card_number(card_internal_id, project_config)
   card_number = resolve_card_number(card_internal_id, repo_path: project_config["repo_path"])
-  if card_number
-    map = load_work_item_map
-    map[card_internal_id] ||= {}
-    map[card_internal_id]["number"] = card_number
-    save_work_item_map(map)
-  end
+  update_fizzy_work_item(card_internal_id, "number" => card_number) if card_number
   card_number
 end
 
@@ -574,10 +571,7 @@ def find_and_save_worktree(card_internal_id, card_number, project_config)
   found = find_worktree_for_card(card_number, repo_path: project_config["repo_path"])
   return nil unless found
 
-  map = load_work_item_map
-  map[card_internal_id] ||= {}
-  map[card_internal_id].merge!("worktree" => found[:worktree], "branch" => found[:branch])
-  save_work_item_map(map)
+  update_fizzy_work_item(card_internal_id, "worktree" => found[:worktree], "branch" => found[:branch])
   LOG.info "Found worktree by card number scan: #{found[:worktree]}"
   found[:worktree]
 end
@@ -649,7 +643,7 @@ end
 
 def resolve_or_create_worktree(ctx, card_number, card_title, repo_path)
   # Check for existing worktree in card map or on disk
-  existing_map_entry = load_work_item_map[ctx.card_internal_id]
+  existing_map_entry = lookup_fizzy_card_info(ctx.card_internal_id)
   if existing_map_entry && existing_map_entry["branch"] && existing_map_entry["worktree"] &&
      File.directory?(existing_map_entry["worktree"])
     LOG.info "Reusing existing worktree from card map: #{existing_map_entry["worktree"]}"

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

@@ -7,7 +7,7 @@
 
 def handle_deploy_comment(eventable, env_key, card_internal_id)
   comment_id = eventable["id"]
-  card_info = load_card_map[card_internal_id]
+  card_info = lookup_fizzy_card_info(card_internal_id)
 
   # Validate environment exists
   deploy_config = DEPLOYMENTS_CONFIG["environments"] || {}
@@ -139,10 +139,9 @@ def clone_branch_for_deploy(eventable, card_internal_id, card_info)
   end
 
   # Update card map
-  map = load_card_map
-  map[card_internal_id] ||= {}
-  map[card_internal_id].merge!("number" => card_number, "branch" => branch, "worktree" => worktree_path, "project" => project_key)
-  save_card_map(map)
+  update_fizzy_work_item(card_internal_id,
+                         "number" => card_number, "branch" => branch,
+                         "worktree" => worktree_path, "project" => project_key)
 
   LOG.info "[Deploy] Cloned branch #{branch} into worktree #{worktree_path} for card ##{card_number}"
   { worktree: worktree_path, card_number: card_number }

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

@@ -73,6 +73,25 @@ module Brainiac
             ""
           end
 
+          # Lightweight recent comment context for intent classification.
+          # Returns a simple "author: message" format (last 5 comments).
+          def fetch_intent_context(card_number, repo_path:, agent_name: nil)
+            env = fizzy_env_for(agent_name || AI_AGENT_NAME)
+            output = run_cmd("fizzy", "comment", "list", "--card", card_number.to_s, chdir: repo_path, env: env)
+            comments = JSON.parse(output)["data"] || []
+            return nil if comments.empty?
+
+            comments.last(5).map do |c|
+              creator = c["creator_name"] || "unknown"
+              body = (c.dig("body", "plain_text") || "").lines.first(3).join.strip
+              body = "#{body[0..200]}..." if body.length > 200
+              "#{creator}: #{body}"
+            end.join("\n")
+          rescue StandardError => e
+            LOG.warn "[Fizzy] Could not fetch intent context for card ##{card_number}: #{e.message}" if defined?(LOG)
+            nil
+          end
+
           def move_card_to_column(card_number, column_name, project_config:, agent_name: nil)
             board_key = Config.board_key_for_project(project_config)
             column_id = Config.board_column_id(board_key, column_name) if board_key
@@ -149,6 +168,91 @@ module Brainiac
             { card_id: card_number || card_internal_id }
           end
 
+          # Look up a Fizzy card's work item info by its internal ID.
+          # Returns a hash with top-level "number", "agent", "branch", "worktree", "project"
+          # keys for backward compatibility with handler code, or nil if not found.
+          def lookup_fizzy_card_info(card_internal_id)
+            return nil unless card_internal_id
+
+            result = find_work_item_by_card(card_internal_id)
+            return nil unless result
+
+            _work_item_id, info = result
+            # Ensure "number" is at top level for fizzy handler compat
+            info["number"] ||= info.dig("sources", "fizzy", "card_number")
+            info
+          end
+
+          # Update or create a work item entry for a Fizzy card.
+          # Accepts a hash of fields to merge into the existing entry.
+          # Handles both new-format (wi-xxx keyed) and creates new entries properly.
+          def update_fizzy_work_item(card_internal_id, updates)
+            return unless card_internal_id
+
+            map = load_work_item_map
+            result = nil
+            work_item_id = nil
+
+            # Find existing entry by card internal ID
+            map.each do |wid, info|
+              next unless info.is_a?(Hash)
+
+              fizzy_source = info.dig("sources", "fizzy")
+              next unless fizzy_source && fizzy_source["card_internal_id"] == card_internal_id
+
+              work_item_id = wid
+              result = info
+              break
+            end
+
+            card_number = updates.delete("number")
+
+            if result
+              result["sources"]["fizzy"]["card_number"] = card_number if card_number
+              result.merge!(updates)
+              map[work_item_id] = result
+            else
+              new_id = generate_work_item_id(branch: updates["branch"], card_number: card_number)
+              map[new_id] = {
+                "id" => new_id,
+                "branch" => updates["branch"],
+                "worktree" => updates["worktree"],
+                "project" => updates["project"],
+                "agent" => updates["agent"],
+                "sources" => {
+                  "fizzy" => {
+                    "card_internal_id" => card_internal_id,
+                    "card_number" => card_number
+                  }.compact
+                }
+              }.compact.merge(updates.except("branch", "worktree", "project", "agent"))
+            end
+
+            save_work_item_map(map)
+          end
+
+          # Resolve a card number from an internal ID by querying the Fizzy API.
+          # Searches card lists to find the matching card.
+          def resolve_card_number(internal_id, repo_path:)
+            env = default_fizzy_env
+            base_cmd = %w[fizzy card list]
+            ["--all", "--all --indexed-by closed"].each do |flags|
+              cmd = base_cmd + flags.split
+              output = run_cmd(*cmd, chdir: repo_path, env: env)
+              data = JSON.parse(output)["data"] || []
+              match = data.find { |c| c["id"] == internal_id }
+              if match
+                LOG.info "Resolved card number #{match["number"]} for internal_id #{internal_id}" if defined?(LOG)
+                return match["number"]
+              end
+            rescue StandardError
+              next
+            end
+
+            LOG.warn "Could not resolve card number for internal_id #{internal_id}" if defined?(LOG)
+            nil
+          end
+
           private
 
           def detect_branch_from_comment(body, card_number)
@@ -156,9 +260,12 @@ module Brainiac
             match = body.match(%r{<code>(fizzy-#{card_number}-[^<]+)</code>})
             return match[1] if match
 
-            # Fall back to card map
+            # Fall back to card map — check both new and old format
             map = load_work_item_map
-            entry = map.values.find { |v| v["number"].to_s == card_number.to_s }
+            entry = map.values.find do |v|
+              v.dig("sources", "fizzy", "card_number").to_s == card_number.to_s ||
+                v["number"].to_s == card_number.to_s
+            end
             entry&.dig("branch")
           end
 

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

@@ -255,7 +255,10 @@ module Brainiac
               card_number = card["number"]
               next unless card_number
 
-              map_entry = map.values.find { |info| info["number"] == card_number }
+              map_entry = map.values.find do |info|
+                info.dig("sources", "fizzy", "card_number").to_s == card_number.to_s ||
+                  info["number"].to_s == card_number.to_s
+              end
               agent_name = map_entry["agent"] if map_entry
               env = Helpers.fizzy_env_for(agent_name || AI_AGENT_NAME)
 
@@ -267,8 +270,8 @@ module Brainiac
                                                        primary_worktree: map_entry&.dig("worktree"), primary_branch: map_entry&.dig("branch"))
 
               if map_entry
-                internal_id = map.key(map_entry)
-                map.delete(internal_id)
+                work_item_id = map.key(map_entry)
+                map.delete(work_item_id)
               end
 
               closed << { number: card_number, url: card["url"], title: card["title"] }

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

@@ -3,7 +3,7 @@
 module Brainiac
   module Plugins
     module Fizzy
-      VERSION = "0.0.7"
+      VERSION = "0.0.9"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainiac-fizzy
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.9
 platform: ruby
 authors:
 - Andy Davis