u-foo 1.2.1 → 1.2.3

package/README.md

@@ -2,7 +2,10 @@
 
 🤖 Multi-agent AI collaboration framework for orchestrating Claude Code, OpenAI Codex, and custom AI agents.
 
+📦 **npm**: [https://www.npmjs.com/package/u-foo](https://www.npmjs.com/package/u-foo)
+
 [![npm version](https://img.shields.io/npm/v/u-foo.svg)](https://www.npmjs.com/package/u-foo)
+[![npm downloads](https://img.shields.io/npm/dm/u-foo.svg)](https://www.npmjs.com/package/u-foo)
 [![License](https://img.shields.io/badge/license-UNLICENSED-red.svg)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
 [![Platform](https://img.shields.io/badge/platform-macOS-blue.svg)](https://www.apple.com/macos)
@@ -35,14 +38,19 @@ ufoo solves the challenge of coordinating multiple AI coding agents:
 ## Installation
 
 ```bash
-# Install globally from npm
+# Install globally from npm (recommended)
 npm install -g u-foo
+```
 
-# Or clone from source
+Or install from source:
+
+```bash
 git clone https://github.com/Icyoung/ufoo.git ~/.ufoo
-cd ~/.ufoo && npm link
+cd ~/.ufoo && npm install && npm link
 ```
 
+After installation, the following commands are available globally: `ufoo`, `uclaude`, `ucodex`, `ucode`.
+
 ## Quick Start
 
 ```bash
@@ -365,77 +373,3 @@ npm test
 ## License
 
 UNLICENSED (Private)
-
-## Recent Changes
-
-### 🎨 UCode Branding & UI Improvements (2026-02-15)
-
-Enhanced ucode agent branding consistency and fixed UI rendering issues:
-
-**Features:**
-- **Consistent Branding** - ucode agents now display as "ucode-1" instead of "ufoo-code-1"
-- **Banner Normalization** - Agent type shows "ucode" in launch banners
-- **UI Width Fix** - Resolved terminal width inconsistency causing background overflow
-- **Immediate Prompt Display** - ucode TUI now shows incoming prompts instantly (not waiting for response)
-
-**Technical Details:**
-- `src/bus/nickname.js` - Maps ufoo-code → ucode for nickname generation
-- `src/utils/banner.js` - Normalized agent type display
-- `src/chat/layout.js` - Fixed blessed log component width handling
-- `src/code/tui.js` - Added onMessageReceived callback for instant display
-
-**Version:** v1.1.9
-
----
-
-### 🚀 Smart Ready Detection & PTY Wrapper (2026-02-06)
-
-Added intelligent agent initialization detection for reliable probe injection:
-
-**Features:**
-- **ReadyDetector** - Monitors PTY output to detect when agents are ready
-- **Smart Probe Timing** - Injects session probe after agent initialization (not before)
-- **Multi-layer Fallback** - 10s ready detection + 8s fallback + 15 retries
-- **Performance Metrics** - Tracks detection time and buffer usage (`UFOO_DEBUG=1`)
-
-**Benefits:**
-- ✅ No more premature probe injection (was 2s, now waits for prompt)
-- ✅ Reliable session ID capture (39 tests, 100% pass)
-- ✅ Production-ready error handling and logging
-
-**Technical Details:**
-- `src/agent/readyDetector.js` - PTY output analysis
-- `src/agent/ptyWrapper.js` - Terminal emulation with monitoring
-- `src/daemon/providerSessions.js` - Early probe triggering support
-
-See `.ufoo/plans/ready-detection-production-checklist.md` for full details.
-
----
-
-### 🎉 Bash to JavaScript Migration (2026-02-04)
-
-We've successfully migrated **80% of the codebase** from Bash to JavaScript for better maintainability and cross-platform support!
-
-**What Changed:**
-- ✅ EventBus core (986 lines) → 8 JavaScript modules
-- ✅ Daemon & inject → Pure JavaScript
-- ✅ status, skills, init → JavaScript modules
-- ⏸️ Context management scripts remain in Bash (complex text processing)
-
-**Impact:**
-- **CLI commands unchanged** - All commands work exactly as before
-- **Performance:** 51ms/message (vs 45ms in Bash, +13%)
-- **Testing:** 20/20 integration tests passing
-- **Quality:** Better error handling, testing, and IDE support
-
-**Learn More:**
-- See [MIGRATION_LOG.md](MIGRATION_LOG.md) for full details
-- View archived scripts in `scripts/.archived/migrated-to-js/`
-- Performance benchmarks in test reports
-
-**Why This Matters:**
-- 🎯 Unified JavaScript tech stack
-- 🧪 Easier to test and maintain
-- 🌍 Cross-platform potential (Windows/Linux)
-- 💡 Better IDE support and refactoring
-- 🚀 Foundation for future enhancements

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",