u-foo 1.0.0

package/LICENSE

@@ -0,0 +1,35 @@
+UFOO Software License Agreement
+Version 1.0, February 2026
+
+Copyright (c) 2026 UFOO Team. All rights reserved.
+
+TERMS AND CONDITIONS
+
+1. GRANT OF LICENSE
+   You are granted a non-exclusive, non-transferable license to use this
+   software for personal and internal business purposes only.
+
+2. RESTRICTIONS
+   You may NOT:
+   - Redistribute, sell, lease, or sublicense this software
+   - Modify, reverse engineer, or create derivative works
+   - Remove or alter any proprietary notices or labels
+   - Use this software to build competing products or services
+
+3. COMMERCIAL USE
+   Commercial use requires a separate commercial license.
+   Contact: license@ufoo.dev
+
+4. NO WARRANTY
+   THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
+   USE AT YOUR OWN RISK.
+
+5. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DAMAGES ARISING
+   FROM THE USE OF THIS SOFTWARE.
+
+6. TERMINATION
+   This license terminates automatically if you violate any terms.
+   Upon termination, you must destroy all copies of the software.
+
+For licensing inquiries: https://ufoo.dev

package/README.md

@@ -0,0 +1,163 @@
+# ufoo
+
+Multi-agent AI collaboration toolkit for Claude Code and OpenAI Codex.
+
+## Features
+
+- **Event Bus** - Real-time inter-agent messaging (`ufoo bus`)
+- **Context Sharing** - Shared decisions and project context (`ufoo ctx`)
+- **Agent Wrappers** - Auto-initialization for Claude Code (`uclaude`) and Codex (`ucodex`)
+- **Skills System** - Extensible agent capabilities (`ufoo skills`)
+
+## Quick Start
+
+```bash
+# Clone and link globally
+git clone <repo> ~/.ufoo
+cd ~/.ufoo && npm link
+
+# Initialize a project
+cd your-project
+ufoo init
+
+# Or use agent wrappers (auto-init + bus join)
+uclaude   # instead of 'claude'
+ucodex    # instead of 'codex'
+```
+
+## Architecture
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   uclaude   │     │   ucodex    │     │  other...   │
+└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
+       │                   │                   │
+       └───────────────────┼───────────────────┘
+                           │
+                    ┌──────▼──────┐
+                    │  ufoo bus   │  Event Bus
+                    └──────┬──────┘
+                           │
+              ┌────────────┼────────────┐
+              │            │            │
+       ┌──────▼──────┐ ┌───▼───┐ ┌──────▼──────┐
+       │  .ufoo/bus  │ │context│ │  decisions  │
+       └─────────────┘ └───────┘ └─────────────┘
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ufoo init` | Initialize .ufoo in current project |
+| `ufoo status` | Show banner, unread bus messages, open decisions |
+| `ufoo daemon --start|--stop|--status` | Manage ufoo daemon |
+| `ufoo chat` | Launch ufoo chat UI (also default when no args) |
+| `ufoo bus join` | Join event bus (auto by uclaude/ucodex) |
+| `ufoo bus send <id> <msg>` | Send message to agent |
+| `ufoo bus check <id>` | Check pending messages |
+| `ufoo bus status` | Show bus status |
+| `ufoo ctx decisions -l` | List all decisions |
+| `ufoo ctx decisions -n 1` | Show latest decision |
+| `ufoo skills list` | List available skills |
+| `ufoo doctor` | Check installation health |
+
+Notes:
+- Claude CLI headless agent uses `--dangerously-skip-permissions`.
+
+## Project Structure
+
+```
+ufoo/
+├── bin/
+│   ├── ufoo         # Main CLI entry (bash)
+│   ├── ufoo.js      # Node wrapper
+│   ├── uclaude      # Claude Code wrapper
+│   └── ucodex       # Codex wrapper
+├── SKILLS/          # Global skills (uinit, ustatus)
+├── scripts/
+│   ├── bus.sh       # Event bus implementation
+│   ├── bus-*.sh     # Bus utilities (inject, daemon, alert)
+│   ├── context-*.sh # Context management
+│   ├── init.sh      # Project initialization
+│   └── skills.sh    # Skills management
+├── modules/
+│   ├── context/     # Decision/context protocol
+│   ├── bus/         # Bus module resources
+│   └── resources/   # UI/icons (optional)
+├── AGENTS.md        # Project instructions (canonical)
+└── CLAUDE.md        # Points to AGENTS.md
+```
+
+## Per-Project Layout
+
+After `ufoo init`, your project gets:
+
+```
+your-project/
+├── .ufoo/
+│   ├── bus/
+│   │   ├── events/      # Event log (append-only)
+│   │   ├── queues/      # Per-agent message queues
+│   │   └── offsets/     # Read position tracking
+│   └── context/
+│       └── DECISIONS/   # Decision records
+├── scripts/             # Symlinked ufoo scripts
+├── AGENTS.md            # Injected protocol blocks
+└── CLAUDE.md            # → AGENTS.md
+```
+
+## Agent Communication
+
+Agents communicate via the event bus:
+
+```bash
+# Agent A sends task to Agent B
+ufoo bus send "codex:abc123" "Please analyze the project structure"
+
+# Agent B checks and executes
+ufoo bus check "codex:abc123"
+# → Executes task automatically
+# → Replies with result
+ufoo bus send "claude-code:xyz789" "分析完成：..."
+```
+
+## Skills (for Agents)
+
+Built-in skills triggered by slash commands:
+
+- `/ubus` - Check and auto-execute pending messages
+- `/uctx` - Quick context status check
+- `/ustatus` - Unified status view (banner, unread bus, open decisions)
+- `/uinit` - Manual .ufoo initialization
+
+## Requirements
+
+- macOS (for Terminal.app/iTerm2 injection features)
+- Node.js >= 18 (optional, for npm global install)
+- Bash 4+
+
+## Codex CLI Notes
+
+If Codex CLI fails with permission errors under `~/.codex` (e.g. sessions dir), set `CODEX_HOME` to a writable path before starting the daemon/chat:
+
+```bash
+export CODEX_HOME="$PWD/.ufoo/codex"
+ufoo daemon start
+ufoo chat
+```
+
+## Development
+
+```bash
+# Local development
+./bin/ufoo --help
+
+# Or via Node
+npm link
+ufoo --help
+```
+
+## License
+
+UNLICENSED (Private)

package/README.zh-CN.md

@@ -0,0 +1,163 @@
+# ufoo
+
+多Agent AI 协作工具包，支持 Claude Code 和 OpenAI Codex。
+
+## 功能特性
+
+- **事件总线** - Agent间实时消息通信 (`ufoo bus`)
+- **上下文共享** - 共享决策和项目上下文 (`ufoo ctx`)
+- **Agent包装器** - Claude Code (`uclaude`) 和 Codex (`ucodex`) 自动初始化
+- **技能系统** - 可扩展的Agent能力 (`ufoo skills`)
+
+## 快速开始
+
+```bash
+# 克隆并全局链接
+git clone <repo> ~/.ufoo
+cd ~/.ufoo && npm link
+
+# 初始化项目
+cd your-project
+ufoo init
+
+# 或使用Agent包装器（自动初始化 + 加入总线）
+uclaude   # 代替 'claude'
+ucodex    # 代替 'codex'
+```
+
+## 架构
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   uclaude   │     │   ucodex    │     │  其他...    │
+└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
+       │                   │                   │
+       └───────────────────┼───────────────────┘
+                           │
+                    ┌──────▼──────┐
+                    │  ufoo bus   │  事件总线
+                    └──────┬──────┘
+                           │
+              ┌────────────┼────────────┐
+              │            │            │
+       ┌──────▼──────┐ ┌───▼───┐ ┌──────▼──────┐
+       │  .ufoo/bus  │ │context│ │  decisions  │
+       └─────────────┘ └───────┘ └─────────────┘
+```
+
+## 命令列表
+
+| 命令 | 说明 |
+|------|------|
+| `ufoo init` | 在当前项目初始化 .ufoo |
+| `ufoo status` | 显示 banner、未读消息和未处理决策 |
+| `ufoo daemon --start|--stop|--status` | 管理 ufoo 守护进程 |
+| `ufoo chat` | 启动 ufoo 交互界面（无参数默认进入） |
+| `ufoo bus join` | 加入事件总线（uclaude/ucodex 自动完成）|
+| `ufoo bus send <id> <msg>` | 发送消息给Agent |
+| `ufoo bus check <id>` | 检查待处理消息 |
+| `ufoo bus status` | 查看总线状态 |
+| `ufoo ctx decisions -l` | 列出所有决策 |
+| `ufoo ctx decisions -n 1` | 显示最新决策 |
+| `ufoo skills list` | 列出可用技能 |
+| `ufoo doctor` | 检查安装状态 |
+
+备注：
+- Claude CLI 的 headless agent 使用 `--dangerously-skip-permissions`。
+
+## 项目结构
+
+```
+ufoo/
+├── bin/
+│   ├── ufoo         # 主 CLI 入口 (bash)
+│   ├── ufoo.js      # Node 包装器
+│   ├── uclaude      # Claude Code 包装器
+│   └── ucodex       # Codex 包装器
+├── SKILLS/          # 全局技能（uinit, ustatus）
+├── scripts/
+│   ├── bus.sh       # 事件总线实现
+│   ├── bus-*.sh     # 总线工具（注入、守护进程、提醒）
+│   ├── context-*.sh # 上下文管理
+│   ├── init.sh      # 项目初始化
+│   └── skills.sh    # 技能管理
+├── modules/
+│   ├── context/     # 决策/上下文协议
+│   ├── bus/         # 总线模块资源
+│   └── resources/   # UI/图标（可选）
+├── AGENTS.md        # 项目指令（规范文件）
+└── CLAUDE.md        # 指向 AGENTS.md
+```
+
+## 项目初始化后的目录结构
+
+执行 `ufoo init` 后，你的项目会包含：
+
+```
+your-project/
+├── .ufoo/
+│   ├── bus/
+│   │   ├── events/      # 事件日志（只追加）
+│   │   ├── queues/      # 每个Agent的消息队列
+│   │   └── offsets/     # 读取位置跟踪
+│   └── context/
+│       └── DECISIONS/   # 决策记录
+├── scripts/             # 软链接的 ufoo 脚本
+├── AGENTS.md            # 注入的协议块
+└── CLAUDE.md            # → AGENTS.md
+```
+
+## Agent通信
+
+Agent通过事件总线通信：
+
+```bash
+# Agent A 向Agent B 发送任务
+ufoo bus send "codex:abc123" "请分析项目结构"
+
+# Agent B 检查并执行
+ufoo bus check "codex:abc123"
+# → 自动执行任务
+# → 回复结果
+ufoo bus send "claude-code:xyz789" "分析完成：..."
+```
+
+## 技能（供Agent使用）
+
+内置技能通过斜杠命令触发：
+
+- `/ubus` - 检查并自动执行待处理消息
+- `/uctx` - 快速检查上下文状态
+- `/ustatus` - 统一状态视图（横幅、未读消息、未决决策）
+- `/uinit` - 手动初始化 .ufoo
+
+## 系统要求
+
+- macOS（用于 Terminal.app/iTerm2 注入功能）
+- Node.js >= 18（可选，用于 npm 全局安装）
+- Bash 4+
+
+## Codex CLI 说明
+
+如果 Codex CLI 在 `~/.codex` 下报权限错误（例如 sessions 目录），请在启动 daemon/chat 前设置可写的 `CODEX_HOME`：
+
+```bash
+export CODEX_HOME="$PWD/.ufoo/codex"
+ufoo daemon start
+ufoo chat
+```
+
+## 开发
+
+```bash
+# 本地开发
+./bin/ufoo --help
+
+# 或通过 Node
+npm link
+ufoo --help
+```
+
+## 许可证
+
+UNLICENSED（私有）

