u-foo 2.4.6 → 2.4.7

package/README.md

@@ -69,7 +69,7 @@ Initialize a project and open the chat dashboard:
 
 ```bash
 cd your-project
-ufoo init --modules context,bus
+ufoo init --targets context,bus
 ufoo
 ```
 
@@ -167,7 +167,7 @@ still available, but the normal ufoo workflow is to work from chat.
 These are setup or troubleshooting commands. In chat, use slash commands:
 
 ```text
-/init context bus resources
+/init context bus
 /doctor
 /status
 /daemon status
@@ -177,11 +177,11 @@ These are setup or troubleshooting commands. In chat, use slash commands:
 ```
 
 `ufoo init` creates `.ufoo/`, ensures `AGENTS.md` and `CLAUDE.md`, initializes
-selected modules, and prepares shared storage. `CLAUDE.md` may be a symlink;
-edit project instructions in `AGENTS.md`.
+selected workspace state, and prepares shared storage. `CLAUDE.md` may be a
+symlink; edit project instructions in `AGENTS.md`.
 
 Before a project has been initialized, the equivalent CLI form is also useful:
-`ufoo init --modules context,bus`.
+`ufoo init --targets context,bus`.
 
 ### Event Bus
 

package/README.zh-CN.md

@@ -67,7 +67,7 @@ npm link
 
 ```bash
 cd your-project
-ufoo init --modules context,bus
+ufoo init --targets context,bus
 ufoo
 ```
 
@@ -163,7 +163,7 @@ ufoo -g
 这些是初始化或排障命令。进入 chat 后优先使用 slash command：
 
 ```text
-/init context bus resources
+/init context bus
 /doctor
 /status
 /daemon status
@@ -173,10 +173,10 @@ ufoo -g
 ```
 
 `ufoo init` 会创建 `.ufoo/`，确保 `AGENTS.md` 和 `CLAUDE.md` 存在，
-初始化选中的模块，并准备共享存储。`CLAUDE.md` 可以是 symlink；项目指令
-优先编辑 `AGENTS.md`。
+初始化选中的工作区状态，并准备共享存储。`CLAUDE.md` 可以是 symlink；
+项目指令优先编辑 `AGENTS.md`。
 
-项目尚未初始化时，也可以先在外部执行等价 CLI：`ufoo init --modules context,bus`。
+项目尚未初始化时，也可以先在外部执行等价 CLI：`ufoo init --targets context,bus`。
 
 ### 事件总线
 

package/SKILLS/ufoo/SKILL.md

@@ -13,7 +13,7 @@ ufoo is the multi-agent coordination layer. It provides four capabilities:
 1. **Context Decisions** — Sparse log of major plan-level choices shared across agents
 2. **Shared Memory** — Durable, low-noise project facts shared across agents
 3. **Event Bus** — Inter-agent messaging
-4. **Initialization** — Project setup for ufoo modules
+4. **Initialization** — Project setup for ufoo workspace state
 
 ## 1. Context Decisions (uctx)
 
@@ -199,7 +199,7 @@ ufoo history prompt [limit]     # Render as injectable prompt block
 Trigger: `/uinit` or `/ufoo init`
 
 ```bash
-ufoo init --modules context,bus --project $(pwd)
+ufoo init --targets context,bus --project $(pwd)
 ```
 
 After init, auto-join bus if enabled.

package/SKILLS/uinit/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: uinit
 description: |
-  Initialize ufoo modules in current project.
+  Initialize ufoo workspace state in current project.
   Use when: (1) new project needs context/bus enabled, (2) user inputs /uinit or /ufoo init.
-  Provides interactive module selection, defaults to all selected.
+  Provides interactive target selection, defaults to all selected.
 ---
 
 # uinit
 
-Initialize ufoo modules in current project.
+Initialize ufoo workspace state in current project.
 
 ## Trigger
 
@@ -16,22 +16,20 @@ User inputs `/uinit` or `/ufoo init`
 
 ## Execution Flow
 
-### 1. Ask user to select modules
+### 1. Ask user to select init targets
 
 Use AskUserQuestion tool, provide multi-select, default all selected:
 
 ```
-Please select modules to enable:
+Please select ufoo state to enable:
 
 ☑ context - Shared context protocol (.ufoo/context/)
 ☑ bus - Agent event bus (.ufoo/bus/ + .ufoo/agent/)
-☐ resources - UI/Icons resources (optional)
 ```
 
 Options:
 - `context` (recommended) - Shared context, sparse decision log for major plan-level choices
 - `bus` (recommended) - Multi-agent communication, task delegation, message passing
-- `resources` (optional) - UI tone guide, icon library
 
 Default selected: context, bus
 
@@ -40,10 +38,10 @@ Default selected: context, bus
 Based on user selection, execute:
 
 ```bash
-ufoo init --modules <selected_modules> --project $(pwd)
+ufoo init --targets <selected_targets> --project $(pwd)
 ```
 
