bosun 0.41.0 → 0.41.2

package/cli.mjs

@@ -77,12 +77,14 @@ function showHelp() {
     bosun [options]
 
   COMMANDS
-    audit <command> [options]   Codebase annotation audit workflows (scan/generate/warn/manifest/index/trim/conformity/migrate)
-    --setup                     Launch the web-based setup wizard (default)
+    workflow list              List declarative pipeline workflows
+    workflow run <name>        Run a declarative pipeline workflow
+    --setup                    Launch the web-based setup wizard (default)
     --setup-terminal            Run the legacy terminal setup wizard
     --where                     Show the resolved bosun config directory
     --doctor                    Validate bosun .env/config setup
     --tool-log <ID|list|prune>  Retrieve/list/prune cached tool outputs
+    node:create <name>          Scaffold a custom workflow node in custom-nodes/
     --context-index [mode]      Run context index workflow (run|status|search)
     --context-index-query <text> Query text for context index search mode
     --context-index-limit <n>   Max results for context index search (default: 25)
@@ -159,6 +161,12 @@ function showHelp() {
 
     Run 'bosun task --help' for complete task CLI documentation and examples.
 
+  WORKFLOWS
+    workflow list               List built-in and configured workflows
+    workflow run <name>         Run a declarative fresh-context workflow
+
+    Run 'bosun workflow --help' for workflow CLI examples.
+
   VIBE-KANBAN
     --no-vk-spawn               Don't auto-spawn Vibe-Kanban
     --vk-ensure-interval <ms>   VK health check interval (default: 60000)
@@ -918,6 +926,19 @@ function daemonStatus() {
       }
       console.log(`  Run --terminate to stop restart owners, then --daemon to restart.`);
     } else {
+      const existingMonitorOwner = detectExistingMonitorLockOwner();
+      if (existingMonitorOwner) {
+        console.log(
+          `  bosun daemon is not running in daemon mode, but bosun monitor is active (PID ${existingMonitorOwner.pid}).`,
+        );
+        console.log(
+          `  Bosun is running in monitor mode with lock file ${existingMonitorOwner.pidFile}.`,
+        );
+        console.log(
+          `  Use 'bosun --terminate' to stop it, or 'bosun --daemon' only after it is fully stopped.`,
+        );
+        process.exit(0);
+      }
       // Broader scan: portal, monitor, ui-server, etc. (non-daemon bosun processes)
       const allPids = findAllBosunProcessPids();
       if (allPids.length > 0) {
@@ -1321,7 +1342,21 @@ async function main() {
     process.exit(0);
   }
 
-  // Handle 'audit' subcommand before --help so command-specific help works.
+  const workflowFlagIndex = args.indexOf("--workflow");
+  const workflowCommandIndex =
+    args[0] === "workflow"
+      ? 0
+      : args[0]?.startsWith("--")
+        ? args.indexOf("workflow")
+        : -1;
+  if (workflowCommandIndex >= 0 || workflowFlagIndex >= 0) {
+    const { runWorkflowCli } = await import("./workflow/workflow-cli.mjs");
+    const commandStartIndex = workflowCommandIndex >= 0 ? workflowCommandIndex : workflowFlagIndex;
+    const workflowArgs = args.slice(commandStartIndex + 1);
+    await runWorkflowCli(workflowArgs);
+    process.exit(0);
+  }
+
   const auditFlagIndex = args.indexOf("--audit");
   const auditCommandIndex =
     args[0] === "audit"
@@ -1333,8 +1368,27 @@ async function main() {
     const { runAuditCli } = await import("./lib/codebase-audit.mjs");
     const commandStartIndex = auditCommandIndex >= 0 ? auditCommandIndex : auditFlagIndex;
     const auditArgs = args.slice(commandStartIndex + 1);
-    const result = await runAuditCli(auditArgs);
-    process.exit(Number.isInteger(result?.exitCode) ? result.exitCode : 0);
+    await runAuditCli(auditArgs);
+    process.exit(0);
+  }
+
+  if (args[0] === "node:create" || (args[0] === "node" && args[1] === "create")) {
+    const name = args[0] === "node:create" ? args[1] : args[2];
+    if (!name) {
+      console.error("Usage: bosun node:create <name>");
+      process.exit(1);
+    }
+    const { scaffoldCustomNodeFile } = await import("./workflow/workflow-nodes.mjs");
+    try {
+      const result = scaffoldCustomNodeFile(name, { repoRoot: runtimeRepoRoot });
+      console.log(`\n  ✓ Created custom node \"${result.type}\"`);
+      console.log(`    File: ${result.filePath}`);
+      console.log("");
+    } catch (err) {
+      console.error(`  Error: ${err.message}`);
+      process.exit(1);
+    }
+    process.exit(0);
   }
 
   // Handle --help

package/config/config.mjs

@@ -26,12 +26,13 @@ import {
 } from "../agent/agent-prompts.mjs";
 import { resolveAgentRepoRoot, resolveRepoLocalBosunDir } from "./repo-root.mjs";
 import { applyAllCompatibility } from "../compat.mjs";
+import { ensureTestRuntimeSandbox } from "../infra/test-runtime.mjs";
 import {
   normalizeExecutorKey,
   getModelsForExecutor,
   MODEL_ALIASES,
 } from "../task/task-complexity.mjs";
-import { ensureTestRuntimeSandbox } from "../infra/test-runtime.mjs";
+import { normalizePipelineWorkflows } from "../workflow/pipeline-workflows.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
@@ -635,6 +636,86 @@ function resolveTriggerSystemConfig(configData, defaults) {
   });
 }
 
+function toBoundedInt(value, fallback, min, max) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) return fallback;
+  const rounded = Math.trunc(parsed);
+  return Math.min(max, Math.max(min, rounded));
+}
+
+function normalizeStatusList(rawStates) {
+  const source = Array.isArray(rawStates)
+    ? rawStates
+    : String(rawStates || "").split(",");
+  const values = [];
+  for (const raw of source) {
+    const normalized = String(raw || "").trim().toLowerCase();
+    if (!normalized || values.includes(normalized)) continue;
+    values.push(normalized);
+  }
+  return values.length > 0 ? values : ["done", "cancelled"];
+}
+
+function resolveWorkflowConfig(configData = {}) {
+  const rawWorkflows = configData?.workflows;
+  const rawEntries = Array.isArray(rawWorkflows) ? rawWorkflows : [];
+  const normalized = [];
+
+  for (const rawEntry of rawEntries) {
+    if (!rawEntry || typeof rawEntry !== "object" || Array.isArray(rawEntry)) continue;
+    const type = String(rawEntry.type || "").trim().toLowerCase();
+    if (!type) continue;
+
+    const entryBase = {
+      type,
+      enabled: rawEntry.enabled !== false,
+      name: String(rawEntry.name || "").trim() || null,
+    };
+
+    if (type !== "continuation-loop") {
+      normalized.push(Object.freeze(entryBase));
+      continue;
+    }
+
+    const onStuckRaw = String(rawEntry.onStuck || "escalate").trim().toLowerCase();
+    const onStuck = ["retry", "escalate", "pause"].includes(onStuckRaw)
+      ? onStuckRaw
+      : "escalate";
+
+    normalized.push(Object.freeze({
+      ...entryBase,
+      taskId: String(rawEntry.taskId || "").trim(),
+      worktreePath: String(rawEntry.worktreePath || "").trim(),
+      maxTurns: toBoundedInt(rawEntry.maxTurns, 8, 1, 1000),
+      pollIntervalMs: toBoundedInt(rawEntry.pollIntervalMs, 30000, 1000, 3600000),
+      terminalStates: normalizeStatusList(rawEntry.terminalStates),
+      stuckThresholdMs: toBoundedInt(rawEntry.stuckThresholdMs, 300000, 1000, 86400000),
+      onStuck,
+      continuePrompt: String(rawEntry.continuePrompt || "").trim(),
+      retryPrompt: String(rawEntry.retryPrompt || "").trim(),
+      sdk: String(rawEntry.sdk || "auto").trim() || "auto",
+      model: String(rawEntry.model || "").trim(),
+      timeoutMs: toBoundedInt(rawEntry.timeoutMs, 1800000, 1000, 21600000),
+    }));
+  }
+
+  // Support declarative pipeline workflow maps while keeping backward-compatible
+  // array semantics for continuation-loop style entries.
+  if (rawWorkflows && typeof rawWorkflows === "object" && !Array.isArray(rawWorkflows)) {
+    const namedWorkflows = normalizePipelineWorkflows(rawWorkflows);
+    for (const [workflowName, workflowDefinition] of Object.entries(namedWorkflows)) {
+      Object.defineProperty(normalized, workflowName, {
+        value: workflowDefinition,
+        enumerable: true,
+        configurable: false,
+        writable: false,
+      });
+    }
+  }
+
+  return Object.freeze(normalized);
+}
+
 // ── Git helpers ──────────────────────────────────────────────────────────────
 
 function detectRepoSlug(repoRoot = "") {
@@ -1404,6 +1485,7 @@ export function loadConfig(argv = process.argv, options = {}) {
     process.env.BOSUN_LOAD_REPO_ENV_WITH_EXPLICIT_CONFIG,
     false,
   );
+  const envOverride = reloadEnv || !isEnvEnabled(process.env.BOSUN_ENV_NO_OVERRIDE, false);
   let detectedRepoRoot = "";
   const getFallbackRepoRoot = () => {
     if (normalizedRepoRootOverride) return normalizedRepoRootOverride;
@@ -1412,10 +1494,23 @@ export function loadConfig(argv = process.argv, options = {}) {
   };
 
   // Determine config directory (where bosun stores its config)
-  const configDir =
+  let configDir =
     explicitConfigDirRaw ||
     resolveConfigDir(normalizedRepoRootOverride);
 
+  // If BOSUN_HOME/BOSUN_DIR is declared in the repo-local .env, load that first
+  // and then pivot into the explicit config dir before reading config files.
+  if (!hasExplicitConfigDir) {
+    loadDotEnv(configDir, { override: envOverride });
+    const envConfigDirRaw = process.env.BOSUN_HOME || process.env.BOSUN_DIR || "";
+    if (String(envConfigDirRaw).trim()) {
+      const resolvedEnvConfigDir = resolve(envConfigDirRaw);
+      if (resolvedEnvConfigDir !== resolve(configDir)) {
+        configDir = resolvedEnvConfigDir;
+      }
+    }
+  }
+
   const configFile = loadConfigFile(configDir);
   let configData = configFile.data || {};
   const configFileHadInvalidJson = configFile.error === "invalid-json";
@@ -1475,7 +1570,6 @@ export function loadConfig(argv = process.argv, options = {}) {
   // for Bosun-specific configuration, so it should override any stale shell
   // env vars.  Users who want shell vars to take precedence can use profiles
   // or set BOSUN_ENV_NO_OVERRIDE=1.
-  const envOverride = reloadEnv || !isEnvEnabled(process.env.BOSUN_ENV_NO_OVERRIDE, false);
   loadDotEnv(configDir, { override: envOverride });
 
   const shouldLoadRepoEnv =
@@ -1963,6 +2057,17 @@ export function loadConfig(argv = process.argv, options = {}) {
         internalExecutorConfig.maxRetries ||
         2,
     ),
+    retryReviewThreshold: Number(
+      process.env.INTERNAL_EXECUTOR_RETRY_REVIEW_THRESHOLD ||
+        internalExecutorConfig.retryReviewThreshold ||
+        internalExecutorConfig.maxRetries ||
+        3,
+    ),
+    retryDelayMs: Number(
+      process.env.INTERNAL_EXECUTOR_RETRY_DELAY_MS ||
+        internalExecutorConfig.retryDelayMs ||
+        15000,
+    ),
     autoCreatePr: internalExecutorConfig.autoCreatePr !== false,
     projectId:
       process.env.INTERNAL_EXECUTOR_PROJECT_ID ||
@@ -2105,6 +2210,7 @@ export function loadConfig(argv = process.argv, options = {}) {
     configData,
     triggerSystemDefaults,
   );
+  const workflows = resolveWorkflowConfig(configData);
 
   // ── GitHub Reconciler ───────────────────────────────────
   const ghReconcileEnabled = isEnvEnabled(
@@ -2189,6 +2295,21 @@ export function loadConfig(argv = process.argv, options = {}) {
     assessWithSdk,
   });
 
+  const workflowDefaults =
+    configData.workflowDefaults && typeof configData.workflowDefaults === "object"
+      ? {
+          ...configData.workflowDefaults,
+          templates: Array.isArray(configData.workflowDefaults.templates)
+            ? [...configData.workflowDefaults.templates]
+            : configData.workflowDefaults.templates,
+          templateOverridesById:
+            configData.workflowDefaults.templateOverridesById &&
+            typeof configData.workflowDefaults.templateOverridesById === "object"
+              ? { ...configData.workflowDefaults.templateOverridesById }
+              : {},
+        }
+      : {};
+
   // ── Fleet Coordination ─────────────────────────────────────
   // Multi-workstation collaboration: when 2+ bosun instances share
   // the same repo, the fleet system coordinates task planning, dispatch,
@@ -2371,6 +2492,7 @@ export function loadConfig(argv = process.argv, options = {}) {
     telegramVerbosity,
 
     triggerSystem,
+    workflows,
 
     // GitHub Reconciler
     githubReconcile: {
@@ -2392,6 +2514,10 @@ export function loadConfig(argv = process.argv, options = {}) {
     // Fleet Coordination
     fleet,
 
+    // Workflow template defaults + opt-in typed workflow entries
+    workflowDefaults: Object.freeze(workflowDefaults),
+    workflows,
+
     // Paths
     statusPath,
     telegramPollLockPath,
@@ -2407,6 +2533,7 @@ export function loadConfig(argv = process.argv, options = {}) {
     workspacesDir,
     activeWorkspace,
     agentRepoRoot,
+    workflows,
 
     // Agent prompts
     agentPrompts,