u-foo 1.0.2 → 1.0.6

package/modules/bus/SKILLS/ubus/SKILL.md

@@ -29,18 +29,28 @@ if [[ ! -d ".ufoo/bus" ]]; then
 fi
 ```
 
-### 2. Check if already joined bus
+### 2. Get or create subscriber ID
 
-Read `.ufoo/bus/bus.json`, check if current session is registered.
-
-If not, auto-join (will auto-generate a friendly nickname like "codex-1", "claude-1"):
+**IMPORTANT**: Always check for existing subscriber ID first to avoid creating duplicates.
 
 ```bash
-SUBSCRIBER=$(ufoo bus join | tail -n 1)
-echo "Joined event bus: $SUBSCRIBER"
-# Example output: codex:0e293156 (nickname: codex-1)
+# Check environment variable first (set by launcher/daemon)
+if [ -n "$UFOO_SUBSCRIBER_ID" ]; then
+  SUBSCRIBER="$UFOO_SUBSCRIBER_ID"
+  echo "Using existing subscriber ID: $SUBSCRIBER"
+else
+  # Not launched via uclaude/ucodex, need to join manually
+  SUBSCRIBER=$(ufoo bus join | tail -n 1)
+  echo "Joined event bus: $SUBSCRIBER"
+  # Example output: codex:0e293156 (nickname: codex-1)
+fi
 ```
 
+**Why this matters**:
+- `uclaude`/`ucodex` automatically set `UFOO_SUBSCRIBER_ID` during launch
+- Re-joining creates a new ID, causing message loss
+- Always reuse existing ID when available
+
 To join with a custom nickname:
 
 ```bash
@@ -127,7 +137,7 @@ Output (now includes nicknames):
 ```
 === Event Bus Status ===
 My identity: claude-code:xyz789
-Online subscribers: 2
+Online agents: 2
   - claude-code:abc123 (architect)
   - claude-code:xyz789 (dev-lead)
 Recent events: 5

package/modules/context/README.md

@@ -1,24 +1,12 @@
 # context
 
-A collaboration protocol that constrains AI behavior through explicit, versioned files.
+Decision-only context module for ufoo.
 
-## Why
-
-AI coding agents (Claude Code, Codex, Cursor, etc.) have two fundamental problems:
-
-1. **No shared memory** — Decisions made in one session are invisible to other agents or future sessions. Each agent starts fresh, repeating mistakes or contradicting prior work.
-
-This protocol solves it by treating decisions and context as files:
-- **Decisions as files** — Persistent, versioned, reviewable. All agents read the same truth.
-
-## Core Principle
-
-```
-Global context defines the law.
-Project context defines the truth.
-```
-
-**Files are truth, not memory.**
+Purpose:
+- Persist decisions in project workspaces
+- Keep decision format canonical in `uctx` skill
+ 
+Bus handles communication; context handles durable decision truth.
 
 ## Quick Start
 
@@ -34,42 +22,32 @@ This repository is the `context` module. The recommended entrypoint is `ufoo`.
 
 Global modules live under `~/.ufoo/modules/`.
 
-### Project: `<project>/.context/` (writable)
+### Project: `<project>/.ufoo/context/` (writable)
 
 ```
-.context/
-├── README.md        # Entry point / how to use this context
-├── SYSTEM.md        # Project architecture
-├── CONSTRAINTS.md   # Non-negotiable rules
-├── ASSUMPTIONS.md   # Current assumptions
-├── TERMINOLOGY.md   # Shared vocabulary
-└── DECISIONS/       # Append-only log
+.ufoo/context/
+├── decisions/       # Append-only decision log (decision-only mode)
+└── decisions.jsonl  # Decision index (ts/type/file/author)
 ```
 
-Must be in Git. Must be reviewable. Truth.
+Should be in the project workspace and writable by agents.
+Versioning is optional but recommended for auditability.
 
-## Protocol Structure
+## Module Structure
 
 ```
 context/                 # This repo
