brainiac 0.0.23 → 0.0.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8bdf84241f89389aef9a1693abd00b1cfdf77d645c096081acb4ea0e8d1de8ed
-  data.tar.gz: 9ed60b3c1ba3fdcdcae4e3b05cfb15fa2a1a60c6311cd8add2c7fa9a3e4e839a
+  metadata.gz: 0a843b412b04f2b176f13e248bcea6327eb27c2893ed516a566c9f79e3b9dbc4
+  data.tar.gz: 0bc50a0db4b6e8d5ea67dbf3de47d8481e94a64d886a378730d4d27da5185403
 SHA512:
-  metadata.gz: 7e5df006c01b492f2e1e9f9918a208b2bcdbdefcf0df032662b12d2f107872f1456ba37200ad70ebd19d3fa218da030a35681249ec4f232af56da4132bc7eef8
-  data.tar.gz: 24cc2728b08071c0ecc4c52bbabedf568446749322e27aad386c5b23395affce9e6b1c16c06feace6ba8487d261dc136a64db6325de1d75f1efc0ca320bef5f4
+  metadata.gz: b3aa491acebfe3b08aef05735fb593c6835b3757b2502f0ca47ad765aca21d9357a0fbb52c8d0a8f0103ad5aff1ff855d2159ff056297dfa4d7ecfeeb2f4387a
+  data.tar.gz: 54179e3366fb8246ed4221e82e70edc67ac0a24fa05212011624f3b9997f11cbdcc481c49b0141efa4c3c8cfbcbb23ffd9f20286442f2a0fb96557ccc8308c12

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brainiac (0.0.23)
+    brainiac (0.0.25)
       puma (~> 7.2)
       rackup (~> 2.3)
       sinatra (~> 4.1)
@@ -84,7 +84,7 @@ DEPENDENCIES
 CHECKSUMS
   ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
-  brainiac (0.0.23)
+  brainiac (0.0.25)
   json (2.19.9) sha256=9b9025b7cdddafa38d316eca0b2358488e42d417045c1b90d216a9fefe46b79a
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87

data/bin/brainiac

@@ -527,6 +527,84 @@ def generate_plugin_skill_md(plugin_name, pascal_name)
   SKILL
 end
 
+SCREENSHOT_CREDS_FILE = File.join(BRAINIAC_DIR, "tmp", "screenshot-creds.json")
+
+# Resolve all op:// references in deployments.json and write to a secure cache file.
+# This allows screenshot commands to work without re-authenticating with 1Password.
+def resolve_screenshot_credentials(quiet: false)
+  deployments_file = File.join(BRAINIAC_DIR, "deployments.json")
+  unless File.exist?(deployments_file)
+    puts "  ⚠ No deployments.json found, skipping credential resolution." unless quiet
+    return false
+  end
+
+  deployments = JSON.parse(File.read(deployments_file))
+  environments = deployments["environments"] || {}
+
+  # Collect all unique op:// references
+  op_refs = {}
+  environments.each_value do |env_config|
+    screenshot = env_config["screenshot"]
+    next unless screenshot
+
+    (screenshot["customers"] || {}).each_value { |ref| op_refs[ref] = nil }
+    (screenshot["employees"] || {}).each_value { |ref| op_refs[ref] = nil }
+  end
+
+  if op_refs.empty?
+    puts "  ⚠ No screenshot credentials to resolve." unless quiet
+    return false
+  end
+
+  puts "  Resolving #{op_refs.size} credential(s) from 1Password..." unless quiet
+
+  # Resolve each unique op:// reference
+  failed = []
+  op_refs.each_key do |ref|
+    password, status = Open3.capture2("op", "read", ref)
+    if status.success?
+      op_refs[ref] = password.chomp
+    else
+      failed << ref
+    end
+  end
+
+  if failed.any?
+    puts "  ❌ Failed to resolve #{failed.size} credential(s):" unless quiet
+    failed.each { |ref| puts "     #{ref}" } unless quiet
+    return false
+  end
+
+  # Write resolved credentials to cache file with restrictive permissions
+  cache_dir = File.join(BRAINIAC_DIR, "tmp")
+  FileUtils.mkdir_p(cache_dir)
+  File.write(SCREENSHOT_CREDS_FILE, JSON.pretty_generate(op_refs))
+  File.chmod(0o600, SCREENSHOT_CREDS_FILE)
+
+  puts "  ✓ Screenshot credentials cached (#{op_refs.size} resolved)" unless quiet
+  true
+rescue JSON::ParserError => e
+  puts "  ❌ Failed to parse deployments.json: #{e.message}" unless quiet
+  false
+end
+
+# Read a resolved credential from the cache file, falling back to `op read`.
+def read_screenshot_credential(op_ref)
+  # Try cache first
+  if File.exist?(SCREENSHOT_CREDS_FILE)
+    creds = JSON.parse(File.read(SCREENSHOT_CREDS_FILE))
+    return creds[op_ref] if creds[op_ref]
+  end
+
+  # Fallback: resolve directly via op read
+  password, status = Open3.capture2("op", "read", op_ref)
+  return password.chomp if status.success?
+
+  nil
+rescue JSON::ParserError
+  nil
+end
+
 def start_server(daemon: false)
   # Resolve the real path of the brainiac script (follows symlinks)
   receiver_path = File.join(BRAINIAC_ROOT, "receiver.rb")
