bosun 0.26.3 → 0.26.5

package/.env.example

@@ -1,6 +1,6 @@
-# ─── OpenFleet — Environment Configuration ───────────────────────────────
+# ─── Bosun — Environment Configuration ───────────────────────────────
 # Copy this file to .env and fill in your values.
-# Or run: openfleet --setup
+# Or run: bosun --setup
 # All variables are optional unless marked [REQUIRED].
 # Boolean flags use true/false (preferred). Legacy 1/0 is still accepted.
 # Profile guidance:
@@ -31,7 +31,7 @@ TASK_CLAIM_OWNER_STALE_TTL_MS=600000
 
 # ─── Telegram Bot ─────────────────────────────────────────────────────────────
 # Create a bot via @BotFather on Telegram, then paste the token here.
-# Run `openfleet-chat-id` to discover your chat ID.
+# Run `bosun-chat-id` to discover your chat ID.
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_CHAT_ID=
 # Optional additional allow-list entries (comma-separated chat IDs or user IDs).
@@ -106,10 +106,10 @@ TELEGRAM_MINIAPP_ENABLED=false
 # TELEGRAM_UI_TUNNEL=auto
 
 # ─── Telegram Sentinel (independent watchdog) ──────────────────────────────
-# Keep Telegram command availability even when openfleet is down.
+# Keep Telegram command availability even when bosun is down.
 # Sentinel can auto-restart monitor, detect crash loops, and run repair-agent.
-# Auto-start sentinel whenever openfleet starts (default: disabled)
-# OPENFLEET_SENTINEL_AUTO_START=true
+# Auto-start sentinel whenever bosun starts (default: disabled)
+# BOSUN_SENTINEL_AUTO_START=true
 # Auto-restart monitor when sentinel detects monitor down/crash (default: 1)
 # SENTINEL_AUTO_RESTART_MONITOR=true
 # Crash-loop threshold within rolling window (default: 3)
@@ -148,7 +148,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # TELEGRAM_IMMEDIATE_PRIORITY=1
 
 # ─── Presence & Multi-Instance Coordination ──────────────────────────────────
-# Presence heartbeat allows discovering multiple openfleet instances.
+# Presence heartbeat allows discovering multiple bosun instances.
 # Heartbeat interval in seconds (default: 60)
 # TELEGRAM_PRESENCE_INTERVAL_SEC=60
 # Consider instances offline after this many seconds (default: 180)
@@ -174,7 +174,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # Optional WhatsApp channel for receiving commands and notifications.
 # Uses @whiskeysockets/baileys for WhatsApp Web multi-device API.
 # Install baileys: npm install @whiskeysockets/baileys qrcode-terminal
-# Then authenticate: openfleet --whatsapp-auth
+# Then authenticate: bosun --whatsapp-auth
 # Enable WhatsApp channel (default: disabled)
 # WHATSAPP_ENABLED=false
 # Restrict to a specific chat JID (recommended for security)
@@ -217,7 +217,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # Define AI executors that work on tasks.
 # Format: EXECUTOR_TYPE:VARIANT:WEIGHT,EXECUTOR_TYPE:VARIANT:WEIGHT
 # Example: COPILOT:CLAUDE_OPUS_4_6:50,CODEX:DEFAULT:50
-# For full config, use openfleet.config.json instead.
+# For full config, use bosun.config.json instead.
 # EXECUTORS=CODEX:DEFAULT:100
 
 # Task distribution mode: "weighted" | "round-robin" | "primary-only"
@@ -297,7 +297,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # GITHUB_PROJECT_MODE=issues
 # GitHub Project owner/title/number used when GITHUB_PROJECT_MODE=kanban
 # GITHUB_PROJECT_OWNER=your-org
-# GITHUB_PROJECT_TITLE=OpenFleet
+# GITHUB_PROJECT_TITLE=Bosun
 # GITHUB_PROJECT_NUMBER=3
 # GitHub Project v2 status field name mapping (customize to match your board columns)
 # GITHUB_PROJECT_STATUS_TODO=Todo
