brainiac 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e2fc609dfdad411c1262f53783c3d6d88de4dbb75c83ccb9cedf6b935555a42
-  data.tar.gz: 6c7f6aed1727d45ba3bd953554598a20222c3ed47a81879b66108fbe2e7abb98
+  metadata.gz: 1edc9fb64e331daacfa390596ce230ee37f6739e91efc72438434110e88d24de
+  data.tar.gz: 0fdf11e2eace81f2ce56f6f562e675d7c67598232a23b020fcc982f7ac20db58
 SHA512:
-  metadata.gz: 68db7910a0cca76489408685a40f1fe549eaa6462ddefad4b532160b2ef8bd80c798a79b84c4daaeb538e52cc4df3412fca8f61862c39d94a49e9c080cb83e95
-  data.tar.gz: ab36e6f636e4ac76b28bfa55a418d1c00f2251adc36663e9fe21786150d3a27aa7d870bf4c225ffc47303873af38c76ed7601166be9d9ce88a2f30e372770e3b
+  metadata.gz: ca3e17f678f0207947da8fda7af7711788cacdf377e2496b04c82a1aed303faa3cc57e6c3b32be3227a98bc12b86bb28b25d523ab817514b396a249955cc226a
+  data.tar.gz: 2cab777438aa1b245b037a46f6fdf9dcfe16120eca888528dd045f7e70fed699c850bfe76b858601f9f7708a61c213f3be96cb4173a3f2fae81d83f7f4fcc36b

data/bin/brainiac

@@ -668,6 +668,9 @@ def generate_plugin_skill_md(plugin_name, pascal_name)
     | `:create_work_item` | Create card/issue/ticket |
     | `:detect_cli_provider` | Detect CLI provider |
     | `:detect_effort` | Detect effort level |
+    | `:agent_added` | New agent in agents.json (after reload) |
+    | `:agent_updated` | Existing agent's entry changed (after reload) |
+    | `:agent_removed` | Agent removed from agents.json (after reload) |
 
     ## Agent Onboarding (`on_agent_created`)
 
@@ -731,6 +734,13 @@ def generate_plugin_skill_md(plugin_name, pascal_name)
     asked during create). Core filters on the plugin name before calling you, so
     plugins don't need to handle this.
 
+    **Going live without a restart.** `agent create` / `agent setup` tell the running
+    server to reload `agents.json`. The server may already have seen the agent before
+    your hook wrote its token, so a server-side plugin that starts something per agent
+    (a gateway connection, a poller) must handle `:agent_updated` as well as
+    `:agent_added`: start it when the credential appears or changes, stop it when it's
+    removed.
+
     ## Channel Prompts
 
     For communication channel plugins:
@@ -2606,8 +2616,12 @@ when "agent"
     notify_plugins_agent_created(agent_key, agent_hook_payload(agent_key, entry, open_browser: open_browser),
                                  skip: skip_plugins, only: only_plugins, confirm: confirm)
     if skip_plugins.any? && entry["skip_plugins"] != skip_plugins.uniq
-      entry["skip_plugins"] = skip_plugins.uniq
-      registry[agent_key] = entry
+      # Re-read: the plugin hooks above wrote their tokens (DISCORD_BOT_TOKEN,
+      # FIZZY_TOKEN, ...) into agents.json, and the copy we loaded at the start
+      # would clobber them.
+      registry = JSON.parse(File.read(agent_registry_file))
+      registry[agent_key] ||= entry
+      registry[agent_key]["skip_plugins"] = skip_plugins.uniq
       File.write(agent_registry_file, JSON.pretty_generate(registry))
       puts "  Skipping #{skip_plugins.uniq.join(", ")} for #{name} (undo: brainiac agent setup #{agent_key} --only <plugin>)"
     end

data/lib/brainiac/agents.rb

@@ -50,6 +50,7 @@ AGENT_REGISTRY = load_agent_registry
 def reload_agent_registry!(force: false)
   return unless file_changed?(AGENT_REGISTRY_FILE, force: force)
 
+  old_registry = AGENT_REGISTRY.dup
   old_keys = AGENT_REGISTRY.keys.to_set
   AGENT_REGISTRY.replace(load_agent_registry)
   new_keys = AGENT_REGISTRY.keys.to_set
@@ -70,6 +71,17 @@ def reload_agent_registry!(force: false)
     LOG.info "Agent removed: #{key}"
     Brainiac.emit(:agent_removed, agent_key: key)
   end
+
+  # Agents that already existed but whose entry changed — e.g. `agent create`
+  # wrote the entry first and a plugin added its token a few seconds later.
+  (old_keys & new_keys).each do |key|
+    entry = AGENT_REGISTRY[key]
+    next if entry == old_registry[key]
+
+    display_name = entry.is_a?(Hash) ? (entry["display_name"] || key.capitalize) : key.capitalize
+    Brainiac.emit(:agent_updated, agent_key: key, display_name: display_name, entry: entry,
+                                  previous_entry: old_registry[key])
+  end
 end
 
 # Default environment for all agent processes. Prevents git from hanging

data/lib/brainiac/hooks.rb

@@ -11,6 +11,7 @@
 #   :agent_completed    — After an agent session finishes (success or failure)
 #   :agent_added        — When a new agent appears in the registry (after reload)
 #   :agent_removed      — When an agent is removed from the registry (after reload)
+#   :agent_updated      — When an existing agent's entry changes (after reload; has :previous_entry)
 #   :pr_merged          — After a GitHub PR is merged
 #   :pr_opened          — After a GitHub PR is opened
 #   :pr_reviewed        — After a PR review is submitted

data/lib/brainiac/version.rb

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

data/skills/brainiac-plugins/SKILL.md

@@ -109,6 +109,9 @@ Available hooks:
 | `:create_work_item` | Create a card/issue/ticket | title, body, project |
 | `:detect_cli_provider` | Detect CLI provider | metadata hash |
 | `:detect_effort` | Detect effort level | metadata hash |
+| `:agent_added` | New key in agents.json (after reload) | agent_key, display_name, entry |
+| `:agent_updated` | Existing agent's entry changed (after reload) | agent_key, display_name, entry, previous_entry |
+| `:agent_removed` | Key gone from agents.json (after reload) | agent_key |
 
 ## Agent Onboarding (`on_agent_created`)
 
@@ -172,6 +175,13 @@ Users choose which plugins run with `--skip` / `--only` (or by answering "n" whe
 asked during create). Core filters on the plugin name before calling you, so
 plugins don't need to handle this.
 
+**Going live without a restart.** `agent create` / `agent setup` tell the running
+server to reload `agents.json`. The server may already have seen the agent before
+your hook wrote its token, so a server-side plugin that starts something per agent
+(a gateway connection, a poller) must handle `:agent_updated` as well as
+`:agent_added`: start it when the credential appears or changes, stop it when it's
+removed.
+
 ## Channel Prompts
 
 If your plugin is a communication channel (like Discord, Fizzy), register a prompt:

metadata

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