@@ -544,6 +622,9 @@ def start_server(daemon: false)
     exit 1
   end
 
+  # Pre-resolve screenshot credentials from 1Password (so agents can screenshot without re-auth)
+  resolve_screenshot_credentials
+
   if daemon
     # Daemon mode: start in background (like the old behavior)
     log_dir = File.join(receiver_dir, "tmp")
@@ -1107,8 +1188,7 @@ when "unregister", "remove", "rm"
 when "list", "ls"
   list_projects
 
-when "projects"
-  # Support "brainiac projects list" as an alias for "brainiac list"
+when "projects", "project"
   projects_cmd = ARGV.shift
   case projects_cmd
   when "list", "ls", nil
@@ -1140,9 +1220,140 @@ when "projects"
     save_projects(projects)
 
     puts "✓ Set '#{project_key}' as the default project"
+  when "update", "set"
+    project_key = ARGV.shift
+    field = ARGV.shift
+    value = ARGV.join(" ") # Allow multi-word values (e.g. tags with spaces)
+
+    unless project_key && field
+      puts "Usage: brainiac projects update <key> <field> <value>"
+      puts ""
+      puts "Fields:"
+      puts "  repo_path <path>           Path to the project repository"
+      puts "  github_repo <owner/repo>   GitHub repository (e.g. stowzilla/brainiac)"
+      puts "  fizzy_tags <tag1,tag2>     Comma-separated Fizzy tags"
+      puts "  fizzy_board <board>        Default Fizzy board key"
+      puts "  cli_provider <provider>    CLI provider name (e.g. kiro, grok)"
+      puts "  agent_name <name>          Default agent for this project"
+      puts "  agent_model <model>        Default model (e.g. auto, opus, sonnet)"
+      puts "  default_branch <branch>    Default git branch (e.g. main, master)"
+      puts ""
+      puts "Examples:"
+      puts "  brainiac projects update brainiac fizzy_board stowzilla"
+      puts "  brainiac projects update marketplace cli_provider grok"
+      puts "  brainiac projects update brainiac fizzy_tags brainiac,core"
+      puts "  brainiac projects update marketplace agent_model opus"
+      exit 1
+    end
+
+    projects = load_projects
+    unless projects.key?(project_key)
+      puts "Error: Project '#{project_key}' not found."
+      puts "Available projects: #{projects.keys.join(", ")}"
+      exit 1
+    end
+
+    # Handle special field parsing
+    case field
+    when "fizzy_tags", "tags"
+      field = "fizzy_tags"
+      unless value && !value.empty?
+        puts "Error: Value required. Provide comma-separated tags."
+        exit 1
+      end
+      parsed_value = value.split(",").map(&:strip)
+    when "repo_path"
+      unless value && !value.empty?
+        puts "Error: Value required."
+        exit 1
+      end
+      parsed_value = File.expand_path(value)
+      puts "Warning: Path does not exist: #{parsed_value}" unless Dir.exist?(parsed_value)
+    else
+      # Handles known fields (github_repo, fizzy_board, cli_provider, agent_name, agent_model,
+      # default_branch) and arbitrary fields for forward-compatibility
+      unless value && !value.empty?
+        puts "Error: Value required."
+        exit 1
+      end
+      parsed_value = value
+    end
+
+    projects[project_key][field] = parsed_value
+    save_projects(projects)
+
+    display_value = parsed_value.is_a?(Array) ? parsed_value.join(", ") : parsed_value
+    puts "✓ Updated #{project_key}: #{field} = #{display_value}"
+
+  when "unset", "delete-field"
+    project_key = ARGV.shift
+    field = ARGV.shift
+
+    unless project_key && field
+      puts "Usage: brainiac projects unset <key> <field>"
+      puts ""
+      puts "Removes a field from a project's configuration."
+      puts ""
+      puts "Examples:"
+      puts "  brainiac projects unset marketplace fizzy_board"
+      puts "  brainiac projects unset brainiac default_branch"
+      exit 1
+    end
+
+    projects = load_projects
+    unless projects.key?(project_key)
+      puts "Error: Project '#{project_key}' not found."
+      exit 1
+    end
+
+    unless projects[project_key].key?(field)
+      puts "Error: Field '#{field}' not set on project '#{project_key}'."
+      exit 1
+    end
+
+    projects[project_key].delete(field)
+    save_projects(projects)
+    puts "✓ Removed #{field} from #{project_key}"
+
+  when "help", "--help", "-h"
+    puts <<~HELP
+      Usage: brainiac projects <command> [options]
+
+      Commands:
+        list                              List all registered projects (default)
+        show <key>                        Show detailed configuration for a project
+        default <key>                     Set the default project (fallback when no tags match)
+        update <key> <field> <value>      Update a project config field
+        unset <key> <field>               Remove a field from project config
+
+      Aliases:
+        brainiac project  Works the same as 'brainiac projects'
+        brainiac list     Shortcut for 'brainiac projects list'
+        brainiac show     Shortcut for 'brainiac projects show'
+
+      Update fields:
+        repo_path         Path to the project repository
+        github_repo       GitHub repository (owner/repo)
+        fizzy_tags        Comma-separated Fizzy tags
+        fizzy_board       Default Fizzy board key
+        cli_provider      CLI provider name (kiro, grok, etc.)
+        agent_name        Default agent for this project
+        agent_model       Default model (auto, opus, sonnet, haiku, etc.)
+        default_branch    Default git branch
+
+      Examples:
+        brainiac projects list
+        brainiac project show marketplace
+        brainiac projects default marketplace
+        brainiac projects update brainiac fizzy_board stowzilla
+        brainiac projects update marketplace agent_model opus
+        brainiac projects update brainiac fizzy_tags brainiac,core
+        brainiac projects unset marketplace fizzy_board
+    HELP
   else
     puts "Unknown projects command: #{projects_cmd}"