@@ -305,7 +305,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # GITHUB_PROJECT_STATUS_INREVIEW=In Review
 # GITHUB_PROJECT_STATUS_DONE=Done
 # GITHUB_PROJECT_STATUS_CANCELLED=Cancelled
-# Auto-sync task status to project board when updating via openfleet (default: true)
+# Auto-sync task status to project board when updating via bosun (default: true)
 # GITHUB_PROJECT_AUTO_SYNC=true
 # GitHub webhook endpoint (served by ui-server.mjs) for project item updates
 # GITHUB_PROJECT_WEBHOOK_PATH=/api/webhooks/github/project-sync
@@ -321,10 +321,10 @@ TELEGRAM_MINIAPP_ENABLED=false
 # GITHUB_DEFAULT_ASSIGNEE=
 # Auto-assign task creator/login when creating issues (default: true)
 # GITHUB_AUTO_ASSIGN_CREATOR=true
-# Codex task scoping label policy (only matching labels are picked by openfleet)
-# OPENFLEET_TASK_LABEL=openfleet
-# OPENFLEET_TASK_LABELS=openfleet,codex-mointor
-# OPENFLEET_ENFORCE_TASK_LABEL=true
+# Codex task scoping label policy (only matching labels are picked by bosun)
+# BOSUN_TASK_LABEL=bosun
+# BOSUN_TASK_LABELS=bosun,codex-mointor
+# BOSUN_ENFORCE_TASK_LABEL=true
 # Optional issue fetch cap per sync/poll cycle (default: 1000)
 # GITHUB_ISSUES_LIST_LIMIT=1000
 
@@ -341,7 +341,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # JIRA_SUBTASK_PARENT_KEY=ENG-1
 # Default assignee account ID for new Jira tasks
 # JIRA_DEFAULT_ASSIGNEE=5b10a2844c20165700ede21g
-# Jira workflow status mapping (openfleet status -> Jira status name)
+# Jira workflow status mapping (bosun status -> Jira status name)
 # JIRA_STATUS_TODO=To Do
 # JIRA_STATUS_INPROGRESS=In Progress
 # JIRA_STATUS_INREVIEW=In Review
@@ -353,7 +353,7 @@ TELEGRAM_MINIAPP_ENABLED=false
 # JIRA_LABEL_STALE=codex:stale
 # JIRA_LABEL_IGNORE=codex:ignore
 # Jira task scoping labels (only tasks with these labels are picked up)
-# JIRA_TASK_LABELS=openfleet,codex-mointor
+# JIRA_TASK_LABELS=bosun,codex-mointor
 # JIRA_ENFORCE_TASK_LABEL=true
 # Jira issue fetch cap per sync/poll cycle (default: 250)
 # JIRA_ISSUES_LIST_LIMIT=250
@@ -418,21 +418,21 @@ TELEGRAM_MINIAPP_ENABLED=false
 # COPILOT_ADDITIONAL_MCP_CONFIG=
 
 # ─── Daemon Mode ──────────────────────────────────────────────────────────────
-# Run openfleet as a background daemon:
-#   openfleet --daemon         Start detached daemon
-#   openfleet --stop-daemon    Stop running daemon
-#   openfleet --daemon-status  Check if daemon is running
+# Run bosun as a background daemon:
+#   bosun --daemon         Start detached daemon
+#   bosun --stop-daemon    Stop running daemon
+#   bosun --daemon-status  Check if daemon is running
 # Optional: keep sentinel always-on alongside monitor
-#   openfleet --daemon --sentinel
-# PID file: .cache/openfleet.pid
+#   bosun --daemon --sentinel
+# PID file: .cache/bosun.pid
 # Logs: logs/daemon.log
 # Daemon crash supervision (monitor child):
-# OPENFLEET_DAEMON_RESTART_DELAY_MS=5000
-# OPENFLEET_DAEMON_MAX_RESTARTS=0   # 0 = unlimited
+# BOSUN_DAEMON_RESTART_DELAY_MS=5000
+# BOSUN_DAEMON_MAX_RESTARTS=0   # 0 = unlimited
 # Consider any crash within this window as an instant startup failure (default: 15000)