package/bin/uclaude

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# uclaude: Launch Claude Code and auto-join event bus
+#
+# Usage: uclaude [claude args...]
+
+set -euo pipefail
+
+# Resolve symlinks to get real script location
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" != /* ]] && SCRIPT_PATH="$SCRIPT_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Source banner
+source "$PROJECT_ROOT/scripts/banner.sh" 2>/dev/null || true
+
+# Check and initialize .ufoo (silent)
+if [[ ! -d ".ufoo/bus" ]]; then
+  ufoo init --modules context,bus &>/dev/null || true
+fi
+
+# Check if AGENTS.md has ufoo template (inject if not)
+if [[ -f "AGENTS.md" ]] && ! grep -q "<!-- ufoo -->" "AGENTS.md" 2>/dev/null; then
+  ufoo init --modules context,bus &>/dev/null || true
+fi
+
+# Generate or reuse session ID
+if [[ -z "${CLAUDE_SESSION_ID:-}" ]]; then
+  export CLAUDE_SESSION_ID="$(date +%s%N | shasum | head -c 8)"
+fi
+
+# Join event bus (using fixed session ID)
+# Export our PID so bus.sh registers the correct process
+export UFOO_PARENT_PID=$$
+NICKNAME="${UFOO_NICKNAME:-}"
+SUBSCRIBER=$(ufoo bus join "$CLAUDE_SESSION_ID" claude-code "$NICKNAME" 2>/dev/null | tail -1)
+
+# Auto-start project-level daemon (if not running)
+DAEMON_STATUS=""
+PID_FILE=".ufoo/bus/.daemon.pid"
+if [[ -f "$PID_FILE" ]]; then
+  existing="$(cat "$PID_FILE" 2>/dev/null || true)"
+  if [[ -n "$existing" ]] && kill -0 "$existing" 2>/dev/null; then
+    DAEMON_STATUS="running"
+  else
+    ufoo bus daemon --daemon &>/dev/null && DAEMON_STATUS="started"
+  fi
+else
+  ufoo bus daemon --daemon &>/dev/null && DAEMON_STATUS="started"
+fi
+
+# Show banner
+if type show_banner &>/dev/null; then
+  show_banner "claude" "$CLAUDE_SESSION_ID" "$SUBSCRIBER" "$DAEMON_STATUS"
+else
+  echo "[uclaude] Connected -> $SUBSCRIBER"
+  echo "[uclaude] Daemon: $DAEMON_STATUS"
+  echo ""
+fi
+
+exec claude "$@"