-    puts "Available: list, show, default"
+    puts "Available: list, show, default, update, unset, help"
+    puts "Run 'brainiac projects help' for more details."
     exit 1
   end
 
@@ -3173,6 +3384,183 @@ when "plugin"
     puts "  brainiac plugins             List installed plugins"
   end
 
+when "screenshot"
+  # Resolve screenshot credentials from cached file and delegate to project's screenshot script.
+  # Usage: brainiac screenshot [app-name] [page-path] [--env ENV] [extra args...]
+  #
+  # Credentials are resolved from 1Password at server start and cached in
+  # ~/.brainiac/tmp/screenshot-creds.json. Falls back to `op read` if cache is missing.
+  # Run `brainiac screenshot resolve` to manually refresh the cache.
+
+  deployments_file = File.join(BRAINIAC_DIR, "deployments.json")
+  abort "Error: #{deployments_file} not found. Run 'brainiac setup' or create it manually." unless File.exist?(deployments_file)
+
+  deployments = JSON.parse(File.read(deployments_file))
+  environments = deployments["environments"] || {}
+
+  sub = ARGV.shift
+  case sub
+  when "envs", "list"
+    environments.each do |key, env|
+      screenshot = env["screenshot"]
+      if screenshot
+        customers = (screenshot["customers"] || {}).keys
+        employees = (screenshot["employees"] || {}).keys
+        puts "  #{key} (#{env["label"]})"
+        puts "    Customers: #{customers.join(", ")}" if customers.any?
+        puts "    Employees: #{employees.join(", ")}" if employees.any?
+      else
+        puts "  #{key} (#{env["label"]}) — no screenshot config"
+      end
+    end
+
+  when "resolve"
+    puts "Resolving screenshot credentials from 1Password..."
+    if resolve_screenshot_credentials(quiet: false)
+      puts "\nCredentials cached at #{SCREENSHOT_CREDS_FILE}"
+      puts "Screenshots will use the cache — no 1Password re-auth needed."
+    else
+      abort "\nFailed to resolve credentials. Ensure `op` is signed in."
+    end
+
+  when "help", "--help", "-h", nil
+    puts <<~HELP
+      brainiac screenshot — Take screenshots with credentials from deployments.json
+
+      Usage:
+        brainiac screenshot <app-name> <page-path> [options]
+
+      Credentials are resolved from 1Password at server start and cached in
+      #{SCREENSHOT_CREDS_FILE} (mode 0600). Use `brainiac screenshot resolve`
+      to manually refresh the cache.
+
+      Options:
+        --env ENV           Environment to use (default: auto-detect from project owner)
+        --customer EMAIL    Use specific customer email (default: first in list)
+        --employee EMAIL    Use specific employee email (default: first in list)
+        --project KEY       Project key (default: current directory or default project)
+        All other args are passed through to screenshot-page.sh
+
+      Commands:
+        brainiac screenshot resolve     Resolve and cache credentials from 1Password
+        brainiac screenshot envs        List environments with screenshot config
+        brainiac screenshot help        Show this help
+
+      Examples:
+        brainiac screenshot ops-app /api-explorer
+        brainiac screenshot ops-app /inventory --env dev04
+        brainiac screenshot app /dashboard --env dev02
+    HELP
+
+  else
+    # Parse flags from remaining args
+    app_name = sub
+    page_path = ARGV.shift
+    abort "Error: page path required. Usage: brainiac screenshot <app-name> <page-path> [options]" unless page_path
+
+    env_name = nil
+    customer_email = nil
+    employee_email = nil
+    project_key = nil
+    passthrough_args = []
+
+    while (arg = ARGV.shift)
+      case arg
+      when "--env"
+        env_name = ARGV.shift
+      when "--customer"
+        customer_email = ARGV.shift
+      when "--employee"
+        employee_email = ARGV.shift
+      when "--project"
+        project_key = ARGV.shift
+      else
+        passthrough_args << arg
+        # If the flag takes a value, pass it through too
+        passthrough_args << ARGV.shift if arg.start_with?("--") && !arg.include?("=") && ARGV.first && !ARGV.first.start_with?("--")
+      end
+    end
+
+    # Determine environment (default: dev02 for Linux)
+    env_name ||= case RUBY_PLATFORM
+                 when /darwin/ then "dev01"
+                 else "dev02"
+                 end
+
+    env_config = environments[env_name]
+    abort "Error: Environment '#{env_name}' not found in deployments.json. Available: #{environments.keys.join(", ")}" unless env_config
+
+    screenshot_config = env_config["screenshot"]
+    abort "Error: No 'screenshot' config for environment '#{env_name}' in deployments.json." unless screenshot_config
+
+    customers = screenshot_config["customers"] || {}
+    employees = screenshot_config["employees"] || {}
+
+    # Resolve which email to use
+    if app_name == "ops-app"
+      email = employee_email || employees.keys.first
+      op_ref = employees[email]
+      abort "Error: Employee email '#{email}' not found in #{env_name} screenshot config. Available: #{employees.keys.join(", ")}" unless op_ref
+    else
+      email = customer_email || customers.keys.first
+      op_ref = customers[email]
+      abort "Error: Customer email '#{email}' not found in #{env_name} screenshot config. Available: #{customers.keys.join(", ")}" unless op_ref
+    end
+
+    # Resolve password (from cache or 1Password directly)
+    password = read_screenshot_credential(op_ref)
+    unless password
+      abort "Error: Failed to resolve password for #{op_ref}. Run 'brainiac screenshot resolve' or 'brainiac restart' to refresh the cache."
+    end
+
+    # Determine project path
+    projects = load_projects
+    if project_key
+      project = projects[project_key]
+      abort "Error: Project '#{project_key}' not found." unless project
+    else
+      # Try to find project from current directory or env config
+      project = projects.find { |_k, p| p["repo_path"] == Dir.pwd }&.last
+      project ||= projects[env_config["project"]]
+    end
+
+    abort "Error: Could not determine project. Use --project KEY." unless project
+    repo_path = project["repo_path"]
+    script_path = File.join(repo_path, "scripts", "screenshot-page.sh")
+    abort "Error: Screenshot script not found at #{script_path}" unless File.exist?(script_path)
+
+    # Build environment
+    screenshot_env = {
+      "SCREENSHOT_CUSTOMER_EMAIL" => (app_name == "ops-app" ? (customers.keys.first || email) : email),
+      "SCREENSHOT_CUSTOMER_PASSWORD" => password,
+      "SCREENSHOT_OPS_EMAIL" => (app_name == "ops-app" ? email : (employees.keys.first || email)),
+      "SCREENSHOT_OPS_PASSWORD" => password
+    }
+
+    # Also set environment-specific email vars
+    env_upper = env_name.upcase.tr("-", "_")
+    screenshot_env["SCREENSHOT_#{env_upper}_CUSTOMER_EMAIL"] = customers.keys.first if customers.any?
+
+    # Run the screenshot script
+    cmd = [script_path, app_name, page_path, "", ""] + passthrough_args
+    puts "Taking screenshot: #{app_name} #{page_path} (env: #{env_name}, user: #{email})"
+    puts "Running: #{cmd.join(" ")}"
+
+    pid = spawn(screenshot_env, *cmd, chdir: repo_path)
+    Process.wait(pid)
+
+    if $CHILD_STATUS.success?
+      # Find the most recent screenshot
+      attachments_dir = File.join(repo_path, ".fizzy-attachments")
+      if Dir.exist?(attachments_dir)
+        latest = Dir.glob(File.join(attachments_dir, "*.png")).max_by { |f| File.mtime(f) }
+        puts "\n✅ Screenshot saved: #{latest}" if latest
+      end
+    else
+      abort "\n❌ Screenshot failed (exit #{$CHILD_STATUS.exitstatus})"
+    end
+  end
+
 when "version", "--version", "-v"
   puts "brainiac #{BRAINIAC_VERSION}"
 
