bosun 0.26.6 → 0.27.0

package/README.md

@@ -1,19 +1,19 @@
-# @virtengine/bosun
+# bosun
 
-**Bosun** is a production-grade supervisor for AI coding agents. It routes tasks across executors, manages retries and failover, automates PR lifecycle, and keeps you in control through Telegram (with optional WhatsApp and container isolation).
+Bosun is a production-grade supervisor for AI coding agents. It routes tasks across executors, automates PR lifecycles, and keeps operators in control through Telegram, the Mini App dashboard, and optional WhatsApp notifications.
 
-[Website](https://bosun.virtengine.com) · [Docs](https://bosun.virtengine.com/docs/) · [GitHub](https://github.com/virtengine/virtengine/tree/main/scripts/bosun) · [npm](https://www.npmjs.com/package/@virtengine/bosun) · [Issues](https://github.com/virtengine/virtengine/issues)
+[Website](https://bosun.virtengine.com) · [Docs](https://bosun.virtengine.com/docs/) · [GitHub](https://github.com/virtengine/bosun?tab=readme-ov-file#bosun) · [npm](https://www.npmjs.com/package/bosun) · [Issues](https://github.com/virtengine/bosun/issues)
 
-![CI](https://github.com/virtengine/virtengine/actions/workflows/ci.yaml/badge.svg)
-![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)
-![npm](https://img.shields.io/npm/v/@virtengine/bosun.svg)
+[![CI](https://github.com/virtengine/bosun/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/virtengine/bosun/actions/workflows/ci.yaml)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![npm](https://img.shields.io/npm/v/bosun.svg)](https://www.npmjs.com/package/bosun)
 
 ---
 
 ## Quick start
 
 ```bash
-npm install -g @virtengine/bosun
+npm install -g bosun
 cd your-repo
 bosun
 ```
@@ -46,7 +46,7 @@ Requires:
 
 **Published docs (website):** https://bosun.virtengine.com/docs/
 
-**Source docs (markdown):** `_docs/` is the source of truth for long-form documentation. Keep `site/docs` in sync with these markdown files so the website mirrors the same content.
+**Source docs (markdown):** `_docs/` is the source of truth for long-form documentation. The website should be generated from the same markdown content so docs stay in sync.
 
 Key references:
 - [GitHub adapter enhancements](_docs/KANBAN_GITHUB_ENHANCEMENT.md)
@@ -78,6 +78,9 @@ npm -C scripts/bosun test
 
 # Prepublish safety checks
 npm -C scripts/bosun run prepublishOnly
+
+# Install local git hooks (pre-commit + pre-push)
+npm -C scripts/bosun run hooks:install
 ```
 
 ---

package/agent-hook-bridge.mjs

@@ -187,14 +187,17 @@ async function run() {
   for (const item of mapped) {
     const context = {
       sdk: agent,
-      taskId: process.env.VE_TASK_ID || "",
-      taskTitle: process.env.VE_TASK_TITLE || "",
+      taskId: process.env.VE_TASK_ID || process.env.BOSUN_TASK_ID || "",
+      taskTitle:
+        process.env.VE_TASK_TITLE || process.env.BOSUN_TASK_TITLE || "",
       taskDescription:
         process.env.VE_TASK_DESCRIPTION ||
+        process.env.BOSUN_TASK_DESCRIPTION ||
         process.env.VE_DESCRIPTION ||
         process.env.VK_DESCRIPTION ||
         "",
-      branch: process.env.VE_BRANCH_NAME || "",
+      branch:
+        process.env.VE_BRANCH_NAME || process.env.BOSUN_BRANCH_NAME || "",
       worktreePath: process.cwd(),
       extra: {
         source_event: sourceEvent,

package/agent-hooks.mjs

@@ -817,6 +817,15 @@ function _buildEnv(ctx) {
     VE_SDK: ctx.sdk ?? "",
     VE_REPO_ROOT: ctx.repoRoot ?? REPO_ROOT,
     VE_HOOK_BLOCKING: "false", // Overridden per-hook in execution
+    // ── Bosun canonical aliases (always set so agents see a consistent set) ──
+    BOSUN_TASK_ID: ctx.taskId ?? "",
+    BOSUN_TASK_TITLE: ctx.taskTitle ?? "",
+    BOSUN_TASK_DESCRIPTION: ctx.taskDescription ?? "",
+    BOSUN_BRANCH_NAME: ctx.branch ?? "",
+    BOSUN_WORKTREE_PATH: ctx.worktreePath ?? "",
+    BOSUN_SDK: ctx.sdk ?? "",
+    BOSUN_MANAGED: "1",
+    VE_MANAGED: "1",
   };
 
   // Merge any extra context values as env vars

package/agent-prompts.mjs

@@ -227,6 +227,32 @@ You are the always-on reliability guardian for bosun in devmode.
 - No placeholders/stubs/TODO-only output.
 - Keep behavior stable and production-safe.
 
+## Bosun Task Agent — Git & PR Workflow
+
+You are running as a **Bosun-managed task agent**.  Environment variables
+\`BOSUN_TASK_TITLE\`, \`BOSUN_BRANCH_NAME\`, \`BOSUN_TASK_ID\`, and their
+\`VE_*\` / \`VK_*\` aliases are available in your environment.
+
+**Before committing:**
+- Run auto-formatting tools (gofmt, prettier, etc.) relevant to changed files.
+- Fix any lint or vet warnings introduced by your changes.
+
+**After committing:**
+- If a precommit hook auto-applies additional formatting changes, add those
+  to a follow-up commit before pushing.
+- Merge any upstream changes from the base branch before pushing:
+  \`git fetch origin && git merge origin/<base-branch> --no-edit\`
+  Resolve any conflicts that arise.
+- Push: \`git push --set-upstream origin {{BRANCH}}\`
+- After a successful push, open a Pull Request:
+  \`gh pr create --title "{{TASK_TITLE}}" --body "Closes task {{TASK_ID}}"\`
+- **Do NOT** run \`gh pr merge\` — the orchestrator handles merges after CI.
+
+**Do NOT:**
+- Bypass pre-push hooks (\`git push --no-verify\` is forbidden).
+- Use \`git add .\` — stage files individually.
+- Wait for user confirmation before pushing or opening the PR.
+
 ## Agent Status Endpoint
 - URL: http://127.0.0.1:{{ENDPOINT_PORT}}/api/tasks/{{TASK_ID}}
 - POST /status {"status":"inreview"} after PR-ready push

package/autofix.mjs

@@ -348,12 +348,36 @@ export function isDevMode() {
     return false;
   }
 
-  // Check for monorepo markers (source repo)
-  const repoRoot = resolve(__dirname, "..", "..");
+  // Check for bosun repo markers (standalone repo)
+  let repoCursor = resolve(__dirname);
+  for (let i = 0; i < 5; i += 1) {
+    const pkgPath = resolve(repoCursor, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        if (pkg?.name === "bosun" && existsSync(resolve(repoCursor, "monitor.mjs"))) {
+          _devModeCache = true;
+          return true;
+        }
+      } catch {
+        /* ignore */
+      }
+    }
+    repoCursor = resolve(repoCursor, "..");
+  }
+
+  // Check for monorepo markers (source repo). Walk up a few levels to
+  // handle scripts/bosun -> repo root layout.
   const monoRepoMarkers = ["go.mod", "Makefile", "AGENTS.md", "x"];
-  const isMonoRepo = monoRepoMarkers.some((m) =>
-    existsSync(resolve(repoRoot, m)),
-  );
+  let cursor = resolve(__dirname);
+  let isMonoRepo = false;
+  for (let i = 0; i < 5; i += 1) {
+    if (monoRepoMarkers.some((m) => existsSync(resolve(cursor, m)))) {
+      isMonoRepo = true;
+      break;
+    }
+    cursor = resolve(cursor, "..");
+  }
 
   _devModeCache = isMonoRepo;
   return isMonoRepo;

package/cli.mjs

@@ -178,7 +178,7 @@ function showHelp() {
     bosun --no-codex --no-autofix                  # minimal mode
 
   DOCS
-    https://www.npmjs.com/package/@virtengine/bosun
+    https://www.npmjs.com/package/bosun
 `);
 }
 

package/monitor.mjs

@@ -6315,7 +6315,7 @@ function resolveUpstreamFromTask(task) {
   if (
     text.includes("bosun") ||
     text.includes("codex monitor") ||
-    text.includes("@virtengine/bosun") ||
+    text.includes("bosun") ||
     text.includes("scripts/bosun")
   ) {
     return DEFAULT_BOSUN_UPSTREAM;

package/package.json

@@ -1,26 +1,25 @@
 {
   "name": "bosun",
-  "version": "0.26.6",
+  "version": "0.27.0",
   "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/bosun",
+  "author": "VirtEngine Maintainers <maintainers@virtengine.com>",
+  "homepage": "https://bosun.virtengine.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/virtengine/virtengine.git",
-    "directory": "scripts/bosun"
+    "url": "git+https://github.com/virtengine/bosun.git"
   },
   "bugs": {
-    "url": "https://github.com/virtengine/virtengine/issues"
+    "url": "https://github.com/virtengine/bosun/issues"
   },
   "keywords": [
+    "bosun",
     "codex",
     "orchestrator",
     "monitor",
     "ai",
     "automation",
-    "vibe-kanban",
     "telegram",
     "devops",
     "executor",

package/postinstall.mjs

@@ -12,6 +12,8 @@
  */
 
 import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
 
 const isWin = process.platform === "win32";
 
@@ -182,6 +184,18 @@ function main() {
   console.log("    bosun             Start with existing config");
   console.log("    bosun --help       See all options");
   console.log("");
+
+  // Auto-install git hooks when inside the repo and hooks are present.
+  try {
+    if (process.env.BOSUN_SKIP_GIT_HOOKS) return;
+    const cwd = process.cwd();
+    const hooksDir = resolve(cwd, ".githooks");
+    if (existsSync(resolve(cwd, ".git")) && existsSync(hooksDir)) {
+      execSync("git config core.hooksPath .githooks", { stdio: "ignore" });
+    }
+  } catch {
+    // Non-blocking; hooks can be installed via `npm run hooks:install`
+  }
 }
 
 main();

package/publish.mjs

@@ -225,9 +225,9 @@ function main() {
     if (status === 0 && !dryRun) {
       console.log(
         "\n[publish] REMINDER: deprecate the legacy npm package to redirect users:\n" +
-        "  npm deprecate bosun@'*' \"Renamed to @virtengine/bosun. Install: npm install -g @virtengine/bosun\"\n" +
+        "  npm deprecate bosun@'*' \"Renamed to bosun. Install: npm install -g bosun\"\n" +
         "  # If a scoped legacy package exists:\n" +
-        "  npm deprecate @virtengine/bosun@'*' \"Renamed to @virtengine/bosun. Install: npm install -g @virtengine/bosun\"\n",
+        "  npm deprecate bosun@'*' \"Renamed to bosun. Install: npm install -g bosun\"\n",
       );
     }
     process.exit(status);

package/session-tracker.mjs

@@ -506,6 +506,19 @@ export class SessionTracker {
     this.#markDirty(sessionId);
   }
 
+  /**
+   * Rename a session (update its title).
+   * @param {string} sessionId
+   * @param {string} newTitle
+   */
+  renameSession(sessionId, newTitle) {
+    const session = this.#sessions.get(sessionId);
+    if (!session) return;
+    session.taskTitle = newTitle;
+    session.title = newTitle;
+    this.#markDirty(sessionId);
+  }
+
   /**
    * Flush all dirty sessions to disk immediately.
    */

package/setup.mjs

@@ -16,7 +16,7 @@
  * Usage:
  *   bosun --setup              # interactive wizard
  *   bosun-setup                # same (bin alias)
- *   npx @virtengine/bosun setup
+ *   npx bosun setup
  *   node setup.mjs --non-interactive   # use env vars, skip prompts
  */
 
@@ -1724,7 +1724,7 @@ async function main() {
   const hasVk = check(
     "Vibe-Kanban CLI",
     commandExists("vibe-kanban") || bundledBinExists("vibe-kanban"),
-    "Bundled with @virtengine/bosun as a dependency",
+    "Bundled with bosun as a dependency",
   );
 
   if (!hasVk) {
@@ -1732,8 +1732,8 @@ async function main() {
       "vibe-kanban not found. This is bundled with bosun, so this is unexpected.",
     );
     info("Try reinstalling:");
-    console.log("     npm uninstall -g @virtengine/bosun");
-    console.log("     npm install -g @virtengine/bosun\n");
+    console.log("     npm uninstall -g bosun");
+    console.log("     npm install -g bosun\n");
   }
 
   if (!hasNode) {

package/startup-service.mjs

@@ -699,7 +699,7 @@ function generateSystemdUnit({ daemon = false } = {}) {
 
   return `[Unit]
 Description=bosun — AI Orchestrator Supervisor
-Documentation=https://www.npmjs.com/package/@virtengine/bosun
+Documentation=https://www.npmjs.com/package/bosun
 After=network-online.target
 Wants=network-online.target
 

package/task-executor.mjs

@@ -2710,11 +2710,16 @@ class TaskExecutor {
   async executeTask(task, options = {}) {
     const taskId = task.id || task.task_id;
     const taskTitle = task.title || "(untitled)";
-    if (this._paused) {
+    if (this._paused && !options?.force) {
       console.log(
         `${TAG} executor paused — skipping task "${taskTitle}" (${taskId})`,
       );
-      return;
+      return { skipped: true, reason: "paused" };
+    }
+    if (this._paused && options?.force) {
+      console.log(
+        `${TAG} executor paused but force=true — executing task "${taskTitle}" (${taskId})`,
+      );
     }
     if (this._isBaseBranchLimitReached(task)) {
       const baseBranch = this._resolveTaskBaseBranch(task);
@@ -3073,7 +3078,39 @@ class TaskExecutor {
         `${TAG} executing task "${taskTitle}" in ${wt.path} on branch ${branch} (sdk=${resolvedSdk})`,
       );
 
-      // 6a. Start session tracking for review handoff
+      // 6a. Inject task context env vars so spawned agents (Codex/Copilot/Claude)
+      // inherit the full Bosun task context regardless of which env-var naming
+      // convention they read (VE_*, VK_*, or BOSUN_*).  We save and restore to
+      // avoid polluting the parent process when running multiple parallel tasks.
+      const _savedEnvKeys = [
+        "VE_TASK_ID", "VE_TASK_TITLE", "VE_TASK_DESCRIPTION",
+        "VE_BRANCH_NAME", "VE_WORKTREE_PATH", "VE_SDK", "VE_MANAGED",
+        "VK_TITLE", "VK_DESCRIPTION",
+        "BOSUN_TASK_ID", "BOSUN_TASK_TITLE", "BOSUN_TASK_DESCRIPTION",
+        "BOSUN_BRANCH_NAME", "BOSUN_WORKTREE_PATH", "BOSUN_SDK", "BOSUN_MANAGED",
+      ];
+      const _savedEnv = {};
+      for (const k of _savedEnvKeys) _savedEnv[k] = process.env[k];
+
+      // Set both naming conventions so any agent instruction set detects them.
+      process.env.VE_TASK_ID            = taskId;
+      process.env.VE_TASK_TITLE         = taskTitle;
+      process.env.VE_TASK_DESCRIPTION   = String(task.description || task.body || "");
+      process.env.VE_BRANCH_NAME        = branch;
+      process.env.VE_WORKTREE_PATH      = wt.path;
+      process.env.VE_SDK                = resolvedSdk;
+      process.env.VE_MANAGED            = "1";
+      process.env.VK_TITLE              = taskTitle;
+      process.env.VK_DESCRIPTION        = String(task.description || task.body || "");
+      process.env.BOSUN_TASK_ID         = taskId;
+      process.env.BOSUN_TASK_TITLE      = taskTitle;
+      process.env.BOSUN_TASK_DESCRIPTION = String(task.description || task.body || "");
+      process.env.BOSUN_BRANCH_NAME     = branch;
+      process.env.BOSUN_WORKTREE_PATH   = wt.path;
+      process.env.BOSUN_SDK             = resolvedSdk;
+      process.env.BOSUN_MANAGED         = "1";
+
+      // 6b. Start session tracking for review handoff
       const sessionTracker = getSessionTracker();
       sessionTracker.startSession(taskId, taskTitle);
 
@@ -3097,6 +3134,16 @@ class TaskExecutor {
         },
       });
 
+      // Restore env vars that were injected for this task slot so parallel
+      // tasks running in the same process don't see stale values.
+      for (const k of _savedEnvKeys) {
+        if (_savedEnv[k] === undefined) {
+          delete process.env[k];
+        } else {
+          process.env[k] = _savedEnv[k];
+        }
+      }
+
       // Track attempts on task for PR body
       task._executionResult = result;
 

package/telegram-bot.mjs

@@ -780,7 +780,7 @@ let agentChatId = null; // chat where agent is running
 // ── Sticky UI menu state (keep /menu accessible at bottom) ─────────────────
 const stickyMenuState = new Map();
 const stickyMenuTimers = new Map();
-const STICKY_MENU_BUMP_MS = 1200;
+const STICKY_MENU_BUMP_MS = 200;
 
 // ── Queues ──────────────────────────────────────────────────────────────────
 
@@ -1876,6 +1876,48 @@ async function handleCallbackQuery(query) {
     enqueueCommand(() => cmdResumeTasks(chatId));
     return;
   }
+  if (data === "cb:close_menu") {
+    // Close and disable sticky menu
+    const state = stickyMenuState.get(chatId);
+    if (state?.enabled) {
+      // Cancel any pending bump timer
+      const timer = stickyMenuTimers.get(chatId);
+      if (timer) {
+        clearTimeout(timer);
+        stickyMenuTimers.delete(chatId);
+      }
+      // Delete the sticky menu message
+      if (state.messageId) {
+        await deleteDirect(chatId, state.messageId).catch(() => {});
+      }
+      // Disable sticky state
+      stickyMenuState.delete(chatId);
+    } else if (query.message?.message_id) {
+      // Not sticky — just delete the message
+      await deleteDirect(chatId, query.message.message_id).catch(() => {});
+    }
+    return;
+  }
+  if (data === "cb:toggle_menu") {
+    // Toggle sticky menu on/off
+    const state = stickyMenuState.get(chatId);
+    if (state?.enabled) {
+      // Menu is open → close it
+      const timer = stickyMenuTimers.get(chatId);
+      if (timer) {
+        clearTimeout(timer);
+        stickyMenuTimers.delete(chatId);
+      }
+      if (state.messageId) {
+        await deleteDirect(chatId, state.messageId).catch(() => {});
+      }
+      stickyMenuState.delete(chatId);
+    } else {
+      // Menu is closed → open it
+      enqueueCommand(() => cmdMenu(chatId));
+    }
+    return;
+  }
   if (data === "cb:confirm_restart") {
     await sendReply(
       chatId,
@@ -3385,11 +3427,15 @@ async function showStartTaskModelPicker(chatId, taskId, sdk, executor) {
 
 function uiNavRow(parent) {
   if (!parent) {
-    return [uiButton("🏠 Home", uiGoAction("home"))];
+    return [
+      uiButton("🏠 Home", uiGoAction("home")),
+      uiButton("✖ Close", "cb:close_menu"),
+    ];
   }
   return [
     uiButton("⬅️ Back", uiGoAction(parent)),
     uiButton("🏠 Home", uiGoAction("home")),
+    uiButton("✖ Close", "cb:close_menu"),
   ];
 }
 
@@ -3623,6 +3669,7 @@ Object.assign(UI_SCREENS, {
       } else if (telegramUiUrl) {
         rows.unshift([{ text: "🌐 Open Control Center", url: getBrowserUiUrl() || telegramUiUrl }]);
       }
+      rows.push([uiButton("✖ Close Menu", "cb:close_menu")]);
       return buildKeyboard(rows);
     },
   },