brainiac-fizzy 0.0.29 → 0.0.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93dfc73c8a3984f834883fbc59057446f220cf640ef14feecdc3882eab0f5e79
-  data.tar.gz: 16dccf767e981ab8b7ec4f4c9ad570a6af713fe9deb410f0e3163f8745def891
+  metadata.gz: 99e73a13d858f22832a0b44acfd689e902e3e35dfc416e891792610f13b42d9f
+  data.tar.gz: bfc325433038c58471ebe821c9a27b5554e1c73aa3da8f6974813a9af5769233
 SHA512:
-  metadata.gz: dfabf4b7239f9fa9181fb327c24660e7c39c0a1558151362330ff67c8c334ba9565239e5da35c1335c67bd5dfdd246cacf8295509e6e61c86b9afb0f2f6be43d
-  data.tar.gz: ebafbeceb274b07e70f23f69d8b7123af573d646e58d92eb756b693bf2cf4d87a12ab7fc79ddca3ced785c54d3beca9c8c602a4c655d0158067cc952d441a90f
+  metadata.gz: 69e3d38e6aba9c10c394c2606020981c414a20bdf766712d07faed4ef2c33012cb1f87abd4b60bc6699c5879bd6cefdc555215dcab6af593e7917e6dfa4f1f62
+  data.tar.gz: 76c41f2d36849f4226dfb33a1cbf501f223551fccc1831b9baa9eeef7ff2f03ff2020dbb66b07ce4190430c50448981b1c659e9ec51ba38db388dc7f47ba6b8c

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

@@ -27,6 +27,8 @@ module Brainiac
               cmd_setup
             when "board"
               cmd_board(args)
+            when "env"
+              cmd_env(args)
             else
               print_help
             end
@@ -126,6 +128,66 @@ module Brainiac
             end
           end
 
+          # --- ephemeral env management ---
+
+          # `brainiac fizzy env setup <card_number>`
+          #
+          # Manually set up (or refresh tracking for) an ephemeral Belt env for a
+          # card that was already worked — no agent, no tokens. Once tracked, PR
+          # updates auto-redeploy it via brainiac-github.
+          def cmd_env(args)
+            sub = args.shift
+            case sub
+            when "setup", "add"
+              env_setup(args)
+            else
+              puts "Usage: brainiac fizzy env setup <card_number>"
+              puts ""
+              puts "Commands:"
+              puts "  setup <card_number>   Configure + deploy an ephemeral Belt env for a"
+              puts "                        card that was already worked (no agent dispatch)."
+            end
+          end
+
+          def env_setup(args)
+            card_number = args.shift
+            if card_number.nil? || card_number.strip.empty?
+              puts "Usage: brainiac fizzy env setup <card_number>"
+              return
+            end
+
+            require "net/http"
+            require "uri"
+
+            server_url = detect_server_url
+            uri = URI("#{server_url}/api/fizzy/ephemeral-env/#{card_number}")
+
+            puts "Setting up ephemeral env for card ##{card_number} (no agent)..."
+            begin
+              http = Net::HTTP.new(uri.host, uri.port)
+              http.read_timeout = 600 # belt deploy can be slow
+              response = http.post(uri.path, "")
+              data = begin
+                JSON.parse(response.body)
+              rescue StandardError
+                {}
+              end
+
+              if response.is_a?(Net::HTTPSuccess) && data["status"] == "ok"
+                puts "✓ Ephemeral env '#{data["env"]}' ready#{" (was already configured)" if data["already_configured"]}"
+                puts "  Worktree: #{data["worktree"]}" if data["worktree"]
+                puts "  URL:      #{data["url"]}" if data["url"]
+                puts ""
+                puts "Tracked in ephemeral_envs.json — PR updates will auto-redeploy it."
+              else
+                puts "✗ Failed: #{data["reason"] || response.message}"
+              end
+            rescue StandardError => e
+              puts "Could not reach server at #{server_url}: #{e.message}"
+              puts "Is the server running? Check with: brainiac status"
+            end
+          end
+
           # --- board setup (split into phases) ---
 
           def board_setup