@@ -3200,8 +3588,8 @@ when "help", "--help", "-h", nil
         brainiac register [options]     Register current directory as a project
         brainiac unregister <key>       Unregister a project
         brainiac list                   List all registered projects
-        brainiac projects list          List all registered projects (alias)
-        brainiac projects default <key> Set the default project
+        brainiac projects <command>     Manage projects (list, show, default, help)
+        brainiac project <command>      Alias for 'brainiac projects'
         brainiac show <key>             Show project configuration
         brainiac plugin new <name>      Generate a new plugin gem skeleton
         brainiac update                  Update brainiac and all installed plugins
@@ -3214,6 +3602,7 @@ when "help", "--help", "-h", nil
         brainiac provider <command>     Manage CLI providers
         brainiac role <command>         Manage agent roles
         brainiac agent <command>        Manage agent registry (env, list, show)
+        brainiac screenshot <app> <path> Take screenshot with 1Password credentials
         brainiac config                 Configure Brainiac CLI
         brainiac path                   Show Brainiac config directory
         brainiac version                Show version

data/bin/brainiac-completion.bash

@@ -9,7 +9,7 @@ _brainiac() {
   local brainiac_dir="${BRAINIAC_DIR:-$HOME/.brainiac}"
 
   # Top-level commands (built-in + installed plugins)
-  local commands="server start stop restart logs status register unregister list show brain cron provider role agent config path version help setup projects card-map handler plugin install uninstall plugins"
+  local commands="server start stop restart logs status register unregister list show brain cron provider role agent config path version help setup projects project card-map handler plugin install uninstall plugins"
 
   # Add installed plugin names as top-level commands
   if [[ -f "$brainiac_dir/plugins.json" ]]; then
@@ -180,16 +180,40 @@ _brainiac() {
       esac
       ;;
 
-    projects)
+    projects|project)
       case $cword in
         2)
