zillacore 0.0.1

data/monitor/setup-menubar.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# One-time setup script to install ZillaCore menubar plugin into xbar or SwiftBar
+# Run this once — the plugin will then auto-refresh on its configured interval
+
+PLUGIN_APPS = [
+  {
+    name: "SwiftBar",
+    plugin_dir: File.expand_path("~/Library/Application Support/SwiftBar/Plugins"),
+    app_path: "/Applications/SwiftBar.app"
+  },
+  {
+    name: "xbar",
+    plugin_dir: File.expand_path("~/Library/Application Support/xbar/plugins"),
+    app_path: "/Applications/xbar.app"
+  }
+].freeze
+
+SYMLINK_NAME = "zillacore.2s.rb"
+SOURCE_PATH = File.join(File.dirname(File.expand_path(__FILE__)), "menubar.rb")
+
+def detect_plugin_app
+  PLUGIN_APPS.each do |app|
+    return { name: app[:name], plugin_dir: app[:plugin_dir] } if Dir.exist?(app[:plugin_dir]) || File.exist?(app[:app_path])
+  end
+  nil
+end
+
+def install_plugin(plugin_dir, source_path)
+  FileUtils.mkdir_p(plugin_dir)
+  link_path = File.join(plugin_dir, SYMLINK_NAME)
+
+  # Remove existing symlink/file if present
+  File.delete(link_path) if File.exist?(link_path) || File.symlink?(link_path)
+
+  File.symlink(source_path, link_path)
+rescue StandardError => e
+  warn "✗ Failed to create symlink: #{e.message}"
+  warn "  Source: #{source_path}"
+  warn "  Target: #{link_path}"
+  exit 1
+end
+
+def verify_executable!(path) # rubocop:disable Naming/PredicateMethod
+  unless File.executable?(path)
+    File.chmod(0o755, path)
+    warn "  Fixed executable permission on #{path}"
+  end
+  File.executable?(path)
+end
+
+# --- Main ---
+
+require "fileutils"
+
+app = detect_plugin_app
+
+unless app
+  puts "No xbar or SwiftBar installation detected."
+  puts ""
+  puts "Install one of the following to use the ZillaCore menu bar plugin:"
+  puts "  • xbar:     https://xbarapp.com"
+  puts "  • SwiftBar: https://github.com/swiftbar/SwiftBar"
+  puts ""
+  puts "After installing, re-run this script:"
+  puts "  ruby #{__FILE__}"
+  exit 0
+end
+
+puts "Detected #{app[:name]}"
+install_plugin(app[:plugin_dir], SOURCE_PATH)
+verify_executable!(SOURCE_PATH)
+
+link_path = File.join(app[:plugin_dir], SYMLINK_NAME)
+puts "✓ Installed ZillaCore plugin into #{app[:name]}"
+puts "  Symlink: #{link_path} → #{SOURCE_PATH}"
+puts "  Refresh interval: 2s"

data/monitor/setup-waybar-deploy-envs.rb