-├── SYSTEM.md               # Protocol definition
-├── RULES.md                # Collaboration rules
-├── CONSTRAINTS.md          # Protocol constraints
-├── DECISION-PROTOCOL.md    # How to write decisions
-├── HANDOFF.md              # Session handoff rules
-├── CONTEXT-STRUCTURE.md    # Project structure spec
-├── TEMPLATES/              # AI behavior constraint
-├── SKILLS/                 # tool skill docs (module-local)
-└── .context/            # Local project context for this repo (ignored; not part of protocol distribution)
+├── README.md               # This file
+├── SKILLS/uctx/SKILL.md    # Canonical decision format + workflow
+└── .ufoo/context/          # Local project context for this repo (ignored; not part of protocol distribution)
 ```
 
 ## For AI Agents
 
 1. Read installed module from `~/.ufoo/modules/context/`
-2. Read/write context from `<project>/.context/`
+2. Read/write decisions in `<project>/.ufoo/context/decisions/`
 3. **Never write to global** — only to project
-4. When unsure, write a decision
-5. Do not modify TEMPLATES/ without a decision
+4. Follow the decision format in `SKILLS/uctx/SKILL.md`
 
 ## Validate
 

package/modules/context/SKILLS/uctx/SKILL.md

@@ -14,12 +14,72 @@ Fast context check for daily use. Run at session start or anytime.
 
 Pre-flight reminder:
 - If the user is asking for evaluation/recommendation/plan, write a decision before replying.
+  Use: `ufoo ctx decisions new "<Title>"`
+
+## Decision format (canonical)
+
+Project context is decision-only. Decisions live at:
+`<project>/.ufoo/context/decisions/`
+
+Decision index (JSONL):
+`<project>/.ufoo/context/decisions.jsonl`
+
+Generate/update the index:
+```bash
+ufoo ctx decisions index
+```
+
+Each JSONL row includes:
+- `ts` (ISO timestamp)
+- `type` (`decision` or `decision_status`)
+- `file` (decision filename)
+- `author` (decision author or resolver)
+
+Create a new decision (recommended before replying when required):
+```bash
+ufoo ctx decisions new "Short Title"
+```
+
+**File naming:** `NNNN-short-title.md` (4-digit prefix + kebab-case slug).
+
+**Template for new decisions:**
+```yaml
+---
+status: open
+---
+# DECISION NNNN: <Title>
+
+Date: YYYY-MM-DD
+Author: <agent>
+
+Context:
+What led to this decision?
+
+Decision:
+What is now considered true?
+
+Implications:
+What must follow from this?
+```
+
+**Status updates (only edit frontmatter):**
+```yaml
+---
+status: resolved
+resolved_by: <agent>
+resolved_at: YYYY-MM-DD
+---
+```
+
+Rules:
+- Decisions are append-only. Do not rewrite past content.
+- Only update the frontmatter when changing status.
 
 ## Workflow
 
 ### 1. Verify structure exists
 
-Check `.ufoo/context/` exists. If missing, tell user to run `uinit` (ufoo init CLI).
+Check `.ufoo/context/decisions/` exists. If missing, tell user to run `ufoo init`.
 
 ### 2. List all decisions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",
@@ -17,13 +17,14 @@
   ],
   "bin": {
     "ufoo": "bin/ufoo.js",
-    "uclaude": "bin/uclaude",
-    "ucodex": "bin/ucodex"
+    "uclaude": "bin/uclaude.js",
+    "ucodex": "bin/ucodex.js"
   },
   "files": [
     "bin/",
     "src/",
     "scripts/",
+    "SKILLS/",
     "modules/",
     "LICENSE",
     "README.md"
@@ -32,9 +33,20 @@
   "engines": {
     "node": ">=18"
   },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
   "dependencies": {
     "blessed": "^0.1.81",
     "chalk": "^4.1.2",
-    "commander": "^13.1.0"
+    "commander": "^13.1.0",
+    "gray-matter": "^4.0.3",
+    "node-pty": "^1.1.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
   }
 }

package/scripts/.archived/bash-to-js-migration/README.md

@@ -0,0 +1,46 @@
+# 已迁移到 JavaScript 的脚本
+
+这些 bash 脚本已经完全迁移到 JavaScript 模块。
+
+## 迁移对照表
+
+| Bash 脚本 | JavaScript 模块 | 状态 |
+|----------|----------------|------|
+| `bus.sh` | `src/bus/index.js` + 7个子模块 | ✅ 完全替换 |
+| `bus-daemon.sh` | `src/bus/daemon.js` | ✅ 完全替换 |
+| `bus-inject.sh` | `src/bus/inject.js` | ✅ 完全替换 |
+| `status.sh` | `src/status/index.js` | ✅ 完全替换 |
+| `skills.sh` | `src/skills/index.js` | ✅ 完全替换 |
+| `init.sh` | `src/init/index.js` | ✅ 完全替换 |
+
+## 迁移完成日期
+
+2026-02-04
+
+## 使用方式
+
+所有命令接口保持不变，直接使用即可：
+
+```bash
+ufoo bus status
+ufoo status  
+ufoo skills list
+ufoo init
+```
+
+## 保留原因
+
+这些脚本被归档保留用于：
+1. 历史参考
+2. 性能对比
+3. 回退备份（如有必要）
+
+## 性能对比
+
+| 指标 | Bash | JavaScript | 差异 |
+|------|------|------------|------|
+| 消息延迟 | 45ms | 51ms | +13% |
+| 并发安全 | ✅ | ✅ | 相同 |
+| 功能完整 | 100% | 100% | 相同 |
+
+性能差异在可接受范围内（<15%），换取更好的可维护性和跨平台支持。

package/scripts/.archived/bash-to-js-migration/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-inject.sh → .archived/bash-to-js-migration/bus-inject.sh}

@@ -54,18 +54,50 @@ else
 fi
 
 # Detect terminal type from tty path or environment
-# iTerm2 uses "write text", Terminal.app uses "do script"
+# Priority: 1) tmux (via stored pane ID), 2) iTerm2, 3) Terminal.app
+
+# Try to get tmux pane info from bus.json (more reliable than tty lookup)
+TMUX_PANE=""
+if command -v jq &>/dev/null && [[ -f "$BUS_DIR/bus.json" ]]; then
+  TMUX_PANE=$(jq -r --arg id "$SUBSCRIBER" '.subscribers[$id].tmux_pane // ""' "$BUS_DIR/bus.json" 2>/dev/null || echo "")
+fi
+
+# Check if this is a tmux session
+USE_TMUX=0
+if [[ -n "$TMUX_PANE" ]] && command -v tmux &>/dev/null; then
+  # Verify the pane still exists
+  if tmux list-panes -a -F '#{pane_id}' 2>/dev/null | grep -q "^${TMUX_PANE}$"; then
+    USE_TMUX=1
+  else
+    echo "[inject] Warning: tmux pane $TMUX_PANE no longer exists" >&2
+    # Fallback: try to find pane by tty
+    TMUX_PANE=$(tmux list-panes -a -F '#{pane_id} #{pane_tty}' 2>/dev/null | grep " ${TARGET_TTY}$" | awk '{print $1}' | head -1)
+    if [[ -n "$TMUX_PANE" ]]; then
+      USE_TMUX=1
+      echo "[inject] Found alternative tmux pane by tty: $TMUX_PANE" >&2
+    fi
+  fi
+fi
 
 # Check if iTerm2 is running and has this tty
 USE_ITERM=0
-if pgrep -q "iTerm2"; then
+if [[ "$USE_TMUX" == "0" ]] && pgrep -q "iTerm2"; then
   # Check if iTerm2 has a session with this tty
   if osascript -e 'tell application "iTerm2" to get tty of current session of current window' 2>/dev/null | grep -q "$TARGET_TTY"; then
     USE_ITERM=1
   fi
 fi
 
-if [[ "$USE_ITERM" == "1" ]]; then
+if [[ "$USE_TMUX" == "1" ]]; then
+  echo "[inject] Using tmux send-keys method for pane: $TMUX_PANE"
+  # Only send C-c if UFOO_INJECT_INTERRUPT is set (to avoid disrupting running agents)
+  if [[ "${UFOO_INJECT_INTERRUPT:-0}" == "1" ]]; then
+    echo "[inject] Sending interrupt (C-c) before command"
+    tmux send-keys -t "$TMUX_PANE" C-c 2>/dev/null || true
+    sleep 0.1
+  fi
+  tmux send-keys -t "$TMUX_PANE" "$INJECT_CMD" Enter
+elif [[ "$USE_ITERM" == "1" ]]; then
   echo "[inject] Using iTerm2 write text method"
   osascript <<EOF
 tell application "iTerm2"

package/scripts/{bus.sh → .archived/bash-to-js-migration/bus.sh}

@@ -295,6 +295,7 @@ cmd_join() {
      --arg ts "$(get_timestamp)" \
      --arg pid "${UFOO_PARENT_PID:-$PPID}" \
      --arg cwd "$(pwd)" \
+     --arg launch_mode "${UFOO_LAUNCH_MODE:-unknown}" \
      '
      .subscribers[$name] = {
         "agent_type": $agent_type,
@@ -306,7 +307,8 @@ cmd_join() {
         "pid": ($pid | tonumber),
         "joined_at": $ts,
         "status": "active",
-        "last_heartbeat": $ts
+        "last_heartbeat": $ts,
+        "launch_mode": $launch_mode
       }
      |
      .agent_types[$agent_type].instances = (

package/scripts/banner.sh

@@ -1,89 +1,2 @@
-#!/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
+#!/bin/bash
+exit 1

package/scripts/postinstall.js

@@ -0,0 +1,59 @@
+/* eslint-disable no-console */
+const path = require("path");
+const fs = require("fs");
+const { spawnSync } = require("child_process");
+
+function run(args) {
+  const bin = path.join(__dirname, "..", "bin", "ufoo.js");
+  const res = spawnSync(process.execPath, [bin, ...args], {
+    stdio: "ignore",
+  });
+  return res.status === 0;
+}
+
+function tryInstall(args, label) {
+  try {
+    run(args);
+  } catch (err) {
+    console.warn(`[postinstall] ${label} failed: ${err.message || String(err)}`);
+  }
+}
+
+// Fix node-pty spawn-helper permissions on macOS (both arm64 and x64)
+function fixNodePtyPermissions() {
+  const platforms = ["darwin-arm64", "darwin-x64"];
+
+  for (const platform of platforms) {
+    try {
+      const spawnHelperPath = path.join(
+        __dirname,
+        "..",
+        "node_modules",
+        "node-pty",
+        "prebuilds",
+        platform,
+        "spawn-helper"
+      );
+
+      if (fs.existsSync(spawnHelperPath)) {
+        const stats = fs.statSync(spawnHelperPath);
+        // Check if executable bit is missing
+        if ((stats.mode & 0o111) === 0) {
+          fs.chmodSync(spawnHelperPath, 0o755);
+          console.log(`[postinstall] Fixed node-pty spawn-helper permissions (${platform})`);
+        }
+      }
+    } catch {
+      // Silently ignore errors - not critical for non-macOS or if node-pty not installed
+    }
+  }
+}
+
+fixNodePtyPermissions();
+
+const skills = ["ufoo", "ubus", "uctx"];
+
+for (const skill of skills) {
+  tryInstall(["skills", "install", skill, "--codex"], `install ${skill} skill (codex)`);
+  tryInstall(["skills", "install", skill], `install ${skill} skill (claude)`);
+}