-          COMPREPLY=($(compgen -W "list default" -- "$cur"))
+          COMPREPLY=($(compgen -W "list show default update unset help" -- "$cur"))
           ;;
         3)
-          if [[ "${words[2]}" == "default" ]]; then
+          local subcmd="${words[2]}"
+          if [[ "$subcmd" == "default" || "$subcmd" == "show" || "$subcmd" == "update" || "$subcmd" == "unset" ]]; then
             COMPREPLY=($(compgen -W "$(_brainiac_projects)" -- "$cur"))
           fi
           ;;
+        4)
+          local subcmd="${words[2]}"
+          if [[ "$subcmd" == "update" || "$subcmd" == "unset" ]]; then
+            COMPREPLY=($(compgen -W "repo_path github_repo fizzy_tags fizzy_board cli_provider agent_name agent_model default_branch" -- "$cur"))
+          fi
+          ;;
+        5)
+          local subcmd="${words[2]}"
+          local field="${words[4]}"
+          if [[ "$subcmd" == "update" ]]; then
+            case "$field" in
+              cli_provider)
+                COMPREPLY=($(compgen -W "$(_brainiac_providers)" -- "$cur"))
+                ;;
+              agent_model)
+                COMPREPLY=($(compgen -W "auto opus sonnet haiku deepseek minimax qwen" -- "$cur"))
+                ;;
+              agent_name)
+                COMPREPLY=($(compgen -W "$(_brainiac_agents)" -- "$cur"))
+                ;;
+            esac
+          fi
+          ;;
       esac
       ;;
 

