brainiac 0.5.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 19070ea9233ea32b1367c449e0d9e8cdc450bf7ba713de28cb0acb0db8de9923
4
- data.tar.gz: 58a1fc29cc7a039bbd551fb0d8dc46100bede670799919a2b963c703f50cfcbf
3
+ metadata.gz: acc261e8c5d724ce5e9acfd455aa8363425f5e9587a00a0fa24b940cec5b7049
4
+ data.tar.gz: 6ba1ae2f332abb462a5381068e73dbde4ec4c1efdf6784f37dea16d3da3fff7a
5
5
  SHA512:
6
- metadata.gz: f02a41922a6cb3ef2e1398fb682afdb10be9d948e522645bfea6ad6c3ab4980aafdacfd81792febf3bc736f331588d65ef9059d28f5d4d473322683af68bae72
7
- data.tar.gz: 30c7d3465ccd6a5a53d7a0cace8451088222c95b2a57dbf1785269143accd5b74282b64ccdd13890fabaf07cd4888ffa2d2eba948e30d901faafbf7eb252a06b
6
+ metadata.gz: 70cf73d06da1ed0ad827db8cb500bb95f909bcc447276356d6ceb8e1d3eedea6607ee521a1cf6316aa8f8d9f53740d9259c9215676bf7d7fc5a6328c1906a4e8
7
+ data.tar.gz: 8cab8cc15b5d58364ff7bc8d17a13b07f52b5cbafeb4906ab8814560669413d5f80ddd1a0b7d0fd111201f7f50a6203fedafd0c865aecba133ccd227a653fac6
data/bin/brainiac CHANGED
@@ -244,6 +244,66 @@ def plugin_list_arg(value)
244
244
  value.to_s.split(",").map { |p| p.strip.downcase.delete_prefix("brainiac-") }.reject(&:empty?)
245
245
  end
246
246
 
247
+ # Load a CLI provider config from ~/.brainiac/cli-providers/<name>.json.
248
+ # Duplicated from lib/brainiac/helpers.rb since bin/brainiac doesn't load the full runtime.
249
+ def load_cli_provider_for_setup(provider_name)
250
+ return {} unless provider_name
251
+
252
+ provider_file = File.join(BRAINIAC_DIR, "cli-providers", "#{provider_name}.json")
253
+ return {} unless File.exist?(provider_file)
254
+
255
+ JSON.parse(File.read(provider_file))
256
+ rescue JSON::ParserError
257
+ {}
258
+ end
259
+
260
+ # Run a CLI provider's setup_hook for a new agent.
261
+ # The hook receives agent_key and entry JSON on stdin.
262
+ # Returns true if the hook ran successfully, false otherwise.
263
+ def run_cli_provider_setup_hook(provider_name, agent_key, entry)
264
+ config = load_cli_provider_for_setup(provider_name)
265
+ hook = config["setup_hook"]
266
+ return true unless hook && !hook.empty?
267
+
268
+ # Expand ~ in hook path
269
+ hook_path = hook.start_with?("~") ? File.expand_path(hook) : hook
270
+
271
+ unless File.executable?(hook_path)
272
+ puts " [#{provider_name}] setup_hook not executable: #{hook_path}"
273
+ return false
274
+ end
275
+
276
+ puts " [#{provider_name}] Running setup hook..."
277
+ input = JSON.generate({ "agent_key" => agent_key, "entry" => entry })
278
+ stdout, stderr, status = Open3.capture3(hook_path, stdin_data: input)
279
+ if status.success?
280
+ puts stdout unless stdout.strip.empty?
281
+ true
282
+ else
283
+ puts " [#{provider_name}] setup_hook failed (exit #{status.exitstatus})"
284
+ puts stderr unless stderr.strip.empty?
285
+ false
286
+ end
287
+ rescue StandardError => e
288
+ puts " [#{provider_name}] setup_hook error: #{e.message}"
289
+ false
290
+ end
291
+
292
+ # Run setup hook for the CLI provider configured on an agent (or the default).
293
+ def run_agent_cli_provider_setup_hook(agent_key, entry)
294
+ provider = entry["cli_provider"]
295
+ provider ||= begin
296
+ brainiac_config_path = File.join(BRAINIAC_DIR, "brainiac.json")
297
+ JSON.parse(File.read(brainiac_config_path))["default_cli_provider"] if File.exist?(brainiac_config_path)
298
+ rescue JSON::ParserError
299
+ nil
300
+ end
301
+ # Default to kiro if no provider is configured anywhere
302
+ provider ||= "kiro"
303
+
304
+ run_cli_provider_setup_hook(provider, agent_key, entry)
305
+ end
306
+
247
307
  AVATAR_EXTENSIONS = %w[.png .jpg .jpeg .gif .webp].freeze
