triflux 10.3.2 → 10.3.3

package/mesh/mesh-router.mjs

@@ -0,0 +1,76 @@
+import { validate } from "./mesh-protocol.mjs";
+
+/**
+ * Routes a mesh message to target agent(s) based on the `to` field.
+ *
+ * Addressing modes:
+ *   - "agent-id"       → direct delivery (registry lookup)
+ *   - "*"              → broadcast to all registered agents
+ *   - "capability:X"   → discover agents with capability X
+ *
+ * @param {object} message  - A mesh-protocol message
+ * @param {object} registry - A mesh-registry instance
+ * @returns {{ routed: boolean, targets?: string[], reason?: string }}
+ */
+export function routeMessage(message, registry) {
+  const { valid, errors } = validate(message);
+  if (!valid) {
+    return { routed: false, reason: `invalid message: ${errors.join(", ")}` };
+  }
+
+  const { to, from } = message;
+
+  // Broadcast
+  if (to === "*") {
+    const all = registry.listAll();
+    const targets = all
+      .map((a) => a.agentId)
+      .filter((id) => id !== from);
+    if (targets.length === 0) {
+      return { routed: false, reason: "broadcast: no agents registered" };
+    }
+    return { routed: true, targets };
+  }
+
+  // Capability-based routing
+  if (to.startsWith("capability:")) {
+    const capability = to.slice("capability:".length);
+    if (!capability) {
+      return { routed: false, reason: "capability: empty capability name" };
+    }
+    const targets = registry.discover(capability);
+    if (targets.length === 0) {
+      return { routed: false, reason: `capability: no agents with "${capability}"` };
+    }
+    return { routed: true, targets };
+  }
+
+  // Direct addressing
+  const agent = registry.getAgent(to);
+  if (!agent) {
+    return { routed: false, reason: `agent not found: "${to}"` };
+  }
+  return { routed: true, targets: [to] };
+}
+
+/**
+ * Routes a message and collects dead-letter info when delivery fails.
+ *
+ * @param {object} message
+ * @param {object} registry
+ * @returns {{ routed: boolean, targets?: string[], deadLetter?: object }}
+ */
+export function routeOrDeadLetter(message, registry) {
+  const result = routeMessage(message, registry);
+  if (!result.routed) {
+    return {
+      ...result,
+      deadLetter: {
+        originalMessage: message,
+        reason: result.reason,
+        timestamp: new Date().toISOString(),
+      },
+    };
+  }
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.3.2",
+  "version": "10.3.3",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -24,6 +24,7 @@
     "scripts",
     "hooks",
     "hud",
+    "mesh",
     ".claude-plugin",
     "README.md",
     "README.ko.md",

package/scripts/completions/tfx.bash

@@ -1,47 +1,47 @@
-#!/usr/bin/env bash
-# Installation: source /path/to/tfx.bash 또는 ~/.bashrc에 추가
-
-_tfx_completion() {
-    local cur prev words cword
-    COMPREPLY=()
-    cur="${COMP_WORDS[COMP_CWORD]}"
-    prev="${COMP_WORDS[COMP_CWORD-1]}"
-    words=("${COMP_WORDS[@]}")
-    cword=$COMP_CWORD
-
-    local commands="setup doctor multi hub auto codex gemini"
-    local multi_cmds="status stop kill attach list"
-    local hub_cmds="start stop status restart"
-    local flags="--thorough --quick --tmux --psmux --agents --no-attach --timeout"
-
-    if [[ $cword -eq 1 ]]; then
-        COMPREPLY=( $(compgen -W "${commands}" -- "$cur") )
-        return 0
-    fi
-
-    local cmd="${words[1]}"
-    case "${cmd}" in
-        multi)
-            if [[ $cword -eq 2 && ! "$cur" == -* ]]; then
-                COMPREPLY=( $(compgen -W "${multi_cmds}" -- "$cur") )
-            else
-                COMPREPLY=( $(compgen -W "${flags}" -- "$cur") )
-            fi
-            ;;
-        hub)
-            if [[ $cword -eq 2 ]]; then
-                COMPREPLY=( $(compgen -W "${hub_cmds}" -- "$cur") )
-            fi
-            ;;
-        doctor)
-            COMPREPLY=( $(compgen -W "--fix --reset" -- "$cur") )
-            ;;
-        setup|auto|codex|gemini)
-            if [[ "$cur" == -* ]]; then
-                COMPREPLY=( $(compgen -W "${flags}" -- "$cur") )
-            fi
-            ;;
-    esac
-}
-
-complete -F _tfx_completion tfx
+#!/usr/bin/env bash
+# Installation: source /path/to/tfx.bash 또는 ~/.bashrc에 추가
+
+_tfx_completion() {
+    local cur prev words cword
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    words=("${COMP_WORDS[@]}")
+    cword=$COMP_CWORD
+
+    local commands="setup doctor multi hub auto codex gemini"
+    local multi_cmds="status stop kill attach list"
+    local hub_cmds="start stop status restart"
+    local flags="--thorough --quick --tmux --psmux --agents --no-attach --timeout"
+
+    if [[ $cword -eq 1 ]]; then
+        COMPREPLY=( $(compgen -W "${commands}" -- "$cur") )
+        return 0
+    fi
+
+    local cmd="${words[1]}"
+    case "${cmd}" in
+        multi)
+            if [[ $cword -eq 2 && ! "$cur" == -* ]]; then
+                COMPREPLY=( $(compgen -W "${multi_cmds}" -- "$cur") )
+            else
+                COMPREPLY=( $(compgen -W "${flags}" -- "$cur") )
+            fi
+            ;;
+        hub)
+            if [[ $cword -eq 2 ]]; then
+                COMPREPLY=( $(compgen -W "${hub_cmds}" -- "$cur") )
+            fi
+            ;;
+        doctor)
+            COMPREPLY=( $(compgen -W "--fix --reset" -- "$cur") )
+            ;;
+        setup|auto|codex|gemini)
+            if [[ "$cur" == -* ]]; then
+                COMPREPLY=( $(compgen -W "${flags}" -- "$cur") )
+            fi
+            ;;
+    esac
+}
+
+complete -F _tfx_completion tfx