data/lib/brainiac/config.rb

@@ -157,7 +157,7 @@ DEFAULT_PROJECT = {
   "agent_effort_flag" => ENV["AGENT_EFFORT_FLAG"] || "--effort",
   "agent_effort" => ENV.fetch("AGENT_EFFORT", nil),
   "allowed_models" => {
-    "opus" => "claude-opus-4.6",
+    "opus" => "claude-opus-4.5",
     "sonnet" => "claude-sonnet-4.6",
     "haiku" => "claude-haiku-4.5",
     "deepseek" => "deepseek-3.2",

data/lib/brainiac/cron.rb

@@ -466,7 +466,10 @@ def handle_cron_completion(job, project, agent_name, agent_config_name, log_file
   update_cron_job_state(job)
 
   if File.exist?(response_file)
-    LOG.info "[Cron] Job #{job[:id]} completed. Response: #{File.read(response_file)[0..100]}..."
+    response_content = File.read(response_file).strip
+    LOG.info "[Cron] Job #{job[:id]} completed. Response: #{response_content[0..100]}..."
+
+    notify_cron_output(job, response_content, agent_name: agent_name) if job[:notify_target] && !response_content.empty?
   else
     LOG.warn "[Cron] Job #{job[:id]} produced no response"
   end

data/lib/brainiac/handlers/shared/git.rb

@@ -106,6 +106,40 @@ def run_project_hook(repo_path, hook_name, extra_env: {})
   end
 end
 
+# Resolve the base branch for a new worktree.
+# Emits :resolve_base_branch hook — plugins can override the default (origin/main).
+# Returns a ref string (e.g., "origin/main", "epic/my-feature").
+#
+# @param repo_path [String] Path to the git repo
+# @param card_number [Integer, String, nil] Fizzy card number (if applicable)
+# @param project_key [String, nil] Brainiac project key
+# @return [String] Base ref for the worktree
+def resolve_base_branch(repo_path:, card_number: nil, project_key: nil)
+  results = Brainiac.emit(:resolve_base_branch,
+                          repo_path: repo_path, card_number: card_number, project_key: project_key)
+  # First non-nil result wins (plugins return a branch name or nil to skip)
+  custom = results.compact.first
+  if custom
+    LOG.info "Using custom base branch '#{custom}' (from plugin hook)"
+    custom
+  else
+    "origin/#{get_default_branch(repo_path)}"
+  end
+end
+
+# Resolve the PR target branch for a card.
+# Emits :resolve_pr_target hook — plugins can override the default branch.
+#
+# @param repo_path [String] Path to the git repo
+# @param card_number [Integer, String, nil] Fizzy card number
+# @param project_key [String, nil] Brainiac project key
+# @return [String, nil] Target branch name (without origin/ prefix), or nil for default
+def resolve_pr_target(repo_path:, card_number: nil, project_key: nil)
+  results = Brainiac.emit(:resolve_pr_target,
+                          repo_path: repo_path, card_number: card_number, project_key: project_key)
+  results.compact.first
+end
+
 # Create or reuse a git worktree for a given branch.
 # Returns the worktree path on success.
 def create_or_reuse_worktree(repo_path:, branch:, base_ref: nil, worktree_path: nil)

data/lib/brainiac/helpers.rb

@@ -492,7 +492,11 @@ end
 def intent_skip?(message, agent_name:, source: nil, channel: nil, context: nil)
   return false unless message && agent_name && intent_config["enabled"]
 
+  # Some channels always require a response (e.g. PR comments are inherently directed at the agent).
+  bypass_channels = intent_config["bypass_channels"] || %w[github]
   intent_channel = channel || source&.to_s || "conversation"
+  return false if bypass_channels.any? { |bc| intent_channel.to_s.downcase.include?(bc) }
+
   unless check_intent(message, agent_name: agent_name, channel: intent_channel, context: context)
     LOG.info "[Intent] Skipping dispatch for #{agent_name} — message classified as not requiring response"
     return true
@@ -503,7 +507,7 @@ end
 
 def run_agent(prompt, project_config:, chdir: nil, log_name: "agent", model: nil, effort: nil, agent_name: nil, card_number: nil, comment_id: nil,
               source: nil, source_context: {}, skip_column_move: false, cli_provider: nil, resume: false,
-              message: nil, channel: nil, context: nil)
+              message: nil, channel: nil, context: nil, env: {})
   # Intent gate: if a raw message is provided, check whether the agent should respond.
   return nil if intent_skip?(message, agent_name: agent_name, source: source, channel: channel, context: context)
 
@@ -527,7 +531,7 @@ def run_agent(prompt, project_config:, chdir: nil, log_name: "agent", model: nil
   cmd = build_agent_cmd(resolved, agent_config_name: agent_config_name, model: model, effort: effort, prompt_file: prompt_file, resume: should_resume)
   prompt_mode = resolved["prompt_mode"] || "stdin"
 
-  spawn_env = agent_env_for(agent_name)
+  spawn_env = agent_env_for(agent_name).merge(env)
 
   LOG.info "Running #{resolved["agent_cli"]} in #{chdir}, logging to #{log_file}"
   LOG.info "Prompt written to #{prompt_file}"
@@ -585,7 +589,7 @@ def build_agent_cmd(resolved, agent_config_name: nil, model: nil, effort: nil, p
   # "auto" means "let the CLI choose" — skip passing it unless the provider explicitly maps it.
   if model && resolved["agent_model_flag"] && !resolved["agent_model_flag"].empty?
     allowed = resolved["allowed_models"] || {}
-    # Pass the model if it's a mapped value (e.g. "claude-opus-4.6") or the key itself is mapped
+    # Pass the model if it's a mapped value (e.g. "claude-opus-4.5") or the key itself is mapped
     is_known = allowed.value?(model) || allowed.key?(model)
     cmd.push(resolved["agent_model_flag"], model) if is_known
   end

data/lib/brainiac/hooks.rb

@@ -17,6 +17,8 @@
 #   :build_brain_context — When building brain context (plugins add source-specific queries)
 #   :pre_dispatch       — Before dispatching an agent (plugins can inject config)
 #   :post_comment       — After an agent posts a comment/response
+#   :resolve_base_branch — Resolve custom base branch for worktree creation
+#   :resolve_pr_target   — Resolve custom PR target branch (instead of default branch)
 #
 # Usage (in plugin .register):
 #   Brainiac.on(:agent_completed) do |ctx|

data/lib/brainiac/version.rb

@@ -2,5 +2,5 @@
 
 module Brainiac
   # @return [String] the current gem version
-  VERSION = "0.0.23"
+  VERSION = "0.0.25"
 end

data/monitor/shared.rb

@@ -205,7 +205,17 @@ def deploy_bash_script(env_key, worktree:, aws_profile: nil)
     fi
     rm -f "$logfile"
     echo
-    if [ $status -eq 0 ]; then echo "✅ Deploy complete"; else echo "❌ Deploy failed (exit $status)"; fi
+    if [ $status -eq 0 ]; then
+      echo "✅ Deploy complete"
+      curl -s -X POST http://localhost:4567/api/deployments/#{env_key.shellescape} \
+        -H "Content-Type: application/json" \
+        -d '{"worktree": #{worktree.to_json}, "deployed_by": "waybar"}' > /dev/null 2>&1
+    else
+      echo "❌ Deploy failed (exit $status)"
+      curl -s -X POST http://localhost:4567/api/deployments/#{env_key.shellescape}/failed \
+        -H "Content-Type: application/json" \
+        -d '{}' > /dev/null 2>&1
+    fi
     echo "Press Enter to close..."
     read
   BASH

data/monitor/xbar/deploy_env.rb

@@ -111,7 +111,17 @@ deploy_script = <<~BASH
   fi
   rm -f "$logfile"
   echo
-  if [ $status -eq 0 ]; then echo "✅ Deploy complete"; else echo "❌ Deploy failed (exit $status)"; fi
+  if [ $status -eq 0 ]; then
+    echo "✅ Deploy complete"
+    curl -s -X POST http://localhost:4567/api/deployments/#{Shellwords.escape(env_key)} \
+      -H "Content-Type: application/json" \
+      -d '{"worktree": #{worktree.to_json}, "deployed_by": "waybar"}' > /dev/null 2>&1
+  else
+    echo "❌ Deploy failed (exit $status)"
+    curl -s -X POST http://localhost:4567/api/deployments/#{Shellwords.escape(env_key)}/failed \
+      -H "Content-Type: application/json" \
+      -d '{}' > /dev/null 2>&1
+  fi
   echo
   echo "Press any key to close..."
   read -n 1

data/templates/cli-providers/kiro.json.example

@@ -7,7 +7,7 @@
   "prompt_mode": "stdin",
   "resume_flag": "--resume",
   "models": {
-    "opus": "claude-opus-4.6",
+    "opus": "claude-opus-4.5",
     "sonnet": "claude-sonnet-4.6",
     "haiku": "claude-haiku-4.5",
     "deepseek": "deepseek-3.2",

metadata

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