-# OPENFLEET_DAEMON_INSTANT_CRASH_WINDOW_MS=15000
+# BOSUN_DAEMON_INSTANT_CRASH_WINDOW_MS=15000
 # Stop auto-restarts after this many instant failures in a row (default: 3)
-# OPENFLEET_DAEMON_MAX_INSTANT_RESTARTS=3
+# BOSUN_DAEMON_MAX_INSTANT_RESTARTS=3
 
 # ─── Vibe-Kanban ──────────────────────────────────────────────────────────────
 # Base URL for the Vibe-Kanban API (default: http://127.0.0.1:54089)
@@ -467,9 +467,9 @@ VK_RECOVERY_PORT=54089
 
 # ─── Shared Workspace Registry ───────────────────────────────────────────────
 # Optional registry path for shared workspace leasing
-# VE_SHARED_WORKSPACE_REGISTRY=.cache/openfleet/shared-workspaces.json
+# VE_SHARED_WORKSPACE_REGISTRY=.cache/bosun/shared-workspaces.json
 # Optional audit log path for shared workspace leasing
-# VE_SHARED_WORKSPACE_AUDIT_LOG=.cache/openfleet/shared-workspace-audit.jsonl
+# VE_SHARED_WORKSPACE_AUDIT_LOG=.cache/bosun/shared-workspace-audit.jsonl
 # Default lease TTL in minutes (Telegram claims); can override with seconds below
 # VE_WORKSPACE_LEASE_TTL_MIN=120
 # Default lease TTL in seconds (converted to minutes if set)
@@ -491,8 +491,8 @@ VK_RECOVERY_PORT=54089
 # GH_REPO=virtengine
 # Target branch for PR checks/merge (default: origin/main)
 # VK_TARGET_BRANCH=origin/main
-# Default upstream/base branch for openfleet tasks (overrides VK_TARGET_BRANCH)
-# OPENFLEET_TASK_UPSTREAM=origin/ve/openfleet-generic
+# Default upstream/base branch for bosun tasks (overrides VK_TARGET_BRANCH)
+# BOSUN_TASK_UPSTREAM=origin/ve/bosun-generic
 
 # ─── Codex / AI Provider ─────────────────────────────────────────────────────
 # The Codex SDK uses OpenAI-compatible configuration that has been setup in ~/.codex/config.toml -
@@ -540,50 +540,50 @@ VK_RECOVERY_PORT=54089
 # Setup can scaffold shared hook configs in:
 #   .codex/hooks.json
 #   .claude/settings.local.json
-#   .github/hooks/openfleet.hooks.json
+#   .github/hooks/bosun.hooks.json
 #
 # Hook profile for setup/non-interactive runs:
 #   strict | balanced | lightweight | none
-# OPENFLEET_HOOK_PROFILE=strict
+# BOSUN_HOOK_PROFILE=strict
 #
 # Which agents should receive generated hook files (comma-separated):
 #   codex,claude,copilot
-# OPENFLEET_HOOK_TARGETS=codex,claude,copilot
+# BOSUN_HOOK_TARGETS=codex,claude,copilot
 #
 # Set to false to skip hook scaffolding during setup.
-# OPENFLEET_HOOKS_ENABLED=true
+# BOSUN_HOOKS_ENABLED=true
 # Set to true to overwrite existing generated hook files.
-# OPENFLEET_HOOKS_OVERWRITE=false
+# BOSUN_HOOKS_OVERWRITE=false
 # Optional overrides for generated bridge command tokens.
 # Defaults are portable across workstations:
-#   node scripts/openfleet/agent-hook-bridge.mjs
-# OPENFLEET_HOOK_NODE_BIN=node
-# OPENFLEET_HOOK_BRIDGE_PATH=scripts/openfleet/agent-hook-bridge.mjs
+#   node scripts/bosun/agent-hook-bridge.mjs
+# BOSUN_HOOK_NODE_BIN=node
+# BOSUN_HOOK_BRIDGE_PATH=scripts/bosun/agent-hook-bridge.mjs
 #
 # Optional per-event command overrides (separate multiple commands with ';;').
 # Use value 'none' to disable that event in generated .codex/hooks.json.
-# OPENFLEET_HOOK_PREPUSH=go vet ./...;;go build ./...
-# OPENFLEET_HOOK_PRECOMMIT=gofmt -l .
-# OPENFLEET_HOOK_TASK_COMPLETE=echo \"task completed\"
-# OPENFLEET_HOOK_SESSION_START=echo \"session start\"
-# OPENFLEET_HOOK_SESSION_STOP=echo \"session stop\"
+# BOSUN_HOOK_PREPUSH=go vet ./...;;go build ./...
+# BOSUN_HOOK_PRECOMMIT=gofmt -l .
+# BOSUN_HOOK_TASK_COMPLETE=echo \"task completed\"
+# BOSUN_HOOK_SESSION_START=echo \"session start\"
+# BOSUN_HOOK_SESSION_STOP=echo \"session stop\"
 #
-# Built-in hook behavior inside openfleet runtime:
+# Built-in hook behavior inside bosun runtime:
 #   force (default), auto, off
-# OPENFLEET_HOOKS_BUILTINS_MODE=force
-# OPENFLEET_HOOKS_DISABLE_PREPUSH=false
-# OPENFLEET_HOOKS_DISABLE_TASK_COMPLETE=false
-# OPENFLEET_HOOKS_DISABLE_HEALTH_CHECK=false
+# BOSUN_HOOKS_BUILTINS_MODE=force
+# BOSUN_HOOKS_DISABLE_PREPUSH=false
+# BOSUN_HOOKS_DISABLE_TASK_COMPLETE=false
+# BOSUN_HOOKS_DISABLE_HEALTH_CHECK=false
 
 # Force hooks to fire even for non-managed sessions (debug only):
-# OPENFLEET_HOOKS_FORCE=false
+# BOSUN_HOOKS_FORCE=false
 
-# VE_MANAGED is auto-set by openfleet at startup. Agent hook bridge
+# VE_MANAGED is auto-set by bosun at startup. Agent hook bridge
 # scripts check for this and exit silently if not present, preventing
 # hooks from firing in standalone Copilot/Codex/Claude sessions.
 
 # ─── Devmode Monitor-Monitor (24/7 reliability guardian) ───────────────────
-# Prompt is injected directly from openfleet source (no .github/agents file required).
+# Prompt is injected directly from bosun source (no .github/agents file required).
 # Enabled by default in devmode source checkouts. Set to false to disable.
 # DEVMODE_MONITOR_MONITOR_ENABLED=true
 # Poll interval for monitor-monitor runs (milliseconds). Default: 300000 (5 min)
@@ -746,9 +746,9 @@ COMPLEXITY_ROUTING_ENABLED=true
 # COMPLEXITY_ROUTING_COPILOT_HIGH_REASONING=high
 
 # ─── Shared Cloud Workspaces ────────────────────────────────────────────────
-# Registry file for shared workspace leasing (default: .cache/openfleet/shared-workspaces.json)
+# Registry file for shared workspace leasing (default: .cache/bosun/shared-workspaces.json)
 # VE_SHARED_WORKSPACE_REGISTRY=
-# Audit log file for claim/release events (default: .cache/openfleet/shared-workspace-audit.jsonl)
+# Audit log file for claim/release events (default: .cache/bosun/shared-workspace-audit.jsonl)
 # VE_SHARED_WORKSPACE_AUDIT_LOG=
 
 # ─── CI Sweep (Orchestrator) ─────────────────────────────────────────────────
@@ -788,7 +788,7 @@ COPILOT_CLOUD_DISABLED=true
 
 # ─── Git Identity (optional) ─────────────────────────────────────────────────
 # Override git author for automated commits