248
308
 
249
309
  # Resolve a description flag value: "-" reads stdin, "@path" reads a file,
@@ -2502,16 +2562,97 @@ when "provider"
2502
2562
  puts "Synced #{added.size} new model(s) to #{file}:"
2503
2563
  added.each { |a| puts " + #{a}" }
2504
2564
 
2565
+ when "setup-agent"
2566
+ provider_name = ARGV.shift
2567
+ agent_name = ARGV.shift
2568
+ unless provider_name && agent_name
2569
+ puts "Usage: brainiac provider setup-agent <provider> <agent>"
2570
+ puts ""
2571
+ puts "Manually runs the CLI provider's setup_hook for an agent."
2572
+ puts "This is useful for backfilling existing agents after adding a setup_hook."
2573
+ puts ""
2574
+ puts "Example:"
2575
+ puts " brainiac provider setup-agent kiro galen"
2576
+ exit 1
2577
+ end
2578
+
2579
+ config = load_cli_provider_for_setup(provider_name)
2580
+ hook = config["setup_hook"]
2581
+ unless hook && !hook.empty?
2582
+ puts "Provider '#{provider_name}' has no setup_hook configured."
2583
+ puts "Edit ~/.brainiac/cli-providers/#{provider_name}.json and add:"
2584
+ puts ' "setup_hook": "~/.brainiac/cli-providers/hooks/kiro-agent-setup.sh"'
2585
+ exit 1
2586
+ end
2587
+
2588
+ agent_registry_file = File.join(BRAINIAC_DIR, "agents.json")
2589
+ registry = File.exist?(agent_registry_file) ? JSON.parse(File.read(agent_registry_file)) : {}
2590
+ agent_key = agent_name.downcase.gsub(/[^a-z0-9-]/, "-")
2591
+ entry = registry[agent_key]
2592
+ unless entry
2593
+ puts "Agent '#{agent_name}' not found in registry."
2594
+ exit 1
2595
+ end
2596
+
2597
+ if run_cli_provider_setup_hook(provider_name, agent_key, entry)
2598
+ puts "✓ Setup hook completed for #{entry["display_name"] || agent_name}"
2599
+ else
2600
+ puts "❌ Setup hook failed"
2601
+ exit 1
2602
+ end
2603
+
2604
+ when "setup-all-agents"
2605
+ provider_name = ARGV.shift
2606
+ unless provider_name
2607
+ puts "Usage: brainiac provider setup-all-agents <provider>"
2608
+ puts ""
2609
+ puts "Runs the CLI provider's setup_hook for ALL local agents."
2610
+ puts "Useful for backfilling after adding a setup_hook to an existing provider."
2611
+ exit 1
2612
+ end
2613
+
2614
+ config = load_cli_provider_for_setup(provider_name)
2615
+ hook = config["setup_hook"]
2616
+ unless hook && !hook.empty?
2617
+ puts "Provider '#{provider_name}' has no setup_hook configured."
2618
+ exit 1
2619
+ end
2620
+
2621
+ agent_registry_file = File.join(BRAINIAC_DIR, "agents.json")
2622
+ registry = File.exist?(agent_registry_file) ? JSON.parse(File.read(agent_registry_file)) : {}
2623
+ local_agents = registry.select { |_, e| e.is_a?(Hash) && e["local"] }
2624
+
2625
+ if local_agents.empty?
2626
+ puts "No local agents found."
2627
+ exit 0
2628
+ end
2629
+
2630
+ puts "Running #{provider_name} setup_hook for #{local_agents.size} local agent(s)..."
2631
+ succeeded = 0
2632
+ failed = 0
2633
+ local_agents.each do |agent_key, entry|
2634
+ display = entry["display_name"] || agent_key
2635
+ if run_cli_provider_setup_hook(provider_name, agent_key, entry)
2636
+ succeeded += 1
2637
+ else
2638
+ failed += 1
2639
+ end
2640
+ end
2641
+ puts ""
2642
+ puts "✓ #{succeeded} succeeded, #{failed} failed"
2643
+
2505
2644
  else