package/scripts/completions/tfx.fish

@@ -1,44 +1,44 @@
-# Installation: ~/.config/fish/completions/에 복사
-# e.g., cp /path/to/tfx.fish ~/.config/fish/completions/tfx.fish
-
-set -l commands setup doctor multi hub auto codex gemini
-set -l multi_cmds status stop kill attach list
-set -l hub_cmds start stop status restart
-
-complete -c tfx -f
-
-# Subcommands
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "setup" -d "Setup and sync files"
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "doctor" -d "Diagnose CLI and issues"
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "multi" -d "Multi-CLI team mode"
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "hub" -d "MCP message bus management"
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "auto" -d "Auto mode"
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "codex" -d "Codex mode"
-complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "gemini" -d "Gemini mode"
-
-# Doctor flags
-complete -c tfx -n "__fish_seen_subcommand_from doctor" -l fix -d "Auto fix issues"
-complete -c tfx -n "__fish_seen_subcommand_from doctor" -l reset -d "Reset all caches"
-
-# Multi subcommands
-complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "status"
-complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "stop"
-complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "kill"
-complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "attach"
-complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "list"
-
-# Hub subcommands
-complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "start"
-complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "stop"
-complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "status"
-complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "restart"
-
-# Global or multi flags
-set -l flags_cond "__fish_seen_subcommand_from setup multi auto codex gemini"
-complete -c tfx -n "$flags_cond" -l thorough -d "Thorough execution"
-complete -c tfx -n "$flags_cond" -l quick -d "Quick execution"
-complete -c tfx -n "$flags_cond" -l tmux -d "Use tmux"
-complete -c tfx -n "$flags_cond" -l psmux -d "Use psmux"
-complete -c tfx -n "$flags_cond" -l agents -d "Specify agents"
-complete -c tfx -n "$flags_cond" -l no-attach -d "Do not attach"
-complete -c tfx -n "$flags_cond" -l timeout -d "Set timeout"
+# Installation: ~/.config/fish/completions/에 복사
+# e.g., cp /path/to/tfx.fish ~/.config/fish/completions/tfx.fish
+
+set -l commands setup doctor multi hub auto codex gemini
+set -l multi_cmds status stop kill attach list
+set -l hub_cmds start stop status restart
+
+complete -c tfx -f
+
+# Subcommands
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "setup" -d "Setup and sync files"
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "doctor" -d "Diagnose CLI and issues"
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "multi" -d "Multi-CLI team mode"
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "hub" -d "MCP message bus management"
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "auto" -d "Auto mode"
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "codex" -d "Codex mode"
+complete -c tfx -n "not __fish_seen_subcommand_from $commands" -a "gemini" -d "Gemini mode"
+
+# Doctor flags
+complete -c tfx -n "__fish_seen_subcommand_from doctor" -l fix -d "Auto fix issues"
+complete -c tfx -n "__fish_seen_subcommand_from doctor" -l reset -d "Reset all caches"
+
+# Multi subcommands
+complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "status"
+complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "stop"
+complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "kill"
+complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "attach"
+complete -c tfx -n "__fish_seen_subcommand_from multi; and not __fish_seen_subcommand_from $multi_cmds" -a "list"
+
+# Hub subcommands
+complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "start"
+complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "stop"
+complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "status"
+complete -c tfx -n "__fish_seen_subcommand_from hub; and not __fish_seen_subcommand_from $hub_cmds" -a "restart"
+
+# Global or multi flags
+set -l flags_cond "__fish_seen_subcommand_from setup multi auto codex gemini"
+complete -c tfx -n "$flags_cond" -l thorough -d "Thorough execution"
+complete -c tfx -n "$flags_cond" -l quick -d "Quick execution"
+complete -c tfx -n "$flags_cond" -l tmux -d "Use tmux"
+complete -c tfx -n "$flags_cond" -l psmux -d "Use psmux"
+complete -c tfx -n "$flags_cond" -l agents -d "Specify agents"
+complete -c tfx -n "$flags_cond" -l no-attach -d "Do not attach"
+complete -c tfx -n "$flags_cond" -l timeout -d "Set timeout"