-# VE_GIT_AUTHOR_NAME=OpenFleet
+# VE_GIT_AUTHOR_NAME=Bosun
 # VE_GIT_AUTHOR_EMAIL=bot@yoursite.com
 
 # ─── Task Planner ─────────────────────────────────────────────────────────────
@@ -811,16 +811,16 @@ COPILOT_CLOUD_DISABLED=true
 # GH_RECONCILE_MERGED_LOOKBACK_HOURS=72
 # GH_RECONCILE_TRACKING_LABELS=tracking
 
-# ─── Prompt Overrides (.openfleet/agents) ────────────────────────────────
-# openfleet scaffolds generic prompt templates under:
-#   .openfleet/agents/*.md
+# ─── Prompt Overrides (.bosun/agents) ────────────────────────────────
+# bosun scaffolds generic prompt templates under:
+#   .bosun/agents/*.md
 # Files in that folder are loaded automatically and are intended for per-project customization.
 # You can also override any prompt path explicitly with env vars:
-# OPENFLEET_PROMPT_PLANNER=.openfleet/agents/task-planner.md
-# OPENFLEET_PROMPT_MONITOR_MONITOR=.openfleet/agents/monitor-monitor.md
-# OPENFLEET_PROMPT_TASK_EXECUTOR=.openfleet/agents/task-executor.md
-# OPENFLEET_PROMPT_REVIEWER=.openfleet/agents/reviewer.md
-# OPENFLEET_PROMPT_SDK_CONFLICT_RESOLVER=.openfleet/agents/sdk-conflict-resolver.md
+# BOSUN_PROMPT_PLANNER=.bosun/agents/task-planner.md
+# BOSUN_PROMPT_MONITOR_MONITOR=.bosun/agents/monitor-monitor.md
+# BOSUN_PROMPT_TASK_EXECUTOR=.bosun/agents/task-executor.md
+# BOSUN_PROMPT_REVIEWER=.bosun/agents/reviewer.md
+# BOSUN_PROMPT_SDK_CONFLICT_RESOLVER=.bosun/agents/sdk-conflict-resolver.md
 
 # ─── Dependabot / Bot PR Auto-Merge ───────────────────────────────────────────
 # Auto-merge Dependabot (and other bot) PRs after all CI checks pass.
@@ -863,8 +863,8 @@ COPILOT_CLOUD_DISABLED=true
 # MERGE_CONFLICT_RESOLUTION_TIMEOUT_MS=600000
 
 # ─── Advanced ─────────────────────────────────────────────────────────────────
-# Override openfleet config directory (where .env and config live)
-# OPENFLEET_DIR=/path/to/scripts/openfleet
+# Override bosun config directory (where .env and config live)
+# BOSUN_DIR=/path/to/scripts/bosun
 # Max orchestrator restarts (0 = unlimited)
 # MAX_RESTARTS=0
 # Restart delay in milliseconds

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "bosun",
-  "version": "0.26.3",
+  "version": "0.26.5",
   "description": "AI-powered orchestrator supervisor — manages AI agent executors with failover, auto-restarts on failure, analyzes crashes with Codex SDK, creates PRs via Vibe-Kanban API, and sends Telegram notifications. Supports N executors with weighted distribution, multi-repo projects, and auto-setup.",
   "type": "module",
   "license": "Apache 2.0",
   "author": "VirtEngine <dev@virtengine.com>",
-  "homepage": "https://github.com/virtengine/virtengine/tree/main/scripts/bosun",
+  "homepage": "https://github.com/virtengine/bosun",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/virtengine/virtengine.git",
@@ -86,6 +86,7 @@
     "pretest": "npm run syntax:check",
     "test": "vitest run --config vitest.config.mjs",
     "test:watch": "vitest",
+    "preinstall": "node preinstall.mjs",
     "postinstall": "node postinstall.mjs",
     "sentinel": "node telegram-sentinel.mjs",
     "sentinel:stop": "node -e \"import('./telegram-sentinel.mjs').then(m => m.stopSentinel())\"",