u-foo 1.0.0

package/modules/resources/ICONS/libraries/lucide/LICENSE

@@ -0,0 +1,40 @@
+ISC License
+
+Copyright (c) for portions of Lucide are held by Cole Bemis 2013-2026 as part of Feather (MIT). All other copyright (c) for Lucide are held by Lucide Contributors 2026.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The MIT License (MIT) (for portions derived from Feather)
+
+Copyright (c) 2013-2026 Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/modules/resources/ICONS/libraries/lucide/README.md

@@ -0,0 +1,15 @@
+# Lucide (Minimal Subset)
+
+Source:
+- Repository: https://github.com/lucide-icons/lucide
+- Path: `icons/`
+- License: ISC (see `LICENSE`)
+- Fetched: 2026-01-27
+
+Included icons:
+- `arrow-right.svg`
+- `chevron-down.svg`
+- `search.svg`
+- `settings.svg`
+- `check.svg`
+- `x.svg`

package/modules/resources/ICONS/libraries/lucide/arrow-right.svg

@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M5 12h14" />
+  <path d="m12 5 7 7-7 7" />
+</svg>
+

package/modules/resources/ICONS/libraries/lucide/check.svg

@@ -0,0 +1,14 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M20 6 9 17l-5-5" />
+</svg>
+

package/modules/resources/ICONS/libraries/lucide/chevron-down.svg

@@ -0,0 +1,14 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="m6 9 6 6 6-6" />
+</svg>
+

package/modules/resources/ICONS/libraries/lucide/search.svg

@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="m21 21-4.34-4.34" />
+  <circle cx="11" cy="11" r="8" />
+</svg>
+

package/modules/resources/ICONS/libraries/lucide/settings.svg

@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915" />
+  <circle cx="12" cy="12" r="3" />
+</svg>
+

package/modules/resources/ICONS/libraries/lucide/x.svg

@@ -0,0 +1,15 @@
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M18 6 6 18" />
+  <path d="m6 6 12 12" />
+</svg>
+

package/modules/resources/ICONS/rules.md

@@ -0,0 +1,7 @@
+# Icon Rules
+
+- ViewBox: 0 0 24 24
+- Stroke-based icons preferred
+- No gradients or shadows
+- Avoid perfect symmetry
+- Optical balance > geometric balance

package/modules/resources/README.md

@@ -0,0 +1,9 @@
+# resources
+
+Optional resources for AI-assisted coding workflows.
+
+This repository intentionally contains non-core materials such as:
+- `UI/` tone + anti-pattern references
+- `ICONS/` reference icon subsets (with licenses)
+
+It is designed to be installed and managed by `ufoo` under `~/.ufoo/modules/resources`.

package/modules/resources/UI/ANTI-PATTERNS.md

@@ -0,0 +1,6 @@
+# UI Anti-Patterns
+
+- Over-rounded corners
+- Decorative gradients
+- Unnecessary animations
+- Visual noise

package/modules/resources/UI/TONE.md

@@ -0,0 +1,6 @@
+# UI Tone
+
+- Neutral
+- Restrained
+- Utility-focused
+- Avoid friendliness or decoration

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "u-foo",
+  "version": "1.0.0",
+  "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://ufoo.dev",
+  "author": "UFOO Team",
+  "keywords": [
+    "cli",
+    "ai",
+    "agent",
+    "multi-agent",
+    "claude",
+    "codex",
+    "orchestration",
+    "workspace"
+  ],
+  "bin": {
+    "ufoo": "bin/ufoo.js",
+    "uclaude": "bin/uclaude",
+    "ucodex": "bin/ucodex"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "scripts/",
+    "modules/",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "blessed": "^0.1.81",
+    "chalk": "^4.1.2",
+    "commander": "^13.1.0"
+  }
+}