package/scripts/completions/tfx.zsh

@@ -1,83 +1,83 @@
-#compdef tfx
-# Installation: fpath에 추가 후 compinit
-# e.g., fpath=(/path/to/dir $fpath) && compinit
-
-_tfx() {
-    local line state
-    local -a commands multi_cmds hub_cmds flags
-
-    commands=(
-        'setup:Setup and sync files'
-        'doctor:Diagnose CLI and issues'
-        'multi:Multi-CLI team mode'
-        'hub:MCP message bus management'
-        'auto:Auto mode'
-        'codex:Codex mode'
-        'gemini:Gemini mode'
-    )
-
-    multi_cmds=(
-        'status:Show status'
-        'stop:Stop multi'
-        'kill:Kill multi'
-        'attach:Attach to multi'
-        'list:List multi sessions'
-    )
-
-    hub_cmds=(
-        'start:Start hub'
-        'stop:Stop hub'
-        'status:Show hub status'
-        'restart:Restart hub'
-    )
-
-    _arguments -C \
-        '1: :->cmds' \
-        '*: :->args'
-
-    case $state in
-        cmds)
-            _describe -t commands 'tfx commands' commands
-            ;;
-        args)
-            case $words[2] in
-                multi)
-                    if (( CURRENT == 3 )) && [[ $words[CURRENT] != -* ]]; then
-                        _describe -t multi_cmds 'multi commands' multi_cmds
-                    else
-                        _arguments \
-                            '--thorough[Thorough execution]' \
-                            '--quick[Quick execution]' \
-                            '--tmux[Use tmux]' \
-                            '--psmux[Use psmux]' \
-                            '--agents[Specify agents]' \
-                            '--no-attach[Do not attach]' \
-                            '--timeout[Set timeout]'
-                    fi
-                    ;;
-                hub)
-                    if (( CURRENT == 3 )); then
-                        _describe -t hub_cmds 'hub commands' hub_cmds
-                    fi
-                    ;;
-                doctor)
-                    _arguments \
-                        '--fix[Auto fix issues]' \
-                        '--reset[Reset all caches]'
-                    ;;
-                *)
-                    _arguments \
-                        '--thorough[Thorough execution]' \
-                        '--quick[Quick execution]' \
-                        '--tmux[Use tmux]' \
-                        '--psmux[Use psmux]' \
-                        '--agents[Specify agents]' \
-                        '--no-attach[Do not attach]' \
-                        '--timeout[Set timeout]'
-                    ;;
-            esac
-            ;;
-    esac
-}
-
-_tfx "$@"
+#compdef tfx
+# Installation: fpath에 추가 후 compinit
+# e.g., fpath=(/path/to/dir $fpath) && compinit
+
+_tfx() {
+    local line state
+    local -a commands multi_cmds hub_cmds flags
+
+    commands=(
+        'setup:Setup and sync files'
+        'doctor:Diagnose CLI and issues'
+        'multi:Multi-CLI team mode'
+        'hub:MCP message bus management'
+        'auto:Auto mode'
+        'codex:Codex mode'
+        'gemini:Gemini mode'
+    )
+
+    multi_cmds=(
+        'status:Show status'
+        'stop:Stop multi'
+        'kill:Kill multi'
+        'attach:Attach to multi'
+        'list:List multi sessions'
+    )
+
+    hub_cmds=(
+        'start:Start hub'
+        'stop:Stop hub'
+        'status:Show hub status'
+        'restart:Restart hub'
+    )
+
+    _arguments -C \
+        '1: :->cmds' \
+        '*: :->args'
+
+    case $state in
+        cmds)
+            _describe -t commands 'tfx commands' commands
+            ;;
+        args)
+            case $words[2] in
+                multi)
+                    if (( CURRENT == 3 )) && [[ $words[CURRENT] != -* ]]; then
+                        _describe -t multi_cmds 'multi commands' multi_cmds
+                    else
+                        _arguments \
+                            '--thorough[Thorough execution]' \
+                            '--quick[Quick execution]' \
+                            '--tmux[Use tmux]' \
+                            '--psmux[Use psmux]' \
+                            '--agents[Specify agents]' \
+                            '--no-attach[Do not attach]' \
+                            '--timeout[Set timeout]'
+                    fi
+                    ;;
+                hub)
+                    if (( CURRENT == 3 )); then
+                        _describe -t hub_cmds 'hub commands' hub_cmds
+                    fi
+                    ;;
+                doctor)
+                    _arguments \
+                        '--fix[Auto fix issues]' \
+                        '--reset[Reset all caches]'
+                    ;;
+                *)
+                    _arguments \
+                        '--thorough[Thorough execution]' \
+                        '--quick[Quick execution]' \
+                        '--tmux[Use tmux]' \
+                        '--psmux[Use psmux]' \
+                        '--agents[Specify agents]' \
+                        '--no-attach[Do not attach]' \
+                        '--timeout[Set timeout]'
+                    ;;
+            esac
+            ;;
+    esac
+}
+
+_tfx "$@"