2506
2645
  puts <<~HELP
2507
2646
  Usage: brainiac provider <command>
2508
2647
 
2509
2648
  Commands:
2510
- list List configured CLI providers
2511
- show <name> Show provider configuration
2512
- add <name> Create a new provider config
2513
- list-models <name> Query available models from the CLI provider
2514
- sync-models <name> Add discovered models to provider config
2649
+ list List configured CLI providers
2650
+ show <name> Show provider configuration
2651
+ add <name> Create a new provider config
2652
+ list-models <name> Query available models from the CLI provider
2653
+ sync-models <name> Add discovered models to provider config
2654
+ setup-agent <provider> <agent> Run provider's setup_hook for one agent
2655
+ setup-all-agents <provider> Run provider's setup_hook for all local agents
2515
2656
  HELP
2516
2657
  end
2517
2658
 
@@ -2822,6 +2963,9 @@ when "agent"
2822
2963
  brain_init(name)
2823
2964
  end
2824
2965
 
2966
+ # Run CLI provider's setup_hook (e.g., create ~/.kiro/agents/<key>.json)
2967
+ run_agent_cli_provider_setup_hook(agent_key, entry)
2968
+
2825
2969
  # Each plugin provisions its side (Discord bot, Fizzy user, Basecamp person, ...).
2826
2970
  # Without --skip/--only, a terminal user is asked per plugin; "no" answers
2827
2971
  # are saved so `agent setup` leaves those plugins alone too.
@@ -2939,6 +3083,8 @@ when "agent"
2939
3083
  File.write(agent_registry_file, JSON.pretty_generate(registry))
2940
3084
 
2941
3085
  puts "Setting up #{entry["display_name"] || name} (#{agent_key})"
3086
+ # Run CLI provider's setup_hook (e.g., create ~/.kiro/agents/<key>.json)
3087
+ run_agent_cli_provider_setup_hook(agent_key, entry)
2942
3088
  notify_plugins_agent_created(agent_key, agent_hook_payload(agent_key, entry, open_browser: open_browser),
2943
3089
  skip: entry["skip_plugins"] || [], only: only_plugins)
2944
3090
  notify_server_reload
@@ -2,5 +2,5 @@
2
2
 
3
3
  module Brainiac
4
4
  # @return [String] the current gem version
5
- VERSION = "0.5.1"
5
+ VERSION = "0.6.0"
6
6
  end