@@ -629,6 +691,7 @@ module Brainiac
                 board list                          List configured boards and their columns
                 board assign <project> <board_key>  Assign a project to a board
                 board columns <board_key>           Refresh columns for a board from Fizzy
+                env setup <card_number>             Set up an ephemeral Belt env for an already-worked card (no agent)
 
               Fizzy handles card assignment, comments, @mentions, cross-agent reviews,
               duplicate detection, and planning mode via webhooks.
@@ -662,11 +725,13 @@ module Brainiac
       # When called with args (the words typed so far after the plugin name),
       # returns context-sensitive completions for nested subcommands.
       def self.completions(args = [])
-        return %w[board config setup status] if args.empty?
+        return %w[board config env setup status] if args.empty?
 
         case args[0]
         when "board"
           board_completions(args[1..])
+        when "env"
+          args.length <= 1 ? %w[setup add] : []
         else
           []
         end

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

@@ -49,6 +49,9 @@ def handle_card_assigned(payload, board_key: nil)
   initial_cli = detect_cli_provider(tags: tags)
   initial_model = detect_model(project_config, tags: tags)
   initial_effort = detect_effort(project_config, tags: tags)
+  # Profile ([profile:X]/[p:X]) can be specified inline in the card title.
+  # It's a named env bundle (e.g. an alternate kiro-cli account) — see core profiles.rb.
+  initial_profile = parse_inline_tags(title.to_s)[:profile]
 
   # Persist initial overrides from card tags to the work item
   resolve_work_item_overrides(
@@ -66,7 +69,7 @@ def handle_card_assigned(payload, board_key: nil)
     card_number: card_number, card_internal_id: card_internal_id, title: title, tags: tags,
     branch: branch, worktree_path: worktree_path, project_config: project_config, project_key: project_key,
     agent_name: assigned_agent, model: initial_model,
-    effort: initial_effort, cli_provider_override: initial_cli, board_key: board_key
+    effort: initial_effort, cli_provider_override: initial_cli, profile: initial_profile, board_key: board_key
   )
 end
 
@@ -136,7 +139,8 @@ def setup_assigned_worktree(repo_path, branch, card_internal_id, card_number, pr
 end
 
 def dispatch_assigned_card(card_number:, card_internal_id:, title:, tags:, branch:, worktree_path:,
-                           project_config:, project_key:, agent_name:, model:, effort:, cli_provider_override:, board_key: nil)
+                           project_config:, project_key:, agent_name:, model:, effort:, cli_provider_override:,
+                           profile: nil, board_key: nil)
   card_context = prefetch_card_context(card_number, repo_path: project_config["repo_path"], agent_name: agent_name)
   planning_info = detect_planning_mode(text: title, tags: tags, card_internal_id: card_internal_id, card_number: card_number)
 
@@ -180,7 +184,7 @@ def dispatch_assigned_card(card_number:, card_internal_id:, title:, tags:, branc
                             log_name: "assigned-#{card_number}", model: model, effort: effort,
                             agent_name: agent_name, card_number: card_number, source: :fizzy,
                             source_context: { card_number: card_number, board_key: board_key, dispatched_at: Time.now },
-                            cli_provider: cli_provider_override, env: agent_github_env)
+                            cli_provider: cli_provider_override, profile: profile, env: agent_github_env)
   register_session(card_key, pid, log_file: log_file, supersede_key: card_key, agent_name: agent_name)
 
   Thread.new { move_card_to_column(card_number, "right_now", project_config: project_config, agent_name: agent_name, board_key: board_key) }
@@ -194,8 +198,13 @@ end
 #
 # `belt g environment` is synchronous so the worktree is configured before the
 # agent starts. The actual `belt deploy` runs in the background.