package/bin/ucodex

@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# ucodex: Launch Codex and auto-join event bus
+#
+# Usage: ucodex [codex args...]
+
+set -euo pipefail
+
+# Resolve symlinks to get real script location
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" != /* ]] && SCRIPT_PATH="$SCRIPT_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Source banner
+source "$PROJECT_ROOT/scripts/banner.sh" 2>/dev/null || true
+
+# Check and initialize .ufoo (silent)
+if [[ ! -d ".ufoo/bus" ]]; then
+  ufoo init --modules context,bus &>/dev/null || true
+fi
+
+# Check if AGENTS.md has ufoo template (inject if not)
+if [[ -f "AGENTS.md" ]] && ! grep -q "<!-- ufoo -->" "AGENTS.md" 2>/dev/null; then
+  ufoo init --modules context,bus &>/dev/null || true
+fi
+
+# Generate or reuse session ID
+if [[ -z "${CODEX_SESSION_ID:-}" ]]; then
+  export CODEX_SESSION_ID="$(date +%s%N | shasum | head -c 8)"
+fi
+
+# Join event bus (using fixed session ID)
+# Export our PID so bus.sh registers the correct process
+export UFOO_PARENT_PID=$$
+NICKNAME="${UFOO_NICKNAME:-}"
+SUBSCRIBER=$(ufoo bus join "$CODEX_SESSION_ID" codex "$NICKNAME" 2>/dev/null | tail -1)
+
+# Auto-start project-level daemon (if not running)
+DAEMON_STATUS=""
+PID_FILE=".ufoo/bus/.daemon.pid"
+if [[ -f "$PID_FILE" ]]; then
+  existing="$(cat "$PID_FILE" 2>/dev/null || true)"
+  if [[ -n "$existing" ]] && kill -0 "$existing" 2>/dev/null; then
+    DAEMON_STATUS="running"
+  else
+    ufoo bus daemon --daemon &>/dev/null && DAEMON_STATUS="started"
+  fi
+else
+  ufoo bus daemon --daemon &>/dev/null && DAEMON_STATUS="started"
+fi
+
+# Show banner
+if type show_banner &>/dev/null; then
+  show_banner "codex" "$CODEX_SESSION_ID" "$SUBSCRIBER" "$DAEMON_STATUS"
+else
+  echo "[ucodex] Connected -> $SUBSCRIBER"
+  echo "[ucodex] Daemon: $DAEMON_STATUS"
+  echo ""
+fi
+
+exec codex "$@"