@@ -0,0 +1,121 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# One-time setup: replaces the single zillacore-deployments module
+# with per-environment modules so each dot gets its own border/click.
+
+require "json"
+require "fileutils"
+
+WAYBAR_CONFIG = File.expand_path("~/.config/waybar/config.jsonc")
+DEPLOY_SCRIPT = File.expand_path("~/.zillacore/bin/waybar-deploy-env")
+DEPLOYMENTS_CONFIG = File.expand_path("~/.zillacore/deployments.json")
+WAYBAR_STYLE = File.expand_path("~/.config/waybar/style.css")
+
+# Create wrapper script that resolves from server.root
+wrapper_dir = File.expand_path("~/.zillacore/bin")
+FileUtils.mkdir_p(wrapper_dir)
+File.write(DEPLOY_SCRIPT, <<~SCRIPT)
+  #!/usr/bin/env ruby
+  root_file = File.expand_path("~/.zillacore/server.root")
+  if File.exist?(root_file)
+    server_root = File.read(root_file).strip
+    script = File.join(server_root, "monitor", "waybar-deploy-env.rb")
+    if File.exist?(script)
+      ARGV.unshift if ARGV.empty?
+      load script
+      exit
+    end
+  end
+  require "json"
+  puts({ text: "", tooltip: "ZillaCore server root not found", class: "error" }.to_json)
+SCRIPT
+File.chmod(0o755, DEPLOY_SCRIPT)
+
+def load_config
+  content = File.read(WAYBAR_CONFIG)
+  json_content = content.lines.reject { |line| line.strip.start_with?("//") }.join
+  JSON.parse(json_content)
+end
+
+def save_config(config)
+  File.write(WAYBAR_CONFIG, JSON.pretty_generate(config))
+end
+
+deployments = JSON.parse(File.read(DEPLOYMENTS_CONFIG))
+envs = deployments["environments"].keys
+
+config = load_config
+
+# Remove old single deployments module from all bar positions
+%w[modules-left modules-center modules-right].each do |pos|
+  next unless config[pos]
+
+  config[pos].reject! { |m| m.to_s.include?("zillacore-deploy") }
+end
+config.delete("custom/zillacore-deployments")
+
+# Remove any existing per-env modules
+config.each_key do |key|
+  config.delete(key) if key.start_with?("custom/zillacore-deploy-")
+end
+
+# Insert per-env modules into modules-center, before custom/zillacore
+center = config["modules-center"] || []
+zc_idx = center.index("custom/zillacore") || center.length
+envs.each_with_index do |env, i|
+  mod_name = "custom/zillacore-deploy-#{env}"
+  center.insert(zc_idx + i, mod_name) unless center.include?(mod_name)
+end
+config["modules-center"] = center
+
+# Add module configs for each env
+envs.each do |env|
+  mod_name = "custom/zillacore-deploy-#{env}"
+  config[mod_name] = {
+    "exec" => "#{DEPLOY_SCRIPT} #{env}",
+    "return-type" => "json",
+    "interval" => 30,
+    "format" => "{}",
+    "tooltip" => true,
+    "escape" => false,
+    "on-click" => "#{DEPLOY_SCRIPT} #{env} --click",
+    "on-click-right" => "#{DEPLOY_SCRIPT} #{env} --deploy"
+  }
+end
+
+save_config(config)
+puts "✓ Added per-environment deploy modules: #{envs.map { |e| "custom/zillacore-deploy-#{e}" }.join(", ")}"
+
+# Update CSS — remove old single-module styles, add per-env styles
+style = File.read(WAYBAR_STYLE)
+
+# Remove old block
+style.gsub!(%r{/\* ZillaCore deployment environment dots \*/.*?(?=\n\n|\n/\*|\z)}m, "")
+style.gsub!(/\n*#custom-zillacore-deployments[^{]*\{[^}]*\}\n*/m, "")
+
+# Add new per-env styles
+unless style.include?("#custom-zillacore-deploy-")
+  css = <<~CSS
+
+    /* ZillaCore per-environment deploy dots */
+    [id^="custom-zillacore-deploy-"] {
+      font-size: 28px;
+      padding: 0 6px;
+      border-radius: 8px;
+      border: 2px solid transparent;
+    }
+
+    [id^="custom-zillacore-deploy-"].deploy-recent {
+      border: 2px solid #4488ff;
+    }
+
+    [id^="custom-zillacore-deploy-"].deploy-failed {
+      border: 2px solid #ff4444;
+    }
+  CSS
+  File.write(WAYBAR_STYLE, "#{style.strip}\n#{css}")
+  puts "✓ Updated waybar CSS with per-environment border styles"
+end
+
+puts "✓ Restart waybar to apply: omarchy restart waybar"

data/monitor/setup-waybar-deployments.rb

@@ -0,0 +1,96 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# One-time setup: adds ZillaCore deployments module to waybar config
+# and repositions the agent session module with more breathing room.
+
+require "json"
+
+WAYBAR_CONFIG = File.expand_path("~/.config/waybar/config.jsonc")
+DEPLOY_SCRIPT = File.expand_path("~/Code/zillacore/monitor/waybar-deployments.rb")
+WAYBAR_STYLE  = File.expand_path("~/.config/waybar/style.css")
+
+def load_config
+  content = File.read(WAYBAR_CONFIG)
+  json_content = content.lines.reject { |line| line.strip.start_with?("//") }.join
+  JSON.parse(json_content)
+end
+
+def save_config(config)
+  File.write(WAYBAR_CONFIG, JSON.pretty_generate(config))
+end
+
+config = load_config
+
+# Remove any existing deployment module
+config["modules-center"]&.reject! { |m| m.to_s.include?("zillacore-deploy") }
+config["modules-right"]&.reject! { |m| m.to_s.include?("zillacore-deploy") }
+config.delete("custom/zillacore-deployments")
+
+# Move agent session module from modules-right to modules-center (after indicators)
+if config["modules-right"]&.delete("custom/zillacore")
+  config["modules-center"] ||= []
+  config["modules-center"] << "custom/zillacore" unless config["modules-center"].include?("custom/zillacore")
+end
+
+# Add deployments module right before agent sessions in modules-center
+center = config["modules-center"] || []
+zc_idx = center.index("custom/zillacore")
+if zc_idx
+  center.insert(zc_idx, "custom/zillacore-deployments") unless center.include?("custom/zillacore-deployments")
+else
+  center << "custom/zillacore-deployments" unless center.include?("custom/zillacore-deployments")
+end
+
+# Add module config
+config["custom/zillacore-deployments"] = {
+  "exec" => DEPLOY_SCRIPT,
+  "return-type" => "json",
+  "interval" => 30,
+  "format" => "{}",
+  "tooltip" => true,
+  "format-alt" => "{}",
+  "escape" => false,
+  "on-click" => "#{DEPLOY_SCRIPT} --click",
+  "on-click-right" => "#{DEPLOY_SCRIPT} --deploy"
+}
+
+save_config(config)
+
+# Add CSS for the deployments module
+style = File.read(WAYBAR_STYLE)
+unless style.include?("#custom-zillacore-deployments")
+  css = <<~CSS
+
+    /* ZillaCore deployment environment dots */
+    #custom-zillacore-deployments {
+      margin-left: 100px;
+      margin-right: 40px;
+      font-size: 14px;
+    }
+  CSS
+  File.write(WAYBAR_STYLE, style + css)
+  puts "✓ Added deployment styles to waybar CSS"
+end
+
+# Add padding-right to agent sessions module
+unless style.include?("padding-right") && style.include?("#custom-zillacore")
+  updated_style = File.read(WAYBAR_STYLE)
+  if updated_style.include?("#custom-zillacore {")
+    updated_style.sub!(/(#custom-zillacore\s*\{[^}]*)(\})/) do
+      block = Regexp.last_match(1)
+      close = Regexp.last_match(2)
+      if block.include?("padding-right")
+        "#{block}#{close}"
+      else
+        "#{block}\n  padding-right: 100px;\n#{close}"
+      end
+    end
+    File.write(WAYBAR_STYLE, updated_style)
+    puts "✓ Added padding-right to agent session module"
+  end
+end
+
+puts "✓ Deployments module added to waybar config"
+puts "  Positioned: [deploy-dots] [agent-sessions] in center bar"
+puts "  Restart waybar to apply: omarchy restart waybar"

data/monitor/setup-waybar-module.rb

@@ -0,0 +1,113 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# One-time setup script to add ZillaCore module to waybar config
+# Run this once, then the module will update dynamically without config rewrites
+
+require "json"
+require "fileutils"
+
+WAYBAR_CONFIG = File.expand_path("~/.config/waybar/config.jsonc")
+WAYBAR_SCRIPT = File.expand_path("~/.zillacore/bin/waybar-status")
+
+# Create a wrapper script that resolves the running server's waybar.rb dynamically
+wrapper_dir = File.expand_path("~/.zillacore/bin")
+FileUtils.mkdir_p(wrapper_dir)
+wrapper_path = File.join(wrapper_dir, "waybar-status")
+File.write(wrapper_path, <<~SCRIPT)
+  #!/usr/bin/env ruby
+  # Resolves the running ZillaCore server's waybar module dynamically.
+  # This allows worktrees / branches to work without reconfiguring waybar.
+
+  root_file = File.expand_path("~/.zillacore/server.root")
+  if File.exist?(root_file)
+    server_root = File.read(root_file).strip
+    waybar_script = File.join(server_root, "monitor", "waybar.rb")
+    if File.exist?(waybar_script)
+      load waybar_script
+      exit
+    end
+  end
+
+  # Fallback: no server root known, try the API directly
+  require "json"
+  require "net/http"
+
+  begin
+    uri = URI("http://localhost:4567/api/status")
+    response = Net::HTTP.get_response(uri)
+    if response.is_a?(Net::HTTPSuccess)
+      data = JSON.parse(response.body)
+      sessions = data["sessions"] || []
+      if sessions.empty?
+        puts({ text: "💤", tooltip: "No active agent sessions", class: "idle" }.to_json)
+      else
+        puts({ text: "🟢 \#{sessions.size}", tooltip: sessions.map { |s| s["agent"] }.join(", "), class: "working" }.to_json)
+      end
+    else
+      puts({ text: "⚠️", tooltip: "ZillaCore Error: HTTP \#{response.code}", class: "error" }.to_json)
+    end
+  rescue StandardError => e
+    puts({ text: "⚠️", tooltip: "ZillaCore Error: \#{e.message}", class: "error" }.to_json)
+  end
+SCRIPT
+File.chmod(0o755, wrapper_path)
+
+def load_config
+  content = File.read(WAYBAR_CONFIG)
+  # Strip comments for JSON parsing
+  json_content = content.lines.reject { |line| line.strip.start_with?("//") }.join
+  JSON.parse(json_content)
+end
+
+def save_config(config)
+  File.write(WAYBAR_CONFIG, JSON.pretty_generate(config))
+end
+
+# Load current config
+config = load_config
+
+# Remove old zillacore modules if they exist (from all module arrays)
+%w[modules-left modules-center modules-right].each do |section|
+  next unless config[section].is_a?(Array)
+
+  config[section].reject! { |m| ["custom/zillacore", "group/zillacore-agents"].include?(m.to_s) }
+end
+config.each_key do |key|
+  config.delete(key) if ["custom/zillacore", "group/zillacore-agents"].include?(key.to_s)
+end
+
+# Add single dynamic module at the end of modules-center (after deploy envs)
+config["modules-center"] ||= []
+config["modules-center"].push("custom/zillacore")
+
+# Add module config
+config["custom/zillacore"] = {
+  "exec" => WAYBAR_SCRIPT,
+  "return-type" => "json",
+  "interval" => 3,
+  "format" => "{}",
+  "tooltip" => true,
+  "on-click" => File.expand_path("~/.zillacore/bin/waybar-logs").to_s
+}
+
+# Create on-click wrapper too
+logs_wrapper = File.expand_path("~/.zillacore/bin/waybar-logs")
+File.write(logs_wrapper, <<~SCRIPT)
+  #!/usr/bin/env ruby
+  root_file = File.expand_path("~/.zillacore/server.root")
+  if File.exist?(root_file)
+    server_root = File.read(root_file).strip
+    script = File.join(server_root, "monitor", "view-logs-rofi.rb")
+    exec("ruby", script) if File.exist?(script)
+  end
+  warn "ZillaCore server root not found"
+SCRIPT
+File.chmod(0o755, logs_wrapper)
+
+# Save updated config
+save_config(config)
+
+puts "✓ ZillaCore module added to waybar config"
+puts "  Module will update every 3 seconds without config rewrites"
+puts "  Restart waybar to apply: omarchy restart waybar"

data/monitor/setup-xbar-plugin.rb

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# One-time setup: symlinks the ZillaCore xbar plugin into xbar's plugin directory
+# Run this once on macOS after installing xbar
+
+require "fileutils"
+
+XBAR_PLUGIN_DIR = File.expand_path("~/Library/Application Support/xbar/plugins")
+PLUGIN_SOURCE = File.expand_path("xbar.3s.rb", __dir__)
+PLUGIN_DEST = File.join(XBAR_PLUGIN_DIR, "zillacore.3s.rb")
+
+unless RUBY_PLATFORM.match?(/darwin/i)
+  puts "⚠ This script is for macOS only (xbar doesn't run on Linux)"
+  exit 1
+end
+
+unless File.directory?(XBAR_PLUGIN_DIR)
+  puts "⚠ xbar plugin directory not found: #{XBAR_PLUGIN_DIR}"
+  puts "  Install xbar first: https://xbarapp.com"
+  exit 1
+end
+
+if File.exist?(PLUGIN_DEST)
+  puts "Removing existing plugin at #{PLUGIN_DEST}"
+  File.delete(PLUGIN_DEST)
+end
+
+File.symlink(PLUGIN_SOURCE, PLUGIN_DEST)
+File.chmod(0o755, PLUGIN_SOURCE)
+
+puts "✓ ZillaCore xbar plugin installed"
+puts "  #{PLUGIN_SOURCE} → #{PLUGIN_DEST}"
+puts "  Refresh interval: 3 seconds"
+puts "  Restart xbar to activate"

data/monitor/view-logs-macos.rb

@@ -0,0 +1,210 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# ZillaCore macOS Log Viewer
+# Opens agent log files in a terminal (wezterm by default, configurable via waybar.json)
+# Set "log_viewer_command" in ~/.zillacore/waybar.json to override (supports wezterm/iTerm/Terminal.app)
+# Uses macOS notifications via osascript for status messages
+
+require "json"
+require "socket"
+
+SOCKET_PATH = "/tmp/zillacore-monitor.sock"
+CONFIG_PATH = File.expand_path("~/.zillacore/waybar.json")
+
+# Load agent configuration from JSON
+# Returns [agents_hash, default_emoji] tuple
+def load_agent_config
+  config = JSON.parse(File.read(CONFIG_PATH))
+  agents = {}
+  config["agents"].each do |agent|
+    agents[agent["name"].downcase] = agent["emoji"]
+  end
+  default_emoji = config["default_emoji"] || "❓"
+  [agents, default_emoji]
+rescue StandardError => e
+  warn "Failed to load waybar.json: #{e.message}"
+  [{}, "❓"]
+end
+
+AGENTS, DEFAULT_EMOJI = load_agent_config
+
+# Read agent state from daemon socket
+# Returns hash with sessions/count/last_update, or error hash if daemon unavailable
+def fetch_state
+  socket = UNIXSocket.new(SOCKET_PATH)
+  data = socket.read
+  socket.close
+  JSON.parse(data)
+rescue Errno::ENOENT
+  { "sessions" => [], "count" => 0, "error" => "daemon not running" }
+rescue StandardError => e
+  { "sessions" => [], "count" => 0, "error" => e.message }
+end
+
+def format_elapsed(seconds)
+  return "#{seconds}s" if seconds < 60
+
+  minutes = seconds / 60
+  return "#{minutes}m" if minutes < 60
+
+  hours = minutes / 60
+  "#{hours}h"
+end
+
+# Send a macOS notification via osascript
+# Silently fails if osascript is unavailable
+def notify(title, message)
+  escaped_title = title.gsub('"', '\\"')
+  escaped_message = message.gsub('"', '\\"')
+  system("osascript", "-e", "display notification \"#{escaped_message}\" with title \"#{escaped_title}\"")
+rescue StandardError => e
+  warn "Notification failed: #{e.message}"
+end
+
+def format_context(card_key)
+  if card_key.start_with?("discord-")
+    "Discord chat"
+  elsif card_key.start_with?("card-")
+    card_key.split("-")[1]
+  else
+    card_key
+  end
+end
+
+def load_log_viewer_command
+  config = JSON.parse(File.read(CONFIG_PATH))
+  config["log_viewer_command"]
+rescue StandardError
+  nil
+end
+
+DEFAULT_LOG_VIEWER = "/opt/homebrew/bin/wezterm"
+LOG_VIEWER_COMMAND = load_log_viewer_command || DEFAULT_LOG_VIEWER
+
+# Find an existing wezterm pane that's already tailing the given log file
+def find_wezterm_pane_for(log_file)
+  json = `#{LOG_VIEWER_COMMAND} cli list --format json 2>/dev/null`
+  panes = JSON.parse(json)
+  panes.find { |p| p["title"]&.include?(log_file) || p["cwd"]&.include?(log_file) }
+rescue StandardError
+  nil
+end
+
+# Get the window ID of the first wezterm window
+def find_wezterm_window_id
+  json = `#{LOG_VIEWER_COMMAND} cli list --format json 2>/dev/null`
+  panes = JSON.parse(json)
+  panes.first&.dig("window_id")
+rescue StandardError
+  nil
+end
+
+def open_log(log_file)
+  escaped_path = log_file.gsub("'", "'\\\\''")
+
+  if LOG_VIEWER_COMMAND.include?("wezterm")
+    wezterm_running = system("pgrep -qf WezTerm")
+    if wezterm_running
+      # Check if this log is already being tailed in an existing tab
+      existing_pane = find_wezterm_pane_for(log_file)
+      if existing_pane
+        system(LOG_VIEWER_COMMAND, "cli", "activate-pane", "--pane-id", existing_pane["pane_id"].to_s)
+      else
+        # Spawn as a new tab in the first available window
+        window_id = find_wezterm_window_id
+        args = [LOG_VIEWER_COMMAND, "cli", "spawn"]
+        args += ["--window-id", window_id.to_s] if window_id
+        args += ["--", "tail", "-f", log_file]
+        system(*args)
+      end
+    else
+      system(LOG_VIEWER_COMMAND, "start", "--", "tail", "-f", log_file)
+      sleep 0.5 # Give wezterm time to launch before trying to activate
+    end
+    system("open", "-a", "WezTerm")
+    system("osascript", "-e", 'tell application "System Events" to set frontmost of process "WezTerm" to true')
+  elsif LOG_VIEWER_COMMAND.include?("iTerm")
+    script = <<~APPLESCRIPT
+      tell application "iTerm"
+        activate
+        create window with default profile command "tail -f '#{escaped_path}'"
+      end tell
+    APPLESCRIPT
+    system("osascript", "-e", script)
+  elsif LOG_VIEWER_COMMAND.include?("Terminal")
+    system("osascript", "-e", "tell application \"Terminal\" to do script \"tail -f '#{escaped_path}'\"")
+    system("osascript", "-e", 'tell application "Terminal" to activate')
+  else
+    system(LOG_VIEWER_COMMAND, "tail", "-f", log_file)
+  end
+end
+
+# --- Main invocation logic ---
+
+# Mode 1: xbar submenu click — log file path passed as param1 (ARGV[0])
+if ARGV[0]
+  log_file = ARGV[0]
+  unless File.exist?(log_file)
+    notify("ZillaCore", "Log file not found: #{log_file}")
+    exit 1
+  end
+  open_log(log_file)
+  exit 0
+end
+
+# Mode 2+: standalone invocation — fetch state from daemon
+state = fetch_state
+sessions = state["sessions"] || []
+
+if state["error"]
+  notify("ZillaCore", state["error"])
+  exit 1
+end
+
+if sessions.empty?
+  notify("ZillaCore", "No active agent sessions")
+  exit 0
+end
+
+# Single session — open directly
+if sessions.size == 1
+  log_file = sessions[0]["log_file"]
+  if log_file && File.exist?(log_file)
+    open_log(log_file)
+  else
+    notify("ZillaCore", "Log file not found: #{log_file}")
+  end
+  exit 0
+end
+
+# Multiple sessions — use fzf if available
+if system("which fzf > /dev/null 2>&1")
+  options = sessions.map do |s|
+    agent = s["agent"]
+    elapsed = format_elapsed(s["elapsed_seconds"])
+    context = format_context(s["card_key"])
+    emoji = AGENTS[agent.downcase] || DEFAULT_EMOJI
+    "#{emoji} #{agent}: #{context} (#{elapsed})|#{s["log_file"]}"
+  end
+
+  menu_text = options.join("\n")
+  selected = `echo "#{menu_text}" | fzf --prompt="Agent Logs: "`.strip
+
+  unless selected.empty?
+    log_file = selected.split("|").last
+    if File.exist?(log_file)
+      open_log(log_file)
+    else
+      notify("ZillaCore", "Log file not found: #{log_file}")
+    end
+  end
+else
+  # No fzf — open first session's log
+  log_file = sessions[0]["log_file"]
+  if log_file && File.exist?(log_file)
+    open_log(log_file)
+  else
+    notify("ZillaCore", "Log file not found: #{log_file}")
+  end
+end