+#
+# When `force: true`, the `deploy` tag requirement is bypassed — the caller is
+# explicitly requesting env setup (e.g. the `brainiac fizzy env setup` CLI or
+# the `/api/fizzy/ephemeral-env/:card` endpoint), so no tag is needed.
 def maybe_create_ephemeral_belt_env(worktree_path:, card_number:, project_key:, tags: nil,
-                                    repo_path: nil, agent_name: nil, fetch_live_tags: false)
+                                    repo_path: nil, agent_name: nil, fetch_live_tags: false,
+                                    force: false)
   unless defined?(BeltConfig) && defined?(BeltEnvironment)
     LOG.debug "[EphemeralEnv] Belt utilities not available — skipping"
     return
@@ -216,14 +225,16 @@ def maybe_create_ephemeral_belt_env(worktree_path:, card_number:, project_key:,
     return
   end
 
-  resolved_tags = resolve_ephemeral_env_tags(
-    tags, card_number: card_number, repo_path: repo_path || worktree_path,
-          agent_name: agent_name, fetch_live_tags: fetch_live_tags
-  )
-  tag_list = tag_names(resolved_tags)
-  unless tag_list.include?("deploy")
-    LOG.debug "[EphemeralEnv] Card ##{card_number} tags=#{tag_list.inspect} — no deploy tag, skipping"
-    return
+  unless force
+    resolved_tags = resolve_ephemeral_env_tags(
+      tags, card_number: card_number, repo_path: repo_path || worktree_path,
+            agent_name: agent_name, fetch_live_tags: fetch_live_tags
+    )
+    tag_list = tag_names(resolved_tags)
+    unless tag_list.include?("deploy")
+      LOG.debug "[EphemeralEnv] Card ##{card_number} tags=#{tag_list.inspect} — no deploy tag, skipping"
+      return
+    end
   end
 
   parent_env = BeltConfig.parent_env_for(project_key)
@@ -266,6 +277,71 @@ def ensure_ephemeral_env_for_comment(ctx, card_number, worktree)
   )
 end
 
+# Manually set up an ephemeral Belt env for a card that was already worked,
+# without dispatching an agent. Resolves the card's existing worktree from the
+# work item map, configures + deploys the env synchronously, and tracks it in
+# ephemeral_envs.json so PR-update auto-redeploys (brainiac-github) work.
+#
+# Bypasses the `deploy` tag requirement (force: true) — the caller is asking
+# for this explicitly. Returns a result hash suitable for a JSON API response.
+#
+# @param card_number [Integer, String] Fizzy card number
+# @return [Hash] { status:, env:, url:, worktree:, reason: }
+def setup_ephemeral_env_for_card(card_number)
+  return { status: "error", reason: "card_number required" } unless card_number
+
+  return { status: "error", reason: "Belt utilities not available" } unless defined?(BeltConfig) && defined?(BeltEnvironment)
+
+  card_number = card_number.to_s
+  entry = work_item_entry_for_card(card_number)
+  return { status: "error", reason: "no work item found for card ##{card_number}" } unless entry
+
+  worktree = entry["worktree"]
+  project_key = entry["project"]
+  return { status: "error", reason: "worktree missing for card ##{card_number} (#{worktree.inspect})" } unless worktree && File.directory?(worktree)
+
+  env_name = BeltConfig.ephemeral_env_for_card(card_number)
+  already = BeltEnvironment.environment_configured?(worktree: worktree, env_name: env_name)
+
+  maybe_create_ephemeral_belt_env(
+    worktree_path: worktree, card_number: card_number,
+    project_key: project_key, force: true
+  )
+
+  # After setup, resolve the public URL the same way deployment lookups do.
+  url = defined?(deployment_url_for_card) ? (deployment_url_for_card(card_number) || {})[:url] : nil
+
+  {
+    status: "ok",
+    env: env_name,
+    url: url,
+    worktree: worktree,
+    already_configured: already
+  }
+rescue StandardError => e
+  LOG.error "[EphemeralEnv] Manual setup failed for card ##{card_number}: #{e.message}"
+  { status: "error", reason: e.message }
+end
+
+# Resolve the work item entry for a Fizzy card number from work_items.json.
+# Returns a flattened hash with worktree/branch/project or nil.
+def work_item_entry_for_card(card_number)
+  map = load_work_item_map
+  match = map.values.find do |entry|
+    entry.dig("sources", "fizzy", "card_number").to_s == card_number.to_s
+  end
+  return nil unless match
+
+  {
+    "worktree" => match["worktree"],
+    "branch" => match["branch"],
+    "project" => match["project"]
+  }
+rescue StandardError => e
+  LOG.error "[EphemeralEnv] Could not load work item for card ##{card_number}: #{e.message}" if defined?(LOG)
+  nil
+end
+
 def belt_app_for_ephemeral?(worktree_path)
   return BeltEnvironment.belt_app?(worktree_path) if defined?(BeltEnvironment) && BeltEnvironment.respond_to?(:belt_app?)
 

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