package/bin/ufoo

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+usage() {
+  cat <<'USAGE'
+ufoo
+
+Monorepo layout:
+  ~/.ufoo/                   (clone of ufoo)
+    modules/ai-context/              (protocol module)
+    modules/ai-resources/            (optional resources)
+
+Usage:
+  ufoo doctor
+  ufoo status
+  ufoo daemon --start|--stop|--status
+  ufoo chat
+  ufoo init [--modules context[,resources]] [--project <dir>]
+  ufoo bus <...>            # delegates to ./scripts/bus.sh in the current project
+  ufoo ctx <...>            # delegates to ./scripts/ai-context-*.sh in the current project
+  ufoo skills list
+  ufoo skills install <name|all> [--codex|--agents|--target <dir>]
+
+Notes:
+  - `init` creates/updates <project>/.ai-context and injects CLAUDE.md/AGENTS.md blocks.
+  - For Codex notifications, prefer `scripts/bus-alert.sh` / `scripts/bus-listen.sh` (no IME issues).
+USAGE
+}
+
+cmd="${1:-}"
+shift || true
+
+case "$cmd" in
+  ""|--help|-h)
+    exec node "$repo_root/bin/ufoo.js" chat
+    ;;
+  doctor)
+    exec bash "$repo_root/scripts/doctor.sh"
+    ;;
+  status)
+    exec bash "$repo_root/scripts/status.sh"
+    ;;
+  daemon)
+    exec node "$repo_root/bin/ufoo.js" daemon "$@"
+    ;;
+  chat)
+    exec node "$repo_root/bin/ufoo.js" chat
+    ;;
+  init)
+    exec bash "$repo_root/scripts/init.sh" "$@"
+    ;;
+  bus)
+    # Project-local bus commands. Must be run from within the target project.
+    if [[ ! -x "./scripts/bus.sh" ]]; then
+      echo "FAIL: missing ./scripts/bus.sh. Run: ufoo init --modules bus" >&2
+      exit 1
+    fi
+    exec bash "./scripts/bus.sh" "$@"
+    ;;
+  ctx)
+    # Project-local ctx commands. Must be run from within the target project.
+    sub="${1:-doctor}"
+    shift || true
+    case "$sub" in
+      doctor)
+        exec bash "./scripts/ai-context-doctor.sh" "$@"
+        ;;
+      lint)
+        exec bash "./scripts/ai-context-lint.sh" "$@"
+        ;;
+      decisions)
+        exec bash "./scripts/ai-context-decisions.sh" "$@"
+        ;;
+      *)
+        echo "Unknown ctx subcommand: $sub" >&2
+        echo "Supported: doctor, lint, decisions" >&2
+        exit 1
+        ;;
+    esac
+    ;;
+  skills)
+    sub="${1:-}"
+    shift || true
+    exec bash "$repo_root/scripts/skills.sh" "$sub" "$@"
+    ;;
+  *)
+    echo "Unknown command: $cmd" >&2
+    usage >&2
+    exit 1
+    ;;
+esac

package/bin/ufoo.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+const { runCli } = require("../src/cli");
+const { runDaemonCli } = require("../src/daemon/run");
+const { runChat } = require("../src/chat");
+const { runInternalRunner } = require("../src/agent/internalRunner");
+
+const cmd = process.argv[2];
+
+async function main() {
+  if (!cmd) {
+    await runChat(process.cwd());
+    return;
+  }
+  if (cmd === "daemon") {
+    runDaemonCli(process.argv.slice(2));
+    return;
+  }
+  if (cmd === "agent-runner") {
+    const agentType = process.argv[3] || "codex";
+    await runInternalRunner({ projectRoot: process.cwd(), agentType });
+    return;
+  }
+  if (cmd === "chat") {
+    await runChat(process.cwd());
+    return;
+  }
+  await runCli(process.argv);
+}
+
+main().catch((err) => {
+  const message = err && err.stack ? err.stack : String(err);
+  console.error(message);
+  process.exitCode = 1;
+});