@@ -0,0 +1,68 @@
1
+ #!/usr/bin/env bash
2
+ # Kiro CLI agent setup hook for brainiac
3
+ #
4
+ # Called by `brainiac agent create` and `brainiac agent setup` after writing
5
+ # the brainiac-side files. Creates ~/.kiro/agents/<key>.json with sensible defaults.
6
+ #
7
+ # Input (stdin): JSON with "agent_key" and "entry" (the agents.json entry)
8
+ # Output (stdout): status messages
9
+ # Exit code: 0 = success, non-zero = failure
10
+ #
11
+ # Install: copy to ~/.brainiac/cli-providers/hooks/kiro-agent-setup.sh
12
+ # and chmod +x
13
+
14
+ set -euo pipefail
15
+
16
+ KIRO_AGENTS_DIR="${HOME}/.kiro/agents"
17
+ mkdir -p "$KIRO_AGENTS_DIR"
18
+
19
+ # Read JSON from stdin
20
+ INPUT=$(cat)
21
+ AGENT_KEY=$(echo "$INPUT" | jq -r '.agent_key')
22
+ DISPLAY_NAME=$(echo "$INPUT" | jq -r '.entry.display_name // empty')
23
+ ROLE=$(echo "$INPUT" | jq -r '.entry.role | if type == "array" then .[0] else . end // empty')
24
+
25
+ if [[ -z "$AGENT_KEY" ]]; then
26
+ echo " [kiro] Error: agent_key not provided" >&2
27
+ exit 1
28
+ fi
29
+
30
+ AGENT_FILE="${KIRO_AGENTS_DIR}/${AGENT_KEY}.json"
31
+
32
+ # Skip if already exists — let kiro-cli agent upgrade handle migration
33
+ if [[ -f "$AGENT_FILE" ]]; then
34
+ echo " [kiro] ${AGENT_FILE} already exists (skipping)"
35
+ exit 0
36
+ fi
37
+
38
+ # Build a minimal Kiro agent config
39
+ # The v3 format uses "tools": ["*"] for unrestricted tool access
40
+ # and "resources" to load steering files
41
+
42
+ # Optional: load the role as a steering file if it exists
43
+ ROLE_RESOURCE=""
44
+ if [[ -n "$ROLE" ]] && [[ -f "${HOME}/.brainiac/roles/${ROLE}.md" ]]; then
45
+ ROLE_RESOURCE="\"file://${HOME}/.brainiac/roles/${ROLE}.md\""
46
+ fi
47
+
48
+ # Create the agent file
49
+ if [[ -n "$ROLE_RESOURCE" ]]; then
50
+ cat > "$AGENT_FILE" <<EOF
51
+ {
52
+ "name": "${DISPLAY_NAME:-$AGENT_KEY}",
53
+ "tools": ["*"],
54
+ "resources": [
55
+ ${ROLE_RESOURCE}
56
+ ]
57
+ }
58
+ EOF
59
+ else
60
+ cat > "$AGENT_FILE" <<EOF
61
+ {
62
+ "name": "${DISPLAY_NAME:-$AGENT_KEY}",
63
+ "tools": ["*"]
64
+ }
65
+ EOF
66
+ fi
67
+
68
+ echo " [kiro] Created ${AGENT_FILE}"
@@ -12,6 +12,8 @@
12
12
  "session_directory_field": "cwd",
13
13
  "session_updated_field": "updatedAt",
14
14
  "list_models_command": "kiro-cli chat --list-models --format json",
15
+ "setup_hook": "~/.brainiac/cli-providers/hooks/kiro-agent-setup.sh",
16
+ "setup_hook_comment": "Optional. Script that runs after brainiac agent create/setup. Receives JSON on stdin with agent_key and entry. Use to create ~/.kiro/agents/<key>.json or other CLI-specific setup.",
15
17
  "models": {
16
18
  "opus": "claude-opus-4.5",
17
19
  "sonnet": "claude-sonnet-4.6",
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: brainiac
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.5.1
4
+ version: 0.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Andy Davis
@@ -168,6 +168,7 @@ files:
168
168
  - templates/cli-providers/codex.json.example
169
169
  - templates/cli-providers/gemini.json.example
170
170
  - templates/cli-providers/grok.json.example
171
+ - templates/cli-providers/hooks/kiro-agent-setup.sh.example
171
172
  - templates/cli-providers/kiro.json.example
172
173
  - templates/cli-providers/opencode.json.example
173
174
  - templates/hooks/pre-commit