@@ -18,7 +18,7 @@ CommentContext = Struct.new(
   :project_config, :project_key, :card_number, :worktree,
   :model, :effort, :deploy_intent, :cli_provider_override,
   :comment_vars, :card_tags, :worktree_override, :fresh,
-  :board_key,
+  :board_key, :profile,
   keyword_init: true
 )
 
@@ -146,6 +146,7 @@ def build_comment_context(eventable:, plain_text:, tags:, card_internal_id:, car
     card_tags: card_tags,
     worktree_override: resolve_worktree_override(tags, project_config),
     fresh: tags[:fresh],
+    profile: tags[:profile],
     comment_vars: {
       "COMMENT_CREATOR" => creator_name || "Unknown",
       "COMMENT_ID" => comment_id.to_s,
@@ -411,7 +412,7 @@ def dispatch_cross_agent_review(ctx, card_key:, card_number:, card_assigned_agen
                             model: ctx.model, effort: ctx.effort, agent_name: ctx.agent_name,
                             card_number: card_number, comment_id: ctx.comment_id,
                             source: :fizzy, source_context: { card_number: card_number, dispatched_at: Time.now },
-                            cli_provider: ctx.cli_provider_override)
+                            cli_provider: ctx.cli_provider_override, profile: ctx.profile)
   return [200, { status: "dispatch_failed", 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)
@@ -525,6 +526,7 @@ def dispatch_new_mention(ctx, card_key:, card_number:, card_title:, branch:, wor
                             model: ctx.model, effort: ctx.effort, agent_name: ctx.agent_name,
                             card_number: card_number, comment_id: ctx.comment_id,
                             source: :fizzy, cli_provider: ctx.cli_provider_override,
+                            profile: ctx.profile,
                             source_context: { card_number: card_number, dispatched_at: Time.now })
   return [200, { status: "dispatch_failed", agent: ctx.agent_name, card: card_number }.to_json] unless pid
 
@@ -563,6 +565,7 @@ def dispatch_followup_comment(ctx, card_key:, card_number:, work_dir:)
                             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: should_resume,
+                            profile: ctx.profile,
                             source_context: {
                               card_number: card_number, card_internal_id: ctx.card_internal_id,
                               deploy_intent: ctx.deploy_intent, board_key: ctx.board_key, dispatched_at: Time.now

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

@@ -3,7 +3,7 @@
 module Brainiac
   module Plugins
     module Fizzy
-      VERSION = "0.0.29"
+      VERSION = "0.0.31"
     end
   end
 end

data/lib/brainiac/plugins/fizzy.rb

@@ -116,6 +116,21 @@ module Brainiac
             end
           end
 
+          # Manually set up an ephemeral Belt env for a card that was already
+          # worked — no agent dispatch, no tokens. Configures + deploys the env
+          # in the card's existing worktree and tracks it so PR-update
+          # auto-redeploys keep it fresh.
+          app.post "/api/fizzy/ephemeral-env/:card" do
+            content_type :json
+            card_number = params["card"]
+            result = setup_ephemeral_env_for_card(card_number)
+            if result[:status] == "ok"
+              result.to_json
+            else
+              halt 422, result.to_json
+            end
+          end
+
           # Deployment API routes (if deployments are configured)
           return unless defined?(DEPLOYMENTS_CONFIG)
 

metadata

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