package/scripts/banner.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# banner.sh - TUI startup banner for ufoo agents
+
+# Colors
+RST='\033[0m'
+BLD='\033[1m'
+DIM='\033[2m'
+CYN='\033[0;36m'
+GRN='\033[0;32m'
+MAG='\033[0;35m'
+WHT='\033[1;37m'
+YLW='\033[0;33m'
+
+show_banner() {
+  local agent_type="${1:-claude}"
+  local session_id="${2:-unknown}"
+  local subscriber="${3:-}"
+  local daemon_status="${4:-}"
+
+  local ACOL
+  if [[ "$agent_type" == "codex" ]]; then
+    ACOL="$GRN"
+  else
+    ACOL="$MAG"
+  fi
+
+  # Width matches Codex CLI (inner content = 52)
+  local INNER=52
+  local W=$INNER
+
+  # Helper: print line with exact padding
+  line() {
+    local prefix="$1"
+    local value="$2"
+    local color="$3"
+    local prefix_len=${#prefix}
+    local value_len=${#value}
+    local pad_len=$((INNER - prefix_len - value_len))
+    printf "${DIM}│${RST}${prefix}${color}${value}${RST}"
+    printf "%${pad_len}s" ""
+    printf "${DIM}│${RST}\n"
+  }
+
+  echo ""
+  printf "${DIM}╭"; printf '─%.0s' $(seq 1 $W); printf "╮${RST}\n"
+
+  # Title line with icon (compute padding from plain text lengths)
+  local icon_plain="<○>"
+  local title="UFOO · Multi-Agent Protocol"
+  local title_pad=$((INNER - 1 - ${#icon_plain} - 1 - ${#title}))
+  printf "${DIM}│${RST} ${WHT}${icon_plain}${RST} ${CYN}${BLD}UFOO${RST}${DIM} · Multi-Agent Protocol${RST}"
+  printf "%${title_pad}s" ""
+  printf "${DIM}│${RST}\n"
+
+  printf "${DIM}├"; printf '─%.0s' $(seq 1 $W); printf "┤${RST}\n"
+
+  # Agent
+  if [[ -n "$subscriber" ]]; then
+    local sub="$subscriber"
+    [[ ${#sub} -gt 36 ]] && sub="${sub:0:33}..."
+    line "  Agent   " "$sub" "${ACOL}${BLD}"
+  fi
+
+  # Daemon
+  if [[ -n "$daemon_status" ]]; then
+    line "  Daemon  " "$daemon_status" "${GRN}"
+  fi
+
+  # Online agents (daemon handles cleanup of dead agents)
+  if [[ -f ".ufoo/bus/bus.json" ]]; then
+    local online
+    online=$(jq -r '.subscribers | to_entries[] | select(.value.status == "active") | .key' .ufoo/bus/bus.json 2>/dev/null | grep -v "^${subscriber}$" 2>/dev/null | head -5 || true)
+    if [[ -n "$online" ]]; then
+      printf "${DIM}├"; printf '─%.0s' $(seq 1 $W); printf "┤${RST}\n"
+      line "  Online  " "" ""
+      while IFS= read -r agent; do
+        [[ -z "$agent" ]] && continue
+        local a="$agent"
+        [[ ${#a} -gt 44 ]] && a="${a:0:41}..."
+        line "    · " "$a" "${YLW}"
+      done <<< "$online"
+    fi
+  fi
+
+  printf "${DIM}╰"; printf '─%.0s' $(seq 1 $W); printf "╯${RST}\n"
+  echo ""
+}
+
+export -f show_banner 2>/dev/null || true

package/scripts/bus-alert.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec bash "$repo_root/modules/bus/scripts/bus-alert.sh" "$@"
+

package/scripts/bus-autotrigger.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec bash "$repo_root/modules/bus/scripts/bus-autotrigger.sh" "$@"
+

package/scripts/bus-daemon.sh

@@ -0,0 +1,231 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# bus-daemon.sh
+# Daemon that watches for new messages and injects /bus into target terminals.
+#
+# Usage:
+#   bash scripts/bus-daemon.sh [--interval <seconds>] [--daemon]
+#
+# This script monitors ALL subscribers' pending queues and injects /bus
+# into their corresponding Terminal.app tabs when new messages arrive.
+#
+# Requirements:
+# - macOS Accessibility permission for Terminal.app
+# - Each subscriber's terminal should have title containing [bus:<instance-id>]
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BUS_DIR=".ufoo/bus"
+INTERVAL=2
+DAEMON_MODE=0
+PID_FILE="$BUS_DIR/.daemon.pid"
+LOG_FILE="$BUS_DIR/logs/daemon.log"
+
+usage() {
+  cat <<'USAGE'
+bus-daemon.sh - Watch for new messages and inject /bus
+
+Usage:
+  bash scripts/bus-daemon.sh [options]
+
+Options:
+  --interval <n>   Poll interval in seconds (default: 2)
+  --daemon         Run in background
+  --stop           Stop running daemon
+  --status         Check daemon status
+  -h, --help       Show this help
+
+Notes:
+  - Requires macOS Accessibility permission
+  - Terminals must have title containing [bus:<instance-id>]
+  - Use `ufoo bus join` to set terminal title
+USAGE
+}
+
+# Handle --help before other parsing
+if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
+  usage
+  exit 0
+fi
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --interval)
+      INTERVAL="$2"
+      shift 2
+      ;;
+    --daemon)
+      DAEMON_MODE=1
+      shift
+      ;;
+    --stop)
+      if [[ -f "$PID_FILE" ]]; then
+        pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+        if [[ -n "$pid" ]]; then
+          kill "$pid" 2>/dev/null && echo "[daemon] Stopped (pid=$pid)" || echo "[daemon] Not running"
+        fi
+        rm -f "$PID_FILE"
+      else
+        echo "[daemon] Not running"
+      fi
+      exit 0
+      ;;
+    --status)
+      if [[ -f "$PID_FILE" ]]; then
+        pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+        if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+          echo "[daemon] Running (pid=$pid)"
+        else
+          echo "[daemon] Not running (stale pid file)"
+          rm -f "$PID_FILE"
+        fi
+      else
+        echo "[daemon] Not running"
+      fi
+      exit 0
+      ;;
+    *)
+      echo "Unknown option: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if [[ ! -d "$BUS_DIR" ]]; then
+  echo "[daemon] Error: $BUS_DIR not found. Run ufoo init first." >&2
+  exit 1
+fi
+
+mkdir -p "$BUS_DIR/logs"
+
+if [[ "$DAEMON_MODE" == "1" ]]; then
+  # Check if already running
+  if [[ -f "$PID_FILE" ]]; then
+    existing="$(cat "$PID_FILE" 2>/dev/null || true)"
+    if [[ -n "$existing" ]] && kill -0 "$existing" 2>/dev/null; then
+      echo "[daemon] Already running (pid=$existing)"
+      exit 0
+    fi
+  fi
+
+  echo "[daemon] Starting in background (log: $LOG_FILE)"
+  nohup bash "$0" --interval "$INTERVAL" >> "$LOG_FILE" 2>&1 &
+  echo $! > "$PID_FILE"
+  echo "[daemon] Started (pid=$!)"
+  exit 0
+fi
+
+# Record PID
+echo $$ > "$PID_FILE"
+trap 'rm -f "$PID_FILE" 2>/dev/null || true; rm -rf "$COUNTS_DIR" 2>/dev/null || true' EXIT
+
+echo "[daemon] Started (pid=$$, interval=${INTERVAL}s)"
+echo "[daemon] Watching: $BUS_DIR/queues/*/pending.jsonl"
+
+# Use temp directory to track last known counts (bash 3.x compatible)
+COUNTS_DIR="$BUS_DIR/.daemon-counts.$$"
+mkdir -p "$COUNTS_DIR"
+
+get_last_count() {
+  local safe_name="$1"
+  local count_file="$COUNTS_DIR/$safe_name"
+  if [[ -f "$count_file" ]]; then
+    cat "$count_file"
+  else
+    echo "0"
+  fi
+}
+
+set_last_count() {
+  local safe_name="$1"
+  local count="$2"
+  echo "$count" > "$COUNTS_DIR/$safe_name"
+}
+
+# Cleanup dead agents (check PID and mark offline)
+cleanup_dead_agents() {
+  if [[ ! -f "$BUS_DIR/bus.json" ]]; then
+    return
+  fi
+
+  local changed=0
+  local tmp_file
+  tmp_file=$(mktemp)
+
+  # Get all active subscribers with their PIDs
+  while IFS='|' read -r subscriber pid; do
+    [[ -z "$subscriber" || -z "$pid" ]] && continue
+
+    # Check if PID is still running AND is a claude/codex/node process
+    local proc_cmd
+    proc_cmd=$(ps -p "$pid" -o comm= 2>/dev/null || true)
+    if [[ -z "$proc_cmd" ]] || ! echo "$proc_cmd" | grep -qiE "(claude|codex|node)"; then
+      echo "[daemon] $(date '+%H:%M:%S') Agent $subscriber (pid=$pid) is dead, marking offline"
+
+      # Mark as offline in bus.json
+      jq --arg name "$subscriber" \
+         '.subscribers[$name].status = "offline"' \
+         "$BUS_DIR/bus.json" > "$tmp_file" && mv "$tmp_file" "$BUS_DIR/bus.json"
+      tmp_file=$(mktemp)
+
+      # Clean up queue directory
+      local safe_name="${subscriber//:/_}"
+      rm -rf "$BUS_DIR/queues/${safe_name}" 2>/dev/null || true
+      rm -f "$BUS_DIR/offsets/${safe_name}.offset" 2>/dev/null || true
+
+      changed=1
+    fi
+  done < <(jq -r '.subscribers | to_entries[] | select(.value.status == "active") | "\(.key)|\(.value.pid)"' "$BUS_DIR/bus.json" 2>/dev/null)
+
+  rm -f "$tmp_file" 2>/dev/null || true
+}
+
+CLEANUP_COUNTER=0
+CLEANUP_INTERVAL=5  # Run cleanup every 5 cycles (10 seconds with default interval)
+
+while true; do
+  # Periodic cleanup of dead agents
+  ((CLEANUP_COUNTER++)) || true
+  if [[ $CLEANUP_COUNTER -ge $CLEANUP_INTERVAL ]]; then
+    cleanup_dead_agents
+    CLEANUP_COUNTER=0
+  fi
+  # Find all subscriber queue files
+  for queue_file in "$BUS_DIR/queues"/*/pending.jsonl; do
+    if [[ ! -f "$queue_file" ]]; then
+      continue
+    fi
+
+    # Extract subscriber from path: .ufoo/bus/queues/claude-code_abc123/pending.jsonl
+    dir_name="$(basename "$(dirname "$queue_file")")"
+    # Convert back to subscriber format: claude-code_abc123 -> claude-code:abc123
+    subscriber="${dir_name/_/:}"
+
+    # Get current count
+    if [[ -s "$queue_file" ]]; then
+      count="$(wc -l < "$queue_file" | tr -d ' ')"
+    else
+      count=0
+    fi
+
+    # Get last known count
+    last="$(get_last_count "$dir_name")"
+
+    # If count increased, inject /bus
+    if [[ "$count" -gt "$last" ]]; then
+      echo "[daemon] $(date '+%H:%M:%S') New message for $subscriber ($last -> $count)"
+
+      # Try to inject
+      if bash "$SCRIPT_DIR/bus-inject.sh" "$subscriber" 2>&1; then
+        echo "[daemon] Injected /bus into $subscriber"
+      else
+        echo "[daemon] Failed to inject (window not found or no permission)"
+      fi
+    fi
+
+    set_last_count "$dir_name" "$count"
+  done
+
+  sleep "$INTERVAL"
+done