-### 3. If bus module selected, auto-join bus
+### 3. If bus target selected, auto-join bus
 
 ```bash
 SUBSCRIBER="${UFOO_SUBSCRIBER_ID:-$(ufoo bus whoami 2>/dev/null || true)}"
@@ -60,7 +58,7 @@ fi
 ```
 === ufoo initialization complete ===
 
-Enabled modules:
+Enabled ufoo state:
   ✓ core memory → .ufoo/memory/
   ✓ context → .ufoo/context/
   ✓ bus → .ufoo/bus/ + .ufoo/agent/
@@ -76,4 +74,3 @@ Next steps:
 
 - If .ufoo/memory, .ufoo/context, .ufoo/bus, or .ufoo/agent already exists, skip creation
 - After initialization, reuse existing subscriber ID first, join only as fallback (if bus enabled)
-- AGENTS.md will have protocol description block injected

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "2.4.6",
+  "version": "2.4.7",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",
@@ -29,7 +29,6 @@
     "online/",
     "scripts/",
     "SKILLS/",
-    "modules/",
     "LICENSE",
     "README.md"
   ],

package/src/agents/launch/launcher.js

@@ -323,23 +323,11 @@ class AgentLauncher {
 
     if (!fs.existsSync(busDir)) {
       // 调用 ufoo init
-      spawnSync("ufoo", ["init", "--modules", "context,bus"], {
+      spawnSync("ufoo", ["init", "--targets", "context,bus"], {
         cwd: this.cwd,
         stdio: "ignore",
       });
     }
-
-    // 检查 AGENTS.md 是否有 ufoo template
-    const agentsFile = path.join(this.cwd, "AGENTS.md");
-    if (fs.existsSync(agentsFile)) {
-      const content = fs.readFileSync(agentsFile, "utf8");
-      if (!content.includes("<!-- ufoo -->")) {
-        spawnSync("ufoo", ["init", "--modules", "context,bus"], {
-          cwd: this.cwd,
-          stdio: "ignore",
-        });
-      }
-    }
   }
 
   /**

package/src/app/chat/commandExecutor.js

@@ -303,7 +303,7 @@ function createCommandExecutor(options = {}) {
   }
 
   async function handleInitCommand(args = []) {
-    logMessage("system", "{white-fg}⚙{/white-fg} Initializing ufoo modules...");
+    logMessage("system", "{white-fg}⚙{/white-fg} Initializing ufoo workspace...");
 
     await withCapturedConsole(
       {
@@ -319,8 +319,8 @@ function createCommandExecutor(options = {}) {
         try {
           const repoRoot = path.join(__dirname, "..", "..");
           const init = createInit(repoRoot);
-          const modules = args.length > 0 ? args.join(",") : "context,bus";
-          await init.init({ modules, project: projectRoot });
+          const targets = args.length > 0 ? args.join(",") : "context,bus";
+          await init.init({ targets, project: projectRoot });
 
           logMessage("system", "{white-fg}✓{/white-fg} Initialization complete");
           renderScreen();

package/src/app/chat/commands.js

@@ -47,7 +47,7 @@ const COMMAND_TREE = {
       templates: { desc: "List available templates" },
     },
   },
-  "/init": { desc: "Initialize modules" },
+  "/init": { desc: "Initialize workspace" },
   "/multi": { desc: "Toggle multi-window agent view" },
   "/open": { desc: "Open project path in global mode" },
   "/launch": {
@@ -305,7 +305,7 @@ function describeCommandForChat(text) {
   if (command === "multi") return "Toggling multi-pane view";
   if (command === "open") return `Opening project ${args[0] || ""}`.trim();
   if (command === "resume") return args[0] === "list" ? "Listing recoverable agents" : `Resuming ${args[0] || "agents"}`;
-  if (command === "init") return "Initializing ufoo modules";
+  if (command === "init") return "Initializing ufoo workspace";
 
   return `Running /${command}`;
 }

package/src/app/cli/features/doctor.js

@@ -14,29 +14,22 @@ class RepoDoctor {
   }
 
   run() {
-    const contextMod = path.join(this.repoRoot, "modules", "context");
+    const skillsDir = path.join(this.repoRoot, "SKILLS");
+    const contextSkill = path.join(skillsDir, "uctx", "SKILL.md");
+    const busSkill = path.join(skillsDir, "ubus", "SKILL.md");
 
-    const contextExists = fs.existsSync(contextMod);
-    if (!contextExists) {
-      this.fail(`missing ${contextMod}`);
-    }
+    if (!fs.existsSync(contextSkill)) this.fail(`missing ${contextSkill}`);
+    if (!fs.existsSync(busSkill)) this.fail(`missing ${busSkill}`);
 
-    if (contextExists) {
-      const contextDoctor = new ContextDoctor(this.repoRoot);
-      const ok = contextDoctor.lintProtocol();
-      if (!ok) this.failed = true;
-    }
+    const contextDoctor = new ContextDoctor(this.repoRoot);
+    const ok = contextDoctor.lintProtocol();
+    if (!ok) this.failed = true;
 
     console.log("=== ufoo doctor ===");
     console.log(`Monorepo: ${this.repoRoot}`);
-    console.log("Modules:");
-    if (contextExists) {
-      console.log(`- context: ${contextMod}`);
-    }
-    const resources = path.join(this.repoRoot, "modules", "resources");
-    if (fs.existsSync(resources)) {
-      console.log(`- resources: ${resources}`);
-    }
+    console.log("Skills:");
+    if (fs.existsSync(contextSkill)) console.log(`- uctx: ${contextSkill}`);
+    if (fs.existsSync(busSkill)) console.log(`- ubus: ${busSkill}`);
 
     if (this.failed) {
       console.log("Status: FAILED");

package/src/app/cli/features/init.js

@@ -7,23 +7,22 @@ const path = require("path");
 class UfooInit {
   constructor(repoRoot) {
     this.repoRoot = repoRoot;
-    this.contextMod = path.join(repoRoot, "modules", "context");
-    this.busMod = path.join(repoRoot, "modules", "bus");
-    this.resourcesMod = path.join(repoRoot, "modules", "resources");
-    this.agentsTemplate = path.join(repoRoot, "modules", "AGENTS.template.md");
   }
 
   /**
    * 初始化项目
    */
   async init(options = {}) {
-    const modules = (options.modules || "context").split(",");
+    const targets = (options.targets || options.modules || "context")
+      .split(",")
+      .map((item) => item.trim())
+      .filter(Boolean);
     const project = options.project || process.cwd();
     const controllerMode = options.controllerMode === true;
 
     console.log("=== ufoo init ===");
     console.log(`Project directory: ${project}`);
-    console.log(`Modules: ${modules.join(", ")}`);
+    console.log(`Targets: ${targets.join(", ")}`);
     console.log();
 
     if (!controllerMode) {
@@ -33,24 +32,17 @@ class UfooInit {
     // 初始化核心
     this.initCore(project, { controllerMode });
 
-    if (!controllerMode) {
-      this.injectAgentsTemplate(project);
-    }
-
-    // 初始化各模块
-    for (const module of modules) {
-      switch (module.trim()) {
+    // Initialize selected workspace features.
+    for (const target of targets) {
+      switch (target) {
         case "context":
           this.initContext(project);
           break;
         case "bus":
           await this.initBus(project);
           break;
-        case "resources":
-          this.initResources(project);
-          break;
         default:
-          console.error(`Unknown module: ${module}`);
+          console.error(`Unknown init target: ${target}`);
       }
     }
 
@@ -121,106 +113,7 @@ class UfooInit {
   }
 
   /**
-   * 注入 ufoo 模板到 AGENTS.md / CLAUDE.md
-   */
-  injectAgentsTemplate(project) {
-    if (!fs.existsSync(this.agentsTemplate)) {
-      console.log("[template] AGENTS.template.md not found, skipping");
-      return;
-    }
-
-    const template = fs.readFileSync(this.agentsTemplate, "utf8");
-    const targets = this.resolveTemplateTargets(project);
-    if (targets.length === 0) {
-      console.log("[template] No target markdown files found, skipping");
-      return;
-    }
-
-    const labels = targets.map((file) => path.relative(project, file) || path.basename(file));
-    console.log(`[template] Injecting ufoo template into: ${labels.join(", ")}`);
-
-    for (const file of targets) {
-      this.injectTemplateIntoFile(file, template);
-    }
-
-    console.log("[template] Done");
-  }
-
-  resolveTemplateTargets(project) {
-    const agentsFile = path.resolve(path.join(project, "AGENTS.md"));
-    const claudeFile = path.resolve(path.join(project, "CLAUDE.md"));
-    const targets = new Set();
-
-    if (fs.existsSync(agentsFile)) {
-      targets.add(agentsFile);
-    }
-
-    const claudeStat = this.safeLstat(claudeFile);
-    if (!claudeStat) return Array.from(targets);
-
-    if (claudeStat.isSymbolicLink()) {
-      try {
-        const rawTarget = fs.readlinkSync(claudeFile);
-        const sourceFile = path.resolve(path.dirname(claudeFile), rawTarget);
-        const projectRoot = path.resolve(project);
-        const inProject = sourceFile === projectRoot || sourceFile.startsWith(`${projectRoot}${path.sep}`);
-        if (inProject) {
-          targets.add(sourceFile);
-        } else {
-          console.warn(`[template] CLAUDE.md symlink target outside project, skipped: ${sourceFile}`);
-        }
-      } catch {
-        // ignore broken symlink
-      }
-      return Array.from(targets);
-    }
-
-    targets.add(claudeFile);
-    return Array.from(targets);
-  }
-
-  injectTemplateIntoFile(filePath, template) {
-    if (!fs.existsSync(filePath)) return;
-
-    let content = fs.readFileSync(filePath, "utf8");
-    const marker = "<!-- ufoo-template -->";
-    const block = `${marker}\n${template}\n${marker}`;
-
-    if (content.includes(marker)) {
-      const startIdx = content.indexOf(marker);
-      const endIdx = content.indexOf(marker, startIdx + marker.length);
-      if (endIdx !== -1) {
-        content = content.slice(0, startIdx) + block + content.slice(endIdx + marker.length);
-      } else {
-        content = content.slice(0, startIdx) + block + content.slice(startIdx + marker.length);
-      }
-    } else {
-      const headingEnd = this.findFirstHeadingEnd(content);
-      if (headingEnd !== -1) {
-        content = content.slice(0, headingEnd) + `\n${block}\n\n` + content.slice(headingEnd);
-      } else {
-        content = `${block}\n\n${content}`;
-      }
-    }
-    fs.writeFileSync(filePath, content, "utf8");
-  }
-
-  findFirstHeadingEnd(content) {
-    const atxHeading = content.match(/^(?:[ \t]{0,3})#{1,6}[ \t]*[^\n]*(?:\n|$)/m);
-    const setextHeading = content.match(/^[^\n]+\n(?:=+|-+)[ \t]*(?:\n|$)/m);
-
-    let bestMatch = null;
-    if (atxHeading && setextHeading) {
-      bestMatch = atxHeading.index <= setextHeading.index ? atxHeading : setextHeading;
-    } else {
-      bestMatch = atxHeading || setextHeading;
-    }
-    if (!bestMatch) return -1;
-    return bestMatch.index + bestMatch[0].length;
-  }
-
-  /**
-   * 初始化 context 模块
+   * 初始化 context
    */
   initContext(project) {
     console.log("[context] Initializing decision-only context...");
@@ -247,10 +140,10 @@ class UfooInit {
   }
 
   /**
-   * 初始化 bus 模块
+   * 初始化 bus
    */
   async initBus(project) {
-    console.log("[bus] Initializing bus module...");
+    console.log("[bus] Initializing bus...");
 
     const EventBus = require("../../../coordination/bus");
     const bus = new EventBus(project);
@@ -263,78 +156,6 @@ class UfooInit {
     }
   }
 
-  /**
-   * 初始化 resources 模块
-   */
-  initResources(project) {
-    if (!fs.existsSync(this.resourcesMod)) {
-      console.log("[resources] Module not found, skipping");
-      return;
-    }
-
-    console.log("[resources] Initializing resources module...");
-
-    const targetDir = path.join(project, ".ufoo", "resources");
-
-    // 复制模块内容
-    this.copyModuleContent(this.resourcesMod, targetDir);
-
-    console.log("[resources] Done");
-  }
-
-  /**
-   * 复制模块内容
-   */
-  copyModuleContent(src, dest) {
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
-    }
-
-    // 复制所有文件和目录（排除 .git、node_modules 等）
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-
-    for (const entry of entries) {
-      // 跳过特殊目录
-      if (entry.name.startsWith(".") || entry.name === "node_modules") {
-        continue;
-      }
-
-      const srcPath = path.join(src, entry.name);
-      const destPath = path.join(dest, entry.name);
-
-      if (entry.isDirectory()) {
-        this.copyRecursive(srcPath, destPath);
-      } else {
-        fs.copyFileSync(srcPath, destPath);
-      }
-    }
-  }
-
-  /**
-   * 递归复制目录
-   */
-  copyRecursive(src, dest) {
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
-    }
-
-    const entries = fs.readdirSync(src, { withFileTypes: true });
-
-    for (const entry of entries) {
-      if (entry.name.startsWith(".") || entry.name === "node_modules") {
-        continue;
-      }
-
-      const srcPath = path.join(src, entry.name);
-      const destPath = path.join(dest, entry.name);
-
-      if (entry.isDirectory()) {
-        this.copyRecursive(srcPath, destPath);
-      } else {
-        fs.copyFileSync(srcPath, destPath);
-      }
-    }
-  }
 }
 
 module.exports = UfooInit;

package/src/app/cli/run.js

@@ -535,7 +535,7 @@ async function runCli(argv) {
   const chalk = requireOptional("chalk") || { cyan: (s) => s, red: (s) => s };
 
   if (commander && commander.Command) {
-    const { Command } = commander;
+    const { Command, Option } = commander;
     const program = new Command();
 
     program
@@ -1074,10 +1074,10 @@ async function runCli(argv) {
         }
       });
 
-    program
+    const initCommand = program
       .command("init")
-      .description("Initialize modules in a project")
-      .option("--modules <list>", "Comma-separated modules (context,bus,resources)", "context")
+      .description("Initialize ufoo workspace state in a project")
+      .option("--targets <list>", "Comma-separated init targets (context,bus)")
       .option("--project <dir>", "Target project directory", process.cwd())
       .action(async (opts) => {
         const UfooInit = require("./features/init");
@@ -1090,6 +1090,11 @@ async function runCli(argv) {
           process.exitCode = 1;
         }
       });
+    if (Option && typeof Option === "function") {
+      initCommand.addOption(new Option("--modules <list>", "Deprecated alias for --targets").hideHelp());
+    } else {
+      initCommand.option("--modules <list>", "Deprecated alias for --targets");
+    }
 
     const skills = program.command("skills").description("Manage skills templates");
     skills
@@ -1713,7 +1718,7 @@ async function runCli(argv) {
     console.log("  ufoo recover [list [target] | run <target>] [--json]");
     console.log("  ufoo report <start|progress|done|error|list> [message] [--task <id>] [--agent <id>]");
     console.log("  ufoo ucode [doctor|prepare|build] [--skip-install]");
-    console.log("  ufoo init [--modules <list>] [--project <dir>]");
+    console.log("  ufoo init [--targets <list>] [--project <dir>]");
     console.log("  ufoo skills list");
     console.log("  ufoo skills install <name|all> [--target <dir> | --codex | --agents]");
     console.log("  ufoo group templates [list|ls] [--json]");
@@ -2058,7 +2063,7 @@ async function runCli(argv) {
     };
 
     const opts = {
-      modules: getOpt("--modules", "context"),
+      targets: getOpt("--targets", getOpt("--modules", "context")),
       project: getOpt("--project", process.cwd()),
     };
 

package/src/coordination/context/doctor.js

@@ -83,21 +83,17 @@ class ContextDoctor {
   }
 
   /**
-   * Lint 协议 repo（modules/context）
+   * Lint bundled context skill.
    */
   lintProtocol() {
-    const moduleRoot = path.join(this.projectRoot, "modules", "context");
     const repoSkill = path.join(this.projectRoot, "SKILLS", "uctx", "SKILL.md");
 
-    if (!fs.existsSync(moduleRoot)) {
-      console.log("No protocol module found (skipping protocol lint)");
+    if (!fs.existsSync(repoSkill)) {
+      console.log("No bundled context skill found (skipping protocol lint)");
       return true;
     }
 
-    console.log(`Linting protocol repo: ${moduleRoot}`);
-
-    // Check minimal module files
-    this.checkFile(path.join(moduleRoot, "README.md"), "README.md");
+    console.log(`Linting bundled context skill: ${repoSkill}`);
     this.checkFile(repoSkill, "SKILLS/uctx/SKILL.md");
 
     return !this.failed;
@@ -153,20 +149,6 @@ class ContextDoctor {
       }
     }
 
-    // Check global modules
-    const globalContext = path.join(
-      process.env.HOME,
-      ".ufoo",
-      "modules",
-      "context"
-    );
-    if (!fs.existsSync(globalContext)) {
-      console.log("");
-      console.log(
-        `WARN: ${globalContext} not found (install via ufoo for best UX)`
-      );
-    }
-
     console.log("");
     if (this.failed) {
       console.log("Status: FAILED");

package/src/runtime/daemon/index.js

@@ -1438,7 +1438,7 @@ function startDaemon({ projectRoot, provider, model, resumeMode = "auto" }) {
           if (!fs.existsSync(targetPaths.ufooDir)) {
             const repoRoot = path.join(__dirname, "..", "..", "..");
             const init = new (require("../../app/cli/features/init"))(repoRoot);
-            await init.init({ modules: "context,bus", project: root });
+            await init.init({ targets: "context,bus", project: root });
           }
           if (!isRunning(root)) {
             cleanupStaleState(root);

package/src/runtime/daemon/mcpServer.js

@@ -400,7 +400,7 @@ async function ensureGlobalControllerDaemon(options = {}) {
     const UfooInit = require("../../app/cli/features/init");
     const init = new UfooInit(PACKAGE_ROOT);
     await suppressConsoleToStderr(() => init.init({
-      modules: "context,bus",
+      targets: "context,bus",
       project: root,
       controllerMode: true,
     }));

package/src/runtime/terminal/index.js

@@ -1,5 +1,5 @@
 /**
- * Terminal detection and feature modules.
+ * Terminal detection and feature helpers.
  */
 
 const detect = require("./detect");

package/src/ui/ink/ChatApp.js

@@ -3549,7 +3549,7 @@ async function runChatInk(projectRoot, options = {}) {
     const repoRoot = path.join(__dirname, "..", "..", "..");
     const init = new env.UfooInit(repoRoot);
     await init.init({
-      modules: "context,bus",
+      targets: "context,bus",
       project: projectRoot,
       controllerMode: env.globalMode,
     });

package/modules/AGENTS.template.md

@@ -1,8 +0,0 @@
-<!-- ufoo -->
-## ufoo Agent Protocol
-
-> **Default: do not write a decision.** Record one only for important, plan-level knowledge that should constrain future work: architectural choices, trade-off analysis, cross-agent coordination, or precedent-setting integration contracts. NOT for routine findings, simple fixes, or because the user asked for a plan/evaluation/recommendation. Durable project facts belong in shared memory, not decisions. → `ufoo ctx decisions new "Title"` BEFORE acting only when that high bar is met.
-> **Read shared memory before writing it.** Durable facts live in `.ufoo/memory/`; use `ufoo memory list/show`, `recall`, `search_memory`, or redacted `search_history` evidence before `remember` / `edit_memory`.
-> **Auto-execute bus messages.** On `ubus`: execute tasks immediately, then `ufoo bus ack`. Never ask the user.
-> **Full protocol**: `/ufoo` skill (auto-loaded on session start). Docs: `.ufoo/docs/`
-<!-- /ufoo -->

package/modules/bus/README.md

@@ -1,140 +0,0 @@
-# bus
-
-File-system based Agent event bus for async communication between multiple AI Coding Agents.
-
-## Overview
-
-bus solves communication problems in multi-agent collaboration:
-
-- Multiple Claude Code instances collaborating on the same project
-- Communication between different AI tools (Claude Code, Cursor, Copilot)
-- Task delegation and response
-- Broadcast messages
-
-## Installation
-
-Initialize via ufoo:
-
-```bash
-ufoo init --modules context,bus
-```
-
-## Directory Structure
-
-```
-.ufoo/
-├── agent/
-│   └── all-agents.json  # Agent metadata + agent status
-├── daemon/
-│   ├── daemon.pid
-│   ├── daemon.log
-│   └── counts/
-└── bus/
-    ├── events/          # Event stream (JSONL, sharded by date)
-    ├── offsets/         # Each Agent's consumption progress
-    └── queues/          # Targeted event queues
-```
-
-## Usage
-
-### Join Bus
-
-```bash
-SUBSCRIBER="${UFOO_SUBSCRIBER_ID:-$(ufoo bus whoami 2>/dev/null || true)}"
-[ -n "$SUBSCRIBER" ] || SUBSCRIBER=$(ufoo bus join | tail -n 1)
-# Output: claude-code:a1b2c3 (or codex:def456)
-```
-
-### Check Pending Messages
-
-```bash
-ufoo bus check "$SUBSCRIBER"
-```
-
-### Send Messages
-
-```bash
-# Send to specific instance
-ufoo bus send "claude-code:abc123" "Please help me review"
-
-# Send to all instances of same type
-ufoo bus send "claude-code" "Everyone please review"
-
-# Broadcast to all
-ufoo bus broadcast "I completed feature-x"
-```
-
-### View Status
-
-```bash
-ufoo bus status
-```
-
-## Notifications/Alerts (no key injection, recommended)
-
-If you want to receive "new message alerts" while running Codex/Claude in another terminal, use **agent-side alert/listen** (avoids IME/accessibility permission/window positioning fragmentation issues):
-
-```bash
-SUBSCRIBER="${UFOO_SUBSCRIBER_ID:-$(ufoo bus whoami 2>/dev/null || true)}"
-[ -n "$SUBSCRIBER" ] || SUBSCRIBER=$(ufoo bus join | tail -n 1)
-
-# Background alert: title badge + bell + optional macOS notification center
-ufoo bus alert "$SUBSCRIBER" 1 --notify --daemon
-
-# Or: foreground continuous print of new messages (suitable for a side terminal)
-ufoo bus listen "$SUBSCRIBER" --from-beginning
-```
-
-## Unattended Auto-Execute (recommended)
-
-If you need **Claude A to notify Claude B / Codex C and have the target auto-execute** (e.g., auto-trigger `/ubus`), use the bus daemon:
-
-1) Resolve subscriber in each terminal session first (records `tty`, also records `TMUX_PANE` if in tmux). Join only as fallback:
-
-```bash
-SUBSCRIBER="${UFOO_SUBSCRIBER_ID:-$(ufoo bus whoami 2>/dev/null || true)}"
-[ -n "$SUBSCRIBER" ] || SUBSCRIBER=$(ufoo bus join | tail -n 1)
-```
-
-2) Start the bus daemon in the project (runs as background daemon):
-
-```bash
-ufoo bus daemon --interval 1 --daemon
-```
-
-3) After sending a message, the daemon injects `/ubus` into the target session and presses Enter:
-- tmux: `send-keys`
-- Terminal.app (pure Automation): `do script` (no Accessibility needed, but requires Automation authorization; compatibility depends on whether target program accepts input)
-- Terminal.app (Accessibility): System Events (needs Accessibility), injection sequence is Escape + paste + Return (avoids IME issues)
-
-Tips:
-- Terminal.app backend depends on `tty` in `.ufoo/agent/all-agents.json`. Execute `join` in the target terminal session (ensure `tty` is not `not a tty`).
-- Pure Automation backend needs one-time authorization: System Preferences → Privacy & Security → Automation (allow script to control Terminal).
-- Accessibility backend needs one-time authorization: System Preferences → Privacy & Security → Accessibility (for Terminal / script host).
-
-Stop/view status:
-
-```bash
-ufoo bus daemon --status
-ufoo bus daemon --stop
-```
-
-## Subscriber ID Format
-
-```
-{agent_type}:{instance_id}
-
-Examples:
-  claude-code:a1b2c3
-  cursor-ai:main
-  copilot:session1
-```
-
-## Relationship with context
-
-| Module | Problem Solved |
-|--------|----------------|
-| context | Shared context, sparse decision log for major plan-level choices |
-| bus | Real-time communication, task delegation, message passing |
-
-Both are independent peer modules that can be used separately or together.

package/modules/context/README.md

@@ -1,60 +0,0 @@
-# context
-
-Decision-only context module for ufoo.
-
-Purpose:
-- Persist decisions in project workspaces
-- Keep decision format canonical in `uctx` skill
- 
-Bus handles communication; context handles durable decision truth.
-
-## Quick Start
-
-```bash
-# Install `ufoo` globally (once), then use it to install modules and init projects.
-```
-
-This repository is the `context` module. The recommended entrypoint is `ufoo`.
-
-## Architecture
-
-### Global: `~/.ufoo/` (read-only for agents, managed by humans)
-
-Global modules live under `~/.ufoo/modules/`.
-
-### Project: `<project>/.ufoo/context/` (writable)
-
-```
-.ufoo/context/
-├── decisions/       # Append-only decision log (decision-only mode)
-└── decisions.jsonl  # Decision index (ts/type/file/author)
-```
-
-Should be in the project workspace and writable by agents.
-Versioning is optional but recommended for auditability.
-
-## Module Structure
-
-```
-context/                 # This repo
-├── 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 decisions in `<project>/.ufoo/context/decisions/`
-3. **Never write to global** — only to project
-4. Follow the decision format in the package-level `SKILLS/uctx/SKILL.md`
-
-## Validate
-
-```bash
-# protocol repo
-ufoo ctx lint
-
-# project-local context (in a real project repo)
-ufoo ctx lint --project <path-to-project-context>
-```

package/modules/online/README.md

@@ -1,92 +0,0 @@
-# online
-
-WebSocket relay module for cross-machine agent collaboration. Extends the local ufoo bus to work over the network.
-
-## Overview
-
-online enables agents on different machines to collaborate:
-
-- Public channel chat (broadcast to all connected agents)
-- Private room collaboration (bus/decisions/wake sync)
-- Token-based authentication
-- Auto-reconnect with exponential backoff
-
-## Quick Start
-
-### 1. Start a relay server
-
-```bash
-ufoo online server --port 8787
-```
-
-### 2. Connect an agent
-
-```bash
-# Join a public channel
-ufoo online connect --nickname my-agent --join lobby
-
-# Join a private room
-ufoo online connect --nickname my-agent --room room_001 --room-password secret
-```
-
-### 3. Send messages
-
-```bash
-# To a channel
-ufoo online send --nickname my-agent --channel lobby --text "hello everyone"
-
-# To a room
-ufoo online send --nickname my-agent --room room_001 --text "hello team"
-```
-
-### 4. Check inbox
-
-```bash
-ufoo online inbox my-agent          # All messages
-ufoo online inbox my-agent --unread # Unread only
-ufoo online inbox my-agent --clear  # Clear inbox
-```
-
-## Private Room Sync
-
-In private room mode, agents automatically sync:
-
-- **Bus messages** — local bus ↔ online relay, bidirectional
-- **Decisions** — new `.md` files synced across team
-- **Wake events** — remote agent can wake local agent via bus
-
-## HTTP APIs (for web preview)
-
-Auth-required management APIs:
-
-- `GET/POST /ufoo/online/channels`
-- `GET/POST /ufoo/online/rooms`
-
-Public read-only preview APIs (no bearer token required):
-
-- `GET /ufoo/online/public/channels`
-- `GET /ufoo/online/public/rooms?type=private`
-- `GET /ufoo/online/public/channels/:channel/messages?limit=120`
-
-Notes:
-
-- Channel history is in-memory (rolling buffer) on relay server.
-- Private room public API only exposes metadata (`room_id`, `name`, `created_by`, `password_required`).
-
-## Storage
-
-```
-~/.ufoo/online/
-├── tokens.json           # Auth tokens
-├── inbox/<nickname>.jsonl # Incoming messages
-└── outbox/<nickname>.jsonl # Queued outgoing messages
-```
-
-## Relationship with bus
-
-| Module | Scope |
-|--------|-------|
-| bus | Local file-system based messaging within a single machine |
-| online | Network relay extending bus across machines via WebSocket |
-
-online builds on top of bus — local agents still communicate via the file-system bus, while online bridges messages to remote agents.

package/modules/resources/ICONS/README.md

@@ -1,12 +0,0 @@
-# Icon Context
-
-Icons here define visual grammar, not shippable assets.
-
-They are used as:
-- Reference bases
-- Modification sources
-- Style constraints
-
-Do not copy blindly into projects.
-
-`libraries/` contains minimal subsets of third-party icon libraries (with licenses) as reference material.

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

@@ -1,17 +0,0 @@
-# Icon Libraries (Minimal Subsets)
-
-This directory vendors **small, representative subsets** of third-party icon libraries.
-
-Purpose:
-- Provide strong, unambiguous signal that icons are **canonical protocol context**
-- Serve as reference bases and modification sources
-
-Non-goals:
-- Shipping assets for products
-- Full icon sets
-
-Each library subfolder contains:
-- A minimal set of SVGs
-- The upstream license text
-- A short README with source info
-

package/modules/resources/ICONS/libraries/heroicons/LICENSE

@@ -1,22 +0,0 @@
-MIT License
-
-Copyright (c) Tailwind Labs, Inc.
-
-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/heroicons/README.md

@@ -1,15 +0,0 @@
-# Heroicons (Minimal Subset)
-
-Source:
-- Repository: https://github.com/tailwindlabs/heroicons
-- Path: `optimized/24/outline/`
-- License: MIT (see `LICENSE`)
-- Fetched: 2026-01-27
-
-Included icons:
-- `arrow-right.svg`
-- `chevron-down.svg`
-- `magnifying-glass.svg`
-- `cog-6-tooth.svg`
-- `check.svg`
-- `x-mark.svg`

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

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true" data-slot="icon">
-  <path stroke-linecap="round" stroke-linejoin="round" d="M13.5 4.5 21 12m0 0-7.5 7.5M21 12H3"/>
-</svg>
-

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

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true" data-slot="icon">
-  <path stroke-linecap="round" stroke-linejoin="round" d="m4.5 12.75 6 6 9-13.5"/>
-</svg>
-

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

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true" data-slot="icon">
-  <path stroke-linecap="round" stroke-linejoin="round" d="m19.5 8.25-7.5 7.5-7.5-7.5"/>
-</svg>
-

package/modules/resources/ICONS/libraries/heroicons/cog-6-tooth.svg

@@ -1,5 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true" data-slot="icon">
-  <path stroke-linecap="round" stroke-linejoin="round" d="M9.594 3.94c.09-.542.56-.94 1.11-.94h2.593c.55 0 1.02.398 1.11.94l.213 1.281c.063.374.313.686.645.87.074.04.147.083.22.127.325.196.72.257 1.075.124l1.217-.456a1.125 1.125 0 0 1 1.37.49l1.296 2.247a1.125 1.125 0 0 1-.26 1.431l-1.003.827c-.293.241-.438.613-.43.992a7.723 7.723 0 0 1 0 .255c-.008.378.137.75.43.991l1.004.827c.424.35.534.955.26 1.43l-1.298 2.247a1.125 1.125 0 0 1-1.369.491l-1.217-.456c-.355-.133-.75-.072-1.076.124a6.47 6.47 0 0 1-.22.128c-.331.183-.581.495-.644.869l-.213 1.281c-.09.543-.56.94-1.11.94h-2.594c-.55 0-1.019-.398-1.11-.94l-.213-1.281c-.062-.374-.312-.686-.644-.87a6.52 6.52 0 0 1-.22-.127c-.325-.196-.72-.257-1.076-.124l-1.217.456a1.125 1.125 0 0 1-1.369-.49l-1.297-2.247a1.125 1.125 0 0 1 .26-1.431l1.004-.827c.292-.24.437-.613.43-.991a6.932 6.932 0 0 1 0-.255c.007-.38-.138-.751-.43-.992l-1.004-.827a1.125 1.125 0 0 1-.26-1.43l1.297-2.247a1.125 1.125 0 0 1 1.37-.491l1.216.456c.356.133.751.072 1.076-.124.072-.044.146-.086.22-.128.332-.183.582-.495.644-.869l.214-1.28Z"/>
-  <path stroke-linecap="round" stroke-linejoin="round" d="M15 12a3 3 0 1 1-6 0 3 3 0 0 1 6 0Z"/>
-</svg>
-

package/modules/resources/ICONS/libraries/heroicons/magnifying-glass.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true" data-slot="icon">
-  <path stroke-linecap="round" stroke-linejoin="round" d="m21 21-5.197-5.197m0 0A7.5 7.5 0 1 0 5.196 5.196a7.5 7.5 0 0 0 10.607 10.607Z"/>
-</svg>
-

package/modules/resources/ICONS/libraries/heroicons/x-mark.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true" data-slot="icon">
-  <path stroke-linecap="round" stroke-linejoin="round" d="M6 18 18 6M6 6l12 12"/>
-</svg>
-

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

@@ -1,40 +0,0 @@
-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

@@ -1,15 +0,0 @@
-# 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

@@ -1,15 +0,0 @@
-<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

@@ -1,14 +0,0 @@
-<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

@@ -1,14 +0,0 @@
-<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

@@ -1,15 +0,0 @@
-<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

@@ -1,15 +0,0 @@
-<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

@@ -1,15 +0,0 @@
-<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

@@ -1,7 +0,0 @@
-# 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

@@ -1,9 +0,0 @@
-# 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

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

package/modules/resources/UI/TONE.md

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